Chapter 4. Configuration Reference

Table of Contents
4.1. Client Configuration
4.2. Server Configuration
4.3. Entity Configuration

4.1. Client Configuration

The QOS Agent does not require much configuration beyond the specification of the QOS Server, as described in the Installation and Configuration section. The Agent only requires one parameter to start, and that is the name or IP address of the QOS Server.

The QOS Agent accepts the following optional command-line options:

QOS Agent Command-line Options

-d or --debug

Enables debug mode. The Agent does not detach from the starting terminal, prints all output to stdout instead of the log, and enables some additional messages.

-p or --port

Sets the Server port the Agent is to contact.

-c or --config

Specifies a configuration to use rather than downloading it from the Server. This mode depends on the local configuration and the Server's configuration for the Agent being identical. Takes one argument which is the name of the file to read from. The file should be a Python dictionary containing the keys from the Host section of the Server configuration for this Agent. This feature is designed for sites that do not want to allow the Server to control what is run on the Agent.

-f or --fork

Enables forking mode. In this mode the Agent will create subprocesses to check each Entity, speeding up checks of large numbers of Entities and Subentities and reducing the possibility of the Agent getting bogged down while checking unresponsive hosts.