Information about Tomcat versions

Supported Tomcat versions

Depending on the AMANA product, different Tomcat versions may be supported. Sometimes, however, individual Tomcat versions are faulty or require special configuration. 

Not supported Tomcat versions

The following Tomcat versions contain errors that prevent them from being used as Web Application Server for the AMANA products. Please do not install the following Tomcat versions:

  • 7.0.75
  • 8.0.41
  • 8.5.11
  • 9.0.0.M17

Special configurations

Square brackets in URLs

Error message:

"Invalid character found in the request target. The valid characters are defined in RFC 7230 and RFC 3986."

The manufacturer has tightened security guidelines and by default does not allow square brackets in URLs anymore.

Known affected Tomcat versions: 7.0.73, 8.0.39, 8.5.7. 8.5.42 (This list is not exhaustive and may be extended.)


Solution:

For AMANA products (e.g. GlobalTaxCenter) to work correctly, the configuration must be extended in the Tomcat installation (%TOMCAT_HOME%/conf) in the server.xml file. The attribute relaxedQueryChars="[,]" must also be specified in the connector so that square brackets are still permitted in URLs.


Example:

<Connector port="80"
           protocol="HTTP/1.1"
           maxThreads="150"
           connectionTimeout="20000"
           redirectPort="443"
           compression="on"
           compressionMinSize="2048"
           noCompressionUserAgents="gozilla, traviata"
           compressableMimeType="text/html,text/xml"
           relaxedQueryChars="[,]"
/>