Wiki source code of Jetty Installation
Version 11.1 by Vincent Massol on 2021/02/15
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | There are several ways to run XWiki on Jetty: | ||
| 2 | * Using the [[Demo packaging (a.k.a Standalone packaging)>>Documentation.AdminGuide.Installation.InstallationStandalone.WebHome]] which bundles Jetty and provide an all-in-one zip, ready to use. | ||
| 3 | * Using the official [[Jetty docker image>>https://hub.docker.com/_/jetty]]. | ||
| 4 | * [[Downloading and instaling>>https://www.eclipse.org/jetty/download.html]] Jetty manually on your server. | ||
| 5 | |||
| 6 | If you go with the last 2 options, make sure you pick a [[supported version of Jetty>>dev:Community.SupportStrategy.ServletContainerSupportStrategy.WebHome]]. | ||
| 7 | |||
| 8 | = Docker = | ||
| 9 | |||
| 10 | * Extract the [[XWiki WAR>>xwiki:Main.Download]] into a directory named ##xwiki##. Let's call this directory ##[XWIKI_HOME]##. | ||
| 11 | * Run the Jetty Docker image, for example: {{code language="none"}}docker run -v [XWIKI_HOME]:/var/lib/jetty/webapps/xwiki -p 8080:8080 jetty:9-jre11{{/code}} | ||
| 12 | |||
| 13 | = Manual = | ||
| 14 | |||
| 15 | * Download and install [[Jetty>>https://www.eclipse.org/jetty/download.html]]. It's usually as simple as unzipping it in a directory. Let's call this directory ##[JETTY_HOME]##. | ||
| 16 | * Extract the [[XWiki WAR>>xwiki:Main.Download]] into a directory named ##xwiki## in ##[JETTY_HOME]/webapps/##. | ||
| 17 | * Open ##[JETTY_HOME]/webapps/xwiki/WEB-INF/xwiki.properties## files and [[configure a permanent directory>>platform:AdminGuide.Configuration||anchor="HConfiguringDirectories"]] | ||
| 18 | * (Optional) If you want to modify the port on which Jetty will run, edit ##[JETTY_HOME]/start.ini##. Search for ##8080##, replace it with the port value you wish to use and uncomment the corresponding property {{code language="none"}}jetty.http.port{{/code}}. | ||
| 19 | |||
| 20 | = Troubleshooting = | ||
| 21 | |||
| 22 | == Unable to parse form content == | ||
| 23 | |||
| 24 | In some cases you could obtain one of the following error messages: | ||
| 25 | |||
| 26 | * {{error}}Unable to parse form content{{/error}} | ||
| 27 | * {{code}}org.eclipse.jetty.http.BadMessageException: 400: Unable to parse form content{{/code}} | ||
| 28 | |||
| 29 | This can be related to a form containing too many parameters. In order to fix this issue, you can modify your ##jetty.xml## file as explained in [[Configuring form limits for the server>>https://www.eclipse.org/jetty/documentation/9.4.x/configuring-form-size.html#_configuring_form_limits_for_the_server]]. |
