Download
Abstract
WASPostUpgrade fails trying to locate the "etc" dir in the backup dir when migrating from V5.1 to V7.0 on iSeries.
Download Description
PM09810 resolves the following problem:
ERROR DESCRIPTION:
Migration of IBM WebSphere Application Server V5.1 to WebSphere Application Server V7.0 on IBM i results in a failure during the WASPostUpgrade phase.
The post-upgrade trace shows the following exception message:
UpgradeBase > handleException Entry
com.ibm.ws.migration.utility.UpgradeException:
com.ibm.wsspi.migration.document.exceptions.NotFoundException:
etc
This message states that the post-migration process is searching the migration backup data for a directory named "etc", but it is unable to find that directory. In this scenario, the "etc" subdirectory does not exist within the migration backup data, but it does seem to be present in the original V5.1 product data. The "etc" subdirectory typically contains keystore and keyring files (related to Application Server security).
Due to security requirements specific to WebSphere Application Server on IBM i, the pre-migration process intentionally does not cull the security files from the "etc" directory in the V5.1 product data. However, the post-migration process attempts to locate the "etc" directory in the migration backup data, and it produces the error mentioned above when it does not find that directory.
LOCAL FIX:
To work around this issue, create an empty directory named "etc" in the migration backup data. The directory does not need any files to be copied into it. The post-migration tool will proceed without error if it is able to read the "etc" directory within the migration backup data.
PROBLEM SUMMARY
USERS AFFECTED:
All users of IBM WebSphere Application Server V7.0 on iSeries migrating from v5.1 to v7.0
PROBLEM DESCRIPTION:
WASPostUpgrade fails trying to locate the "etc" dir in the backup dir when migrating from V5.1 to V7.0 on iSeries.
RECOMMENDATION:
None
iSeries for V5.1 does not migrate the "etc" dir and therefore the WASPreUpgrade process did not back it up. WASPostUpgrade then expects the "etc" to be in the backup dir, and when not found will throw an exception.
PROBLEM CONCLUSION:
Upgrade WASPostUpgrade to not fail on iSeries when the "etc" directory is not located in the backup directory.
The fix for this APAR is currently targeted for inclusion in
fix pack 7.0.0.11. Please refer to the Recommended Updates
page for delivery information:
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
Prerequisites
Please download the UpdateInstaller below to install this fix.
Installation Instructions
Please review the readme.txt for detailed installation instructions.
Technical Support
Contact IBM Support using SR (http://www.ibm.com/software/support/probsub.html), visit the WebSphere Application Server support web site (http://www.ibm.com/software/webservers/appserv/was/support/), or contact 1-800-IBM-SERV (U.S. only).
Problems (APARS) fixed
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg24026494