\uD83D\uDCD8 Instructions
Prerequisites
Before updating the system, please make sure that the Docker containers of MaDaM are shut down. Please use the following command from within the location where file docker-compose.yml is located.
docker-compose stop
If you do not shut down either service, it may lead to corruption of the stored data throughout the updating process.
Backup
We highly recommend backing up the existing service files. This requires all data from Docker volumes or bind-mounts (Persistent data directories) as well as the configuration files
contained in directory config
docker-compose.yml
.env
to be backed up.
Update steps
When updating to a new version, Kistler will provide a package containing new binaries. Typically, this includes Docker images as well as configuration files. All the files should be moved as described in the MaDaM package structure. Before moving the files, please make sure that no remains of the old provision are at the target locations. Please apply all changes you made to your former and backed-up configuration files to the newly provided configuration files.
If no changes were made to the structure of the configuration and docker-compose.yml files, they can stay in place and do not need to be replaced by the updated configuration files. In this case it is enough the replace the image version numbers within docker-compose.yml to match the newly provided images. e.g., xyz-backend:2.5.4.9 --> xyz-backend:2.6.1.9
Finally, start all containers by loading the newly provided images as in file install-madam.sh (docker load -i images/xyz-backend-2.5.4.9.tar.gz) and then using the following command:
docker-compose up –-force-recreate -d