The WASPreUpgrade command for WebSphere Application Server V6.1 saves the configuration of a previously installed version of WebSphere Application Server into a migration-specific backup directory.

Location

The command file is located and should be run in the V6.1 directory...

app_server_root/bin

Authority

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

Syntax

The syntax is as follows:

WASPreUpgrade backupDirectory 
              currentWebSphereDirectory
              [-traceString trace_spec [-traceFile file_name ]]

Parameters

The parameters are as follows:

backupDirectory

Name of the directory where the command script stores the saved configuration.

Required. Must be the first parameter that you specify.

This is also the directory from which the WASPostUpgrade command reads the configuration.

If the directory does not exist, WASPreUpgrade creates it.

currentWebSphereDirectory

Name of the instance or profile root directory for the current WAS V5.x instance or 6.0.x profile that you want to migrate.

Required. Must be the second parameter that you specify.

• V5.0.x Express:

  /QIBM/UserData/WebASE/ASE5/instance

• V5.0.x base:

  /QIBM/UserData/WebAS5/Base/instance

• V5.0.x Network Deployment:

  /QIBM/UserData/WebAS5/ND/instance

• V5.1.x Express:

  /QIBM/UserData/WebASE51/ASE/instance

• V5.1.x base:

  /QIBM/UserData/WebAS51/Base/instance

• V5.1.x Network Deployment:

  /QIBM/UserData/WebAS51/ND/instance

• In V6.0.x, profile root may be a unique value chosen during profile creation but the following directories are the defaults:

  • For V6.0.x Express or base:

    /QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/profile

  • For V6.0.x Network Deployment:

    /QIBM/UserData/WebSphere/AppServer/V6/ND/profiles/profile

-traceString

Trace information that you want to collect.

Optional.

To gather all trace information...

"*=all=enabled"

...with quotation marks.

If you do not specify one of the following -traceString or -traceFile the command creates a trace file by default and places it in...

backupDirectory/logs

If you specify this parameter, also specify the -traceFile parameter.

-traceFile

Optional. The value file_name specifies the name of the output file for trace information.

If you do not specify the -traceString or -traceFile parameter, the command creates a trace file by default and places it in the backupDirectory/logs directory.

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 runs. The tool also saves a more extensive set of logging information in...

backupDirectory/WASPreUpgrade.time_stamp.log

Migrated resources

WASPreUpgrade saves all of your resources, but it does not migrate entities in your classes directory.

Migration saves the following files in the backupDirectory directory.

• config
• properties

Related tasks

Related Reference