platform-vcm-home/docs/online/cvs_features2.0/cvs-faq.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.52, Mon Apr 4 17:52:44 2005 UTC revision 1.53, Wed Apr 20 18:13:09 2005 UTC
# Line 90  Line 90 
90  server?</a></li>  server?</a></li>
91        <li><a href="#ssh_2">What is the difference between ext and        <li><a href="#ssh_2">What is the difference between ext and
92  extssh?</a></li>  extssh?</a></li>
93        <li><a href="#ssh_jcraft">My SSH server only support SSH2 protocol</a></li>        <li><a href="#ssh_jcraft">My SSH server only support SSH2 protocol and
94        <li><a href="#ssh_3">How do I set up public-key authentication?</a></li>          I'm using Eclipse 2.1.x</a></li>
95          <li><a href="#ssh_3">How do I set up public-key authentication for use with
96            an external SSH client?</a></li>
97        <li><a href="#ssh_4">When I try to connect using SSH, it tells me        <li><a href="#ssh_4">When I try to connect using SSH, it tells me
98  "Could not chdir to home directory /home/user/myname". What did I do  "Could not chdir to home directory /home/user/myname". What did I do
99  wrong?</a></li>  wrong?</a></li>
100        <li><a href="#ssh_5">I got an 'Unknown response' while trying to        <li><a href="#ssh_5">I got an 'Unknown response' while trying to
101  perform CVS browsing. What went wrong?</a></li>  perform CVS browsing. What went wrong?</a></li>
102      <li><a href="#ssh_6">I can't get keys generated using Putty to work with Eclipse</a></li>
103      </ol>      </ol>
104    </li>    </li>
105    <li><b><a href="#10">Upgrading from Eclipse 1.0</a></b>    <li><b><a href="#10">Upgrading from Eclipse 1.0</a></b>
# Line 506  Line 509 
509  <!-- SSH  -->  <!-- SSH  -->
510  <h1>Using SSH with CVS</h1>  <h1>Using SSH with CVS</h1>
511  <ol>  <ol>
512    <li><b><a name="ssh_1">How do I use SSH to communicate with the    <li><b><a name="ssh_1">How do I use SSH to communicate with the server?</a></b>
513  server?</a></b>      <p>The pserver protocol sends passwords over the network in plaintext. Many
514      <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>        people prefer to establish a secure connection using SSH. Eclipse supports
515      <p>The pserver protocol sends passwords over the network in        two methods of connecting to CVS repositories using SSH. </p>
516  plaintext. Many people prefer to establish a secure connection using      <p>To use the Eclipse's built-in SSH support, simply specify "extssh" as the
517  SSH. Eclipse supports two methods of connecting to CVS repositories        connection method type when creating the repository connection.</p>
 using SSH. </p>  
     <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>  
     <p>To use the Eclipse's built-in SSH support, simply specify  
 "extssh" as the connection method type when creating the repository  
 connection.</p>  
518      <p>To use SSH support from an external tool, you must: </p>      <p>To use SSH support from an external tool, you must: </p>
519      <ol>      <ol>
520        <li>Specify "ext" as the connection method type when creating the        <li>Specify "ext" as the connection method type when creating the repository
521  repository connection.</li>          connection.</li>
522        <li>Window-&gt;Preferences-&gt;Team-&gt;CVS-&gt;Ext Connection        <li>Window-&gt;Preferences-&gt;Team-&gt;CVS-&gt;Ext Connection Method. On
523  Method. On this page, specify the name and location of your external          this page, specify the name and location of your external ssh client.
524  ssh client. (For example, "<code>C:\plink.exe</code>" or "<code>/usr/local/bin/ssh</code>").          (For example, "<code>C:\plink.exe</code>" or "<code>/usr/local/bin/ssh</code>").
525  Also specify the name and location of the CVS binary <b>on the server</b>.  Also specify the name and location of the CVS binary <b>on the server</b>.
526  The default value is often correct.</li>  The default value is often correct.</li>
527        <li>Ensure that you can log on to the server using the external        <li>Ensure that you can log on to the server using the external SSH tool
528  SSH tool <b>without specifying a password</b>.</li>          <b>without specifying a password</b>.</li>
529      </ol>      </ol>
530      <p><b>Note:</b> In Eclipse 2.1, you can also specify (on the Ext      <p><b>Note:</b> In Eclipse 2.1, you can also specify (on the Ext Connection
531  Connection Method preference page) the parameters to be passed to the        Method preference page) the parameters to be passed to the SSH client, including
532  SSH client, including the password.</p>        the password.</p>
533    </li>    </li>
   <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>  
534    <li><b><a name="ssh_2">What is the difference between ext and extssh?</a></b>    <li><b><a name="ssh_2">What is the difference between ext and extssh?</a></b>
535      <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The extssh connection method uses      <p>The extssh connection method uses a built-in SSH client. The ext connection
536  a built-in SSH client. The ext connection method allows you to specify        method allows you to specify an external SSH client to use. For extssh to
537  an external SSH client to use. For extssh to work, the server must be        work with Eclipse 2.1.x and before, the server must be running an SSH server
538  running an SSH server with SSH1 protocol compatibility. If extssh does        with SSH1 protocol compatibility. If extssh does not work, it is possible
539  not work, it is likely that the server is running only the SSH2        that the server is running only the SSH2 protocol. If this is the case,
540  protocol. If this is the case, you must configure the ext connection        you must configure the ext connection method with an external SSH client.
541  method with an external SSH client. <br>        In Eclipse 3.0 and beyond, extssh does support SSH2. </p>
     <br>  
     </p>  
542    </li>    </li>
543    <li><a name="ssh_jcraft"></a><strong>My SSH server only support SSH2    <li><a name="ssh_jcraft"></a><strong>My SSH server only support SSH2 protocol
544  protocol</strong><br>      and I'm using Eclipse 2.1.x</strong> <br>
545      <br>      <br>
546  Eclipse comes with a built-in SSH connection method called 'extssh'.      Eclipse comes with a built-in SSH connection method called 'extssh'. Prior
547  However this method only supports SSH1 servers. If your server is      to Eclipse 3.0, this method only supported SSH1 servers. If your server is
548  running SSH2 and you want to use Eclipse to connect to that server you      running SSH2 and you want to use Eclipse 2.1.x to connect to that server you
549  have two options: <br>  have two options: <br>
     <br>  
550      <ol>      <ol>
551        <li>use a command line SSH client that supports SSH2 with the        <li>use a command line SSH client that supports SSH2 with the 'ext' connection
552  'ext' connection method <br>          method <br>
553        </li>        </li>
554        <li>download a plugin created by <a        <li>download a plugin created by <a
555   href="http://www.jcraft.com/eclipse-cvsssh2/">JCraft</a> that provides   href="http://www.jcraft.com/eclipse-cvsssh2/">JCraft</a> that provides a SSH2
556  a SSH2 connection method. <br>          connection method. <br>
         <br>  
557        </li>        </li>
558      </ol>      </ol>
559  To use the 'ext' connection method, download and install an SSH command      To use the 'ext' connection method, download and install an SSH command line
560  line client for your operating environment. In the Team &gt; CVS &gt;      client for your operating environment. In the Team &gt; CVS &gt; Ext Connection
561  Ext Connection Method preference page, configure the location of the      Method preference page, configure the location of the SSH executable and how
562  SSH executable and how the executable is to be called. For the ext      the executable is to be called. For the ext method to work the CVS client
563  method to work the CVS client on your server must support the server      on your server must support the server mode. You can verify this by running
564  mode. You can verify this by running cvs --help-commands and ensure      cvs --help-commands and ensure that the server command is supported.<br>
 that the server command is supported.<br>  
565  &nbsp; </li>  &nbsp; </li>
566    <li><b><a name="ssh_3">How do I set up public-key authentication?</a></b>    <li><b><a name="ssh_3">How do I set up public-key authentication for an external
567      <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>      SSH client?</a></b>
568      <p>The steps for setting up public-key authentication vary      <p>The steps for setting up public-key authentication vary depending on your
569  depending on your SSH client. However, they all follow this set of        SSH client. However, they all follow this set of common steps: </p>
570  common steps: </p>      <ol>
571      <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>        <li>Use the client program (or a utility that came with it) to generate
572      <ol>          a public/private key pair. This program might be called ssh-keygen or
573        <li>Use the client program (or a utility that came with it) to          puttygen.exe.</li>
574  generate a public/private key pair. This program might be called        <li>Copy the public key to the server. This is often done by pasting the
575  ssh-keygen or puttygen.exe.</li>          public key into the file <code>/home/user/.ssh/authorized_keys</code>.</li>
       <li>Copy the public key to the server. This is often done by  
 pasting the public key into the file <code>/home/user/.ssh/authorized_keys</code>.</li>  
576      </ol>      </ol>
577    </li>    </li>
578    <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>    <br>
579    <li><b><a name="ssh_4">When I try to connect using SSH, it tells me    <li><b><a name="ssh_4">When I try to connect using SSH, it tells me "Could not
580  "Could not chdir to home directory /home/user/myname". What did I do      chdir to home directory /home/user/myname". What did I do wrong?</a></b>
581  wrong?</a></b>      <p>This often happens when using SourceForge projects for the first time,
582      <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>        but may occur on other servers as well. You must manually log in to the
583      <p>This often happens when using SourceForge projects for the first        server, using an interactive SSH session, in order to create your home directory
584  time, but may occur on other servers as well. You must manually log in        for the first time. After this, you will be able to log in successfully.
585  to the server, using an interactive SSH session, in order to create      </p>
586  your home directory for the first time. After this, you will be able to      <p>Use your SSH client to connect to the server (e.g. cvs.sourceforge.net)
587  log in successfully. </p>        and log in with your username and password. Your home directory will be
588      <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>        created for you.</p>
589      <p>Use your SSH client to connect to the server (e.g.    </li>
590  cvs.sourceforge.net) and log in with your username and password. Your    <li><b><a name="ssh_5">I got an 'Unknown response' while trying to perform CVS
591  home directory will be created for you.</p>      browsing. What went wrong?</a></b>
592    </li>      <p>A problem has been reported that involves the Cygwin SSH client (see bug
593    <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>        <a href="http://bugs.eclipse.org/bugs/show_bug.cgi?id=21180">21180</a>).
   <li><b><a name="ssh_5">I got an 'Unknown response' while trying to  
 perform CVS browsing. What went wrong?</a></b>  
     <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>  
     <p>A problem has been reported that involves the Cygwin SSH client  
 (see bug <a href="http://bugs.eclipse.org/bugs/show_bug.cgi?id=21180">21180</a>).  
594  Try using another SSH client such as Putty or <a  Try using another SSH client such as Putty or <a
595   href="http://www.networksimplicity.com/openssh/">OpenSSH</a>. </p>   href="http://www.networksimplicity.com/openssh/">OpenSSH</a>. </p>
596    </li>    </li>
597    <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </p>    <li><a name="ssh_6"><strong>I can't get keys generated using Putty to work with Eclipse</strong></a></li>
598      <p>Putty's private key is encrypted by AES, but JCE (Java Crtptgraphy Extension)
599        included in J2SE 1.4.x does not support AES. So, at present time, there is
600        no plan to support it. Of course, JSch (the SSH2 client used in Eclipse) may
601        support Putty's key by using the latest J2SE in the near future, but Eclipse
602        3.0/3.1 will not be able to use it because they must run on J2SE 1.4.0.</p>
603  </ol>  </ol>
604  <br>  <br>
605  <!-- Upgrading from Eclipse 1.0 -->  <!-- Upgrading from Eclipse 1.0 -->

Legend:
Removed from v.1.52  
changed lines
  Added in v.1.53