WCIM utility
The WebSphere Commerce Instance Migration (WCIM) utility is the recommended tool to use for migrating your WebSphere Commerce environment. For an overview of the utility, review this information.
The WCIM (WebSphere Commerce Instance Migration) utility is provided in the following directory:
AIX|Linux|Solaris|I5/OS:
WC_installdir/bin
Windows:
WC_installdir\bin
Before running the WCIM utility, see Migrating the application using the WCIM utility for additional steps. The following syntax is used for the WCIM script:
- -component
- (Required) Specify one of the following values:
- ws
- Web server
- app
- WebSphere Commerce application
- wpm
- WebSphere Commerce Payments and WebSphere Commerce Payments Web server
-
- -instanceName
- Specifies the WebSphere Commerce or WebSphere Commerce Payments instance
to be migrated, specified by instance.
If WCIM detects that your existing instance is already in use, it will prompt you to enter a new instance name.
AIX|Linux|Solaris|Windows:
The length of the WebSphere Commerce or Payments instance name cannot be greater than 12 characters long, and must not include the following characters:
/ \ " | < > ? * : &
I5/OS|The length of the WebSphere Commerce or Payments instance name you enter cannot be greater than 10 characters long and must not include the following characters:
/ \ " | < > ? * : &
- -from
- (Required) If you have set -component to either ws or app,
select one of the following values for (previous_version):
- 55
- WebSphere Commerce V5.5
- 56
- WebSphere Commerce V5.6
- 561
- WebSphere Commerce V5.6.1
(Required) If you have set -component to wpm, select one of the following values for version:
- wcp55
- WebSphere Commerce Payments V5.5
- wcp56
- WebSphere Commerce Payments V5.6
- wcp561
- WebSphere Commerce Payments V5.6.1
- -action
- (Required) Specify one of the following values:
- backup
- Backup the application tier on your WebSphere Commerce machine.
- migrate
- Migrate the application tier on your WebSphere Commerce machine.
- config
- Configure the Web server tier.
-
- The WCIM -action config parameter can change the host name for the Web server tier configuration to a temporary host name during application tier migration. However, it does not change the host name for optional components such as WebSphere Commerce Payments, WebSphere Commerce Analyzer, or LDAP. If you have made any changes for these components that impact their host name during the course of migration (for example, if you change the machine on which they run), update the host name for the component using the appropriate panel in WebSphere Commerce Configuration Manager.
- For the Web server, instance must be different
for app and wpm.
When running:
- wcim.sh -component ws -from 55 -action config -instanceName instance
The instance points to new instance name.
When running:
- wcim.sh -component wpm -from wcp55 -action config -instanceName instance
The instance points to an old instance name.
- -loglevel
- (Optional) Specify one of the following values:
- NONE
- WCIM does not generate an error log.
- ERROR
- WCIM generates an error log that contains only the error messages (if any).
- NORMAL
- WCIM generates an error log that contains any error messages plus normal status messages.
- VERBOSE
- WCIM generates an error log that contains any error messages, normal status messages, plus additional detailed explanations of these errors.
- DEBUG
- WCIM generates an error log that contains any error messages, normal status messages, additional detailed explanations of these errors, plus additional debug information.
- -testRun
- (Optional) If you have set -component to ws; enter true or false. The default value is true.
Related concepts