Enabling Apache Proxypass

Apache is not required for functionality, but is necessary to provide cleaner URIs by making http://numismatics.org/ocre/ a proxy for http://numismatics.org:8080/orbeon/numishare/ocre/, for example.

1. Install Apache web server sudo apt-get install apache2
2. Enable mod_proxy sudo a2enmod proxy
3. Edit the default site configuration sudo vi /etc/apache2/sites-enabled/000-default.conf and insert the following before the </VirtualHost> for each project that you wish to create clean URIs for:

---

ProxyPass /{projectname} http://localhost:8080/orbeon/numishare/{projectname}
ProxyPassReverse /{projectname} http://localhost:8080/orbeon/numishare/{projectname}

<Location /{projectname}>
    Order allow,deny
    Allow from all
</Location>

If you wish to deploy only a single Numishare project at the root of a domain name, then you may use / as the location instead of /{projectname}.

Save and exit the file. Restart Apache with sudo service apache2 restart for the changes to take effect. You should be able to access the home page of the Numishare project by going to http://servername/projectname

Note The Numishare administrative XForms web form pages (/numishare/admin) do not function via Apache Proxypass, so you will have to access the administrative section through Orbeon directly at port 8080.