История страницы

...

The Ubersmith Installer is a command line utility that allows a system administrator to install (or upgrade) Ubersmith on a supported platform without assistance from Ubersmith Support. This can be useful when access to the Ubersmith environment is restricted, or for provisioning development/testing environments. The installer can be used to install both the Ubersmith Core (frontend) software as well as the Ubersmith Appliance.

...

Installation

Prepare the Host

Ensure that your host has been updated to the latest available packages as well as the latest Linux kernel. If necessary, reboot to ensure that the system is running the latest kernel.

...

# docker exec ubersmith_web_1 rm -rf /var/www/ubersmith_root/app/www/setup

Upgrade

Before upgrading, be sure to backup your Ubersmith database.

If you have never used the Ubersmith installation / upgrade utility before, configuration is necessary. Without running the configuration step, the upgrade utility will fail. Run configure.sh to configure the location of your existing Ubersmith installation, as well as your Ubersmith URL/address, and an email address associated with the Ubersmith administrator. Follow the steps to configure your environment:

$ ./configure.sh               
Configuring the Ubersmith installer for an existing installation...
Current path in use by Ubersmith / Appliance [/usr/local/ubersmith]: ~/ubersmith_test
Enter the address in use by Ubersmith / Appliance [ubersmith.example.com]: ubersmith.mydomain.com
Enter the email address of the Ubersmith administrator [admin@example.org]: jsmith@mydomain.com

[ output follows ]

localhost                  : ok=3    changed=1    unreachable=0    failed=0   

This step creates the file .ubersmith_installer.ini in the home directory of the user running the configuration utility.

To upgrade Ubersmith, run the ./upgrade_ubersmith.sh script. The upgrade process will complete automatically.

Troubleshooting

• When running CentOS, if the installer is unable to install pip, you may need to enable the EPEL yum repository.
• Do not install the OS provided `pip` packages for Ubuntu and Debian as the version of `pip` provided is older and has difficulty installing the dependencies for the Ubersmith installer. python-setuptools will install the easy_install utility, which will allow the installer to install a more contemporary version of pip.
• Dependencies installed by pip will installed using the --user option, which will install to the Python user install directory for your platform; typically ~/.local/. (See the Python documentation for site.USER_BASE for full details.) This allows for the installer to be executed as a non-root user. You may want to add this directory to your PATH shell variable so that the supporting utilities (docker-compose, for example) can be run without having to specify the full path to the utility.