Migrate a V5.x deployment manager configuration instance to a V6 deployment manager profile

The migration tools of WAS Network Deployment V6 support migrating a configuration instance of Network Deployment V5.x to a Network Deployment V6 profile.


Before you begin

This topic describes migrating a V5.x Network Deployment configuration instance to a V6 profile.

Migrate V5.x of WebSphere Application Server Network Deployment to V6 before migrating the base nodes that comprise the cell. The Network Deployment node must always be at the highest release and fix level within a cell, to allow it to manage all nodes in the cell. Starting with V6, the deployment manager has the capability to manage both V6 and V5.x release nodes. This allows a cell to be upgraded to a new release one node at a time, with minimal impact to the applications that are running within the cell.

If you have a Web services gateway running on a V5 application server that is part of a network deployment cell, and you want to migrate the cell from a V5 to a V6 deployment manager, you must first preserve the gateway configuration as described in Co-existing with previous gateway versions.



Use the following procedure to migrate the deployment manager instance.



  1. Stop the V5.x deployment manager. Use the stopManager command from the install_root/bin directory. For example, use the following command on a Linux platform


    If you have security enabled, specify the -user and -password parameters of the command.

    You can migrate a V5.x deployment manager without stopping it, but it is not necessary for it to be running for you to migrate its configuration. The migration tools can retrieve all the configuration data while the deployment manager is either running or stopped. However, stop the V5.x deployment manager before one can start the V6 deployment manager that you are installing, so it makes sense to stop it now.

  2. Use the migration tools to migrate the V5.x configuration to V6. The Migration wizard, which is the graphical interface to the V6 command line migration tools (WASPreUpgrade and WASPostUpgrade), is the recommended migration tool. For detailed instructions and information on the new Migration wizard, see Using the Migration wizard. The instructions below describe migration using the command line migration tools.

    1. Install the V6 product on the same machine as the V5.x deployment manager.

    2. Create a new deployment manager profile with the same node name, host name, and cell name as the V5.x cell. Also, ensure that the port numbers for the new V6 deployment manager match the port numbers used by the V5.x deployment manager.

    3. Verify the installation of the V6 deployment manager. Use the First Steps tool when it appears at the end of installing the product, or run the installation verification test yourself, if the First Steps tool does not appear for some reason.

    4. Stop the V6 deployment manager.

    5. From the V6 deployment manager's <profile>/bin directory, run the following command:


       ./WASPreUpgrade.sh <backupDmgrDir> <V5_location>


       WASPreUpgrade.bat <backupDmgrDir> <V5_location>
      where backupDmgrDir is the name of the directory you want the output of WASPreUpgrade to be stored, and V5_location is the location where the V5.x deployment manager is installed.

    6. From the V6 deployment manager's <profile>/bin directory, run the following command:


      ./WASPostUpgrade.sh <backupDmgrDir> -oldProfile <host_instanceName> -profileName <dmgrProfileName>


       WASPostUpgrade.bat <backupDmgrDir> -oldProfile <host_instanceName> -profileName <dmgrProfileName>
      where backupDmgrDir is the same directory you specified in WASPreUpgrade, and dmgrProfileName is the name of the V6 deployment manager profile. (See WASPostUpgrade command for more information on WASPostUpgrade.)

    7. Start the V6 deployment manager.

    8. Optional: Uninstall the V5.x node. Perform this step only after you are certain that you have successfully migrated the configuration of the deployment manager you intend to delete. During migration processing, the V5.x Network Deployment environment will be disabled. This is done to prevent an unsupported scenario, such as a node being managed by two different cells, from occurring. The V5.x Network Deployment environment can be enabled by executing the following Jacl script from the V5.x Network Deployment/bin directory




After the deployment manager is upgraded to V6, each node in the cell may then be upgraded incrementally, one at a time. The following diagram illustrates a mixed-release cell containing a V6 deployment manager with both V5 and V6 managed nodes:

The migration tools migrate V5.x Samples to the V6 Network Deployment node, to support cell members at the V5.x level. If the migration did not migrate the V5.x Samples, a synchronization would remove the Samples from the V5.x nodes. After migrating all federated nodes to V6, the V5.x Samples remain in the configuration. You can remove the V5.x Samples at that time or replace them with the V6 samples.


What to do next

Return to Migrating configuration data to continue.


See Also

Migration tools


See Also

addNode command
removeNode command
serverStatus command
startNode command
startServer command
stopNode command
stopServer command
startManager command
stopManager command




WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.
IBM is a trademark of the IBM Corporation in the United States, other countries, or both.