From: Heiko Schlittermann (HS12-RIPE) Date: Tue, 1 Nov 2016 15:06:59 +0000 (+0100) Subject: Refer to run_cron instead of run_cron.sh X-Git-Url: https://git.exim.org/buildfarm-client-wiki.git/commitdiff_plain/0d0a1126a5cbdb93169abf2cddcb8f8cacf0829d Refer to run_cron instead of run_cron.sh --- diff --git a/Installation.md b/Installation.md index 1897d5a..26a7f13 100644 --- a/Installation.md +++ b/Installation.md @@ -35,7 +35,7 @@ This will create the repo checkout in the directory *~/code/*. 15. Test the test suite by running `./run_build.pl --test --verbose=2 --only-steps=configure,make,test --override range_num_tests='1 2'`. There will be one error on a standard system: the Exim test suite uses ifconfig to obtain the IP address, and this binary is frequently not in a regular user's path. Temporarily fix this by running `export PATH="/usr/sbin:/sbin:$PATH"` to prepend the probably directories where that command is located to your regular user path. (Instructions on how to do this automatically in the cron job are below). 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). 16. 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,make-doc`. For documentation generation to succeed, it will require extra packages to be installed to support xml, xslt, pdf, and a few other things. Please see the comments on the [Building Documentation](https://github.com/mrballcb/exim-build-farm-client/wiki/BuildingDocs) page. 17. If you can get past each of these steps, then your build farm system meets the minimum requirements. -18. 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. The official process can be kicked off by running `/home/farm/code/run_cron --run-all`. This will run the default build configuration, keep track of the git repository status, and upload the build results to the server. 19. 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 2 hours. If a previous instantiation is still running, the script will detect the lockfile and exit so as not to step on each other. I had a problem running the *run_cron.sh* script in that cron gives a highly sanitized path to the script when it runs it. I made a second script to call the first one so I could insert path elements in that were needed:
$ more /home/farm/bin/build_farm.sh
 #!/bin/bash