Procédure d’installation de la chaîne de traitement

Installation d'ActiveMQ Artemis

Ne pas utiliser le paquet activemq qui correspond à ActiveMQ Classic et est incomplet (pas de console web notamment). Télécharger l'archive ActiveMQ Artemis 2.29.0 depuis https://activemq.apache.org/components/artemis/download/ :

wget https://dlcdn.apache.org/activemq/activemq-artemis/2.25.0/apache-artemis-2.29.0-bin.tar.gz
sudo tar zxvf apache-artemis-2.29.0-bin.tar.gz -C /opt/

Créer une instance d'Artemis :

sudo /opt/artemis/bin/artemis create --user admin --password admin --role admins --allow-anonymous false --relax-jolokia /opt/artemis-broker

Ajouter l'utilisateur artemis

sudo groupadd -r artemis
sudo useradd -r -s /bin/false -g artemis artemis
sudo chown artemis -R /opt/artemis-broker/

Copier le fichier systemd sur le serveur

scp src/scripts/etc/systemd/system/artemis.service siclima-preprod:

Autoriser l'accès à la console d'ActiveMQ en modifiant le fichier /opt/artemis-broker/etc/bootstrap.xml.

<web path="web">
   <binding uri="http://0.0.0.0:8161">

Fixer la version de Java à utiliser avec la variable d'environnement JAVA_HOME dans /opt/artemis-broker/etc/artemis.profile.

Installer sur le serveur, modifier le chemin vers l'exécutable Java 17 si nécessaire et activer le service

sudo mv artemis.service /etc/systemd/system/artemis.service
sudo systemctl daemon-reload
sudo systemctl start artemis.service
systemctl status artemis.service
sudo systemctl enable artemis.service

À noter que par la suite le changement de version d'ActiveMQ Artemis se fait en utilisant le script src/scripts/update_artemis.sh.

Il faut éventuellement procéder à la mise à jour de l'instance, avec le script ou avec la commande directe :

sudo /opt/apache-artemis-2.41.0/bin/artemis upgrade /opt/artemis-broker/

Plus de détails dans le chapitre Upgrading tool de la documentation de ActiveMQ Artemis.

Installation rapide des bases de données

Le script sql/sample/create.sh automatise la création d'une base de données comportant la structure de SEASON ainsi que les données climatiques DRIAS – 2020 | CNRM-CM5 / ALADIN63 | Reference + RCP8.5 pour une maille.

Lancez ce script en spécifiant le nom de la base de données à mettre en place.

Installation détaillée des bases de données

Installer la base de données SEASON

Suivre les instructions du fichier Base de données PostgreSQL pour l’installation de la base de données.

Installer les bases de données climatiques

Pour installer d'autres bases de données climatiques, il faut remplir différentes tables :

dans dbconnection : les connexions JDBC aux différentes instances PostgreSQL comportant les données climatiques ;
dans maillage : la définition de la grille ;
dans maille : les valeurs des attributs géographiques de chacune des mailles ;
dans climaticbase : la base de données climatique avec le lien vers la grille ;
dans numeromaille : la correspondance des mailles définies dans maille et de la base de données climatique ;
dans climaticmodel : la clef étrangère de la connexion JDBC à utiliser ainsi que le schéma de la base de données ;
dans climaticscenario : les scénarios climatiques ;
dans climaticvariable : les descriptions des colonnes des tables des scénarios climatiques ;
dans fileformatclimaticvariable et climaticvariable_climaticdata : les correspondances entre les colonnes des tables climatiques et les variables climatiques et colonnes des formats de fichier.

Tester

Lancer des exemples :

mvn package
java -jar cli/target/season-cli-1.1.0-jar-with-dependencies.jar --simulation=core/src/test/resources/sample.properties
java -jar cli/target/season-cli-1.1.0-jar-with-dependencies.jar --receivers=1

Pour plus d’exemples, voir Exécution.