Wiki source code of Installation
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.3 | 1 | This section provides information relevant to the installation of {{formcycle/}}. |
| |
1.1 | 2 | |
| |
1.3 | 3 | On the corresponding subpages you will find, among other things, information about the system requirements and instructions for updating an existing installation of {{formcycle/}}. |
| |
1.1 | 4 | |
| |
1.3 | 5 | {{subpagesalpha title="Subpages"/}} |
| |
1.1 | 6 | |
| 7 | |||
| 8 | |||
| |
1.3 | 9 | = Installing {{formcycle/}} = |
| |
1.1 | 10 | |
| 11 | {{content/}} | ||
| 12 | |||
| 13 | {{warning}} | ||
| |
1.3 | 14 | 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>>doc:Formcycle.SystemSettings.TomcatSettings.WebHome]]. |
| |
1.1 | 15 | {{/warning}} |
| 16 | |||
| |
1.3 | 17 | {{info}}When configuring the application server, note that {{formcycle/}} does not support HTTP/2 at the moment.{{/info}} |
| |
1.2 | 18 | |
| |
1.3 | 19 | == Install database driver == |
| |
1.1 | 20 | |
| |
1.3 | 21 | {{formcycle/}} does not ship any database driver anymore. You need to [[install the required database driver>>doc:Formcycle.SystemSettings.DatabaseDrivers]] yourself. |
| |
1.1 | 22 | |
| |
1.3 | 23 | == Installing with Apache Tomcat manager == |
| |
1.1 | 24 | |
| |
1.3 | 25 | The following steps describe how to install {{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.1 | 26 | |
| |
1.3 | 27 | 1. Start Apache Tomcat. |
| 28 | 1. Open the Tomcat manager and sign in with your account, if necessary. | ||
| 29 | 1. 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//. | ||
| 30 | 1. 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//. | ||
| |
1.1 | 31 | |
| |
1.3 | 32 | In case the installation should fail with the error message //SizeLimitExceededException//, the [[upload file size limit of the Tomcat manager must be increased>>doc:Formcycle.SystemSettings.TomcatSettings.LimitUploadSize]] in the //web.xml// configuration file. |
| |
1.1 | 33 | |
| |
1.3 | 34 | Continue with the [[initial configuration>>doc:InitialConfiguration]]. |
| |
1.1 | 35 | |
| |
1.3 | 36 | == Installing the WAR file manually == |
| |
1.1 | 37 | |
| |
1.3 | 38 | To install the WAR file manually, copy the //formcycle.war// to the //webapps// directory of the Tomcat web container. |
| |
1.1 | 39 | |
| |
1.3 | 40 | 1. Copy the //formcycle.war// to the //webapps// directory of the Tomcat web container. |
| 41 | 1. Restart the Tomcat application server. | ||
| 42 | 1. Tomcat will unpack the WAR file automatically on startup, completing the installation. | ||
| |
1.1 | 43 | |
| |
1.3 | 44 | Continue with the [[initial configuration>>doc:InitialConfiguration]]. |