Trinidad Init Services
Trinidad's init services based on Apache commons daemon and jruby-jsvc. Works on Unix and Windows systems.
Installation
$ jruby -S gem install trinidad_init_services
When the gem is installed the user must launch the installation process:
$ jruby -S trinidad_init_service
This installer guides you through the configuration process and generates a init.d script if you are on a unix system or creates the service if you are on a windows box.
You can optionally provide a configuration file to the trinidad_init_service command. An example configuration file might look like this:
app_path: "/home/myuser/app"
trinidad_options: "-e production"
jruby_home: "/opt/jruby"
ruby_compat_version: RUBY1_8
trinidad_name: Trinidad
jsvc_path: "/usr/bin/jsvc"
java_home: "/opt/java"
output_path: "/etc/init.d"
pid_file: "/tmp/trinidad.pid"
log_file: "/tmp/trinidad.log"
You can then run the installer like so:
$ jruby -S trinidad_init_service trinidad_init_config.yml
If any of the required options are not provided in the configuration file, then the installer will prompt you for them.
Unix
Requirements
To run Trinidad as a daemon jsvc is used. Some distributions provide binary packages of JSVC but not all, for these we do bundle JSVC's sources and try to compile the binary during configuration for you. However please note that to build JSVC on Unix you will need :
- an ANSI-C compliant compiler (GCC is good) and GNU Make
- Java SDK installed (a JRE installation is not enough)
Execution
When the installation process finishes you can use the script generated to launch the server as a daemon with the options start|stop|restart, i.e:
$ /etc/init.d/trinidad restart
Running as a Non-Root User
By default, the Trinidad server process will run as the same user that ran the
/etc/init.d/trinidad start
command. But the service can be configured to run
as a different user. The preferred method for doing this is the run_user:
attribute in the configuration YAML (or it's corresponding value at the prompt).
For example:
app_path: "/home/myuser/app"
trinidad_options: "-e production"
jruby_home: "/opt/jruby"
run_user: myuser
...
This causes the the server to run with non-root privileges (it essentially executes
as sudo -u run_user jsvc ...
).
On some platforms, however, it may be required that you use the JSVC -user
argument.
This can be configured with the JSVC_ARGS_EXTRA
environment variable, like this:
JSVC_ARGS_EXTRA="-user myuser" /etc/init.d/trinidad start
It not recommended that you mix the -user
flag with the run_user
option !
Windows
Execution
Open the Services panel under Administrative Tools and look for a service called Trinidad.
Copyright
Copyright (c) 2011-2012 David Calavera[email protected]. See LICENSE for details.