PI27558: TOLERATE EQUINOX OSGI.CLEAN PROPERTY

8.5.5.4: WebSphere Application Server V8.5.5 Fix Pack 4
8.5.5.5: WebSphere Application Server V8.5.5 Fix Pack 5
8.5.5.6: WebSphere Application Server V8.5.5 Fix Pack 6
8.5.5.7: WebSphere Application Server V8.5.5 Fix Pack 7
8.5.5.8: WebSphere Application Server V8.5.5 Fix Pack 8
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21

APAR status

• Closed as program error.

Error description

• Since WebSphere Application Server Liberty Profile relies on
  Equinox for OSGi support, various aspects of the server
  environment can be influenced by certain Equinox settings.  In
  particular, if the system property "osgi.clean" is set, then the
  OSGi framework that is used by the WebSphere Application Server
  Liberty Profile at server startup time will clear any OSGi data
  the OSGi framework has previously cached.
  .
  The WebSphere Liberty Server Liberty Profile server command has
  its own "--clean" command line option (on the server command) to
  properly clear all cached data. This is the supported way to
  have Liberty Profile clear all the cached data, which includes
  both the OSGi framework and other Liberty specific data.
  .
  Relying on the "osgi.clean" system property will clear the OSGi
  framework cached data, but leaves the Liberty Profile cached
  data intact. There is a relationship between the OSGi cached
  data and the Liberty Profile data and both must be cleared at
  the same time.  If they are not, undefined behavior may result
  as a corruption of the cached data on disk.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server Liberty Profile                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Tolerate Equinox osgi.clean property    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Since WebSphere Application Server Liberty Profile relies on
  Equinox for OSGi support, various aspects of the server
  environment can be influenced by certain Equinox settings.  In
  particular, if the system property "osgi.clean" is set, then the
  OSGi framework that is used by the WebSphere Application Server
  Liberty Profile at server startup time will clear any OSGi data
  the OSGi framework has previously cached.
  The WebSphere Liberty Server Liberty Profile server command has
  its own "--clean" command line option (on the server command) to
  properly clear all cached data. This is the supported way to
  have Liberty Profile clear all the cached data, which includes
  both the OSGi framework and other Liberty specific data.
  Relying on the "osgi.clean" system property will clear the OSGi
  framework cached data, but leaves the Liberty Profile cached
  data intact. There is a relationship between the OSGi cached
  data and the Liberty Profile data and both must be cleared at
  the same time.  If they are not, undefined behavior may result
  as a corruption of the cached data on disk.
  

Problem conclusion

• Tolerate the Equinox "osgi.clean" property by triggering a
  Liberty Profile "--clean" when osgi.clean is set.  This will
  clear all cached data properly.
  The fix for this APAR is currently targeted for inclusion in fix
  pack 8.5.5.4.  Please refer to the Recommended Updates page for
  delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

Temporary fix

• Use the WebSphere Application Server Liberty Profile "--clean"
  command line option and  remove the "osgi.clean" system
  property.
  

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

• R855 PSY

     UP