editor-manual/chapter02/svnssh.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6
   7 <sect1 id="ch02-svnssh">
   8 <title>Subversion SSH Access (for editors)</title>
   9 <?dbhtml filename="svnssh.html"?>
  10
  11 <para>For editors, access is slightly more complicated. You first of all need
  12 to generate an ssh key-pair. You then need to upload your public key into your
  13 <filename>~/.ssh</filename> directory on belgarath. To generate the keys run:
  14 </para>
  15
  16 <para><screen><userinput>ssh-keygen -t dsa</userinput></screen></para>
  17
  18 <para>When prompted as to where to save them, it's probably best to leave
  19 them in .ssh (as <filename>id_dsa</filename> and
  20 <filename>id_dsa.pub</filename>) unless you already have ssh keys there.
  21 When prompted for a passphrase just press enter (unless you want to have
  22 to give the phrase <emphasis>every</emphasis> time you perform a subversion
  23 operation.  But, since the same passphrase will be used when you log in to
  24 <emphasis>belgarath</emphasis> over ssh, it may be advisable to have some
  25 security in place.   Having generated your keys, upload
  26 <filename>~/.ssh/id_dsa.pub</filename> to belgarath and move it to
  27 <filename>~/.ssh/authorized_keys2</filename> <emphasis>on
  28 belgarath</emphasis>.  (Your local copy of <filename>id_dsa</filename>
  29 and <filename>id_dsa.pub</filename> should remain untouched by
  30 this.) Make sure that the ~/.ssh directory on belgarath is mode 700:</para>
  31
  32 <screen><userinput>chmod -R 700 ~/.ssh</userinput></screen>
  33
  34 <para>Once you have this setup, try to checkout the latest LFS book revision by
  35 running:</para>
  36
  37 <screen><userinput>svn checkout svn+ssh://svn.linuxfromscratch.org/LFS/trunk/BOOK lfs-trunk
  38 </userinput></screen>
  39
  40 <para>If this works, you'll checkout a copy of the current book to
  41 <filename class="directory">lfs-trunk</filename> and you will have your own
  42 local working copy.  You will also have write access so from now on be extra
  43 careful, but note that <emphasis>no</emphasis> changes will be made until you
  44 issue a <userinput>svn commit</userinput> command.</para>
  45
  46 <para>The above is fine for working in trunk, and you can checkout an individual
  47 branch in a similar manner.  But, merging changes between branches is much
  48 easier if you check out the whole tree by running:</para>
  49
  50 <screen><userinput>svn checkout svn+ssh://svn.linuxfromscratch.org/LFS LFS
  51 </userinput></screen>
  52
  53 <para>The drawback to checking out the whole tree is that you will currently
  54 get about 102M of data instead of 5M.</para>
  55
  56 <para>As with anonymous access, you can update your local copy by simply
  57 <command>cd</command>'ing into the LFS directory and running:</para>
  58
  59 <para><screen><userinput>svn update</userinput></screen></para>
  60
  61
  62 </sect1>