1.1 --- a/README.txt Sat Sep 12 20:16:38 2015 +0200
1.2 +++ b/README.txt Sun Sep 13 00:50:38 2015 +0200
1.3 @@ -17,6 +17,17 @@
1.4 System User and Filesystem Access
1.5 ---------------------------------
1.6
1.7 +The data handled by imip-agent needs to be accessible to other software,
1.8 +notably mail handling software and Web server software. Two approaches are
1.9 +described here: LMTP delivery and local SMTP delivery.
1.10 +
1.11 +LMTP Delivery
1.12 +-------------
1.13 +
1.14 +Here, imip-agent's programs run in a way that permits LMTP delivery (requiring
1.15 +suitable local privileges to communicate with the mail storage solution)
1.16 +whilst allowing the Web server to read data written by those programs.
1.17 +
1.18 A system group needs to be created for LMTP delivery and for certain users to
1.19 share resources:
1.20
1.21 @@ -41,10 +52,32 @@
1.22 and published data so that new files and directories have the appropriate
1.23 group associated with them.
1.24
1.25 +It should be possible to omit all arguments to the init.sh script, but it is
1.26 +also worth reading the help message:
1.27 +
1.28 + tools/init.sh --help
1.29 +
1.30 Fixing ownership can be done using the tools/fix.sh script, in case some form
1.31 of modification has altered the ownership or membership of the created files
1.32 and directories.
1.33
1.34 +Local SMTP Delivery
1.35 +-------------------
1.36 +
1.37 +Here, imip-agent's programs run in a way that permits local SMTP delivery
1.38 +(which merely needs the ability to connect to a local network service) whilst
1.39 +allowing the Web server to read data written by those programs.
1.40 +
1.41 +A system user needs to be created and to belong to certain groups in order to
1.42 +deliver messages to mail stores and to publish resources on the Web:
1.43 +
1.44 + useradd -d /var/lib/imip-agent -m -U -G www-data -r imip-agent
1.45 +
1.46 +Again, the tools/init.sh script will initialise directories for stored and
1.47 +published data. For example:
1.48 +
1.49 + tools/init.sh imip-agent www-data
1.50 +
1.51 Installing the Software
1.52 -----------------------
1.53