Deploying eXist

Numishare depends upon eXist-db as the XML database, but this could be switched with another XML database which follows the same REST protocols. The eXist WAR file should be placed in Tomcat's webapps folder. Download the latest stable build of eXist-db.

eXist-db 5.x+

Beginning with 5.0, eXist-db no longer packages a WAR file for deployment into a servlet container, and so the XML database software must be run as a standalone service (like the current version of Solr). Refer to the installation documentation, or specifically, the advanced installation instructions for deploying as a service on a web server.

Note By default, the Jetty container that eXist-db runs in as a server is set to use port 8080 by default, which is the same as Tomcat. Refer to the troubleshooting documentation to change Jetty to another port, e.g., 8888.

eXist-db 4.7 and below (Tomcat)

Packages for eXist-db 4.7 and below contain a WAR file can be deployed into Apache Tomcat. Be sure to rename the WAR file to exist.war before deploying. Note that the above installation instructions still apply for earlier versions of eXist-db.

Note about deployment on Tomcat 8.5: There is an incompatibility between betterForm Jars in eXist-db and Tomcat 8.5. Disable anything pertaining to betterForm in the web.xml in /var/lib/tomcat8/webapps/exist.

Setting credentials in Numishare

By default, eXist has an “admin” user with administrative privileges, and the password is blank. If you change the eXist server URL, username, or password, you can edit exist-config.xml, located in the Numishare installation folder. The default config is shown below:

<exist-config>
	<username>admin</username>
	<password/>
	<url>http://localhost:8080/exist/rest/db/</url>
</exist-config>

You can use the client.sh to upload directly into Numishare and change usernames and passwords.