Changing the data directory

By default, all data and internal configuration files are saved to the default Tomcat directory or a temporary system directory. When you need to change the directory, for example to a different partition or hard drive, the following settings need to be modified.

Creating or finding the configuration file

You can change the settings in one of following three configuration files:

• TOMCAT_DIRECTORY/webapps/FORMCYCLE_CONTEXT_NAME/WEB-INF/web.xml 
  eg. /home/tomcat/apache-tomcat-8.5.11/webapps/formcycle-tc8/WEB-INF/web.xml. The relevant settings are already in this file and commented out. This configuration file is local to the FORMCYCLE installation and is not modified when updating Tomcat.
• TOMCAT_DIRECTORY/conf/Catalina/localhost/formcycle.xml 
  If this file does not yet exist, it must be created.
• TOMCAT_DIRECTORY/conf/context.xml
  In case you have already applied the modifications as described at Using formcycle with the root domain, modify the file  ROOT.xml instead.

Alternatively, you can also change the directories via environment variables of system properties of the JVM. The names are the same as the context parameters.

Editing the configuration file

Add two Parameter entries to the context containing the path to the data and configuration directory to be used by formcycle.

The configuration file might look like this:

<Context>
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
    <Parameter name="XFC_CONFIG_DIR" value="/home/fc/config" override="true"/>
    <Parameter name="XFC_DATA_DIR" value="/home/fc/data" override="true"/>
</Context>

• XFC_CONFIG_DIR
  Directory containing the formcycle's configuration files, such as the application settings application.properties , the logging settings  logging.properties, the license fcmLizenz.lic, or the LDAP settings ldapauth.properties.
• XFC_DATA_DIR
  Directory containing temporary files such as uploaded files or files created by actions during workflow processing.
• XFC_TEMP_DIR
  Directory for temporary files.
• XFC_SCAN_DIR
  Directory for storing files temporarily when a malware scan is performed.
• XFC_PLUGIN_DIR
  Directory for plugins and plugin configuration files.
• XFC_CACHE_DIR
  Directory for cache files.