IBM Support

PI71093: NODE MIGRATION TO WEBSPHERE 9.0 FAILS WHEN VARIABLES.XML IS NOT IN THE CLUSTER LEVEL.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When migrating to WebSphere 9.0, after the Deployment Manager
    has been migrated, the BBOWMG3F job fails and these messages
    are seen:
    MIGR0302I: The existing files are being saved.
    MIGR0385I: Starting to save profile default
    variables.xml
    com.ibm.wsspi.migration.document.exceptions.NotFoundException:
    variables.xml  .at
    com.ibm.ws.migration.document.BasicDocumentCollection.createDocu
    ment(BasicDocumentCollection.java:1042) .at
    com.ibm.ws.migration.document.BasicDocumentCollection.openReadOn
    lyDocument(BasicDocumentCollection.java:1209)  .at
    com.ibm.ws.migration.document.BasicDocumentCollection.openDocume
    nt(BasicDocumentCollection.java:1169)
    .........
    Also,  in the node configuration being migrated there is not
    even one variable defined at the cluster level and therefore
    there is not a variables.xml file at the cluster level.
    

Local fix

  • At the cluster level create a dummy variable via the admin
    console and then sync this to all related nodes.  Then your
    node migration should proceed without creating  a
    NotFoundException: variables.xml
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users of the configuration migration    *
    *                  tools with clusters, migrating to IBM       *
    *                  WebSphere Application Server V9.0           *
    ****************************************************************
    * PROBLEM DESCRIPTION: WASPreUpgrade fails when a cluster      *
    *                      exists that does not contain a          *
    *                      variables.xml configuration file.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    WASPreUpgrade will fail with
    "com.ibm.wsspi.migration.document.exceptions.NotFoundException:
    variables.xml". The callstack should
    include
    com.ibm.ws.migration.preupgrade.LibrariesClusterCopyDocumentProc
    essor.instantiateVariables(), otherwise this is not the same
    problem.
    

Problem conclusion

  • The WASPreUpgrade code has been updated to tolerate the case
    where a cluster does not include a variables.xml directly in
    its configuration.
    
    APAR PI71093 is currently targeted for inclusion in Fix Pack
    9.0.0.3 of WebSphere Application Server.
    
    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 number

    PI71093

  • Reported component name

    WEBSPHERE FOR Z

  • Reported component ID

    5655I3500

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-10-21

  • Closed date

    2016-12-19

  • Last modified date

    2016-12-19

  • 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 FOR Z

  • Fixed component ID

    5655I3500

Applicable component levels

  • R900 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"900","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
19 October 2021