= JBOSS

== How To
- [[JBOSS HowTo Debug Restart Issues]]

=== Start / Stop / Restart

1. /local/jboss/run.sh
 1. Needs parameters that you can find in TRAC somewhere or on the internet.
 2. Run with an ampersand to run in the background.

== Stop

Run the command `{JBOSS directory}/shutdown.sh -S`

== Start

**NB: run another command as {{{sudo}}} first, because you cannot enter a password when trying to run a command in the background.**

{{{
sudo run.sh -Duser.timezone="Europe/London" -b 0.0.0.0 &
}}}

== Auto Start on Reboot

To automatically start on reboot.  Add the following line to the crotab of a user with the permissions to run JBOSS.  (wwwrun on the lamp servers)

{{{
@reboot /local/jboss-5.1.0.GA/bin/run.sh -b 0.0.0.0 &
}}}

This will probably require some ACL changes.  Here are the ones that were required on the University LAMP server:

{{{
setfacl -m u:wwwrun:rwx log
setfacl -m u:wwwrun:rw data/jnp-service.url
setfacl -m u:wwwrun:rwx data/hypersonic
setfacl -m u:wwwrun:rwx data/hypersonic/*
setfacl -m u:wwwrun:rw data/hypersonic/*
setfacl -m u:wwwrun:wrx /local/jboss-5.1.0.GA/server/default/data
setfacl -m u:wwwrun:rwx tmp/
setfacl -m u:wwwrun:rwx vfs-nested.tmp
setfacl -m u:wwwrun:rwx work/
setfacl -m u:wwwrun:rwx work/jboss.web/localhost/
setfacl -m u:wwwrun:rwx work/jboss.web/localhost/*
}}}

[[BackLinks]]