WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Migrating product configurations

Use the migration tools to migrate WebSphere Application Server product configurations.

Before you begin

Important: If your WebSphere Application Server environment matches either of the following two conditions, you must upgrade all the clients and servers that use the service integration technologies to Version 6.0.0.2 before you upgrade any such client or server to Version 6.0.1 or later:
  • Your WebSphere Application Server environment consists of one or more cells with multiple nodes and servers using the service integration technologies
  • Your WebSphere Application Server environment uses a topology with clients that connect to a server using service integration technology messaging

You can migrate your product configurations using the Migration wizard or the command-line migration tools.

If you use an earlier version of WebSphere Application Server, the system administrator might have fine-tuned various application and server settings for your environment. It is important to have a strategy for migrating these settings with maximum efficiency and minimal loss.

You can perform incremental migration of WebSphere Application Server Version 4.0.x nodes by calling the migration tools multiple times, each time specifying a different configuration file. Various reasons exist for having multiple configuration files. Whatever the reason, migrating one configuration file at a time lets you test applications incrementally before continuing to the next configuration file. You can also perform incremental migration of Version 5.x instances in the same manner.

Before using the migration tools, consult the WebSphere Application Server Version 6.0 Release Notes document to understand what fixes you must apply to earlier versions. Applying fixes to an earlier version might also apply fixes to files that have a role in the migration. Apply any fixes to ensure the most effective migration of configurations and applications possible.

The migration tools in WebSphere Application Server Version 6.0.x support migration from WebSphere Application Server Version 4.0.x, Version 5.0.x, and Version 5.1.x.

Why and when to perform this task

IBM provides a set of migration tools for migrating administrative configurations from Version 4.0.x, 5.0.x, or 5.1.x to the Version 6.0.x Network Deployment product.

When you use the migration tools, the overall migration process includes the following steps:
  1. Install the WebSphere Application Server Version 6.0.x product.

    See Installing the product and additional software.

  2. Use the WebSphere Application Server Version 6.0.x Profile creation wizard to create one or more profiles for a deployment manager, a managed node, or a stand-alone application server.

    See Creating profiles through the graphical user interface.

  3. Start the First steps console.
  4. Select the Migration wizard on the First steps console.
  5. [AIX][Solaris][Version 6.0.2]Click Exit on the First steps console.
  6. Use the Migration wizard to migrate the previous release to the Version 6.0.x product.

    See Using the Migration wizard.

The Migration wizard calls the WASPostUpgrade command. The WASPostUpgrade command uses the backupConfig command to save the existing Version 6.0.x configuration before performing migration. The results are stored in the profile_name/temp directory. You can use the restoreConfig command to restore the backup if required.

Steps for this task

  1. Migrate the deployment manager.
    Note: The WebSphere Application Server Version 6.0.x deployment manager must be running whenever you migrate a Version 5.x deployment manager to it. Also, if you are migrating a Version 5.x deployment manager, the Version 6.0.x deployment manager must have the same cell name.
  2. Migrate WebSphere Application Server Version 5.x and 4.0.x Express and base nodes.

    Select one of the following migration scenarios for information about how to migrate configuration data from a Version 4.0.x or 5.x Express node or a Version 4.0.x or 5.x base node to a Version 6.0.x stand-alone application server:

    Note: If you are migrating a WebSphere Application Server Version 5.x managed node to a Version 6.0.x managed profile, the node names must match.
  3. After migrating each base node, start each node.

    Use the startNode script from the profile_name/bin directory of each application server to start the node agent process. See startNode command.

    Occasionally, for example after rebooting an application server machine, you must restart the node agent server on the application server node, by running the startNode command from the profile_name/bin directory. To keep your application server nodes running without having to access the bin directory of each one, use the operating system to monitor and restart the node agent process on each application server node. (You can also set up the dmgr server as a managed process on the deployment manager node.) For more information, see Automatically restarting server processes.

  4. Configure the WebSphere Application Server environment after migration, as described in Configuring WebSphere Application Server after migration. This is a way of verifying the results of the migration tools. You can also use Configuration mapping during migration to verify the results of the migration. The article has a detailed description of how the migration tools migrate objects and what you should verify.

Result

You can use the migration tools to migrate from one version of WebSphere Application Server to another.

What to do next

Return to Migrating and coexisting to continue.



Sub-topics
Network Deployment migrations
Stand-alone migrations
Migration tools
Rolling back your environment to Version 5.x
Configuring WebSphere Application Server after migration
Task topic    

Terms of Use | Feedback

Last updated: Dec 11, 2005 4:07:15 PM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/tins_migadmin.html

© Copyright IBM Corporation 2002, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)