Migrate to a WebSphere Application Server Version 5 default instance

Tools for migrating administrative configurations are provided for WebSphere Application Server - Express Version 5 and later. This support enables WebSphere Application Server - Express Version 5.0.2 (or later) to be upgraded to WebSphere Application Server Version 5.

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 - Express Version 5 configuration.

  2. Restore the WebSphere Application Server - Express Version 5 configuration into a Version 5 instance.

  3. Start the Version 5 default instance.

Save the WebSphere Application Server - Express Version 5 configuration

Perform the following steps to save the WebSphere Application Server - Express Version 5 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: 
    /QIBM/ProdData/WebAS5/Base/bin/WASPreUpgrade   
myBackupDirectory
/QIBM/UserData/WebASE/ASE5/5.xExpressInstanceName

    where:

    • myBackupDirectory (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. Additionally, the tool writes a log file called WasPreUpgrade.log that chronicles the steps taken by WasPreUpgrade.

    • /QIBM/UserData/WebASE/ASE5/5.xExpressInstanceName (required parameter) is the fully qualified path of the Version 5.x Express instance being migrated.

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

Restore the WebSphere Application Server - Express Version 5 configuration into a Version 5 instance

Perform the following steps to restore the WebSphere Application Server - Express Version 5 configuration into a Version 5 instance:

  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: 
    /QIBM/ProdData/WebAS5/Base/bin/WASPostUpgrade
myBackupDirectory

    where myBackupDirectory (required parameter) is the fully qualified path to the integrated file system directory where the the WasPreUpgrade migration tool had previously been used to save the WebSphere Application Server - Express Version 5 instance configuration.

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

Start the Version 5 default instance

  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 QEJBAS5 subsystem has not been started, start the default instance by entering the following command on an OS/400 command line: 
    STRSBS QEJBAS5/QEJBAS5

  3. If the QEJBAS5 subsystem is already started, and the SERVER1 job is present, stop the server and start it again.

  4. If the QEJBAS5 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

/QIBM/ProdData/WebAS5/Base/bin/startServer