Thursday, January 13, 2005

2.       Open a command prompt and run the "puttygen" command.  When the dialog appears, select the appropriate key type and click the "generate" button.  You will have to move your mouse over the blank area of the dialog to get the key to generate (this is because the applications uses the input from your mouse movement for the random seed value).

3.       Once the key pair has been generated, enter a meaningful name for the key into the Key Comment field.

4.       Type in a key passphrase for the private key into both the "Key passphrase" and "Confirm passphrase" fields.  This should be a fairly complex password, but you will only need to type it on the startup of your workstation.

5.       Click the "Save public key" button and save the key into the "C:\\Program Files\\Putty" directory as a text file.

6.       Keep the “puttygen” application running until you install the public key on the target server.

7.       Run the TortoiseCVS-1.8.7.exe program that will install the TortiseCVS application.

8.   Copy a shortcut of "C:\\Program Files\\Putty\\pageant.exe" into your "Startup" folder.

9.   Edit the shortcut to include the name and location of your private key file after the program file's name and location (in the target field of the properties dialog).  The result will look something like this:

"C:\\Program Files\\Putty\\pageant.exe" "C:\\Program Files\\Putty\\{PrivateKeyFile}"

Replace the "{PrivateKeyFile}" string with the actual name of your private key file.

10.   Run the shortcut to activate the Putty Agent application.  You will have to type in your passphrase when the application loads.

11.   In the system tray, the Putty Agent icon should be visible.  Right click on the icon and select the "New Session" menu option.

12.   In the Putty session dialog, set the following values:

Session ->    Saved Sessions = the hostname of the CVS server

This field is right above the list of displayed sessions.

Session ->    Host Name = the hostname of the CVS server

Session ->    Protocol = SSH

Session ->    Port = 22

Connection ->        Auto-login username = {USER}

Replace {USER} with your username for the CVS server.

Connection -> SSH -> Preferred SSH protocol version

Select wither 1 or 2, appropriately to the version that you set the key pair to support.

Connection -> SSH -> Auth -> Private key file for authentication = {PrivateKeyFile}

Replace {PrivateKeyFile} with the name and location of your private

key file (the "PPK" file).

13.   Back on the "Session" settings page, click the "Save" button to save the definition.

14.   Click “Open” to connect to the target server. 

You will have to type in your password for the CVS server (NOT your private key passphrase).

15.   Go back to the “puttygen” application and copy the “Public key for pasting into the authorized_keys file” to the clipboard.

16.   Add the contents of the clipboard to the ~/.ssh/authorized_keys file on the server.  If the file is not there, then create it and add the data.

17.   After saving the changes to the authorized_keys file, close the putty session.

18.   Close the "puttygen" application.

19.   Test the key based authentication by right clicking on the Putty Agent system tray icon and selecting the "saved session" of 216.203.1.133.  When selected, a putty terminal window should appear, and you should be automatically logged into the server.

20.   Add the following user environmental variables:

CVS_ROOT=:ext:{USER}@{CVS SERVER}:{CVS HOME}

CVS_RSH=plink

21.   Add the following to the "Path" system environment variable:

;C:\\Program Files\\Putty

22.   Restart your system.  Be sure to type in your passphrase into the Putty agent dialog after you login.

23.   CVS should now be integrated into your workstation.  You can test the connectivity by right clicking on your desktop and selecting “CVS Checkout”.  When the dialog opens, set the following settings:

Protocol -> Secure shell (:ext:)

Server -> {CVS SERVER}

Repository directory -> {CVS HOME}

User name -> {USER}

            Click the “Fetch list…” button to see a list of modules that are available for Checkout.

            If the list returns, then the application is installed correctly.