Upgrading the Docker Compose Package

When you have already used the Panopticon Docker Compose package, you can upgrade it to a later version. Select one from the following options.

 

Option 1

Add the new Docker Compose package as a separate installation by placing it in a new, separate folder, while keeping your current Docker Compose package as it is. When using this approach, follow the instructions in this section.

 

Option 2

Upgrade your current Docker Compose installation and continue using the same configurations and Panopticon content such as data tables and workbooks. When using this approach, follow the procedure described below.

Files to Keep

The following files and folders that can contain configurations, customizations, and server content that you need to keep:

  • pano-mount/config/*
  • pano-mount/data/*
  • pano-mount/logs/*

 

Files That May Have Changed

Files that may have changed in the newer version of the Docker Compose package zip file, which means that you must replace the old files with new ones, are the following:

  • .env
  • altair-repo-login.bat
  • altair-repo-login.sh
  • docker-compose.yaml
  • Examples.exz

NOTE:

In case you have modified the PANO_MOUNT_DIR value in the .env file to a path other than /pano-mount, then you must edit the new version of the .env file the same way.

In case you have modified the docker-compose.yaml file (e.g., port mappings), you must make the same changes in the new version of the docker-compose.yaml file.

There is a possibility that the files in /pano-mount/config/python/
and /pano-mount/config/rserve have been modified in the new Docker Compose package. If you have made no customizations to those files, you could replace them with the files from the newer package. In case you have made modifications, you must manually review and compare the old and the new files and manually consolidate your customizations and the new file versions.

 

Detailed Upgrade Instructions

  1. Stop and delete the containers, and then delete the images.

    This is done in Docker Desktop if you are on macOS or Windows. On Linux without a desktop gui, use the command line as described by Docker documentation.

    NOTE: On Windows and Mac, use the command docker images to check that the images are deleted. If they still are listed, then use the command docker rmi to delete the images.

  2. Download the latest Panopticon Docker Compose zip file from Altair One Marketplace.
  3. Extract the contents of the Panopticon Docker Compose zip file to a path different from the location of your current Docker Compose package to avoid overwriting your current setting.
  4. You can opt to compare old and new files in the /pano-mount/config/python/ and /pano-mount/config/rserve folders for reasons described in the note above.
  5. From the folder where you unzipped the new Docker Compose package, copy the files listed in this section and paste them in the folder where the old versions are located.
  6. In case you did not keep the settings from your Panopticon.properties file and you are using Managed Altair Units License; you may discover that you need to create a new machine authorization token (“Auth Code”) on Altairone.com as described in this section.
  7. To download or pull new container images and mount the containers, follow the procedures in this section.

 

 

 

(c) 2013-2024 Altair Engineering Inc. All Rights Reserved.

Intellectual Property Rights Notice | Technical Support