Monter le Share

Le système doit avoir accès au share dans acd-store.

Consulter le dépôt JREST

Dans acd-store exécutez les commandes suivantes pour extraire le dépôt :

su jtel cd /srv/jtel/shared git clone https://bitbucket.org/jtelgmbh/jtel-system-java-services.git

Installation - sur un serveur Linux

Pour installer le rôle REST sur un serveur Linux, procédez comme suit sur le serveur acd-rest .

Java 12

Installez java 12 comme suit :

cd /home/jtel wget https://cdn.jtel.de/downloads/java/openjdk-12.0.2_linux-x64_bin.tar.gz tar xvfz openjdk-12.0.2_linux-x64_bin.tar.gz rm -f openjdk-12.0.2_linux-x64_bin.tar.gz chown -R jtel:jtel jdk-12.0.2

jrest

Installez jrest comme suit :

cd /home/jtel cp -r /home/jtel/shared/jtel-system-java-services/deploy/jrest jrest mkdir /home/jtel/jrest/log chown -R jtel:jtel jrest cp jrest/systemd/jrest.service /etc/systemd/system chmod +x /home/jtel/jrest/systemd/jrest systemctl daemon-reload systemctl enable jrest.service

Configuration

Modifiez le fichier de configuration configuration /home/jtel/jrest/config/jtel-jrest.xml et vérifiez que les mots de passe d'accès à la base de données et les hôtes, etc. sont corrects.

Note : le serverID doit être unique pour chaque serveur.

Modifiez le fichier de démarrage /etc/init.d/jrestjrest  et vérifiez que le répertoire java est correct (la bonne version java).

Modifier le fichier de configuration de l'enregistrement /home/jtel/jrest/config/log4j2.xml et assurez-vous qu'il pointe vers le répertoire d'enregistrement requis.

Pare-feu

Ouvrez le port 8091 du pare-feu comme suit :

firewall-cmd --zone=public --add-port=8091/tcp --permanent firewall-cmd --reload

Démarrer le service

Démarrez le service. 

systemctl start jrest.service

Installation - sur Windows Server

Pour installer le rôle REST sur le serveur Windows, procédez comme suit.

Java 12

Télécharger java 12 ici:

https://cdn.jtel.de/downloads/java/openjdk-12.0.2_windows-x64_bin.zip

Décompressez le tout dans le répertoire suivant :

c:\Apps\

Cela devrait aboutir à la création de la structure de répertoire suivante :

C:\Apps\openjdk-12.0.2_windows-x64_bin\jdk-12.0.2\bin 

Copier les fichiers and Installer

Sur le serveur Windows, exécutez les commandes suivantes dans une invite de commande non levée :

c: md \JRest xcopy /E \\acd-store\shared\jtel-system-java-services\deploy\jrest C:\JRest

Configuration

Edit the configuration file, and make sure the database access (username and password) est correcte :

C:\JRest\config\jtel-jrest.xml

Raccourci

Créer un raccourci pour start-jrest.cmd et mettre cela dans shell:startup

Configurer l'équilibreur de charge

Il est préférable d'envoyer les demandes de l'API REST à l'équilibreur de charge. Pour cela, il faut ajouter les éléments suivants à la configuration de l'équilibreur de charge.

Frontend http / https

Selon le protocole utilisé, il est possible de configurer soit http soit https. Dans le front-end correspondant, il convient d'ajouter ce qui suit :

# ADD THIS WHERE THE acls are: acl rest_req url_reg ^\/rest\/v1.0 # ADD THIS WHERE THE use_backend directives are: use_backend jtel_rest if rest_req # ADD THIS AT THE BOTTOM: #--------------------------------------------------------------------- # this backend provides access to the REST API #--------------------------------------------------------------------- backend jtel_rest mode http compression algo gzip compression type text/xml text/html text/plain text/css text/javascript balance leastconn # roundrobin stick-table type ip size 20k stick on src server acd-tel1 acd-tel1:8091 weight 1 cookie jboss1 check inter 1m

Recharger l'équilibreur de charge

Rechargez l'équilibreur de charge :

systemctl reload haproxy

Configurer le pare-feu Windows

Dans une invite de commande élevée sur le serveur Windows :

netsh advfirewall firewall add rule name="JREST" dir=in action=allow protocol=TCP localport=8091 edge=no

Démarrer le serveur REST

Démarrez le serveur de repos sur la machine Windows avec le raccourci.