Installing Fedora 2.2.2

This guide is intended for people who wish to install Fedora 2.2.2 with the intention of later installing RAMP components. It doesn't go into details on how to install Fedora, but contains workarounds for problems when installing Fedora 2.2.2 from the main download. This was tested on a Linux system.

Prerequisites

  • A running LDAP for authentication (tested with OpenLDAP v2.3.27). It is assumed that users can authenticate against this LDAP and obtain their attributes such as their group membership(s). We assume that users in the LDAP follow the eduPerson schema and that their "roles" attributes can be found in eduPersonEntitlement. We also assume that there is an administrator user in the LDAP called fedoraAdmin.
  • A running RDBMS database - Oracle, MySQL, PostgreSQL (tested with PostgreSQL 8.1). It is assumed that there are two databases created: "fedora" and "riTriples", for Fedora index and its RDF Triplestore database respectively. Both databases must be owned by the "fedoraAdmin" user.
  • A running Tomcat >= 5.x.x container.
    • If you are running Tomcat 6.x.x then you need to create a 'common' folder in the $CATALINA_HOME directory and then create a symbolic link from the $CATALINA_HOME/lib into that directory so that $CATALINA_HOME/common/lib -> $CATALINA_HOME/lib. This is because the 'common' directory structure no longer exists in Tomcat 6+ but the Fedora Installer requires it.
  • Sun JDK >= 1.5.x

Instructions

  1. Download Fedora v2.2.2 installation jar file from the Fedora website.
  2. Installing Fedora 2.2.2 by running "java -jar fedora-2.2.1-installer.jar" and select the following options:
    • Select authentication for both API-A and API-M (no need for SSL)
    • Use "existingTomcat" option and point it to your $TOMCAT_HOME installation
    • Do not use Fedora XACML authorization
    • Select the 'postgresql' database option. You can use the included drivers
    • Here is a complete installation log example: Fedora Installation Log
  3. Turn on the Resource Index for Fedora 2.2.2 by editing the fedora.fcfg file
  4. Enable LDAP Authentication for Fedora 2.2.2 by editing the web.xml file. There is an article on the Fedora Wiki describing how this is done
  5. Download Muradora script to convert the default Fedora demo objects by untar/gunzip and running "ant run".
  6. Start Tomcat and ingest the demos by using the supplied script ($FEDORA_HOME/client/bin/fedora-ingest-demos.sh)
  7. Test Fedora deployment by going to http://<yourhost:8080>/fedora/search and http://<yourhost:8080>/fedora/risearch, login as "fedoraAdmin" (or an account from your LDAP directory if you have configured this) and do a simply query for both to see that you have results returned

Back to Deployment Guides