Use the migration tools to migrate from a WebSphere® Application Server Version 6.1 or
above stand-alone application server profile to a Version 8.5 stand-alone application
server.
Before you begin
Supported configurations: This
article is about configuration migration, such as migrating deployment
managers and federated nodes in a network deployment environment.
The Application Migration Toolkit for WebSphere Application Server
provides support for migrating applications from previous versions
of WebSphere Application Server to the latest product version. For
information about migrating applications, read more about the Application
Migration Toolkit.
sptcfg
See Overview of migration, coexistence, and interoperability and Premigration considerations.
For help, read Troubleshooting migration.
If your scenario includes migrating a WebSphere Application Server Version 6.1 or
above configuration on one machine to Version 8.5 on another machine,
use the alternate procedure described in Migrating to a Version 8.5 stand-alone application server on a remote machine.
Tip: Before migrating a WebSphere Application Server Version 6.1 or
above stand-alone 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. For more information, see backupConfig
command. Make sure that you note the exact name and location
of this backed-up configuration.
Decide whether you want to migrate from WebSphere Application Server Version 6.1 or
above to Version 8.5 using
the Migration wizard or using the command-line migration tools.
Procedure
- Migrate from WebSphere Application Server Version 6.1 or above to Version 8.5 using the Migration
wizard.
- Stop all of the WebSphere Application Server Version 6.1 or
above application servers that are running on the node.
Use the stopServer command from the app_server_root/bin directory. See stopServer command for more information.
![[Linux]](../images/linux.gif)
For example, issue the following commands to stop server1 and server2:
./stopServer.sh server1
./stopServer.sh server2
If security is enabled,
specify the -user and -password parameters on the stopServer command.
You can migrate a WebSphere Application Server Version 6.1 or
above node without stopping it; however, you must stop the node before
you can start the Version 8.5 node that you are installing. It is not necessary to have the node
running to migrate its configuration. The migration tools can retrieve
all the configuration data while the node is stopped.
- Install WebSphere Application Server Version 8.5.
See Installing and configuring your application serving
environment for more information.
- Optional: Use the Profile Management tool
or the manageprofiles command to create a WebSphere Application Server Version 8.5 profile.
See Managing profiles using the graphical user interface or manageprofiles command for more information.
- Use the Migration wizard to transfer configuration settings
from Version 6.1 or above to the Version 8.5 stand-alone application
server.
This step transfers applications and configuration information
for the Version 6.1 or above server resources, security, variables,
and virtual hosts to the Version 8.5 stand-alone application server. All stored information is in
XML files in the app_server_root/config/cells directory of each product.
The Migration wizard uses the WASPreUpgrade command and WASPostUpgrade command to migrate the data and applications from Version
6.1 or above to Version 8.5.
The
WASPreUpgrade tool saves selected
files from the install and profile directories to a backup directory
that you specify on a wizard panel. Migration saves files from the
following directories to the backup directory:
- bin
- classes
- config
- installableApps
- installedApps (or an alternate directory
specified by the user)
- properties
Later, the Migration wizard uses the WASPostUpgrade tool to copy the environment in the backup directory to the Version 8.5 stand-alone application
server installation.
- Migrate from WebSphere Application Server Version 6.1 or above to Version 8.5 using the command-line
migration tools.
- Stop all of the WebSphere Application Server Version 6.1 or
above application servers that are running on the node.
Use the stopServer command from the app_server_root/bin directory. See stopServer command for more information.
![[Linux]](../images/linux.gif)
For example, issue the following commands to stop server1 and server2
on the Linux operating system:
./stopServer.sh server1
./stopServer.sh server2
If security is enabled,
specify the -user and -password parameters on the stopServer command.
You can migrate a WebSphere Application Server Version 6.1 or
above node without stopping it; however, you must stop the node before
you can start the Version 8.5 node that you are installing. It is not necessary to have the node
running to migrate its configuration. The migration tools can retrieve
all the configuration data while the node is stopped.
- Install WebSphere Application Server Version 8.5.
See Installing and configuring your application serving
environment for more information.
- Use the Profile Management tool or the manageprofiles command to create a WebSphere Application Server Version 8.5 profile.
See Managing profiles using the graphical user interface or manageprofiles command for more information.
- Run the WASPreUpgrade command, specifying
the migration backup directory name and the existing WebSphere Application Server directory name.
Read WASPreUpgrade command for more
information.
The
WASPreUpgrade tool saves
selected files from the
/bin directory to a backup
directory you specify on a wizard panel. Migration saves files from
the following directories to the backup directory:
- classes
- config
- installableApps
- installedApps (or an alternate directory
specified by the user)
- properties
- Run the WASPostUpgrade command, specifying
the migration backup directory.
See WASPostUpgrade command for more information.
The WASPostUpgrade tool copies the environment
in the backup directory to the WebSphere Application Server Version 8.5 stand-alone application
server installation.
Note: When migrating a stand-alone
application server from Version 6.1 or above to Version 8.5, you can choose a
stand-alone application server node that has already been registered
with an administrative agent as the target of the migration.