Migrating server configuration files from an earlier to a later version of WebSphere Application Server

The Server Configuration Backup and Server Configuration Restore options available in the workbench are not the correct way to migrate a profile from an earlier to a later version of WebSphere® Application Server. The server is going to fail to start if you attempt to restore the server configuration of an earlier version of WebSphere Application Server into a later version. Instead, follow this topic for details on using the Migration wizard from the later version of WebSphere Application Server to migrate server configuration files from an earlier version of the server.

Before you begin

  • This task is a forward migration of your profile from an earlier to a later version of WebSphere Application Server. For example, an existing V8.0 profile into a newly created V8.5 profile. Before migrating the earlier version of WebSphere Application Server, use the backupConfig command or your own preferred backup utility to back up your existing configuration if you want to be able to restore it to its previous state after migration. Make sure that you note the exact name and location of your backed-up configuration. Details on the backupConfig command is available in the Information Center for the WebSphere Application Server:

Procedure

To migrate the server configuration files from an earlier to a later version of WebSphere Application Server profile, complete the following steps:

  1. In the workbench, remove all applications from the earlier version of WebSphere Application Server.
    1. In the Servers view, right-click the server and select the Add and Remove projects option. The Add and Remove Projects wizard opens.
    2. In the Add and Remove Projects wizard, select the Remove All button. Click Finish.
  2. Issue a publish command to ensure the applications are removed from the earlier version of WebSphere Application Server.
    1. In the Servers view, right-click the server and select the Publish option.
  3. Close the IBM® Rational® Software Development Platform workbench by selecting File > Exit.
  4. Stop the WebSphere Application Server. Use thestopServer command from the x:/bin directory, where x is the installation directory of the WebSphere Application Server. Details on the stopServer command is available in the Information Center for the WebSphere Application Server:
  5. Run the Migration wizard from the later version of WebSphere Application Server to migrate server configuration files from an earlier version of the server. Details on the Migration wizard is available in the Information Center for the WebSphere Application Server:
  6. Open the IBM Rational Software Development Platform workbench.
  7. In the Servers view, create a later version of the WebSphere Application Server.
  8. In the New Server wizard of the WebSphere Application Server Settings page, there is a Profile name drop-down list. Select the newly migrated profile.
  9. Add the previously removed projects into the later version of WebSphere Application Server.
    1. In the Servers view, right-click the later version of the server and select the Add and Remove projects option. The Add and Remove Projects wizard opens.
    2. In the Add and Remove Projects wizard, select the previously removed application and click Add button. Click Finish.
  10. Issue a publish command to ensure the applications are added back into the later version of WebSphere Application Server.
    1. In the Servers view, right-click the server and select the Publish option.
Related tasks:
Backing up server configuration from a WebSphere Application Server
Restoring server configuration to a WebSphere Application Server
Feedback