Getting Started/Build/Windows/subversion: Difference between revisions

From KDE TechBase
(server id key import)
(Replaced content with "{{Moved To Community|Windows/Imported From TechBase/Build/{{#titleparts:{{PAGENAME}}||4}}}}")
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This article details how a developer can set up the Subversion command line client <tt>svn</tt> and <tt>PuTTY</tt> on MS Windows to enable write access to the KDE Subversion Repository, using your existing SSH credentials from *nix.
{{Moved To Community|Windows/Imported From TechBase/Build/{{#titleparts:{{PAGENAME}}||4}}}}
 
==Install PuTTY==
*Install PuTTY
[http://en.wikipedia.org/wiki/PuTTY PuTTY] is a free implementation of SSH for Win32. [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Download] and install PuTTY.  Using the Windows install file is the easiest method. As of this writing the current version is [ftp://ftp.chiark.greenend.org.uk/users/sgtatham/putty-latest/x86/putty-0.60-installer.exe putty-0.60-installer.exe].
 
*Put PuTTY in $PATH
In order for MS Windows to be able to find PuTTY and its related executable files, you need to add their location to your PATH variable.  By default, puTTY will install to C:\Program Files\PuTTY.  To edit your PATH (for Windows >= Win2k), Start -> Control Panel -> System -> Advanced -> Environment Variables -> System Variables -> Path -> Edit.  Add "C:\Program Files\PuTTY;" to the end of the PATH variable value.
 
==Enable Existing Key==
*Transfer existing ~\.ssh\id_dsa to Windows
Copy the private ssh key that is associated with your KDE Subversion account to the MS Windows machine.  In many cases this will be /home/kde-devel/.ssh/id_dsa.  I put mine in C:\Documents and Settings\mark\My Documents.
 
*Load into PuTTY Key Generator
In order to use your OpenSSH private key, you must first convert it to a puTTY Private Key (*.ppk).  To do this, Start -> All Programs -> puTTY -> puTTYgen -> Load.  Browse to wherever you saved your private key (id_dsa) and load it.
 
*Save Private Key
Once the key is loaded, click on 'Save Private Key' to save a copy of the key in a version that PuTTY can use.  I saved mine as id_dsa.ppk.
 
==Enable Pageant==
Pageant is PuTTY's version of sshagent, holding your keys for you so you don't always have to enter your passphrase.
 
*Start Pageant
Start Pageant Start -> All Programs -> PuTTY -> Pageant.  An icon will appear in your system tray.  Right-click in the icon, then select view keys.  If your key isn't listed, click on 'Add Key' and add the id_dsa.ppk key you created earlier.
 
*Add Pageant to Startup group
I suggest adding Pageant to the MS Windows Startup group so that it launches every time you start Windows.
 
==Configure Subversion PuTTY Tunnel==
We need to create a new type of tunnel: subversion over puTTY (svn+putty://).
 
*We create this tunnel in the Subversion configuration file. Open <tt>C:\Documents and Settings\<username>\Application Data\Subversion\config</tt>
 
*In [Tunnels] section, we create our new tunnel by adding a line:
<tt>putty = plink -ssh -C -i c:\path\to\id_dsa.ppk -agent <svnaccountname>@svn.kde.org</tt>
 
<tt>plink</tt> is the command line version of puTTY. <tt>-ssh</tt> tells puTTY to use SSH protocol. <tt>-C</tt> turns on compression. <tt>-i</tt> is the path to your private key. <tt>-agent</tt> tells puTTY to try to use Pageant.
 
Now open putty (Start -> All Programs -> PuTTY -> PuTTY) and open a connection to <tt>svn.kde.org</tt> it will ask you if you accept the server id. Select yes,
a terminal window with an error message will apear, this is normal. The authentication process between your computer and svn.kde.org is now complete.
 
==Repository Access==
*The repository can now be accessed by using the svn+putty:// tunnel, e.g. <tt>
C:\KDE4> svn co svn+putty://svn.kde.org/home/kde/trunk/kdesupport/emerge</tt>

Latest revision as of 14:10, 11 March 2016

This page is now on the community wiki.