TortoiseSVN - Revision history

Jpr@uab.edu: /* Register Your Public Key */ Add link to ticket

2010-03-25T17:54:02Z

← Older revision		Revision as of 17:54, 25 March 2010
Line 64:		Line 64:
	You are now ready to use the simplified SSH access with TortoiseSVN. You can close the PuTTY Configuration and PuTTY Key Generator windows now if you haven't already done so/		You are now ready to use the simplified SSH access with TortoiseSVN. You can close the PuTTY Configuration and PuTTY Key Generator windows now if you haven't already done so/

	Note: You may think these steps to registering you public key onerous and error prone. We agree. Our goal is to improve this process so it becomes an easy paste to a web page and you don't need to worry about typing in a lot of commands. We're planning to improve this, you can follow our progress [here].		Note: You may think these steps to registering you public key onerous and error prone. We agree. Our goal is to improve this process so it becomes an easy paste to a web page and you don't need to worry about typing in a lot of commands. We're planning to improve this, you can follow our progress [http://dev.uabgrid.uab.edu/ticket/114 here].

	=== Load Your Private Key ===		=== Load Your Private Key ===

Jpr@uab.edu: /* Use TortoiseSVN */ Add note about session names for advanced users.

2010-03-25T17:37:33Z

Use TortoiseSVN: Add note about session names for advanced users.

← Older revision		Revision as of 17:37, 25 March 2010
Line 81:		Line 81:
	=== Use TortoiseSVN ===		=== Use TortoiseSVN ===

	You can now use TortoiseSVN to interact with your subversion repository without further prompting for credentials. Just remember to load your private key into the Pageant Key List.		You can now use TortoiseSVN to interact with your subversion repository without further prompting for credentials. Just remember to load your private key into the Pageant Key List and use the session name you defined as the target for accessing your subversion repository via SSH, eg. projects.uabgrid.uab.edu.

			Note for advanced users: You can define session names that are more meaningful to you. That is, the session name can be anything you want. The only thing you need to do is then use that session name in place of the normal host name when defining your svn+ssh:// url in TortoiseSVN. We chose to define the session name as projects.uabgrid.uab.edu to help those folks who've already checked out there code using that name name, they don't have to change anything with their checked out repository to start using this improvement.

	== References ==		== References ==

Jpr@uab.edu: /* Generate an SSH Key Pair */ Make the screen shots smaller

2010-03-25T17:32:41Z

Generate an SSH Key Pair: Make the screen shots smaller

← Older revision		Revision as of 17:32, 25 March 2010
Line 19:		Line 19:
	The first thing you need to do to accomplish a single-password-prompt for subversion access is generate a public-private key pair. Start the DOS command shell (e.g. Run... cmd, Programs->Accessories->Command Prompt). Type the command "puttygen" and press enter. This will bring up a window to manage your key pair.		The first thing you need to do to accomplish a single-password-prompt for subversion access is generate a public-private key pair. Start the DOS command shell (e.g. Run... cmd, Programs->Accessories->Command Prompt). Type the command "puttygen" and press enter. This will bring up a window to manage your key pair.

	[[Image:puttygen-window.png]]		[[Image:puttygen-window.png\|400px]]

	The first step is to press the "Generate" button to start the process. You will be requested to move your mouse around in the blank are of that window to help generate a good random number. The progress bar will fill in as you do so letting you know when the process is complete. Once complete, the PuTTY Gen window will display your public key and offer you various options to work with that key.		The first step is to press the "Generate" button to start the process. You will be requested to move your mouse around in the blank are of that window to help generate a good random number. The progress bar will fill in as you do so letting you know when the process is complete. Once complete, the PuTTY Gen window will display your public key and offer you various options to work with that key.

	[[Image:puttygen-savekey.png]]		[[Image:puttygen-savekey.png\|400px]]

	There are four things you need to:		There are four things you need to:

Jpr@uab.edu: /* Create a Session Definition */ Make the screen shots smaller

2010-03-25T17:32:08Z

Create a Session Definition: Make the screen shots smaller

← Older revision		Revision as of 17:32, 25 March 2010
Line 40:		Line 40:
	To create a PuTTY session for projects.uabgrid.uab.edu, follow these steps.		To create a PuTTY session for projects.uabgrid.uab.edu, follow these steps.

	# Start the PuTTY session editor by running "putty.exe" from the Run... menu item or the command prompt. This brings up the following dialog that has a collection of configuration categories in the "Categories:" window on the left, and an context sensitive set of actions on the right. That is, if you change the category on the left you will change what you see on the right. The default category that you see is the Session, which is the main focus of our work here. <br>[[Image:putty-session-dialog.png]]		# Start the PuTTY session editor by running "putty.exe" from the Run... menu item or the command prompt. This brings up the following dialog that has a collection of configuration categories in the "Categories:" window on the left, and an context sensitive set of actions on the right. That is, if you change the category on the left you will change what you see on the right. The default category that you see is the Session, which is the main focus of our work here. <br>[[Image:putty-session-dialog.png\|400px]]
	# In the default "Session" category, fill in the "Host Name (or IP address)" text box with "projects.uabgrid.uab.edu", and fill in the "Saved Sessions" text box with "projects.uabgrid.uab.edu". Press the "Save" button <br>[[Image:putty-session-dialog-filled.png]]		# In the default "Session" category, fill in the "Host Name (or IP address)" text box with "projects.uabgrid.uab.edu", and fill in the "Saved Sessions" text box with "projects.uabgrid.uab.edu". Press the "Save" button <br>[[Image:putty-session-dialog-filled.png\|400px]]
	# Select the "Data" sub-category under the "Connection" category from the left-side Category browser. Fill in the "Auto-login username" text box with the username for your account on the SSH server.		# Select the "Data" sub-category under the "Connection" category from the left-side Category browser. Fill in the "Auto-login username" text box with the username for your account on the SSH server.
	# Select the "Session" category, and press "Save" again. You now have a saved session ready for use.		# Select the "Session" category, and press "Save" again. You now have a saved session ready for use.

Jpr@uab.edu: /* Load Your Private Key */ Fix layout with screenshot

2010-03-25T17:31:25Z

Load Your Private Key: Fix layout with screenshot

← Older revision		Revision as of 17:31, 25 March 2010
Line 71:		Line 71:

	# From the Run... menu or the command prompt, type <pre>pageant</pre> This will place the "Pageant" icon (a computer wearing a tilted hat: [[Image:pageant-icon.png]]) in you shortcuts toolbar in the lower-right of our screen.		# From the Run... menu or the command prompt, type <pre>pageant</pre> This will place the "Pageant" icon (a computer wearing a tilted hat: [[Image:pageant-icon.png]]) in you shortcuts toolbar in the lower-right of our screen.
	# Click on the icon to bring up the Pageant Key List dialog: [[Image:pageant-dialog.png]]		# Click on the icon to bring up the Pageant Key List dialog <br> [[Image:pageant-dialog.png\|300px]]
	# Press the "Add Key" button. From the file dialog, select the private key you created above (in My Documents by default).		# Press the "Add Key" button. From the file dialog, select the private key you created above (in My Documents by default).
	# Once you select your key file and press "Open" on the file dialog, you will be prompted for the passphrase to load your private key. Enter in the passphrase you chose above.		# Once you select your key file and press "Open" on the file dialog, you will be prompted for the passphrase to load your private key. Enter in the passphrase you chose above.

Jpr@uab.edu: /* Create a Session Definition */ Clean up list formatting with images.

2010-03-25T17:26:35Z

Create a Session Definition: Clean up list formatting with images.

← Older revision		Revision as of 17:26, 25 March 2010
Line 40:		Line 40:
	To create a PuTTY session for projects.uabgrid.uab.edu, follow these steps.		To create a PuTTY session for projects.uabgrid.uab.edu, follow these steps.

	# Start the PuTTY session editor by running "putty.exe" from the Run... menu item or the command prompt. This brings up the following dialog that has a collection of configuration categories in the "Categories:" window on the left, and an context sensitive set of actions on the right. That is, if you change the category on the left you will change what you see on the right. The default category that you see is the Session, which is the main focus of our work here. [[Image:putty-session-dialog.png]]		# Start the PuTTY session editor by running "putty.exe" from the Run... menu item or the command prompt. This brings up the following dialog that has a collection of configuration categories in the "Categories:" window on the left, and an context sensitive set of actions on the right. That is, if you change the category on the left you will change what you see on the right. The default category that you see is the Session, which is the main focus of our work here. <br>[[Image:putty-session-dialog.png]]
	# In the default "Session" category, fill in the "Host Name (or IP address)" text box with "projects.uabgrid.uab.edu", and fill in the "Saved Sessions" text box with "projects.uabgrid.uab.edu". Press the "Save" button [[Image:putty-session-dialog-filled.png]]		# In the default "Session" category, fill in the "Host Name (or IP address)" text box with "projects.uabgrid.uab.edu", and fill in the "Saved Sessions" text box with "projects.uabgrid.uab.edu". Press the "Save" button <br>[[Image:putty-session-dialog-filled.png]]
	# Select the "Data" sub-category under the "Connection" category from the left-side Category browser. Fill in the "Auto-login username" text box with the username for your account on the SSH server.		# Select the "Data" sub-category under the "Connection" category from the left-side Category browser. Fill in the "Auto-login username" text box with the username for your account on the SSH server.
	# Select the "Session" category, and press "Save" again. You now have a saved session ready for use.		# Select the "Session" category, and press "Save" again. You now have a saved session ready for use.

Jpr@uab.edu: /* Generate an SSH Key Pair */ Fix image extension for puttygen-savekey

2010-03-25T17:21:37Z

Generate an SSH Key Pair: Fix image extension for puttygen-savekey

← Older revision		Revision as of 17:21, 25 March 2010
Line 23:		Line 23:
	The first step is to press the "Generate" button to start the process. You will be requested to move your mouse around in the blank are of that window to help generate a good random number. The progress bar will fill in as you do so letting you know when the process is complete. Once complete, the PuTTY Gen window will display your public key and offer you various options to work with that key.		The first step is to press the "Generate" button to start the process. You will be requested to move your mouse around in the blank are of that window to help generate a good random number. The progress bar will fill in as you do so letting you know when the process is complete. Once complete, the PuTTY Gen window will display your public key and offer you various options to work with that key.

	[[Image:puttygen-savekey]]		[[Image:puttygen-savekey.png]]

	There are four things you need to:		There are four things you need to:

Jpr@uab.edu: Fix links for TortoiseSVN and downloads

2010-03-25T17:17:26Z

Fix links for TortoiseSVN and downloads

← Older revision		Revision as of 17:17, 25 March 2010
Line 1:		Line 1:
	Project support with Trac and Subversion are available for collaborations.		Project support with Trac and Subversion are available for collaborations.

	The easiest way to interact with the Subversion repositories from a Microsoft Windows platform is to use the [http://tortoisesvn.net/\|TrotoiseSVN] client. This tool adds menu items to your regular file browser menus that enable you to interact with repositories on remote servers and local working copies that you have checked out. To get started using this tool, simply [http://tortoisesvn.net/downloads\|download the appropriate installer for your platform] and complete the install.		The easiest way to interact with the Subversion repositories from a Microsoft Windows platform is to use the [http://tortoisesvn.net/ TrotoiseSVN] client. This tool adds menu items to your regular file browser menus that enable you to interact with repositories on remote servers and local working copies that you have checked out. To get started using this tool, simply [http://tortoisesvn.net/downloads download the appropriate installer for your platform] and complete the install.

	== Configuring Subversion Access via SSH ==		== Configuring Subversion Access via SSH ==

Jpr@uab.edu: /* References */ Add link to putty documenation

2010-03-25T17:16:25Z

References: Add link to putty documenation

← Older revision		Revision as of 17:16, 25 March 2010
Line 87:		Line 87:
	These instructions were adapted from:		These instructions were adapted from:
	* [http://tortoisesvn.net/ssh_howto TortoiseSVN SSH How-To]		* [http://tortoisesvn.net/ssh_howto TortoiseSVN SSH How-To]
	* [PuTTY Documentation]		* [http://the.earth.li/~sgtatham/putty/0.60/htmldoc/index.html PuTTY Documentation]

Jpr@uab.edu: Complete first draft of instructions with session create, key registration, and pageant setup

2010-03-25T17:15:38Z

Complete first draft of instructions with session create, key registration, and pageant setup

@@ Line 6: / Line 6: @@
 Once the install is complete you will want to take some extra steps to interact smoothly with any repositories that provide Subversion access via SSH, like those currently offered on projects.uabgrid.uab.edu or personal repositories you may set up.  These are repositories that use connection strings like "svn+ssh://hostname/path".
 === Get SSH Connection Configuration Tools ===
@@ Line 23: / Line 25: @@
 [[Image:puttygen-savekey]]
-There are two things you need to:
+You can now use TortoiseSVN to interact with your subversion repository without further prompting for credentials.  Just remember to load your private key into the Pageant Key List.
-# Set a passphrase for your private key, filling in both the "Key passphrase" and "Confirm passphrase" text boxes with the same passphrase.  The passphrase is your '''local''' password for this private key.  It doesn't have anything to do with any other passwords.  It is strictly about protecting the private key that you just generated.  It can be whatever you like, but brief multi-word phrases that you can easily remember are good choices. You need to remember this passphrase because you will be prompted for it whenever you use this key-pair.
+== References ==
-The save button, will by default save the private key to your "My Documents" folder.  This is fine, and you can give any file name you like.  Just remember the name and where you saved it, so you can load it in the next steps.
+These instructions were adapted from: