WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Migration wizard

The version-to-version migration wizard is a graphical interface that guides you through migrating from an older version to a newer version of WebSphere® ESB.

Note: The migration wizard cannot run in a non-graphical environment. Examples of non-graphical environments include the i5/OS® platform or telnet sessions. If you want to run migration in a non-graphical environment, use the WBIPreUpgrade and WBIPostUpgrade commands.
Note: The migration wizard supports only WebSphere ESB profiles. If you have WebSphere Application Server profiles, you must use the migration commands.

What the migration wizard does

The migration wizard uses the WBIPreUpgrade command and WBIPostUpgrade command to migrate the data and applications from the older version to the newer version of WebSphere ESB.

This step transfers applications and configuration information for the older version's server resources, security, variables, and virtual hosts to the newer version's server. All stored information is in XML files in the profile_dir/config/cells directory of each product.

The WBIPreUpgrade tool saves selected files from the install_root and profile_root directory to a backup directory you specify on a wizard panel. Migration saves files to the following subdirectories in the backup directory: profiles/profile_name and websphere_backup.

Later, the migration wizard uses the WBIPostUpgrade tool to restore a selected profile environment in the backup directory into the newer WebSphere ESB profile environment

Accessing the migration wizard

Invoke the migration wizard in one of the following ways:
  • From the WebSphere ESB First Steps console, select Migration wizard.
  • Run one of the following scripts (depending upon your operating system) stored in the install_dir/bin directory:
    • For Linux operating systemFor UNIX operating system On Linux® and UNIX® platforms: wbi_migration.sh
    • For Windows operating system On Windows® platforms: wbi_migration.bat
    Note: You can optionally change the default trace setting (*=all=enabled:com.ibm.ws.migration.common.*=all=disabled) when invoking the migration wizard. The default trace setting enables tracing on only certain classes, but you can change the default to either enable full tracing or disable all tracing.
    • To enable full tracing, run one of the following scripts to invoke the migration wizard, depending on your operating system:
      • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: wbi_migration.sh -W -migrationPanel.traceString="*=all=enabled"
      • For Windows operating system On Windows platforms: wbi_migration.bat -W -migrationPanel.traceString="*=all=enabled"
    • To disable all tracing, run one of the following scripts to invoke the migration wizard, depending on your operating system:
      • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: wbi_migration.sh -W -migrationPanel.traceString="*=all=disabled"
      • For Windows operating system On Windows platforms: wbi_migration.bat -W -migrationPanel.traceString="*=all=disabled"

Before you begin

The migration wizard prompts you for information as you proceed. Before you invoke the wizard, collect the following information:

Cell name
Name of the cell managed by the deployment manager that you are migrating. The cell name for source and target profile for all migration scenarios must match.
Installation root directory
See WBIPreUpgrade command-line utility for a description of the currentWebSphereDirectory parameter.
Migration backup directory name
See WBIPreUpgrade command-line utility for a description of the backupDirectory parameter.
Administrative security user name (required if adminstrative security is configured)
See WBIPostUpgrade command-line utility for a description of the -username parameter.
Administrative security password (required if adminstrative security is configured)
See WBIPostUpgrade command-line utility for a description of the -password parameter.
Source profile name
See WBIPostUpgrade command-line utility for a description of the -oldProfile parameter.
Target profile name
See WBIPostUpgrade command-line utility for a description of the -profileName parameter.
Port value assignments (optional)
See WBIPostUpgrade command-line utility for a description of the -replacePorts and -portBlock parameters.
Note: This applies only if you are migrating from version 6.0.2.x toversion 6.2.

concept Concept topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/cmig_vtv_tools_wiz.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).