Run the WCIM utility


To run the WCIM utility do the following:

  1. Run the WCIM script (with any optional flags that you might require for the application tier) from the following directory:

    (Linux)(AIX)(Solaris) Run WCIM as the same user you use to start your WebSphere Commerce application server. IBM recommends that you use a non-root user, for example, wasuser to do so. Following is an example of switching to the wasuser: su - wasuser.

    (i5/OS) All WCIM commands must be run from within the iSeries QShell. Open a Qshell window by running the STRQSH command. The user running WCIM must have *SECOFR authority.

  2. Type the following WCIM command to migrate the current WebSphere Commerce version application tier with minimal options (this is normally sufficient for most migrations):

    • (i5/OS)

      ./wcim.sh -component component -from previous_version
   -action action -instanceName instance

    • (Linux)(AIX)(Solaris)

      ./wcim.sh -component component
   -from previous_version
   -action action -instanceName instance

    • (Windows)

      wcim.bat -component component -from previous_version -action
     
  
  action -instanceName instance





    • ./wcim.sh db2390 -component component -from previous_version
    
     -action action -instanceName instance

    where:

    • previous_version is the version of WebSphere Commerce you are migrating from for example, 55,56, or 561.

    • component is either app, ws, or wpm, meaning application, Web server, and Payments respectively.

    • action is either backup, migrate, or config.

    Run the command migrates the application tier to the WebSphere Commerce, v6 level.

  3. (Linux)(AIX)(Solaris)(Windows) Provide responses to the following prompts:

    1. WCIM checks whether the WebSphere Commerce instance name is already used, and prompts you to enter a new WebSphere Commerce, v6 instance name. The length of the WebSphere Commerce instance name you enter cannot be greater than 12 characters long,

      (i5/OS) 10 characters, and cannot include any of the following characters:/ \ " | < > ? * : &.

    2. A new Web server host name. If you install the Web server locally on the WebSphere Commerce, v6 machine, you can accept the default host name or type a new host name as applicable. If you use the same remote Web server as your previous WebSphere Commerce version, type a new Web server host name that is different from that your previous WebSphere Commerce version. Otherwise, there will be a port conflict between your new instance and old instance. In test runs, you can not reuse the same Web server host name as the production site is still running.

  4. (i5/OS) Provide a response to the prompt for the WAS 6 instance name that the migrated WebSphere Commerce instance will use.

  5. Verify that WCIM ran successfully. See the WebSphere Commerce Migration Guide.

  6. Perform post migration steps. See the WebSphere Commerce Migration Guide.

Related tasks

Related reference