Use the Migration wizard to migrate from a WebSphere Application
Server Version 5.x application server to a Version 6.0.x standalone application
server.
Before you begin
Collect the following information about your Version 5.x installation
before you begin this procedure. The Migration wizard prompts you for the
information during the migration:
- Installation root directory
See WASPreUpgrade command for a description of the
currentWebSphereDirectory parameter.
- Use port values assigned to previous installation?
Specifying “true”
causes any ports of matching VirtualHosts to first be removed from the new
configuration before adding the new values.
Specifying “false” for this
parameter will just add new port values.
See WASPostUpgrade command for a description of the
replacePorts parameter.
- Backup directory name
See WASPreUpgrade command for a description of the backupDirectory parameter.
- Target profile name.
See WASPostUpgrade command for a description of the profileName parameter.
Before using the Migration wizard, you should have installed Version
6.0.x already. Use the Profile creation wizard to create a valid new application
server profile if one does not already exist. After verifying that a valid
Version 6.0.x target exists, you can start the procedure.
The
Network Deployment product does not create a profile during installation because
there are three profile types. The Installation wizard prompts you to create
a profile, but that action is optional during installation. Create a standalone
application server profile if you have not already created one.
About this task
This article describes using the Migration wizard to migrate a
Version 5.x application server to a Version 6.0.x standalone application server.
Use the Migration wizard after installing Version 6.0.x and creating the required
standalone application server profile.
The Migration wizard is new as
of Version 6.0. The wizard is the graphical interface to the Version 6.0.x
migration tools, which are the WASPreUpgrade command and the WASPostUpgrade command. The migration tools are command-line tools.
Use
the wizard to migrate a Version 5.x application server to a Version 6.0.x
standalone application server.
- Start the First steps console.
./profile_root/firststeps/firststeps.sh
profile_root\firststeps\firststeps.bat
- When
migrating a standalone application server from Version 5.1.0 or earlier Version
5.x releases only: Look for and delete the app_server_root/properties/version/ND.product file
if the file exists.
The file is created if the standalone application
server was ever federated into a deployment manager cell. Version 5.1.1 deletes
the file when a node is unfederated. Earlier versions do not. The Migration
wizard reacts to the presence of the file by identifying the standalone node
as a federated node. If the node names do not match, an erroneous failure
occurs.
See Migrating a Version 5.x application server to
a Version 6.0.x standalone application server profile after unfederating the
Version 5.x node fails with a node name mismatch error for more information.
- Click Migration wizard on the First steps console.
The First steps console starts the Migration wizard. The wizard displays
its Welcome panel.
Click Exit on
the First steps console.
- Read the Welcome panel of the Migration wizard to learn about the
migration, then click Next.
The wizard displays the detected
versions of WebSphere Application Server panel.
- Select a previous version, then click Next to continue.
Select the check box to specify the location of a previous installation
that might not appear in the list.
If the previous version specification
is correct, the wizard displays the Target profile selection panel.
- Specify a backup directory, then click Next to continue.
If the Version 6.0.x profile is valid, the wizard displays the Target
profile selection panel.
- Select the target profile from the list of valid Version 6.0.x
profiles for the installation, then click Next.
Use the
Profile creation wizard to create a target profile for the migration if one
does not yet exist.
The wizard displays the Port value assignment panel.
- Choose whether to use port values assigned to the previous installation,
or generate new Version 6.0.x port values that are already assigned to the
target profile, then click Next.
The wizard begins the
premigration. The wizard displays a Migration status panel during the premigration.
If
the premigration is not successful, the wizard displays a failure panel. If
the premigration is partially successful, the wizard displays a warning panel.
Correct
any problems and retry the migration.
If the premigration is successful,
the wizard displays an indication of success.
- Click Next to start the postmigration.
If
the postmigration is not successful, the wizard displays a failure panel.
If the postmigration is partially successful, the wizard displays a warning
panel.
Correct any problems and retry the migration.
If the postmigration
is successful, the wizard displays an indication of success.
- Click Finish to exit the Migration wizard.