Project

General

Profile

Windows » History » Version 38

Marc Mengel, 02/03/2012 10:00 AM

1 1 Marc Mengel
h1. Windows
2 1 Marc Mengel
3 26 Marc Mengel
[ Please help debug these instructions! Send comments/corrections! ]
4 26 Marc Mengel
5 5 Marc Mengel
There are numerous graphical front ends to the various packages on Windows; regardless which
6 5 Marc Mengel
front-end you choose, you will need to configure the back-end part below.
7 5 Marc Mengel
8 5 Marc Mengel
h2. Front ends
9 5 Marc Mengel
10 5 Marc Mengel
* http://www.tortoisecvs.org/
11 5 Marc Mengel
* http://code.google.com/p/tortoisegit/
12 5 Marc Mengel
* http://tortoisesvn.tigris.org/
13 29 Marc Mengel
* http://www.eclipse.org/  [Note that Eclipse's Git backend currently ignores GIT_SSH...]
14 10 Marc Mengel
* http://www.wincvs.org/
15 10 Marc Mengel
* http://cola.tuxfamily.org/
16 5 Marc Mengel
17 5 Marc Mengel
h2. Back Ends
18 5 Marc Mengel
19 31 Marc Mengel
For write access to  repositories on cdcvs, I am currently recommending that users use Putty 0.62 (or newer)
20 31 Marc Mengel
in concert witht NetIDManager and Keberos for Windows.
21 1 Marc Mengel
22 1 Marc Mengel
Then there are a few steps to get things setup:
23 14 Marc Mengel
24 31 Marc Mengel
# Install the appropriate Putty installer (either 32 or 64 bit, at the bottom of this page).
25 37 Marc Mengel
To find out if your computer is running 32-bit or 64-bit Windows, do the following:
26 38 Marc Mengel
#* Open System by clicking the *Start* button, clicking *Control Panel*, clicking *System and Maintenance*, and then clicking *System*.
27 37 Marc Mengel
#* Under System, you can view the system type.
28 31 Marc Mengel
# Startup PuTTY from that installation
29 31 Marc Mengel
# Select *Session* and set the hostname to: cdcvs.fnal.gov
30 31 Marc Mengel
# Expand *SSH* and under that expand *Auth*, and select GSSAPI
31 31 Marc Mengel
#* Check the box labelled: *Allow GSSAPI credential delegation*
32 31 Marc Mengel
#* Ensure that *MIT Kerberos GSSAPI* is first in the *Preference order for GSSAPI libraries"* box.
33 33 Marc Mengel
# Select Session again.  In the empty *Saved Sessions* box, enter *cdcvs.fnal.gov* and click  *Save*.
34 31 Marc Mengel
# Create some environment variables:
35 36 Marc Mengel
## (system) CVS_RSH = C:\PROGRA~1\PuTTY\plink.exe
36 36 Marc Mengel
## (system) GIT_SSH = C:\PROGRA~1\PuTTY\plink.exe
37 36 Marc Mengel
## (system) SVN_SSH = C:\PROGRA~1\PuTTY\plink.exe
38 32 Marc Mengel
##* Right-click My Computer, and then click Properties.
39 32 Marc Mengel
##* Click the Advanced tab.
40 32 Marc Mengel
##* Click Environment variables.
41 32 Marc Mengel
##* Click one the following options, for either a user or a system variable:
42 32 Marc Mengel
##** Click New to add a new variable name and value.
43 32 Marc Mengel
##** Click an existing variable, and then click Edit to change its name or value.
44 32 Marc Mengel
##** Click an existing variable, and then click Delete to remove it.
45 32 Marc Mengel
# Close all open windows then renew your the credentials for username@FNAL.GOV.
46 12 Marc Mengel
47 1 Marc Mengel
h2. Check if it works:
48 2 Marc Mengel
49 31 Marc Mengel
try to login on the server with  plink.exe. In a cmd.exe window:
50 16 Marc Mengel
<pre>
51 36 Marc Mengel
  %CVS_RSH% p-project@cdcvs.fnal.gov echo hi
52 16 Marc Mengel
</pre>
53 1 Marc Mengel
(where "project" is your project name). You should get 
54 36 Marc Mengel
<pre>
55 1 Marc Mengel
   Only 'lscvs' and 'cvs' commands are allowed 
56 36 Marc Mengel
</pre>
57 1 Marc Mengel
(or 
58 36 Marc Mengel
<pre>
59 1 Marc Mengel
   hi
60 36 Marc Mengel
</pre>
61 36 Marc Mengel
if you're a project admin.)  If it's the first time you've connected to this host,
62 36 Marc Mengel
you'll also get:
63 1 Marc Mengel
64 36 Marc Mengel
<pre>
65 36 Marc Mengel
The server's host key is not cached in the registry. You
66 36 Marc Mengel
have no guarantee that the server is the computer you
67 36 Marc Mengel
think it is.
68 36 Marc Mengel
The server's rsa2 key fingerprint is:
69 36 Marc Mengel
ssh-rsa 1024 01:30:15:c1:ab:4a:41:c3:62:e2:46:35:71:2e:c7:64
70 36 Marc Mengel
If you trust this host, enter "y" to add the key to
71 36 Marc Mengel
PuTTY's cache and carry on connecting.
72 36 Marc Mengel
If you want to carry on connecting just once, without
73 36 Marc Mengel
adding the key to the cache, enter "n".
74 36 Marc Mengel
If you do not trust this host, press Return to abandon the
75 36 Marc Mengel
connection.
76 36 Marc Mengel
Store key in cache? (y/n)
77 36 Marc Mengel
</pre>
78 36 Marc Mengel
79 36 Marc Mengel
Please answer 'y' for yes.
80 36 Marc Mengel
81 1 Marc Mengel
82 3 Marc Mengel
h2. CVS
83 1 Marc Mengel
84 21 Marc Mengel
The CVS_RSH environment variable should make :ext: CVSROOT's work in WinCVS, TortiseCVS, etc.
85 3 Marc Mengel
86 22 Marc Mengel
h2. GIT
87 22 Marc Mengel
88 22 Marc Mengel
The GIT_SSH environment variable should make ssh:/... repository paths work with Git tools.
89 22 Marc Mengel
90 30 Marc Mengel
The only exception known at the moment is Eclipse's Git backend, which ignores GIT_SSH.  If you're using Git from Eclipse, we can setup ssh public key access for you.  We also have a bug report in with the Eclipse Git backend asking that they fix this.
91 30 Marc Mengel
92 1 Marc Mengel
h2. Subversion
93 2 Marc Mengel
94 3 Marc Mengel
Configure Subversion to use plink/ssh  for “svn+ssh” uri.
95 2 Marc Mengel
96 2 Marc Mengel
    * Edit the file c:\Documents and Settings\user\Application Data\Subversion\config
97 8 Marc Mengel
      (with your username for "user")
98 2 Marc Mengel
    * Locate the section named [tunnels]
99 9 Marc Mengel
    * Add the following line :
100 3 Marc Mengel
101 34 Marc Mengel
      ssh=$SVN_SSH
102 6 Marc Mengel
103 6 Marc Mengel
h3. Related files