Installation Scrapbook

Overview
Installation
Configuration
Quercus
SOA/IoC
JSP
Servlets and Filters
Admin (JMX)
EJB
Amber
Security
Performance
Hessian
XML and XSLT
Third-party
Troubleshooting/FAQ

Quick Start
Resin Web Server
Apache
IIS
Plugin Dispatch
Linux Boot
FAQ
Scrapbook

FAQ

Installation

Configuration

A repository of notes and comments for installation.

Mac OS X startup script

(contributed by Rob Lockstone)

Resin can be configured to start automatically when the system boots up using StartupItems. Create a directory in /Library/StartupItems called "Resin". In that directory are two files:

/Library/StartupItems/Resin/Resin

#!/bin/sh

##
# Resin Application Server
##

. /etc/rc.common

JAVA_HOME=/Library/Java/Home
export JAVA_HOME
RESIN_HOME=/path/to/resin
export RESIN_HOME

StartService ()
{
        ConsoleMessage "Starting Resin"
        $JAVA_HOME/bin/java -jar $RESIN_HOME/lib/resin.jar start
}

StopService ()
{
        ConsoleMessage "Stopping Resin"
        $JAVA_HOME/bin/java -jar $RESIN_HOME/lib/resin.jar stop
}

RestartService ()
{
        ConsoleMessage "Restarting Resin"
        $JAVA_HOME/bin/java -jar $RESIN_HOME/lib/resin.jar restart
}

RunService "$1"

/Library/StartupItems/Resin/StartupParameters.plist

{
  Description     = "Resin Application Server";
  Provides        = ("Resin");
  Requires        = ("Web Server");
  OrderPreference = "None";
  Messages =
  {
    start = "Starting Resin";
    stop  = "Stopping Resin";
    restart = "Restarting Resin";
  };
}

Note The StartupParameters.plist file example above requires that the service named "Web Server", which is Apache, is started before Resin starts. If you run Resin standalone, remove that dependency.

Resin will start automatically when your system boots. You can stop, start and restart Resin using the following commands from a terminal:

sudo SystemStarter start Resin
sudo SystemStarter stop Resin
sudo SystemStarter restart Resin

Since Resin is started by root, consider using the user-name and group-name tags to change the effective user id of Resin:

resin.conf

<server>
  ...
  <user-name>nobody</user-name>
  <group-name>daemon</group-name>
  ...
</server>

For more info than you probably want to know about Mac OS X's boot process and startup items, see Apple's documentation.

FAQ

Installation

Configuration