wiki:Builder

Version 12 (modified by igloo, 4 years ago) (diff)

--

Setting up a nightly build

The GHC builder builds GHC on various platforms in various different ways each night, runs the test suite and performance benchmarks, and mails the results to the cvs-ghc@haskell.org mailing list. We're always keen to add more build slaves to the setup, especially if you have a platform that doesn't already have a build slave, so if you'd like to join the fun, please let us know at cvs-ghc@…. If a platform is represented in the nightly builds, it's more likely we'll be able to identify and fix problems specific to that platform quickly.

Install OpenSSL

  • On Windows, install OpenSSL from here (not the Light Version): http://www.openssl.org/related/binaries.html
  • On Linux, get OpenSSL from your distro. E.g. install openssl-devel on RedHat-derived distros (e.g. Fedora), or openssl-dev on Debian-derived distros (e.g. Ubuntu)
  • Mac OSX: someone please fill this in
  • Solaris: someone please fill this in

Install HsOpenSSL

On non-Windows:

cabal install HsOpenSSL

On Windows: I found I had to add 'ssl2' after 'eay32' in 'extra-libraries' in HsOpenSSL.cabal. So

cabal unpack HsOpenSSL
cd HsOpenSSL*
<edit HsOpenSSL.cabal, add ssl2 to extra-libraries>
cabal install --extra-include-dirs="c:/OpenSSL/include" --extra-lib-dirs="c:/OpenSSL"

To create a new build slave

You can get the code for the builder with

darcs get http://darcs.haskell.org/builder/

or, if you have an account on darcs.haskell.org,

darcs get darcs.haskell.org:/srv/darcs/builder/

Once you have built it, pick a username (something fairly unique to you) and password, and send them to igloo@… along with the time you want builds to happen. The username is used so we know which machine the build log came from, and the password is used to verify that the client is who it claims it is.

Then initialise the client by creating a new directory, and running:

builder-client init username password darcs.haskell.org

in it, where username and password are your username and password. This will create various files and subdirectories that the client will use. Then put a copy of http://darcs.haskell.org/ghcBuilder/cert/root.pem in certs/ so that the client can verify that it is connecting to the right server.

You can now run the client with:

builder-client

or

builder-client -v

We recommend running in screen for now, as the client doesn't daemonise itself yet. The client will connect to the server, and the server will tell the client how and when to do builds. The client therefore needs to be left running unless you want to stop builds from happening.

Seeing build results

The build results are uploaded to http://darcs.haskell.org/ghcBuilder/builders/