X-Git-Url: https://git.exim.org/buildfarm-client-wiki.git/blobdiff_plain/7b9de6cee08a1a5ec80bbc2acc00b688cb42451f..019c859643bc0f20168968a81de541460bfc302c:/Installation.md diff --git a/Installation.md b/Installation.md index 01bbfd9..f0161a1 100644 --- a/Installation.md +++ b/Installation.md @@ -24,12 +24,12 @@ This will create the repo checkout in the directory *~/code/*. 14. Test the test suite by running `./run_build.pl --test --verbose=2 --only-steps=configure,make,test --override range_num_tests='1 2'`. If there are build errors when building the test suite, or runtime errors trying to run the test suite, you may need to install additional packages (you shouldn't though). 15. If you enabled the documentation building process in the *build-farm.conf*, then you can try to build it with `./run_build.pl --test --verbose=2 --only-steps=configure,build_docs`. For documentation generation to succeed, it will require extra packages to be installed to support xml, xslt, pdf, and a few other things. 16. If you can get past each of these steps, then your build farm system meets the minimum requirements. -17. The official process can be kicked off by running `/home/farm/code/run_cron.sh`. This will run the default build configuration, keep track of the git repository status, and upload the build results to the server. +17. The official process can be kicked off by running `/home/farm/code/run_cron.sh --run-all`. This will run the default build configuration, keep track of the git repository status, and upload the build results to the server. 18. Once that command runs with no complaints, add it to the **farm** user crontab. You can run it at whatever frequency you choose, I suggest 1 hour. If a previous instantiation is still running, the script will detect the lockfile and exit so as not to step on each other. ## Overview -In the default configuration, a full rebuild of Exim will occur every 7 days, and it will also build and run the test suite. You can choose to also have it also build the docs, but there are several extra package requirements for it to build the documentation. +In the default configuration, a full rebuild of Exim will occur when a new commit to the monitored branches occurs or every 7 days, and it will also build and run the test suite. You can choose to have it also build the docs, but there are several extra package requirements for it to build the documentation. Review your enabled features in the Makefile and make adjustments to your *build-farm.conf* to enable those features, using either the makefile_set, makefile_add, or makefile_regex. You may also receive requests from the developers to enable specific features on your build.