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

Summary

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.

...

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.

Install Dependencies

The installation process will fail without these dependencies:

CentOS 

sudo yum install gcc libffi-devel python-devel openssl-devel epel-release git

Once EPEL is configured, run:

sudo yum install python-pip

sudo dnf remove buildah podman
sudo dnf install gcc libffi-devel python3-devel openssl-devel git
sudo alternatives --set python /usr/bin/python3
sudo alternatives --install /usr/bin/pip pip /usr/bin/pip3.6 1

Debian / Ubuntu LTS

sudo apt install build-essential libssl-dev libffi-dev python3-dev python3-setuptools python3-pip git
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.7 1
sudo update-alternatives --install /usr/bin/pip pip /usr/bin/pip3 1

sudo apt install build-essential libssl-dev libffi-dev python3-dev python3-setuptools python3-pip git
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.6 1
sudo update-alternatives --install /usr/bin/pip pip /usr/bin/pip3 1

sudo apt install build-essential libssl-dev libffi-dev python3-dev python3-setuptools python3-pip git
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1
sudo update-alternatives --install /usr/bin/pip pip /usr/bin/pip3 1

Install Docker

The Ubersmith Installer requires that Docker, as well as some additional dependencies be installed prior to installing Ubersmith. The script located at:

...

can be helpful when installing Docker. Ensure that Docker is configured to start on boot; in many cases it may not be. Depending on the operating system used, you may be able to enable the docker service with:

# systemctl enable docker

Ensure that Docker is up and running:

# service docker start

Install Dependencies

The installation process will fail without these dependencies:

CentOS 

$ sudo yum install gcc libffi-devel python-devel openssl-devel epel-release git

Once EPEL is configured, run:

$ sudo yum install python-pip

Debian / Ubuntu LTS

$ sudo apt install build-essential libssl-dev libffi-dev python-dev python-setuptools git

Clone the Repository or Download a Release

On the host Ubersmith is to be installed on, clone the ubersmith_installer repository.

$ git clone https://github.com/TeamUbersmith/ubersmith_installer.git

...

At the end of the Setup Wizard, you will be prompted to delete the setup directory. Change to the directory you deployed Ubersmith to (by default /usr/local/ubersmith) and run:

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

...

On the host Ubersmith is to be installed on, clone the ubersmith_installer repository.

$ git clone https://github.com/TeamUbersmith/ubersmith_installer.git

...

As root, 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]:
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   

...