mpoeschl 01/03/09 12:43:34
Modified: xdocs/images mindterm_tunnel.gif
xdocs/site cvsonwin32.xml
Added: xdocs/images jcvs_checkout.gif
Log:
update cvs4win docs
- update mindterm doc
- add jcvs doc
Revision Changes Path
1.2 +50 -50 jakarta-site2/xdocs/images/mindterm_tunnel.gif
<<Binary file>>
1.1 jakarta-site2/xdocs/images/jcvs_checkout.gif
<<Binary file>>
1.2 +83 -51 jakarta-site2/xdocs/site/cvsonwin32.xml
Index: cvsonwin32.xml
===================================================================
RCS file: /home/cvs/jakarta-site2/xdocs/site/cvsonwin32.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- cvsonwin32.xml 2000/11/25 21:36:36 1.1
+++ cvsonwin32.xml 2001/03/09 20:43:33 1.2
@@ -3,6 +3,7 @@
<properties>
<author email="[EMAIL PROTECTED]">Jon S. Stevens</author>
+ <author email="[EMAIL PROTECTED]">Martin Poeschl</author>
<title>CVS Access on Windows</title>
</properties>
@@ -10,7 +11,7 @@
<section name="CVS Access on Windows">
<p>
-On Windows, you need one of the following software products for each
+On Windows, you need one of the following software products for each
category:
</p>
@@ -18,6 +19,7 @@
<li>CVS client</li>
<ul>
<li><a href="http://www.wincvs.org">WinCVS 1.0 or greater (GUI client)</a></li>
+ <li><a href="http://www.gjt.org">jCVS (Java GUI client)</a></li>
<li><a href="http://download.cyclic.com/pub/">Cyclic's CVS (command line
client)</a></li>
</ul>
<li>SSH client/tunnel</li>
@@ -36,7 +38,7 @@
<p>
You can find other SSH clients <a
href="http://www.cs.hmc.edu/tech_docs/qref/ssh.html">here</a>
-but the above are the only ones recommended since they do SSH tunneling (most
+but the above are the only ones recommended since they do SSH tunneling (most
SSH clients just do terminal emulation). If you find any usable software that
is missing here, please <a href="mailto:[EMAIL PROTECTED]">inform us.</a>
</p>
@@ -49,64 +51,110 @@
for details.
</p>
</section>
- <section name="How to Connect using MindTerm and WinCVS">
+ <section name="Create a SSH connection">
+ <subsection name="MindTerm">
<p>
-This is an illustrated example showing the MindTerm program and the
-WinCVS CVS GUI client.
+This example is based on MindTerm V1.2.1.
</p>
<p>
-Assuming you have installed the Mindterm classes (or .jar archive) on your
+Assuming you have installed the Mindterm classes (or .jar archive) on your
system classpath (and, of course, that you have a Java virtual machine
-available on your system), the first step is turn on the client.
+available on your system), the first step is turn on the client.
From the DOS prompt type:
</p>
<source>
- java mindbright.application.MindTerm
-</source>
+ java mindbright.application.MindTerm
+</source>
<p>
+First connect to SSH host cvs.apache.org by typing so at the
+<code>SSH-server:</code> prompt. Then your username
+will be requested and the password. Don't worry about transmitting your
+password since SSH is done exactly to allow you to transmit your password
+without worrying about sniffing and other security holes of normal
+remote shells.
+</p>
+
+<p>
Now, go to the tunnels menu and set is up so that local port 2401
is directed to host "localhost" on the same (you don't need to understand why)
as showed in the picture below:
</p>
-<img src="/images/mindterm_tunnel.gif" width="587" height="475"/>
+<img src="/images/mindterm_tunnel.gif" width="588" height="460"/>
<p>
-When this is done, go ahead and connect to SSH host jakarta.apache.org
-by typing so at the <code>SSH-server:</code> prompt. Then your username
-will be requested and the password. Don't worry about transmitting your
-password since SSH is done exactly to allow you to transmit your password
-without worrying about sniffing and other security holes of normal
-remote shells.
+Now you can safely minimize your
+mindterm window since, for plain CVS operation, you won't need to type
+anything in the ssh terminal. The CVS client will send CVS commands thru
+the SSH tunnel transparently.
</p>
+ </subsection>
+ <subsection name="VanDyke SecureCRT SSH">
<p>
-When Taz welcomes you and its prompt appears, you can safely minimize your
-mindterm window since, for plain WinCVS operation, you won't need to type
-anything in the ssh terminal. The WinCVS client will send CVS commands thru
-the SSH tunnel transparently.
+This is an illustrated example showing the VanDyke SecureCRT SSH program.
+</p>
+
+<p>
+<strong>Note:</strong> the servername 'taz.apache.org' as shown in the screen
+shots is not valid! Use 'cvs.apache.org' instead.
+</p>
+
+<p>
+First, set up SecureCRT to make a connection to jakarta. You should fill
+out the session preferences window to look something like this:
+</p>
+<img src="/images/scrt_ssh_session_prefs.gif" width="428" height="413"/>
+
+<p>
+Next, you'll need to click on the "Advanced" button (next to
+the hostname in the above image) so that you can set up the SSH
+tunnel. Fill it out so that it looks something like this:
+</p>
+
+<img src="/images/scrt_ssh_adv_options.gif" width="428" height="413"/>
+
+ </subsection>
+ </section>
+
+ <section name="CVS client">
+
+ <subsection name="Using the jCVS client">
+<p>
+Launch the jCVS client. Go to the <code>Checkout-Tab</code> and enter the
+repository and authentication information. The screenshot below tells you what
+you should enter. Note that you must replace the string username in the
+repository location with your own username on jakarta.
</p>
+<img src="/images/jcvs_checkout.gif" width="402" height="429"/>
+
<p>
-Then launch the WinCVS client. The first time, it will ask you the basic
+For more Information about jCVS look at the jCVS documentation
+</p>
+ </subsection>
+
+ <subsection name="Using the WinCVS client">
+<p>
+Launch the WinCVS client. The first time, it will ask you the basic
configuration preferences that it needs. These are the CVS repository location
and authentication information. The screenshot below tells you what you
-should enter. Note that you must replace the string username in the
+should enter. Note that you must replace the string username in the
repository location with your own username on jakarta.
</p>
<img src="/images/wincvs_config.gif" width="622" height="517"/>
-
+
<p>
At this point you software is setup and first thing to do is to authenticate
yourself on the CVS repository. This is done by logging in the server with
the menu <code>Admin -> Login</code> and inserting your password. This action
authenticates you into the CVS server and saves your password (in a crypted
-form) in the <code>.cvspass</code> file in the home directory you specify. Note
-that you need to do this only once per CVS repository, not everytime you
+form) in the <code>.cvspass</code> file in the home directory you specify. Note
+that you need to do this only once per CVS repository, not everytime you
connect to it, even if you disconnected from that server.
</p>
@@ -115,44 +163,28 @@
repository. First action to take is to <code>checkout</code> the
jakarta-tomcat module. To do this, first select the directory
where you want the files to be located. Note that the files will be automatically
-placed in the <code>jakarta-tomcat</code> subdirectory of the indicated
+placed in the <code>jakarta-tomcat</code> subdirectory of the indicated
directory. Then select the menu item <code>Create -> Checkout module...</code>.
-After this, place <code>jakarta-tomcat</code> (or any module you want to
+After this, place <code>jakarta-tomcat</code> (or any module you want to
checkout on jakarta) in the module name field and you're ready to go.
</p>
- </section>
- <section name="How to Connect on Windows Using SecureCRT and Cyclic's CVS">
-<p>
-This is an illustrated example showing the VanDyke SecureCRT SSH
-program and command line CVS.
-</p>
+ </subsection>
+ <subsection name="Using command line CVS">
<p>
-First, set up SecureCRT to make a connection to jakarta. You should fill
-out the session preferences window to look something like this:
-</p>
-<img src="/images/scrt_ssh_session_prefs.gif" width="428" height="413"/>
-
-<p>
-Next, you'll need to click on the "Advanced" button (next to
-the hostname in the above image) so that you can set up the SSH
-tunnel. Fill it out so that it looks something like this:
-</p>
-
-<img src="/images/scrt_ssh_adv_options.gif" width="428" height="413"/>
-
-<p>
-Now, just connect. Once you've connected, open up a DOS prompt and
+After connection to the server, open up a DOS prompt and
enter the appropriate cvs commands. Here's a sample session:
</p>
<img src="/images/dos_cvs.gif" width="652" height="359"/>
<p>
-Note that this is a DOS prompt on your local machine, not the shell
-prompt that is opened on jakarta by SecureCRT.
+Note that this is a DOS prompt on your <strong>local machine</strong>, not the
+shell prompt that is opened on jakarta by the SSH client.
</p>
+ </subsection>
+
</section>
</body>
-</document>
\ No newline at end of file
+</document>
