WebSphere Application Server - Express, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Migrating a V5 Application Server to a V6 Stand-alone Application Server with the Migration wizard

Version 6 migration always works by migrating an earlier supported version of WebSphere Application Server to an Application Server profile.

Before you begin

Collect the following information about your V5 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 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 target exists, you can start the procedure.

The Express product creates a valid Version 6 profile for a stand-alone Application Server during installation.

Why and when to perform this task

This topic describes using the Migration wizard to migrate a Version 5.x Application Server to a Version 6 stand-alone Application Server.

The Migration wizard is new as of Version 6. The wizard is the graphical interface to the Version 6 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 stand-alone Application Server.

Steps for this task

  1. Start the First steps console.
    • [Linux][UNIX]./install_root/profiles/profile_name/firststeps/firststeps.sh
    • [Windows]install_root\profiles\profile_name\firststeps\firststeps.bat
  2. Click the Migration wizard option on the First steps console.

    The First steps console starts the Migration wizard. The wizard displays its Welcome panel.

  3. Read the Welcome panel to learn about the migration, then click Next.

    The wizard displays the Detected versions of WebSphere Application Server panel.

  4. 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.

  5. Specify a backup directory, then click Next to continue.

    If the V6 profile is valid, the wizard displays the Target profile selection panel.

  6. Select the target profile from the list of valid V6 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.

  7. Choose whether to use port values assigned to the previous installation, or generate new V6 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.

  8. 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.

  9. Click Finish to exit the migration wizard.

What to do next

See Using the Profile creation wizard to learn more about creating profiles.

Refer to the description of the wasprofile command to learn more about the command, and to see examples of how to use the wasprofile command.




Related tasks
Using the Migration wizard

Task topic    

Terms of Use | Feedback

Last updated: Jun 8, 2005 12:45:23 PM EDT
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/tins_helpmig5.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)