arm4.conf(5)

SYNOPSIS

/etc/arm4.conf

DESCRIPTION

The agent has a number of configurable options that are controlled through the configuration file. The agent and it's utilities can use either the default file at /etc/arm4.conf, or a file passed in as a command line argument.

While the options are passed to the programs as they start, they generally affect persistent global objects shuch as the shared memory regions that remain after the program exits. Because of this, many options will only be changed when the shared memory objects are recreated.

Options may be set in one of two ways:

<option> <value> <option> = <value>

Blank lines and lines starting with # are considered to be comment lines.

The different configuration options are:

user the user name or UID for the daemon. The defaults is to run as the current user.

group the group name or GID for the daemon. The defaults is to run as the current group.

umask the umask used for the creation of shared objects.

db_home_dir

the home directory for the ARM 4 instance databases. The default is /var/opt/arm/data.

db_backup_dir

the parent directory for the database archives. When a new archive is created, a time stamped directory is created as a child of this directory. The default is /var/opt/arm/data/backup.

db_file_size

sets the transaction file size for the Berkeley DB. This should be large enough that no single transaction can span multiple files or memory allocation errors will occur. The db_file_size parameter must always be smaller than the db_buffer_size. Refer to the Berkeley DB documentation for more information.

db_buffer_size

sets the size of memory allocated for transactions. It should be large enough to hold all active transactions or memory allocation errors will occur. the db_buffer_size parameter should always be larger than db_file_size. Refer to the Berkeley DB documentation for more information.

db_key multiple instances of the Berkeley database share common memory regions. In cases where this is undesireable, the

db_key can be set explicitly. Refer to the Berkeley DB documentation for more information.

instance

specify the ARM 4 instance number. Refer to user guide for more information on running multiple instances. The default instance is 0.

enable_rpc

enable the XMLRPC server. This is disabled by default to improve out-of-the-box security.

port the TCP port used by the XMLRPC server.

FILES

/etc/arm4.conf

REPORTING BUGS

Report bugs at <http://www.arm4.org>

COPYRIGHT

Copyright © 2005-2007 arm4.org

This is free software. You may redistribute copies of it under terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

arm4_daemon(8), arm4_report(1), arm4_dump(8)