Chapter 2. Running MonAMI

Table of Contents

2.1. Options for monamid
2.2. Testing a configuration
2.3. Running in production environment
2.4. Running from within the CVS tree

In this section, the various modes of running MonAMI are discussed. In most production environments, MonAMI runs as a single detached process (a daemon), launched from the system start-up scripts (the init scripts), as described in Section 2.3, “Running in production environment”. Other modes of running monamid, such as testing a new configuration, are also discussed.

2.1. Options for monamid

The MonAMI application (monamid) accepts only a limited number of options as most of the behaviour is controlled by the configuration file (/home/paul/MonAMI-test-install/etc/monami.conf). The format of this configuration file is described in a later section of this guide (Chapter 3, Configuring MonAMI).

The following options are available for the monamid application.

monamid [-f] [-h] [-v] [-V] [--pid-file file]

-f or --no-daemon

run in the foreground, i.e. do not detach from current terminal. Unless explicitly configured in monami.conf, logging output will be sent to stdout or stderr.

-h or --help

display a brief synopsis of available options.

-v or --verbose

show more of the logging information. MonAMI aims to be a quiet application. By default it will only report problems that are from extern resources or that are due to configuration that is inconsistent. With the -v option specified extra information is reported that, whilst not necessarily reporting an error, is indicative of potentially abnormal activity. This is often useful when MonAMI is not behaving as expected.

This option can be repeated to include extra debugging information; information useful when tracking down programming problems within MonAMI.

-V or --version

display the version of MonAMI and exit.

--pid-file file

store the PID of monamid in file, creating file if it does not already exist.