START_SERVER(1) User Contributed Perl Documentation START_SERVER(1)NAMEstart_server - a superdaemon for hot-deploying server programs
SYNOPSISstart_server [options] -- server-prog server-arg1 server-arg2 ...
# start Plack using Starlet listening at TCP port 8000
start_server --port=8000 -- plackup -s Starlet --max-workers=100 index.psgi
DESCRIPTION
This script is a frontend of Server::Starter. For more information
please refer to the documentation of the module.
OPTIONS
--port=(port|host:port)
TCP port to listen to (if omitted, will not bind to any ports)
--path=path
path at where to listen using unix socket (optional)
--dir=path
working directory, start_server do chdir to before exec (optional)
--interval=seconds
minimum interval to respawn the server program (default: 1)
--signal-on-hup=SIGNAL
name of the signal to be sent to the server process when start_server
receives a SIGHUP (default: SIGTERM). If you use this option, be sure
to also use "--signal-on-term" below.
--signal-on-term=SIGNAL
name of the signal to be sent to the server process when start_server
receives a SIGTERM (default: SIGTERM)
--pid-file=filename
if set, writes the process id of the start_server process to the file
--status-file=filename
if set, writes the status of the server process(es) to the file
--envdir=ENVDIR
directory that contains environment variables to the server processes.
It is intended for use with "envdir" in "daemontools". This can be
overwritten by environment variable "ENVDIR".
--enable-auto-restart
enables automatic restart by time. This can be overwritten by
environment variable "ENABLE_AUTO_RESTART".
--auto-restart-interval=seconds
automatic restart interval (default 360). It is used with
"--enable-auto-restart" option. This can be overwritten by environment
variable "AUTO_RESTART_INTERVAL".
--kill-old-delay=seconds
time to suspend to send a signal to the old worker. The default value
is 5 when "--enable-auto-restart" is set, 0 otherwise. This can be
overwritten by environment variable "KILL_OLD_DELAY".
--restart
this is a wrapper command that reads the pid of the start_server
process from --pid-file, sends SIGHUP to the process and waits until
the server(s) of the older generation(s) die by monitoring the contents
of the --status-file
--help
prints this help
--version
prints the version number
AUTHOR
Kazuho Oku
SEE ALSO
Server::Starter
LICENSE
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.18.2 2013-07-18 START_SERVER(1)