To perform the update, the following prerequisites must be met:
- The IAM installation of the old IAM version (e.g. 7.5) must still be available.
- The new IAM version (e.g. 7.6) must be installed.
- The affected IAM instance must be stopped.
The table below lists all pieces of information required for the upgrade. To keep the instructions below valid for different IAM and h2 versions, it uses the variables shown in the following table. For each step, an example is given using the example values in the table.
The values in the example column are valid for a default IAM installation (e.g. using the installer) with instance auth
. The h2 versions are valid when upgrading from IAM 7.5.2 to IAM 7.6.
| |
---|
| Refers to the H2 version found in the lib folder of the old IAM version. Version 1.4.197 is valid for versions IAM 7.3 up to at least 7.5.2. | |
| Refers to the H2 version found in the lib folder of the new IAM version. Version 2.1.210 is valid for IAM 7.6. | |
| Refers to the absolute installation directory of the IAM binaries of the version before the upgrade. | |
| Refers to the absolute installation directory of the IAM binaries of the version after the upgrade. | |
| Refers to the absolute h2 data directory. It is configured by property iam.h2.data.dir in the instance.properties file. Alternatively it can be determined using the IAM command-line interface:
iam info -i <instance-name> | grep iam.h2.data.dir Note that the iam.h2.data.dir is usually relative to the IAM base dir. Make sure to use the absolute path. The H2 script used below will not accept a relative path. | /home/airlock/iam/instances/auth/h2
|
| Refers to the H2 database name. It is the last part of the JDBC URL that is configured by property iam.h2.jdbc.url in the instance.properties file. Alternatively the JDBC URL can be determined using the IAM command-line interface:
iam info -i <instance-name> | grep iam.h2.jdbc.url Example: in the JDBC URL jdbc:h2:tcp://localhost:9001/iamdb the database name is iamdb . | |
| Refers to the database user that is used to connect to the H2 database. It is configured by property iam.h2.jdbc.user in the instance.properties file. Alternatively it can be determined using the IAM command-line interface:
iam info -i <instance-name> | grep iam.h2.jdbc.user | |
| Refers to the database password that is used to connect to the H2 database. It is configured by property iam.h2.jdbc.password in the instance.properties file. | |
| Existing directory to move backup data during the migration. The directory must exist. | |
To use the example scripts below, you may use the following shell variables and set them to values matching your environment.