Home
Documentation
This Help Center provides documentation on all aspects of the HCL Commerce+ Transaction Server product, from installation and deployment to operating and customization.
Migrating
The following topics show how to migrate an existing HCL Commerce Version 9.1 environment to Commerce+ Transaction Server.
Migrating 9.1 databases
Migrate HCL Commerce v9.1.x.0 databases (Db2 or Oracle) to HCL Commerce+ Transaction Server using the wcim_ant utility. It includes guidance for Development, Staging, and Production database environments.

Documentation
This Help Center provides documentation on all aspects of the HCL Commerce+ Transaction Server product, from installation and deployment to operating and customization.
- Overview
  Welcome to the HCL Commerce+ Transaction Server overview. Explore these feature overviews to learn how Commerce+ Transaction Server operates. Refer to the related links listed at the end of each topic to access expanded product documentation.
- Deploying
  This section provides details on deploying HCL Commerce+ Transaction Server. It explains how to download the Docker images and Git bundles that comprise the product, how to create a minimal environment, and how to plan for a full deployment. It details supported software versions, patches, and configurations to ensure the platform performs well.
- Migrating
  The following topics show how to migrate an existing HCL Commerce Version 9.1 environment to Commerce+ Transaction Server.
  - Migrating 9.1 databases
    Migrate HCL Commerce v9.1.x.0 databases (Db2 or Oracle) to HCL Commerce+ Transaction Server using the wcim_ant utility. It includes guidance for Development, Staging, and Production database environments.
    - Migrating the staging database
      In this section, you will learn how to efficiently migrate the staging database, ensuring a smooth and reliable transition process.
    - Migrating the production database
      In this section, you will learn how to efficiently migrate the production database, ensuring a smooth and reliable transition process.
  - Migrating the HCL Commerce Version 9.1 code
    Migrate HCL Commerce Version 9.1 code using the guidance below. As part of this migration, remove all IBM-related code, such as com.ibm.commerce, and include only the code that is proprietary to your organization.
  - Migrate Solr search to Commerce+
    Migrate your Solr-based search solution from HCL Commerce Version 9.1 to Commerce+ Transaction Server. This is the first step in adopting Commerce+ Transaction Server, letting you run your existing customizations on the new runtime with your current database before you optionally move to PostgreSQL.
  - Migrate Elasticsearch to Commerce+
    Migrate your Elastic-based search solution from HCL Commerce Version 9.1 to Commerce+ Transaction Server. This is the first step in adopting Commerce+ Transaction Server, letting you run your existing customizations on the new runtime with your current database before you optionally move to PostgreSQL.
  - Migrating 9.1 JSP store to Commerce+
    Migrate custom downstream CRS extension repositories to Java 21, Spring 6, and Open Liberty 26+. Update Enterprise APIs to Jakarta EE and modernize your build toolchain.
- Operating
  The topics in this section focus on tasks that are performed by business users, marketers, and customer support representatives to connect with partners and attract and satisfy customers.
- Administering
  The site administrator performs the tasks needed to support day to day operations of the Commerce+ Transaction Server site.
- Extending
  Using Commerce+ Transaction Server's xC programming model, you can use HCL-provided extension points to extend existing Commerce logic. You can implement these extensions with the xC Customization toolkit provided by HCL. Commerce+ also provides Packaged Business Capability integrations that extend the product's reach and functionality.
- Securing
  These topics describe the security features of Commerce+ Transaction Server 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 Commerce+ Transaction Server site performance.
- Troubleshooting
  Topics in the Troubleshooting section highlight common issues that are encountered with Commerce+ Transaction Server, and how they can be addressed or mitigated.
- Reference
  Topics in the Reference section contain all of the Commerce+ Transaction Server reference documentation.

Migrating HCL Commerce Version 9.1 databases

Migrate HCL Commerce v9.1.x.0 databases (Db2 or Oracle) to HCL Commerce+ Transaction Server using the wcim_ant utility. It includes guidance for Development, Staging, and Production database environments.

Pre-requisite

Before you migrate to HCL Commerce+ Transaction Server from HCL Commerce Version 9.1, review this information to help plan and execute your migration.

To initiate the migration, ensure the customer environment is on HCL Commerce version 9.1.20.0 or higher. The migration process supports migrating to HCL Commerce+ Transaction Server version 26.07.22 (July 2026) and onward.

Best practices for Database migration

Backup everything first: Always complete the backup of the source database before starting migration. Retain backups until post-migration verification is complete.
Use a Non-Production Environment First: To uncover potential issues early, perform trial migrations in a development or staging environment.
Monitor Logs Closely: Use -logLevel Verbose for all wcim_ant executions. Review the logs immediately after each migration step for errors or warnings.
Set Maintenance Windows: Schedule the migration during a designated maintenance window to avoid disruption to business operations.
Post-Migration Validation: To confirm application stability, test core functionalities like storefront access, catalog browsing, order placement, and admin tools.
Update SITE Table Correctly: Ensure the SITE table version is correctly updated and audited as part of the migration checklist.

High-Level Migration Steps

Back up the 9.1.x.0 database and restore it to the HCL Commerce+ Transaction Server database environment.
Run pre-migration checks using the wcim_ant tool.
Perform the database migration using wcim_ant.
Update the SITE table version.
Run the updatedb utility from the HCL Commerce+ Transaction Server environment.