The Core Job Plugin provides several out-of-the-box jobs for use with the Registry Job Shell.


The Core Job Plugin replaces the Identifier Assignment Job Plugin and Provisioner Job Plugin.

Configuration

  1. This is a core plugin, and so is enabled by default.

General Usage

Core Jobs can be run via the command line either synchronously with -s, or asynchronously with -a. When run asynchronously, a Registry Job will be queued, and executed during the next execution of Registry Job Shell in run queue (-r) mode. Some jobs can also be scheduled to run asynchronously via the web interface, details of which are provided below.

Note that when CO ID is provided as a command line argument, it must be provided even if another argument implies a specific CO.

Available Jobs

Bulk

Perform bulk operations.

Usage (Web Interface)

A web interface to Bulk Job is not yet available. (CO-2088)

Usage (Command Line)

$ ./Console/cake job CoreJob.Bulk -s --coid co --action action --recordType recordType --records records [--actionArgs args]

(info) Keep in mind operating system limits on command line arguments may constrain the number of records that can be passed at a time. If these limits are reached, simply split the record set into multiple commands.

Supported Actions

ActionSupported Record TypesAction Specific Arguments
expungeCoPerson
updateStatusCoPerson, CoPersonRolestatus: New status (must use code as defined in Lib/enum.php)

Examples

$ ./Console/cake job CoreJob.Bulk -s -c 41 --action expunge --recordType CoPerson --records 2660,2661,2662
$ ./Console/cake job CoreJob.Bulk -s -c 41 --action updateStatus --actionArgs status=S --recordType CoPersonRole --records 1093,1218

Expire

Run Expiration Policies.

(info) Prior to Registry v4.0.0, this functionality was provided as a Registry Job Shell task.

Usage (Command Line)

$ ./Console/cake job CoreJob.Expire -s --coid co

GarbageCollector

Perform Garbage Collection.

(info) This job should be automatically scheduled, and should ordinarily not need to be manually scheduled.

Usage (Web Interface)

This Job can be scheduled via CO Settings >> Schedule Job if there is no currently scheduled Garbage Collector.

Usage (Command Line)

$ ./Console/cake job CoreJob.GarbageCollector -s --coid co [--object_type type]

IdAssign

Run Identifier Assignment.

(info) In Registry v3.3.x, this functionality was provided by the Identifier Assignment Job Plugin.

Usage (Web Interface)

This Job can be scheduled using the UI via COConfigurationIdentifier Assignments > Autogenerate Identifiers For All.

Usage (Command Line)

$ ./Console/cake job CoreJob.IdAssign -s --coid co [--object-type type [–-object_id id]]

Provision

Run Provisioning.

(info) In Registry v3.3.x, this functionality was provided by the Provisioner Job Plugin.

Usage (Web Interface)

This Job can be used to schedule bulk reprovisioning using the UI via CO Configuration > Provisioning Targets > Reprovision All.

This Job can be used to provide asynchronous provisioning by setting the Provisioning Target Mode appropriately.

Usage (Command Line)

$ ./Console/cake job CoreJob.Provision [-a|-s] --coid co –-co_provisioning_target_id ptid --record_type (CoEmailList|CoGroup|CoPerson|CoService|All) [–-record_id recid] [–-provisioning_action action]

Sync

Synchronize Org Identity Sources.

(info) Prior to Registry v4.0.0, this functionality was provided as a Registry Job Shell task.

(warning) When syncing all sources, sub-jobs will be started for each source. Canceling the parent job will prevent new jobs from starting, but will not stop the in-progress job.

Usage (Command Line)

$ ./Console/cake job CoreJob.Sync -s --coid co [--ois_id ois_id] [--force] [--source_key source_key] [--reference_id reference_id]

ValidateGroupMember

Reprovision records based on Group Validity Dates. As of Registry v4.0.2, this job will also process CO Group Nesting changes due to validity dates taking effect.

(info) Prior to Registry v4.0.0, this functionality was provided as a Registry Job Shell task.

Usage (Command Line)

$ ./Console/cake job CoreJob.ValidateGroupMember -s --coid co

Vet

Perform Person Vetting by processing queued Vetting Requests.

Usage (Web Interface)

An individual Vetting Request can be registered via CO PersonVetting RequestsRegister Vetting Request.

Usage (Command Line)

$ ./Console/cake job CoreJob.Vet [-a|-s] --coid co