resin

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.

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

#!/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" { Description = "Resin Application Server"; Provides = ("Resin"); Requires = ("Web Server"); OrderPreference = "None"; Messages = { start = "Starting Resin"; stop = "Stopping Resin"; restart = "Restarting Resin"; }; } 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 and tags to change the effective user id of Resin:

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