Airlock as a Service Knowledge Base
API Reference Service Status Airlock Console
airlock.com

Upgrade the tenant IAM version

This guide explains how to upgrade a tenant IAM in Airlock as a Service. A tenant IAM has two version components:

  • IAM application version – the Airlock IAM version used by the tenant IAM

  • Database schema version – the version of the database schema used by Airlock IAM

Upgrading a tenant IAM may involve an IAM application upgrade, a database schema upgrade, or both, depending on the features you want to use. When you activate an updated IAM configuration, Airlock as a Service automatically deploys a tenant IAM that matches the version of the uploaded configuration. Some features additionally require a database schema upgrade, which is performed by Airlock Support.


Airlock IAM upgrade

Notice

Before upgrading, consult the ALSAASPM-N-194 list to verify that your target IAM version is supported.

The upgrade procedure depends on how the IAM configuration is managed.


Determining the current IAM version

The current IAM version is displayed at the bottom of the navigation bar in the tenant IAM Adminapp.

If you use the Getting Started configuration

When you apply your next configuration change, click Activate. Airlock as a Service automatically migrates the configuration to the latest supported IAM version and deploys the upgraded tenant IAM.


If the IAM configuration is managed by a partner

If your IAM configuration is managed by a partner, the partner prepares and applies the upgrade on your behalf. This typically includes the following steps:

  1. Open the configuration in the Config Editor of the target Airlock IAM version.

  2. Apply the required configuration adjustments and fixes.

  3. Apply the required Airlock-as-a-Service-specific configuration variables and settings.

  4. Create a ZIP file containing the updated configuration.

  5. Upload the ZIP file to a non-production service-level tenant in Airlock as a Service.

  6. Activate the configuration and thoroughly test all relevant flows in the deployed tenant IAM.

  7. Follow the staging process to roll out the changes to production.


Upgrading the tenant IAM

  1. Update your IAM configuration to a supported Airlock IAM version.

  2. Upload the updated configuration to the Airlock Console.

  3. Activate the updated configuration.

Airlock as a Service automatically deploys a tenant IAM that matches the version of the uploaded configuration. The configuration change takes effect immediately and does not require downtime.


Database schema upgrades

Some features require changes to the underlying database schema. These changes are referred to as database schema upgrades.

A database schema upgrade may be performed before or after the IAM version upgrade, depending on the feature requirements.


When is a database schema upgrade necessary?

A database schema upgrade may be required to enable features that depend on changes to the underlying database schema.

Notice

The current database schema version can only be determined by Airlock Support. To find out which database schema version your tenant IAM is using, create a support ticket.


Requesting a database schema upgrade

Database schema upgrades are performed by Airlock Support to ensure data integrity and a smooth transition.

To request a database schema upgrade, submit a SAASCASE service request.


Downgrade

Reverting to an earlier IAM version, configuration, or database schema version requires assistance from Airlock Support.