Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

---

 

Migrate to a V6.1 deployment manager

Use this procedure to migrate from a WebSphere^® Extended Deployment Version 6.0.2 deployment manager to a WebSphere Extended Deployment Version 6.1 deployment manager.

 

Before you begin

Ensure that your workstation has a sufficient amount of drive space to support a mixed cell environment, and the names of the cell and the nodes are the same to successfully migrate from V6.0.2 to V6.1. You must download and install the required interim fix for the XDPreUpgrade command before you can use the utility in the migration process to save your Version 6.0.2 configurations to a backup directory. Download the XDPreUpgrade Interim Fix from the WebSphere Extended Deployment support site:

• Type PK43942 in the Search Support field. This is the specific APAR number for the interim fix.

• Select Download (Fixes, Utilities, APARs) to limit the returned results, and click Search.

 

About this task

WebSphere Extended Deployment V6.1 introduces a new strategy for migrating and merging the configuration of separate products. With previous versions, you were required to complete a migration process in which you migrate the deployment manager and all of the nodes at the same time. With V6.1, you first migrate the deployment manager, and then migrate each node one at a time, which creates a mixed cell environment.

Additionally, if you have an existing installation of WebSphere Extended Deployment Version 6.0.2 on WebSphere Application Server Network Deployment V6.1, you can migrate directly from V6.0.2 to V6.1 without having to install or migrate WebSphere Application Server Network Deployment.

Complete the following steps to update the V6.0.2 deployment manager with the V6.1 deployment manager.

 

Procedure

• To migrate a WebSphere Extended Deployment Version 6.0.2 deployment manager that exists with WebSphere Application Server Network Deployment Version 6.0.2:

  1. Install WebSphere Application Server Network Deployment Version 6.1 on the workstation that hosts the deployment manager.

  2. Use the manageprofiles command to create a Network Deployment V6.1 deployment manager profile.

  3. Issue the WASPreUpgrade and WASPostUPgrade commands to migrate the deployment manager to the Network Deployment V6.1 product level.

  4. Install WebSphere Extended Deployment Operations Optimization V6.1 on the same workstation that you installed Network Deployment V6.1. You must first install the Operations Optimization component to install the Compute Grid or Data Grid components.

  5. Augment the deployment manager profile that you created in step b. with the xd_augment template, which is the profile augment template for WebSphere Extended Deployment Operations Optimization V6.1. If you install multiple V6.1 components, augment the profile for that particular component.

     Use the wxdcg_augment template for WebSphere Extended Deployment Compute Grid, and use the wxddg_augment template for WebSphere Extended Deployment Data Grid.

  6. Start the Migration wizard or issue the XDUpgrade command to migrate the deployment manager to WebSphere Extended Deployment Version 6.1. To start the Migration wizard, run the following command:

     • install_root/bin/xd_migration.bat

     • install_root/bin/xd_migration.sh
     Issue the XDUpgrade command from the target_profile/bin directory:

     • XDUpgrade.bat

     • ./XDUpgrade.sh

     For further details on the WASPreUpgrade and WASPostUpgrade commands, and the Network Deployment installation and profile creation process, refer to the WebSphere Application Server Network Deployment Information Center.

• To migrate a WebSphere Extended Deployment Version 6.0.2 deployment manager that exists with WebSphere Application Server Network Deployment Version 6.1:

  1. Stop the deployment manager by issuing the stopManager command:

     • stopManager.bat

     • ./stopManager.sh

  2. Issue the XDPreUgrade command from the source_profile/bin directory to save the V6.0.2 product configurations:

     • XDPreUpgrade.bat -create

     • ./XDPreUpgrade.sh -create

  3. Uninstall WebSphere Extended Deployment Version 6.0.2, and install WebSphere Extended Deployment V6.1 in the same location. You must first install the Operations Optimization component to install the Compute Grid or Data Grid components.

  4. Augment the WebSphere Application Server profile for WebSphere XD by issuing xd_augment, which is the profile augment template for WebSphere Extended Deployment Operations Optimization. If you install multiple V6.1 components, augment the profile for that particular component.

     Use the wxdcg_augment template for WebSphere Extended Deployment Compute Grid, and use the wxddg_augment template for WebSphere Extended Deployment Data Grid.

  5. Start the Migration wizard or issue the XDUpgrade command to migrate the deployment manager to WebSphere Extended Deployment Version 6.1. To start the Migration wizard, run the following command:

     • install_root/bin/xd_migration.bat

     • install_root/bin/xd_migration.sh
     Issue the XDUpgrade command from the target_profile/bin directory:

     • XDUpgrade.bat

     • ./XDUpgrade.sh

  Your cell is updated and now contains WebSphere Extended Deployment Version 6.1.

 

Results

You can check the log files if the migration fails:

• For the Operations Optimization component, the files are located in install_root/logs/xd.xdopupgrade.log

• For the Compute Grid component, the files are located in install_root/logs/xd.xdcgupgrade.log

• For the Data Grid component, the files are located in install_root/logs/xd.xddgupgrade.log

 

What to do next

Migrate the nodes to the V6.1 level.

---

 

Related concepts

XDPreUpgrade command
XDUpgrade command
Where migration tasks are performed

 

Related tasks

Installing WebSphere XD
Use the Profile Management tool to create and augment profiles