Updating Gateway with the admin menu

Airlock Gateway can be updated with digitally signed update files that are provided by Airlock product support.

The Gateway offers two interfaces to manage updates:

  • The interactive Update Menu.
  • The non-interactive airlock-update tool.

Update Menu

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

  1. Log in via ssh as user menu to access the Airlock Gateway admin menu.
  2. Choose 2) Updates in the Airlock Gateway admin menu to enter the Update 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 “...”

Select an updated file and start 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

This will empty 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.

Update tool

The airlock-update program is a command line tool for basic update related tasks.

 
Info

The airlock-update tool can be used for scripted automatization and update tasks i.e. to roll-out updates for multiple Airlock Gateway installations.

  1. Log in as root on the Gateway.
  2. Start the airlock-update program without any options to show a list of available functions.
 
Terminal box
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_7.x.zip root@airlock:/var/tmp/update_in/
  ssh root@airlock airlock-update --install airlock_update_7.x.zip

  ssh root@airlock airlock-update --uninstall 7.x-HF00xx

Further information and links