Update BRIX AI in an air-gapped environment

When a new version of BRIX AI is released, download the archive with updated installation files and transfer your configuration settings from the environment variables file. Below are the steps to update an offline installation using Docker Swarm.

Step 1. Prepare update files

  1. Before updating, create a backup copy of your current .env environment variables file:

cp ~/elma-cortex/docker-swarm/.env ~/elma-cortex-env-backup.env

  1. On a machine with internet access, download the new version of the archive. To do this, download and run the script that prepares files for offline installation by executing the following commands:

cd ~
curl -fsSL -o cortex-offline-swarm.sh \
 https://dl.elma365.com/extensions/elma-cortex/latest/cortex-offline-swarm.sh
chmod +x cortex-offline-swarm.sh
./cortex-offline-swarm.sh --pull

If you have already downloaded and extracted the archive, run the following commands, specifying the path to the offline folder:

cd ~/elma-cortex/docker-swarm/offline
chmod +x cortex-offline-swarm.sh
./cortex-offline-swarm.sh –pull

  1. Transfer the new files to the isolated environment using any file transfer method, such as a USB drive or SCP protocol if a secure connection is available. Example using SCP:

scp -r elma-cortex-X.Y.Z user@air-gapped-server:~/

  1. Push images to your private registry using one of the methods described in Install BRIX AI in an air-gapped environment.

Step 2. Update installation configuration

  1. Compare the saved backup copy with the new .env file to identify settings added in the latest version. Run the following command:

diff ~/elma-cortex-env-backup.env ~/elma-cortex/docker-swarm/.env

  1. Transfer setting values from your custom configuration by running one of the following commands:
  • To replace the new .env file with your backup copy and manually add new parameters from the latest version:

cp ~/elma-cortex-env-backup.env ~/elma-cortex/docker-swarm/.env

  • To edit the new .env file directly and transfer modified values from your backup copy:

nano ~/elma-cortex/docker-swarm/.env

Step 3. Apply update

  1. If you use a private registry that requires authentication, log in to Docker:

docker login your-registry.example.com

  1. To apply the update, run the installation script:

chmod +x install.sh
./install.sh

update-cortex-docker-swarm.html cortex-troubleshooting.html