Installation - FORMCYCLE Wiki

This section provides information relevant to the installation of {{formcycle/}}.

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

= Installing {{formcycle/}} =

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

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]].

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]].

Wiki source code of Installation