doc: Augment the "Installation" section with material by Visser & Dolstra.

[?]

Mar 16, 2011, 7:56 AM

EKNK5AHQNJDKGLFPEX6CQXNPVIOWX3JXEP2H5YUZ4UFWCZ3HEJLQC

Dependencies

[2] KBW3FDZ2 Merge remote branch 'remotes/origin/master'
[3] HN7JDKV3 doc: Mention SQLite.

Change contents

edit in doc/manual/installation.xml at line 6

[2.408]

[2.408]

<para>
This chapter explains how to install Hydra on your own build farm server.
</para>
edit in doc/manual/installation.xml at line 15

[2.564]

[2.564]
replacement in doc/manual/installation.xml at line 17

[2.588]→[2.588:697](∅→∅)

<listitem><para>Nix</para></listitem>
<listitem><para>PostgreSQL</para></listitem>

[2.588]

[2.697]

<listitem>Nix</listitem>
<listitem>either PostgreSQL or SQLite</listitem>
<listitem>many Perl packages, notably Catalyst,
EmailSender, and NixPerl (see the <link
xlink:href="https://svn.nixos.org/repos/nix/nixpkgs/trunk/pkgs/development/tools/misc/hydra/default.nix">Hydra
expression in Nixpkgs</link> for the complete
list).</listitem>
replacement in doc/manual/installation.xml at line 25

[2.722]→[2.722:862](∅→∅)

At the moment, Hydra runs only on 32 bit and 64 bit Linux (<emphasis>i686-linux</emphasis> and <emphasis>x86_64_linux</emphasis>).

[2.722]

[2.862]

At the moment, Hydra runs only on GNU/Linux
(<emphasis>i686-linux</emphasis> and
<emphasis>x86_64_linux</emphasis>).
edit in doc/manual/installation.xml at line 30

[2.878]

[2.878]

<para>
For small projects, Hydra can be run on any reasonably
modern machine. For individual projects you can even run
Hydra on a laptop. However, the charm of a buildfarm server
is usually that it operates without disturbing the
developer's working environment and can serve releases over
the internet. In conjunction you should typically have your
source code administered in a version management system,
such as subversion. Therefore, you will probably want to
install a server that is connected to the internet. To scale
up to large and/or many projects, you will need at least a
considerable amount of diskspace to store builds. Since
Hydra can schedule multiple simultaneous build jobs, it can
be useful to have a multi-core machine, and/or attach
multiple build machines in a network to the central Hydra
server.
</para>

<para>
Of course we think it is a good idea to use the <a
href="http://nixos.org/nixos">NixOS</a> GNU/Linux
distribution for your buildfarm server. But this is not a
requirement. The Nix software deployment system can be
installed on any GNU/Linux distribution in parallel to the
regular package management system. Thus, you can use Hydra
on a Debian, Fedora, SuSE, or Ubuntu system.
</para>
edit in doc/manual/installation.xml at line 59

[2.887]

[2.887]

</section>

<section>
<title>Getting Nix</title>

<para>
If your server runs NixOS you are all set to continue with
installation of Hydra. Otherwise you first need to install
Nix. The latest stable version can be found one <link
xlink:href="http://nixos.org/nix/download.html">the Nix web
site</link>, along with a manual, which includes installation
instructions.
</para>
edit in doc/manual/installation.xml at line 76

[2.953]

[2.953]

<para>
Hydra can be installed using Nixpkgs:

<screen>
nix-env -Ai hydra -f /path/to/nixpkgs</screen>

This makes the tools available in your Nix user environment,
<literal>$HOME/.nix-profile</literal> by default.
</para>
replacement in doc/manual/installation.xml at line 88

[2.968]→[2.968:1182](∅→∅)

Hydra can be installed by visiting the URL,
<screen>
http://hydra.nixos.org/view/hydra/unstable</screen>
and use the one-click install available at one of the build pages. You could also

[2.968]

[2.1182]

Alternatively, the latest development snapshot can be
installed by visiting the URL
<link xlink:href="http://hydra.nixos.org/view/hydra/unstable"><literal>http://hydra.nixos.org/view/hydra/unstable</literal></link>
and use the one-click install available at one of the build pages. You can also
edit in doc/manual/installation.xml at line 98

[2.1398]

[2.1398]

</para>

<para>
Command completion should reveal a number of command-line tools from Hydra:
replacement in doc/manual/installation.xml at line 103

[2.1399]→[2.1399:1415](∅→∅)

</para>

[2.1399]

[2.1415]

<screen>
hydra_build.pl hydra_eval_jobs hydra_server.pl
hydra_control.sh hydra_evaluator.pl hydra_update_gc_roots.pl
hydra_create.pl hydra_queue_runner.pl </screen>
</para>