Setting up XELOS Docker

The XELOS Docker setup contains the XELOS application and all necessary resources to run XELOS productively.

Docker Guide

You can find all important information about installing XELOS as Docker Setup in our public Bitbucket repository.

• Instructions and configuration files ( https://bitbucket.org/blueend/xelos-docker/src/master/ )
• Docker images are distributed directly through Docker Hub and can be loaded directly through compatible services. ( https://hub.docker.com/u/xelos/ )

Conversion of a Demo Docker setup to a production environment

If you have downloaded the demo setup of XELOS and would like to use the installation in production mode, please follow the instructions below. Steps to adjust the environment accordingly:

Overview of the

1. Adaptation of ESXI / Hyper V parameters
2. Setting up the hard disk extension in the Linux OS
3. Changing passwords and security salts
4. Check configuration parameters

Adaptation of ESXI / Hyper V parameters

Follow suit. Parameters / Configurations in your virtualization:

• Increase CPU and RAM parameters (Minimum 4 CPU and 8 GB RAM, Recommended: 8+ CPU and 32+ GB RAM)
• Include an additional hard disk as a resource, on which all user data of the system will be moved. The size of the hard disk should depend on your needs.

Setting up the hard disk extension in the Linux OS

Switch to the Linux virtual machine console (login with 'root', the current default password can be found in the Quick Installation Guide) and perform the following steps:

Shut down the docker containers:

cd /server/docker/xelos
docker-compose down

Temporarily move the current server directory:

cd /
mv /server /server_tmp

Create a partition on the new hard disk and mount the new hard disk under /server:

fdisk /dev/sbd
> Interactive: (n) eue partition, (p) primary, (w) store

yum install system-storage-manager
ssm create -n xelos_files -p xelos --fstype xfs /server /dev/sdb1

echo '/dev/mapper/xelos-xelos_files /server xfs defaults 0 0' >> /etc/fstab

Move the contents to the new hard disk and remove the temporary directory:

mv /server_tmp/* /server/.
rm -rf /server_tmp

Raise the docker containers again:

cd /server/docker/xelos
docker-compose up -d

Changing passwords and security salts

Create a backup of the database:

cd /server/docker/xelos
docker-compose exec web php xf snapshot take
> Interactive: (d) database only

Shut down the docker containers:

docker-compose down

Change the security features and passwords in docker-compose.yml and config.custom.php

vi docker-compose.yml
vi xelos/system/config/config.custom.php

Delete the old database contents and then start the docker containers.

rm -f data/mysql/*
docker-compose up -d

Now restore the database and assign a new password for the admin account (all passwords have to be reset, because the hashes are no longer valid after changing the security salt)

docker-compose exec web php xf snapshot restore
> Interactive: Select the previously created backup.

docker-compose exec web php xf user reset_password 1

Check configuration parameters

Please adjust the configuration parameters of the installation so that all desired services are used or switched off in productive operation. You will find the most important service parameters in the Standard Docker Guide.

Checklist:

• Elastic Search as Search Adapter (Administration > Search > Configuration)
• Redis as session and cache server (parameters in custom.config.php)
• ClamAV as AV scanner (parameters in custom.config.php, activation under Administration > Advanced > Security)
• Office Preview (Administration > System Preview > Configuration)
• Install SSL Certificate / Activate SSL in Configuration