Inhalt

1. Systemvoraussetzung erfüllt?

• Java ist installiert?
• Tomcat ist installiert und eingerichtet?
• Tomcat wurde erfolgreich gestartet und ist erreichbar?
• Datenbanktreiber im "lib" Verzeichnis bereitgestellt?
• Die Datenbank wurde eingerichtet?

2. Installation der formcycle.war

Installation über Apache Tomcat-Manager

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

1. Starten Sie Apache Tomcat.
2. Rufen Sie den Tomcat-Manager auf und melden Sie sich ggf. mit den dazugehörigen Daten 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 formcycle.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 Server sowie eine Meldung ähnlich der folgenden: OK - Deployed application at context path /formcycle.

Sollten eine Fehlermeldung des Typs SizeLimitExceededException erscheinen, so muss die maximale Uploadgröße des Managers in dessen web.xml entsprechend der Größe der formcycle.war angepasst werden. Siehe hierzu die Tomcat-Dokumentation und den Bereich Beschränkung der Uploadgröße ändern.

Weiter geht es mit der initialen Konfiguration.

Manuelle Installation der war-Datei

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

1. Kopieren Sie die mitgelieferte Datei formcycle.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

Weiter geht es mit der initialen Konfiguration.

3. Initiale Konfiguration von formcycle

Warnung

Das initiale Passwort für den Systemadministrator (Nutzername sadmin und Passwort admin) sollte sofort nach der ersten Anmeldung geändert werden!

Nach der Installation von formcycle muss das System erst konfiguriert werden, bevor es in Betrieb genommen werden kann. Die nötigen Einstellungen werden über den Web-Browser vorgenommen. Die Administrationsoberfläche findet sich unter folgender URL, falls die Standardeinstellungen nicht geändert wurden:

http://servername:port/formcycle/

Für den Systemadministrator lautet der Benutzername sadmin und das Passwort admin an.

Loginversuche

Aus Gründen der Sicherheit wird ein Nutzer gesperrt, wenn dieser zu oft das falsche Passwort eingibt. Standardmäßig kann ein Nutzer sich fünfmal erfolglos anmelden, bevor er für 15 Minuten gesperrt wird. Erst dann sind weitere Anmeldeversuche möglich. Diese Werte können bei Bedarf geändert werden.

4. Datenbankverbindung einrichten

Es muss der entsprechende Datenbanktreiber installiert sein. Danach kann die Datenbankverbindung konfiguriert werden, siehe Datenbank.

5. Bereitstellen der Lizenz

Siehe Lizenz

6. E-Mail-Server einrichten

Um den ersten Mandanten zu erstellen, muss zunächst der E-Mail-Server eingerichtet werden, damit die Einladungs-E-Mail für den Mandanten empfangen werden kann. Für weitere Hinweise siehe E-Mail-Server.

7. Ersten Mandant anlegen

Siehe Mandanten

8. Anwendungseinstellungen anpassen

Diese haben alle Standardwerte und müssen nur bei Bedarf geändert werden. Siehe Anwendungseinstellungen