3. Build

Configuration Files

build.xml - the Ant script

Each Cinnamon sub-project (Server, Utils, EntityLib) can be build with an Ant script.

An example is contained in Server/build.xml.example.

Copy this to the parent directory of Server, rename it to "build.xml" and configure it to reflect your setup.

persistence.xml - basic database configuration

In Server/META-INF/ you will find a file persistence.xml.example.

Copy it to persistence.xml and configure the persistence units according to your setup.

To improve performance, you can set the following options:

        <property name="hibernate.show_sql" value="false"/>
        <property name="hibernate.format_sql" value="false"/>

 If you expect many client concurrent connections, alter the connection pool settings:

        <property name="hibernate.c3p0.min_size" value="5" />
        <property name="hibernate.c3p0.max_size" value="20"/>

logback.xml - configure your logging

as its main logging framework.

To change the logging level or enable/disable certain logging behaviours, edit this file.

cinnamon_config.xml - configuring Cinnamon itself

The Cinnamon server is configured with the cinnamon_config.xml.

Copy Server/WEB-INF/cinnamon_config.example.xml to cinnamon_config.xml and edit this file as appropriate.

Note that depending on the webcontainer you use, this configuration file may not be found once Cinnamon is running. It is recommended to set an environment variable CINNAMON_HOME_DIR to a directory, where a copy of the configuration file is found. This will also allow you to make changes to the configuration without re-compiling your Cinnamon server again.

Compilation

On the command line, in the parent directory of Server/:

 ant all dist

 This will build all three Cinnamon server projects (EntityLib, Utils, Server)