WAS v8.0 > Migration and coexistence > Distributed operating systems > Migrate product configurations


Migrate profiles using the migration wizard

Before using the Migration wizard, install WAS v8.0.

Read WASPreUpgrade command and WASPostUpgrade command for descriptions of the parameters related to the information that collect before you begin this procedure. The Migration wizard prompts you for this information during the migration.

Use the Profile Management tool or the manageprofiles command to create a valid new target v8.0 profile if one does not already exist, or you can create a target profile using the Migration wizard.

The WAS - Express product creates a valid v8.0 profile for a standalone application server during installation.

Tip: Before migrating a WAS v6.x or 7.x application server profile, use the backupConfig command or your own preferred backup utility to back up your existing configuration. Note the name and location of your backup configuration. We can also choose to let the MMT run the backupConfig command. We can run the backupConfig command on the source profile and the intended target profile if the MMT is not creating the profile. See backupConfig command.

New feature: We can migrate profiles using the Migration wizard graphical user interface. The wizard is the graphical user interface to the primary v8.0 command-line migration tools, which are the WASPreUpgrade command and the WASPostUpgrade command. newfeat The wizard is the graphical user interface to the primary v8.0 command-line migration tools, which are the WASPreUpgrade command and the WASPostUpgrade command. After gathering all of the information that is required for the migration, use the wizard to migrate a WAS v6.x or v7.0 profile to a v8.0 profile.

For help, read Troubleshoot migration.


Procedure

  1. Start the migration wizard. Perform one of the following options to access and start the Migration wizard:

    • Go to Start > Programs > IBM WebSphere > Application Server V8.0 - Express. Click Migration wizard.

    • Run one of the following commands:

      • WAS_HOME/bin/migration.sh
      • WAS_HOME\bin\migration.bat

  2. Define a migration source. On the Migration Sources panel, click New.

  3. Select the installations to migrate. View the list of valid installations which you can migrate to v8.0. We can select installations from this list, or you can specify an installation which has not been detected. Click Next.

  4. Create a backup of the valid source profiles managed by the installation you selected. This step is optional. If you wish to make a backup of the profile, select the profile check box and specify the location for the profile backup.

    1. Select a valid source profile from the drop down list.

    2. Optionally choose to run backupConfig on the selected source profile.

    3. Click Next.

    We can use the restoreConfig script to apply this backup and restore the profile.

  5. Specify the location for the migration output. The migration output includes log files. We can also optionally enable tracing to the appropriate level and select the location for the trace file. The trace file destination can be a different location from the Migration output location. Click Next.

  6. Create the target profile or use an existing profile from the target installation. If you are using an existing profile, specify the name of the profile and click Next.

    Only the names of those profiles which match the type of the source profile being migrated will be displayed in the list. If you are using an existing profile, optionally choose to run backupConfig on the target profile by selecting the checkbox and specifying the location for the profile backup.

  7. Provide the required information for the profile creation process. If you are creating a new profile, the information required depends on the profile type that you are migrating. Click Next.

    1. If migrating a federated node, verify the Deployment Manager is running and open for connections.

  8. Select a method to use for migrating the applications.

    If you are migrating applications, specify the application installation directory. Click Next.

  9. Specify whether to use the port values from the source or target profile. Click Next.

  10. Select additional migration options. Select the appropriate settings.

    To proceed to the summary page, click Next.

  11. Review and verify the migration data.

  12. Start the migration. Click Next to start the migration process. The migration process consists of 2-6 sub-processes, depending on the choices you made in previous steps. Each sub-process has a tab where its progress can be monitored. Controls are in place to allow the process to flow continuously upon each success, or the user can control when to stop or continue the migration process as a whole. The Stop button brings up a confirmation dialog box. We can review any of the sub-process tabs at any time during the migration. If the process requires user input, you are automatically moved to the appropriate tab.

  13. Review the results page. After all sub-processed have completed, the results page is displayed.

    To return to the list of Migration sources, click Finish.


What to do next

We can now start the migrated standalone application server in the WAS v8.0 environment or begin a new migration scenario.
Overview of migration, coexistence, and interoperability
Premigration considerations
Troubleshoot migration
WASPreUpgrade command
WASPostUpgrade command

+

Search Tips   |   Advanced Search