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

Supported configurations:

This topic is about configuration migration, such as migrating deployment managers and federated nodes in a network deployment environment. The Application Migration Toolkit for WebSphere Application Server provides support for migrating applications from previous versions of WebSphere Application Server to the latest product version. For information about migrating applications, read more about the Migration Toolkit.

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.

[AIX Solaris HP-UX Linux Windows]You can use the WASPreUpgrade command to store the configuration of an existing release before you migrate to the Version 8.5 product.

Procedure

Select the appropriate migration tools to migrate your product configurations.
[AIX Solaris HP-UX Linux Windows]Migration wizard
[AIX Solaris HP-UX Linux Windows]You use the Migration wizard to migrate an earlier supported version of WebSphere Application Server to Version 8.5.

The wizard is the graphical interface to the primary Version 8.5 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.

[AIX Solaris HP-UX Linux Windows]WASPreUpgrade command
[AIX Solaris HP-UX Linux Windows]You use the WASPreUpgrade command to save the applications and configuration data from a previous installation of WebSphere Application Server to a backup directory.

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

[AIX Solaris HP-UX Linux Windows]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.

[AIX Solaris HP-UX Linux Windows]WASPostUpgrade command
[AIX Solaris HP-UX Linux Windows]You use the WASPostUpgrade command to restore the configuration data from a previous release.

The WASPostUpgrade command reads the data from the backup directory where the WASPreUpgrade command stored the data.

[AIX Solaris HP-UX Linux Windows]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.

[AIX Solaris HP-UX Linux Windows]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 6.1 or later administration scripts to a mode that is fully Version 8.5.

Read convertScriptCompatibility command for more information.

convertSelfSignedCertificatesToChained task
Chained certificates are the default certificate type in WebSphere Application Server Version 8.5. 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.