System Properties

Address Book Server can be configured using several properties. The properties are set in either setenv.sh, setenv.bat or the Tomcat Service Configuration tool on windows.

This is an extract from setenv.sh showing the default values

JAVA_OPTS="$JAVA_OPTS -DH2_TCP_PORT=48081"
JAVA_OPTS="$JAVA_OPTS -DH2_WEB_PORT=48082"
JAVA_OPTS="$JAVA_OPTS -Dorg.apache.el.parser.COERCE_TO_ZERO=false"
JAVA_OPTS="$JAVA_OPTS -Dcom.addressbookserver.ENABLE_BONJOUR=true"
JAVA_OPTS="$JAVA_OPTS -Dcom.addressbookserver.ENABLE_H2=true"
JAVA_OPTS="$JAVA_OPTS -Dcom.addressbookserver.H2_DATABASE=../db"
JAVA_OPTS="$JAVA_OPTS -Dcom.addressbookserver.H2_BACKUPS=../backups"
JAVA_OPTS="$JAVA_OPTS -Dcom.sun.management.jmxremote"

# Optionally you can enable this feature which will alert you
# if a client has not sync'd with the server within the last
# X days.
#JAVA_OPTS="$JAVA_OPTS -Dcom.addressbookserver.EvaluateLastSyncDate=10"

# Native Library for Bonjour 
# JAVA_OPTS="$JAVA_OPTS -Djava.library.path=/usr/local/lib/"

H2_TCP_PORT

This configures the port on which the H2 database is running. Changing this port is not recommended unless you also modify the server.xml file to match the new port.

H2_WEB_PORT

This configures the port on which the the H2 database. You can access your database using SQL by pointing your web browser to your server on this port.

org.apache.el.parser.COERCE_TO_ZERO

This setting is required for the web interface to function correction. DO NOT CHANGE THIS

com.addressbookserver.ENABLE_BONJOUR

Enables Address Book Server to publish its presence on the network using Bonjour. If you want to disable this feature you can set it to false

com.addressbookserver.ENABLE_H2

Start up the H2 embedded database during server startup. If you are using an alternate database you could disable this

com.addressbookserver.H2_DATABASE=../db"

The folder / path where the database files are created / kept. If you are changing this path a new database will be created, unless you move the files from the old location to the new one.

com.addressbookserver.H2_BACKUPS=../backups"

The folder / path where database backups are stored

com.addressbookserver.EvaluateLastSyncDate

If you want to prevent clients which have not synchronised in a long time from synchronising with your server, and potentially introducing out-dated records you can set this property to the number of days after which synchronisation will no longer be possible. To restore synchronisation after the specified period has elapsed you need to remove the reference to the client in the Users tab on the web interface.