[AIX Solaris HP-UX Linux Windows]

Migrating to WebSphere Application Server Version 8.5 Intelligent Management cells

Use the VEUpgrade command to migrate a previous release of WebSphere® Virtual Enterprise to a WebSphere Application Server Version 8.5 Intelligent Management cell.

Before you begin

Update WebSphere Application Server Network Deployment Version 8.5.x to the latest maintenance level that is available. For more information about the latest fix packs, see the IBM® Support Portal. Read about Migrating cells using the command line tools.
Avoid trouble: If you run VEUpgrade with no parameters to get command line help, existing migration logs are overwritten. To retain the migration logs, copy the logs to a backup directory.

About this task

First migrate the deployment manager. Then migrate each application server node one at a time.

Supported configurations: If you are migrating a WebSphere Virtual Enterprise Version 6.1.1.x or 7.0.0.x cell with middleware agents to WebSphere Application Server Network Deployment Version 8.5.x, the middleware agents are not migrated. The middleware agents remain at the previous version, and you can continue to use the middleware agents and use the IBM Update Installer to install fix packs to the middleware agents separately. However, Version 7 is the last full release of WebSphere Virtual Enterprise, and there are no further releases of the middleware agent. To manage middleware servers from a WebSphere Application Server Network Deployment Version 8.5 or later deployment manager, it is recommended that you use the WebSphere Application Server node agent at the same release level. The node agent completely replaces the functions of the middleware agent.
Avoid trouble: Applications migrated from a WebSphere Application Server Network Deployment environment to a WebSphere Application Server Intelligent Management (ODRLIB) environment with an On Demand Router (ODR) will not have a default work class. The Java-based ODR will still route in absence of a default work class, however, the ODRLIB will not. For these migrated applications you will need to manually create default work classes.

Procedure

  1. Run the backupConfig command on the deployment manager and all nodes.
    The backupConfig command is a utility that is used to back up the configuration of the deployment manager and the nodes.
  2. Install WebSphere Application Server Network Deployment Version 8.5.x on each deployment manager and node.
    Specify a different installation location than the location in which the previous version exists. Read about installing the product and additional software in the documentation.
  3. Use the Profile Management Tool or the manageprofiles command to create your profiles for Version 8.5.x, but do not federate the nodes.
    Read about managing profiles.
  4. Migrate the deployment manager to your Version 8.5.x cell.
    You can use the WASPreUpgrade and WASPostUpgrade commands. The WASPreUpgrade command saves the previous configuration to a migration-specific backup directory, and the WASPostUpgrade command retrieves the saved configuration. Read about the WASPreUpgrade and the WASPostUpgrade command. For example, run:
    /opt/WebSphereV85/bin/WASPreUpgrade.sh /mybackup/v70tov85dmgr01 /opt/WebSphereV70 -oldProfile 70dmgr01
/opt/WebSphereV85/bin/WASPostUpgrade.sh /mybackup/v70tov85dmgr01 -profileName v70tov85dmgr01 -oldProfile 70dmgr01 
-replacePorts TRUE -backupConfig TRUE -includeApps TRUE -scriptCompatibility TRUE -keepDmgrEnabled FALSE 
-username myuser -password mypass
  5. Use the VEUpgrade command to migrate the product configuration data from an existing WebSphere Virtual Enterprise Version 6.1.0.5, Version 6.1.1, or Version 7.0 deployment manager to Version 8.5. Read about the VEUpgrade command.
    For example, run:
    C/opt/WebSphereV85/bin/VEUpgrade.sh -userid myser-password mypass -sourcewashome/opt/WebSphereV70 
-sourceprofilepath /opt/WebSphereV70/profiles/dmgr -targetprofilepath /opt/WebSphereV85/profiles/v70tov85dmgr01 
-traceDir c:/opt/VELOGS/v70tov85dmgr01
  6. Migrate the remaining nodes one at a time.
    The procedure to migrate each node is similar to the preceding procedure, except WebSphere Application Server Network Deployment already exists in your environment, and you create custom profiles instead of a deployment manager profile.
    1. Use the Profile Management Tool or the manageprofiles command to create a WebSphere Application Server Network Deployment custom profile.
    2. Migrate the node to your WebSphere Application Server Network Deployment Version 8.5.x cell.
      Run the WASPreUpgrade and WASPostUpgrade commands.
    3. Migrate the node to Version 8.5.
      Run the VEUpgrade command.

Results

Your cell is now at Version 8.5 level.