SKOOR Webservice Installation
Voraussetzungen
- SKOOR RPM- Repository ist verfügbar
Installation
Installieren Sie das eranger-webservice-Paket aus dem SKOOR-Repository:
# yum install eranger-webservice
eranger-jre and eranger-phantomjs will be installed as dependent packages.
Das Paket wird die folgenden Änderungen am System vornehmen:
- Installieren Sie SKOOR Webservice im Verzeichnis /opt/eranger/eranger-webservice (Spring Boot App)
- Konfigurieren Sie den Dienst, einschließlich des automatischen Starts beim Booten
- Erstellen Sie die Webdienstkonfiguration in /etc/opt/eranger/eranger-webservice.cfg
- Erstellen Sie die Reverse-Proxy-Konfiguration in /etc/httpd/conf.d/eranger-webservice-proxy.conf
/eranger-webservice -> http://localhost:8090/ - Konfigurieren Sie die Protokollrotation in /etc/logrotate.d/eranger-webservice.conf
- Starten Sie den Webdienst
- Laden Sie die Apache-Konfiguration neu
Dienst starten / stoppen / neu starten /status
Der eRanger Webservice ist als Linux-Dienst konfiguriert und kann mit den entsprechenden Befehlen verwaltet werden:
# service eranger-webservice start # service eranger-webservice stop # service eranger-webservice restart # service eranger-webservice status
oder
# systemctl start eranger-webservice # systemctl stop eranger-webservice # systemctl restart eranger-webservice # systemctl status eranger-webservice
Benutzerdefinierte Konfiguration
Die Standardkonfiguration sollte ohne Änderungen sofort einsatzbereit sein.
Folgende Änderungen können bei Bedarf vorgenommen werden:
Tomcat-Port
Sollte der Standardport 8090 nicht verfügbar sein, kann dieser in der Datei „/opt/eranger/eranger-webservice/eranger-webservice.conf“ geändert werden:
# 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
Derselbe Port muss in der Reverse-Proxy-Konfiguration in "/etc/httpd/conf.d/eranger-webservice-proxy.conf" konfiguriert werden:
# 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>
Protokoll- und PID-Datei
In der Standardkonfiguration wird eine PID-Datei nach "/var/opt/run/eranger" und die Log-Datei nach "/var/log/eranger/eranger-webservice.log" geschrieben.
Werden andere Pfade bevorzugt, können diese in der Datei „/opt/eranger/eranger-webservice/eranger-webservice.conf“ konfiguriert werden.
# 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 LOG_FOLDER=/new/log/path LOG_FILENAME=new-name.log
Wenn der Log-Ordner geändert wurde, ändern Sie bitte auch die Logrotate-Konfiguration
/new/log/path/new-name.log { rotate 30 daily nodateext create 0640 eranger eranger missingok copytruncate }
Mehrere Mandanten
Der Webservice ist in der Lage, Daten von mehreren SKOOR Engine -Backends unter Verwendung der tenantId abzurufen.
Um zusätzliche Backends zu konfigurieren, muss man einen separaten eranger-webservice-
# eRanger Server Address eranger.address=<host of Skoor server>
Sie müssen files.root oder reviews.root nicht ändern. Der Webserver übernimmt die Trennung dieser Ordner selbst.
Nachdem die Konfiguration gespeichert wurde, sollten Sie in der Lage sein, Daten von der konfigurierten SKOOR Engine , indem Sie entweder den HTTP-Anforderungsheader X-Tenant-Id oder den URL-Parameter tenantId angeben.