The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Server-Control-0.20
River stage zero No dependents
++
/ apachectlp

NAME

apachectlp - a more featureful Perl-based replacement for apachectl

VERSION

version 0.20

SYNOPSIS

   apachectlp [-f conf_file] [-d server_root] [-b httpd_binary] [-v]
              -k start|stop|restart|ping|graceful|graceful-stop
   apachectlp -h

DESCRIPTION

apachectlp uses Server::Control::Apache to start, stop, restart or ping (show status of) an Apache httpd server.

Features:

  • Checks server status both by looking at the pid file, and by contacting the server's port

  • Tails the error log when server fails to start

  • Detects and handles corrupt or out-of-date pid files

  • Uses sudo by default when using restricted (< 1024) port

OPTIONS

Required options: -k, and either -d or -f.

 -b, --httpd-binary  Specify an httpd binary - defaults to the first httpd in user's PATH
 -c, --class         Specify a customized class to use instead of Server::Control::Apache
 -d, --server-root   Specify the server root - will determine from configuration file if given
 -f, --conf-file     Specify the httpd conf file - defaults to conf/httpd.conf under server root
 -h, --help          Print help message
 -k, --action        Specify action - start, stop, restart, or ping
 -q, --quiet         Show only errors and warnings
 -v, --verbose       Show verbose output
 -I                  Library paths to include

Server::Control::Apache needs the values below and usually gets them by parsing the Apache configuration file, but you may pass any of them if the parsing isn't working.

 --bind-addr
 --error-log
 --pid-file
 --port
 --use-sudo

And in general, any constructor parameter to Server::Control or Server::Control::Apache can be passed here (replacing underscores with dashes), e.g.

 --name
 --wait-for-status-secs

RC FILE

You may place options in an rc file called serverctl.yml in the server root, e.g.

    # This is my serverctl.yml
    use_sudo: 1
    wait_for_status_secs: 5

You can also specify the path of the rc file with --serverctlrc.

AUTHOR

Jonathan Swartz

SEE ALSO

apachectl, httpd, Server::Control::Apache

COPYRIGHT & LICENSE

Copyright (C) 2007 Jonathan Swartz.

This software is provided "as is" and without any express or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for a particular purpose.

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

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Jonathan Swartz.

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