JBOSS3CTL(1)

NAME
jboss3ctl - JBoss server control interface

SYNOPSIS
jboss3ctl [-java-options] {start|restart|stop}

DESCRIPTION
The jboss3ctl program provides an restricted interface to the JBoss application server. The jboss3ctl program is only accessible to users in the 'www' group, and will only invoke the Native 1.4.2 JVM.

Any Java options listed are handed off directly to the JVM. Any classpath options will be ignored.

The program expects exactly one of the following terminating commands:

start
    Start JBoss, if it is not already running.

restart
    Restart JBoss. If it is already running, then it will be stopped and then started right after that. Otherwise it will just be started up.

stop
    Stop JBoss, if it is actually running.

ERRORS
The following error conditions are detected. They will be checked in the specified order. In each case an error message is printed with the name of the control program prepended.

If no argument is passed, then a simple help message is printed and the program exists with error code 0.

If at least one argument is passed, but it is different from start, restart or stop then the help message is printed as well, and the program exits with error code 1.

The following errors conditions are defined:

Illegal program argument (error code 1)

PID file not found (error code 2)

PID file too large (error code 3)

PID file contains illegal character (error code 4)

Kill of process failed (error code 5)

JBoss is already running (error code 6)

JBoss is not running (error code 7)

Unable to chdir to the JBoss home directory (error code 8)

Unable to open the stdout log file (error code 9)

Unable to open the stderr log file (error code 10)

Unable to start JBoss (error code 11)

FILES

/var/run/jboss3.pid
    The JBoss PID file that is used to store the process ID of the currently running process in. It is emptied as soon as the server is stopped and filled with the process ID when it is started. It should never be writable for anyone but www,

/usr/local/etc/rc.d/020.jboss3.sh
    A script that starts the jboss3ctl program. It is used to start JBoss at startup time.

AUTHORS
Ernst de Haan <znerd@FreeBSD.org> Jonathan Chen <jonc@chen.org.nz>