Configure BigMemory Servers for Business Analytics Caching and In-Memory Stores

Appendix : Administration : Business Analytics Server Configuration : BigMemory for Caching, Connections and MashZone NextGen Analytics : Configure BigMemory Servers for Business Analytics Caching and In-Memory Stores

You can configure Business Analytics to work with one or an array of BigMemory Servers to provide additional memory, provide reliability and support specific other features. See BigMemory for Caching, Connections and MashZone NextGen Analytics for more information on features that require BigMemory servers.

To configure BigMemory Servers for Business Analytics

1. Copy your license for BigMemory to Business Analytics and update Business Analytics startup scripts:

a. Copy the license file terracotta.key to the MashZoneNG-install/apache-tomee-jaxrs/conf folder.

Note:

If Business Analytics is deployed in a cluster, you must copy this file to every cluster member.

b. Add this Java system property to the Business Analytics startup script :

-Dcom.tc.productkey.path=MashZoneNG-install/apache-tomee-jaxrs/conf/terracotta.key

Add this property to either:

MashZoneNG-install/apache-tomee-jaxrs/bin/setenv.bat file for Windows systems, or

MashZoneNG-install/apache-tomee-jaxrs/bin/setenv.sh file for Linux, OS/X or UNIX systems.

Note:

If Business Analytics is deployed in a cluster, you must update the startup scripts for every cluster member.

2. Edit the ehcache.xml file for Business Analytics in a text editor of your choice. The location depends on your deployed environment:

Only One Business Analytics Server	MashZoneNG-install/apache-tomee-jaxrs/webapps/mashzone/WEB-INF/classes/ehcache.xml
A Business Analytics Cluster and Shared External Configuration Folder	MashZoneNG-config/ehcache.xml For more information in a clustered environment, see Setting Up an External Business Analytics Configuration Folder.
A Business Analytics Cluster With No Shared Configuration	You must update MashZoneNG-install/apache-tomee-jaxrs/webapps/mashzone/WEB-INF/classes/ehcache.xml for each cluster member.

3. Find the line in ehcache.xml with <terracottaConfig> that is commented out like this:

Remove the comment markers and change the url attribute to the host (or IP address) and port for the BigMemory server(s) you installed. For example:

Note:

There are several ways to identify one or more BigMemory servers for Business Analytics. See BigMemory documentation for more information.

4. Find the line in ehcache.xml with <terracotta> that is commented out and uncomment this line for each of the following named <cache> elements:

RAQL_DATA_CACHE = the MashZone NextGen Analytics In-Memory Stores

SEARCH_RESULTS_CACHE = one part of the Business Analytics Artifact cache.

SERVICES_BY_ID_CACHE = = one part of the Business Analytics Artifact cache.

SERVICE_RESPONSE_CACHE = the Business Analytics Response cache for mashables and mashups. This is optional. Update this cache only if you want it to be distributed.

This <terracotta> element allows the In-Memory Store and Business Analytics caches to use heap and off-heap memory in both the local host and BigMemory hosts. This combined memory is managed by BigMemory.

For more information on the <terracotta> element, see Distributed Configuration topics in BigMemory documentation.

5. Save these changes to ehcache.xml.

Important:

For clusters where this configuration file is not stored in a shared external folder, copy this file to the same location for each Business Analytics cluster member.

6. Optionally, update configuration for dynamic In-Memory Stores that MashZone NextGen Analytics creates to work with BigMemory servers:

a. Edit the dynamiccache.xml file in these locations (based on your deployed environment):

Only One Business Analytics Server	MashZoneNG-install/apache-tomee-jaxrs/webapps/mashzone/WEB-INF/classes/dynamiccache.xml
A Business Analytics Cluster and Shared External Configuration Folder	MashZoneNG-config/dynamiccache.xml For more information in a clustered environment, see Setting Up an External Business Analytics Configuration Folder.
A Business Analytics Cluster With No Shared Configuration	You must update MashZoneNG-install/apache-tomee-jaxrs/webapps/mashzone/WEB-INF/classes/dynamiccache.xml for each cluster member.

b. Add a <terracotta> element inside the <cache> element.

c. Provide URLs or other connection information as needed.

For more information on configuration for the <terracotta> element, see BigMemory documentation.

d. Save your changes.

7. Optionally, update configuration for any declared In-Memory Stores to work with these BigMemory server(s):

a. In the configuration files for your declared In-Memory Stores, add a <terracotta> element inside the corresponding <cache> element.

b. Provide URLs or other connection information as needed.

For more information on the <terracotta> element, see BigMemory documentation.

c. Save changes to these files.

d. Upload these configuration changes. See Modify a Declared In-Memory Store for instructions.

8. Start BigMemory Server(s).

9. If needed, adjust memory configuration for the local Business Analytics host. See Memory Configuration for the Business Analytics Server for instructions.

10. Restart Business Analytics. See Start and Stop the Business Analytics Server for instructions.

Contact Support | Community | Feedback