Configuration
Resin 3.1

Documentation
Examples
Changes

Overview
Quick Start
Installation
Command-Line
Configuration
Admin
Amber
Clustering
Caching
Database
Deployment
EJB 3.0
Embedding
Filters
Hessian
HMTP
IoC
JSP
Logging
Messaging
Performance
Quercus/PHP
Remoting
Scheduled Tasks
Security
Server Push
Servlets
Third-party
Troubleshooting
Virtual Hosting
Watchdog
WebApp
XML and XSLT

<cluster>
<database>
<host>
Ports
<resin>
Resource tags
Rewrite
<server>
session
variables
<web-app>
Index
Relax Schema
Command-Line
Resin 3.1
<cluster>

Resin is a powerful, customizable application server. 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>

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.

Rewrite

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.

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

variables

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

Relax Schema

Environment
Resin J2EE
Resin web.xml
resin.conf
J2EE Common
J2EE web.xml

Command-Line
Resin 3.1
<cluster>
Copyright © 1998-2006 Caucho Technology, Inc. All rights reserved.
Resin ® is a registered trademark, and Quercustm, Ambertm, and Hessiantm are trademarks of Caucho Technology.