Getting started with hooks

Hooks Introduction
Proof of concept (A veto hook)
Hooks Example - Assign a Unix id to each new group

Instructions to get started with Grouper and hooks.

Install postgres, add a grouper user with a pass.
Download the latest grouper 1.4 branch
- cvs -d:pserver:anoncvs@anoncvs.internet2.edu:/home/cvs/i2mi login
- cvs -d:pserver:anoncvs@anoncvs.internet2.edu:/home/cvs/i2mi export -r GROUPER_1_4_BRANCH grouper
- cvs -d:pserver:anoncvs@anoncvs.internet2.edu:/home/cvs/i2mi export -r GROUPER_UI_1_4_BRANCH grouper-ui
In grouper dir, run: ant dist
Change these settings in conf/grouper.hibernate.properties
- hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect
- hibernate.connection.driver_class =org.postgresql.Driver
- hibernate.connection.url = jdbc:postgresql://localhost:5433/grouper
- hibernate.connection.username = grouper
- hibernate.connection.password = whateverYouSet
Copy the grouper_home/lib/jdbcSamples/postgresql.jar to grouper_home/lib/custom
- cp lib/jdbcSamples/postgresql.jar lib/custom
Change this in conf/grouper.properties so ddl can be done:
db.change.allow.user.1=grouper
db.change.allow.url.1=jdbc:postgresql://localhost:5432/grouper
Add tables: bin/gsh.sh -registry -runscript
- You should now be able to browse the DB with pgAdmin or whatever tool you use to admin the db
Check tables: bin/gsh.sh -registry -check
- Should output: NOTE: database table/object structure (ddl) is up to date
Start gsh and add a subject: bin/gsh.sh
gsh 0% addSubject("mchyzer", "person", "Chris Hyzer")
gsh 1% exit
In grouper.properties, I will change/add these settings:
groups.wheel.use = true
groups.wheel.group = etc:sysadmingroup
configuration.autocreate.group.name.0 = etc:sysadmingroup
configuration.autocreate.group.description.0 = super users
configuration.autocreate.group.subjects.0 = mchyzer
Start gsh again: bin/gsh.sh see if the user is in the groups. Make a stem. Add a type, and an attribute
gsh 0% grouperSession = GrouperSession.startRootSession();
edu.internet2.middleware.grouper.GrouperSession: f802d876-b876-4315-b76e-0586bcc561b1,'GrouperSystem','application'
gsh 1% subject = findSubject("mchyzer");
subject: id='mchyzer' type='person' source='jdbc' name='Chris Hyzer'
gsh 2% member = MemberFinder.findBySubject(grouperSession, subject);
member: id='mchyzer' type='person' source='jdbc' uuid='1324c75e-9435-4c45-97e9-af40f2b71046'
gsh 3% member.getGroups();
group: name='etc:sysadmingroup' displayName='etc:sysadmingroup' uuid='e8cf5974-97ea-4865-9ac9-719fe3a13134'
gsh 4% addRootStem("aStem", "aStem");
stem: name='aStem' displayName='aStem' uuid='3e1c5e6e-6dd4-43f0-8b6c-20cb39f01ac8'
gsh 5% typeAdd("fubGroup");
type: 'fubGroup'
gsh 5% typeAddAttr("fubGroup", "gid", AccessPrivilege.READ, AccessPrivilege.ADMIN, false);
attribute: 'gid'
Lets add the hook and try in gsh. Just add in grouper source tree for simplicity sake

package test;

import edu.internet2.middleware.grouper.Group;
import edu.internet2.middleware.grouper.GroupType;
import edu.internet2.middleware.grouper.GroupTypeFinder;
import edu.internet2.middleware.grouper.hooks.beans.HooksContext;
import edu.internet2.middleware.grouper.hooks.beans.HooksGroupBean;

/**
 * add a type after a group insert
 */
public class GroupAddFubHook extends
    edu.internet2.middleware.grouper.hooks.GroupHooks {

  /**
   *
   * @see edu.internet2.middleware.grouper.hooks.GroupHooks#groupPostInsert(edu.internet2.middleware.grouper.hooks.beans.HooksContext, edu.internet2.middleware.grouper.hooks.beans.HooksGroupBean)
   */
  @SuppressWarnings("unchecked")
  @Override
  public void groupPostInsert(HooksContext hooksContext,
      HooksGroupBean postInsertBean) {

    super.groupPostInsert(hooksContext, postInsertBean);

    try {
      Group group = postInsertBean.getGroup();
      GroupType fubGroup = GroupTypeFinder.find("fubGroup");
      group.addType(fubGroup);
      group.setAttribute("gid", "2");
      group.store();

    } catch (Exception e) {
      throw new RuntimeException(e.getMessage(), e);
    }
  }

}

[mchyzer@flash2 grouper]$ ant dist

Add this line to the hooks section in conf/grouper.properties
hooks.group.class=test.GroupAddFubHook
See hook work, see new type and new attribute: bin\gsh.sh

gsh 0% group = addGroup("aStem", "aGroup5", "aGroup5");
group: name='aStem:aGroup5' displayName='aStem:aGroup5' uuid='b5552545-2ad2-462c-b5df-67586c987992'
gsh 1% group.getTypes();
type: 'base'
type: 'fubGroup'
gsh 2% group.getAttributes();
java.util.HashMap: {extension=aGroup5, displayExtension=aGroup5, gid=2, name=aStem:aGroup5, displayName=aStem:aGroup5}
gsh 3%

*

Grouper UI

Download or unzip grouper-ui
Run ant - exit
Edit the build.properties,
- set the grouper.folder if not ../grouper
Run ant - dist
Edit your tomcat_home/conf/server.xml, add a context for the UI
<Engine defaultHost="localhost" name="Catalina">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
<Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true" xmlNamespaceAware="false" xmlValidation="false">
<Context docBase="/home/mchyzer/grouper_v1_4/grouper-ui/dist/grouper" path="/grouper" reloadable="false"/>
</Host>
</Engine>
Add a user to your tomcat-users.xml file:

<tomcat-users>
  <role rolename="grouper_user"/>
  <user username="mchyzer" password="whateveryouwant" roles="grouper_user"/>
</tomcat-users>

If you are using mod_jk, hook up the url with the tomcat:
JkMount /grouper/* tomcat_mchyzer
Stop and start apache and tomcat:
[mchyzer@flash2 grouper]$ /home/mchyzer/apache2_0/bin/apachectl stop
[mchyzer@flash2 grouper]$ /home/mchyzer/apache2_0/bin/apachectl start
[mchyzer@flash2 grouper]$ /home/mchyzer/tomcat/bin/shutdown.sh
Using CATALINA_BASE:   /home/mchyzer/tomcat
Using CATALINA_HOME:   /home/mchyzer/tomcat
Using CATALINA_TMPDIR: /home/mchyzer/tomcat/temp
Using JRE_HOME:       /opt/appserv/java6
[mchyzer@flash2 grouper]$ /home/mchyzer/tomcat/bin/startup.sh
Using CATALINA_BASE:   /home/mchyzer/tomcat
Using CATALINA_HOME:   /home/mchyzer/tomcat
Using CATALINA_TMPDIR: /home/mchyzer/tomcat/temp
Using JRE_HOME:       /opt/appserv/java6
[mchyzer@flash2 grouper]$
Add a group with or without the fubGroup type, and see the type and attribute when done