Geckos name is required when creating user "farm"
authorTodd Lyons <tlyons@ivenue.com>
Sat, 26 Oct 2013 20:48:08 +0000 (13:48 -0700)
committerTodd Lyons <tlyons@ivenue.com>
Sat, 26 Oct 2013 20:48:08 +0000 (13:48 -0700)
Installation.md

index 251e71e37cea6a569cd63627930c7b6527e6b11d..7a1b504b1df800a3b504c34e6fc49c01f7f3d4c1 100644 (file)
@@ -6,7 +6,8 @@ This Installation page works on the assumption that you have already submitted y
 ## Install Steps
 1. Make sure that all required packages for Exim to build successfully are installed. The minimal package requirements are the basic suite of compiler tools and basic libraries.  You will also need to install the ccache package.
 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**.
 ## Install Steps
 1. Make sure that all required packages for Exim to build successfully are installed. The minimal package requirements are the basic suite of compiler tools and basic libraries.  You will also need to install the ccache package.
 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.
+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.)
 5. Configure sudo to allow user **farm** to elevate to root without a password.  Run `visudo` and add:
 `farm    ALL=(ALL)       NOPASSWD: ALL`
 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.)
 5. Configure sudo to allow user **farm** to elevate to root without a password.  Run `visudo` and add:
 `farm    ALL=(ALL)       NOPASSWD: ALL`