The WASPreUpgrade script

The WASPreUpgrade script is a migration tool for migrating the configuration and applications of previous WebSphere Application Server and WebSphere Application Server - Express versions to a WebSphere Application Server - Express V5.1 application server node. The script is located in the /QIBM/ProdData/WebASE51/ASE/bin directory.

Authority

To run this script, your user profile must have *ALLOBJ authority.

Syntax

The syntax of the WASPreUpgrade script is:

WASPreUpgrade backupDirectory currentWASDirectory administrationNodeName  -instance instance 
  [ -nameServiceHost host_name [ -nameServicePort port_number ] ]
  [ -traceString trace_spec [ -traceFile file_name ] ]

Parameters

The parameters of the WASPreUpgrade script are:

• backupDirectory
  This is a required parameter and must be the first parameter that you specify. The value backupDirectory specifies the name of the directory where the script stores the saved configuration and files. This is also the directory from which the WASPostUpgrade tool reads the configuration and files. For example, if you are migrating a configuration from WebSphere Application Server Version 3.5, you could specify the /home/was35_instancename/backup directory. If the directory does not exist, the WASPreUpgrade script creates it.

• currentWASDirectory
  This is a required parameter and must be the second parameter that you specify. The value currentWASDirectory specifies the name of the instance root directory for instance that you want to migrate. For Version 3.5.x this is /QIBM/UserData/WebASStd/instance, where instance is the name of the instance you want to migrate. For WebSphere Application Server - Express Version 5.0.x this is /QIBM/UserData/WebASE/ASE5/instance, where instance is the name of the instance you want to migrate.

• administrationNodeName
  This parameter is required and must be the third parameter that you specify. The value administrationNodeName specifies the name of the node that contains the administrative server for the previous version of the product. The value of this argument is case-sensitive and must match the node name given in the topology tree on the Topology tab of the administrative console for the previous version. The WASPreUpgrade tool uses this parameter to call the XMLConfig tool.

• -instance
  This is a required parameter. The value instance specifies the name of the WebSphere Application Server - Express V5.1 instance to which you are migrating the configuration.

• -nameServiceHost
  This is a required parameter if you are migrating from Version 3.5.x. The value host_name specifies the TCP/IP host name of the iSeries server. If you do not specify this parameter, the default host name is localhost.

• -nameServicePort
  This is a required parameter if you are migrating from Version 3.5.x. The value port_number specifies specifies the bootstrap port for the administrative server for the instance from which you are migrating. If you do not specify this parameter, the default value is 900.

• -traceString
  This is an optional parameter. The value trace_spec specifies the trace information that you want to collect. To gather all trace information, specify "*=all=enabled" (with quotation marks). The default is to not gather trace information. If you specify this parameter, you must also specify the -traceFile parameter.

• -traceFile
  This is an optional parameter. The value trace_file specifies the name of the output file for trace information. If you specify the -traceString parameter but do not specify the -traceFile parameter, the script does not generate a trace file.

Logging

The WASPreUpgrade tool displays status to the screen while it is running. It also saves a more extensive set of logging information in the WASPreUpgrade.log file. This file is located in the backupDirectory directory, where backupDirectory is the value specified for the backupDirectory parameter.

Security

The WASPreUpgrade script uses the XMLConfig script to export configuration data from WebSphere Application Server Version 3.5 Standard Edition. If WebSphere security is enabled, ensure that the properties are configured properly in the sas.client.props property file for the Version 3.5 instance before running the WASPreUpgrade script or the script fails when it attempts to invoke the XMLConfig script.

Examples

Migrate from WebSphere Application Server Version 3.5.x Standard Edition

This example illustrates how to migrate from WebSphere Application Server Version 3.5.x Standard Edition. The backup directory is named /home/was35_instancename/WebASAdv, and the instance root of the previous version is /QIBM/UserData/WebASAdv/default. The administrative server is contained in myNode.

> WASPreUpgrade /home/was35_instancename/WebASAdv /QIBM/UserData/WebASAdv/default MYISERIES