IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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 number

    PH36935

  • Reported component name

    WEBSPHERE APP S

  • Reported component ID

    5724J0800

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-05-04

  • Closed date

    2021-07-21

  • Last modified date

    2021-07-21

  • 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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"850"}]

Document Information

Modified date:
22 July 2021