WebSphereProcessServerPreUpgrade command-line utility

Purpose

The WebSphereProcessServerPreUpgrade command-line utility allows administators to perform a backup of both configuration and applications from the original WebSphere Business Integration Server Foundation 5.1 or 5.1.1 installation to a specified backup directory. This backup information is then used by WebSphereProcessServerPostUpgrade to complete the migration. Only an administrator can use WebSphereProcessServerPreUpgrade.

Location of command file

The command file is located in the install_root/bin directory. The command file is a script named WebSphereProcessServerPreUpgrade.sh for Linux and UNIX-based platforms or WebSphereProcessServerPreUpgrade.bat for Windows platforms.

Usage

An administrator invokes the WebSphereProcessServerPreUpgrade utility from a command-line to backup system configuration information and applications from Server Foundation installations to a specified location. The utility also creates a backup of the $WAS_5X_HOME/events so that Common Event Infrastructure components will be migrated. The backup can then be used as input to the WebSphereProcessServerPostUpgrade command-line utility to complete the migration to WebSphere Process Server 6.0.
The WebSphereProcessServerPreUpgrade utility is also invoked when using the Runtime Migration GUI.

Syntax

WebSphereProcessServerPreUpgrade backupDirectoryName currentWebSphereDirectory[-traceString trace_spec[-traceFile file_name]]

Parameters

The first two parameters are required and positional.

Supported arguments include:

backupDirectoryName
Required positional name of the directory in which the WebSphereProcessServerPreUpgrade tool stores the saved configuration and files, and from which the WebSphereProcessServerPostUpgrade tool later reads the configuration and files. The WebSphereProcessServerPreUpgrade tool creates the directory if the directory does not already exist.
currentWebSphereDirectory
Required positional name of the root directory of the Server Foundation instance that you intend to migrate.
-traceString trace_spec -traceFile file_name
used to gather trace information for use by IBM service personnel. The value of the trace_spec parameter is "*=all=enabled" and must be specified with the quotation marks in order to be processed correctly.

Sample

This is what the command looks like:
WebSphereProcessServerPreUpgrade c:/backupdirectory c:/oldserverdirectory

Parent topic: Rolling back the migration upon failure

Parent topic: Rolling back a successful migration