Upgrade a single installation

The following example describes the most common upgrade situation in which a single Airlock IAM has been installed and can be upgraded with a newer IAM version. We assume, that an instance name auth exists:

Terminal box

# As "root": Stop "auth" instance service
systemctl stop airlock-iam-auth

# Install new version, e.g. 8.5 ./airlock-iam-installer-8.5.sh

su - airlock

# Upgrade "auth" instance, enable license analytics 
iam upgrade -i "auth" --analytics LICENSE_DATA

# Upgrade systemd service for instance "auth"
iam systemd -i "auth"

# As "root" (ctrl-d): Enable new systemd service pointing to the new IAM version
cp '/home/airlock/iam/instances/auth/airlock-iam-auth.service' '/etc/systemd/system/airlock-iam-auth.service'
chown root:root '/etc/systemd/system/airlock-iam-auth.service' && chmod 644 '/etc/systemd/system/airlock-iam-auth.service'
systemctl enable -f airlock-iam-auth

systemctl daemon-reload
systemctl start airlock-iam-auth

Notice

Starting with IAM 8.5, the IAM license and analytics feature is mandatory. If it is not configured, configuration activation will fail. The IAM CLI is used to configure the analytics plugin, during the init, reset, and upgrade operations. When you run any of these operations, you must specify your preferred analytics mode. For more information, see License and usage analytics.