This appendix provides instructions for creating the EAC application that supports Commerce Reference Store using scripts instead of CIM. If the Oracle Commerce Platform and Oracle Commerce Guided Search with Experience Manager are installed on different servers, you must create and provision the EAC application using the scripts described below. After creating the EAC application, return to the Assembling and Deploying Your Oracle Commerce Applications section earlier in this guide to finish configuring your environment.
To create the EAC application:
On the machine where Oracle Commerce Guided Search with Experience Manager is installed, create the directory where the EAC application will reside, for example,
/usr/local/endeca/Apps
orC:\Endeca\Apps
.Copy the
<ATG11dir>/CommerceReferenceStore/Store/Storefront/deploy
directory to a temporary location on the machine where Oracle Commerce Guided Search with Experience Manager is installed.On the machine where Oracle Commerce Guided Search with Experience Manager is installed, open a UNIX shell or command prompt and browse to the ToolsAndFrameworks
/deployment_template/bin
directory, for example,/usr/local/endeca/ToolsAndFrameworks/11.1.0/deployment_template/bin
orC:\Endeca\ToolsAndFrameworks\11.1.0\deployment_template\bin
.Execute the
deploy
script. For example, on UNIX, enter:./deploy.sh --app
CRS-t
emporary-directory
/deploy/deploy.xml
On Windows, enter:
deploy.bat --app
CRS-t
emporary-directory
\deploy\deploy.xml
After the note about the Platform Services version, press Enter to continue with the install.
Enter the following information for the script prompts:
Enter
N
to install a base deployment.Enter
CRS
for the name of the application.Enter the full path to the
Apps
directory, for example:/usr/local/endeca/Apps
orC:\Endeca\Apps
.Enter the EAC port (default is 8888).
Note: The EAC port is used for all Endeca applications that have been deployed, so if you deploy more than one application, continue to use the same port number for all of them.
Workbench port number [8006]
Dgraph1 (Live Dgraph) port (default is 15000).
Authoring Dgraph port (default is 15002)
LogServer port (default is 15010)
Enter the CAS install directory using UNIX-style forward slashes, even if on Windows. For example, /
usr/local/endeca/CAS/11.1.0
orC:/Endeca/CAS/11.1.0
.Enter the CAS version number (default is
11.1.0
).Enter the CAS hostname (default is
localhost
).Enter the CAS port (default is 8500).
Enter the language code (default is
en
).Enter the fully-qualified Workbench hostname.
Production application server host name. This is the host where the
ATGProduction
server will be running. [localhost]Production application server HTTP port number. IMPORTANT: If you are following the instructions in this guide, these values are 7003 for WebLogic, 8080 for JBoss and Tomcat, and 9081 for WebSphere.
Preview host name [localhost]. For this installation, use the
ATGProduction
server’s host name.Preview port number. For this installation, use the
ATGProduction
server’s HTTP port. IMPORTANT: If you are following the instructions in this guide, these values are 7003 for WebLogic, 8080 for JBoss and Tomcat, and 9081 for WebSphere.IMPORTANT: The proper way to configure Experience Manager preview is to have it reference a staging server. Because the configuration documented in this guide does not include a staging server, you should use the
ATGProduction
server’s host and port instead. However, please note that, with this configuration, Experience Manager Preview will be referencing the live production server and changes made in Experience Manager will not be reflected in Preview until after they are promoted to the live production server using thepromote_content.sh|bat
script.Context root of the preview application [crs]
Host name of the user segment server. This is the server that will respond to Experience Manager requests for Business Control Center user segment data. Oracle recommends using the Content Adminstration server (also called the
ATGPublishing
server in this guide). [localhost]HTTP port of the user segment server. IMPORTANT: If you are following the instructions in this guide, these values are 7103 for WebLogic, 8180 for JBoss and Tomcat, and 9181 for WebSphere.
Path for the Oracle Wallet
jps-config.xml
file, for example,/usr/local/endeca/ToolsAndFrameworks/11.1.0/server/workspace/credential_store/jps-config.xml
orC:\Endeca\ToolsAndFrameworks\11.1.0\server\workspace\credential_store\jps-config.xml
Application configuration archive path. This is the location where content promoted using the file-based method is stored, for example,
/usr/local/endeca/Apps/CRS/data/workbench/application_export_archive
orC:/Endeca/Apps/CRS/data/workbench/application_export_archive
. IMPORTANT: If you have a split install, where Oracle Commerce Guided Search with Experience Manager and the Oracle Commerce Platform are installed on different machines, you must specify the shared directory you created in the Creating a Shared Archive Directory section, for example,/usr/local/application_export_archive
orC:\application_export_archive
.
You see a message that says “Application successfully deployed” when the deployment is finished.
In a UNIX shell or command prompt, change directories to the EAC applications directory, for example,
/usr/local/endeca/Apps
orC:\endeca\Apps
. TheCRS
application directory is added as child of the/Apps
directory.
Commerce Reference Store only requires one EAC application, so at this point you can move onto provisioning the application, described below. Other environments may require additional EAC applications (see the Platform-Guided Search Integration Guide for guidance). If so, you should create additional EAC applications for any other Oracle Commerce Platform server instances which you intend to index against, for example, Staging and Publishing servers. Be sure to enter unique ports for Live Dgraph, Authoring Dgraph, and LogServer for each additional application.
To provision the EAC application:
In a UNIX shell or command prompt, change directories to your EAC application’s
/control
directory, for example,/usr/local/endeca/Apps/CRS/control
orC:\Endeca\Apps\CRS\control
.Execute the
initialize_services.sh
script. For example, on UNIX, enter:./initialize_services.sh
On Windows, enter:
initialize_services.bat
Return to the Assembling and Deploying Your Oracle Commerce Applications section earlier in this guide to finish configuring your environment. (Note: If your environment has multiple EAC applications, repeat these steps for any other EAC applications you created.)