Upgrade

Airlock Gateway is updated using digitally signed update files that are available on the Airlock Gateway download page on Techzone.

To manage updates, two interfaces are available:

  • Update Menu — for manual (interactive) updates
  • airlock-update tool — for unattended (non-interactive) updates

Applying a manual update via Update Menu

The Update Menu is a submenu of the Airlock Gateway admin menu:

 
Example
Update Menu 
=========== 
 
    1) Apply update "airlock_update_x.y.zip" 
 
    a) Display list of all installed updates 
    u) Uninstall hotfix 
    c) Clear list of uploaded updates 
 
    b) Back to Main Menu 
    q) Quit 
 
Your choice?

Apply update “...”

Selects an update file and starts the update process.

Display list of all installed updates

Displays a detailed list of applied updates:

  • No – line counter of the list.
  • ID – version of the update.
  • Name – name of the update.
  • Version – build version of the update.
  • Installation Date – date of the update.
  • State – status of the update attempt.

Uninstall hotfix

Can be used to select and uninstall hotfixes.

Clear list of uploaded updates

Empties the list of uploaded updates and delete all update files in the /var/tmp/update_in folder.

Back to Main Menu

Brings you back to the Airlock Gateway admin menu

Quit

Closes the session to the Gateway.

  1. In the Configuration Center, go to:
    System Setup >> Updates
  2. In the Updates section, upload the update file to the Gateway using the Upload button.

  3. Alternatively, use SCP from a workstation to upload the update file to the Airlock Gateway, targeting the /var/tmp/update_in/ directory:

  4.  
    Terminal box
    scp airlock_update_x.y.zip root@airlock.my.dom:/var/tmp/update_in/
  5. Log in as the dedicated menu user to access the Airlock Gateway admin menu.
    • The admin menu is displayed.
  7. Select the 2) Updates option and confirm.
    • The update menu presents a list of all uploaded update files on the system.
  9. Select the update file and confirm.
    • The Gateway verifies the signature and applies the update if the update file is valid.
  11. Follow the update instructions to finish the process.

Applying an unattended update via update tool

The airlock-update tool is a CLI application for basic update-related tasks. It can be used for scripted automatization and update tasks — i.e., to roll-out updates for multiple Airlock Gateway installations.

 
Example
root@gateway:~ # airlock-update

 Description:
  Install Airlock Gateway update/hotfix without interaction

 Usage: airlock-update [OPTION]

 Options:
  -i, --install <filename>     install update/hotfix
  -u, --uninstall <version>    uninstall hotfix
  -l, --list                   list all installed updates/hotfixes
      --list-uninstallable     list uninstallable hotfix
  -h, --help                   print help

 Examples:
  scp airlock_update_8.x.zip root@airlock:/var/tmp/update_in/
  ssh root@airlock airlock-update --install airlock_update_8.x.zip

  ssh root@airlock airlock-update --uninstall 8.x-HF00xx
  1. Use the scp command to upload the update file as root user into the /var/tmp/update_in/ folder:
  2.  
    Terminal box
    scp airlock_update_x.y.zip root@airlock.my.dom:/var/tmp/update_in/
  3. Log in via SSH as root and run the /opt/airlock/base/bin/airlock-update --install command to start the update process.
  4.  
    Terminal box
    ssh root@airlock.my.dom /opt/airlock/base/bin/airlock-update --install airlock_update_x.y.zip
  5. The Gateway verifies the signature and applies the update if the update file is valid.