How to Install Calamari

The installation process is a bit manual at the moment There are two components to install to get Calamari up and running, the back end and the front end.

Calamari Service Installation

Requirements: Java 5 or greater, Java application/web server

  1. Download the Calamari-1.0.war file from github
  2. Install a Java web server such as Tomcat, JBoss or Glassfish
  3. Copy the war file to the web application directory
  4. Create a directory /var/lib/databases - this is where the database will be stored. Make sure the user the Java application server runs as has read/write permissions to the directory.
  5. Start up the application server. The service should be available at http://<address>:<port>/Calamari-1.0/resources/dataservice/ and http://<address>:<port>/Calamari-1.0/resources/admin/ You won't be able to test it until a database has been created. You can use the front end to create the database or call http://<address>:<port>/Calamari-1.0/resources/admin/initdb. You should see some output in your server log files.

Calamari UI Installation

Requirements: JavaFX 1.2

  1. Download the Calamari-ui.jar and dependencies from GITHub. Please note that I have added a method to JFXTras so you will need to use the one on github. It is based on 0.6
  2. Place the dependencies in a folder called lib.
  3. Copy the lib folder, Calamar-UI.jar and the jnlp file to your web server directory.
  4. Edit the jnlp file so that the code base is correct. Currently it is set to codebase="file:/home/mark/workspace/Calamari-UI/dist/" change it to point to your browsers url.
  5. Open your browser and enter the url to the jnlp file.
  6. Once the application has loaded, go to the admin section.
    1. You can initialise your database form here is you haven't done so already.
    2. Enter the path to the log files, as seen by the server,
    3. Click on the import data button to import files.