RE-ENTER SAS
Voyez le cloud autrement

Installing Oracle Commerce (ATG) 11.1 on a development machine

by Vina Rakotondrainibe | Oracle Commerce Expert and Cloud Deployment Specialist
Paris area,

Hi, I decided to write this article because I have had hard times understanding and finding the steps to install ATG11.1 with the Commerce Reference Store (CRS). Now it is official, CRS is using Experience Manager extensively. You can no longer display the front home page without calling the search engine. But as usual, Oracle did not really merge the two documentations and you have to sneak around to put all pieces together.

The official way to bootstrap your installation is to use CIM (the well known ATG installation and configuration tool) so I will use it but I won't put the installation log here. Instead I will point you to the official documentation with comments on the specific values you should enter. I assume you already know ATG and JAVA/J2EE basics (e.g. DYNAMO_ROOT, JDBC URLs etc...). I also assume you are familiar with ATG and the typical development architecture in both development and production mode. If not, please take time to read the Installation document.

Pre-requisites

In order to get Oracle Web Commerce and Guided Search installers, you need to go to Oracle e-delivery portal with a valid Oracle account.

Note: You might need to ask Oracle Support to validate your account in order to download the installers.

You need to download the following packages for ATG:

  • Oracle Commerce Platform 11.1
  • Oracle Commerce Reference Store 11.1

You need the following packages for Oracle Guided Search:

  • Oracle Commerce MDEX Engine 6.5.1 for Linux
  • Oracle Commerce Guided Search Platform Services 11.1 for Linux
  • Oracle Commerce Experience Manager Tools and Frameworks 11.1 for Linux
  • Oracle Commerce Content Acquisition System 11.1 for Linux

I assume you already have installed the following:

  • Oracle JDK 7
  • Tomcat 7 or JBOSS AS 7 or JBOSS EAP 6.1

Endeca Instalation

In this part, we assume that you have unziped the installers downloaded from Oracle.

  • Install MDEX

./OCmdex6.5.1-Linux64_829811.sh --target /opt/data/applications

Note: Do not include the endeca folder in the target path as the installer will create it automatically for all products

  • Install the platform services

./OCplatformservices11.1.0-Linux64.bin

You will be prompted to enter several ports, just choose the default ones (you need to retype them):

Please enter the port number of the Oracle Commerce Guided Search HTTP Service.
The typical default is 8888.
       : 8888

  • Install the WorkBench (Tools and Framework). There is a silent install script in the installer package you downloaded.

./silent_install.sh `pwd`/silent_response.rsp ToolsAndFrameworks_1 /opt/data/applications/endeca admin

Note: I cover silent installation here

  • Install Endeca Content Acquisition System (CAS)

./OCcas11.1.0-Linux64.sh --target /opt/data/appliactions --endeca_tools_root /opt/data/applications/endeca/ToolsAndFrameworks_1/11.1.0 --endeca_tools_conf /opt/data/applications/endeca/ToolsAndFrameworks_1/11.1.0/server/workspace

Shell environment settings

As a general rule, I use env files to set my environment variables. They are named with the following pattern:

/etc/env/product name,product version

Here is the content of my /etc/env/atg11.1file:

DYNAMO_ROOT=/opt/data/applications/ATG/ATG11.1
DYNAMO_HOME=${DYNAMO_ROOT}/home

Here is the content of my /etc/env/endeca11.1 file:

#!/bin/bash
source /opt/data/applications/endeca/PlatformServices/workspace/setup/installer_sh.ini
source /opt/data/applications/endeca/MDEX/6.5.1/mdex_setup_sh.ini
export ENDECA_TOOLS_ROOT="/opt/data/applications/endeca/ToolsAndFrameworks_1/11.1.0"
export ENDECA_TOOLS_CONF="/opt/data/applications/endeca/ToolsAndFrameworks_1/11.1.0/server/workspace"

ATG installation

I assume you are familiar with ATG installation process on an Unix machine. It is not complicated really, the installer is just prompting you for the ATG root installation folder (which is equal to /opt/data/applications/ATG/ATG11.1 in my case).

Here are the official links for ATG 11.1:

ATG initialization

You need to use CIM to initialize ATG. To launch it, issue the following commands:

. /etc/env/atg11.1
cd ${DYNAMO_HOME}
./cim.sh

I will not cover all CIM installation, you can find the official documentation here: CRS CIM installation

Initialize the indexes

In the rest of this thread, ${ENDECA_FOLDER} stands for the endeca folder where all Endeca components are installed (e.g. /opt/data/applications/endeca in my case).

You need to initialize CRS services in Guided Search first:

cd ${ENDECA_FOLDER}/Apps/CRS/control
./initialize_services.sh --force

In order to baseline the Endeca indexes, connect on the ATG dyn/admin console and go to http://localhost:8080/dyn/admin/nucleus/atg/commerce/endeca/index/ProductCatalogSimpleIndexingAdmin/ and baseline index by hiting the Baseline index button.

The above dyn/admin page should autorefresh during the baseline process. When everyting is in COMPLETE stats, you can promote content by using the promote_content.sh provided in the EAC CRS application (the ATG instance needs to remain started):

cd ${ENDECA_FOLDER}/Apps/CRS/control
./promote_content.sh

In the /atg/endeca/assembler/cartridge/manager/DefaultFileStoreFactory service, make sure you point to the shared application_export_archive directory (this is normally correctly generated by CIM but I had a wrong value in mine due to my ignorance on CIM first run):

configurationPath=/opt/data/applications/endeca/Apps/CRS/data/workbench/application_export_archive/CRS

Check the store at http://localhost:8080/crs

Note: If you did not do a full deploy from Content Administration / Merch UI, you will need to start the CRS's NoPublishing submodule in order to avoid an error on the homepage slot.

The hardest is yet to come... good luck :-)

Top