Installing a frontend server


A frontend server is optional and is responsible for serving forms to users. There are several reason to setup a frontend server, including:

  • Isolate the intranet with Xima® Formcycle backend from the internet.
  • Load balancing. But note that all the form data is still processed on the master server.

Requirements

To use a frontend server, make sure that:

  • a master server was installed successfully and has got a license that allows for frontend servers
  • the master can access the frontend server via the network. Also make sure that the port is open (default port is 4753).

Step 1: Install the frontend server

If you are using Tomcat, make sure you configured it properly. In particular, the encoding should be set to UTF-8. See also Tomcat settings.

The following describes the installation for the application server Apache Tomcat. If you are using another application server, refer to the corresponding documentation of that server.

Using the Apache Tomcat manager

  1. Start Apache Tomcat.
  2. Invoke the Tomcat manager and login with the corresponding data, if neccessary. 
  3. In the surface of the Tomcat manager you can find the section Upload local War file for installation. Choose the installation file frontend-server.war on your local system via the button searching... Afterwards approve the selection via the button install below the textfield. 
  4. After the successful installation, the entry xima formcycle frontend-server in the table application and a report similar to the following:
OK - Deployed application at context path /frontend-server

If an error message shows up that reads SizeLimitExceededException, the maximum upload size of the manager must be adjusted in the web.xml. See also the Tomcat documentation and the help pages on Tomcat settings.

Manual installation

You can also install the frontend server manually. Just copy the file frontend-server.war to the webapp directory. You can find this directory inside the folder where Tomcat is installed.

  1. Copy the provided file frontend-server.war to the directory webapps
  2. Restart the Appache Tomcat application server
  3. Tomcat unpacks the war file, completing the installation

Test the installation

Go to the Url http://meinServer/frontend-server. An HTML page with the current status of the connection should be displayed.

The status page of the frontend server. The logical_status is either NOT_CONNECTED or WAIT_FOR_CONNECTION.

Step 2: Connect the master server to the frontend server

To use the frontend server, you first need to configure it in the system menu.

Login as the system administrator (username sadmin). Go to the system menu frontend server and add a new frontend server. See the help pages on the frontend server menu for futher details.

Now the system can connect to the frontend server. To use it with a form, you first need to allow the client of that form access to the frontend server.

Step 3: Allow access to the frontend server for a client

By default, no client is granted access to the frontend server. You need to explicitly allow them access to the frontend server.

Now you need to grant a client access to the frontend server. Log in as a client administrator. Go to frontend server menu and configure the frontend server connection. For more details, see the help pages on the frontend server menu.

Step 4: Setup an encrypted communication

Encrypt the communication between the master server and the frontend server via SSL.
  1. Create a new keystore (type: JKS) with a key pair. For example, keystore name: fs.keystore) There are several tools available for creating the keystore, such as the freely available KeyStore Explorer tool.
  2. Export the certificate chain, based on the generated key pair. Import the certificate into a new keystore (type: JKS). For example, keystore name: ms.keystore
  3. Put the keystore (fs.keystore) with the key pair in the configuration directory of the frontend server.
  4. On the frontend server, open the file application.properties (this is created automatically after installation) and add or edit the following entries:
    fs.settings.authKey=...
    fs.settings.port=...
    fs.settings.ssl.use=true
    fs.settings.ssl.keystore.path=<Pfad zum Keystore>\\fs.keystore
    fs.settings.ssl.keystore.pass=<Keystore Passwort>
  5. Restart the frontend server
  6. Storing the keystore key certificate (ms.keystore) in the configuration directory of master server
  7. Customizing the frontend server configuration on the master server
  8. Check the connection