Operating Systems: AIX, HP-UX, Linux, Solaris, Windows
XDUpgrade command
Use the XDUpgrade command to migrate from an
existing installation to a new installation of WebSphere XD.
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. Issue the XDUPgrade command
from the target_profile\bin directory of the Version
6.1 profile to which the V6.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 WebSphere XD. 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 WebSphere XD 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 WebSphere XD 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.
Related concepts
XDPreUpgrade command
Where migration tasks are performed
Related tasks
Migrate WebSphere XD
Migrate product configurations