servlet.ini reference - novalexei/mod_servlet GitHub Wiki

###servlet.ini

As it was pointed out in Apache2 server configuration file servlet.ini contains the properties to configure mod_servlet. By default this file is located in webapps directory and called servlet.ini. Non default location can be specified in ServletConfigurationFile directive (see ditails). All the properties in this file have default values, and if the file is not found they will be used.

  • translate.filepath (default true) - instructs to translate request URL to the filesystem path from webapp root directory. With this property set to false the request URL will be translated to the filesystem path from document root. This will affect the value returned by method get_path_translated of http_request, and also how static files are served. For example if the Apache2 server root is set to /home/me/apache/2.4/dt-root and mod_servlet webapp root to /home/me/apache/2.4/webapps and the request URL path is /test/some.html. With translate.filepath set to true the translated path will be /home/me/apache/2.4/webapps/test/some.html, and with translate.filepath set to false the translated path will be /home/me/apache/2.4/dt-root/test/some.html

  • input.stream.limit (default 2 Mb) - sets maximum limit for input stream size which can be read from http_request. If this value is "0" no limit for input stream will be set.

  • logging.properties - name for the logging properties file. For logging.properties format see documentation for servlet::logging::log_registry. If this file is not specified mod_servlet will search for it in webapp root directory, and if not found there will use default values.

  • share.sessions (default false) - instructs mod_servlet to share the http_session instances between web applications.

  • session.timeout (default is 30) - number of minutes to keep inactive http_sessions. This property has effect only if share.sessions is true in which case all session-timeout configurations for web applications will be overridden by this property's value. If this value is "0" no timeout will be set and sessions will be kept indefinitely.