IBM Support

MustGather for IBM Order Management Software Certified Containers: Container Customization Issues

Troubleshooting


Problem

This document helps you collect and share data required to diagnose Container Customization issues.

Diagnosing The Problem

Collecting the Data
Depending on nature of your issue, provide the requested diagnostics:
  • OS Version (Recommended Version: RHEL 8.x )
  • Database vendor and version details (Include Fix Pack level)
  • MQ Version
  • om-compose.properties
  • The exact command used to execute the process 
  • All avaialble log files from <Path>/devtoolkit_docker/compose/logs folder
  • devtoolkit_extensions.xml
  • The exact command used to execute the process and log output
    • Example: ./sci_ant.sh -f <path>/devtoolkit_extensions.xml export
  • Generated extensions.jar (present in the parent directory of your runtime directory)
  • extensions.jar
  • om-compose.properties
  • The exact command used to execute the process and log output
    • Example:./om-compose.sh update-extn <full_path_to_extensions.jar>
Upload the following diagnostics from the Extracted Runtime: 
  • Exact command used to execute CDT import and corresponding logs
    • Example: cdtshell.sh 
  • ydk_prefs.xml
  • Screen Print of the Agent or Integration server configuration from Applications Manager
  • Apply VERBOSE tracing on the related Agent or Integration server and share the logs captured
  • MQ .bindings file
- The exact command used to create the custom runtime container from the base images.
Example: 
docker run -e LICENSE=accept -e LANG --privileged -v <oci-storage-name>:/images  \ -v <docker volume or host path>:/opt/ssfs/shared -it --name <container name> <image>

- Upload the diagnostics from the custom container image for issues related to Database connectivity 

- DB2 or Oracle:
  • /opt/ssfs/runtime/properties/system_overrides.properties 
  • /opt/ssfs/runtime/properties/sandbox.cfg file
  • Logs generated on running ./dbverify.sh
- For Oracle please include:
  • AGENTDynamicclasspath.cfg.in
  • APPDynamicclasspath.cfg.in.
Upload the following diagnostics:
  • Exact command executed to generate custom Images.
  • generateImages.sh logs
Upload the following diagnostics:
  • BuildConfig.yaml file
  • build.sh script
  • build.sh logs
Upload the following diagnostics:
  • log4jconfig.custom.xml
  • resource.jar
  • values.yaml

How to submit diagnostic data to IBM Support

After you have collected the preceding information, and the case is opened, please see:
Exchanging information with IBM Technical Support

For more details, see:

Back to top

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SS6PEW","label":"Sterling Order Management"},"ARM Category":[{"code":"a8m0z000000cy0AAAQ","label":"Install and Deploy"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0.0"}]

Document Information

Modified date:
18 July 2025

UID

ibm16486385

Page Feedback