PH32363: INSTALLUTILITY AND FEATUREUTILITY IGNORES INCLUDED CONFIG FILES IN WINDOWS

APAR status

• Closed as program error.

Error description

• Customer sees following on Windows using 20.0.0.12. Issue
  seems
  to be resolved on Unix/Linux.
  
  <include
  location="${server.config.dir}/server2.xml"/>
  
  <include
  location="${server.output.dir}/server2.xml"/>
  
  <include location
  ="${env.BASE_PATH}/server2.xml"/>
  
  C:\liberty\20.0.0.12_kernel\b
  in>featureUtility.bat installServerFeatures --noCache
  --acceptLicense --verbose server1
  
  [12/2/20 15:27:32:276 EST]
  Checking for missing features required by the server
  ...
  
  [12/2/20 15:27:32:787 EST] file not found for
  bootstrap.properties under server: server1
  
  [12/2/20
  15:27:32:849 EST] Illegal char <:> at index 2:
  /C:\liberty\20.0.
  0.12_kernel/usr/servers/server1/server2.xml
  
  java.nio.file.Inval
  idPathException: Illegal char <:> at index 2:
  /C:\liberty\20.0.0.12_kernel/usr/servers/server1/server2.xml
  
  
  at sun.nio.fs.WindowsPathParser.normalize(Unknown Source)
  
  at
  sun.nio.fs.WindowsPathParser.parse(Unknown Source)
  
  at
  sun.nio.fs.WindowsPathParser.parse(Unknown Source)
  
  at
  sun.nio.fs.WindowsPath.parse(Unknown Source)
  
  at
  sun.nio.fs.WindowsFileSystem.getPath(Unknown Source)
  
  at
  java.nio.file.Paths.get(Unknown Source)
  
  at com.ibm.ws.install.
  internal.InstallUtils.getFeatures(InstallUtils.java:741)
  
  at co
  m.ibm.ws.install.internal.Director.getServerFeaturesToInstal
  l(Di
  rector.java:475)
  
  at com.ibm.ws.install.internal.InstallKernelI
  mpl.getServerFeaturesToInstall(InstallKernelImpl.java:266)
  
  at
  com.ibm.ws.install.featureUtility.cli.InstallServerAction.in
  stal
  lServerFeatures(InstallServerAction.java:174)
  
  at com.ibm.ws.in
  stall.featureUtility.cli.InstallServerAction.execute(Install
  Serv
  erAction.java:247)
  
  at com.ibm.ws.install.featureUtility.cli.In
  stallServerAction.handleTask(InstallServerAction.java:69)
  
  at c
  om.ibm.ws.install.featureUtility.cli.FeatureAction.handleTas
  k(Fe
  atureAction.java:92)
  
  at com.ibm.ws.install.featureUtility.Feat
  ureUtilityExecutor.main(FeatureUtilityExecutor.java:58)
  
  at
  sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
  
  
  at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown
  Source)
  
  at
  sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown
  Source)
  
  at java.lang.reflect.Method.invoke(Unknown Source)
  
  
  at
  com.ibm.ws.kernel.boot.cmdline.UtilityMain.internal_main(Uti
  l
  ityMain.java:173)
  
  at com.ibm.ws.kernel.boot.cmdline.UtilityMai
  n.main(UtilityMain.java:53)
  
  [12/2/20 15:27:33:487 EST] The
  server does not require any additional features. No features
  were installed.
  
  <---------------------> 0.00%
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server Liberty                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: include tag parsing did not work in     *
  *                      some cases on Windows                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  problem occurred because we did not use the windows file
  separators when parsing/handling include tags
  

Problem conclusion

• Resolved issue by fixing the code to resolve the paths using the
  OS appropriate file separators
  https://github.com/OpenLiberty/open-liberty/issues/15174
  
  The fix for this APAR is currently targeted for inclusion in fix
  pack 20.0.0.12.  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

  WAS LIBERTY COR

• Fixed component ID

  5725L2900

Applicable component levels