NAME

rtexec - real time data acquisition system executive

SYNOPSIS

rtexec [-cdfknstvx] [-q minutes] [-r minutes]
                [-u user] [-w whyfile] [comment]

DESCRIPTION

rtexec starts up, shuts down, and monitors the operation of the real time data acquisition system. Typically, it performs the following operations:

If a task dies, it is restarted automatically. If the rtexec.pf parameter file changes, it is reread. If any task has been added or deleted, or its command line changed, it is started, restarted, or killed as appropriate. Any crontab changes are incorporated.

If the Defines or Env or Limit arrays in rtexec.pf environment change, all the tasks are restarted.

OPTIONS

Any optional comment on the command line is recorded in the log.

FILES

rtexec typically runs in a directory with a particular organization; the typical directories are described below. This directory and file structure is only the default organization. The directories can be rearranged as desired by modifying the appropriate parameter files.

ENVIRONMENT

The environment for rtexec and tasks rtexec runs is specified in the parameter file.

PARAMETER FILE

The execution of the real time system is largely dictated by rtexec's parameter file.

Resource Limits

Parameters used by rtm

Some parameters are kept in rtexec.pf only because it's a convenient central location, not because they're used by rtexec. Some parameters are shared by rtexec and rtm. Following are the rtm parameters; please refer to rtm(1) for a description:

In addition, the network code used by rtreport(1) and rtsys(1) can be specified in rtexec.pf; the default is to use the net code from the first entry in the network table.

EXAMPLE


# start a real time system, first saving the old log files
# to a sub-directory.
% rtexec -ts

# kill a running real time system
% rtexec -k

DIAGNOSTICS

rtexec is generally pretty verbose, logging most changes to the file logs/rtexec. Fatal errors include the following:

SEE ALSO

rtexec_setup(5)
rt(5)
rtsystem(5)
rtsetup(8)
pf(3), pfecho(1)
crontab(1.gz)
rtincident(1)
rtsnapshot(1)
rtmail(1)

BUGS AND CAVEATS

Presumably, many cron jobs may run soon after midnight UTC. However, local times in the hour after switches to and from Daylight savings time should be avoided.

The names of tasks are completely arbitrary; however, it has proven convenient to use this convention: the task name is the executable name, potentially followed by an underscore and a qualifier. For instance, the name of a single orb2orb task would be orb2orb. If there were multiple orb2orb tasks, the names might be distinguished by qualifiers, eg: orb2orb_AZ, orb2orb_cslb, etc.

AUTHOR

Daniel Quinlan
Boulder Real Time Technologies, Inc.

Table of Contents
Antelope Release 4.8 Darwin 8.7.0 2006-09-26
Boulder Real Time Technologies, Inc For more information, contact support@brtt.com