InfoCenter Home >
3: Migration overview >
3.4: Migrating administrative configurations >
3.4.1: Using the Migration Assistant

3.4.1: Using the Migration Assistant

The Migration Assistant helps you migrate from IBM WebSphere Application Server Version 3.0.2x to Version 3.5x. To use the WebSphere Migration Assistant, you must have WebSphere Application Server installed at least at the 3.0.2x level. If you do not, you must upgrade to that level before continuing. Also, if you installed WebSphere Application Server V3.0.2 by using the native installation program, ensure that the JAVA_HOME variable is set correctly in the setupCmdLine file before continuing.

Starting the Migration Assistant

To start the Migration Assistant on Windows NT/2000, run the migration executable (migration.exe). If you have a CD, migration.exe is in the \nt directory.

To start the Migration Assistant on UNIX:

  1. Log onto your machine with superuser (root) privileges.
  2. Run the migration script file (./migration.sh), which is in the /cdrom directory.

Note: The Migration Assistant does not check for the bootstrap port on which the current installation is running. If the bootstrap port is something other than the default (900), migration will fail. To prevent failure, start the Migration Assistant with the -nameServerPort option, specifying the appropriate port.

What the Migration Assistant does

The Migration Assistant detects if you have Version 3.0.2.x installed. If a version earlier than Version 3.0.2.x is installed, the Migration Assistant tells you to upgrade to Version 3.0.2.x before continuing and points you to this InfoCenter for more information.

If the Migration Assistant detects that Version 3.0.2.x is installed, the wizard provides a series of panels that walk you through migration to Version 3.5, including:

  • Exporting, saving and restoring your previous administrative configuration
  • Uninstalling Version 3.0.2.x
  • Testing your system for the right prerequisites
  • Installing the upgraded version of WebSphere Application Server

The Migration Assistant also leads you to information about the final steps of installing the WebSphere Application Server, such as migrating application components to APIs and specifications.

If you exit the Migration Assistant before completing all of the steps on the panels and later restart the Migration Assistant, the wizard restarts where you left off.

Details on the migration.exe and its command-line arguments for Windows

The migration.exe program, which runs on Windows NT/2000, determines if a migration should be performed in the course of an installation of Version 3.5.

migration.exe can be run with no arguments, which is what happens you run the Version 3.5 installation program. When executed with no arguments, migration.exe makes a number of checks against values stored in the Windows NT/2000 system registry:

  • If Version 3.0.2 or later is present in the registry, it performs a migration add_run command and then launches the migration wizard with the migration uncond command.
  • If a version previous to 3.0.2 but after 3.0 is present in the registry, it displays the Unsupported Version panel and then launches the installation program setup.exe.
  • If Version 3.0 is present in the registry, it performs a migration add_run command and then launches the migration wizard with the migration uncond command.
  • If a version previous to 3.0 is present in the registry, it displays the Unsupported Version panel and then launches the installation program setup.exe.
  • If no version of IBM WebSphere Application Server is in the registry, it launches the installation program setup.exe.

migration.exe may also be run with either the uncond, add_run, or remove_run arguments:

migration uncond
Causes the migration wizard to be launched, without checking for an installed Application Server product and without checking the version of the current Application Server product.
migration add_run
Verifies that the current directory is the migration directory, checking for either migration.exe or setup.exe. If the current directory is verified as the migration directory, the program stores this directory under the registry keys:
"SOFTWARE\\IBM\\WebSphere Application Server - Migration Assistant"
"Home"

migration add_run primarily adds an auto-run key to the registry. The auto-run key is WebSphere migration Assistant and its run command is migration.exe uncond.

migration remove_run
Causes the auto-run key which was added to the system registry by the migration add_run command to be removed, causes the migration directory to be removed from the system registry, and causes files in the migration directory to be deleted.
Go to previous article: Migrating administrative configurations Go to next article: Migrating configurations manually

 

 
Go to previous article: Migrating administrative configurations Go to next article: Migrating configurations manually