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.