IBM Support

PH32961: INSTALLUTILITY AND FEATUREUTILITY ARE WORKING WHEN THE VARIABLE IS A DIRECTORY, BUT NOT PART OF A FILE NAME

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • The user defined are working when the variable is a
    directory,
    but not part of a file name:
    
    Directory of C:\ford\liberty\20.0
    .0.12_kernel\usr\shared\config
    
    oidc.security.xml
    
    Environment
    variable SECURITY=oidc
    
    main server.xml entry:
    
    <include locatio
    n="${shared.config.dir}/${env.SECURITY}.security.xml"/>
    
    Executi
    on:
    
    C:\ford\liberty\20.0.0.12_kernel>bin\featureUtility.bat
    installServerFeatures --acceptLicense --verbose
    server1
    
    [12/16/20 16:07:55:687 EST] Checking for missing
    features required by the server ...
    
    [12/16/20 16:07:55:769
    EST] file not found for bootstrap.properties under server:
    server1
    
    [12/16/20 16:07:55:781 EST] CWWKF1241E: Failed to read
    null because the following error occurred: Error:
    C:\ford\liberty\20.0.0.12_kernel\usr\shared\config\null
    
    
    here
    is a log of the same test from a linux host:
    
    
    bin/featureUtility installServerFeatures --acceptLicense
    --verbose server1
    
    [12/17/20 10:35:01:407 EST] Checking for
    missing features required by the server ...
    
    [12/17/20
    10:35:01:540 EST] file not found for bootstrap.properties
    under
    server: server1
    
    [12/17/20 10:35:01:554 EST] CWWKF1241E: Failed
    to read null because the following error occurred: Error:
    /proj/wlp/usr/shared/config/null
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users of IBM WebSphere Application      *
    *                  Server Liberty                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: environment variables in file names are *
    *                      not parsed and replaced for             *
    *                      featureUtility and installUtility       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    environment variables in file names are not parsed and replaced
    for featureUtility and installUtility. i.e
    /test/path/${myserver}.xml will not replace myserver with the
    appropriate variable, instead it will return
    /test/path/${myserver}.xml  unchanged
    

Problem conclusion

  • The featureUtility and installUtility configParser was changed
    to accommodate variable substitution in filenames
    
    The fix for this APAR is currently targeted for inclusion in fix
    pack 21.0.0.1.  Please refer to the Recommended Updates page for
    delivery information:
    http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH32961

  • Reported component name

    LIBERTY PROFILE

  • Reported component ID

    5724J0814

  • Reported release

    CD0

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-12-24

  • Closed date

    2021-03-08

  • Last modified date

    2021-03-08

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

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

Fix information

  • Fixed component name

    LIBERTY PROFILE

  • Fixed component ID

    5724J0814

Applicable component levels

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"CD0"}]

Document Information

Modified date:
10 March 2021