How ToResin 3.0
Resin 3.0

Features
Installation
Configuration
Web Applications
IOC/AOP
Resources
JSP
Quercus
Servlets and Filters
Databases
Admin (JMX)
CMP
EJB
Amber
EJB 3.0
Security
XML and XSLT
XTP
JMS
Performance
Protocols
Third-party
Troubleshooting/FAQ

index
howto
resin.conf
env
web-app
log
el control
Bean Config
Common Tasks
Relax Schema
Config FAQ
Scrapbook
index
Configuration
resin.conf

Task-based configuration index.

  1. Configure and use a database connection
  2. Bind to port 80/443 without running as root
  3. Set a proxy port when mapping port 80 to port 8080
  4. Reload .war files manually

Configure and use a database connection

See the database configuration page for the full configuration documentation.

See the thirdparty driver configuration page for sample configurations for several database drivers.

See the JNDI DataSource tutorial and the DataSource inversion-of-control tutorial for sample JDBC usage patterns.

Bind to port 80/443 without running as root

Unix needs root privileges to bind to port 80 and 443, but Resin should avoid running as root for security. It's best to use a port mapper or firewall to map the protected port to an unprotected port like 8080 to avoid running as root entirely.

On Linux, use iptables. An example iptable configuration.

If iptables is not available, the user-name and group-name configuration can use setuid to change Resin's user after binding ports.

Set a proxy port when mapping port 80 to port 8080

When the HTTP port is mapped from 80 to port 8080 or when a load balancer redirects to an internal IP address, the application often needs the external address, not the server's view.

Use host-name in the <host> to set the canonical host and port name to the external address.

<host host-name="http://foo.com:80">
  <host-alias>foo.com</host-alias>
  ...
</host>

Reload .war files manually

See the JMX restart example.


index
Configuration
resin.conf
Copyright © 1998-2006 Caucho Technology, Inc. All rights reserved.
Resin® is a registered trademark, and HardCoretm and Quercustm are trademarks of Caucho Technology, Inc.