Use the migration tools to migrate product configurations
Migration support consists of tools that are shipped as part of WAS V6.1 that primarily provide support for saving the configuration and applications from an older version of WebSphere into a migration-specific backup directory and then importing that configuration into V6.1.
See Overview of migration, coexistence, and interoperability and Premigration considerations.
Use the migration tools for the version of WebSphere Application
Server that you are installing. The tools change over time. If you use migration tools from an earlier release of WAS, you are likely to encounter a problem with the migration.
All of the migration scripts are in the app_server_root/bin directory after installation.
The WASPreUpgrade tool also ships on the utilities disk so that you can store the configuration of an existing release before installing the V6.1 product. The tools on the product disk provide the necessary function for migrating from a previous release of WAS to the one on the product disk. The tools on the disk match the product on the disk.
Procedure
Select the appropriate migration tools to migrate your product configurations.
- Migration wizard
-
Used to migrate an earlier supported version of WebSphere Application
Server to V6.1. The wizard is the graphical interface to the primary
V6.1 migration tools, the WASPreUpgrade and the WASPostUpgrade commands.
The Migration wizard cannot run in a non-graphical environment. Examples of non-graphical environments include telnet sessions. To run migration in a non-graphical environment, use the WASPreUpgrade and WASPostUpgrade commands described below.
See Use the Migration wizard to migrate product configurations.
- WASPreUpgrade tool
-
Saves the applications and configuration data from a previous installation of WAS to a backup directory.
The
Migration wizard calls the WASPreUpgrade command during migration. You can also use the command to perform a manual migration after installing the new version.
See WASPreUpgrade command.
- WASPostUpgrade tool
-
Restores the configuration data from a previous release.
The WASPostUpgrade tool reads the data from the backup directory where the WASPreUpgrade tool stored the data.
The Migration wizard calls the WASPostUpgrade command during migration. You can also use the command to perform a manual migration after installing the new version.
See WASPostUpgrade command.
- clientUpgrade tool
-
Upgrades the client application to a new release level.
See clientUpgrade command.
- convertScriptCompatibility tool
-
Used by administrators to convert their configuration from a mode that supports backward compatibility of V5.x or 6.0.x administration scripts to a mode that is fully V6.1.
See convertScriptCompatibility command.
For help in troubleshooting problems when migrating, see Troubleshooting migration.
What to do next
Use the selected tools to migrate your product configuration.
Use the Migration wizard to migrate product configurations
Use the utilities disk to migrate product configurations
clientUpgrade command
convertScriptCompatibility command
WASPreUpgrade command
WASPostUpgrade command
|