Installation - Update 

Page / - last modified by sas on 19.05.2021, 16:22 

Update 
last modified by sas
on 19.05.2021, 16:22

Table of Contents
Step 1: Download the current version
Step 2: Replace the old version
Step 3: Database update
Notice Update Frontend Server

Content [ Hide ] 
•	Step 1: Download the current version
•	Step 2: Replace the old version
•	Step 3: Database update
•	Notice Update Frontend Server
 
When an update of the system or the database is required, you will see a notification on the login screen.
 
After you sign in, you are taken to the database settings. Check if they are still correct.
 
After you have checked the database settings, the system performs all necessary updates.
 
The update is done once all required updates have finished.
Before you install an update, make sure you check out the release notes
We recommend you take a backup of the database and all local data before you install the update.
For an update between minor versions (e.g. from version 6.1.2 to 6.3.1) it is not necessary to install all minor intermediate versions (6.2.0, 6.3.0) one after the other. In this example only the update 6.3.1 has to be installed. It includes all previous updates.
The current version of Xima® Formcycle can be downloaded directly from our update page. If you should require them, we also  provide access to previous versions of Xima® Formcycle.
For each version, you can find three different files:
formcycle.war
Contains the master server with the backend and the Xima® Formcycle Designer. For the most common use case, you only need this file.
frontend-server.war
Contains the frontend server that only serves and accepts forms.
frontend-server-inbox.war
The frontend-server with additional support for accessing the inbox on the frontend server.
For certain version, we also provide plugins you can download.
Step 1: Download the current version
The current version of Xima® Formcycle can be downloaded directly from our update page.
Step 2: Replace the old version
 1.	Remove the current WAR file on the application server from the Tomcat. In Windows, for example, this is the folder C:\Program Files\Apache\Tomcat 9.0\webapps. The folder formcycle is automatically removed. This folder must be deleted before you continue.
 2.	Upload or copy the new WAR file to the webapps directory.
It may be necessary to restart the tomcat or application server afterwards. When required, update the configuration file web.xml as well in case you have made any custom changes.
Step 3: Database update
When you go to the login page, you may get a notifications that an update was found. If it does, sign in with a system administrator account and proceed as follows:
 1.	After signing in as system administrator (sadmin), you will be redirected to the database administration page. Here the settings should be checked again.
 2.	After clicking the Save and update button, the database and machine are updated.
 3.	The individual steps are displayed here. When all of them have been completed, the update is completed.
You should logout and continue your work with a regular user account (and not as a system administrator).
Please note that plugin updates may also be required. To do this, you must check the Customer Cloud to see if you already have the latest version installed. The update can be done under System > System plugins or
Client > Plugins, using the button Update plugin bundle. Please make sure that the correct plugin is selected.
Notice Update Frontend Server
The process for updating the frontend server must be done adequately to FORMCYCLE. This should ideally be done before FORMCYCLE. Afterwards, check on the master server under System > Frontend Server whether the connection is re-established.