Updating the Docker-based Headwind MDM

Question

We would like to know the recommended procedure for updating the Docker-based version in the future, once it is in production.

Answer 1

To update the Docker instance of Headwind MDM:

1. Sign in to the web panel, and download the new version through admin -> Check for updates (click "Update" to download updates).

2. Once the update is downloaded, restart the container - it should install the new version.

docker-compose restart hmdm

Notice: using start and stop instead of restart WILL NOT run the update.

3. In the browser, reload the Headwind MDM web application (Ctrl-F5 in Chrome), and check the version through admin -> About. If you still see the old version, try clearing the browser cache.

Answer 2

To update both Headwind MDM and Tomcat services, compare the version of the hmdm container in docker-compose.yaml with the latest tag at https://github.com/h-mdm/hmdm-docker. 

If your version is outdated, update the version number in docker-compose.yaml and pull the changes:

docker-compose up -d

Notice: if your instance of Headwind MDM is working in the closed network without Internet access, docker may fail to pull changes. 

To update the Docker image in an isolated network, you need to:

1. Pull the new image and save it to a file

docker pull headwindmdm:hmdm-0.1.8

docker save -o hmdm-0.1.8.tar headwindmdm:hmdm-0.1.8

(replace 0.1.8 with the latest version of Headwind MDM container)

2. Upload the image to the offline server

3. Import the image to the local docker repository

docker load -i /path/to/hmdm-0.1.8.tar

4. Proceed with updating similar to the online update