editor-manual/chapter02/cvsssh.xml

   1 <sect1 id="ch02-cvsssh">
   2 <title>CVS SSH Access (for editors)</title>
   3 <?dbhtml filename="cvsssh.html" dir="chapter02"?>
   4
   5 <para>For editors, access is slightly more complicated. You first of
   6 all need to generate yourself an ssh key-pair. You then need to upload
   7 your public key into your <filename>~/.ssh</filename> directory on
   8 shadowfax. To generate the keys run:</para>
   9
  10 <para><screen><userinput>ssh-keygen -t dsa</userinput></screen></para>
  11
  12 <para>When prompted as to where to save them, it's probably best to leave
  13 them in .ssh (as <filename>id_dsa</filename> and
  14 <filename>id_dsa.pub</filename>) unless you already have ssh keys there.
  15 When prompted for a passphrase just press enter (unless you want to have
  16 to give the phrase <emphasis>every</emphasis> time you perform a cvs
  17 operation.  Having generated your keys, upload
  18 <filename>~/.ssh/id_dsa.pub</filename> to shadowfax and move it to
  19 <filename>~/.ssh/authorized_keys2</filename> <emphasis>on
  20 shadowfax</emphasis>.  (Your local copy of <filename>id_dsa</filename>
  21 and <filename>id_dsa.pub</filename> should remain untouched by
  22 this.)</para>
  23
  24 <para>Once you've done this, you need to set environment variables like
  25 this:</para>
  26
  27 <para><screen><userinput>export CVS_RSH=ssh &amp;&amp;
  28 export CVSROOT=:ext:USERNAME@cvs.linuxfromscratch.org:/home/cvsroot</userinput></screen></para>
  29
  30 <para>Replace <emphasis>USERNAME</emphasis> with your shadowfax username.</para>
  31
  32 <para>Once you have this setup, try to checkout the LFS tree by
  33 running:</para>
  34
  35 <para><screen><userinput>cvs checkout BLFS</userinput></screen></para>
  36
  37 <para>If this works, you'll get the LFS directory listing and you have
  38 your own sandbox.  You also have write access so from now on be extra
  39 careful but note that <emphasis>no</emphasis> changes will be made until
  40 you use a <userinput>cvs commit</userinput> command.</para>
  41
  42 <para>As with anonymous access, you can update your local copy by simply
  43 cd'ing into the LFS directory and running:</para>
  44
  45 <para><screen><userinput>cvs update</userinput></screen></para>
  46
  47 </sect1>
  48