The Grouper Daemon is a process that can handle many tasks. In Grouper v2.4+, all daemon jobs are visible in the Grouper UI.
- Grouper daemon has a component called Grouper Loader that can automatically provision Grouper memberships from external SQL sources
- Grouper daemon is a Java Quartz standalone command line application, launched from GSH: gsh -loader
- This daemon is required for all deployments, even if you are not using it to provision Grouper memberships from external SQL sources
- There is a daemon to:
- Disable expired memberships or to enable memberships which are enabled in the future
- Delete old audit and notification logs (configured in grouper-loader.properties)
- Massage the notification logs so they have a sequential index number
- Validate Grouper Rules and mark invalid ones as invalid. (v2.0)
- Notification consumers (callbacks) can be registered as a daemon. Grouper will keep track of which change log number they have successfully processed so the daemons can maintain state across Grouper Loader restarts
- The Grouper Loader keeps database logs in the grouper_loader_log table. These are periodically cleaned out based on configuration
- There is a daily report that can be emailed out to Grouper admin which details the state of the registry and the status of all daemon jobs from the last day
- The PSP changelog provisioning can be enabled as a daemon process (v2.1)
In v2.3+, the daemon is pre-configured to use a database to store job schedules instead of storing them locally in memory.
- By default, the Grouper database is used. These are the grouper_QZ_* tables.
- You can run the daemon on multiple machines and jobs will be spread among them all automatically. Be sure to keep your loader configuration (grouper-loader.properties) the same on all machines.
You can also use the daemon to schedule any custom jobs that you may have. To do so, add the following configuration in grouper-loader.properties:
- In Grouper v2.4+, all daemon jobs are visible in the Grouper UI. The screen below is linked from the "Miscellaneous" link in the Quick Links section.
You can also see their associated logs from the grouper_loader_log table by clicking on a job name.
Starting in v2.5+: run the Grouper container with the "deamon" argument or the appropriate env vars set (see v2.5 container documentation)
Starting (command line, not needed in v2.5):
Starting in Unix (command line, not needed in v2.5):
Stopping: find the process and kill it
See this document to have a unix service which controls the loader
Note: it is also possible to run the loader in another webapp if you like
The long-term roadmap is to have the ability to run the loader in a web services instance or UI instance
For Grouper v2.5+ see this page on Daemon configuration.
For Grouper Daemon configuration options, see the Daemon section of the Grouper API page.
For info on pruning Daemon logs, see Ongoing Maintenance Tasks