Command-Line 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
Linux Boot
Resin 3.1
Configuration

While most configuration options have been made available in resin.conf, this section describes some common command-line options.

./configure options

The ./configure; make; make install step is important for all Unix users. It configures and compiles low level JNI code that enables Resin to provide a number of features not normally available to Java programs and also provides significant performance improvements.

The most commonly used options for ./configure are documented below, the full set of available command line options is available by running ./configure --help.

--helpHelp for all ./configure command line options
--enable-64bitCompiles the JNI using 64-bits, requires <jvm-arg>-d64</jvm-arg> entry in resin.conf
--enable-sslEnable OpenSSL, see the OpenSSL documentation for details.
--with-apxs=/path/to/apxsEnable Apache integration and produce mod_caucho

The 64-bit JNI compilation must match the JDK you're using, i.e. you'll need to add a <jvm-arg>-d64</jvm-arg> entry in resin.conf to indicate that the jvm should start in 64-bit mode.

Startup Options

As of Resin 3.1, startup options should be declared in the configuration file. However, some startup options are available via the command line.

Command-line arguments

ArgumentMeaningDefault
-conf xxxSelects the Resin configuration fileconf/resin.conf
-server xxxSelects the <server> in the resin.conf""
-verboseShow the Java environment before starting Resin.off
startStarts Resin as a daemon, starting the watchdog if necessaryn/a
statusShow the status of Resin as a daemon.n/a
stopStops Resin as a daemon by contacting the watchdog.n/a
restartRestarts Resin as a daemon by contacting the watchdog.n/a
killKill Resin as a daemon by contacting the watchdog, a killed process is destroyed and not allowed to clean up or finish pending connections.n/a
shutdownShutdown the watchdog and all of the Resin daemons.n/a
-install(Windows) install Resin as a service (but doesn't automatically start.)n/a
-install-as xxx(Windows) install Resin as a named service (but doesn't automatically start.)n/a
-remove(Windows) install Resin as a service (but doesn't automatically start.)n/a
-remove-as xxx(Windows) remove Resin as a named service (but doesn't automatically start.)n/a
-resin-home xxx Deprecated. Sets the Resin home directory. Use environment variable RESIN_HOME or <jvm-arg>-Dresin.home=xxx</jvm-arg> in resin.conf. The parent directory of resin.jar

JDK arguments

Resin 3.1 has moved all JDK arguments into the resin.conf file, in the <jvm-arg> tag. Because the Resin 3.1 watchdog starts each Resin server instance, it can pass the arguments defined in the configuration file to the JVM. By moving the Java arguments to the configuration file, server configuration is easier and more maintainable.

resin.conf with Java arguments
      <resin xmlns="http://caucho.com/ns/resin">
        <cluster id="app-tier">

          <server-default>
            <jvm-arg>-Xms32m</jvm-arg>
            <jvm-arg>-Xmx512m</jvm-arg>
            <jvm-arg>-Xss1m</jvm-arg>
            <jvm-arg>-verbosegc</jvm-arg>
            <jvm-arg>-Dfoo=bar</jvm-arg>
            <jvm-arg>-agentlib:resin</jvm-arg>
            <jvm-arg>-Xdebug</jvm-arg>
            
            <http port="8080"/>
          </server-default>

          <server id="a" address="192.168.2.1" port="6800"/>

          ...
        </cluster>
      </resin>
      

Linux Boot
Resin 3.1
Configuration
Copyright © 1998-2006 Caucho Technology, Inc. All rights reserved.
Resin ® is a registered trademark, and Quercustm, Ambertm, and Hessiantm are trademarks of Caucho Technology.