Home
User Guide
The information contained in this section applies to WebSphere Commerce Version 8. The documentation also applies to all subsequent releases and modifications until otherwise indicated in a newer section.WebSphere Commerce is a single, unified e-commerce platform that offers the ability to do business directly with consumers (B2C), directly with businesses (B2B), and indirectly through channel partners (indirect business models). WebSphere Commerce is designed to be a customizable, scalable, and high availability solution that is built to leverage open standards. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels.
Migrating
Before you migrate to WebSphere Commerce Version 8.0, review this information to help plan and execute your migration.
Migrating WebSphere Commerce
The following section outlines the available migration paths for moving from WebSphere Commerce Version 7.0 to WebSphere Commerce Version 8.0.
Migrating runtime environments (with staging servers)
The following section outlines the high-level steps that must be followed to migrate your runtime instance from version 7.0 to version 8.0. These steps are specific to version 7.0 environments that are configured with a staging or authoring instance.
Migrating the staging server
The following section outlines the high-level steps that must be followed to migrate your staging server from version 7.0 to version 8.0. The sequence of these migration steps is specific to version 7.0 environments that are configured with a staging or authoring instance.

User Guide
The information contained in this section applies to WebSphere Commerce Version 8. The documentation also applies to all subsequent releases and modifications until otherwise indicated in a newer section.WebSphere Commerce is a single, unified e-commerce platform that offers the ability to do business directly with consumers (B2C), directly with businesses (B2B), and indirectly through channel partners (indirect business models). WebSphere Commerce is designed to be a customizable, scalable, and high availability solution that is built to leverage open standards. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels.
- Planning
  Creating a custom implementation of a WebSphere Commerce store requires a significant amount of planning. From gathering client needs, to deploying the live solution, much work is needed to successfully deploy a custom client store. Use the resources in here to help you plan every phase of store creation.
- Installing
  Review the following sections for information about installing the WebSphere Commerce product, associated maintenance, and WebSphere Commerce enhancements.
- Migrating
  Before you migrate to WebSphere Commerce Version 8.0, review this information to help plan and execute your migration.
  - Planning to migrate WebSphere Commerce
    Most businesses treat investments in technology updates and migrations as overhead expenses. Even though you might need to upgrade or migrate to the latest WebSphere Commerce version to take advantage of the technological offering, providing a business justification to do so requires outlining the business benefits, strategy, and migration plan.
  - Migrating WebSphere Commerce Developer
    The following section outlines the high-level steps that must be completed to migrate your WebSphere Commerce Version 7.0 Developer environment to WebSphere Commerce Developer Version 8.0. Migrating WebSphere Commerce Developer includes completing the following steps in order.
  - Migrating WebSphere Commerce
    The following section outlines the available migration paths for moving from WebSphere Commerce Version 7.0 to WebSphere Commerce Version 8.0.
    - Migrating runtime environments (without staging servers)
      The following section outlines the high-level steps that must be followed to migrate your runtime instance from version 7.0 to version 8.0. These steps are specific to version 7.0 environments that are not configured with a staging or authoring server.
    - Migrating runtime environments (with staging servers)
      The following section outlines the high-level steps that must be followed to migrate your runtime instance from version 7.0 to version 8.0. These steps are specific to version 7.0 environments that are configured with a staging or authoring instance.
      - Migrating the staging server
        The following section outlines the high-level steps that must be followed to migrate your staging server from version 7.0 to version 8.0. The sequence of these migration steps is specific to version 7.0 environments that are configured with a staging or authoring instance.
        Preparing WebSphere Commerce Version 7.0 for migration
        Prepare your version 7.0 staging environment by backing up your WebSphere Commerce Version 7.0 and staging database. Keep WebSphere Commerce Version 7.0 staging environment, including the database, available if anything goes wrong during the upcoming migration. The staging database backup is restored to your version 8.0 staging environment in the upcoming section of the migration.
        Preparing WebSphere Commerce Version 8.0 for migration
        Before you began the migration process, you were asked to install WebSphere Commerce Version 8.0 and create a staging or authoring instance. Complete the following database-related tasks to prepare your version 8.0 environment for migration.
        Migrating the staging database
        You can migrate the database by using the Migration wizard or the command line.
        Deploying your migrated customizations to your staging server
        Using either your version 8.0 development environment or your designated version 8.0 build server to deploy your customized assets to your version 8.0 staging server.
        Migrating WebSphere Commerce Search
        You can migrate WebSphere Commerce Search from an earlier version to a later version, according to your site requirements.
        Migrating site security for WebSphere Commerce
        If you are migrating your staging server from WebSphere Commerce Version 7.0 to WebSphere Commerce Version 8.0, manually migrate your security configurations.
        Migrating WebSphere Commerce XML configuration files
        You must prepare your wc-server.xml on your WebSphere Commerce Version 8.0 staging environment for migration. Once the file is updated, run the configMigration utility to migrate the wc-server.xml and any remaining XML configuration files.
        Migrating remaining WebSphere Commerce functions
        After you migrate your staging database and deployed your customizations from version 7.0 to version 8.0, migrate any remaining WebSphere Commerce functions.
        Clustering WebSphere Commerce
        You can cluster your WebSphere Commerce Version 8.0 environment before you proceed further with the migration.
        Completing the staging migration
        After you migrate the staging database and your custom assets, complete remaining updates to your staging database.
      - Migrating the production server
        After you migrate your staging server, migrate the production server. The following section outlines the high-level steps that must be followed to migrate your production server from version 7.0 to version 8.0.
    - Converting a staging server into an authoring server
      The following section outlines the high-level steps that must be followed to convert a WebSphere Commerce version 8 staging server into a workspace-enabled authoring server.
- Deploying
  The topics in this section describe how to publish stores to either a test or production environment, and how to deploy customized code.
- Operating
- Integrating
  Topics in the Integrating category highlight the tasks that are commonly performed for using WebSphere Commerce in combination with other products.
- Administering
- Tutorials
  WebSphere Commerce provides many tutorials to help you customize and understand your WebSphere Commerce instance and stores.
- Samples
- Developing
  The topics in the Developing section describe tasks performed by an application developer.
- Compliance
  The following section describes how you can leverage WebSphere Commerce features and functionality to help your site be compliant with different privacy and security standards.
- Securing
  These topics describe the security features of WebSphere Commerce and how to configure these features.
- Performance
- Troubleshooting

WebSphere Commerce Version 8.0.1.0 or later

Migrating the staging server

The following section outlines the high-level steps that must be followed to migrate your staging server from version 7.0 to version 8.0. The sequence of these migration steps is specific to version 7.0 environments that are configured with a staging or authoring instance.

Notes:

Do not run the stagingcopy utility while you migrate this staging migration process. This migration process assumes that you have a fully functioning version 7.0 staging server to migrate.
If you ran stagingcopy on your version 7.0 staging environment, you cannot migrate your version 7.0 staging environment to version 8.0. As an alternative, you can create a new staging server from a migrated runtime environment. For more information about this, see Creating a staging server on a migrated environment.

Before you begin

Upgrade your WebSphere Commerce Version 7.0 database to one of the following levels:
- DB2 10.5 Fix Pack 5 or later
- Oracle 12c
Install WebSphere Commerce Version 8.0.
Note: Install WebSphere Commerce Version 8.0 on a separate machine from your WebSphere Commerce Version 7.0. The two installations cannot coexist on the same machine.
Install the latest Mod Pack and Fix Pack.
Create a staging or authoring instance.
Notes:
- When you create a version 8.0 staging or authoring instance for migration, the following instance properties must match your version 7.0 instance:
  - Instance name
  - Merchant key
  - Database name
  - Default language
  - Web server configurations
    - Web server type
    - Local web server / remote web server
    - Installation path
- To verify your version 7.0 instance properties, review your createInstance.properties file, which is located under your WC_installdir/instances/instance_name/properties/ directory.
Verify your WebSphere Commerce Version 8.0 installation.
Deploy the search server in standard configuration.
Note: You can cluster your search server while migrating search.

Procedure