SKOOR Webservice
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 :
- Installez SKOOR Webservice dans le répertoire /opt/eranger/eranger-webservice (Spring Boot App)
- Configurer le service, y compris le démarrage automatique au démarrage
- Créez la configuration du service Web dans /etc/opt/eranger/eranger-webservice.cfg
- Créez une configuration de proxy inverse dans /etc/httpd/conf.d/eranger-webservice-proxy.conf
/eranger-webservice -> http://localhost:8090/ - Configurez la rotation des journaux dans /etc/logrotate.d/eranger-webservice.conf
- Démarrer le service Web
- 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-
# eRanger Server Address eranger.address=<host of Skoor server>
Vous n'avez pas besoin de modifier files.root ou reports.root . Le serveur Web gère lui-même la séparation de ces dossiers.
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.