Migrating product configurations with migration tools

Migration support consists of tools that are included with WebSphere® Application Server. These tools primarily provide support for saving the configuration and applications from a previous version of the product into a migration-specific backup directory and then importing that configuration into the latest version of the application server.

Before you begin

Read Overview of migration, coexistence, and interoperability and Premigration considerations. For resources to help you plan and perform your migration, visit Knowledge Collection: Migration planning for WebSphere Application Server.

Important: 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 WebSphere Application Server, you are likely to encounter a problem with the migration.

The migration scripts are located in the app_server_root/bin directory after installation.

The WASPreUpgrade tool is also on the migration disk so that you can store the configuration of an existing release before installing the Version 7.0 product. The tools on the product disk provide the necessary function for migrating from a previous release of WebSphere Application Server to the one on the product disk.

Procedure

Select the appropriate migration tools to migrate your product configurations.
Migration wizard
You use the Migration wizard to migrate an earlier supported version of WebSphere Application Server to Version 7.0.

The wizard is the graphical interface to the primary Version 7.0 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. If you want to run migration in a non-graphical environment, use the WASPreUpgrade and WASPostUpgrade commands.

Read Migrating product configurations with the migration wizard for more information.

WASPreUpgrade tool
You use the WASPostUpgrade tool to save the applications and configuration data from a previous installation of WebSphere Application Server to a backup directory.

The WASPostUpgrade tool restores the configuration data from the directory to the new installation.

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.

Read WASPreUpgrade command for more information.

WASPostUpgrade tool
You use the WASPostUpgrade tool to restore 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.

Read WASPostUpgrade command for more information.

clientUpgrade tool
You can use the clientUpgrade tool to upgrade the client application to a new release level.

Read clientUpgrade command for more information.

convertScriptCompatibility tool
Administrators use the convertScriptCompatibility tool to convert their configuration from a mode that supports backward compatibility of Version 5.1.x or Version 6.x administration scripts to a mode that is fully Version 7.0.

Read convertScriptCompatibility command for more information.

convertSelfSignedCertificatesToChained task
Chained certificates are the default certificate type in Websphere Application Server Version 7.0. Administrators can use the convertSelfSignedCertificatesToChained task with the wsadmin tool to convert self-signed certificates to chained certificates.

Read the "SSLMigrationCommands command group for the AdminTask object" article for more information.

Tip: For help, read Troubleshooting migration.

What to do next

Use the selected tools to migrate your product configuration.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 12:47:02 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-express-dist&topic=tmig_tools
File name: tmig_tools.html