configuration

This section discusses how to configure Resin.

<cluster>

Each <cluster> contains a set of virtual hosts served by a collection of <server>s. The cluster provides load-balancing and distributed sessions for scalability and reliability.

<database>

The database tag configures a database as a javax.sql.DataSource with numerous options. Resin offers robust database connection pooling.

<host>

Describes the virtual host configuration tags.

Ports

The port tags configure <http> ports, addresses, cluster-ports and custom protocol TCP ports.

<resin>

The top-level <resin> tag contains any <cluster> defined for a deployment. It also provides an resources for class-loaders, logging and shared resources.

Resource tags

Environment tags configure class-loaders, logging, authentication and resources like databases, JMS queues, EJB servers, and web service clients. Many of the resources are stored in JNDI or in EL variables for later assembly.

Any environment resource can appear in any of Resin environments: <resin>, <cluster>, <host> and <web-app>. Resources configured at parent levels are shared among all children, so a database can share connection pools for all web-apps or an authenticator can provide single-signon.

CanDI Resources

List of Resin's CanDI-style resources.

<server>

The <server> tag configures a JVM instance in a cluster. It configures HTTP and cluster sockets, keepalives and timeouts, thread pooling, load balancing, and JVM arguments.

session

Resin adds a number of additions to the standard session-config tag.

<web-app>

Web applications are configured with the <web-app> tag, which can occur in a number of places.

• WEB-INF/web.xml contains a top-level web-app element. It is the Servlet standard location for defining things like servlet mappings and security roles.
• WEB-INF/resin-web.xml is also used by Resin and will override and supplement the configuration in WEB-INF/web.xml. Use it to specify Resin specific configuration if you prefer to keep WEB-INF/web.xml strictly conforming to the Servlet specification.
• A web application can also be configured in the main Resin configuration, and in this context web-app is a child of <host>.

Index

Alphabetical index of all configuration tags.