IES-Webnode
Ab IES Version 2.5 verfügbar
Der IES-Webnode ist ein Java-Applikations-Server auf Basis des Jetty 9. Er wird auf Web-Servern installiert, die vom IES generierte Webseiten ausliefern. Innerhalb des IES-Webnode werden Module installiert, die Funktionalitäten für die Webseite bereite stellen (Z.B. Volltextsuche).
Systemvoraussetzungen
- Java Platform, Standard Edition JDK - Version 7
- Der IES muss den Server auf dem der IES-Webnode installiert wird per HTTP(S) erreichen können.
- Hardware-Anforderungen sind je nach Anwendungsfall zu prüfen.
Installation
Installation unter Linux
Die Installations-Datei für den IES-Webnode wird mit dem IES mitgeliefert. In dem Verzeichnis IES_HOME/bin liegt die Datei
ies-webnode-server.bin
Diese muss auf das Linux-System kopiert werden, auf dem sich die Webseite befindet, die den IES-Webnode benötigt. Für die Installation vergeben Sie noch die nötigen Ausführungsrechte und führen das Installations-Script anschließend aus:
chmod a+x ies-webnode-server.bin ./ies-webnode-server.bin
Befolgen Sie die Anweisungen.
Das Installations-Script führt folgende Schritte aus:
- Es wird einen Nutzer und eine Gruppe
ies-webnodeangelegt - Es wird ein init-Script unter
/etc/init.d/ies-webnodeabgelegt. - Es wird eine Konfigurations-Datei für das init-Script angelegt:
- bei systemd-Systemen unter /etc/sysconfig/ies-webnode
- bei init-v-Systemen unter /etc/default/ies-webnode
- In dieser Datei können die Start-Optionen für den IES-Webnode angepasst werden (z.B.
JAVA_OPTIONS="-server -Xms512m -Xmx2048m -Xss8m").
- Der Server wird unterhalb des angegebenen Installations-Verzeichnisses (Standardverzeichnis:
/srv/sitepark/ies-webnode) installiert.
Apache Integration
<VirtualHost *:443>
...
ProxyRequests Off
ProxyPreserveHost On
ProxyTimeout 3600
<Proxy balancer://ies-webnode-balancer>
Order Deny,Allow
Allow from All
BalancerMember http://localhost:8381
</Proxy>
ProxyPassMatch ^(/ies-webnode/.*)$ balancer://ies-webnode-balancer$1
...
</VirtualHost>
IES-Konfiguration
Wenn der IES-Webnode auf dem Webserver installiert ist, muss die Verbindung für den IES über die Administrations-Oberfläche konfiguriert werden. Bei den Servereinstellungen erscheint der Menüpunkt 'Webnode'. Erstellen Sie hier einen neuen Eintrag und vergeben einen sprechenden Namen. die Basis URL des Webnodes ist der Host (oder IP-Adress) des Server, auf dem der Webnode installiert wurde. Sollte keine Apache-Einbindung konfiguriert sein, muss hier der Port (default 8381) ergänzt werden (Beispiel: http://my.webnode.de:8381/). Das Passwort wurde bei der Installation automatisch vergeben und befindet sich in der Datei [WEBNODE_HOME]/config/realm.properties (Beispiel: "api: 123456789abcdef, api" => Login 'api' Passwd: '123456789abcdef')
/etc/defaults/ies-webnode
IES_JAVA_OPTIONS
Java Optionen die mit -D angegeben werden
Chunked transfer encoding für die Kommunikation vom IES z.b. zum IES-Webnode deaktivieren. Dies ist in der Regel nur dann notwendig, wenn die Kommunikation über einen Proxy läuft und dieser Chunked transfer encoding via POST nicht unterstütz (sehr alte Proxies)
com.sitepark.net.HttpClient.disableChunked=true
Updates
Der IES-Webnode ist aus IES-Sicht ein IES-Modul und wird auch so wie alle anderen IES-Module über die IES-Admin Oberfläche aktualisiert. Die Update-Dateien werden vom IES-Admin vom zentralen Update-Server von Sitepark herunter geladen und auf die IES-Webnodes verteilt. Das Update auf den einzelnen IES-Webnodes muss dann allerdings manuell ausgeführt werden. Ob ein Update auf den IES-Webnodes zur Ausführung bereit steht kann innerhalb des IES-Admin im Bereich 'Webnode' nachgesehen werden.
Linux
Steht ein Update die IES-Webnode zur Verfügung kann das Update wie folgt ausgeführt werden
/etc/init.d/ies-webnode stop /etc/init.d/ies-webnode update /etc/init.d/ies-webnode start
Status abfragen
Der Webnode kann einen Status-Bericht zum eigenen Prozess und zu den verwalteten Publishern liefern. Hierzu werden Anfragen und Antworten per JSON generiert. Der Kommunikationsaufruf ist dabei i.d.R. folgender:
- Aufruf des Publisher-Status in IES-Admin im Browser -> HTTPS-Request vom Nutzer an den IES
- IES stellt Anfrage an den Webnode des Publishers -> HTTPS-Request an den Webserver auf dem der Webnode installiert wurde (ggf. auch direkt auf Port 8381)
- Webserver leitet Anfrage via Proxy-Request an den lokalen Webnode-Prozess -> HTTP-Request an Webnode
- Webnode erstellt HTTPS-Anfrage an ein PHP-Script im Publisher -> HTTPS-Request an den lokalen Webserver
Der Python-Aufruf am Ende der Aufrufe (s.u.) sorgt für eine lesbare Darstellung der JSON-Daten. Alternativ kann auch jq verwendet werden.
Ein aktuell typisches Problem ist die Problematik von Apache 2.4 und PHP-FPM (Fast.CGI). Hier ist Chunked-Transfer-Encoding nicht möglich. Dies muss in den Setzungen des Webnode über -Dcom.sitepark.net.HttpClient.disableChunked=true in den Java-Optionen deaktiviert werden.
Webnode-Status
Den Status des Webnode kann man auf dem lokalen System über folgenden curl-Aufruf abfragen:
curl -s "http://api:XXX@localhost:8381/ies-webnode/admin/rpc/?rpcAction=Server&rpcMethod=getStatus" | python -m json.tool
Die Authentifizierung erfolgt über die URL. Der Login ist api. Dass Passwort ist Ihr API-Key.
Diesen können Sie der Datei realm-properties im Installationsverzeichnis des Webnode entnehmen.
Publisher-Status
Aufruf des Webnodes durch den IES (im Fall einer lokalen Installation):
curl -s "http://api:XXX@localhost:8381/ies-webnode/admin/rpc/?rpcAction=WebChannel&rpcMethod=getStatus&protocol=https&host=hostname" | python -m json.tool
Die Authentifizierung erfolgt über die URL. Der Login ist api. Dass Passwort ist Ihr API-Key.
URL für Request des Webnodes auf den Publisher:
curl -k "https://api:XXX@hostname/WEB-IES/sitekit-module/php/SP/SiteKit/Rpc/Server/Port.php?rpcAction=SP\\SiteKit\\Rpc\\WebChannel\\Info&rpcMethod=getInfo" | python -m json.tool
Der Parameter Host ist der Domain-Name des Publisher.
ngrep untersucht werden.