DocumentationAEM 6.4Deploying Guide

SAP Commerce Cloud sap-commerce-cloud

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.
NOTE
This page contains links to the hybris website. For certain pages you will need an account to login.

Deploying eCommerce with SAP Commerce Cloud 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 will provide 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 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
  • Supports up to hybris 6.4 with OCC version 2.
  • You will need Java 7 to run the hybris 5 server.
  • The hybris add-on, the Telco Accelerator, is not supported by the AEM extension.

Packages Needed for eCommerce with hybris 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 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. Setup 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 download-and-build-your-hybris-server

The steps in this procedure will download and build the hybris server. It will also make the initial configurations required for the connections between hybris and cq. The extension will then be usable with the default settings.

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

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

    note caution
    CAUTION
    You will 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:

    code language-shell 
    cd <hybris-root-directory>/bin/platform
. ./setantenv.sh
ant clean all
cd ../..
    note note
    NOTE
    When executing:
    ant clean all
    Press Return when required.

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

    code language-none 
        <hybris-root-directory>

    Get File

    note note
    NOTE
    For hybris 5.6.0 and later, please 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
    code language-shell 
    groovy setup.groovy
cd bin/platform
ant clean all
sh hybrisserver.sh
    note note
    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 will delete existing data).

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

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

Setup the Geometrixx Outdoors Store setup-the-geometrixx-outdoors-store

This procedure will upload and configure the demonstration store - Geometrixx Online.

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

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

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

    http://localhost:9002/hmc/hybris

  3. From the sidebar navigation, expland 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 will show 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, please 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 will show 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

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56