Updating PI-Server

Stop the server

To stop the server, change in to the directory of the PI-Server (pi-server-docker) and run the following:

docker-compose down

Backup all the important data to make sure you can roll back

mkdir ~/pi-server-backup
cd /path/to/my/pi-server/installation
cp -r common ~/pi-server-backup/common
cp docker-compose.yml ~/pi-server-backup/docker-compose.yml 
cp -r data ~/pi-server-backup/data
cp piplanning.cfg ~/pi-server-backup/piplanning.cfg

Update Docker images

If your server has a connection to the internet:

Request a login (username and password) for the Rentouch-Docker-Hub from Rentouch if you do not already have one.

docker login harbor3.piplanning.io

If your server does not have a connection to the internet:

Install the updated offline installable images

  • Request a download link from rentouch for the updated .tar archived docker images.
  • Move the .tar archive to the server on which you are installing pi-server.
  • Input the command: (this may takes a minute...)
docker load -i pi-server-images_X.X.X.tar

Update PI-Server config files

On the host-system download the newest version (checkout https://binaries.rentouch.ch/on-premise to see all versions) of the PI-Server docker archive and extract it:

wget https://binaries.rentouch.ch/on-premise/pi-server-docker_X.X.X.tar
mkdir -p pi-server-docker_X.X.X && tar -xf pi-server-docker_X.X.X.tar -C pi-server-docker_X.X.X
cd pi-server-docker_X.X.X

Run the updater. You have to pass the path to your PI-Server folder (which contains the docker-compose and all the data) as the first argument.

python update.py /path/to/my/pi-server/installation

When the migration to the newest version is finished restart the pi-server by

cd /path/to/my/pi-server/installation

As a last step: You can clean up by removing the installer

rm pi-server-docker_X.X.X.tar pi-server-docker_X.X.X

piplanning app

Related to this guide