doc/manual.docbook
branchdebian
changeset 186 4fa13d8412c1
parent 185 f8f8b4018381
child 221 c4c3facf5d6b
equal deleted inserted replaced
183:6569a18b8a52 186:4fa13d8412c1
    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.