Skip to main content

Upgrading to IAM Version 3.4

This topic describes how to upgrade the InterSystems API Manager (IAM) from version 3.0 to version 3.4.

New in IAM 3.4

Upgrade Steps

To upgrade from 3.2 to 3.4:

  1. Download the installation tar file from the InterSystems Worldwide Response Center (WRC) download page: in a new tab. To show only the IAM kits, type IAM in the Name column.

  2. Uncompress the file and extract the contents.

    See Installing IAM for a list of the contents.

  3. Perform the upgrade which consists of the following high level steps:

    1. Stop IAM 3.2

    2. Load the IAM 3.4 image and set up environment variables for IAM 3.4

    3. Start IAM 3.4

Perform the Upgrade

Stop IAM 3.2

Before upgrading to IAM 3.4, you must ensure your current version of IAM is no longer running. To stop the IAM container you must be in a shell where you have previously run the setup script for your current version of IAM, or you will need to define the ISC_IAM_IMAGE and ISC_IRIS_URL environment variables. Navigate to the scripts directory containing the docker-compose.yml file for your current IAM version, and stop it, for example:

cd iam3.4/scripts
docker compose down
cd iam3.4/scripts
docker-compose down
cd iam3.4scripts
podman-compose down

Load the IAM 3.4 Image and Set Up Environment Variables for IAM 3.4

  1. Load the IAM image into your local repository by executing the following command in the directory where you extracted the IAM archive:

    docker load -i iam_image.tar
    podman load -i iam_image.tar
  2. Make a note of the value of Loaded image from the output of the docker load command. It is required in step 3b.

  3. Run the IAM setup script and enter the requested information at the prompts.

    1. In a UNIX bash shell, enter:

      source ./scripts/
    2. At the first prompt, enter the container image name. The container image name can be found in the output of the docker load command, as the value of Loaded image. For example, it could be:


    3. Enter the IP address for your InterSystems IRIS instance. If your instance is on your local machine, use your externally visible local IP address, not localhost or If the instance is running in a container, use the IP address of the host environment, not the IP address of the container. To avoid any DNS issues, use the numeric form of the IP address.

    4. Enter the web server port for your InterSystems IRIS instance.

    5. Enter the password for the IAM user on your InterSystems IRIS instance.

    6. Re-enter the password.

    7. If you want IAM to request the license from InterSystems IRIS using HTTPS instead of HTTP, provide the full path to your CA Certificate file; otherwise, press Enter.

    8. With certain InterSystems IRIS configurations, the instance is not accessible by using the instance server name. In these cases, your InterSystems IRIS instance is only accessible via its CSPConfigName URL prefix (see Changing the InterSystems IRIS Server Name in the URLOpens in a new tab) and you need to provide the prefix with a trailing slash (/) now. If this does not apply, press Enter.

    9. To continue and use the information you entered, press y then pressenter.

This script sets the ISC_IAM_IMAGE and ISC_IRIS_URL environment variables required by the docker-compose.yml file.

Start IAM 3.4

Navigate to the directory where you extracted the IAM archive. For example, /users/iam/iam32. Run the following commands:

cd scripts
docker compose up -d
cd scripts
docker-compose up -d
cd scripts
podman-compose up -d

After waiting a minute, go to http://localhost:8002/overview to verify that everything is running.

FeedbackOpens in a new tab