Sha256: efffb23770c1723fe62016783a8237b66a0a2cc8947f71219370bce043e4dcec

Contents?: true

Size: 1.91 KB

Versions: 5

Compression:

Stored size: 1.91 KB

Contents

Trinidad Daemon Extension
=======

# DESCRIPTION

Extension to run Trinidad server as a daemon.

[WARNING] This extension only works with Trinidad 0.8.3 or above.

# INSTALLATION

jruby -S gem install trinidad_daemon_extension

# USAGE

This extension can be enabled from the Trinidad's configuration file or from the command line.
It uses a temporal directory to write the pid file but its route can be overrided.

  * To enable it from the configuration file you have to add a section "extensions" to the root of the file and the section "daemon" to this one. The pid file can be specified there:

    ---
      extensions:
        daemon:
          pid_file: ./trinidad.pid # this is optional by default the extension writes the pid file into a temporal directory.

  * To enable it from the command line you have to load the extension first and then add one of these options:

     -d, --daemonize [PID_FILE]

     for instance: 

     $ jruby -S trinidad --load daemon --daemonize ./trinidad.pid

The log file where the daemon writes its logs is also configurable from the trinidad's configuration file.
By default it writes the logs into the file log/trinidad.log with the level INFO, to modify this behaviour you just need to add these lines under the daemon configuration:

    ---
      extensions:
        daemon:
          log:
            file: trinidad.log # where the daemon writes its output
            level: ALL # severity level, it cn be one of these: ALL, CONFIG, FINE, FINER, FINEST, INFO, OFF, SEVERE, WARNING 

The extension also allows to add new JVM arguments to run the daemon with. They just need to be added into the configuration file:

    ---
      extensions:
        daemon:
          jvm_args: '-XX:MaxPermSize=512m'

You can find further information on how to write your own extension in the wiki: http://wiki.github.com/calavera/trinidad/extensions

# Copyright

Copyright (c) 2010 David Calavera. See LICENSE for details.

Version data entries

5 entries across 5 versions & 1 rubygems

Version Path
trinidad_daemon_extension-0.2.2 README
trinidad_daemon_extension-0.2.1 README
trinidad_daemon_extension-0.2.0 README
trinidad_daemon_extension-0.1.5 README
trinidad_daemon_extension-0.1.4 README