You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-cvs@jakarta.apache.org by jo...@apache.org on 2001/03/05 23:13:56 UTC
cvs commit: jakarta-site2/xdocs/site cvsonunix.xml
jon 01/03/05 14:13:55
Modified: docs/site cvsonunix.html
xdocs/site cvsonunix.xml
Log:
rewrote the cvs on unix page to make more sense and not force people
to use tunnels because on unix, it is easier to simply set the CVS_RSH
env variable.
also fixed links to the utilities
Revision Changes Path
1.16 +27 -51 jakarta-site2/docs/site/cvsonunix.html
Index: cvsonunix.html
===================================================================
RCS file: /home/cvs/jakarta-site2/docs/site/cvsonunix.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- cvsonunix.html 2001/03/01 02:38:01 1.15
+++ cvsonunix.html 2001/03/05 22:13:50 1.16
@@ -131,8 +131,8 @@
On Unix, you need the following software products:
</p>
<ul>
-<li><a href="http://download.cyclic.com/pub/">CVS client (pick up latest version)</a></li>
-<li><a href="ftp://ftp.cs.hut.fi/pub/ssh/">SSH client (pick up 1.x, not 2.x)</a></li>
+<li><a href="http://www.cvshome.org/">CVS client (pick up latest version)</a></li>
+<li><a href="http://www.openssh.org/">SSH client (1.x or 2.x)</a></li>
</ul>
<p>
Depending on your platform you may be able to pick up precompiled
@@ -150,21 +150,20 @@
<tr><td>
<blockquote>
<p>
-Since both CVS and SSH are based on open standards, there are lots of CVS and
-SSH tools freely available on the net, both of command line and GUI behavior.
-This means that any compliant implementations of those standards should work
-as well.
+Since both CVS and SSH are based on open standards, there are lots of
+CVS and SSH tools freely available on the net, both of command line and
+GUI behavior. This means that any compliant implementations of those
+standards should work as well.
</p>
<p>
For some more software options as well as other tips and tricks, see
-<a href="http://www.hyperreal.org/info/ssh/">www.hyperreal.org/info/ssh/</a>
+<a href="http://www.hyperreal.org/info/ssh/">http://www.hyperreal.org/info/ssh/</a>
</p>
<p>
-In addition, if you are behind a corporate firewall, your best option
-is to use a socks proxy. Most SSH software knows how to traverse socks
-proxies. In addition, there are socks utility programs that
-let you "sockisfy" any application. Contact your sysadmin
-for details.
+In addition, if you are behind a corporate firewall, your best option is
+to use a socks proxy. Most SSH software knows how to traverse socks
+proxies. In addition, there are socks utility programs that let you
+"sockisfy" any application. Contact your sysadmin for details.
</p>
</blockquote>
</td></tr>
@@ -178,9 +177,13 @@
<tr><td>
<blockquote>
<p>
-The first step is to set up the SSH tunnel to jakarta. To do this, you
-need to have your SSH client software redirect your local port 2401 to
-the far side of the SSH connection. The command looks something like this:
+On unix, using SSH is easy. All you need to do is setup a couple of
+environment variables and then use CVS normally. The CVS_RSH environment
+variable should be set to your path to the ssh binary executable. The
+CVSROOT environment variable should be set without the :pserver:
+argument. Depending on which shell you use, you need to set your
+environment variables properly. You can also use the cvs -d argument in
+place of setting the CVSROOT.
</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
@@ -192,7 +195,8 @@
<tr>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#ffffff"><pre>
- ssh -L 2401:localhost:2401 jakarta.apache.org
+ CVS_RSH=/path/to/ssh
+ cvs -d user@localhost:/home/cvs login
</pre></td>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
@@ -204,10 +208,8 @@
</table>
</div>
<p>
-The next step is to use the CVS pserver functionality to
-login. You'll want to do this in a seperate terminal from the one that
-you logged into jakarta with so that you check out the files to your local
-machine and not to your account on jakarta! This command looks like this:
+After you login, you can check out any of the source trees. The
+command to checkout source code is:
</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
@@ -219,7 +221,7 @@
<tr>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#ffffff"><pre>
- cvs -d :pserver:user@localhost:/home/cvs login
+ cvs -d user@localhost:/home/cvs checkout module
</pre></td>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
@@ -230,39 +232,13 @@
</tr>
</table>
</div>
- <p>
-Note that the CVS client thinks it is talking to a server
-running on your local machine, but in fact is talking to the CVS
-pserver on jakarta thanks to the SSH tunnel.
-</p>
<p>
-After you login, you can check out any of the source trees. The
-command to checkout the Tomcat source is:
+The list of modules are shown on <a href="./cvsindex.html">this
+page</a>.
</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
- cvs -d :pserver:user@localhost:/home/cvs checkout jakarta-tomcat
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
<p>
-Once you checkout a source tree, all CVS operations in that source tree do not
-require the <code>-d :pserver:</code> argument.
+Once you checkout a source tree, all CVS operations in that source tree
+do not require the <code>-d</code> argument.
</p>
</blockquote>
</td></tr>
1.2 +27 -35 jakarta-site2/xdocs/site/cvsonunix.xml
Index: cvsonunix.xml
===================================================================
RCS file: /home/cvs/jakarta-site2/xdocs/site/cvsonunix.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- cvsonunix.xml 2000/11/25 21:36:36 1.1
+++ cvsonunix.xml 2001/03/05 22:13:53 1.2
@@ -14,8 +14,8 @@
</p>
<ul>
-<li><a href="http://download.cyclic.com/pub/">CVS client (pick up latest version)</a></li>
-<li><a href="ftp://ftp.cs.hut.fi/pub/ssh/">SSH client (pick up 1.x, not 2.x)</a></li>
+<li><a href="http://www.cvshome.org/">CVS client (pick up latest version)</a></li>
+<li><a href="http://www.openssh.org/">SSH client (1.x or 2.x)</a></li>
</ul>
<p>
@@ -25,65 +25,57 @@
</section>
<section name="Notes">
<p>
-Since both CVS and SSH are based on open standards, there are lots of CVS and
-SSH tools freely available on the net, both of command line and GUI behavior.
-This means that any compliant implementations of those standards should work
-as well.
+Since both CVS and SSH are based on open standards, there are lots of
+CVS and SSH tools freely available on the net, both of command line and
+GUI behavior. This means that any compliant implementations of those
+standards should work as well.
</p>
<p>
For some more software options as well as other tips and tricks, see
-<a href="http://www.hyperreal.org/info/ssh/">www.hyperreal.org/info/ssh/</a>
+<a href="http://www.hyperreal.org/info/ssh/">http://www.hyperreal.org/info/ssh/</a>
</p>
<p>
-In addition, if you are behind a corporate firewall, your best option
-is to use a socks proxy. Most SSH software knows how to traverse socks
-proxies. In addition, there are socks utility programs that
-let you "sockisfy" any application. Contact your sysadmin
-for details.
+In addition, if you are behind a corporate firewall, your best option is
+to use a socks proxy. Most SSH software knows how to traverse socks
+proxies. In addition, there are socks utility programs that let you
+"sockisfy" any application. Contact your sysadmin for details.
</p>
</section>
<section name="How to Connect">
<p>
-The first step is to set up the SSH tunnel to jakarta. To do this, you
-need to have your SSH client software redirect your local port 2401 to
-the far side of the SSH connection. The command looks something like this:
+On unix, using SSH is easy. All you need to do is setup a couple of
+environment variables and then use CVS normally. The CVS_RSH environment
+variable should be set to your path to the ssh binary executable. The
+CVSROOT environment variable should be set without the :pserver:
+argument. Depending on which shell you use, you need to set your
+environment variables properly. You can also use the cvs -d argument in
+place of setting the CVSROOT.
</p>
<source>
- ssh -L 2401:localhost:2401 jakarta.apache.org
+ CVS_RSH=/path/to/ssh
+ cvs -d user@localhost:/home/cvs login
</source>
<p>
-The next step is to use the CVS pserver functionality to
-login. You'll want to do this in a seperate terminal from the one that
-you logged into jakarta with so that you check out the files to your local
-machine and not to your account on jakarta! This command looks like this:
+After you login, you can check out any of the source trees. The
+command to checkout source code is:
</p>
<source>
- cvs -d :pserver:user@localhost:/home/cvs login
+ cvs -d user@localhost:/home/cvs checkout module
</source>
-<p>
-Note that the CVS client thinks it is talking to a server
-running on your local machine, but in fact is talking to the CVS
-pserver on jakarta thanks to the SSH tunnel.
-</p>
-
<p>
-After you login, you can check out any of the source trees. The
-command to checkout the Tomcat source is:
+The list of modules are shown on <a href="./cvsindex.html">this
+page</a>.
</p>
-<source>
- cvs -d :pserver:user@localhost:/home/cvs checkout jakarta-tomcat
-</source>
-
<p>
-Once you checkout a source tree, all CVS operations in that source tree do not
-require the <code>-d :pserver:</code> argument.
+Once you checkout a source tree, all CVS operations in that source tree
+do not require the <code>-d</code> argument.
</p>
</section>