The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

xas-supervisor - supervise and manage background processes

SYNOPSIS

xas-supervisor [--help] [--debug] [--manual] [--version]

 options:
   --port         the management port to listen on
   --address      the network address to use
   --help         outputs simple help text
   --manual       outputs the procedures manual
   --version      outputs the apps version
   --debug        toogles debugging output
   --alerts       toogles alert notifications
   --cfg-file     which configuration file to use
   --pid-file     which pid file to use
   --log-file     name of the log file 
   --log-type     toggles the log type
   --log-faciilty changes the log facility

DESCRIPTION

This procedure reads a configuration file and spawns multiple background processes. It will then try to keep those processes running. External management tools can send commands to the supervisor to control those background processes.

CONFIGURATION

Please refer to XAS::Apps::Supervisor::Monitor for configuration file information.

OPTIONS AND ARGUMENTS

--port

The network port to listen on for management functions.

--address

The network address to use.

-cfg-file

The configuration file to use.

--pid-file

The pid file to use.

--help

Displays a simple help message.

--debug

Turns on debbuging.

--alerts

Togggles alert notification.

--log-type

Toggles the log type. Defaults to 'console'. Can be 'console', 'file', 'json' or 'syslog'.

--log-facility

Toggles the log facilty. Defaults to 'local6'. This follows syslog convention.

--log-file

Optional logfile. When specified the log type is set to 'file'.

--manual

The complete documentation.

--version

Prints out the apps version

EXIT CODES

 0 - success
 1 - failure

SEE ALSO

XAS::Apps::Supervisor::Monitor
XAS::Supervisor
XAS

AUTHOR

Kevin L. Esteb, <kevin@kesteb.us>

COPYRIGHT AND LICENSE

Copyright (c) 2012-2015 Kevin L. Esteb

This is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0. For details, see the full text of the license at http://www.perlfoundation.org/artistic_license_2_0.