Note: If you check out the git repository, run ./gradlew downloadGrouper from the repository root and skip to step 5. You will also have to change some paths to match the directory you cloned into.

1. Install JDK 7 from Oracle. Follow the instructions at that site to download and install Java SE Development Kit 7u45.

2. Download the tarball from Google Drive.

3. Choose a location to install the package. For this demo, ~/Applications will be used.

4. Unpack the tarball

   mkdir ~/Applications
   cd ~/Applications
   tar xvfj ~/Downloads/cas-grouper.tar.bz2

Note: If the directory ~/Applications already exists, you might get an error

1. set APP_HOME and JAVA_HOME

   cd ~/Applications/cas-grouper
   export APP_HOME=`pwd`
   export JAVA_HOME=`/usr/libexec/java_home`

2. Install Grouper

   cd $APP_HOME/grouper
   java -jar grouperInstaller.jar

   Accept the defaults, when available.

   Notes:

   • You will get exceptions if you choose to run dos2unix and it's not installed; You can ignore these.
   • When asked, "Do you want to init the database (delete all existing grouper tables, add new ones)," choose t.
   • When prompted, "Enter the GrouperSystem password," use letmein7.

3. Check to make sure everything installed properly by visiting the (Grouper Site)[http://localhost:8080/grouper]. You should be able to log in with username GrouperSystem and password letmein7.

4. Build the application

   cd $APP_HOME
   ./gradlew clean build

5. Load permissions sample data into Grouper.

   cd $APP_HOME/grouper
   export GROUPER_HOME=$APP_HOME/grouper/grouper.apiBinary-2.1.5
   $GROUPER_HOME/bin/gsh sample.gsh

6. Open 2 terminals to run the CAS server and the sample application

   • For CAS:

      cd $APP_HOME/cas-grouper
      ./gradlew :cas:run

   • For sample resource:

      cd $APP_HOME/cas-grouper
      ./gradlew :resource:run

7. Test initial configuration of App by going to (resource)[http://localhost:5050/resources/bill]. Click the link to get key. Log in with username jj and password jj. Click allow. You should be redirected back to the application with a message saying the now logged in user doesn't have permission.

8. Open a new terminal and add permissions to the resource to the user

   cd ~/Applications/cas-grouper/grouper
   export GROUPER_HOME=~/Applications/cas-grouper/grouper/grouper.apiBinary-2.1.5
   $GROUPER_HOME/bin/gsh sample-read.gsh

9. Test read permission of App by going to (resource)[http://localhost:5050/resources/bill]. Click the link to get key. Log in with username jj and password jj. Click allow. You should be redirected back to the application with a message saying the now logged in user has the read permission.

Start:

$GROUPER_HOME/db.sh start

Stop:

$GROUPER_HOME/db.sh stop

Start:

$GROUPER_HOME/apache-tomcat-6.0.35/bin/catalina.sh start

Stop:

$GROUPER_HOME/apache-tomcat-6.0.35/bin/catalina.sh stop

This should be run in its own terminal

Start:

cd $APP_HOME
./gradlew -q :cas:run

Stop: ctrl-c in the terminal

This should be run in its own termial

Start:

cd $APP_HOME
./gradlew -q :resource:run

Stop: ctrl-c in the terminal

To be written

To be written