This section provides information relevant to the installation of Xima® Formcycle.

On the corresponding subpages you will find, among other things, information about the system requirements and instructions for updating an existing installation of Xima® Formcycle.


Installing Xima® Formcycle

In case it has not been done already, the Tomcat settings should be set appropriately, such as the character encoding to UTF-8. More details on which settings should be changed are available in the section on Tomcat settings.

When configuring the application server, note that Xima® Formcycle does not support HTTP/2 at the moment.

Install database driver

Xima® Formcycle does not ship any database driver anymore. You need to install the required database driver yourself.

Installing with Apache Tomcat manager

The following steps describe how to install Xima® Formcycle with the Apache Tomcat web container 8.0 (with installed manager application). For other Java web containers or application server, consult the installation instruction of the corresponding documentation or help pages.

  1. Start Apache Tomcat.
  2. Open the Tomcat manager and sign in with your account, if necessary.
  3. Go to the section named Select WAR file to upload. Click on browse and choose the formcycle.war file from you local file system. Upload the application by clicking on deploy.
  4. Once the installation has completed successfully, the entry xima formcycle server will appear in the list of installed applications. A success message similar to the following should be displayed: OK - Deployed application at context path /formcycle.

In case the installation should fail with the error message SizeLimitExceededException, the  upload file size limit of the Tomcat manager must be increased in the web.xml configuration file.

Continue with the initial configuration.

Installing the WAR file manually

To install the WAR file manually, copy the formcycle.war to the webapps directory of the Tomcat web container.

  1. Copy the formcycle.war to the webapps directory of the Tomcat web container. 
  2. Restart the Tomcat application server.
  3. Tomcat will unpack the WAR file automatically on startup, completing the installation.

Continue with the initial configuration.