Use https in links to exim.org
[buildfarm-client-wiki.git] / Installation.md
index 36e7265517e51c4ddc71b9e7c1c7b4f7b14a761c..471d6d135235616c06e094f425b57544bfa7fc9e 100644 (file)
@@ -7,10 +7,20 @@ If you want to run more than one instance of the build farm to test multiple dif
 
 ## 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.
+A set needed for basic build (not including the buildfarm!) of a bulky-configuration Exim on Fedora 27 is:
+git gcc make
+pcre-devel
+libdb-devel libXaw-devel libXt-devel libidn2-devel libidn-devel
+lmdb-devel sqlite-devel hiredis-devel postgresql-devel mysql-devel
+openssl-devel openldap-devel
+perl-ExtUtils-Embed perl-experimental
+redhat-rpm-config
 
 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**, **exim4**, or **Debian-exim**.  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:
+3. Create a user that will run the Build Farm.  I suggest the user **farm**.
+It can be your normal login, but be warned: you'll be giving it passwordless "sudo" permissions.
+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 GeCos 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.)  Here is a sample user/group configuration:
@@ -69,7 +79,7 @@ This will create the repo checkout in the directory *~/code/*.
     $HOME/code/run_cron --run-all $@
     ````
 
-20. The default tests that are run are a limited set, from 1 to 999.  This covers basic Exim functions, but does not exercise a lot of the advanced functions.  Once a few cronjob runs complete successfully, increase the range of tests to run.  Edit the *build-farm.conf* file and change the `range_num_tests => '1 999',` to `range_num_tests => '1 5999',` and it will run more advanced tests.
+20. The default tests that are run are a limited set, from 1 to 999.  This covers basic Exim functions, but does not exercise a lot of the advanced functions.  Once a few cronjob runs complete successfully, increase the range of tests to run.  Edit the *build-farm.conf* file and change the `range_num_tests => '1 2',` to `range_num_tests => '1 5999',` and it will run more advanced tests.
 
 
 ## Multiple build clients on one machine