Migrate to the default Version 6.0 standalone application server profile

Tools for migrating administrative configurations are provided for a WebSphere Application Server Version 5.x default instance to be migrated to the WebSphere Application Server Version 6.0 default profile.

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. Save the WebSphere Application Server Version 5 configuration.
  2. Restore the WebSphere Application Server Version 5 configuration into a Version 6.0 profile.
  3. Start the Version 6.0 default profile.

Save the WebSphere Application Server Version 5.x configuration

Perform the following steps to save the WebSphere Application Server Version 5.x 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, when migrating to an Version 6.0 Express or Base stand-alone application server profile:
    install_root/bin/WASPreUpgrade backupDirectoryName oldDefaultInstance
    

    where:

    • install_root is /QIBM/ProdData/WebSphere/AppServer/V6/Base or /QIBM/ProdData/WebSphere/AppServer/V6/ND.
    • backupDirectoryName (required parameter) is the fully qualified path to the directory where the WasPreUpgrade migration tool stores the saved configuration and files. This directory is created if it does not already exist. This directory also stores a log file called WasPreUpgrade.log that chronicles the steps taken by WasPreUpgrade.
    • oldDefaultInstance is /QIBM/UserData/WebAS5/Base/default or /QIBM/UserData/WebAS51/Base/default, depending on which version you are migrating from.

    The tool writes a log file called WasPreUpgrade.log that chronicles the steps taken by WasPreUpgrade.

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

Restore the WebSphere Application Server Version 5.x configuration into a Version 6.0 profile

Perform the following steps to restore the WebSphere Application Server Version 5.x 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 default 

    where:

    • install_root is /QIBM/ProdData/WebSphere/AppServer/V6/Base or /QIBM/ProdData/WebSphere/AppServer/V6/ND.
    • backupDirectoryName (required parameter) is the fully qualified path to the directory where the WasPreUpgrade migration tool previously saved the WebSphere Application Server Version 5.x instance configuration.

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

Start the Version 6.0 default 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. If the QWAS6 subsystem has not been started, start the default profile by entering the following command on an OS/400 command line:
    STRSBS QWAS6/QWAS6
  3. If the QWAS6 subsystem is already started, and the SERVER1 job is present, stop the server and start it again.
  4. If the QWAS6 subsystem is already started, but the SERVER1 job is not present, start the server using the startServer script. Enter the following commands on an OS/400 command line:
    STRQSH
    
    install_root/bin/startServer