IBM Support

PH19983: WASPREUPGRADE MIGRATION SCRIPT FAILS TO RUN ON AIX

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

  • WASUpgrade script fail to run on AIX with following
    exception
    
    [12/05/2019 16:50:51:994 MSK] MIGR0385I: Starting to
    save profile Dmgr01.
    java.lang.NullPointerException
    	at com.ibm.
    ws.migration.common.FileUtilities.isQuoted(FileUtilities.java:65
    3)
    	at com.ibm.ws.migration.common.FileUtilities.unquoteString(F
    ileUtilities.java:636)
    	at com.ibm.ws.migration.common.FileUtili
    ties.getUnquotedName(FileUtilities.java:612)
    	at com.ibm.ws.migr
    ation.common.DefaultOSInfo.configRoot(DefaultOSInfo.java:576)
    	a
    t com.ibm.ws.migration.preupgrade.R50BackupFiles.baseBackupFiles
    (R50BackupFiles.java:199)
    	at com.ibm.ws.migration.preupgrade.De
    faultBackupFiles.createTransformMappings(DefaultBackupFiles.java
    :97)
    	at com.ibm.ws.migration.preupgrade.DefaultBackupFiles.<ini
    t>(DefaultBackupFiles.java:59)
    	at com.ibm.ws.migration.preupgra
    de.R50BackupFiles.<init>(R50BackupFiles.java:87)
    	at com.ibm.ws.
    migration.preupgrade.PreUpgradeTransformProviderImpl.provideDefa
    ultTransforms(PreUpgradeTransformProviderImpl.java:139)
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users of IBM WebSphere Application      *
    *                  Server Configuration Migration Tools        *
    ****************************************************************
    * PROBLEM DESCRIPTION: NullPointerException in                 *
    *                      FileUtilities.isQuoted when running     *
    *                      WASPreUpgrade, usually on non-Linux     *
    *                      operating systems.                      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Migration scans the setupCmdLine script looking for any
    adjustments that may have been made to the WAS_HOME
    environment variable for use by WebSphere Application Server
    processes. If it encounters a path with multiple directory
    separators that is partially quoted, it attempts to
    deconstruct the path and remove the quotes. In the course of
    this, if it attempts to unquote a parent directory when there
    are no more parent directories in the path, the
    NullPointerException occurs.
    

Problem conclusion

  • Migration was adjusted to handle the instance in which there
    is no parent directory to unquote.
    
    The fix for this APAR is targeted for inclusion in fix pack
    8.5.5.17.  For more information, see 'Recommended Updates for
    WebSphere Application Server':
    http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
    

Temporary fix

  • Temporarily edit the setupCmdLine file in question to remove
    any lines containing WAS_HOME= for the purposes of running
    WASPreUpgrade. This workaround may not work if the WAS
    installtion requires WAS_HOME to be set to a nondefault value
    in setupCmdLine--the APAR will be required in that case.
    

Comments

APAR Information

  • APAR number

    PH19983

  • Reported component name

    WEBS APP SERV N

  • Reported component ID

    5724H8800

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-12-05

  • Closed date

    2020-01-07

  • Last modified date

    2020-01-07

  • 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

    WEBS APP SERV N

  • Fixed component ID

    5724H8800

Applicable component levels



Document information

More support for: WebSphere Application Server
General

Software version: 850

Reference #: PH19983

Modified date: 07 January 2020