25 </para> |
25 </para> |
26 </section> |
26 </section> |
27 <section> |
27 <section> |
28 <title>Step by step</title> |
28 <title>Step by step</title> |
29 <para> |
29 <para> |
30 mercurial-server authenticates users not using passwords but using <link |
30 mercurial-server authenticates users not using passwords but using SSH |
31 xlink:href="http://sial.org/howto/openssh/publickey-auth/">SSH public |
31 public keys; everyone who wants access to a mercurial-server repository |
32 keys</link>; everyone who wants access to a mercurial-server repository |
|
33 will need such a key. In combination with <command>ssh-agent</command> (or |
32 will need such a key. In combination with <command>ssh-agent</command> (or |
34 equivalents such as the Windows program <link |
33 equivalents such as the Windows program <link |
35 xlink:href="http://the.earth.li/~sgtatham/putty/0.60/htmldoc/Chapter9.html#pageant">Pageant</link>), |
34 xlink:href="http://the.earth.li/~sgtatham/putty/0.60/htmldoc/Chapter9.html#pageant">Pageant</link>), |
36 this means that users will not need to type in a password to access the |
35 this means that users will not need to type in a password to access the |
37 repository. |
36 repository. If you're not familiar with SSH public keys, the <link |
|
37 xlink:href="http://sial.org/howto/openssh/publickey-auth/">OpenSSH Public |
|
38 Key Authentication tutorial</link> may be helpful. |
38 </para> |
39 </para> |
39 <section> |
40 <section> |
40 <title>Installing mercurial-server</title> |
41 <title>Installing mercurial-server</title> |
41 <para> |
42 <para> |
42 In what follows, we assume that your username is <systemitem |
43 In what follows, we assume that your username is <systemitem |
43 class="username">jay</systemitem>, that you usually sit at a machine called |
44 class="username">jay</systemitem>, that you usually sit at a machine called |
44 <systemitem class="systemname">my-workstation</systemitem> and you wish to |
45 <systemitem class="systemname">my-workstation</systemitem> and you wish to |
45 install mercurial-server on <systemitem |
46 install mercurial-server on <systemitem |
46 class="systemname">repository-host</systemitem>. We assume that you have created your SSH public key, set up your SSH agent with this key, and that this key gives you access to <systemitem |
47 class="systemname">repository-host</systemitem>. We assume that you have created your SSH public key, set up your SSH agent with this key, and that this key gives you access to <systemitem |
47 class="systemname">repository-host</systemitem>. If you're not familiar with SSH public keys, the <link |
48 class="systemname">repository-host</systemitem>. |
48 xlink:href="http://sial.org/howto/openssh/publickey-auth/">OpenSSH Public |
|
49 Key Authentication tutorial</link> may be helpful. |
|
50 </para> |
49 </para> |
51 <para>First install mercurial-server on <systemitem |
50 <para>First install mercurial-server on <systemitem |
52 class="systemname">repository-host</systemitem>:</para> |
51 class="systemname">repository-host</systemitem>:</para> |
53 <screen> |
52 <screen> |
54 <computeroutput>jay@my-workstation:~$ </computeroutput><userinput>scp mercurial-server_0.6.1_amd64.deb repository-host:</userinput> |
53 <computeroutput>jay@my-workstation:~$ </computeroutput><userinput>scp mercurial-server_0.6.1_amd64.deb repository-host:</userinput> |