SAP Commerce Cloud

Last update: April 24, 2024

CREATED FOR:

  • Admin
  • Developer
NOTE
This page contains links to the hybris website. For certain pages, you need an account to log in.

Deploying eCommerce with SAP Commerce Cloud

NOTE
The following procedures use the following demonstration catalog to illustrate the deployment:
Geometrixx Outdoors Site English (US)

Deploying the necessary eCommerce packages provides the full functionality of the eCommerce framework, together with a reference implementation of eCommerce functionality as provided with a hybris implementation (including a demonstration catalog)

This is available under the English (US) branch ( /content/geometrixx-outdoors/en_US) of the Geometrixx Outdoors site:

Technical Requirements - hybris Server

The hybris extension of the eCommerce Integration Framework has been updated to support Hybris 5 (as default), while maintaining backward compatibility with Hybris 4.

NOTE

Packages Needed for eCommerce with hybris

To install eCommerce functionality, you need:

  • Your hybris server

  • AEM eCommerce framework:

    • this is part of a standard AEM installation

  • AEM Geometrixx-all package:

    • cq-geometrixx-all-pkg

  • AEM hybris content packages:

    • cq-hybris-content-6.3.2
    • hybris-specific API implementation
    • cq-geometrixx-hybris-content-6.3.2
    • a reference implementation to illustrate use of hybris ( geometrixx-outdoors/en_US)

Installation of eCommerce with hybris

To install a fully fledged configuration (using the demonstration catalog, Geometrixx Outdoors) the basic steps are:

  1. Install AEM.

  2. Install the Geometrixx-all package

    1. [cq-geometrixx-all-pkg](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq60/product/cq-geometrixx-all-pkg)

  3. Install the demonstration content packages using the Package Manager:

    1. [cq-hybris-content-6.3.2](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq630/product/cq-hybris-content)
    2. [cq-geometrixx-hybris-content-6.3.2](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq630/product/cq-geometrixx-hybris-content)

  4. Download and build your hybris Server.

  5. Construct your catalog in your eCommerce engine:

    1. Set up the Geometrixx Outdoor Store.

  6. Author any supplementary pages that you need in AEM.

CAUTION
Use of the hybris server requires a separate hybris license.
NOTE
For developers, API documentation is also available for download.

Download and Build your hybris Server

The steps in this procedure download and build the hybris server. It also makes the initial configurations that are required for the connections between hybris and cq. The extension is then usable with the default settings.

CAUTION
Hybris versions earlier than 5.5.1 are not supported.
NOTE
To complete this, you need Groovy installed on your system.

  1. Download the hybris Commerce Suite distribution from the hybris download site.

    CAUTION
    You need an account (from hybris) to access this.

  2. Unzip the distribution file to the required location (referred as <hybris-root-directory>).

  3. From the command line, execute the following:

    cd <hybris-root-directory>/bin/platform
. ./setantenv.sh
ant clean all
cd ../..
    NOTE
    When running:
    ant clean all
    Press Return when required.

  4. Download the following files to the root folder of your extracted hybris distribution,

        <hybris-root-directory>

    Get File

    NOTE
    For hybris 5.6.0 and later, use the following setup.groovy.

    5.6.0 and later

    Get File

  5. From the command line, execute the following to:

    • update the configuration of the hybris server (as required by the extension)
    • rebuild the hybris server with the modified configuration
    • start the server
    groovy setup.groovy
cd bin/platform
ant clean all
sh hybrisserver.sh
    NOTE
    Dependent on your system, several of these steps might take several minutes to complete.

  6. In your browser, navigate to the hybris administration console at:

    http://localhost:9002

  7. Click Initialize and then confirm the initialization action (as it deletes existing data).

    The progress is shown on the console, with FINISHED indicating completion.

    NOTE
    Dependent on your system, this might take several minutes to complete.

Set up the Geometrixx Outdoors Store

This procedure uploads and configures the demonstration store - Geometrixx Online.

  1. Start your hybris instance. From the command line, execute the following:

    cd <hybris-root-directory>/bin/platform
sh hybrisserver.sh

  2. In your browser, navigate to the hybris management console at:

    https://localhost:9002/backoffice

    Use these credentials:

    • username: admin
    • password: nimda

  3. From the sidebar navigation, expand System and Tools. Then select Import to open the Wizard: CSV Import window.

  4. In the Configuration tab, Upload the following Import file:

    Get File

  5. Set the Locale Setting to:

    en_US - English (United States)

  6. Open the Resources tab.

  7. Upload the following Media-Zip:

    Get File

  8. Click Start to import the specified files. The Result tab shows any log entries.

  9. Click Done to close the import window.

  10. From the sidebar, select System, then Tools, then Import.

  11. Upload the following Import file:

    Get File

    For hybris 5.7, use the following:

    Get File

  12. Set the Locale Setting to:

    en_US - English (United States)

  13. Click Start to import the specified files. The Result tab shows any log entries.

  14. Click Done to close the import window.

  15. You can now use the product cockpit to view the imported catalogs and products:

    http://localhost:9002/productcockpit

Experience Manager