PH36935: WASPREUPGRADE - THE "PLUGINS" DIRECTORY WAS NOT IN THE LIST OF WAS_INSTALL_ROOT PROTECTED DIRECTORIES

APAR status

• Closed as program error.

Error description

• WASPreUpgrade examines whether collecting the "mjar" (migration
  jar) will cause harm to the new WebSphere environment when it is
  processed later by WASPostUpgrade. If it thinks it will be
  harmful the following message is issued as was done for the
  "<classPath>${WAS_INSTALL_ROOT}/runtimes</classPath>" entry: MIG
  corrupting the new application server installation or target
  profile There was no message for the
  "<classPath>${WAS_INSTALL_ROOT}/plugins</classPath>" entry
  because in the migration code the "plugins" directory was not in
  the list of WAS_INSTALL_ROOT protected directories, so
  WASPreUpgrade created the "mjar" and WASPostUpgrade processed it
  replacing the com.ibm.ws.migration.jar with the v8.0 version
  right in the middle of the migration.
  

Local fix

• Re-install v8.5.5 Go back to v8.0 and use the admin console to
  remove the "${WAS_INSTALL_ROOT}/plugins" from the library
  classpath. Rerun WASPreUpgrade Ensure there is no .../plugins/pl
  Re-run WASPostUpgrade
  
  After the migration you can add the
  "${WAS_INSTALL_ROOT}/plugins" back to the library's classpath if
  you would like.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: When migrating from WebSphere           *
  *                      traditional                             *
  *                      version 8.0 to 8.5.5 using the          *
  *                      WASPostUpgrade tool a                   *
  *                      java.lang.ClassNotFoundException:       *
  *                      com.ibm.ws.migration.common.WCCMDocumen *
  *                      tR                                      *
  *                      eflector$CrossReferenceData is thrown.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The WebSphere plugins directory was set as a library class path.
  The WASPostUpgrade tool should exclude migrating the plugins
  directory.
  

Problem conclusion

• The migration tooling was updated to exclude migrating the
  WebSphere plugins directory.
  
  The fix for this APAR is targeted for inclusion in fix pack
  8.5.5.21. For more information, see 'Recommended Updates for
  WebSphere Application Server':
  https://www.ibm.com/support/pages/node/715553
  

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

  WEBSPHERE APP S

• Fixed component ID

  5724J0800

Applicable component levels

• R850 PSY

     UP