Home
Documentation
This Help Center provides documentation on all aspects of the HCL Commerce+ product, from installation and deployment to operating and customization.
Administering
The site administrator performs the tasks needed to support day to day operations of the Commerce+ site.
Logging services
Commerce+ maintains a detailed set of logs related to a variety of processes and functions. These logs are available upon request.
Configuring logging for runtime environments
You can manage logging and tracing configurations in your runtime environments by using Run Engine commands.
Configuring logging for the Quote server
You can configure logging in the Quote Server Docker container by running the set-trace-specification script.

Documentation
This Help Center provides documentation on all aspects of the HCL Commerce+ product, from installation and deployment to operating and customization.
- Overview
  Welcome to the HCL Commerce+ overview. Explore these feature overviews to learn how Commerce+ 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+. 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+. The process consists of an initial migration of your database contents. This is followed by a code migration. Both are fully described.
- 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+ site.
  - Member groups
    A member group is a grouping of members - users, organizations, or other member groups - used for various business purposes. Two kinds of member groups exist: implicit and explicit. An implicit member group contains users that share common attributes and are therefore considered members of a specific member group. An implicit member group specifies criteria or attributes that users must satisfy in order to be considered members of that member group. You can also explicitly exclude certain users although they satisfy the criteria. An explicit member group contains explicitly assigned users, who may or may not share common attributes. A member group can be both implicit and explicit at the same time.
  - Inventory management
    Use the HCL Commerce+ Inventory to manage your inventory and access your Inventory Locations (ILs), where your inventory is physically stored and is delivered or shipped from.
  - Approvals
    Accurate, secure transactions require that a second individual approve some electronic marketplace actions before they proceed. This individual, called an approver, can accept or reject requests to perform a specific action. During the organization registration process, the organization administrator selects the business processes for which they want to enable approval. This is done by signing up for the appropriate approval member group during membership registration. The organization administrator also populates the approver member groups. Only users within these groups have the authority to accept or reject requests to perform those actions for which approval has been enabled.
  - System Administration
    Commerce Lab allows you to manage transport, messages, scheduler, Connectors, registries, and security policies.
  - Staging environment
    An Commerce+ staging environment is a runtime environment where business and technical users can update and manage store data and preview changes. The changes can then be propagated to the production environment.
  - Workspaces
    Workspaces provide a powerful and flexible way to manage and preview changes to your e-commerce website without affecting the live production environment.
  - Commerce+ database
    As a site administrator, maintain the Commerce+ database and ensure that any Commerce+ utilities and processes that load and retrieve data from the database is configured to connect to the database properly.
  - Extracting and loading data
    Commerce+ provides utilities for preparing and loading data into a Commerce+ database. The loading utilities are flexible and you can continue to use these utilities when you customize the Commerce+ schema.
  - Administering Search
    HCL Commerce+ Search provides the core search capability for Commerce+, enabling product indexing and retrieval for customer queries across the storefront. It supports guided navigation, landing pages, and dynamic merchandising, helping shoppers quickly find relevant products while giving merchandisers tools to influence search results.
  - Logging services
    Commerce+ maintains a detailed set of logs related to a variety of processes and functions. These logs are available upon request.
    - Configuring logging for runtime environments
      You can manage logging and tracing configurations in your runtime environments by using Run Engine commands.
      - Configuring logging for the Transaction server
        You can configure logging in the Transaction server Docker container by using one of two methods.
      - Configuring logging for the Quote server
        You can configure logging in the Quote Server Docker container by running the set-trace-specification script.
      - Configuring logging for the Approval server
        You can configure logging in the Approval server Docker container by running the setRuntimeTraceSpecs script.
      - Configuring logging for Kubernetes
        You can configure centralized logging for your Kubernetes deployment using Elastic, Fluentd, and Kibana (EFK).
      - Logging services
        Commerce+ maintains a detailed set of logs related to a variety of processes and functions. The Catalog import service uses Logback for logging, integrated with Spring Boot. Logging settings are configured in the logback-spring.xml file.
    - Trace components
      Use the following trace strings and logger information to gather the information that you need to troubleshoot problems.
  - Business events
    Each time that a command triggers a business event, a record is added to the BUSEVENT database table to persist data from the event. Event listeners and external systems (such as the Marketing component, a back end order management system, or an external analytics system) can use this data to perform further processing.
  - Business Object thresholds
    Applying limits on business operations reduces the risk of system attacks where unbound conditions might result in system failures.
- Extending
  Using Commerce+'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+ 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+ site performance.
- Troubleshooting
  Topics in the Troubleshooting section highlight common issues that are encountered with Commerce+, and how they can be addressed or mitigated.
- Reference
  Topics in the Reference section contain all of the Commerce+ reference documentation.

Configuring logging for the Quote server

You can configure logging in the Quote Server Docker container by running the set-trace-specification script.

Procedure

Navigate to the /SETUP/bin/ directory.

Navigate to the /SETUP/bin/ directory.

Run the set-trace-specification script with the component or components that you want to be traced.

./set-trace-specification com.hcl.commerce.rfq=TRACE

The following table includes the trace strings that are available specifically for the Quote Server Docker container. In some cases, you might need to enable trace strings in multiple servers to fully troubleshoot a component. For more information, see the MustGather sections in Trace components.


Component	Trace string
All Quote Logs	`com.hcl.commerce.rfq=TRACE`
Logging Aspect	`com.hcl.commerce.rfq.logging.RFQLoggingAdvice=TRACE`
Exception logs	`com.hcl.commerce.rfq.logging=TRACE:com.hcl.commerce.rfq.exception=TRACE`
Controller logs	`com.hcl.commerce.rfq.logging=TRACE:com.hcl.commerce.rfq.controller=TRACE`
Service logs	`com.hcl.commerce.rfq.logging=TRACE:com.hcl.commerce.rfq.service=TRACE`
Utility logs	`com.hcl.commerce.rfq.logging=TRACE:com.hcl.commerce.rfq.util=TRACE`
Security logs	`com.hcl.commerce.rfq.logging=TRACE:com.hcl.commerce.rfq.security=TRACE`

Note:

When configured as trace, all messages are displayed.
When configured as info, all messages at levels info through fatal are displayed.

Note: You can view the quote serve logs as follows:

The following command may be used to view quote logs from outside the Quote Server Docker container:
```
docker logs -f commerce_rfq_1
```
You can also view the trace log file at /SETUP/app/logs/trace.log location .

Results

Logging is now configured. You can now reproduce any issues and collect the associated logs for troubleshooting purposes.