Conditions préalables

• Le référentiel SKOOR RPM est disponible

Installation

Installez le package eranger-webservice à partir du référentiel SKOOR :

# yum install eranger-webservice

eranger-jre and eranger-phantomjs will be installed as dependent packages.

Le paquet apportera les modifications suivantes au système :

1. Installez SKOOR Webservice dans le répertoire /opt/eranger/eranger-webservice (Spring Boot App)
2. Configurer le service, y compris le démarrage automatique au démarrage
3. Créez la configuration du service Web dans /etc/opt/eranger/eranger-webservice.cfg
4. Créez une configuration de proxy inverse dans /etc/httpd/conf.d/eranger-webservice-proxy.conf
   /eranger-webservice -> http://localhost:8090/
5. Configurez la rotation des journaux dans /etc/logrotate.d/eranger-webservice.conf
6. Démarrer le service Web
7. Recharger la configuration Apache

Service démarrage/arrêt/redémarrage/état

Le Webservice eRanger est configuré comme un service Linux et peut être géré avec les commandes respectives :

# service eranger-webservice start
# service eranger-webservice stop
# service eranger-webservice restart
# service eranger-webservice status

ou

# systemctl start eranger-webservice
# systemctl stop eranger-webservice
# systemctl restart eranger-webservice
# systemctl status eranger-webservice

Paramétrage personnalisé

La configuration standard devrait être prête à l'emploi sans aucun changement.

Les modifications suivantes peuvent être effectuées si nécessaire :

Port Tomcat

Si le port standard 8090 n'est pas disponible, il peut être changé dans le fichier "/opt/eranger/eranger-webservice/eranger-webservice.conf":

# Spring Boot service config file
# Has to be in the same directory as the JAR file
MODE=service
JAVA_HOME=/opt/eranger/eranger-jre/current
APP_NAME=eranger-webservice
JAVA_OPTS="-Dserver.port=8091"
PID_FOLDER=/var/opt/run/eranger
LOG_FOLDER=/var/log/eranger
LOG_FILENAME=eranger-webservice.log

Le même port doit être configuré dans la configuration du reverse proxy dans "/etc/httpd/conf.d/eranger-webservice-proxy.conf":

# mod_proxy setup for using httpd as a reverse proxy for tomcat
# has to placed in /etc/httpd/conf.d
ProxyPass /eranger-webservice http://localhost:8091/
ProxyPassReverse /eranger-webservice http://localhost:8091/
<Location "/eranger-webservice">
  setOutputFilter DEFLATE
  Require all granted
  Satisfy Any
  Order allow,deny
  Allow from all
</Location>

Fichier PID

Dans la configuration par défaut, un fichier PID est écrit dans "/var/opt/run/eranger".

Si un chemin différent est préféré, il peut être configuré dans le fichier "/opt/eranger/eranger-webservice/eranger-webservice.conf".

# Spring Boot service config file
# Has to be in the same directory as the JAR file
MODE=service
JAVA_HOME=/opt/eranger/eranger-jre/current
APP_NAME=eranger-webservice
JAVA_OPTS="-Dserver.port=8091"
PID_FOLDER=/new/pid/path

Locations multiples

Le service Web est capable d'obtenir des données de plusieurs backends SKOOR Engine à l'aide du tenantId.

Pour configurer des backends supplémentaires, il faut fournir un eranger-webservice- Fichier de configuration .cfg dans le dossier /etc/opt/eranger. Ce fichier est essentiellement une copie du fichier eranger-webservice.cfg par défaut avec une adresse eranger spécifique au tenanc.

# eRanger Server Address
eranger.address=<host of Skoor server>

Une fois la configuration enregistrée, vous devriez pouvoir récupérer les données du SKOOR Engine configuré en fournissant soit l'en-tête de requête HTTP X-Tenant-Id, soit le paramètre d'URl tenantId.