Hybris recipe Installation in Windows and Mac

Step 1 : Download the latest hybris commerce suite using the below link,                                      
              https://wiki.hybris.com/display/downloads/Download

Step 2 : Create a directory and unzip your hybris commerce suite directly. (as the zip file already contains a hybris directory).

While creating the directory we need to follow few rules,

• Don’t use directory paths containing spaces.  Building SAP hybris commerce fails if you use spaces.
• The directory must be close to system root directory and should not exceed more than 255 characters.

For example you can place it inside C:\ hybris

Step 3 : Unzip the suite in to the created directory . After completing the extraction, the choosen directory structure should look as shown below,

Step 4 : Now go to hybris installation folder and navigate to install directory. 

For example,  C:\hybris\install.

• On Microsoft Windows systems, install the b2c recipe using a command "install -r b2c_acc_plus"

• On Unix-based systems (like Mac OS X or Linux) use command "./install.sh -r b2c_acc_plus"

This will auto create the config and other folders under hybris directory inside the hybris installation folder.

Please note it will also auto generate the localextensions.xml file under config directory.

Step 5 :  Now navigate to Hybris Installion directory > hybris > bin > platform and set up the ant enviroment. 

      For Windows use command "setantenv.bat"

For Mac / Linux use command ". ./setantenv.sh"

This will set up ant environment.

Step 6 : Now perform a clean build using the command,

> ant clean all

Once the build is finished you should successful build message as shown below.

server:

     [echo]

     [echo] Configuring server at C:\hybris\bin\platform/tomcat-6

     [echo] Using config set at C:\hybris\config/tomcat

     [echo]

    [mkdir] Created dir: C:\hybris\log\tomcat

    [mkdir] Created dir: C:\hybris\data\media

     [copy] Copying 8 files to C:\hybris\bin\platform\tomcat-6

     [copy] Copying 6 files to C:\hybris\bin\platform\tomcat-6

     [copy] Copying 1 file to C:\hybris\bin\platform\tomcat-6\lib

     [echo]

     [echo] Embedded server does not seem to be running (no PID found). 

            No restart necessary.

     [echo]

all:

     [echo] Build finished on 26-March-2013 11:23:33.

     [echo]

BUILD SUCCESSFUL

Total time: 3 minutes 15 seconds

C:\hybris\bin\platform>

§       After  the build is successful the hybris folder structure should look like this,

Note : All the configuration files of SAP hybris commerce are placed inside config directory.

Step 6 : Now start the hybris server.

For windows use command "hybrisserver.bat"
For Mac/linux use command "./hybrisserver.sh"

Once you see the below message you can confirm that your hybris server has been started.

      INFO: Server startup in 143608 ms

  

a  Step 7 : Test if you are able to access the hybris server by using the following request in your browser,

   http://localhost:9001

d  If you are able to see the below hybris admin console,

   

Congos you have succesfully setup hybris on your local system !!

Accessing the storefront and Setting up the workspace

Accessing the storefront

•  After initialization is done you can open hmc using http://localhost:9001/hmc 
•  Navigate hmc > wcms > websites > administration properties  and get the site url.
•  Try to access the storefront using the site url

  Setting up the workspace in IDE

• Open the STS / Eclipse and Navigate to file > import > select your hybris installation folder > select hybris directory.
• Import all the storefront extensions and some other basic extensions which you need in your workspace.
• Navigate to windows > preferences > change the ant environment and set it to hybris > bin > platform > ant
• Establish the dependencies between all the extensions manually, by navigating to all the extension properties.

Starting the Hybris server and Initializing the system

• Once the build is successful you can start the hybris server. Navigate to <${HYBRIS_BIN_DIR}> / platform directory.

On Windows systems, call the hybrisserver.bat file.

On Unix systems, call the hybrisserver.sh file, such as: ./hybrisserver.sh

This will start the hybris server and once the server is started you see a log message as shown below,

INFO: Server startup in 26438 ms

•      Open the administration console by using this url, http://localhost:9001/hac.

•       You are prompted to enter a user account name and a password. By factory default, you can use the admin user account and the nimda password as shown below,

• Go to the Platform tab and select the Initialization option as shown below,

• The Initialization page opens with preconfigured settings for initialization.
• Without changing any settings, click the Initialize button. Bear in mind that the initialization process may take up to an hour to finish.
• When the initialization process is completed, you should see the following information.

• Click the Continue link and log in again.

Note : If your browser fails to display the above information at the end of the initialization process, look at the console output.

• If you see the following output,

it means that the initialization has finished and you can refresh your browser and log in to the console.

Installing SAP Hybris commerce on your local system

Step 1 : Download the latest hybris commerce suite using the below link,                                        
              https://wiki.hybris.com/display/downloads/Download

Step 2 : Create a directory and unzip your hybris commerce suite directly. (as the zip file already contains a hybris directory).

While creating the directory we need to follow few rules,

• Don’t use directory paths containing spaces.  Building SAP hybris commerce fails if you use spaces.
• The directory must be close to system root directory and should not exceed more than 255 characters.

For example you can place it inside C:\ hybris

Step 3 : Unzip the suite in to the created directory . After completing the extraction, the choosen directory structure should look as shown below,

Step 4 : Open command prompt and navigate to <${HYBRIS_BIN_DIR}>  ( i.,e Your hybris installation folder > Hybris > bin)  directory and navigate to platform directory. 

For example,  C:\hybris\bin\platform.

• On Microsoft Windows systems, run the setantenv.bat file by entering setantenv.bat.

• On Unix-based systems (like Mac OS X or Linux), run setantenv.sh by entering . ./setantenv.sh

Step 5 :  Now perform ant clean all. This prompts you to select a configuration template for our operation environment as shown below,

Buildfile: C:\hybris\bin\platform\build.xml

     [echo]

    [mkdir] Created dir: C:\hybris\log

    [mkdir] Created dir: C:\hybris\data

    [mkdir] Created dir: C:\hybris\temp\hybris

    [input]

    [input]  **** NO CONFIG FOLDER FOUND **** use the jar utility to

             unzip the zip file on unix based systems, as this will change the 

             timestamps of the contained files and break the build process.

Buildfile: C:\hybris\bin\platform\build.xml

     [echo]

    [mkdir] Created dir: C:\hybris\log

    [mkdir] Created dir: C:\hybris\data

    [mkdir] Created dir: C:\hybris\temp\hybris

    [input]

    [input]

    [input]  No config folder was found at C:\hybris-4.5\hybris\config.

    [input]  A "fresh" folder containing basic configuration files 

             and the hybris

    [input]  demo licence will be created for your convenience.

    [input]  Please adjust and review the configuration files (and license) and

    [input]  call 'ant' again. This directory will never be overridden or

    [input]  touched again. Always use this configuration folder 

             for configuration

    [input]  of platform, do not change anything within the platform folder.

    [input]

    [input]  Please choose the configuration template.

    [input]  Press [Enter]

    [input to use the default value ([develop], production)

We should select the default value develop, by pressing enter.

§       This will generate folders like config, data, log and data and places them in hybris bin directory.

server:

     [echo]

     [echo] Configuring server at C:\hybris\bin\platform/tomcat-6

     [echo] Using config set at C:\hybris\config/tomcat

     [echo]

    [mkdir] Created dir: C:\hybris\log\tomcat

    [mkdir] Created dir: C:\hybris\data\media

     [copy] Copying 8 files to C:\hybris\bin\platform\tomcat-6

     [copy] Copying 6 files to C:\hybris\bin\platform\tomcat-6

     [copy] Copying 1 file to C:\hybris\bin\platform\tomcat-6\lib

     [echo]

     [echo] Embedded server does not seem to be running (no PID found). 

            No restart necessary.

     [echo]

all:

     [echo] Build finished on 26-March-2013 11:23:33.

     [echo]

BUILD SUCCESSFUL

Total time: 3 minutes 15 seconds

C:\hybris\bin\platform>

§       After  the build is successful the hybris folder structure should look like this,

Note : All the configuration files of SAP hybris commerce are placed inside config directory.

Step 6 : Configure all the required extensions. Navigate to Your hybris installation directory > hybris > config and open localextensions.xml and make the following configuration,

    <hybrisconfigxmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'        xsi:noNamespaceSchemaLocation='../bin/platform/resources/schemas/extensions.xsd'>

 

   <extensions>

    <path dir='${HYBRIS_BIN_DIR}' autoload='false' />

    <extension name='ordermanagementaddon' />

    <extension name='orderselfserviceaddon' />

    <extension name='ordermanagementfacade' />

    <extension name='ordermanagementwebservices' />

    <extension name='warehousing' />

    <extension name='warehousingbackoffice' />

    <extension name='warehousingfacade' />

    <extension name='warehousingwebservices' />

    <extension name='instore' />

    <extension name='mcc' />

    <extension name='backoffice' />

    <extension name='commercesearchbackoffice' />

    <extension name='commerceservicesbackoffice' />

    <extension name='solrfacetsearchbackoffice' />

    <extension name='solrserver' />

    <extension name='yacceleratorcockpits' />

    <extension name='yacceleratorinitialdata' />

    <extension name='yacceleratorordermanagement' />

    <extension name='yacceleratorstorefront' />

    <extension name='yaddon' />

    <extension name='ycommercewebservices' />

    <extension name='electronicsstore' />

    <extension name='apparelstore' />

    <extension name='acceleratorwebservicesaddon' />

    <extension name='customersupportbackoffice' />

    <extension name='customerticketingaddon' />

    <extension name='ticketsystembackoffice' />

    <extension name='rulebuilderbackoffice' />

    <extension name='couponbackoffice' />

    <extension name='droolsruleengineservices' />

    <extension name='couponfacades' />

    <extension name='promotionenginesamplesaddon' />

<extension name='ordermanagementtestaddon'/>

<extension name='hmc' />

   </extensions>

  </hybrisconfig>
  
    Now perform ant clean all again and make sure the build is success.

What is Omni Channel in hybris ?

Providing a seamless shopping experience to customers across multiple channels.

Technically, this is achieved by maintaining data integration across all the channels.

Did SAP acquire Hybris ?

Yes, SAP AG has acquired Hybris on August 1, 2013.

About Hybris Company

Hybris is a E-commerce technology company founded in Zug, Switzerland in 1997.

Now it moved its headquarters to Munich, Germany.