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:
- -backUpDirectory
- Specifies the location in which the saved configuration is stored.
Specify this parameter when you create and migrate a backup copy of
the migration source.
- -backUpProfileName
- Specifies the name of the profile that contains the saved configuration
data. Specify this parameter when you create and migrate a backup
copy of the migration source.
- -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.