= Configuration =

There are three levels of configuration in imip-agent:

 * `config.sh` provides system-level and tool configuration
 * `config.py` provides the configuration of the software itself
 * User preferences reside as files in separate user-specific directories

These files are by default installed into the `/etc/imip-agent` directory
and they can be changed in that location once the system is installed.

{{{#!wiki tip
=== Text Encoding ===
The textual encoding employed by the preferences files is UTF-8.
}}}

== System-Level and Tool Configuration ==

Given a choice of [[../SystemUsers|system users and groups]], the
resulting configuration must be indicated in the `config.sh` file. Since
the `tools/install.sh` script depends on this configuration, changes must
be made to the file in the `tools/config.sh` location before installation
can occur.

== Software Configuration ==

Any changes to filesystem locations may need to be incorporated into the
`config.py` file, which is found in the `imiptools/config.py` location of
the distribution. There is, however, no urgency in changing this file
before installation, and it can be edited in its installed location to
achieve the same effects.

The agent system configuration dictates how the software behaves, and the
`config.py` file provides system-level settings (filesystem locations
and file permissions), service-level settings (e-mail address and Web site
choices), and default policies for users of the software.

== User Preferences ==

Although the software configuration in `config.py` provides default policies,
users can choose to override these defaults by editing their own preferences.
The most convenient way of doing this is to use the profile page provided by
the [[../CalendarManager|management interface]].

The settings for the different policies are described in the
[[../Preferences|preferences guide]].
