Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XYMONLAUNCH(8)		    System Manager's Manual		XYMONLAUNCH(8)

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 -	xymon-
       launch 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 log-
	      file 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	 fore-
	      ground.

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  min-
       utes. This will be logged to the	xymonlaunch logfile.

       If  the configuration file changes, xymonlaunch will re-read it and no-
       tice 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  environ-
       ment  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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | STARTING TASKS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xymonlaunch&sektion=8&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help