Changes between Version 11 and Version 12 of GrouperInstall

Timestamp:

06/09/13 07:14:45 (11 years ago)

Author:

uaguest_SPatel1@…

Comment:

--

GrouperInstall

@@ -223 +223 @@
 }}}
 
+== Patches ==
+
+A bug was found in the Grouper API while debugging the building loader.  The source directory (/srv/grouper/grouper.api-2.1.4/src) was patched with the fix.  The fix will also be available in the next version of Grouper.  To apply the fix, update the file src/grouper/edu/internet2/middleware/grouper/app/loader/db/GrouperLoaderResultset.java with the latest version from the 2.1 branch in Grouper's SVN repository.  Then run 'ant dist' again.
 
 == Basic Grouper Configuration ==
@@ -653 +656 @@
 }}}
 
+== Custom development ==
+
+Custom code development for this proof of concept has been added to the following location:  /srv/grouper_custom.
+
+Note that this should all probably get added to a UA source control repository.
+
+1.  The file conf/ua_buildings.properties contains the building information with the fields short name, long name, and campus name.  There is one building per line and the fields are pipe separated.
+
+2.  The class src/edu/ua/iam/grouper/BuildingLoaderHelper.java contains logic to convert an officeLocation attribute value to a group name.  The algorithm is:
+
+    a) Check to see if the officeLocation value entirely matches a building short name.
+
+    b) If a match is not found, remove the first word in the officeLocation value and check again.
+
+    c) Repeat (b) until a match is found or there is nothing left to check.
+
+    d) If no match is found, return "UNKNOWN" as the group name.
+
+    e) If a match is found, return the campus name followed by the short name of the building (separated by a hyphen).
+
+3.  So for instance, all of the following officeLocation values translate to the Grouper group "ua:inst:buildings:groups:UAF Main Campus - BUTRO":
+
+{{{
+officeLocation: 211 BUTRO
+officeLocation: 211 BUTRO BUTRO
+officeLocation: BUTRO
+officeLocation: Suite 001 BUTRO
+}}}
+
+4.  The custom code can be deployed by simply running 'ant'.  This will copy both the properties file and the code into the Grouper API installation.
+
+{{{
+[root@grinnell grouper_custom]# cd /srv/grouper_custom/
+[root@grinnell grouper_custom]# ant
+Buildfile: build.xml
+
+init:
+
+clean:
+   [delete] Deleting directory /srv/grouper_custom/build
+   [delete] Deleting: /srv/grouper_custom/dist/lib/grouper_custom.jar
+
+prepare:
+    [mkdir] Created dir: /srv/grouper_custom/build
+
+prepare-src:
+    [mkdir] Created dir: /srv/grouper_custom/build/src
+    [mkdir] Created dir: /srv/grouper_custom/build/classes
+     [copy] Copying 1 file to /srv/grouper_custom/build/src
+
+build:
+    [javac] Compiling 1 source file to /srv/grouper_custom/build/classes
+
+jar:
+      [jar] Building jar: /srv/grouper_custom/dist/lib/grouper_custom.jar
+
+all:
+     [copy] Copying 1 file to /srv/grouper/grouper.api-2.1.4/lib/custom
+
+BUILD SUCCESSFUL
+Total time: 1 second
+[root@grinnell grouper_custom]#
+}}}
+
 
 == Set up loader for the office building for people ==