This section describes how to configure Oracle WebCenter Sites: Insights, including its supporting software — Kafka, HBase, and Endeca. Insights runtime consists of an Insights web application (WAR file) and a config
directory shared across cluster members.
The following topics provide details about the supporting software and how to configure Insights:
Oracle WebCenter Sites: Insights relies on supporting software components, which you need to install and configure before Insights.
Before you deployInsights, install and configure the following software:
Apache Kafka 0.8.2.1 (with Zookeeper) — the messaging queue (data buffer) service for Insights
Raw data collected by Insights is put into the Kafka message queue. Insights then pulls raw data from the queue; enriches it with visitor metadata like country, browser, and operating system; and writes it to the enriched data queue. Finally, Insights pulls the enriched data and writes it to HBase for permanent storage.
HBase 0.98.6-hadoop2 or CDH 5.2.0 (with Zookeeper) — the data store for enriched Insights data
Oracle Endeca Server 7.6
(Optional) Oracle Endeca Information Discovery 3.1(with Zookeeper) — the report generation tool.
A data loader configured within Insights pulls specific ranges of data from HBase and loads them into Endeca to generate reports.
Zookeeper – a standalone instance that Insights can use for managing properties
Note:
Kafka, Endeca, and HBase are third-party products not distributed as part of Insights. You must obtain them from their respective vendors. Do not run any combination of Kafka, Endeca, and HBase on the same server because their zookeeper ports would conflict with one another. Run each service on a separate server instance (recommended) or change the zookeeper ports (not recommended).You can configure Insights for your environment and test your configuration.
Install and configure Apache Kafka 0.8.2.1 and HBase 0.98.6-hadoop2.
Install and configure at least one fully functional instance of WebCenter Sites.
In the WebCenter Sites domain, configure the Insights Managed Servers, using the WebLogic Configuration Wizard and the “Oracle WebCenter Sites — Insights — 12.2.1.0.0” template, as Configuring the WebCenter Sites Domain describes.
For Insights, the product home directory is ORACLE_HOME/wcsites/insights
(WCS_INSIGHTS_HOME
), and the configuration directory is DOMAIN_HOME/wcsites/insights/config
(WCS_INSIGHTS_CONFIG
).
If you have not already done so for the WebCenter Sites domain, grant read, write, and delete permissions for accessing the Oracle Platform Security Services credential store to ORACLE_HOME/wcsites/wcsites_common/lib/sites-security.jar
by executing the following script:
On UNIX operating systems:
DOMAIN_HOME/wcsites/bin/grant-opss-permission.sh
On Windows operating systems:
DOMAIN_HOME\wcsites\bin\grant-opss-permission.bat
Use the WebLogic Server Administrator user name and password, when prompted by the script.
Install and configure third-party supporting software for Insights, which Software Components Required by Insights describes.
Note:
Only users with theanalytics
role can access reports and other Insights-related configuration. Reports get data from Endeca, so if you can’t see your reports, make sure you have a loader configured for your site. A loader can be scheduled to load data from Hbase periodically or all at once. For more information, see Configuring the Data Loader in Administering Oracle WebCenter Sites.For more information about configuring Insights, see Developing Insights in Developing with Oracle WebCenter Sites.
Note:
Because changes you make to a WAR file are not retained during redeployment, WAR file changes need to be copied over after each redeployment of the web applications. It is generally recommended to deploy the static artifacts such as images and stylesheet files onto the web server.