IBM Support

PH67677: FOLLOWING MIGRATION TO DB2 AI FOR Z/OS 1.6.2, THE LIBERTY SERVER MIGHT FAIL TO RESTART

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Migration to the 1.6.2 level may complete successfully, but
    Liberty fails to restart
    due to missing properties in the server.xml file.
    Migration might also fail as a result of a configuration
    failure.
    Additional keywords: DB2AIV1R6/K
    

Local fix

  • To work around the issue, run the deploy command again:
    a. Stop Db2ZAI
    b. From the $DB2ZAI_INSTALLATION/configuration/scripts
    directory, run:
    ./config.sh -a deploy
    Note: The values for each prompt are stored in the
    $DB2ZAI_HOME/config/config.json file and can be copy/pasted.
    c. Start Db2ZAI
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All Db2 AI for z/OS (Db2ZAI) users who are   *
    *                 migrating from prior Db2ZAI 1.6.0            *
    *                 maintenance levels to Db2ZAI 1.6.2.          *
    ****************************************************************
    * PROBLEM DESCRIPTION: Migration to Db2ZAI 1.6.2 may fail or   *
    *                      cause Liberty to not restart due to     *
    *                      missing server.xml properties.          *
    ****************************************************************
    * RECOMMENDATION: Apply corrective PTF when available          *
    ****************************************************************
    Migration to the Db2ZAI 1.6.2 level may
    complete successfully, but Liberty fails to
    restart due to missing properties
    (jaasLoginContextEntry and jaasLoginModule) in
    the server.xml file.
    

Problem conclusion

  •  This APAR resolves the issues described above.
    above.
    Additional keyword:
    DB2ZAIV1R6/K
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH67677

  • Reported component name

    DB2 AI FOR Z/OS

  • Reported component ID

    5698CGN00

  • Reported release

    160

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-08-07

  • Closed date

    2025-08-14

  • Last modified date

    2025-08-31

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UO04462

Modules/Macros

  •    COYNOD02 COYREADM
    

Fix information

  • Fixed component name

    DB2 AI FOR Z/OS

  • Fixed component ID

    5698CGN00

Applicable component levels

  • R160 PSY UO04462

       UP25/08/16 P F508 Ž

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"160"}]

Document Information

Modified date:
31 August 2025