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 | == Install database driver == | ||
| 18 | |||
| 19 | {{formcycle/}} does not ship any database driver anymore. You need to [[install the required database driver>>doc:Formcycle.SystemSettings.DatabaseDrivers]] yourself. | ||
| 20 | |||
| 21 | == Installing with Apache Tomcat manager == | ||
| 22 | |||
| 23 | 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. | ||
| 24 | |||
| 25 | 1. Start Apache Tomcat. | ||
| 26 | 1. Open the Tomcat manager and sign in with your account, if necessary. | ||
| 27 | 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//. | ||
| 28 | 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//. | ||
| 29 | |||
| 30 | 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. | ||
| 31 | |||
| 32 | Continue with the [[initial configuration>>doc:InitialConfiguration]]. | ||
| 33 | |||
| 34 | == Installing the WAR file manually == | ||
| 35 | |||
| 36 | To install the WAR file manually, copy the //formcycle.war// to the //webapps// directory of the Tomcat web container. | ||
| 37 | |||
| 38 | 1. Copy the //formcycle.war// to the //webapps// directory of the Tomcat web container. | ||
| 39 | 1. Restart the Tomcat application server. | ||
| 40 | 1. Tomcat will unpack the WAR file automatically on startup, completing the installation. | ||
| 41 | |||
| 42 | Continue with the [[initial configuration>>doc:InitialConfiguration]]. |