/mandos/release

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/release

« back to all changes in this revision

Viewing changes to debian/mandos-client.README.Debian

  • Committer: Teddy Hogeborn
  • Date: 2014-07-17 00:49:30 UTC
  • mto: (237.7.272 trunk)
  • mto: This revision was merged to the branch mainline in revision 319.
  • Revision ID: teddy@recompile.se-20140717004930-tqfjwjvonrtfcr7w
mandos-ctl: Make it work in Python 3.

* mandos-ctl: Tolerate failure of importing future_builtins.  If
              Python 2, override "str" with "unicode".
  (print_clients): Use "str" instead of "unicode".
  (main): Use 'type=argparse.FileType(mode="rb")' instead of
          'type=file', and use the items() method instead of
          iteritems().

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
This file documents the next steps to take after installation of the
2
 
Debian package, and also contain some notes specific to the Debian
3
 
packaging which are not also in the manual.
4
 
 
5
1
* Adding a Client Password to the Server
6
2
  
7
3
  The server must be given a password to give back to the client on
20
16
  is possible to verify that the correct password will be received by
21
17
  this client by running the command, on the client:
22
18
  
23
 
        MANDOSPLUGINHELPERDIR=/usr/lib/$(dpkg-architecture \
24
 
        -qDEB_HOST_MULTIARCH)/mandos/plugin-helpers \
25
19
        /usr/lib/$(dpkg-architecture -qDEB_HOST_MULTIARCH \
26
20
        )/mandos/plugins.d/mandos-client \
27
21
                --pubkey=/etc/keys/mandos/pubkey.txt \
43
37
  automatically detected.  If this should result in incorrect
44
38
  interfaces, edit the DEVICE setting in the
45
39
  "/etc/initramfs-tools/initramfs.conf" file.  (The default setting is
46
 
  empty, meaning it will autodetect the interfaces.)  *If* the DEVICE
 
40
  empty, meaning it will autodetect the interface.)  *If* the DEVICE
47
41
  setting is changed, it will be necessary to update the initrd image
48
 
  by running this command:
 
42
  by running the command
49
43
  
50
44
        update-initramfs -k all -u
51
45
  
90
84
  "mandos=connect:<IP_ADDRESS>:<PORT_NUMBER>" on the kernel command
91
85
  line.
92
86
  
93
 
  For very advanced users, it is possible to specify simply
 
87
  For very advanced users, it it possible to specify simply
94
88
  "mandos=connect" on the kernel command line to make the system only
95
89
  set up the network (using the data in the "ip=" option) and not pass
96
90
  any extra "--connect" options to mandos-client at boot.  For this to
97
91
  work, "--options-for=mandos-client:--connect=<ADDRESS>:<PORT>" needs
98
92
  to be manually added to the file "/etc/mandos/plugin-runner.conf".
99
93
 
100
 
* Diffie-Hellman Parameters
101
 
 
102
 
  On installation, a file with Diffie-Hellman parameters,
103
 
  /etc/keys/mandos/dhparams.pem, will be generated and automatically
104
 
  installed into the initital RAM disk image and also used by the
105
 
  Mandos Client on boot.  If different parameters are needed for
106
 
  policy or other reasons, simply replace the existing dhparams.pem
107
 
  file and update the initital RAM disk image.
108
 
 
109
 
 -- Teddy Hogeborn <teddy@recompile.se>, Tue, 21 Jun 2016 21:43:49 +0200
 
94
 -- Teddy Hogeborn <teddy@recompile.se>, Mon, 28 Oct 2013 11:02:26 +0100