Use the migration tools to migrate from WebSphere® Application Server Version 6.1 to
a new Version 8.5 stand-alone
application server profile.
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
Read Overview of migration, coexistence, and interoperability and Premigration considerations.
For resources to help you plan and perform your migration,
visit Knowledge Collection: Migration planning for WebSphere Application Server.
For help, read Troubleshooting migration.
Before following these instructions, perform the actions in Preparing for product-configuration migration.
Tip: Before
migrating a WebSphere Application Server Version 6.1 stand-alone application server profile, 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. See backupConfig command for more information. Make sure that you note the exact name and
location of this backed-up configuration.
Procedure
- Create a WebSphere Application Server Version 8.5 profile
to receive the Version 6.1 configuration.
- Start the Qshell environment so that you can run WebSphere Application Server scripts.
Enter the following command from a command line:
STRQSH
- Run the dspwasinst script to obtain the node name and server name
for the Version 6.1 instance or profile that is to be migrated.
Use the following parameters:
app_server_root/bin/dspwasinst
-instance 61_profile_name
where
- app_server_root is the location
of the Version 6.1 installation that contains the instance or profile
to be migrated
- 61_profile_name is the name
of the Version 6.1 instance or profile that is to be migrated
The name of the Version 6.1 node is listed in the
Node section, and the name of the server is listed in the
Information
for server section.
- Run the manageprofiles script.
Use the following parameters:
app_server_root/bin/manageprofiles
-create
-profileName 85_profile_name
-startingPort starting_port_number
-templatePath app_server_root/profileTemplates/default
-serverName 61_application_server_name
-nodeName 61_node_name
where
For details on the syntax and parameters of the manageprofiles command, see manageprofiles command.
- Save the WebSphere Application Server Version 6.1 configuration.
- Start the Qshell environment so that you can run WebSphere Application Server scripts.
Enter the following command from a command line:
STRQSH
- Run the WASPreUpgrade script.
Use the following parameters:
app_server_root/bin/WASPreUpgrade
backup_directory_name
profile_root
where
For a full explanation of the WASPreUpgrade command and its parameters, read WASPreUpgrade command.
- Restore the WebSphere Application Server Version 6.1 configuration into a Version 8.5 profile.
- Start the Qshell environment so that you can run WebSphere Application Server scripts.
Enter the following command from a command line:
STRQSH
- Run the WASPostUpgrade script.
Use the following parameters:
app_server_root/bin/WASPostUpgrade
backup_directory_name
-profileName 85_profile_name
[-portBlock port_starting_number]
where
- app_server_root is the location
where Version 8.5 is installed
- backup_directory_name is the
required name of the directory in which the WASPreUpgrade tool stored the saved configuration and files and from which the WASPostUpgrade tool reads the configuration and files
- 85_profile_name is the name
of the Version 8.5 profile
to which the script migrates your configuration
- port_starting_number specifies
the first of a block of 10 to 15 consecutive port numbers that are
not in use on the IBM® i server
where the migration is being performed
It is recommended that you
always specify the -portBlock parameter if you do not want your profile's
ports to conflict with the default profile's ports.
Note: When migrating a stand-alone application server from Version 6.1
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.
For a full explanation of the WASPostUpgrade command and its parameters, read WASPostUpgrade command.
- Start the WebSphere Application Server Version 8.5 profile
that receives the Version 6.1 configuration.
- Start the QWAS85 subsystem if it is not already started.
Enter the following command from a command line:
STRSBS QWAS85/QWAS85
- Start the Qshell environment so that you can run WebSphere Application Server scripts.
Enter the following command from a command line:
STRQSH
- Run the startServer script.
Use the following parameters:
app_server_root/bin/startServer
-profileName 85_profile_name
61_server_name
where
- app_server_root is the location
where Version 8.5 is installed
- 85_profile_name is the name
of the Version 8.5 profile
created in an earlier step
- 61_server_name is the name
of the Version 6.1 application server that was migrated