As a Grouper administrator, you might get a request to add a job to the loader. This is how to do this:
The request should have two parts (at least) for a simple job (simple means one group one query):
- The query
- The name of the group (hopefully the requestor has created that group and already has admin rights, or you need to grant it, or READ or whatever)
Note, first decide which envs you are going to do this in. Just prod? Test and prod? At Penn sometimes we do just prod, sometimes we do both.
To configure the group, first you can make a view from the query that returns at least the subjectId (maybe the numeric ID at your institution), or subjectIdentifier (maybe the netId at your institution). Note, it is assumed that the query is intended for a database that has a connection configured in the grouper-loader.properties. At Penn this is our people database (where Grouper resides), or the data warehouse. For the Grouper database, the database name is configured as "grouper", for the other, it is a custom name. At Penn we use "warehouse" for our data warehouse.
Note, generally all loader jobs have members as people, if this is the case, you can also select the subject source id to make the job more efficient. Test the resulting query of the view, and note the columns must be correct (in this case the subject id)
Now we can go to the group in the UI that the requester specified. "Edit" the group. Mark this as a loader group. Then edit the attributes:
Note, for cron, generally I set the job for once per day, and I pick a random time in the morning so all the jobs don't run at the same time.
At this point, the job is there, and the WS status (if your institution runs this with nagios or something) will start throwing errors since that job has never run successfully. So lets run it.
Log in to the daemon server where you run GSH:
In order for the loader to pick up the new job on the next day, it needs to be bounced. Note: generally it is good to not do this in the morning when most jobs are scheduled. Here is how to do that if the loader is running as a unix service
Note that as of Grouper 2.3, if you create a new loader job, you can have it scheduled without restarting the daemon by using an option in the New UI. If you're an admin of the group, under "More actions", there's an option named "Schedule loader process". This option can also be used if you change the loader's schedule.