/
Installation Instructions

Installation Instructions

Jan 20, 2020



Introduction


This document describes how to install Compose 5 (a/k/a CNG).

The installation involves deploying the Compose WAR-file to a web server and configuring it. For storage you need a database and some locations on disk. 
Compose can run in different environments which means some configuration steps may vary accordingly. This document is intended to be read by someone already experienced with deployment. 
The steps that need to be taken are roughly:

  1. Setting up the database.
  2. Initializing the database with tables.
  3. Making the JDBC driver accessible to the web server.
  4. Configuring the web server.
  5. Deploying the application to the web server.

Installation instructions

Minimum requirements:

  • JDK 1.6 / 1.7 / 1.8
  • Database (one of)
    • PostgreSQL 8.4 or newer
    • Oracle 10g or newer
    • MS SQL Server 2012 (only tested with Express version)
  • Servlet container (one of)
    • Tomcat 6.0.35
    • Tomcat 7.0.41+
    • Tomcat 8.0.5+
    • Tested on Jetty 8.1 (although we primarily use Tomcat)

Setting up the database

  1. Create a database to host the data. e.g. cng.
  2. Create a user and make that user database owner for the database you created in step 1. This user must be allowed to log in to the database.

See this page for more instructions: Database


Configure cng.properties, see CNG configuration file

Deployment to web server


Deployment on tomcat:
The war file can be copied to the TOMCAT_HOME/webapp folder and it will be processed and unpacked by tomcat when tomcat is running. 
Deployment on Jetty:The cng.war file should be unpacked into the JETTY_HOME/webapp directory.