Skip to content
Frederic Bergeron edited this page Feb 15, 2016 · 7 revisions

This document describes the procedure to install Comète on Linux, more specifically on the Debian 8.1 (stable) distribution. If you are using a different distribution of Linux, the commands might differ significantly.

Requirements

Development environment
Runtime Environment

Install the required sotfware:

sudo aptitude install git default-jdk maven2 tomcat8 tomcat8-admin

Actually, for Maven, it's recommended to use a more recent version. To this end, download the latest binary version from here. Uncompress the archive in /opt directory and adjust your environment like this:

export M3_HOME=/opt/apache-maven-3.3.9
export M3=$M3_HOME/bin
export PATH=$M3:$PATH

Adjust Tomcat's options by adding this line at the end of /etc/default/tomcat8 file:

JAVA_OPTS="${JAVA_OPTS} -Xmx1024m -XX:PermSize=1024m -XX:MaxPermSize=1024m -Dfile.encoding=UTF-8 -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true"

Source Code Download

Clone the following git repository in your home directory:

git clone https://github.com/LICEF/comete.git

A 'comete' folder will be created with all project sources at your current location. This 'comete' directory will be referenced as $COMETE_SRC from now on.

Project Building

  1. Generate the main config file.

    Duplicate the file $COMETE_SRC/src/main/resources/conf/sample-core.properties file and rename it core.properties. Adjust values with your settings.

    Please note that whitespace characters in directories can cause execution problems.

  2. Compile and build the whole project with the following Maven command:

mvn package

Deployment

At this point, Comète is ready to be deployed.

  1. Copy the generated $COMETE_SRC/target/comete.war file into Tomcat's webapp folder (/var/lib/tomcat8/webapps).

Testing

  • Start the Tomcat server.
  • Try the User Interface at : http://localhost:8080/comete

External module

Moreover, you can add a LinkedData portal service over your Comète instance as explained in the following page : LinkedData Installation