/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
-*- org -*-

* Prerequisites
  
  Debian 5.0 "lenny" or Ubuntu 8.04 "Hardy Heron".
  
  The following libraries and packages are needed.  (It is possible
  that it might work with older versions of some of these, but these
  versions are confirmed to work.  Newer versions are almost certainly
  OK.)
  
** Documentation
   These are required to build the manual pages for both the server
   and client:
   
   + DocBook 4.5          http://www.docbook.org/
   + DocBook XSL stylesheets 1.71.0
                   http://wiki.docbook.org/topic/DocBookXslStylesheets
  
** Mandos Server
   + GnuTLS 2.4           http://www.gnu.org/software/gnutls/
   + Avahi 0.6.16         http://www.avahi.org/
   + Python 2.4           http://www.python.org/
   + Python-GnuTLS 1.1.5  http://pypi.python.org/pypi/python-gnutls/
   + dbus-python 0.82.4   http://dbus.freedesktop.org/doc/dbus-python/
   + python-ctypes 1.0.0  http://pypi.python.org/pypi/ctypes
   
   Strongly recommended:
   + fping 2.4b2-to-ipv6  http://www.fping.com/
  
** Mandos Client
   + initramfs-tools 0.85i
                  http://packages.qa.debian.org/i/initramfs-tools.html
   + GnuTLS 2.4           http://www.gnu.org/software/gnutls/
   + Avahi 0.6.16         http://www.avahi.org/
   + GnuPG 1.4.9          http://www.gnupg.org/
   + GPGME 1.1.6          http://www.gnupg.org/related_software/gpgme/

* Installing the Mandos server
  
  + Do "make doc".
  
  + On the computer to run as a Mandos server, run the following
    command: "sudo make install-server".
    
    (This creates a configuration without any clients configured; we
    need an actually configured client to do that; see below.)

* Installing the Mandos client.
  
  + Do "make all doc".
  
  + On the computer to run as a Mandos server, run the following
    command: "sudo make install-client".  This will also create an
    OpenPGP key, which will take some time and entropy, so either wait
    patiently or frob your mouse until it's done.
  
  + Run "mandos-keygen --password".  When prompted, enter the
    password/passphrase for the encrypted root file system on this
    client computer.  It will output a section of text, starting with
    a [section header].  Copy and paste this into the
    "/etc/mandos/clients.conf" file *on the server computer*.
  
  + On the server computer, start the server by running the command
    "invoke-rc.d mandos start".

* Further customizations
  
  You may want to tighten or loosen the timeouts in the server
  configuration files; see mandos.conf(5) and mandos-clients.conf(5).
  Is IPsec is not used, it is suggested that a more cryptographically
  secure checker program is used and configured, since without IPsec
  ping packets can be faked.