A fix is available
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
R850 PSY
UP
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.5","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
02 November 2021