Home
Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. 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. Business users can also use AI enabled content management capabilities.
Tutorials
HCL Commerce provides many tutorials to help you customize and understand your HCL Commerce instance and stores.
Migration
HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to migration from previous versions of WebSphere Commerce. The following tutorials provide sample guides to migrating your WebSphere Commerce sites to HCL Commerce Version 9.
Migrating a WebSphere Commerce store
This tutorial demonstrates how to migrate an Aurora-based store from WebSphere Commerce Version 7 or Version 8, to HCL Commerce Version 9.

Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. 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. Business users can also use AI enabled content management capabilities.
- Getting started
  HCL Commerce has different advantages for business users, administrators and developers. HCL Commerce targets each of these roles with a tailored set of offerings so that each of your users can get maximum benefit.
- Installing and deploying
  Learn how to install and deploy HCL Commerce development environments and HCL Commerce production environments.
- Migrating
  Before you migrate to HCL Commerce Version 9, review this information to help plan and execute your migration.
- Operating
  Topics in the Operating category highlight tasks that are typically performed by business users, customer support representatives, to complete their day-to-day tasks in the operation of the HCL Commerce site.
- Integrating
  Topics in the Integrating category highlight the tasks that are commonly performed for using HCL Commerce in combination with other products.
- Administering
  Topics in the Administering category highlight tasks that are typically performed by the Site Administrator, to support daily operations of the HCL Commerce site.
- Customizing
  The topics in the Customizing section describe tasks performed by an application developer to customize HCL Commerce.
- Tutorials
  HCL Commerce provides many tutorials to help you customize and understand your HCL Commerce instance and stores.
  - Docker start-up logic
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to the customizing Docker start-up logic. The following tutorials provide sample guides to defining the custom logic.
  - Programming model
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to creating customized code to develop and enhance HCL Commerce applications. The following tutorials provide sample guides to customizing elements of the HCL Commerce programming model.
  - Web services
    Web services tutorials introduce the various tasks that are related to creating and customizing web services for HCL Commerce applications.
  - Management Center
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to customizing Management Center.
  - Migration
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to migration from previous versions of WebSphere Commerce. The following tutorials provide sample guides to migrating your WebSphere Commerce sites to HCL Commerce Version 9.
    - Migrating a WebSphere Commerce store
      This tutorial demonstrates how to migrate an Aurora-based store from WebSphere Commerce Version 7 or Version 8, to HCL Commerce Version 9.
      - Create the local store
        In this lesson, you create the local store in your HCL Commerce development environment.
      - Create the deployment package
        In this lesson, you create the deployment package containing your local store using the WCB tool. This package can then be used to create custom Docker images for use in a live production environment.
      - Create the Docker images
        In this lesson, you create the custom Docker images for your Transaction server (ts-app) and Transaction web server (ts-web) from the contents of the WCB tool generated deployment package containing your migrated local store. These images can then be deployed into a live production environment to serve site traffic.
      - Deploy the Docker images
        In this lesson, you deploy the custom Docker images for your Transaction server (ts-app) and Transaction web server (ts-web). These images can then be used in a live production environment deployment to serve site traffic.
  - Search
    HCL Commerce provides tutorials that are designed to describe how to customize HCL Commerce Search.
  - Starter stores
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to customizing the storefront.
- Samples
  Topics in the Samples category highlight the various samples that are provided with HCL Commerce.
- Compliance
  The following section describes how you can leverage HCL Commerce features and functionality to help your site be compliant with different privacy and security standards.
- Securing
  These topics describe the security features of HCL Commerce and how to configure these features.
- Performance
  Topics in the Performance section describe the means by which to plan, implement, test, and re-visit the optimization of HCL Commerce site performance.
- Troubleshooting
  Topics in the Troubleshooting section highlight common issues that are encountered with HCL Commerce, and how they can be addressed or mitigated.
- Reference
  Topics in the Reference section contain all of the HCL Commerce reference documentation.

Tutorial: Migrating a WebSphere Commerce store

This tutorial demonstrates how to migrate an Aurora-based store from WebSphere Commerce Version 7 or Version 8, to HCL Commerce Version 9.

Learning objectives

After completing this tutorial, you should be familiar with the following concepts and tasks:

The difference in architectures between a remote and local store.
The tasks required for migrating WebSphere Commerce stores.
The tasks required for the building and deployment of custom Docker containers, for use in live production HCL Commerce environments.

Time required

Expect this tutorial to take 3 hours or more to complete. The tutorial takes longer if you explore all of the concepts and tasks that are related to this tutorial.

Skill level

Advanced

Audience

This tutorial is intended for developers who are responsible for migrating, customizing, testing, building and deploying HCL Commerce sites.

Prerequisites

Before you begin:

Read the following sections in the HCL Commerce documentation to gain the prerequisite knowledge required to migrate a legacy WebSphere Commerce store:
- Migrating a legacy WebSphere Commerce store, to learn the differences in available store architectures.
- Deploying custom changes, to learn the basics about building your custom HCL Commerce Docker images.
- Setting up an HCL Commerce production environment without IBM Cloud Private and HCL Commerce production environment overview, to learn about the HCL Commerce Version 9 production environment, and the various methods that can be used to stand up a production site from your custom Docker images.
Ensure that you have full backups of your WebSphere Commerce site. This will ensure that any errors that are made during the migration can be fully reversed.
Specific backup instructions are also included in the lessons and tasks that are referenced throughout this tutorial.