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 page.
You can also use this page to troubleshoot when the What Matters streams are not working properly. For troubleshooting tips, see Troubleshooting the Activity and Communications Stream.
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/ |
As of Jive version 5.0.1, 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.
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: