Deploying Orbeon

Orbeon is a the XForms processor that handles all of the back end harvesting and transformation workflows. Additionally, with the XML Pipeline Language (XPL), it handles the public user interface, interacting with Apache Fuseki to deliver SPARQL query results in HTML, Atom, and other formats through REST and content negotiation.

Download the latest free, open source Orbeon Community Edition (CE) zip file. Within the root folder in this zip file, you'll find orbeon.war. Extract orbeon.war and place in the Tomcat webapps folder.

$TOMCAT_HOME = /var/lib/tomcat8

Two minor configurations need to be applied to Orbeon.

• Allow symlinks within the Orbeon webapp directory structure:

  • Create orbeon.xml in $TOMCAT_HOME/conf/Catalina/localhost
  • Insert the following XML fragment (substituting ”/var/lib/tomcat8” with $TOMCAT_HOME if necessary): <Context path="/orbeon" docBase="/var/lib/tomcat8/webapps/orbeon"> <Resources allowLinking="true" /> </Context>
  • Save the file.

• Set the plain theme:

  • Edit $TOMCAT_HOME/webapps/orbeon/WEB-INF/resources/config/properties-local.xml.template, insert within <properties>: <property as="xs:anyURI" name="oxf.epilogue.theme" value="oxf:/config/theme-plain.xsl"/> <property as="xs:string" name="oxf.fr.authentication.method" value="container"/> <property as="xs:string" name="oxf.fr.authentication.container.roles" value="harvester-admin waps ormcl {all additional MARC codes here}"/>
  • Save file. Rename properties-local.xml.template to properties-local.xml.

Finally, restart Tomcat for these changes to take effect: sudo service tomcat8 restart