Getting Started

To get imip-agent running on your own system you will need the following:

It is possible to test the agent programs without these abilities, but any difficulties in getting the software to work will be compounded by any problem or deficiency in either of these areas.

  1. Obtaining the Software
  2. Configuring System Users
  3. Installing the Software
  4. Initialising the Software
  5. Integrating with Other Software
  6. Configuring the Software
  7. Administering the Software
  8. Using the Software

Obtaining the Software

To get started, the imip-agent software must be downloaded and any prerequisites installed, the latter being software that imip-agent needs to work with. The choice of prerequisites will influence some of the activities described below.

Configuring System Users

The system users guide indicates the requirements for system user and group configuration.

If you are comfortable configuring your mail system, you may decide to choose the local SMTP delivery approach.

If you already use mail storage solutions that employ LMTP, you may decide to choose the LMTP delivery approach.

Once you have decided which approach is the most preferable, you will be able to use this choice to influence the configuration process mentioned below.

Installing the Software

Ideally, an operating system distribution package should be used to install the software. As a result, the software should already be suitably integrated and configured and guidance will be available to get everything working.

  1. In the absence of a suitable system package, the installation locations and system user details must first be configured, as described above.
  2. Then, the tools/install.sh script should install the software in appropriate locations. You may need to be root or use sudo to successfully use this script.
    tools/install.sh
    

See the prerequisites for other software that will be required for the software to function.

Initialising the Software

Once a suitable system user has been chosen, stored and published data is then initialised using the tools/init.sh script. The script employs the setgid flag on the directories initialised for stored and published data so that new files and directories have the appropriate group associated with them.

It should be possible to omit all arguments to the init.sh script, but it is also worth reading the help message:

tools/init.sh --help

Fixing ownership can be done using the tools/fix.sh script, as described in the administration guide in case some form of modification has altered the ownership or membership of the created files and directories.

Integrating with Other Software

The conf directory in the imip-agent source code distribution contains subdirectories for different systems:

Directory

Description

Guide

apache

Apache 2 site configuration for publishing resources

Web Server Integration

cron

Cron command scheduling for free/busy updates

Cron Task Scheduler Integration

exim

Exim 4 routing and transport configuration

E-Mail Integration and Mailbox Integration

ldap

Some LDAP-related resources

postfix

Postfix routing and transport configuration

E-Mail Integration and Mailbox Integration

postgresql

PostgreSQL configuration

Database Store

In addition, a tools directory provides a configuration helper tool that can be used to quickly customise the above resources and produce files that, after review, may be deployed.

conf/tools/configure.sh --help

Use of this tool is covered in the configuration guide.

Configuring the Software

The behaviour of the imip-agent software itself can be configured using mechanisms described in the configuration guide.

Administering the Software

With the basic configuration performed, all that remains is to perform any necessary administration tasks to set the software up for certain kinds of users or participants.

Using the Software

With configuration and administration performed, it should be possible to get started using the software. See the usage guide for details.