Wiki source code of Installation
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | This section provides information relevant to the installation of {{formcycle/}}. | ||
2 | |||
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/}}. | ||
4 | |||
5 | {{subpagesalpha title="Subpages"/}} | ||
6 | |||
7 | |||
8 | |||
9 | = Installing {{formcycle/}} = | ||
10 | |||
11 | {{content/}} | ||
12 | |||
13 | {{warning}} | ||
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]]. | ||
15 | {{/warning}} | ||
16 | |||
17 | {{info}}When configuring the application server, note that {{formcycle/}} does not support HTTP/2 at the moment.{{/info}} | ||
18 | |||
19 | == Install database driver == | ||
20 | |||
21 | {{formcycle/}} does not ship any database driver anymore. You need to [[install the required database driver>>doc:Formcycle.SystemSettings.DatabaseDrivers]] yourself. | ||
22 | |||
23 | == Installing with Apache Tomcat manager == | ||
24 | |||
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. | ||
26 | |||
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//. | ||
31 | |||
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. | ||
33 | |||
34 | Continue with the [[initial configuration>>doc:InitialConfiguration]]. | ||
35 | |||
36 | == Installing the WAR file manually == | ||
37 | |||
38 | To install the WAR file manually, copy the //formcycle.war// to the //webapps// directory of the Tomcat web container. | ||
39 | |||
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. | ||
43 | |||
44 | Continue with the [[initial configuration>>doc:InitialConfiguration]]. |