The XDPreUpgrade command for WebSphere® Extended Deployment Version
6.1 saves the configuration of WebSphere Extended Deployment Version
6.0.2 into a migration-specific backup directory.
You must download and install the required interim fix for the XDPreUpgrade command
before you can use the utility in the migration process to save your Version
6.0.2 configurations to a backup directory. Download the XDPreUpgrade Interim
Fix from the WebSphere Extended Deployment support site:
- Type PK43942 in the Search Support field. This
is the specific APAR number for the interim fix.
- Select Download (Fixes, Utilities, APARs) to limit the returned
results, and click Search.
Issue the XDPreUPgrade command to save the configuration of WebSphere Extended Deployment Version 6.0.2 before you uninstall
the product. After you install WebSphere Extended Deployment Version
6.1, the backed up configuration of Version 6.0.2 is then used to complete
the migration process. By default, the configuration of the Version 6.0.2
profile is located in the install_root\properties\WXDBACKUPS\6.1.0.0\backups directory.
The source keyword indicates which WebSphere Application Server
Network Deployment and WebSphere Extended Deployment installations to migrate
from:
You must issue the XDPreUpgrade command from the source_profile\bin directory
of the profile that is to be backed up:
The command syntax to create the backup configuration is provided in the
following section:
XDPreUpgrade.bat -create -profilePath source_profile_path
-OPT -backupsDirectory backups_directory -traceLevel trace_level
-traceDir trace_directory
XDPreUpgrade.sh -create -profilePath source_profile_path
-OPT -backupsDirectory backups_directory -traceLevel trace_level
-traceDir trace_directory
Each parameter is described in the following section:
- create
- This is a required parameter that specifies the migration action to create
a backup configuration from the specified profile path.
- profilePath
- This is a required parameter that specifies the fully qualified path to
the profile that is to be backed up.
- -backupsDirectory
- This is an optional parameter that specifies the directory in which to
create the backup configuration. The default location of the backups directory
is install_root\properties\WXDBACKUPS\6.1.0.0\backups.
- -traceLevel
- This is an optional parameter that specifies the trace level for generating
diagnostic messages. The following list provides the valid trace levels:
- 0:off
- do no logging
- 1:severe
- log only severe errors
- 2: warning
- log severe errors and warnings
- 3:info
- log severe errors, warning, and info messages
- 4:config
- log sever errors, warnings, info and config messages
- 5:fine
- turn on fine level logging
- 6:finer
- turn on even finer level logging
- 7:finest
- log every message produced (default)
- -traceDir
- This is an optional parameter that specifies the directory that contains
the XDUpgrade.log file. The default directory is install_root/logs/xd.migration.
The command syntax to remove the backup configuration is provided in the
following section:
XDPreUpgrade.bat -remove -profileName source_profile_name
-OPT -backupsDirectory backups_directory -traceLevel trace_level
-traceDir trace_directory
XDPreUpgrade.sh -remove -profileName source_profile_name
-OPT -backupsDirectory backups_directory -traceLevel trace_level
-traceDir trace_directory
Each parameter is described in the following section:
- remove
- This is a required parameter that specifies the migration action to remove
the backup configuration from the specified profile.
- profileName
- This is a required parameter that specifies the fully qualified path to
the profile that is to be backed up.
- -backupsDirectory
- This is an optional parameter that specifies the directory from which
to remove the backup configuration. The default location of the backups directory
is install_root\properties\WXDBACKUPS\6.1.0.0\backups.
- -traceLevel
- This is an optional parameter that specifies the trace level for generating
diagnostic messages. The following list provides the valid trace levels:
- 0:off
- do no logging
- 1:severe
- log only severe errors
- 2: warning
- log severe errors and warnings
- 3:info
- log severe errors, warning, and info messages
- 4:config
- log server errors, warnings, info and config messages
- 5:fine
- turn on fine level logging
- 6:finer
- turn on even finer level logging
- 7:finest
- log every message produced (default)
- -traceDir
- This is an optional parameter that specifies the directory that contains
the XDUpgrade.log file. The default directory is install_root/logs/xd.migration.