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 (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 WebSphere Commerce Search
You can migrate WebSphere Commerce Search from an earlier version to a later version, according to your site requirements.
... from a BOD-based search deployment
Follow this procedure to migrate from a BOD-based search deployment to the WebSphere Commerce Version 8 REST-based model.
Preprocessing the search index
Preprocess the search index to ensure that your search index works in the new version.

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.
      - Preparing WebSphere Commerce Version 7.0 for migration
        Prepare your version 7.0 environment by backing up your WebSphere Commerce Version 7.0 and database. Keep the WebSphere Commerce Version 7.0 environment, including the database, available if anything goes wrong during the upcoming migration. The database backup is restored to your version 8.0 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. Complete the following database-related tasks to prepare your version 8.0 environment for migration.
      - Migrating the database
        You can migrate the database by using the Migration wizard or the command line.
      - Deploying your migrated customizations
        Using either your version 8.0 development environment or your designated version 8.0 build server, deploy your customized assets to your version 8.0 runtime server.
      - Migrating WebSphere Commerce Search
        You can migrate WebSphere Commerce Search from an earlier version to a later version, according to your site requirements.
        ... from a REST-based search deployment
        Follow this procedure to migrate from a REST-based search deployment to the WebSphere Commerce Version 8 REST-based model.
        ... from a BOD-based search deployment
        Follow this procedure to migrate from a BOD-based search deployment to the WebSphere Commerce Version 8 REST-based model.
        Importing and deploying previous search assets to the new version
        Your previous search customizations are required to perform some migration tasks in WebSphere Commerce Version 8. Therefore, you must move your search customizations from WebSphere Commerce Version 7 into source control in WebSphere Commerce Version 8.
        Running the migrate Solr search utility
        Run the migrate Solr search utility to migrate your search index to the new version.
        Migrating facetable attributes
        If you are migrating from WebSphere Commerce Version 7 Feature Pack 2, 3, or 4, migrate facetable attributes.
        Merging previous search assets to the new version
        Your previous search customizations must be merged back into WebSphere Commerce Version 8.
        Preprocessing the search index
        Preprocess the search index to ensure that your search index works in the new version.
        Building the search index
        Fully build the search index to ensure that your search index works in the new version.
        Securing the search server
        If your previous version of WebSphere Commerce Search had security enabled, secure the search server again. This ensures that the WebSphere Commerce Search server is secured after migration.
        Updating your storefront JSP files
        If you are migrating from WebSphere Commerce Version 7 Feature Pack 6 or lower, update your storefront JSP files.
        Reconfiguring clustering and replication
        If your previous search deployment is in a clustered environment, reconfigure clustering and replication.
      - Migrating site security for WebSphere Commerce
        If you are migrating 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 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 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.
      - Migrating the live version 7.0 database
        Migrate your live WebSphere Commerce Version 7.0 database to version 8.0 with minimal downtime.
    - 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.
    - 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

Preprocessing the search index

Preprocess the search index to ensure that your search index works in the new version.

Procedure

Complete the following task: Preprocessing the WebSphere Commerce Search index data. Ensure that you preprocess both the CatalogEntry index and the CatalogGroup index.
Restart the WebSphere Commerce Search server.