Skip to end of metadata
Go to start of metadata

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:
  • 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:

      ################################
      ## Other jobs
      ##
      ## Configure other jobs.
      ## "jobName" is the name of your job.
      ## Class must implement org.quartz.Job.
      ## Priority is optional
      ################################
      
      # otherJob.jobName.class =
      # otherJob.jobName.quartzCron =
      # otherJob.jobName.priority =
      
  • 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:

gsh -loader

Starting in Unix:

nohup gsh -loader &

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

See Also

For Grouper Daemon configuration options, see the Daemon section of the Grouper API page.
For info on pruning Daemon logs, see Ongoing Maintenance Tasks

  • No labels