paul@955 | 1 | = Getting Started = |
paul@955 | 2 | |
paul@955 | 3 | To get imip-agent running on your own system you will need the following: |
paul@955 | 4 | |
paul@955 | 5 | * The ability to install software and to configure the system |
paul@955 | 6 | * A working mail configuration |
paul@955 | 7 | |
paul@955 | 8 | It is possible to [[../Testing|test the agent programs]] without these |
paul@955 | 9 | abilities, but any difficulties in getting the software to work will be |
paul@955 | 10 | compounded by any problem or deficiency in either of these areas. |
paul@955 | 11 | |
paul@955 | 12 | == Configuring System Users == |
paul@955 | 13 | |
paul@955 | 14 | The [[../SystemUsers|system users guide]] indicates the requirements for |
paul@955 | 15 | system user and group configuration. |
paul@955 | 16 | |
paul@955 | 17 | If you are comfortable configuring your mail system, you may decide to |
paul@955 | 18 | choose the [[../MailIntegration/LocalSMTP|local SMTP delivery]] approach. |
paul@955 | 19 | |
paul@955 | 20 | If you already use mail storage solutions that employ LMTP, you may decide |
paul@955 | 21 | to choose the [[../MailIntegration/LMTP|LMTP delivery]] approach. |
paul@955 | 22 | |
paul@955 | 23 | == Installing the Software == |
paul@955 | 24 | |
paul@955 | 25 | Ideally, an operating system distribution package should be used to |
paul@955 | 26 | install the software. As a result, the software should already be suitably |
paul@955 | 27 | integrated and configured and guidance will be available to get everything |
paul@955 | 28 | working. |
paul@955 | 29 | |
paul@955 | 30 | 1. In the absence of a suitable system package, the installation locations |
paul@955 | 31 | and system user details must first be configured, as described above. |
paul@955 | 32 | |
paul@955 | 33 | 1. Then, the `tools/install.sh` script should install the software in |
paul@955 | 34 | appropriate locations. You may need to be `root` or use `sudo` to |
paul@955 | 35 | successfully use this script. |
paul@955 | 36 | |
paul@961 | 37 | {{{ |
paul@961 | 38 | tools/install.sh |
paul@961 | 39 | }}} |
paul@961 | 40 | |
paul@955 | 41 | See the [[../Prerequisites|prerequisites]] for other software that will be |
paul@955 | 42 | required for the software to function. |
paul@955 | 43 | |
paul@955 | 44 | == Initialising the Software == |
paul@955 | 45 | |
paul@955 | 46 | Once a suitable system user has been chosen, stored and published data is then |
paul@955 | 47 | initialised using the `tools/init.sh` script. The script employs the setgid |
paul@955 | 48 | flag on the directories initialised for stored and published data so that new |
paul@955 | 49 | files and directories have the appropriate group associated with them. |
paul@955 | 50 | |
paul@955 | 51 | It should be possible to omit all arguments to the `init.sh` script, but it is |
paul@955 | 52 | also worth reading the help message: |
paul@955 | 53 | |
paul@955 | 54 | {{{ |
paul@955 | 55 | tools/init.sh --help |
paul@955 | 56 | }}} |
paul@955 | 57 | |
paul@955 | 58 | Fixing ownership can be done using the `tools/fix.sh` script, in case some form |
paul@955 | 59 | of modification has altered the ownership or membership of the created files |
paul@955 | 60 | and directories. |
paul@955 | 61 | |
paul@955 | 62 | == Configuring Other Software == |
paul@955 | 63 | |
paul@955 | 64 | The `conf` directory contains subdirectories for different systems: |
paul@955 | 65 | |
paul@961 | 66 | {{{#!table |
paul@961 | 67 | '''Directory''' || '''Description''' || '''Guide''' |
paul@961 | 68 | == |
paul@961 | 69 | `apache` |
paul@961 | 70 | || Apache 2 site configuration for publishing resources |
paul@961 | 71 | || [[../WebServerIntegration|Web Server Integration]] |
paul@961 | 72 | == |
paul@961 | 73 | `cron` |
paul@961 | 74 | || Cron command scheduling for free/busy updates |
paul@961 | 75 | || [[../CronIntegration|Cron Task Scheduler Integration]] |
paul@961 | 76 | == |
paul@961 | 77 | `exim` |
paul@961 | 78 | || Exim 4 routing and transport configuration |
paul@988 | 79 | || [[../MailIntegration|E-Mail Integration]] and |
paul@988 | 80 | .. [[../MailboxIntegration|Mailbox Integration]] |
paul@961 | 81 | == |
paul@961 | 82 | `ldap` |
paul@961 | 83 | || Some LDAP-related resources |
paul@961 | 84 | || |
paul@961 | 85 | == |
paul@961 | 86 | `postfix` |
paul@961 | 87 | || Postfix routing and transport configuration |
paul@988 | 88 | || [[../MailIntegration|E-Mail Integration]] and |
paul@988 | 89 | .. [[../MailboxIntegration|Mailbox Integration]] |
paul@961 | 90 | }}} |
paul@955 | 91 | |
paul@961 | 92 | == Configuring the Software == |
paul@955 | 93 | |
paul@961 | 94 | The behaviour of the imip-agent software itself can be configured using |
paul@961 | 95 | mechanisms described in the [[../Configuration|configuration guide]]. |
paul@988 | 96 | |
paul@988 | 97 | == Using the Software == |
paul@988 | 98 | |
paul@988 | 99 | With everything configured, it should be possible to get started using |
paul@988 | 100 | the software. See the [[../Usage|usage guide]] for details. |