Skip to content

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.

  1. Launch a new instance of the newest version of Airlock.
  2. Copy your policies from /opt/airlock/policies to the new instance.
  3. Copy your /opt/airlock/airlock.properties to the new instance.
  4. Copy your /opt/airlock/airlock-ui.properties to the new instance.
  5. Replace the new virtual machine's properties file with your copy from step 1.
  6. Copy your policies from /opt/airlock/policies to the new instance.
  7. If you have configured any SSL certificates for Airlock, copy those files over to the new instance.
  8. Restart Airlock: sudo systemctl restart airlock.service && sudo systemctl restart airlock-ui.service && sudo systemctl restart airlock-ner.service
  9. Test the new Airlock virtual machine to make sure it is behaving as expected.
  10. 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.

  1. 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)
  2. Launch a new instance of the newest version of Airlock.
  3. Replace the new virtual machine's properties file with your copy from step 1.
  4. Restart Airlock: sudo systemctl restart airlock.service sudo systemctl restart airlock-ui.service sudo systemctl restart airlock-ner.service
  5. Test the new Airlock virtual machine to make sure it is behaving appropriately.
  6. Decommission the old Airlock instance.