blob: 4598db5c41f0d4aac8606a61d780645ff64c5dea [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<HEAD>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Creating a CVS repository location</title>
<meta name="keyword" content="team">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script>
</HEAD>
<BODY BGCOLOR="#ffffff">
<H1 CLASS="Head">Creating a CVS repository location</H1>
<P><em>Prerequisite</em>: A CVS server must already be configured on the host machine to create a
valid repository location in the Workbench.
</P>
<P>To create a new repository location:
</P>
<ol>
<li>Open the CVS Repositories view by selecting
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.team.ccvs.ui.RepositoriesView)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link">
<b>Window &gt; Show View &gt; Other... &gt; CVS &gt; CVS Repositories</b></a>.
Alternatively, the CVS Repositories view is also shown in the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.team.cvs.ui.cvsPerspective)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link">
CVS Repository Exploring</a> perspective.</li>
<li>On the toolbar, click on <strong>Add CVS Repository</strong> (or from the
context menu of the CVS Repositories View, select <b>New &gt; Repository Location</b>).
The Add CVS Repository wizard opens.</li>
<li>Enter the information required to identify and connect to the repository
location:
<ol type="a">
<li>In the <b> Host </b> field, type the address of the host. (For example:
<samp>mymachine.com)</samp>. </li>
<li>In the <b> Repository path </b> field, type the path to the repository
on the host (for example <samp>/home/repo, d:/repo.)</samp></li>
<li>In the <b> User </b> field, type the user name under which you want
to connect to the repository. </li>
<li>In the <b>Password</b> field, type the password for the above user name.</li>
<li> From the <b> Connection Type</b> list, select the authentication protocol
of the CVS server.&nbsp; There are three connection methods that come
with the Eclipse CVS client:
<ul>
<li><b>pserver</b> - a CVS specific connection method.</li>
<li><b>extssh</b> - an SSH 2.0 client included with Eclipse</li>
<li><b>pserverssh2</b> - provides a pserver connection over ssh2.</li>
<li><b>ext</b> - the CVS ext connection method which uses an external
tool such as SSH to connect to the repository. The tool used by ext
is configured in the <b>Team &gt; CVS &gt; EXT Connection Method</b>
preference page. </li>
</ul>
</li>
<li>If the host uses a custom port, enable <b>Use Port</b> and enter the
port number.</li>
</ol>
</li>
<li><em>Optional:</em> Select <b>Validate Connection on Finish</b> if you want to authenticate
the specified user to the specified host when you close this wizard. (If you
do not select this option, the user name will be authenticated later, when
you try to access the contents of the repository.)</li>
<li><em>Optional:</em> Select <strong>Save Password</strong> if you want to
save the password between sessions, so you do not have to enter the password
again the next time you start Eclipse. To persist login credentials in a
safe, encrypted form <a href="../reference/ref-securestorage-start.htm">
Secure Storage</a> is used.</li>
<li> Click <b>Finish</b>. The repository location is created. </li>
</ol>
<p><strong>Note</strong>: Prior to Eclipse 3.0, the <strong>extssh</strong> connection
method only supported SSH 1.0. In 3.0 or later, this connection method was upgraded to
support SSH 2.0 as well.</p>
<p><em>Tip</em>: If you want to use the <strong>extssh</strong> connection method
but want to keep your local workspace (sandbox) compatible with the CVS command
line client, you can use the <strong>ext</strong> connection method and configure
it to use <strong>extssh</strong> from inside Eclipse on the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.team.cvs.ui.ExtMethodPreferencePage)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link">
<strong>Team &gt; CVS &gt; Ext Connection Method</strong></a> preference page.</p>
<p><img border="0" src="../images/ngrelc.png" alt="Related concepts" ><br>
<a href="../concepts/concepts-26.htm">Team programming with CVS</a><br>
<a href="../concepts/concepts-27c.htm">CVS Repositories</a> </p>
<p><img border="0" src="../images/ngrelt.png" alt="Related tasks" ><br>
<a href="tasks-94.htm">Discarding a CVS repository location</a><br>
<a href="tasks-93.htm">Refreshing the CVS repositories view</a><br>
<a href="tasks-96.htm">Checking out a project from a CVS repository</a><br>
<a href="tasks-110.htm">Discovering branch and version tags</a><br>
<a href="tasks-95.htm">Changing the properties of a CVS Repository Location</a>
</p>
<p><img border="0" src="../images/ngrelr.png" alt="Related references" ><br>
<a href="../reference/ref-47.htm">CVS</a><br>
<a href="../reference/ref-32.htm">CVS Repositories view</a><br>
<a href="../reference/ref-securestorage-start.htm">Secure Storage</a><br>
<a href="../reference/ref-securestorage-prefs.htm">Secure storage preference page</a>
</p>
</BODY>
</HTML>