FeSL Installation

Note: these are preliminary build notes for early testing and development. Feel free to add your own notes

Test environment:

• Mac OS X 10.6 (Snow Leopard)
  • Java 1.6
  • Maven 2.0.9
  • Ant 1.7.0
• Fedora 3.3
  • Tomcat 5.5.26
• melcoe-pdp
• melcoe-pep
• fedora-jaas

fedora

svn co https://fedora-commons.svn.sourceforge.net/svnroot/fedora-commons/fedora/trunk fedora
cd fedora
mvn install -P fedora-installer
java -jar installer/target/installer-1.0.0-fedora-installer.jar

Select "custom" and accept all defaults and "included" options except for "Enable policy enforcement" which should be "false" and "Enable Resource Index" which should be "true".

melcoe-pdp

adapted from: http://www.muradora.org/muradora/wiki/InstallingRampPDP

1. dbxml (versions prior to 2.5 include xerces-c 2.x, which does not build correctly in OS X 10.6)

   ./buildall.sh --prefix=/usr/local/dbxml-2.5.13 --enable-java
   

   Note: this is a quite lengthy build. Take the dog for a walk and come back.
2. set environment variables

   export DBXML_HOME=/usr/local/dbxml-2.5.13
   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${DBXML_HOME}/lib
   export MELCOEPDP_HOME=/usr/local/melcoe-pdp
   export DYLD_LIBRARY_PATH=${DBXML_HOME}/lib:$DYLD_LIBRARY_PATH
   

3. Build and install melcoe-pdp 

   svn co http://www.muradora.org/svn/muradora-project/melcoe-pdp/trunk melcoe-pdp
   cd melcoe-pdp
   ant install
   ant load-policies
   cp dist/axis2.war $CATALINA_HOME/webapps/
   

4. Start Tomcat, e.g.:

   $CATALINA_HOME/bin/startup.sh
   

5. Sanity check: verify that http://localhost:8080/axis2/services/listServices lists the PolicyDataManagerService and PDP services.

melcoe-pep

1. Make a backup copy of $CATALINA_HOME/webapps/fedora/WEB-INF/web.xml and $CATALINA_HOME/webapps/fedora/WEB-INF/schema-config.wsdd. These get replaced when you run ant install
2. Download & install melcoe-pep

   svn co http://www.muradora.org/svn/muradora-project/melcoe-pep/trunk melcoe-pep
   cd melcoe-pep
   ant install -Dwebapp.location=$CATALINA_HOME/webapps/fedora
   

3. Sanity check: verify that http://localhost:8080/fedora/search works for fedoraAdmin, but returns authorization denied for a valid, but non-adminstrator role (create one in $FEDORA_HOME/server/config/fedora-users.xml)
4. Replace the $CATALINA_HOME/webapps/fedora/WEB-INF/web.xml with this version. This version has the melcoe-pep and fedora-jaas configuration already set. You will need to set the 'fedora.home' parameters though.

fedora-jaas

1. Download & install fedora-jaas

   svn co http://www.muradora.org/svn/muradora-project/fedora-jaas/trunk fedora-jaas
   cd fedora-jaas
   ant dist
   

2. Copy the dist/fedora-jaas.jar file to $CATALINA_HOME/webapps/fedora/WEB-INF/lib.
3. Copy the config/jaas.conf file to $FEDORA_HOME/server/config.
4. Configure the config/jaas.conf file.
5. View the fedora-jaas documentation: FESL Authentication Module