How To: Configure Job Groups in Synchronize

Applies To:

GroupID 8 and above - Synchronize

Business Scenario:

You have two Synchronize jobs configured in GroupID and want to run one job after another.

More Information:

In GroupID, you can group individual jobs to run consecutively. Create multiple Synchronize jobs, and then combine them in a Job Group. Then you can execute the Job Group instead of executing each job one by one.

Managing Job Groups

A job group is a collection of individual jobs that you want to run in a particular order. For instance, you can create a job group to synchronize user accounts between multiple Active Directory domains. You first create multiple Synchronize jobs to transfer data between two directories, and then combine them in a job group. Then you can execute the job group instead of executing each job one by one.

You can do the following in a job group:

1. Add existing jobs to a group
   When you add existing jobs to a group, Synchronize creates a copy of the original job for the group. Any changes you make to the job at the group level are applied to the group's copy, not the original. Similarly, any change in the original job is not applied to the group’s copy.
      
2. Create new jobs to add
   If the job to be added does not exist, you can launch the New Job Wizard from within the New Job Group wizard to create it. The new job is automatically added to the group upon creation. Such jobs only exist in the originating job group and do not appear in the All Jobs list.
    
3. Remove jobs from a group
   Let's assume you add an existing job to a group. If this job is deleted from the group, the group’s copy is deleted while the original continues to exist in the All Jobs list.
      
4. Determine the order of job execution
   You can specify the order in which jobs are run one after another.
      
5. Specify a failure action for each job
   For each job in a group, you can specify the action to take if it fails to run successfully. You can choose whether to continue or to abort the execution of the remaining jobs in the group.
      
6. Set up job run notifications
   Email notifications contain a brief summary of the objects processed by the job group and a detailed log of statistics and errors. 

Create a Job Group:

1. In GroupID Management Console, click the Synchronize node.
2. Expand the Synchronize node, right-click Job Groups, and then click New Group.
   The New Group wizard opens.
3. On the Job Group Template page, select whether to use a job group template or create the job group from scratch.
4. Click Next.
5. On the Group Jobs page, add jobs to the group.
   • To add an existing job to the group, click Add Existing Job. On the Synchronize Existing Job(s) dialog box, select the check box next to the name of the job to be added and click Add in Group.
   • To add a new job to the group, click Add New Job and create a new job to add it to the group.
6. Set the run order of an individual job by right-clicking the job and then selecting Move Up or Move Down.
7. Set the action to take on the failure of a job by clicking its cell in the On Failure column and then selecting one of the following:
   • Abort: to stop the execution of the remaining jobs in the group.
   • Continue: to continue with the next job in the group.
8. Click Next to continue.
9. On the Notifications page, set up email notification of job group run results. This feature requires Microsoft Exchange.
   Notifications are disabled by default. Select the Enable notifications check box to enable them.

   Note: This step requires that notification settings are already configured. Click the Configure Notifications link to configure notifications.

   1. Enter the email address of notification recipients in the given box.
   2. From the Send notification list, select the notification trigger event. Options are:
      • Always: Send a notification every time the job group is run, regardless of outcome.
      • When records are updated: Send a notification only when one or more records have been updated.
      • When one or more errors occur: Send a notification only when errors occur while executing the job group.
      • When the job group fails: Send a notification only when a fatal error occurs causing the job group to fail.
   3. Click Next.
10. On the Save Job Group page, provide a name and a description for your job group to save it, and click Next.
11. On the Completing the Synchronize Job Group Wizard page, select the Preview job group when finished check box to view details about the job group on completing the wizard.
12. Click the Advanced button if you want to set up a run schedule for the job group.
    • In the Task Name box on the When to Run Job Group page, enter a name for the scheduled task.
    • Click Set Schedule to open the Windows Task Scheduler dialog box and define a schedule.
13. Click Finish to exit the wizard and create the job group.

Create a Job Group by duplicating an existing Job Group

1. In GroupID Management Console, click the Synchronize node.
2. Expand the Synchronize node and click Job Groups.
3. In the job groups list, right-click a job group and select Duplicate.
4. Use the Rename and Open commands in the Actions pane to rename the job group and then open it for modifications.

Change the execution order of individual Jobs in a Job Group

1. In GroupID Management Console, click the Synchronize node.
2. Expand the Synchronize node and click Job Groups.
3. In the job groups list, right-click a job group and click Open.
4. In the jobs list, right-click a job and then click Move Up or Move Down as needed.
5. Click Finish.

Edit a Job in a Job Group

1. In GroupID Management Console, click the Synchronize node.
2. Expand the Synchronize node and click Job Groups.
3. In the job groups list, right-click a job group and select Open.
4. In the jobs list, right-click the job you want to edit and select Open.
5. Go through the Open Job wizard pages to modify the job as required.
6. Click Finish twice to close both wizards.

Remove a Job from a Job Group

1. In GroupID Management Console, click the Synchronize node.
2. Expand the Synchronize node and click Job Groups.
3. In the job groups list, right-click a job group and select Open.
4. In the jobs list, right-click a job and select Remove.
5. Click Finish.

Delete a Job Group

1. In GroupID Management Console, click the Synchronize node.
2. Expand the Synchronize node and click Job Groups.
3. In the job groups list, right-click a job group and select Delete.