You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Registry Job Shell is a command line utility for running various scheduled tasks. It is primarily intended to be run via Cron, though it can also be run manually.

(info) Prior to v2.0.0, JobShell was known as CronShell.

Installation and Running

For installation instruction via cron, see Registry Installation - Cron.

To run JobShell manually, the usage is

JobShell Usage
$ cd ${REGISTRY_SRC}/app
$ su -c "./Console/cake job ${ARGS}" ${APACHE_USER}

(warning) After running JobShell, it may be necessary to manually clear or change ownership on cache files, especially if the command is not run as the Apache user.

Arguments

Usage: job [-hqv] [-c coid] [task] [task...]

Where:

  • c: Numeric CO ID to process tasks for (default: All COs) (--coid)
  • h: Display help (--help)
  • q: Quiet mode, suppress most output (--quiet)
  • v: Verbose mode, enable additional output (--verbose)
  • task: Task or tasks to run (default: All available tasks)

(warning) JobShell is designed to provide minimal command line output, with actions instead recorded in Registry Job History.

Tasks

The following tasks are supported by Job Shell:

  • expirations: Run Expiration Policies
    • In most cases, it makes sense to run expirations once per day, as this task is primarily useful for expirations driven by calendar dates. However, if your deployment includes business processes that manually manage criteria for expiration (eg: expiration driven by moving a record to a different COU) you may wish to run expirations more frequently.
  • forcesyncorgsources: Sync Organizational Identity Sources
  • groupvalidity: Reprovision records to due Group Validity
    • When a CO Group Member valid from or valid through date takes effect, this task is used to reprovision affected records. When executed, the task will reprovision any record associated with a CO Group Membership whose valid from or valid through date is within the last x minutes, where x is set via the CO Setting Group Validity Sync Window. The default value for this setting is 1440 minutes (or 1 day), and so typically it would make sense to run this task once per day, perhaps just after midnight. However, it may make sense to run this task more frequently, depending on how your deployment uses these dates.
  • syncorgsources: Sync Organizational Identity Sources

Monitoring

Job status maybe monitored via the web interface by CO Administrators, via the Jobs menu item. An in progress job may be canceled via the Job details view.

(warning) Expirations do not currently support monitoring. (CO-1385)

  • No labels