doc/manual.docbook
changeset 185 f8f8b4018381
parent 179 243dd21d0dbc
child 221 c4c3facf5d6b
equal deleted inserted replaced
184:ec3047e1dadc 185:f8f8b4018381
    36 repository. If you're not familiar with SSH public keys, the <link
    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
    37 xlink:href="http://sial.org/howto/openssh/publickey-auth/">OpenSSH Public
    38 Key Authentication tutorial</link> may be helpful.
    38 Key Authentication tutorial</link> may be helpful.
    39 </para>
    39 </para>
    40 <section>
    40 <section>
    41 <title>Installing mercurial-server</title>
    41 <title>Initial access to mercurial-server</title>
    42 <para>
    42 <para>
    43 In what follows, we assume that your username is <systemitem
    43 In what follows, we assume that your username is <systemitem
    44 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
    45 <systemitem class="systemname">spoon</systemitem> and you wish to
    45 <systemitem class="systemname">spoon</systemitem> and you have
    46 install mercurial-server on <systemitem
    46 installed mercurial-server on <systemitem
    47 class="systemname">jeeves</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">jeeves</systemitem> using the package management system (see the README for more on installation). 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
    48 class="systemname">jeeves</systemitem>.  
    48 class="systemname">jeeves</systemitem>.  
    49 </para>
    49 </para>
    50 <para>First install mercurial-server on <systemitem
    50 <screen><computeroutput>jay@spoon:~$ </computeroutput><userinput>ssh -A jeeves</userinput>
    51 class="systemname">jeeves</systemitem>:</para>
    51 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>ssh-add -L > my-key</userinput>
    52 <screen><computeroutput>jay@spoon:~$ </computeroutput><userinput>scp mercurial-server_0.6.1_amd64.deb jeeves:</userinput>
       
    53 <computeroutput>mercurial-server_0.6.1_amd64.deb 100%
       
    54 jay@spoon:~$ </computeroutput><userinput>ssh -A jeeves</userinput>
       
    55 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo dpkg -i mercurial-server_0.7_amd64.deb</userinput>
       
    56 <computeroutput>[sudo] password for jay: 
       
    57 Selecting previously deselected package mercurial-server.
       
    58 (Reading database ... 144805 files and directories currently installed.)
       
    59 Unpacking mercurial-server (from .../mercurial-server_0.7_amd64.deb) ...
       
    60 Setting up mercurial-server (0.7) ...
       
    61 jay@jeeves:~$ </computeroutput></screen>
       
    62 <para>
       
    63 mercurial-server is now installed on the repository host.  Next, we need to give you permission to access its repositories.
       
    64 </para>
       
    65 <screen><computeroutput>jay@jeeves:~$ </computeroutput><userinput>ssh-add -L > my-key</userinput>
       
    66 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo mkdir -p /etc/mercurial-server/keys/root/jay</userinput>
    52 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo mkdir -p /etc/mercurial-server/keys/root/jay</userinput>
    67 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo cp my-key /etc/mercurial-server/keys/root/jay/spoon</userinput>
    53 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo cp my-key /etc/mercurial-server/keys/root/jay/spoon</userinput>
    68 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo -u hg /usr/share/mercurial-server/refresh-auth</userinput>
    54 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo -u hg /usr/share/mercurial-server/refresh-auth</userinput>
    69 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>exit</userinput>
    55 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>exit</userinput>
    70 <computeroutput>Connection to jeeves closed.
    56 <computeroutput>Connection to jeeves closed.