configuration

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.

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

Describes the virtual host configuration tags.

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

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

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.

Resin's <rewrite-dispatch> tag allows configuration for URL aliasing, rewriting, dispatching, and redirection.

<rewrite-real-path> configures an alias for files located on the filesystem, allowing for the mapping of a virtual directory.

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.

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

Resin configuration can directly access Resin-IoC/WebBeans-configured beans and variables using EL expressions in the configuration files. Predefines variables include webApp, host, and resin variables.

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>.

Alphabetical index of all configuration tags.

Environment

Resin J2EE

Resin web.xml

resin.conf

J2EE Common

J2EE web.xml