Installation Scrapbook
Resin 3.0

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

Quick Start
Standalone Web Server
Apache
IIS
Details
FAQ
Scrapbook
FAQ
Installation
Configuration

A repository of notes and comments that will eventually make their way into the documentation. Please treat the information here with caution, it has often not been verified.

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"
        $RESIN_HOME/bin/httpd.sh start -J-server -Xms32M -Xmx64M
}

StopService ()
{
        ConsoleMessage "Stopping Resin"
        $RESIN_HOME/bin/httpd.sh stop
}

RestartService ()
{
        ConsoleMessage "Restarting Resin"
        $RESIN_HOME/bin/httpd.sh 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
Copyright © 1998-2005 Caucho Technology, Inc. All rights reserved.
Resin® is a registered trademark, and HardCoretm and Quercustm are trademarks of Caucho Technology, Inc.