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
- Adaptation of ESXI / Hyper V parameters
- Setting up the hard disk extension in the Linux OS
- Changing passwords and security salts
- 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