IBM Support

Error 'docker compose file is invalid' appears during major upgrade of developer toolkit (DTK) to 24.1.3.0

Troubleshooting


Problem

Upgrade or installation of the latest IBM Sterling OMS DTK version 10.0.2403.0 is failing.

Symptom

1 - Loading images and starting services results in invalid configurations and errors.
2 - Log messages indicating unsupported config options for various services.
3 - Docker daemon reports errors related to missing containers.

Environment

This error occurs in an environments where the latest DTK (10.0.2403.0) is being upgraded or installed.

Diagnosing The Problem

1. Review the below log messages generated during the upgrade or installation process
2. Check the docker-compose.yml file for any unsupported configuration options, particularly related to platform specifications.
3. Verify the Docker environment settings and configurations for compatibility with the DTK version being installed.
Logs:
 
Loading image from file /root/DTK/devtoolkit_docker/om-base_24.1.3.0_20240229-0918.tar.gz ...
Loaded image: om-base:24.1.3.0_20240229-0918
Docker image om-base:24.1.3.0_20240229-0918 loaded successfully.
mode of '/root/DTK/devtoolkit_docker/compose/docker/omruntime' retained as 0777 (rwxrwxrwx)
mode of '/root/DTK/devtoolkit_docker/compose/docker/omruntime/middleware' retained as 0777 (rwxrwxrwx)
mode of '/root/DTK/devtoolkit_docker/compose/docker/omruntime/middleware/db2' retained as 0777 (rwxrwxrwx)
mode of '/root/DTK/devtoolkit_docker/compose/docker/omruntime/middleware/liberty' retained as 0777 (rwxrwxrwx)
mode of '/root/DTK/devtoolkit_docker/compose/docker/omruntime/middleware/mq' retained as 0777 (rwxrwxrwx)
mode of '/root/DTK/devtoolkit_docker/compose/docker/omruntime/addons' retained as 0777 (rwxrwxrwx)
Disabling OIDC integration
Starting services in no-recreate mode ...
Pulling latest middleware images ...
The Compose file './docker-compose.yml' is invalid because:
Unsupported config option for services.appserver: 'platform'
Unsupported config option for services.db2server: 'platform'
Unsupported config option for services.mqserver: 'platform'
Unsupported config option for services.omruntime: 'platform'
The Compose file './docker-compose.yml' is invalid because:
Unsupported config option for services.appserver: 'platform'
Unsupported config option for services.db2server: 'platform'
Unsupported config option for services.mqserver: 'platform'
Unsupported config option for services.omruntime: 'platform'
Error response from daemon: No such container: om-runtime

Resolving The Problem

To resolve this error, we have 2 possible ways as mentioned below:
Option 1:
A -  Open the docker-compose.yml file located at <HOME_DIR>/devtoolkit_docker/compose/docker/docker-compose.yml.
B - Comment out the below mentioned unsupported configuration options related to platform specifications for the affected services:
 platform: "${DB_PLATFORM_ARCH}"
 platform: "${OM_PLATFORM_ARCH}"
 platform: "${AP_PLATFORM_ARCH}"
 platform: "${MQ_PLATFORM_ARCH}"
 
C - Save the changes to the docker-compose.yml file.
D - Retry the upgrade or installation process for the DTK.
Option 2:
Upgrade the docker-compose to latest version.   (Note - This is tested with latest version v2.24.7 and worked fine.)

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS6PEW","label":"IBM Sterling Order Management"},"ARM Category":[{"code":"a8m0z000000cy0AAAQ","label":"Install and Deploy"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
13 March 2024

UID

ibm17137767