Datenverzeichnisse von FORMCYCLE

Standard-Verzeichnisse

Standardmäßig werden Daten und interne Konfigurationsdateien im Benutzerverzeichnis des Benutzers welcher den Tomcat-Server startet abgelegt. Da sich diese je nach Betriebssystem und Benutzer stark unterscheiden können, gibt es zwei Möglichkeiten diese im zu ermitteln. Zum einen wird beim Start von Xima® Formcycle innerhalb der Log-Dateien ein entsprechender Eintrag ausgegeben:

Die zweite Möglichkeit ist das Ablesen der verwendeten Verzeichnisse innerhalb der Verwaltungsoberfläche unter dem Punkt System -> Serverinformationen:

Ändern des Daten- und Konfigurationsverzeichnisses

Falls die standardmäßig verwendeten Verzeichnisse geändert werden sollen um dies zum Beispiel auf eine andere Partition zu speichern, sind folgende Änderungen der Konfiguration notwendig.

Anlegen bzw. Auffinden der Konfigurationsdatei

Die Einstellungen können in einer von drei Konfigurationsdateien eingetragen werden:

• TOMCAT_VERZEICHNIS/webapps/FORMCYCLE_CONTEXT_NAME/WEB-INF/web.xml, z.B. /home/tomcat/apache-tomcat-8.5.11/webapps/formcycle-tc8/WEB-INF/web.xml. Hier sind die Einstellungen bereits auskommentiert und beschrieben hinterlegt. Da es sich bei dieser Datei um die Konfiguration direkt innerhalb der Anwendung handelt, geht diese beim Einspielen einer neuen Xima® Formcycle verloren.
• TOMCAT_VERZEICHNIS/conf/Catalina/localhost/formcycle.xml Falls diese Datei noch nicht existiert, kann diese manuell angelegt werden. Diese gilt hierbei lediglich für den Anwendung mit dem zugehörigen Namen und bleibt bei Updates von Xima® Formcycle bestehen. Falls Sie die Änderungen wie im Abschnitt Formcycle von Root-Domain aufrufen vorgenommen haben, nehmen Sie die Änderungen stattdessen an der Datei ROOT.xml vor.
• TOMCAT_VERZEICHNIS/conf/context.xml Hierbei handelt es sich um eine Server-weite Datei welche ebenso beim Update von Xima® Formcycle bestehen bleibt. Sollten nicht mehrere Xima® Formcycle-Instanzen auf dem selben Server betrieben werden wird diese Datei empfohlen.

Bearbeiten der Konfigurationsdatei

Fügen Sie in der Konfigurationsdatei zwei Parameter-Einträge hinzu, wo Sie die gewünschten Pfade für das Verzeichnis von Dateien von Xima® Formcycle eintragen. Beispielhaft könnte eine Konfigurationsdatei wie folgt aussehen:

• XFC_CONFIG_DIR
  Verzeichnis, in dem Konfigurationsdateien von Xima® Formcycle wie z.B. application.properties (Anwendungseinstellungen), logging.properties oder ldapauth.properties gespeichert werden.
• XFC_DATA_DIR
  Verzeichnis, in dem Daten wie z.B. hochgeladene oder durch Aktionen erzeugte Dateien temporär gespeichert werden.