Grouper

Grouper Toolkit enables project managers, departments, institutions and end users to create and manage institutional and personal groups.

Assuming you have a working install of Grouper below are the steps to configure uPortal to use your Grouper instance. Please refer to the Grouper Wiki for the technical information, installation, configuration, and case studies of the Grouper software.

Step 1: Edit grouper.client.properties

Open for editing: uportal-war/src/main/resource/grouper.client.properties

To perform the most basic configuration, edit the grouperClient.webSerice.url, grouperClient.webSerice.login, and grouperClient.webSerice.password properties to match your Grouper server.

########################################
## Web service Connection settings
########################################
# url of web service, should include everything up to the first resource to access
# e.g. http://groups.school.edu:8090/grouper-ws/servicesRest
# e.g. https://groups.school.edu/grouper-ws/servicesRest
grouperClient.webService.url = http://localhost:8180/grouper-ws/servicesRest/
# kerberos principal used to connect to web service
grouperClient.webService.login = GrouperSystem
# password for shared secret authentication to web service
# or you can put a filename with an encrypted password
grouperClient.webService.password = 123

Step 2: Edit compositeGroupServices.xml

Open for editing: uportal-war/src/main/resource/properties/groups/compositeGroupServices.xml

Uncomment the grouper service component

 <service>
    <name>grouper</name>
    <service_factory>org.jasig.portal.groups.ReferenceIndividualGroupServiceFactory</service_factory>
    <entity_store_factory>org.jasig.portal.groups.grouper.GrouperEntityStoreFactory</entity_store_factory>
    <group_store_factory>org.jasig.portal.groups.grouper.GrouperEntityGroupStoreFactory</group_store_factory>
    <entity_searcher_factory>org.jasig.portal.groups.grouper.GrouperEntitySearcherFactory</entity_searcher_factory>
    <internally_managed>false</internally_managed>
    <caching_enabled>true</caching_enabled>
  </service>

Step 3: Rebuild/Redeploy uPortal

ant clean deploy-war

Step 4: Restart Tomcat

Restart your tomcat server.

Additional References

Grouper Wiki - This is the primary documentation for Grouper, and is a community-maintained repository consisting of technical information you need to know prior to installing Grouper, installation/configuration guides, and case studies contributed by the Grouper community

Having problems with these instructions?

Please send us feedback at uportal-user@lists.ja-sig.org