Preparing the host
The commands given in this section assume the yum package manager. They apply
similarly but may need adaptions when applying to other Linux flavors.
Pretty much all the commands need to be run as super user. For convenience,
one may become root as:
$ sudo su -
$ whoami
rootThat way, the sudo prefixing may be omitted.
Install Docker and docker-compose
To run BlueRange in a Docker container, you’ll first need to install
Docker and docker-compose.
Install Docker
Please follow the official installation instructions on Docker Engine to install Docker on your server. On most Linux distributions Docker should be part of the repository.
| Please make sure to follow the official installation instructions as some distributions come with fairly outdated docker software packages in their default repositories! |
Make sure to start and enable the Docker service after installation, so it is available after a system reboot.
$ sudo systemctl start docker
$ sudo systemctl enable docker
Created symlink /etc/systemd/system/multi-user.target.wants/docker.service → /usr/lib/systemd/system/docker.service.To verify the installation run:
$ sudo docker --version
Docker version 20.10.5, build 55c4c88
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMESThe above prints the docker version and all running containers which should result in an empty list.
Install docker compose
In recent versions compose gets installed automatically alongside with docker. Depending on your environment one of two slightly different compose versions may be available.
To verify the installation run:
$ sudo docker compose version
Docker Compose version v2.6.0
$ sudo docker-compose version
docker-compose version 1.28.6, build 5db8d86fThe above prints the docker compose version. If so, please proceed installing Additional tooling below.
| For server installation any of these two will do so that it is okay if either one of these commands succeeds. |
In case both the above commands fail, please follow the official installation instructions at Install Docker Compose to install docker-compose on your server. Once you have installed Docker and docker-compose, continue with the steps below.
| Again, most distributions have outdated docker software in their repositories so that following these external instructions is highly recommended. Please notice that compose installation requires running an externally downloaded script with root rights. |
Typically explicit installation requires the package docker-compose-plugin.
It can be installed using the package manager, e.g. by running
sudo yum install docker-compose-plugin.
Additional tooling
Some tool installations below require the addition of the Enterprise repository:
$ sudo yum install epel-release
[..]
Total download size: 23 k
Installed size: 32 k
Is this ok [y/N]: y
[..]
Complete!PwGen
For generating secure random passwords the pwgen tool is handy:
$ sudo yum install pwgen
[..]
Total download size: 31 k
Installed size: 46 k
Is this ok [y/N]: y
[..]
Complete!
$ pwgen -snc 48 1
YuM0oqdMs4rXvCjkLybn9XdzUPRfwnaEbmLZiRZZ04pZkuNCThe tool generates random passwords.
Vi IMproved
During this installation some files will need to be edited manually.
| If you are not familiar with vim please skip this and keep using the default editor. |
If you are familiar with vim set it as default editor with these commands:
$ sudo yum install vim
[..]
Total download size: 7.8 M
Installed size: 30 M
Is this ok [y/N]: y
[..]
Complete!
$ sudo update-alternatives --install /usr/bin/editor editor /usr/bin/vim 100
$ sudo editor --version
VIM - Vi IMproved 8.0 (2016 Sep 12, compiled Jun 18 2020 15:49:08)
[..]This should report a Vi IMproved now.
Git
Some server scripts are prepared online for use as part of this installation.
For easy updates these files are obtained and maintained using git which is
installed as shown:
$ sudo yum install git
[..]
Total download size: 21 M
Installed size: 80 M
Is this ok [y/N]: y
[..]
Complete!
$ sudo git --version
git version 2.27.0This should report a git version now.