Example of proper user/group configured system.

diff --git a/Installation.md b/Installation.md
index 0a0cf1c205b0dcf799575af39f01bd1a13c0f21b..1a578f87b4d30e01157cb45189e12b466aee5285 100644 (file)
--- a/Installation.md
+++ b/Installation.md
@@ -10,7 +10,11 @@ If you want to run more than one instance of the build farm to test multiple dif
 2. Create the master exim user (i.e. the user that Exim changes uid to when it runs in normal operation).  I suggest the user **exim**.  If you already have the Exim package provided by your distro installed, chances are good that you already have a user named **exim** or **exim4**.  That user is fine.  This howto also assumes you use the groupname **exim**.
 3. Create a user that will run the Build Farm.  I suggest the user **farm**.  Due to some assumptions that are made in the test suite, the group name must also be **farm**. It is ok if you make it a secondary group or the primary group.  You also must assign a geckos name, or some tests will fail.  I suggest "Exim BuildFarm".  An example command that should work for most distributions:
 `useradd -m -c 'Exim BuildFarm' farm`
 2. Create the master exim user (i.e. the user that Exim changes uid to when it runs in normal operation).  I suggest the user **exim**.  If you already have the Exim package provided by your distro installed, chances are good that you already have a user named **exim** or **exim4**.  That user is fine.  This howto also assumes you use the groupname **exim**.
 3. Create a user that will run the Build Farm.  I suggest the user **farm**.  Due to some assumptions that are made in the test suite, the group name must also be **farm**. It is ok if you make it a secondary group or the primary group.  You also must assign a geckos name, or some tests will fail.  I suggest "Exim BuildFarm".  An example command that should work for most distributions:
 `useradd -m -c 'Exim BuildFarm' farm`

-4. Add **exim** as a secondary group to the **farm** user.  (You should **NOT** add **farm** as a secondary group to the exim user; this will cause test errors.)
+4. Add **exim** as a secondary group to the **farm** user.  (You should **NOT** add **farm** as a secondary group to the exim user; this will cause test errors.)  Here is a sample user/group configuration:
+<pre><code>farm@buildclient:~/code$ id farm
+uid=1001(farm) gid=1001(farm) groups=1001(farm),137(exim)
+farm@buildclient:~/code$ id exim
+uid=480(exim) gid=137(exim) groups=137(exim)</code></pre>

 5. Configure sudo to allow user **farm** to elevate to root without a password.  Run `visudo` and add:
 `farm    ALL=(ALL)       NOPASSWD: ALL`
 6. Change to the **farm** user.
 5. Configure sudo to allow user **farm** to elevate to root without a password.  Run `visudo` and add:
 `farm    ALL=(ALL)       NOPASSWD: ALL`
 6. Change to the **farm** user.