### Limitations

Using JavaDB is currently supported only in the embedded mode -- server mode is not supported, due to some limitations of JavaDB.
This means that using JavaDB cannot support cluster configurations. Only one server can access the database at any one time.

### Details

Install as per the war file instructions, with the following additional stes.

In the Tomcat file conf/server.xml, you need to add the following entry to the <GlobalNamingResources> section:

<Resource
  accessToUnderlyingConnectionAllowed="true"
  auth="Container"
  defaultAutoCommit="false"
  driverClassName="org.apache.derby.jdbc.EmbeddedDriver"
  initialSize="0"
  logAbandoned="true"
  maxActive="10"
  maxIdle="0"
  maxWait="15000"
  minIdle="0"
  name="jdbc/AdminDB"
  removeAbandoned="true"
  removeAbandonedTimeout="30"
  timeBetweenEvictionRunsMillis="30000"
  type="javax.sql.DataSource"
  url="jdbc:derby:/foo/bar/EspressoAdmin;create=true"
  username="ESPRESSOADMIN"/>

The items in bold are the ones that are required -- you can modify other parameters as desired.

Obviously, you can specify any path in the URL. On Windows, you can specify a drive, e.g. jdbc:derby:d:\foo\bar\EspressoAdmin;create=true -- see full details for the JavaDB URL

Note that the create=true parameter will create a new database directory if one does not exist -- this is usually desirable, at least for the first time.