Upgrading Airlock

We recommend reviewing the Airlock Release Notes prior to upgrading.

Upgrading from a 2.x Version

Upgrading Airlock to the newest version requires moving Airlock's configuration to the new version of Airlock. To upgrade Airlock from a 2.x version, follow the steps below.

Launch a new instance of the newest version of Airlock.
Copy your policies from /opt/airlock/policies to the new instance.
Copy your /opt/airlock/airlock.properties to the new instance.
Copy your /opt/airlock/airlock-ui.properties to the new instance.
Replace the new virtual machine's properties file with your copy from step 1.
Copy your policies from /opt/airlock/policies to the new instance.
If you have configured any SSL certificates for Airlock, copy those files over to the new instance.
Restart Airlock: sudo systemctl restart airlock.service && sudo systemctl restart airlock-ui.service && sudo systemctl restart airlock-ner.service
Test the new Airlock virtual machine to make sure it is behaving as expected.
Decommission the old Airlock instance.

Upgrading from a 1.x Version

Upgrading Airlock to the newest version requires moving Airlock's configuration to the new version of Airlock. To upgrade Airlock from a 1.x version, follow the steps below.

Make local copies of your current Airlock's properties files.
1. /opt/airlock/airlock.properties (prior to 1.10.1 the filename was /opt/airlock/application.properties)
2. /opt/airlock/airlock-ui.properties (not applicable prior to version 1.10)
Launch a new instance of the newest version of Airlock.
Replace the new virtual machine's properties file with your copy from step 1.
Restart Airlock: sudo systemctl restart airlock.service sudo systemctl restart airlock-ui.service sudo systemctl restart airlock-ner.service
Test the new Airlock virtual machine to make sure it is behaving appropriately.
Decommission the old Airlock instance.

Last modified: 17 November 2023