The SpringSource Application Platform embeds an OSGi-enhanced version of the Tomcat Servlet Container in order to provide support for deploying Java EE WARs and Web Modules. The embedded Servlet container can be configured via the servletContainer.config file located in the $PLATFORM_HOME/config directory. The following listing displays the default configuration distributed with the Platform.

{
    "servletContainer": {
        "version": 1.0,
        "configDir": "config/servlet",
        "hostName": "localhost",
        "jvmRoute": "jvm1",
        "listeners": [
            {
                "enabled": true,
                "className": "org.apache.catalina.core.AprLifecycleListener",
                "SSLEngine": "on"
            },
            {
                "enabled": true,
                "className": "org.apache.catalina.core.JasperListener"
            }
        ],
        "connectors": [
            {
                "enabled": true,
                "port": 8080,
                "protocol": "HTTP/1.1",
                "connectionTimeout": 20000,
                "maxThreads": 150,
                "emptySessionPath": false,
                "redirectPort": 8443
            },
            {
                "enabled": true,
                "port": 8443,
                "protocol": "HTTP/1.1",
                "scheme": "https",
                "connectionTimeout": 20000,
                "maxThreads": 150,
                "emptySessionPath": false,
                "clientAuth": false,
                "keystoreFile": "keystore",
                "keystorePass": "changeit",
                "secure": true,
                "SSLEnabled": true,
                "sslProtocol": "TLS"
            },
            {
                "enabled": true,
                "port": 8009,
                "protocol": "AJP/1.3",
                "connectionTimeout": 20000,
                "redirectPort": 8443
            }
        ],
        "logs": {
            "accessLogDir": "access",
            "accessLogFormat": "long"
        },
        "threadPool" : {
            "minSize": 25,
            "maxSize": 200,
            "keepAlivePeriod": 60000
        }
    }
}

	Disabling configuration elements
	Listener and Connector configuration elements can be disabled by setting the enabled flag to false. This allows you to disable but still retain the configuration for such elements without the need to delete the configuration.

7.2.1 Servlet Container Configuration

The following table lists all top-level options for configuring the embedded Servlet container.

	Relative paths
	If the configured path to a directory or file does not represent an absolute path, it will typically be interpreted as a path relative to the Servlet container's config directory (see configDir).

Table 7.1. Servlet Container Configuration Values

Entry	Description	Supported Values	Default Value
version	The configuration schema version.	1.0	N/A
configDir	The path to the Servlet container's config directory. This directory serves as the central location for implementation-specific configuration files. The config directory also serves as the base directory for any relative-path-based resources for the Servlet container. If the configured value does not represent an absolute path, it will be interpreted as a directory relative to the Platform's home directory.	config/servlet	N/A
hostName	The host name to use for the Servlet container's default host.	Any valid hostname for the server on which the Platform is running.	localhost
jvmRoute	A unique identifier for the Servlet container instance, used to configure a JVM route for load balancing.	A unique text value, typically purely alpha-numeric.	jvm1
listeners	A list of LifecycleListener configuration elements. Consult the official Tomcat documentation for further information on available listeners.	N/A	N/A
connectors	A list of Connector configuration elements. See the connector configuration section for details.	N/A	N/A
logs - accessLogDir	The path to the access log directory where HTTP requests to the Servlet container will be logged. If the configured value does not represent an absolute path, it will be interpreted as a directory relative to the $PLATFORM_HOME/serviceability/logs directory.	(see description)	access
logs - accessLogFormat	The style to use for formatting the access log.	short or long	long
threadPool - minSize	The minimum number of threads to be kept in the Servlet Container's threadpool.	Any positive int	25
threadPool - maxSize	The maximum number of threads to be kept in the Servlet Container's threadpool.	Any positive int	200
threadPool - keepAlivePeriod	The period of time, in milliseconds, that an idle thread will be kept alive in the Servlet Container's threadpool.	Any positive int	60000

7.2.2 Connector Configuration

The SpringSource Application Platform supports JSON-based configuration of any connector supported by Apache Tomcat. See the default configuration above for syntax examples, and for further details on the configuration properties supported for various Connector implementations, consult the official Tomcat HTTP Connector documentation.

	Configuring SSL for Tomcat
	The SpringSource Application Platform distribution includes a preconfigured keystore file which contains a single self-signed SSL Certificate. The password for this keystore file is changeit. Please note that the provided keystore file is intended for testing purposes only. For detailed instructions on how to configure Tomcat's SSL support, consult the official Tomcat SSL Configuration HOW-TO.