Migrate > Migrating WebSphere Commerce > Overview of migrating the WebSphere Commerce application using the Migration wizard



Migrate the WebSphere Commerce application using the Migration wizard

Before the application tier is migrated, a backup is needed. If the previous and new versions of WebSphere Commerce are installed on the same system, the Migration wizard automatically backs up the application for you. If the previous and new versions of WebSphere Commerce are installed on different systems, manual steps are required.


Before you begin

  1. AIXLinuxSolarisFor IBM i OS operating system If WebSphere Application Server Global Security is enabled, disable it before you migrate the application.

  2. For IBM i OS operating system If you are performing a remote application migration, the following steps must be completed before starting the application migration script:

    1. Install WebSphere Application Server v7 on the WebSphere Commerce v5.6.1 or 6.0 machine.

    2. Copy WC_INSTALL/bin/backupAppWAS400.sh from the WebSphere Commerce v7 machine to a temporary directory tempDir on the WebSphere Commerce v5.6.1 or 6.0 machine.

    3. Run tempDir/backupAppWAS400.sh on the WebSphere Commerce v5.6.1 or 6.0 machine. For more information, run backupAppWAS400.sh directly to display its usage details.

    4. Copy prod.jar, user.jar, and backupforpostupgrade.jar from /tmp on the WebSphere Commerce v5.6.1 or 6.0 machine to a temporary directory tempDir70 on the WebSphere Commerce v7 machine.

    5. Run WC_INSTALL/bin/restoreAppWAS400.sh on the WebSphere Commerce v7 machine to restore the backup files. For more information, run restoreAppWAS400.sh directly to see its usage details.

If you are migrating multiple instances, complete the Migration wizard for each instance to migrate.


Procedure

  1. Launch the Migration wizard.

  2. Back up the WebSphere Commerce v5.6.1 or 6.0 application. The Migration wizard asks if the previous and new versions of WebSphere Commerce are installed on the same system.

    • The WebSphere Commerce versions are installed on the same system. Continue with step 3

    • For IBM i OS operating system The WebSphere Commerce versions are installed on different systems. Continue with step 3

    • AIXSolarisLinuxWindows The WebSphere Commerce versions are installed on different systems a backup is required. Continue with the following steps:

    1. Select the operating system and complete the task:

      • Locate the WebSphere Commerce v7.0 DVD and insert into the DVD-ROM drive on the machine where WebSphere Commerce Version 5.6.1 or 6.0 is installed.

    2. Navigate through the initial screen and select Custom installation.

      AIX Note: If you run the installation on AIX version 5.3, you may get an error forcing you to cancel the installation, with a message similar to the following example:

      AIX 53 Maintenance Level 06-01 was detected.  AIX 53 Maintenance level 07-01 is required.
      

      Upgrading your operating system will prevent this message. If you do not want to upgrade the old WebSphere Commerce server operating system, an alternate migration path has been provided. Execute the following steps:

      1. On the WebSphere Commerce 7.0 system, make a copy of WC_INSTALL\bin\backupAppWAS.sh to a temporary directory, tempdir, on the remote (old) machine.

      2. Log into the old WebSphere Commerce server as the root user.

      3. Run the following command:

        tempDir/backupAppWAS.sh -oldWASDir WAS_installdir -oldWCSDir WCS_installdir [oldProfileName]
        

      4. The script creates two folders in tempDir. Copy tempDir to the WebSphere Commerce version 7 server.

      5. Run the following command on the WebSphere Commerce version 7 server:

        chown -R wasuser:wasgroup tempDir
        

      6. Skip to Step 3

        When prompted, ensure that you:

        • Specify the tempDir/WAS as the previous WebSphere Application Server directory.

        • Specify tempDir/Commerce as the previous WebSphere Commerce directory.

      If you use backupAppWAS.sh to back up the WebSphere Commerce v5.6.1 or 6.0 application, select Yes for WebSphere Commerce versions installed on the same machine in the Migration wizard.

    3. From the components list, select Remote WebSphere Commerce Management Utilities. This selection installs the required backup utilities and scripts.

    4. AIXLinuxSolaris You need to change some file permissions before running the wcimRemoteBackup script:

      1. Log in as root.

      2. Open a command line session and change to the WAS_installdir\properties directory.

      3. Run the following command:

        chmod o+r NIFRegistry.properties profileRegistry.xml WSCustomConstants.properties
        

        Remember: Change the file permission back for security reasons after completing the application migration.

    5. AIXLinuxSolarisWindows Navigate to the WC_INSTALL/bin directory and run the following command:

      • Windows wcimRemoteBackup.bat -tier app -from version -action backup -instanceName instance

      • AIXLinuxSolaris Run the following command as the non-root user:

        wcimRemoteBackup.sh -tier app -from version -action backup -instanceName instance
        

      where:

      version

      The original WebSphere Commerce version. Enter 561 or 60.
      This script creates a folder, WC_INSTALL/temp/zip, containing two files:

      • backupwas.zip

      • backupwc_version_instance.zip.

    6. Copy the resulting folders to the WebSphere Commerce v7.0 target system. Ensure the files are put in WC_INSTALL/temp/zip and ensure that the WebSphere Commerce non-root user is the owner of WC_INSTALL/temp/zip and the files. The Migration wizard displays the directories where the files must be placed.

  3. Respond to prompts of the Migration wizard to migrate the application tier.

  4. After the application migration completes, the Migration wizard displays a message box. Review the information and ensure that the WebSphere Application Server administrative console port number is recorded.

  5. AIXLinuxSolarisFor IBM i OS operating system Optional: If you disabled WebSphere Application Server Global Security before you migrated the application, you can re-enable it.


+

Search Tips   |   Advanced Search