Installation FAQ

Q: How can I configure eXist to log exceptions only?

A: You have to edit log4j.xml (or WEB-INF/classes/log4j.xml when running as a webapp). Change all the

<priority value="debug"/>

to

<priority value="warn"/>

The possible values are: debug, info, warn, error (with increasing priority).

Q: How do I tell the client that I use a different port for exist?

Exist runs as a web application under tomcat (I intend to use it with cocoon). My problem is that I cannot get the client to run because it cannot establish the connection. I know now that the problem is that I use a different port number for tomcat. Tomcat runs on 80 instead of 8080. What I couldn't find is how to change the port number so that I can use exist on port 80???

A: To set this uri as the default, edit client.properties and change:

uri=xmldb:exist://localhost:8080/exist/xmlrpc

Q: How do I tell the jetty server to listen on a different port?

The quick start installation instructions describe launching eXist using bin/startup.sh or bin/startup.bat. These scripts launch Jetty and run Cocoon and eXist as servlets.

By default, jetty listens on port 8080.

A: To configure the jetty server to listen on a different port, edit bin/startup.sh and bin/shutdown.sh and change this line:

OPTIONS="-Dexist.home=$EXIST_HOME"

For example, to tell jetty to listen on port 8680, use:

OPTIONS="-Dexist.home=$EXIST_HOME -Djetty.port=8680"

For the .bat file versions of these scripts, just add -Djetty.port=8680 to the JAVA_OPTS line.

You should also edit webapp/WEB-INF/cocoon.xconf to reflect the new port number. Search for 8080 and replace it with the new port.

Finally, you may wish to change the client.properties file as well.