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 formcycle innerhalb der Log-Dateien ein entsprechender Eintrag ausgegeben:

[main] (XfcConfig.java:433) -  ==> Data-folder set to '/tmp/xima/formcycle'
[main] (XfcConfig.java:434) -  ==> Configuration-folder set to '/home/tomcat/xima/formcycle/config'

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 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 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 formcycle bestehen bleibt. Sollten nicht mehrere formcycle-Instanzen auf dem selben Server betrieben werden wird diese Datei empfohlen.

Alternativ können die Verzeichnisse auch über einen Umgebungsvariable oder eine System-Property der JVM geändert werden. Die Namen hierfür sind die gleichen wie die Kontextparameter.

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 FORMCYCLE eintragen. Beispielhaft könnte eine Konfigurationsdatei wie folgt aussehen:

<Context>
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
    <Parameter name="XFC_CONFIG_DIR" value="C:\formcycle\config" override="true"/>
    <Parameter name="XFC_DATA_DIR" value="C:\formcycle\data" override="true"/>
</Context>

• XFC_CONFIG_DIR
  Verzeichnis, in dem Konfigurationsdateien von formcycle wie z.B. application.properties (Anwendungseinstellungen), logging.properties, fcmLizenz.lic (Lizenzdatei) 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.
• XFC_TEMP_DIR
  Verzeichnis für temporäre Dateien.
• XFC_SCAN_DIR
  Verzeichnis, in dem Dateien temporär für den Virenscan abgelegt werden.
• XFC_PLUGIN_DIR
  Verzeichnis, in dem Plugins und Plugin-Konfigurationsdateien abgelegt werden.
• XFC_CACHE_DIR
  Verzeichnis, in dem Cache-Dateien abgelegt werden.