Installation

The installation process uses Apache Maven to create the module and download the appropriate dependencies. After installing Maven, perform the following steps:

1. Download or clone the source repository from https://github.com/Unicon/googleapps-grouper-provisioner.

2. Build the module and pull down dependencies by running mvn clean package dependency:copy-dependencies -DskipTests -DincludeScope=runtime.

   This will download all of the required dependencies and place them in target/dependencies, and build the provisioner module at target/google-apps-provisioner-1.X.X-SNAPSHOT.jar.

3. Update the GROUPER_HOME/config/grouper-loader.properties file with the Provisioner Properties.

   The following is a sample of the minimum set of properties needed:

   changeLog.consumer.courses.class = edu.internet2.middleware.changelogconsumer.googleapps.GoogleAppsChangeLogConsumer
   changeLog.consumer.courses.quartzCron =
   
   changeLog.consumer.courses.serviceAccountPKCS12FilePath = /Users/jgasper/GrouperProvisioner.key
   changeLog.consumer.courses.serviceAccountEmail = [email protected]
   changeLog.consumer.courses.serviceImpersonationUser = [email protected]
   changeLog.consumer.courses.domain=gtestschool.edu
   
   changeLog.consumer.courses.groupIdentifierExpression=crs-${groupName}
   changeLog.consumer.courses.subjectIdentifierExpression=${subjectId}
   

4. Update the GROUPER_HOME/config/log4j.properties file, and add log4j.logger.edu.internet2.middleware.changelogconsumer.googleapps = DEBUG, grouper_debug.

   Output will be written to the grouper_debug.log file.

   DEBUG, grouper_debug can be adjusted to other properties. See the log4j.properties file for more examples.