Work in progress
This is the app that we intent to use for all our group management.
We will run this on an Ubuntu 12.04 VM.
I would like to stick as much as possible to Ubuntu provided packages, preferably the latest versions of everything. Confirmed on the list that Grouper can run fine with OpenJDK, so no need for the
Sun Oracle Java stuff any more (which was tedious to install and update since Oracle ended their Operating System Distributor License for Java in August 2011). So, at the moment it looks like we're going to use:
- Tomcat 6.0.35 (v7 does not work with Grouper - yet)
- PostgreSQL 9.1.4
- Ant 1.8.2
- OpenJDK 7u3
To page described how to get all various components installed and running on a pristine Ubuntu 12.04 system.
This is the core, and consists of a database and the
grouper/ directory in the repository - which is downloaded later.
Remove the old JRE:
Now download the source code, in this case we're fetching the latest version of the 2.1 branch, and stick that under
Create the PostgreSQL database and credentials:
Because we run our databases on IPv6 only, we have to edit
/etc/postgresql/9.1/main/postgresql.conf to list:
Copy the default hibernate config file:
and edit accordingly. Note that the values should not be enclosed in quotes:
Change all (6) occassions of the version string "1.5" into "1.7" in build.xml:
Symlink the database driver:
Create the database structure:
Check if this went OK:
Run the tests. This is an extensive test suite - on a powerful VM it took me about one hour:
No errors should be reported in the end.
Configure the subject source(s)
At this stage the database structure is in place to manage groups, but obviously you need something to group .
Often you'll want to group users together. In Grouper-speak users are called subjects.
Grouper needs to know about the subjects before it can group them. This is done by configuring one or more subject sources.
There are several options: let Grouper look stuff up in a directory, an SQL database, etc, depending on the local situation.
users subjects are stored in a PostgreSQL database on a remote server. I created a dedicated view in the database, just for Grouper, which is handy because you can add whatever you like, without affecting the rest of the database.
This is the web interface that comes as another java app, and sits in
/grouper-ui of the repository.
First change the version statement to 1.7 to make sure it works with JDK1.7:
Compile the app:
Create a file
/etc/tomcat6/Catalina/localhost/grouper.xml with this content:
/etc/tomcat6/tomcat-users.xml so that there is a user called GrouperSystem, with a secure password:
Change the permissions on the logging directory:
You should now be able to go to http://<yourservername>:8080/grouper-ui/
and log in.
This is optional, but good practise for security considerations. All the JAVA stuff can run on unprivileged ports, and apache faces the internet.
Configure SSL certificates etc