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