IBM Z Software Asset Management Container 9.1 - Docker API Version Compatibility Quick Fix

Resolving The Problem

As a temporary workaround, the Docker API version configured in the startup script must be updated to match the minimum API version supported by the Docker server.

Step 1 – Determine the Minimum Supported API Version

Run the following command:

docker version

In the output, locate the Server section and identify the value reported as Minimum API version (or the minimum version supported by the server).

Example:

Server:
 Engine:
  Version:          29.1.3
  API version:      1.52 (minimum version 1.44)

In this example, the minimum supported API version is 1.44.

Step 2 – Update the Startup Script

Edit the following file:

/path/of/installation/start_IBM-Z_SW_Asset_Mgmt-UI.sh

Locate the docker_api_version parameter and replace the default value:

docker_api_version=1.39

The parameter is in the docker run line (like in this example):

$docker run -e USER_ID=$USER_ID -e GUID=$GUID -e ZAO_IMPORT_VERSION="ibm_z_sw_asset_mgmt-import:09.01-OAGAPTF-ZS833-IBM" -e ExecOS=$ExecOS -e docker_api_version=1.39 -e ehostname=$Hostnm -e enableHttps=true -v /var/run/docker.sock:/var/run/docker.sock -e ehostIP=$HostIP -e TZ=Australia/Perth -e DOCKER_PORT=2376 -v zswam_database-91-IBM:/usr/src/app/database -v zswam_uploads-91-IBM:/usr/src/app/upload -v zswam_logs-91-IBM:/usr/src/app/logs -v zswam_tls-91-IBM:/usr/src/app/tls -v zswam_backup-91-IBM:/usr/src/app/backup --name ibm-z-sw-asset-mgmt-ui-prod-91-IBM -p 8443:8443 -d -it --rm ibm-z-sw-asset-mgmt-ui:prod-91-IBM

with the minimum API version reported by the Docker server.

Example:

$docker run -e USER_ID=$USER_ID -e GUID=$GUID -e ZAO_IMPORT_VERSION="ibm_z_sw_asset_mgmt-import:09.01-OAGAPTF-ZS833-IBM" -e ExecOS=$ExecOS -e docker_api_version=1.44 -e ehostname=$Hostnm -e enableHttps=true -v /var/run/docker.sock:/var/run/docker.sock -e ehostIP=$HostIP -e TZ=Australia/Perth -e DOCKER_PORT=2376 -v zswam_database-91-IBM:/usr/src/app/database -v zswam_uploads-91-IBM:/usr/src/app/upload -v zswam_logs-91-IBM:/usr/src/app/logs -v zswam_tls-91-IBM:/usr/src/app/tls -v zswam_backup-91-IBM:/usr/src/app/backup --name ibm-z-sw-asset-mgmt-ui-prod-91-IBM -p 8443:8443 -d -it --rm ibm-z-sw-asset-mgmt-ui:prod-91-IBM

Step 3 – Restart the Application

After saving the modification, restart the application using the standard startup procedure.

Once restarted, the application should be able to communicate correctly with the Docker backend, allowing containers to load successfully and restoring the affected functionality.

-----------------------------------------------------------------------------------------------------------------------------------------------

A fix is planned to enhance the installation process so that the docker_api_version parameter is automatically aligned with the Docker server capabilities, eliminating the need for manual intervention and preventing future compatibility issues.