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