When an update for the server has been released you will need to follow the instructions below to install the update. There are two sets of instructions below depending on whether you deployed the server with Docker or the Virtual Machine.
Please note: if you are updating to iTDS version 4.2.0 or higher for the first time, please ensure that you allow for incoming connections to port 8000 as per our Network Requirements.
Update Docker Images
We recommend that our customers always download the latest docker-compose files directly from our website, to ensure that they are using the correct configuration to run the server. You can download the latest version of the compose file here:
Replace your old docker-compose file with the updated file downloaded. Then run the commands below in the folder containing the compose file.
To download the latest image, first log into our registry using this command:
docker login registry.paterva.com #credentials in delivery email
Note: Password will be hidden when logging in. Use sudo if required for docker commands.
You can pull the updated server images by running the pull command:
docker-compose -f itds.yml pull #Pull latest iTDS image from registry.paterva.com
You can then restart the server by running the "up" command to restart the server using the new images.
docker-compose -f itds.yml up #to run iTDS server in foreground
To run the server in the background, use the following command:
docker-compose -f itds.yml up -d #to run iTDS server in background
Download a New VM
If you cannot pull new docker images due to network restrictions, you can download a new VM containing the updated docker images.
The download link provided in your delivery PDF will always point to the latest server image. This can be used again to download the updated VM.
Once you have successfully updated your sever, you can verify the update by browsing to the home page of the server. You will find the new version number in the top left corner.