PH41660: AFTER 21.0.0.9 UPGRADE "DEFAULTHOSTNAME" DEFINITION IN BOOTSTRAP.PROPERTIES DOES NOT OVERWRITE LIBERTY DEFAULT.

APAR status

• Closed as program error.

Error description

• After upgrade to 21.0.0.9, with the following definition in
  server.xml:
  
  <httpEndpoint id="defaultHttpEndpoint"
  host="${defaultHostName}" httpPort="${defaultPort}"
  httpsPort="${defaultSecPort}" enabled="true" >
  
  and the variables defined in bootstrap.properties:
  defaultHostName=some.host.name
  ...
  
  the Liberty default of "localhost" is used instead of the
  defined value in bootstrap.propertes.
  
  
  The problem is only with this specific spelling of the
  variable
  "defaultHostName".
  

Local fix

• Use a variable name different from "defaultHostName", ex:
  "mydefaultHostName"
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  Liberty 21.0.0.9 - 22.0.0.1 users who had   *
  *                  defined a defaultHostName replacement       *
  *                  property in bootstrap.properties and who    *
  *                  used that property in <httpEndoint> in      *
  *                  server.xml.                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: defaultHostName substitution variable   *
  *                      should be picked up from                *
  *                      bootstrap.properties                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In 21.0.0.8 and earlier, the Liberty code would not replace the
  value from bootstrap.properties with the variable definition
  from defaultInstances. That issue was fixed on 21.0.0.8.
  The fix exposed an issue in Channel Framework where
  defaultHostName is set to a value "localhost" on the
  <httpEndpoint> by default and is not being allowed to be
  overwritten.
  
  The server.xml which shows the issue would look similar to this,
  where defaultHostName is defined in bootstrap.properties:
  
  
  <httpEndpoint id="defaultHttpEndpoint"
  
     host="${defaultHostName}"/>
  

Problem conclusion

• The code was updated to allow the defaultHostName property as
  defined in bootstrap.properties to replace the defaultHostName
  on the <httpEndpoint> clause in server.xml.
  
  The fix for this APAR is currently targeted for inclusion in fix
  pack 22.0.0.2.  Please refer to the Recommended Updates page for
  delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  
  The liberty issue which resolves this problem is
  https://github.com/OpenLiberty/open-liberty/issues/19841
  

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

• Fixed component ID

  5655W6514

Applicable component levels