| 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> |
| 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> </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> </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->Preferences->Team->CVS->Ext Connection |
<li>Window->Preferences->Team->CVS->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> </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> 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 > CVS > |
client for your operating environment. In the Team > CVS > 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 |
</li> |
</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> </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> </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> </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> </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> </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> </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> </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> </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 --> |