Cloning the Github Numishare Repository

The Numishare Github repository must be cloned onto the server and a symlink placed into the Orbeon apps folder in order to finally deploy the application. If you choose to download the zip file from Github instead of cloning, skip to step 4. You may wish to fork the repository and clone from that.

1. Install Git (It may be necessary to add SSH public keys for servers into user accounts in Github).
2. The repository may be cloned anywhere on the server, but I have always preferred to create /usr/local/projects
3. After creating /usr/local/projects, do a git clone git@github.com:ewg118/Numishare.git to clone the repository within this location. Note: By default, this will clone the folder as Numishare. References in Orbeon are case sensitive to 'numishare', so you may want to rename this folder or create a lower-case symlink in the step below
4. Create a symlink within $TOMCAT_HOME/webapps/orbeon/WEB-INF/resources/apps/ to /usr/local/projects/numishare

After following these instructions (and the steps that follow for deploying eXist, Solr, and establishing Tomcat authentication), the home page of the public user interface will be available at http://servername:8080/orbeon/numishare/ and the admin panel will be available at http://servername:8080/orbeon/numishare/admin/