NAME

Clustericious::Command::lighttpd - Clustericious command to stat lighttpd

VERSION

version 1.29

SYNOPSIS

% yourapp start

DESCRIPTION

Start a lighttpd web server. The lighttpd start and stop commands recognize these options in their configuration section:

pid_file

The location to the pid file. This should usually be the same as the PidFile directive in your lighttpd configuration.

EXAMPLES

FCGI

See caveats below

---
% my $root = dir "@{[ home ]}/var/run";
% $root->mkpath(0,0700);
% $root->subdir('document-root')->mkpath(0700);

url: http://<%= $host %>:<%= $port %>
start_mode: lighttpd

lighttpd:
  args: -f <%= $root %>/lighttpd.<%= $port %>.conf
  pid_file: <%= $root %>/lighttpd.<%= $port %>.pid
  autogen:
    filename: <%= $root %>/lighttpd.<%= $port %>.conf
    content: |
      server.bind          = "<%= $host %>"
      server.port          = <%= $port %>
      server.document-root = "<%= $root %>/document-root"
      server.pid-file      = "<%= $root %>/lighttpd.<%= $port %>.pid"
      
      server.modules += ( "mod_fastcgi" )
      
      fastcgi.server = ("/" => ((
        "bin-path"            => "<%= $0 %> fastcgi",
        "check-local"         => "disable",
        "fix-root-scriptname" => "enable",
        "socket"              => "<%= $root %>/lighttpd.<%= $port %>.sock"
        ))
      )

CAVEATS

I was unable to get lighttpd to kill the FCGI processes and there are reports (see http://redmine.lighttpd.net/issues/2137) of the PID file it generates disappearing. Because of the former limitation, the lighttpd tests for Clustericious are skipped by default (though they can be used by developers willing to manually kill the FCGI processes).

Pull requests to Clustericious and / or documentation clarification would be greatly appreciated if someone manages to get it to work better!

SEE ALSO

Clustericious

AUTHOR

Original author: Brian Duggan

Current maintainer: Graham Ollis <plicease@cpan.org>

Contributors:

Curt Tilmes

Yanick Champoux

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by NASA GSFC.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.