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

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 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