Skip to end of metadata
Go to start of metadata

 This topic is discussed in the "Grouper Maintenance" training video.

There is a Grouper report that you can have emailed to you daily, or you can run it manually from GSH.  This report shows a summary of the total state of your grouper installation (e.g. how many memberships/groups/etc, how many unresolvable subjects, how many "bad memberships", etc), and it shows the status of the last day's worth of activity (e.g. how many new membership, how many loader errors).

To run this report from GSH, just run this command:  GrouperReport.report(isRunUnresolvableSubjectReport, isRunBadMembershipFinder);

e.g.

gsh 1% GrouperReport.report(true, true);
Grouper daily report

----------------
OVERALL:
----------------
environment:           DEV
memberships:           40
groups:                9

...

 

To have the report emailed to you, configure these parts of the grouper.properties:

# in cases where grouper is logging or emailing, it will use this to differentiate test vs dev vs prod
grouper.env.name = TEST
...

#smtp server is a domain name or dns name, must be simple clear text stmp with no authentication
#mail.smtp.server = whatever.school.edu

#leave blank if unauthenticated
#mail.smtp.user =

#leave blank if unauthenticated
#mail.smtp.pass =

#this is the default email address where mail from grouper will come from
#mail.from.address = noreply@school.edu

#this is the subject prefix of emails, which will help differentiate prod vs test vs dev etc
#mail.subject.prefix = TEST: 


 Then you can configure the relevant parts of the grouper-loader.properties:

#quartz cron-like schedule for daily grouper report, the default is 7am every day: 0 0 7 * * ?
#leave blank to disable this
daily.report.quartz.cron = 0 0 7 * * ?

#comma separated email addresses to email the daily report
daily.report.emailTo = mchyzer@isc.upenn.edu, mchyzer@yahoo.com

#days on which usdu should run with daily report (comma separated)
#blank means run never.   e.g. to run on all days: monday, tuesday, wednesday, thursday, friday, saturday, sunday
daily.report.usdu.daysToRun = monday, tuesday, wednesday, thursday, friday, saturday, sunday

#days on which bad membership finder should run with daily report (comma separated)
#blank means run never.   e.g. to run on all days: monday, tuesday, wednesday, thursday, friday, saturday, sunday
daily.report.badMembership.daysToRun = monday, tuesday, wednesday, thursday, friday, saturday, sunday
 

 Sample report:

Note, it will also show (if applicable), up to 50 unresolvable subjects, all the bad membership output, all the loader jobs with errors, etc...

 Grouper daily report

----------------
OVERALL:
----------------
environment:           DEV
memberships:           40
groups:                9
members:               16
folders:               4
unresolvable subjects: 0
bad memberships:       0

----------------
WITHIN LAST DAY:
----------------
new memberships:       40
new groups:            9
updated groups:        0
new folders:           3

----------------
LOADER SUMMARY WITHIN LAST DAY
----------------
jobs:                  4
successes:             3
errors:                0
unresolvable subjects: 0
inserts:               0
updates:               0
deletes:               0
processing time:       12,250ms

----------------
LOADER JOBS NON-ERROR
----------------
job:               MAINTENANCE_grouperReport (0 total count)
status:            SUCCESS, started: 2008-11-07 16:09:00.0 (9141ms)
inserts/updates/deletes: 0/0/0
unresolvable subjects: 0

job:               SQL_SIMPLE_faculty (12,324 total count)
status:            SUCCESS, started: 2008-11-07 13:10:00.0 (1340ms)
inserts/updates/deletes: 10/3/7
unresolvable subjects: 3

----------------
GROUPER INFO
----------------
version: 1.4.0 build date: null
os.name: Windows XP
os.arch: x86
os.version: 5.1
java.version: 1.5.0_11
java.vendor: Sun Microsystems Inc.
java.class.path: C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\build;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\activation.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\antlr.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\asm.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\asm-attrs.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\asm-util.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\backport-util-concurrent.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\bsh.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\c3p0.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\cglib.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-beanutils.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-betwixt.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-cli.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-collections.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-digester.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-lang.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-logging.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-math.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\DdlUtils.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\dom4j.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\ehcache.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\hibernate.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\invoker.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\jakarta-oro.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\jsr107cache.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\jta.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\jug.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\log4j.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\mailapi.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\morphString.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\odmg.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\p6spy.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\quartz.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\smtp.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\subject.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\jdbcSamples\hsqldb.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\jdbcSamples\mysql-connector-java-bin.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\jdbcSamples\ojdbc14.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\jdbcSamples\postgresql.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\test\junit.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\ant\ant-contrib.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\commons-discovery.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\jamon.jar;C:\mchyzer\isc\dev\grouper-qs-1.2.0\grouper\lib\grouper\ant.jar
heapSize: 6 MB
heapMaxSize: 63 MB
heapSizeFree: 1 MB

privileges.access.interface: edu.internet2.middleware.grouper.GrouperAccessAdapter
privileges.naming.interface: edu.internet2.middleware.grouper.GrouperNamingAdapter
privileges.access.cache.interface:
privileges.naming.cache.interface:
groups.wheel.use: true
groups.wheel.group: penn:etc:sysAdminGroup

source: id=pennperson name=Penn person class=GrouperJdbcSourceAdapter
source: id=g:gsa name=Grouper: Group Source Adapter class=GrouperSourceAdapter
source: id=g:isa name=Grouper: Internal Source Adapter class=InternalSourceAdapter
source: id=jdbc name=JDBC Source Adapter class=GrouperJdbcSourceAdapter
source: id=servPrinc name=Kerberos service principals class=GrouperJdbcSourceAdapter

hibernate.dialect: org.hibernate.dialect.Oracle10gDialect
hibernate.connection.driver_class: oracle.jdbc.driver.OracleDriver
hibernate.cache.provider_class: org.hibernate.cache.EhCacheProvider





See also

Grouper Diagnostics

  • No labels