Configuring the Activity Engine

Fastpath: Admin Console: System > Settings > Activity Engine

To configure the Activity Engine, you will first install the Jive package on the Activity Engine node as described in Installing the Linux Package. You can then configure the settings that control Jive's connection to the Activity Engine's core processes on the Admin Console: System > Settings > Activity Enginepage.

You can also use this page to troubleshoot when the What Matters streams are not working properly. For troubleshooting tips, see Troubleshooting the Activity stream and Inbox.

Properties of the json Configuration File

The core.json configuration file is located in the service configuration directory specified at runtime, typically /usr/local/jive/services/eae-service/etc.

Property Purpose Default Value
coreAddress Address of the Activity Engine server. localhost
corePort Port of the Activity Engine server. 7020

coreMinWorkerThreads

Minimum number of threads to listen for incoming socket connections from the Jive web application. 4
coreMaxWorkerThreads Maximum number of threads to listen for incoming socket connections from the Jive web application. 2048
user-recency-enabled Controls whether or not only active users will have their streams populated. true
user-recency-timeout The age in milliseconds after which a user will be considered inactive. 2592000000 (30 days)
user-recency-buffer Update user recency time no more than once in this time period in milliseconds. 86400000 (1 day)
user-recency-rebuild-length When rebuilding streams for an inactive user who has become active, look back no longer than this in milliseconds. 2592000000 (30 days)
remove-old-entries-time-after-midnight When to allow the tasks that remove old items from the stream to run (after midnight, in milliseconds). For example, a value of 7200000 will allow the tasks after 2 a.m. If you want the tasks to run on a set interval (not just during a time window), set this to 0 and set remove-old-entries-buffer to 24 hours (in milliseconds = 86400000). 7200000
remove-old-entries-period The window in milliseconds following remove-old-entries-time-after-midnight in which the old item deletion tasks will run, OR how often to run the tasks in milliseconds if remove-old-entries-buffer is set to 24 hours. For example, the default values will allow the tasks to run once between 2 a.m. and 3 a.m. 3600000
remove-old-entries-buffer Extra buffer time to allow the old item deletion tasks sufficient time to run. If you want the tasks to run on a set interval (not just during a time window) set this to 24 hours (in milliseconds = 86400000) and set remove-old-entries-time-after-midnight to 0, then set remove-old-entries-period to the desired interval. 600000
log-monitor-directory The path (absolute or relative to service configuration directory) where performance monitoring logs are saved. var/monitoring
log-monitor-period The frequency in milliseconds that samples are written to the monitoring logs. 15000 (15 seconds)
pathToQueues The path (absolute or relative to service configuration directory) where queue data is saved. var/data/

Deploying Multiple Activity Engines

You can deploy multiple Activity Engine cores if a single Activity Engine core will not be enough to handle your volume of traffic. Do this by setting up the new Activity Engine core with the same settings as the first Activity Engine core, and adding the new address to the Activity Engine configuration in the Admin Console.

Queue Depth Settings

The queue depths displayed on the Activity Engine page of the Admin Console show the number of items awaiting processing by the Activity Engine node. When an activity is sent to the Activity Engine, the activity is queued and processed as quickly as possible. Each queue, or group of queues, serves a specific purpose:

Expiration Settings

The expiration settings control the number of days an activity remains in a given stream.
CAUTION:
Do not adjust these settings without guidance from Jive Support. Doing so can lead to serious performance problems or data loss.