WebSphere Application Server Network Deployment, Version 6.1
             Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

             Personalize the table of contents and search results

Using the migration tools to migrate product configurations

Migration support consists of tools that are shipped as part of WebSphere Application Server Version 6.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 Version 6.1.

Before you begin

See Overview of migration, coexistence, and interoperability and Premigration considerations.

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.

All of the migration scripts are in the app_server_root/bin directory after installation.

[AIX HP-UX Linux Solaris Windows] The WASPreUpgrade tool also ships on the utilities disk so that you can store the configuration of an existing release before installing the Version 6.1 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. The tools on the disk match the product on the disk.

Procedure

Select the appropriate migration tools to migrate your product configurations.
Migration wizard [AIX HP-UX Linux Solaris Windows]
Used to migrate an earlier supported version of WebSphere Application Server to Version 6.1.
The wizard is the graphical interface to the primary Version 6.1 migration tools, the WASPreUpgrade and the WASPostUpgrade commands.
Note: 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 described below.

See Using the Migration wizard to migrate product configurations.

Customization Dialog [z/OS]
Used to collect the information and generate the JCL jobs (CNTL and DATA data sets) for migrating a standalone application server, deployment manager, or federated node. You must create these jobs before you can begin the actual migration.
The Customization Dialog is run from TSO. Use the following command to launch it:
ex 'product_hlq.SBBOCLIB(BBOWSTRT)' 'options'

See Using the ISPF Customization Dialog to create migration jobs and instructions.

z/OS Migration Management Tool [z/OS]
Eclipse plug-in, running under the Application Server Toolkit, used to collect the information and generate the JCL jobs (CNTL and DATA data sets) for migrating a standalone application server, deployment manager, or federated node. You must create these jobs before you can begin the actual migration.

See Using the z/OS Migration Management Tool to create and work with migration definitions.

WASPreUpgrade tool [AIX HP-UX Linux Solaris Windows] [i5/OS]
Saves the applications and configuration data from a previous installation of WebSphere Application Server to a backup directory.

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

See WASPreUpgrade command.

WASPostUpgrade tool [AIX HP-UX Linux Solaris Windows] [i5/OS]
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.

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

See WASPostUpgrade command.

clientUpgrade tool
Upgrades the client application to a new release level.

[AIX HP-UX Linux Solaris Windows] [z/OS] See clientUpgrade command.

[i5/OS] See clientUpgrade script.

convertScriptCompatibility tool
Used by administrators to convert their configuration from a mode that supports backward compatibility of Version 5.x or 6.0.x administration scripts to a mode that is fully Version 6.1.

See convertScriptCompatibility command.

Tip: For help in troubleshooting problems when migrating, see Troubleshooting migration.

What to do next

Use the selected tools to migrate your product configuration.



In this information ...


IBM Redbooks, demos, education, and more


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

This feature requires Internet access.

IBM Suggests
Task topic    

Terms of Use | Feedback

Last updated: Feb 25, 2009 9:32:38 AM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/tmig_tools.html