Use the XDUpgrade command to migrate from an existing installation
to a new installation of WebSphere Extended Deployment.
The XDUpgrade command transfers WebSphere Extended Deployment configuration
data from an existing WebSphere Extended Deployment Version 6.0.2 deployment
manager to a newly created WebSphere Extended Deployment Version 6.1 deployment
manager profile. You must issue the XDUPgrade command from the target_profile\bin directory
of the WebSphere Extended Deployment Version 6.1 profile to which the Version
6.0.2 is to be migrated.
The
source keyword indicates which WebSphere Application
Server Network Deployment and WebSphere Extended Deployment installation from
which you want to migrate, and the
target keyword indicates
which WebSphere Application Server Network Deployment and WebSphere Extended
Deployment installation to which you want to migrate. A migration source can
be either an existing product installation, or a previously created backup
configuration of the product.
Attention: The previously created
backup is necessary when you are migrating only WebSphere Extended Deployment
configuration, and not when you are migrating WebSphere Application Server
configuration.
The command syntax for when the migration source is an existing product
installation is provided in the following section:
XDUpgrade.bat -sourcewashome -sourceProfilePath source_profile_path
-targetProfilePath target_profile_path -userid user_name -password password
-OPT -traceLevel trace_level -traceDir trace_directory
XDUpgrade.sh -sourcewashome -sourceProfilePath source_profile_path
-targetProfilePath target_profile_path -userid user_name -password password
-OPT -traceLevel trace_level -traceDir trace_directory
Each parameter is described in the following section:
- sourcewashome
- This is a required parameter that specifies the install_root directory
of the WebSphere Application Server Network Deployment and WebSphere Extended
Deployment installation from which the configuration is migrated.
- sourceProfilePath
- This is a required parameter that specifies the fully qualified path to
the profile from which the configuration is migrated.
- -targetProfilePath
- This is a required parameter that specifies the fully qualified path to
the profile to which the configuration is migrated.
- -userid
- This is an additional parameter that should always be specified, along
with password. Because the migration utility does not check
for these parameters, the migration will fail if you do not specify your user
ID and password when security is enabled on the workstation.
- -password
- This is an additional parameter that should always be specified, along
with userid. Because the migration utility does not check
for these parameters, the migration will fail if you do not specify your user
ID and password when security is enabled on the workstation.
- -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 for when the migration source is a previously created
backup of the product configuration is provided in the following section:
XDUpgrade.bat -backupsDirectory backup_directory -backupProfileName backup_profile_name
-targetProfilePath target_profile_path -userid user_name -password password
-OPT -traceLevel trace_level -traceDir trace_directory
XDUpgrade.sh -backupsDirectory backup_directory -backupProfileName backup_profile_name
-targetProfilePath target_profile_path -userid user_name -password password
-OPT -traceLevel trace_level -traceDir trace_directory
Each parameter is described in the following section:
- -backUpsDirectory
- This is a required parameter that specifies the path to the product installation
from which you want to migrate.
- -backupProfileName
- This is a required parameter that specifies the path, with the name of
the profile included, to the profile from which you want to migrate.
- -targetProfilePath
- This is a required parameter that specifies the path, with the profile
name included, to the profile to which you want to migrate.
- -userid
- This is an additional parameter that should always be specified, along
with password. Because the migration utility does not check
for these parameters, the migration will fail if you do not specify your user
ID and password when security is enabled on the workstation.
- -password
- This is an additional parameter that should always be specified, along
with userid. Because the migration utility does not check
for these parameters, the migration will fail if you do not specify your user
ID and password when security is enabled on the workstation.
- -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.