Migrate from a WebSphere Application Server - Express Version 5.0.x instance

Tools for migrating administrative configurations are provided for WebSphere Application Server - Express Version 5.0.x to be upgraded to WebSphere Application Server - Express Version 5.1.

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 5.1 instance to receive the WebSphere Application Server - Express Version 5.0.x configuration.
2. Save the WebSphere Application Server - Express Version 5.0.x configuration.
3. Restore the WebSphere Application Server - Express Version 5.0.x configuration into a Version 5.1 instance.
4. Start the Version 5.1 instance that receives the WebSphere Application Server - Express Version 5.0.x.

Create a Version 5.1 instance to receive the WebSphere Application Server - Express Version 5.0.x configuration

See Create a new application server in the Administration topic for details on how to create a WebSphere Application Server - Express instance. The name of your WebSphere Application Server - Express Version 5.1 instance must be identical to the Version 5 instance that is to be migrated.

Save the WebSphere Application Server - Express Version 5.0.x configuration

Perform the following steps to save the WebSphere Application Server - Express Version 5.0.x:

1. Enter the following command from the CL 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.0.x:

   /QIBM/ProdData/WebASE51/ASE/bin/WASPreUpgrade   
   myBackupDirectory  
   /QIBM/UserData/WebASE/ASE5/5.xExpressInstanceName   
   -instance 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. It is also the directory where the WasPreUpgrade migration tool writes a log file called WasPreUpgrade.log that chronicles the steps taken by WasPreUpgrade.
   • 5.xExpressInstanceName (required parameter) is the name of the WebSphere Application Server - Express Version 5.1 instance to which you are migrating the configuration. This parameter must be identical to the Version 5.0.x instance that is to be migrated.

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

Restore the WebSphere Application Server - Express Version 5.0.x configuration into a Version 5.1 instance

Perform the following steps to restore the WebSphere Application Server - Express Version 5.0.x configuration into a Version 5.1 instance:

1. Enter the following command from the CL 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/WebASE51/ASE/bin/WASPostUpgrade
   myBackupDirectory
   -instance 51_instance_name
    [-portBlock port_starting_number]
    

   Supported arguments include:

   • backupDirectoryName
     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.0.x instance configuration.

   • -instance
     This is a required parameter. The value 51_instance_name specifies the name of the WebSphere Application Server - Express Version 5.1 instance to which the script migrates your configuration. This parameter must be identical to the Version 5 instance that is to be migrated.

   • -portBlock
     This is an optional parameter. The value 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. It is recommended that you always specify the -portBlock parameter if you do not want your instance's ports to conflict with the default instance's ports.

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

Start the Version 5.1 instance that receives the WebSphere Application Server - Express Version 5.0.x

Perform the following steps to start the Version 5.1 instance that receives the WebSphere Application Server - Express Version 5.0.x:

1. Start the QASE51 subsystem if it is not already started. Enter this command from the CL command line:

   STRSBS QASE51/QASE51

2. Enter the following command from the CL 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:

   /QIBM/ProdData/WebASE51/ASE/bin/startServer -instance 51InstanceName
   

   where 51InstanceName is the name of the Version 5.1 instance created in an earlier step.