WAS v8.0 > Migration and coexistence > Distributed operating systems
Scenario 2: Migrating cells across operating systems using the command-line tools
Supported configurations:
This topic is about configuration migration, such as migrating dmgrs and federated nodes in a network deployment environment. The Application Migration Toolkit for WAS provides support for migrating applications from previous versions of WAS to the latest product version. For information about migrating applications, read more about the Application Migration Toolkit.
Review the migration planning information. See Knowledge Collection: Migration planning for WAS.
This information describes migrating cells to a different machine. For information on migrating cells on the same machine, see Scenario 1: Migrating a cell using the command line tools.
This task describes how to use the command-line tools to migrate cell topologies across operating systems from a previous version of WAS to v8.0. WAS v8.0 only needs to be installed on the target host. A remote migration jar will be created and extracted on the source WAS host. The cell configuration consists of a dmgr with one or more nodes, a web server, and an application client. All ports are migrated forward into the new configuration. This procedure assumes that the previous configuration is running and that you are migrating all profiles to a new host.
Ensure that your setting for the maximum number of open files is 10000 or greater. If the number of open files is too low, this can cause a variety of migration failures.
Procedure
- Run the backupConfig command on the dmgr and all old nodes
- Install WAS v8.0
- Create the remote migration .jar file
- Create the target dmgr profile
- Run the WASPreUpgrade command from the updated WAS supplemental CD
- Verify the console output and the WASPreUpgrade logs for success, warnings, or failure
- Archive the backup directory created by the WASPreUpgrade command
- Run the WASPostUpgrade command from the new dmgr profile bin directory
- Verify the logs for success
- Run the backupConfig command on the v8.0 dmgr
- Stop and disable the dmgr on the old host
- Start the v8.0 dmgr
- Manually synchronize all nodes
- Migrate plug-ins for web servers
- Run a migration on application client installations
- Migrate nodes
- Troubleshoot
Results
You have migrated from a previous version to WAS v8.0 or later using the migration tools.