+

Search Tips   |   Advanced Search

Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

 

XDPreUpgrade command


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:

Issue the XDPreUPgrade command to save the configuration of WebSphere Extended Deployment V6.0.2 before you uninstall WebSphere XD. After you install WebSphere Extended Deployment Version 6.1, the backed up configuration of V6.0.2 is then used to complete the migration process. By default, the configuration of the V6.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:

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.



 

Related concepts


XDUpgrade command
Where migration tasks are performed

 

Related tasks

Migrate WebSphere XD
Migrating product configurations