Command-Line Configuration

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

./configure options

The 64-bit JNI compilation must match the JDK you're using, i.e. you'll need to use something like -J-d64 to properly enable 64 bit JDKs.

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

Argument

Meaning

Default

-conf xxx

Selects the Resin configuration file

conf/resin.conf

-server xxx

Selects the <server> in the resin.conf

-verbose

Show the Java environment before starting Resin.

off

-resin-home xxx

Sets the Resin home directory. (Deprecated. Use environment variable RESIN_HOME or <jvm-arg>-Dresin.home=xxx</jvm-arg> in resin.conf.)

The parent directory of resin.jar

start

Starts Resin as a daemon, starting the watchdog if necessary

n/a

stop

Stops Resin as a daemon by contacting the watchdog.

n/a

restart

Restarts Resin as a daemon by contacting the watchdog.

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

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