Use the XDUpgrade command to migrate from an
existing installation to a new installation of the product.
The XDUpgrade command transfers product 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 Version
6.1 profile to which the Version 6.0.2 is migrated.
The
source keyword indicates which
WebSphere Application Server Network Deployment and
WebSphere Extended
Deployment installations from which you want
to migrate, and the
target keyword indicates which
WebSphere Application Server Network Deployment and
WebSphere Extended
Deployment installations 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 installations
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.