Installation

Préambule

Ce document concerne l'installation de Constellation-SDI version 1.1.0 et +.


Pré-requis


Installation depuis une archive binaire (Installation standard)

  • Téléchargement de l’application

Vous pouvez télécharger l’application en cliquant sur le lien suivant : Constellation-SDI-1.1.2


  • Création de la base de données constellation

Créer un rôle de connexion PostgreSQL avec pour login cstl et pour mot de passe admin :

sql> CREATE USER cstl WITH ENCRYPTED PASSWORD 'admin';

Créer une base de données nommée constellation en UTF-8. Elle doit utiliser le rôle utilisateur précédemment créé "cstl" :

sql> CREATE DATABASE constellation OWNER cstl ENCODING 'UTF8';


  • Déploiement sur le serveur Tomcat

Veuillez consulter la partie consacrée au déploiement en cliquant suivant le lien Déploiement


Installation depuis les sources (Installation développeur)

  • Pré-requis d’installation complémentaire

  • Récupération des sources depuis Github

Les sources de Constellation-SDI sont disponibles sur GitHub à l’adresse suivante: https://github.com/geomatys/constellation

Pour récupérer les sources il faut exécuter dans un terminal la commande Git suivante :

$> git clone https://github.com/Geomatys/constellation.git
$> git checkout 1.1.0


  • Installation du serveur de base de données

Créer un rôle de connexion PostgreSQL avec pour login cstl et pour mot de passe admin

sql> CREATE USER cstl WITH ENCRYPTED PASSWORD 'admin';

Créer deux bases de données nommées constellation et cstl-test. Elles utilisent le rôle précédemment créé : cstl

sql> CREATE DATABASE constellation OWNER cstl ENCODING 'UTF8';
sql> CREATE DATABASE cstl-test OWNER cstl ENCODING 'UTF8';


  • Compilation et exécution des tests

Vérifier que Java et Maven sont reconnus sur le système avec les commandes :

$> java -version
$> mvn -version

Le résultat de ces commandes doit correspondre aux versions indiquées dans les pré-requis. Dans le cas contraire, veuillez vérifier vos variables d’environnement.


Lancer la compilation depuis les sources en allant dans le dossier constellation et en lançant la commande suivante :

$> mvn install

Pour une compilation plus rapide, on peut éviter d’exécuter les tests avec la commande :

$> mvn install -DskipTests


Déploiement de Constellation-SDI dans Tomcat

  • Configuration du Tomcat

La configuration du Tomcat consiste à créer un fichier setenv.sh dans le dossier bin du Tomcat avec le contenu suivant :

CATALINA_OPTS="$CATALINA_OPTS -Dfile.encoding=UTF8 -Xmx1024m
-XX:MaxPermSize=128m -Dgeotk.image.cache.size=128m
-XX:-HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=./constellation.hprof"
JAVA_HOME=<PATH_TO_JDK>
JRE_HOME=<PATH_TO_JDK>/jre


Remplacer <PATH_TO_JDK> par le chemin vers le JDK précédemment installé.


  • Déploiement de l’application Constellation-SDI

Le fichier constellation.war représente l’application web et se trouve sous le chemin constellation/modules/cstl-sdi/target/

Copier le fichier constellation.war dans le dossier webapps de votre installation de tomcat.

Démarrer le serveur Tomcat en utilisant la commande suivante dans un terminal :

<PATH_TO_TOMCAT>/bin/startup.sh

Affichage des logs :

tail -f <PATH_TO_TOMCAT>/logs/catalina.out

Une fois le serveur Tomcat démarré, l'application est accessible à l'URL http://localhost:8080/constellation
Les identifiants de connexion sont :

  • login : admin
  • password : admin

Pour éteindre l’application, vous pouvez lancer la commande suivante :

<PATH_TO_TOMCAT>/bin/shutdown.sh