Installation eines Frontend-Servers

Inhalt [ Verbergen ]

Ein Frontend-Server ist optional und verantwortlich für das Ausliefern und Entgegennehmen von Formularen. Es gibt verschiedene Gründe, einen Frontend-Server einzusetzten, unter anderem:

  • Zur Isolation des Internets vom internen Intranets mit dem Backend von Xima® Formcycle
  • Zur Lastenverteilung. Hier muss aber beachtet werden, dass die gesamte Verarbeitung von Formulardaten weiterhin auf dem Master-Server geschieht.

Voraussetzung

Bevor ein Frontend-Server installiert wird, sollte geprüft werden, dass

  • ein Master-Server installiert und über eine Lizenz verfügt, die Frontend-Server erlaubt.
  • der Master-Server über das Netzwerk auf den Frontend-Server zugreifen kann und auch der entsprechende Port freigegeben ist (Standardport ist 4753).

Schritt 1: Installation des Frontend-Servers

Falls noch nicht geschehen, sollten die Einstellungen vom Tomcat entsprechend konfiguriert werden. Insbesondere sollte der Zeichensatz auf UTF-8 eingestellt werden. Weitere Informationen hierzu sind im Abschnitt Tomcat-Einstellungen zu finden.

Nachfolgend wird die Installation beispielhaft für den Web-Container Apache Tomcat beschrieben. Erfolgt die Installation auf einem anderen Java Web-Container/Applikationsserver, sind die Installationsschritte der zugehörigen Dokumentation zu entnehmen.

Installation über Apache Tomcat-Manager

  1. Starten Sie Apache Tomcat.
  2. Rufen Sie den Tomcat-Manager auf und melden Sie sich bei Bedarf an. 
  3. In der Oberfläche des Tomcat-Managers finden Sie den Bereich Lokale War Datei zur Installation hochladen. Wählen Sie über den Button Durchsuchen… die Installationsdatei frontend-server.war auf Ihrem lokalen System. Bestätigen Sie anschließend die Auswahl über den Button Installieren unterhalb des Eingabefeldes.
  4. Nach der erfolgreichen Installation erscheint in der Tabelle Anwendungen der Eintrag xima formcycle Frontend-Server sowie eine Meldung ähnlich der folgenden:
OK - Deployed application at context path /frontend-server

Sollte eine Fehlermeldung des Typs SizeLimitExceededException erscheinen, so muss die maximale Uploadgröße des Managers in dessen web.xml entsprechend der Größe der frontend-server.war angepasst werden. Siehe hierzu die Tomcat-Dokumentation und den Bereich Tomcat-Einstellungen.

Manuelle Installation der war-Datei

Die Installation erfolgt durch Kopieren der Datei frontend-server.war in die vorgegebene Verzeichnisstruktur des Tomcat-Webcontainers.

  1. Kopieren Sie die mitgelieferte Datei frontend-server.war in das Verzeichnis webapps des Tomcat-Webcontainers
  2. Starten Sie den Apache-Tomcat Applikationsserver bzw. den Context ggf. neu.
  3. Die Installation ist abgeschlossen

Testen der Installation

Entweder ist der logical_status NOT_CONNECTED oder WAIT_FOR_CONNECTION

Rufen Sie die URL http://meinServer/frontend-server auf. Es sollte eine HTML Seite mit dem aktuellen Status der Verbindung angezeigt werden.

Schritt 2: Verbindung herstellen zwischen Frontend- und Master-Server

Einrichten einer Verbindung zum Frontend-Servers.

Melden Sie sich auf dem Master-Server als Systemadministrator (Nutzername sadmin) an. Wechseln Sie in das Navigationsmenü des Master-Servers zum Punkt Frontend-Server unter System. Konfigurieren Sie den Frontend-Server entsprechend der Anleitung unter Frontend-Server-Menü.

In diesem Schritt wurde die technische Verbindung hergestellt. Das bedeutet, dass der Master-Server und der Frontend-Server nun untereinander kommunizieren können. Im nächsten Schritt wird die Bereitstellung dieser Verbindung für den jeweiligen Mandanten konfiguriert.

Schritt 3: Freigeben des Frontend-Servers für einen Mandanten

Freigeben eines Frontend-Servers für einen bestimmten Mandanten.

Nun muss der Frontend-Server noch für den Mandanten freigegeben werden. Melden Sie sich hierzu als Mandantadministrator an. Wechseln Sie im Navigationsmenü zum Punkt Frontend-Server und konfigurieren Sie die Frontend-Server-Verbindung entsprechend der Anleitung unter Frontend-Server.

Kommunikation zwischen Master- und Frontend-Server verschlüsseln

Einrichten der SSL-Kommunikation auf dem Master-Server.
  1. Einen neuen Keystore (Typ: JKS) mit einem Schlüsselpaar erzeugen. Zum Beispiel mit den Namen fs.keystore. Die Erzeugung des Keystores kann etwa mit dem frei erhältlichen Tool KeyStore Explorer erfolgen. Passwort für Schlüssel und Keystore müssen identisch sein.
  2. Zertifikatskette (auf Grundlage des erzeugten Schlüsselpaares) exportieren und in einen neuen Keystore (Typ: JKS) importieren. Zum Beispiel mit dem Namen ms.keystore.
  3. Den Keystore (fs.keystore) mit dem Schlüsselpaar im Konfigurationsverzeichnis des Frontend-Servers ablegen.
  4. Anpassen der Datei application.properties (diese wird automatisch nach Installation angelegt) in dem gleichen Verzeichnis auf dem Frontend-Server:
    fs.settings.authKey=...
    fs.settings.port=...
    fs.settings.ssl.use=true
    fs.settings.ssl.keystore.path=<Pfad zum Keystore>\\fs.keystore
    fs.settings.ssl.keystore.pass=<Keystore Passwort>
  5. Frontend-Server neu starten
  6. Ablage des Keystores Schlüsselzertifikats ms.keystore im Konfigurationsverzeichnis vom Master-Server
  7. Anpassung der Frontend-Server-Konfiguration auf dem Master-Server unter System > Frontend-Server
  8. Testen der Verbindung