Migrate to a new WebSphere Application Server Version 6.0 profile

Tools for migrating administrative configurations are provided for WebSphere Application Server - Express Version 5 (or later) and Version 5.1 (or later) to be upgraded to WebSphere Application Server Version 6.0.

Before performing the instructions on this page, do the steps in
Step 1: Plan your migration.

A summary of the product migration process is as follows:

  1. Create a Version 6.0 profile to receive the WebSphere Application Server - Express Version 5 or Version 5.1 configuration.
  2. Save the WebSphere Application Server - Express Version 5 or Version 5.1 configuration.
  3. Restore the WebSphere Application Server - Express Version 5 or Version 5.1 configuration into a Version 6.0 profile.
  4. Start the Version 6.0 profile that receives the WebSphere Application Server - Express Version 5 or Version 5.1 configuration.

Create a Version 6.0 profile to receive the WebSphere Application Server - Express Version 5 or Version 5.1 configuration

  1. Enter the following command from an OS/400 command line: 
    STRQSH

    This starts the Qshell environment so that you can run WebSphere Application Server scripts.

  2. Run the wasprofile script with the following parameters: 
    install_root/bin/wasprofile -create  
  -profileName 60ProfileName
  -startingPort starting_port_number
  -templatePath install_root/profileTemplates/defaultnoexamp   -serverName 5xApplicationServerName

    where:

    • install_root is /QIBM/ProdData/WebSphere/AppServer/V6/Base or /QIBM/ProdData/WebSphere/AppServer/V6/ND.
    • 60ProfileName is the name of your WebSphere Application Server Version 6.0 profile. This parameter must be identical to the Version 5 instance that is to be migrated. The source and target node names must be identical when migrating to Version 6.0.
    • starting_port_number is the first of a block of 13 consecutive ports.
    • 5xApplicationServerName is the name of your WebSphere Application Server - Express Version 5 or Version 5.1 application server.

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

Save the WebSphere Application Server - Express Version 5 or Version 5.1 configuration

Perform the following steps to save the WebSphere Application Server - Express Version 5 or Version 5.1 configuration:

  1. Enter the following command from an OS/400 command line: 
    STRQSH

    This starts the Qshell environment so that you can run WebSphere Application Server scripts.

  2. Run the WasPreUpgrade script with the following parameters:

    Express Version 5: 

    install_root/bin/WASPreUpgrade   
backupDirectoryName  
/QIBM/UserData/WebASE/ASE5/5.xInstanceName

    Express Version 5.1: 

    install_root/bin/WASPreUpgrade   
backupDirectoryName  
/QIBM/UserData/WebASE51/ASE/5.xInstanceName

    where:

    • install_root is /QIBM/ProdData/WebSphere/AppServer/V6/Base or /QIBM/ProdData/WebSphere/AppServer/V6/ND.
    • backupDirectoryName is the required name of the directory in which the WASPreUpgrade tool stores the saved configuration and files, and from which the WASPostUpgrade tool reads the configuration and files.

    For a full explanation of the WasPreUpgrade migration tool and parameters, see The WASPreUpgrade script.

Restore the WebSphere Application Server - Express Version 5 or Version 5.1 configuration into a Version 6.0 profile

Perform the following steps to restore the WebSphere Application Server - Express Version 5 or Version 5.1 configuration into a Version 6.0 profile:

  1. Enter the following command from an OS/400 command line: 
    STRQSH

    This starts the Qshell environment so that you can run WebSphere Application Server scripts.

  2. Run the WasPostUpgrade script with the following parameters: 
    install_root/bin/WASPostUpgrade backupDirectoryName
-profileName 60ProfileName
 [-portBlock port_starting_number]

    where

    • install_root is /QIBM/ProdData/WebSphere/AppServer/V6/Base or /QIBM/ProdData/WebSphere/AppServer/V6/ND.
    • backupDirectoryName is the required name of the directory in which the WASPreUpgrade tool stores the saved configuration and files, and from which the WASPostUpgrade tool reads the configuration and files.
    • 60ProfileName is the name of the WebSphere Application Server Version 6.0 profile to which the script migrates your configuration.
    • port_starting_number specifies the first of a block of 10-15 consecutive port numbers that are not in use on the iSeries server where the migration is being performed. IBM recommends that you always specify the -portBlock parameter if you do not want your profile's ports to conflict with the default profile's ports.

    For a full explanation of the WasPostUpgrade migration tool and parameters, see The WASPostUpgrade script.

Start the Version 6.0 profile that receives the WebSphere Application Server - Express Version 5 or Version 5.1 configuration

Perform the following steps to start the Version 6.0 profile that receives the WebSphere Application Server - Express Version 5 or Version 5.1 configuration:

  1. Start the QWAS6 subsystem if it is not already started. Enter this command from an OS/400 command line: 
    STRSBS QWAS6/QWAS6
  2. Enter the following command from an OS/400 command line: 
    STRQSH

    This starts the Qshell environment so that you can run WebSphere Application Server scripts.

  3. Run the startServer script with the following parameters: 
    install_root/bin/startServer -profileName 60ProfileName 5xExpressApplicationServerName

    where

    • install_root is /QIBM/ProdData/WebSphere/AppServer/V6/Base or /QIBM/ProdData/WebSphere/AppServer/V6/ND.
    • 60ProfileName is the name of the Version 6.0 profile created in an earlier step.
    • 5xExpressApplicationServerName is the name of the WebSphere Application Server Express - Version 5 or Version 5.1 application server that was migrated.