Project

General

Profile

Windows » History » Version 40

Marc Mengel, 02/16/2012 10:57 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 40 Marc Mengel
Note that if you were previously using the old KCA bundle setup, you should probably
48 40 Marc Mengel
also remove the environment variable setting for KRB5_CONFIG.
49 40 Marc Mengel
50 1 Marc Mengel
h2. Check if it works:
51 2 Marc Mengel
52 31 Marc Mengel
try to login on the server with  plink.exe. In a cmd.exe window:
53 16 Marc Mengel
<pre>
54 39 Marc Mengel
  %CVS_RSH% username@cdcvs.fnal.gov echo hi
55 16 Marc Mengel
</pre>
56 39 Marc Mengel
(where "username@cdcvs.fnal.gov" is from your repository path (CVSROOT or svn+ssh: or ssh: path for Git) ). You should get 
57 36 Marc Mengel
<pre>
58 1 Marc Mengel
   Only 'lscvs' and 'cvs' commands are allowed 
59 36 Marc Mengel
</pre>
60 1 Marc Mengel
(or 
61 36 Marc Mengel
<pre>
62 1 Marc Mengel
   hi
63 36 Marc Mengel
</pre>
64 36 Marc Mengel
if you're a project admin.)  If it's the first time you've connected to this host,
65 36 Marc Mengel
you'll also get:
66 1 Marc Mengel
67 36 Marc Mengel
<pre>
68 36 Marc Mengel
The server's host key is not cached in the registry. You
69 36 Marc Mengel
have no guarantee that the server is the computer you
70 36 Marc Mengel
think it is.
71 36 Marc Mengel
The server's rsa2 key fingerprint is:
72 36 Marc Mengel
ssh-rsa 1024 01:30:15:c1:ab:4a:41:c3:62:e2:46:35:71:2e:c7:64
73 36 Marc Mengel
If you trust this host, enter "y" to add the key to
74 36 Marc Mengel
PuTTY's cache and carry on connecting.
75 36 Marc Mengel
If you want to carry on connecting just once, without
76 36 Marc Mengel
adding the key to the cache, enter "n".
77 36 Marc Mengel
If you do not trust this host, press Return to abandon the
78 36 Marc Mengel
connection.
79 36 Marc Mengel
Store key in cache? (y/n)
80 36 Marc Mengel
</pre>
81 36 Marc Mengel
82 36 Marc Mengel
Please answer 'y' for yes.
83 36 Marc Mengel
84 1 Marc Mengel
85 3 Marc Mengel
h2. CVS
86 1 Marc Mengel
87 21 Marc Mengel
The CVS_RSH environment variable should make :ext: CVSROOT's work in WinCVS, TortiseCVS, etc.
88 3 Marc Mengel
89 22 Marc Mengel
h2. GIT
90 22 Marc Mengel
91 22 Marc Mengel
The GIT_SSH environment variable should make ssh:/... repository paths work with Git tools.
92 22 Marc Mengel
93 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.
94 30 Marc Mengel
95 1 Marc Mengel
h2. Subversion
96 2 Marc Mengel
97 3 Marc Mengel
Configure Subversion to use plink/ssh  for “svn+ssh” uri.
98 2 Marc Mengel
99 2 Marc Mengel
    * Edit the file c:\Documents and Settings\user\Application Data\Subversion\config
100 8 Marc Mengel
      (with your username for "user")
101 2 Marc Mengel
    * Locate the section named [tunnels]
102 9 Marc Mengel
    * Add the following line :
103 3 Marc Mengel
104 34 Marc Mengel
      ssh=$SVN_SSH
105 6 Marc Mengel
106 6 Marc Mengel
h3. Related files