this is obsolete doc -- see http://doc.nethence.com/ instead

Orbeon Forms on RHEL5 

Apache Tomcat : http://pbraun.nethence.com/doc/www/tomcat.html 

Orbeon Forms : http://pbraun.nethence.com/doc/www/orbeon_forms.html 

XForms : http://pbraun.nethence.com/doc/www/xforms.html 

Installation 

Install Tomcat & depedencies (http://pbraun.nethence.com/doc/www/tomcat.html). Get Orbeon Forms (http://www.orbeon.com/forms/download) and extract it, 

tar xvzf orbeon-dev-3.7.1.200905272119.tar.gz

cd orbeon-dev-3.7.1.200905272119

deploy it and apply, 

mkdir orbeon

unzip orbeon.war -d orbeon

mv orbeon /usr/share/tomcat5/webapps/

service tomcat5 restart

service httpd reload

Note. copying the .war won't do since we need to edit files inside the app. 

Setup permissions, 

  cd /usr/share/tomcat5/webapps/orbeon

chown tomcat:tomcat WEB-INF/exist-data

Note. no need for '-R' 

Prepare Tomcat for the authentication example, 

cd /usr/share/tomcat5/conf

mv tomcat-users.xml tomcat-users.xml.dist1

vi tomcat-users.xml

replace with, 

<tomcat-users>

 <role rolename="orbeon-user"/>

 <role rolename="orbeon-admin"/>

 <user username="orbeonadmin" password="xforms"

        roles="orbeon-user,orbeon-admin"/>

</tomcat-users>

also, 

cp server.xml server.xml.dist

vi server.xml

uncomment this tag, 

      <Realm className="org.apache.catalina.realm.MemoryRealm" />

Prepare Orbeon for the authentication example, 

cd /usr/share/tomcat5/webapps/orbeon

cp WEB-INF/web.xml WEB-INF/web.xml.dist

vi WEB-INF/web.xml

uncomment those tags, 

    <security-constraint>

    <login-config>

    <security-role>

Security : http://www.orbeon.com/ops/doc/intro-install#security 

Tutorial : http://www.orbeon.com/ops/doc/intro-tutorial 

Troubbleshooting 

If anything goes wrong, 

cd /usr/share/tomcat5/logs

tail -F catalina.out

Misc 

To get the instance you can post it against a "service" with 'xforms:submission'. The service can be e.g. a JSP. From the JSP, access the document using the Dom4j library, 

Document queryDocument = xmlReader.read(request.getInputStream());

References 

Installing Orbeon Forms : http://www.orbeon.com/ops/doc/intro-install 

Orbeon Forms FAQ : http://www.orbeon.com/ops/doc/home-faq 

XForms Everywhere : http://www.orbeon.com/blog/ 

Orbeon Form Builder : http://xforms.fr.free.fr/blog/index.php/2008/05/22/orbeon-form-builder/ 

Alternatives 

AJAXForms : http://ajaxforms.sourceforge.net/ (get SUN JRE 5.0 http://java.sun.com/javase/downloads/5u20/jre) 

XSLTForms : http://www.agencexml.com/xsltforms 

Chiba : http://chibaxforms.org/ 

Ubiquity-xforms : http://code.google.com/p/ubiquity-xforms/