Post on 29-Dec-2015
Grouper Training - Admin - Client
Chris Hyzer
Internet2
University of Pennsylvania
This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.
2
Contents
• Introduction• Need to admin?• Download• Customize• Defaults• Usage• ID terminology• LDAP operations• Misc operations
• Build and host
3
Introduction
4
Need to admin?
• You do not need to administer the client
• Administer if:• Make easier for users with URLs populated• Customize the usage• Institution-ify the IDs• Provide with canned LDAP operation(s)
5
Download
• Grouper download sitehttp://www.internet2.edu/grouper/software.html
• Generally if you are customizing, you need the source release, not binary
• Via Grouper Installer
• Unzip
6
Customize defaults
• Edit grouper.client.properties to set default URL's for your environments
7
Customize defaults (continued)
• Edit grouper.client.properties to set discovery URL's for your institution
8
Customize usage
• Edit grouper.client.usage.txt
• Use institution-specific terms
9
Customize ID terminology
• Edit grouper.client.properties
• Customize the ID and Identifier
10
Customize ID terminology (continued)
• Commands can use new terminology
11
Custom LDAP operations
• Grouper client can do simple LDAP operations
• For example, lookup by student ID, return netID
12
Custom LDAP operations (continued)
13
Misc operations (advanced)
• Can bundle custom operations (Java)
14
Build
• Download the source package
• Manually you need Java6, ant
• Edit config files• grouper.client.properties• grouper.client.usage.properties
• Run "ant" (default build)
15
Host
• Rename the built tarball
• Host on one of your web servers
• Link for your internal Grouper documentation site/wiki, e.g.
https://myschool.edu/grouper/grouperClient.myschool-2.1.1.tar.gz
16
Quiz
• Click on the quiz link in the video description to reinforce your knowledge of this topic
Thanks!
Further information:
•Infosheets, mailing lists, wiki, downloads, etc.:www.internet2.edu/grouper
•Grouper demo server:grouperdemo.internet2.edu/
•Grouper Online Training Home:spaces.internet2.edu/x/IIGfAQ
This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License. 17