[IBM i]

Migrating to a Version 8.5 stand-alone application server profile

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 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

  1. Create a WebSphere Application Server Version 8.5 profile to receive the Version 6.1 configuration.
    1. Start the Qshell environment so that you can run WebSphere Application Server scripts.
      Enter the following command from a command line:
      STRQSH
    2. 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.
    3. 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
      • app_server_root is the location where Version 8.5 is installed
      • 85_profile_name is the name of your Version 8.5 profile

        This parameter must be identical to the Version 6.1 instance or profile that is to be migrated.

      • starting_port_number is the first of a block of 13 consecutive ports
      • 61_application_server_name is the name of the Version 6.1 application server obtained in the previous step
      • 61_node_name is the Version 6.1 node name obtained in the previous step

        The source and target node names must be identical when migrating to Version 8.5.

      For details on the syntax and parameters of the manageprofiles command, see manageprofiles command.

  2. Save the WebSphere Application Server Version 6.1 configuration.
    1. Start the Qshell environment so that you can run WebSphere Application Server scripts.
      Enter the following command from a command line:
      STRQSH
    2. Run the WASPreUpgrade script.
      Use the following parameters:
      app_server_root/bin/WASPreUpgrade
       backup_directory_name
       profile_root
      where
      • app_server_root is the location where Version 8.5 is installed
      • backup_directory_name (required parameter) is the fully qualified path to the integrated file system directory where the WASPreUpgrade migration tool stores the saved configuration and files

        The directory is created if it does not already exist. It is also the directory where the WASPreUpgrade migration tool writes a log file called WASPreUpgrade.log that chronicles the steps taken by the WASPreUpgrade command.

      • profile_root (required parameter) is the path to the Version 6.1 instance or profile that is to be migrated

      For a full explanation of the WASPreUpgrade command and its parameters, read WASPreUpgrade command.

  3. Restore the WebSphere Application Server Version 6.1 configuration into a Version 8.5 profile.
    1. Start the Qshell environment so that you can run WebSphere Application Server scripts.
      Enter the following command from a command line:
      STRQSH
    2. 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.

  4. Start the WebSphere Application Server Version 8.5 profile that receives the Version 6.1 configuration.
    1. Start the QWAS85 subsystem if it is not already started.
      Enter the following command from a command line:
      STRSBS QWAS85/QWAS85
    2. Start the Qshell environment so that you can run WebSphere Application Server scripts.
      Enter the following command from a command line:
      STRQSH
    3. 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
Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 20, 2014 10:48 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-base-iseries&topic=tmig_is_to70sas
File name: tmig_is_to70sas.html