Page History

Note: these are preliminary build notes for early testing and development. Feel free to add your own notes
2009-12-09 note: these instructions, while valid for the moment, will change as FeSL gets integrated into Fedora's trunkThis document is out of date. Please see: FeSL Installation

Test environment:

• Mac OS X 10.6 (Snow Leopard)
  • Java 1.65 (32-bit from OS X 10.5 Leopard installation, but the default 64-bit Java6 should work fine)
  • Maven 2.0.9
  • Ant 1.7.0
• Fedora 3.3
  • Tomcat 6.0.20
• 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

Oracle Berkeley DB XML

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)

   Code Block
   ./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.
   Once the build has completed, we need to create local Maven artifacts for the dbxml libraries so that the Fedora build can find them.

cd /usr/local/dbxml-2.5.13/lib
cp db.jar db-2.5.13.jar && cp dbxml.jar dbxml-2.5.13.jar
mvn install:install-file -DgroupId=com.sleepycat -DartifactId=db -Dversion=2.5.13 -Dpackaging=jar -Dfile=db-2.5.13.jar
mvn install:install-file -DgroupId=com.sleepycat -DartifactId=dbxml -Dversion=2.5.13 -Dpackaging=jar -Dfile=dbxml-2.5.13.jar

1.  
2. set environment variables

   Code Block
   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

   Build and install melcoe-pdp  (DYLD_LIBRARY_PATH might only be necessary for OS X)
3. Windows warning:  Oracle priovides only a 32-bit MSI.  64-bit Windows will require a build from source.

fedora

svn co 

...

https://

...

fedora-commons.svn.sourceforge.net/svnroot/fedora-commons/fedora/trunk fedora
cd fedora
mvn install -P fedora-installer
java -jar fcrepo-installer/target/fcrepo-installer-3.3-SNAPSHOT.jar

Select "custom" and accept all defaults and "included" options except for "Enable FeSL" which should be "true".

Start Tomcat, e.g.:

$CATALINA_HOME/bin/startup.sh

...

fcrepo-security-pep

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:

   Code Block
   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

fcrepo-security-jaas

1. Configure the
2. Download & install fedora-jaas

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

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