NAME

       xymonlaunch - Master program to launch other Xymon programs

SYNOPSIS

       xymonlaunch [options]

DESCRIPTION

       xymonlaunch(8) is the main program that controls the execution and scheduling of all of the components in
       the Xymon system.

       xymonlaunch  allows  the  administrator  to  add,  remove  or  change  the  set of Xymon applications and
       extensions without restarting Xymon - xymonlaunch will automatically notice any changes  in  the  set  of
       tasks, and change the scheduling of activities accordingly.

       xymonlaunch  also  allows  the  administrator  to setup specific logfiles for each component of the Xymon
       system, instead of getting output from all components logged to a single file.

OPTIONS

       --env=FILENAME
              Loads the environment from FILENAME before starting  other  tools.   The  environment  defined  by
              FILENAME is the default, it can be overridden by the ENVFILE option in tasks.cfg(5)

       --config=FILENAME
              This  option  defines  the  file that xymonlaunch scans for tasks it must launch. A description of
              this file is in tasks.cfg(5) If not specified, files at /etc/tasks.cfg, /etc/xymon/tasks.cfg,  and
              /etc/xymon-client/clientlaunch.cfg are searched for, as well as ~/server/etc/tasks.cfg.

       --log=FILENAME
              Defines  the  logfile  where xymonlaunch logs information about failures to launch tasks and other
              data about the operation of xymonlaunch. Logs from individual tasks are defined in  the  tasks.cfg
              file. By default this is logged to stdout.

       --pidfile=FILENAME
              Filename  which  xymonlaunch  saves  its  own process-ID to. Commonly used by automated start/stop
              scripts.

       --verbose
              Logs the launch of all tasks to the logfile. Note that the logfile may become quite large  if  you
              enable this.

       --dump Just dump the contents of the tasks.cfg file after parsing it.  Used for debugging.

       --debug
              Enable debugging output while running.

       --no-daemon
              xymonlaunch  normally detaches from the controlling tty and runs as a background task. This option
              keeps it running in the foreground.

STARTING TASKS

       xymonlaunch will read the configuration file and start all of the tasks listed there.

       If a task completes abnormally (i.e. terminated by a  signal  or  with  a  non-zero  exit  status),  then
       xymonlaunch  will  attempt to restart it 5 times. If it still will not run, then the task is disabled for
       10 minutes. This will be logged to the xymonlaunch logfile.

       If the configuration file changes, xymonlaunch will re-read it and notice any changes. If a running  task
       was  removed  from  the  configuration,  then  the  task  is stopped. If a new task was added, it will be
       started.  If the command used for a task changed, or it was given a new environment definition  file,  or
       the logfile was changed, then the task is stopped and restarted with the new definition.

SEE ALSO

       tasks.cfg(5), xymon(7)

Xymon                                      Version 4.3.30:  4 Sep 2019                            XYMONLAUNCH(8)