Migrating profiles by using the migration wizard
Use the migration tools to migrate WebSphere® Application Server profiles to Version 9.0.
Before you begin
This topic is about profile configuration migration. To migrate your applications to the latest version, use the WebSphere Application Server Migration Toolkit.
- Read Overview of migration, coexistence, and interoperability and Migration considerations for general migration information.
- For resources to help you plan and perform your migration, visit Knowledge Collection: Migration planning for WebSphere Application Server.
- Read WASPreUpgrade command and WASPostUpgrade command for descriptions of the parameters that are related to the information that you need to collect before you begin this procedure. The Migration wizard prompts you for this information during the migration.
Install WebSphere Application Server Version 9.0. You must migrate your Version 7.0 or later profiles by using the Version 9.0 migration wizard.
If a valid Version 9.0 target profile does not exist, you can create one before you start the migration process by using the Profile Management tool or the manageprofiles command, or you can create one during migration by using the migration wizard.
About this task
The migration wizard transfers applications and configuration information for the Version 7.0 or later server resources, security, variables, and virtual hosts to the Version 9.0 profile. All information is stored in XML files in the app_server_root/config/cells directory of each product.
For help, read Troubleshooting migration.
If you have embedded Derby databases or messaging engine file stores that might be locked by
any running servers, stop the servers that are defined by the WebSphere Application Server
Version 7.0 or later profile that you want to migrate.
The server must be stopped to unlock any in-use files that need to be migrated.The command that you use to stop the servers depends on the server type:
For example, issue the following commands to stop
- Application server, administrative agent, and job manager: stopServer command
- Node agent: stopNode command
- Deployment manager: stopManager command
./stopServer.sh server1 ./stopServer.sh server2
Start the Version 9.0 migration wizard.
Perform one of the following options to access and start the migration wizard:
- Go to Configuration Migration Tool. . Click
- Run one of the following commands:
Define a migration source.
On the Migration Sources tab, click New.
Select the installations that you want to migrate, and click Next.
Detected valid installations that you can migrate to Version 9.0 are listed. You can select installations from this list, or you can specify an installation was not detected.
Select the source profile that you want to migrate.
- Select a valid source profile from the drop-down list.
To make a backup of the profile, select the profile check box and specify the location for the
Selecting this option runs the backupConfig command on the selected source profile.Note: You can use the restoreConfig command to apply this backup and restore the profile.
- Click Next.
Specify the location for the migration output and trace options, and click
The migration output includes log files and files saved from the source profiles.
By default, the tracing level is set to Fine. You can change this selection or specify a different location for the trace file. The trace file destination can be a different location from the migration output location.
Create the target profile or use an existing profile from the target installation.
- If you are creating a new profile, provide the required information for the profile creation
process, and click Next.
The required information depends on the profile type that you are migrating.
If you are migrating a federated node, verify that the deployment manager is running and open for connections.
- If you are using an existing profile, specify the name of the profile and click
Next. Note: Only the names of those profiles that match the type of the source profile that you are migrating are displayed in the list. If you are using an existing profile, optionally choose to run backupConfig on the target profile by selecting the check box and specifying the location for the profile backup.
- If you are creating a new profile, provide the required information for the profile creation process, and click Next.
Select whether to migrate your applications, and click Next.
If you are migrating applications, you can specify a different application installation directory.
- Select how to migrate port values, and click Next.
- Select additional migration options, and click Next.
Review and verify the migration summary data.
Note: To generate a text file of the commands to be used for this migration, click Generate Commands. You can use this text file to create a script that uses the commands.
To start the migration, click Migrate.
The migration process consists of 2-6 subprocesses, depending on the choices you made in previous steps. Each subprocess 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. You can review any of the subprocess tabs at any time during the migration. If the process requires user input, you are automatically moved to the appropriate tab.
You can start any stopped servers in your source installation after the WASPreUpgradesubprocess completes.
- After all subprocesses complete, review the results page.
- To return to the list of migration sources, click Finish.