Use the migration tools to migrate from Network Deployment Version
5.x to a Version 6.0.x deployment manager.
Before you begin
Migrate WebSphere Application Server Network Deployment Version
5.x to Version 6.0.x before migrating the base nodes that comprise the cell.
The deployment manager must always be at the highest release and fix level
within a cell, to allow it to manage all nodes in the cell. In Version 6.0.x,
the deployment manager has the capability to manage both Version 6.0.x and
Version 5.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 are migrating to a deployment manager on a remote
machine, you can follow the steps outlined for an application server in Migrating from Version 5.x to a Version 6.0.x standalone application
server on a remote machine
. The
steps are identical for a deployment manager.
About this task
Use the following procedure to migrate the deployment manager.
Procedure
- Stop the Version 5.x deployment manager.
Use the
stopManager command
from the
app_server_root/bin directory.
See
stopManager command
. For example,
use the following command on a Linux platform:
./stopManager.sh
If
you have security enabled, specify the -user and -password parameters of the
command.
You can migrate a Version 5.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, you must stop the Version 5.x
deployment manager before you can start the Version 6.0.x deployment manager
that you are installing, so it makes sense to stop it now.
- Use the migration tools to migrate the Version 5.x configuration
to Version 6.0.x. The Migration wizard, which is the graphical interface to the
Version 6.0.x 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.
- Install the Version
6.0.x product on the same machine as the Version 5.x deployment manager.
- Create
a new deployment manager profile with the same cell name as the Version
5.x cell. You should also use the same node name as the Version 5.x cell.
This makes migration smoother, because the Version 5.x node agents
will still work without being restarted.
- Verify the installation of the Version 6.0.x deployment manager.
Use the First
Steps tool when it opens 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.
- Stop the Version 6.0.x deployment manager.
- Use the Migration
wizard to migrate the deployment
manager to Version 6.0.x.
- Start the Version 6.0.x deployment manager.
- Optional: Uninstall
the Version 5.x deployment manager. 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 Version 5.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 Version 5.x Network Deployment environment can
be enabled by running the following JACL script from the Version 5.x Network
Deployment/bin directory:
migrationDisablementReversal.jacl
- See Migrating a Version 5.x managed node to a Version 6.0.x managed node
for
information on iteratively migrating each federated node to Version 6.0.x.
Results
After the deployment manager is upgraded to Version 6.0.x, each
node in the cell can then be upgraded incrementally, one at a time. The following diagram
illustrates a mixed-release cell containing a Version 6.0.x deployment manager
with both Version 5.x and Version 6.0.x managed nodes:

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