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.
Administering
WebSphere Commerce instance
Every WebSphere Commerce installation requires at least one instance to function, and each WebSphere Commerce instance can contain one or more stores.
Configuring directory services (LDAP) with WebSphere Commerce
WebSphere Commerce can be configured to use one or more LDAP servers as the master user repository instead of the WebSphere Commerce database. This is typically done when multiple applications need to share a common user repository.
Preparing the LDAP server for use with WebSphere Commerce
The steps on this page describe how to prepare an LDAP server to use with WebSphere Commerce.

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.
- 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
  - Overview of administering a WebSphere Commerce site
    In WebSphere Commerce the person who performs administrative tasks is called a Site Administrator. The Site Administrator installs, configures, and maintains WebSphere Commerce and the associated software and hardware. The administrator responds to system warnings, alerts, and errors, and diagnoses and resolves system problems. Typically, this person controls access and authorization (creating and assigning members to the appropriate role), manages the Web site, monitors performance, and manages load balancing tasks. The Site Administrator might be responsible for establishing and maintaining several server configurations for different stages of development such as testing, staging, and production. The Site Administrator also handles critical system backups and resolves performance problems.
  - WebSphere Commerce instance
    Every WebSphere Commerce installation requires at least one instance to function, and each WebSphere Commerce instance can contain one or more stores.
    - Modifying a WebSphere Commerce instance
      You can use the Configuration Manager to change any of the configuration settings for your WebSphere Commerce instance.
    - Deleting a WebSphere Commerce instance
      You can delete an instance when you no longer need any of the resources and services that are associated with the instance. You can also choose to delete the WebSphere Application Server profile and server that is associated with the instance. Deleting an instance that is not needed can free up a significant amount of system resources and can make the resources available for other purposes.
    - Changing the ports used for WebSphere Commerce tools
      In the Instance creation wizard, you can specify the ports that are used for WebSphere Commerce tools. You can also change the ports after instance creation.
    - WebSphere Commerce federation
      Federating your WebSphere Commerce environment requires WebSphere Application Server Network Deployment. After you federate, you can configure clustering.
    - Clustering your WebSphere Commerce environment
      After you federate your WebSphere Commerce environment, you can configure clustering. Clustering provides failover protection and workload balancing.
    - Configuring directory services (LDAP) with WebSphere Commerce
      WebSphere Commerce can be configured to use one or more LDAP servers as the master user repository instead of the WebSphere Commerce database. This is typically done when multiple applications need to share a common user repository.
      - Directory Services and WebSphere Commerce
        WebSphere Commerce connects to LDAP using Federated repositories, provided in WebSphere Application Server.
      - Preparing the LDAP server for use with WebSphere Commerce
        The steps on this page describe how to prepare an LDAP server to use with WebSphere Commerce.
        Configuring IBM Security Directory Server for use with WebSphere Commerce
        If you use IBM Security Directory Server, complete the steps on this page.
        Configuring IBM Lotus Domino LDAP Service for use with WebSphere Commerce
        If you use IBM Lotus Domino LDAP Service, follow the steps on this page.
        Configuring Microsoft Windows Server Active Directory for use with WebSphere Commerce
        If you use Microsoft Windows Server Active Directory, complete the steps on this page.
        Configuring NetIQ eDirectory for use with WebSphere Commerce
        You can use NetIQ eDirectory, a full-service secure LDAP directory, to run your organization's identity infrastructure.
      - Setting up LDAP over SSL
        You can configure WebSphere Application Server and WebSphere Commerce to access your LDAP directory over SSL to ensure the confidentiality of the data, for example passwords, exchanged between WebSphere Application Server, the WebSphere Commerce Server, and your LDAP server. This is mandatory for some LDAP servers, for example Microsoft Active Directory and NetIQ eDirectory. Configuring LDAP over SSL is a separate operation from configuring the HTTP Server to accept incoming browser requests over HTTPS.
      - Enabling security with federated repositories
        To use WebSphere Commerce with LDAP, you must configure WebSphere Application Server Administrative Security with Federated Repositories.
      - Replication for LDAP
        The ldapentry.xml file is used to configure which attributes are synchronized between the LDAP server and the WebSphere Commerce database. Some commonly used attributes are specified by default. The actual synchronization is done whenever the synchronization beans are used: UserSyncBean for user profile data, and OrganizationSyncBean for organization data.
      - Selected user exclusion from your LDAP server
        You can store some users in the LDAP server, such as your internal (sell-side) users, and other users, in the WebSphere Commerce database, such as your customers. To assign your users, you must configure WebSphere Commerce to use LDAP, and then modify the instance configuration file to specify which users you want to exclude from your LDAP server.
      - Testing your LDAP configuration
        To ensure that LDAP is working properly, complete the following test.
      - Disabling LDAP
        You can disable LDAP using the Configuration Manager.
      - Federating two LDAP servers with a common root organization
        All users and organizations reside on a single LDAP server by default. If you require that shoppers and internal users exist on separate LDAP servers, you can follow this example to set up this configuration. In this example, B2C shoppers exist under the default organization, which resides on LDAP server 1, and internal users that manage the site exist under the seller organization, which resides on LDAP server 2.
      - Federating two LDAP servers without a common root organization
        You can leverage the directory integration features of Virtual Member Manager (VMM) in WebSphere Application Server to map between different organizational hierarchies in LDAP.
      - LDAP customization points
        There are customization points available when you integrate with LDAP to handle extra synchronization logic.
    - Enabling the SSL Accelerator option
      An SSL Accelerator (or SSL Terminator) strips off HTTPS encryption at or before the Web server tier in a multitier setup. When you use an SSL Accelerator with WebSphere Commerce, you can use the SSL Accelerator option to configure WebSphere Commerce to correctly receive requests that require redirects.
    - XML configuration directory
      WebSphere Commerce uses an XML directory to configure many different aspects of its behavior. Many different customization tasks will require you to modify the XML, template definition, template definition DTD, and DTD files in these directories.
    - Changing database settings on an existing WebSphere Commerce instance
      If you want to change database settings, such as the database host name or the port number, on an existing WebSphere Commerce instance, you must manually complete the changes.
    - Business Object thresholds
      Applying limits on business operations reduces the risk of system attacks where unbound conditions might result in system failures.
  - Managing features
    You can administer the features for your store and site, such as attribute, catalog, promotion, marketing, order management features, and more. The administration tasks that you can complete differ depending on the type of feature and the tool that you use to administer your store and site.
  - Logging services
    WebSphere Commerce provides facilities for logging. For existing customers, ECTrace and ECMessage are still supported. For new implementations, use the WebSphere Application Server recommendation for logging and tracing.
  - Business auditing
    Business auditing is the capturing of the business logic and objects during a WebSphere Commerce operation. You may want to audit your business for various reasons: generic, such as to review various tasks performed weekly; or specific, such as to track the steps involved in a particular Customer Service Representative's order. A report on business auditing is available in the Administration Console.
  - 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.
  - Staging server
    The WebSphere Commerce staging server is a part of the production environment where business and technical users can update and manage store data and preview changes. The changes can then be propagated to the production server.
  - WebSphere Commerce database
    As a site administrator, maintain the WebSphere Commerce database and ensure that any WebSphere Commerce utilities and processes that load and retrieve data from the database is configured to connect to the database properly.
  - Dynamic caching
    In general, caching improves response time and reduces system load. Caching techniques are used to improve the performance of World Wide Web Internet applications. Most techniques cache static content (content that rarely changes) such as graphic and text files. However, many websites serve dynamic content, containing personalized information or data that changes more frequently. Caching dynamic content requires more sophisticated caching techniques, such as those provided by the WebSphere Application Server dynamic cache, a built-in service for caching and serving dynamic content.
  - Extracting, transforming, and loading data
    WebSphere Commerce provides multiple utilities for preparing and loading data into a WebSphere Commerce database. The loading utilities are flexible and you can continue to use these utilities when you customize the WebSphere Commerce schema.
  - Payment plug-ins
    To configure a payment plug-in define payment and refund methods; payment and refund rules; and the payment protocols that you intend to use.
  - WebSphere Commerce Search
    For a fully functioning WebSphere Commerce Search implementation, you must understand and complete the search administration tasks, which include search index management and ongoing maintenance.
  - Deploying a WebSphere Commerce dual cell environment
    Consider deploying a dual cell environment to achieve continuous availability and ensure that shoppers are minimally affected by planned or unplanned outages.
  - IBM Customer Service for WebSphere Commerce
    IBM Customer Service for WebSphere Commerce is a separately purchased product that provides a light-weight customer service solution that is embedded in the Aurora B2C and Aurora B2B storefronts. Even though this solution is a separately purchased product, it is not a separate application. Stores that are enabled with IBM Customer Service for WebSphere Commerce allow a customer service representative (CSR) to act on behalf of guest customers and registered customers. A CSR can manage customer accounts, cancel and reorder orders, and shop as customer. A CSR can also act on behalf of Buyer Administrators to help complete Aurora B2B tasks from the storefront, without having to access the Organization Administration Console.
- 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

Preparing the LDAP server for use with WebSphere Commerce

The steps on this page describe how to prepare an LDAP server to use with WebSphere Commerce.

Before you begin

Ensure that WebSphere Commerce has write access on the LDAP server. Read-only access is not supported.

Determine the DN of the Root organization and the Default organization. These fundamental organizations are part of the WebSphere Commerce membership system. Root Organization is at the top of the membership hierarchy, and all other organizations are descendants of it. Default Organization is directly under Root Organization, and is the parent of guest and B2C users. Do not create B2B users under the Default Organization. Create B2B users under their respective buyer and seller organizations.

If a user is manually created in the LDAP server and then the user logs on to WebSphere Commerce, or performs single sign-on to WebSphere Commerce, the user is automatically replicated into the WebSphere Commerce database, however the password remains only on the LDAP server. When the user is created in the WebSphere Commerce database, the user profile type is determined by the parent organization:

Parent organization of the user is Default Organization - profile type 'C' (B2C user)
Parent organization of the user is not Default Organization - profile type 'B' (B2B user)

'B' (B2B) type users are managed from the Organization Administration Console while 'C' (B2C) type users are managed from WebSphere Commerce Accelerator.

Note: The relationship of the user to its parent organizations is defined in the MBRREL table and mirrored in user DN.

WebSphere Commerce provides default DNs that you can customize:

Root Organization: Default DN: o=root organization
Example of customized DN: dc=domain,dc=ibm,dc=com
Default Organization: Default DN: o=default organization,o=root organization
Example of customized DN: cn=users,dc=domain,dc=ibm,dc=com