Crib Sheet for SVN GUI Here's a crib sheet for getting set up with SmartSVN (on UNIX-like systems or Windows) Installation: ~~~~~~~~~ For UNIX-like systems: Use the version which is installed on /disks/socware: source /disks/socware/toolchain/current/setup To start SmartSVN, type smartsvn.sh on the command line. For Windows: You can choose between SmartSVN and TortoiseSVN. * SmartSVN is java-based, and works on many platforms. The basic features you will need are free, but some convenient features require a professional license (~$60) * TortoiseSVN is made for Windows. It is free, full-featured and well-integrated into the Windows Explorer. SmartSVN -------------- Download and install SmartSVN: http://www.syntevo.com/smartsvn (download the version that includes Java if you are not sure that Java is installed on your machine) TortoiseSVN ----------------- Download and install TortoiseSVN Download and install PuTTY or some other SSH client you will use to tunnel your connection. SSH setup: ~~~~~~~~~ Windows: ------------ PuTTY >>>> Ideally, use PuTTY, because this will create OpenSSH keys. choose Programs->PuTTY->PuTTYgen Click Generate (keep default SSH-2 RSA setting for type of key under Parameters) Move the mouse around. Enter a key comment: e.g. kenb-lepkrblap-win2000 (this identifies me, my machine, and my OS) Enter and confirm a passphrase, and then press 'Save private key'. You can save the keys where you like, but you might want to create a new directory named SSH under the default location, to save the key in: C:\Documents and Settings\username\Application Data\SSH Copy the key in the window where it says 'Public key for pasting into OpenSSH authorized_keys file' and copy it into an email to: teq@ssl.berkeley.edu or kenb@ssl.berkeley.edu For TortoiseSVN, Select TortoiseSVN->Settings from the context menu. In the TortoiseSVN Setting popup, select Network in the list on the left. For SSH Client, browse to find the location of TortoisePlink on your system, probably: C:\Program Files\TortoiseSVN\bin\TortoisePlink.exe Press OK For more information about setting up Subversion access with TortiseSVN, see http://www.logemann.org/day/archives/000099.html Secure Shell Client from ssh.org >>>>>>>>>>>>>>>>>>>>>>>>> You can use the Secure Shell Client application from ssh.org. This may work seamlessly as the SSH client for TortoiseSVN, but you will need to convert your keys to OpenSSH format to use them with SmartSVN. The menu path to the wizard is: Edit-->Settings-->Global Settings (branch)-->User Authorization (branch) \ -->Keys (leaf) --> Generate New... (button) The key pair created by the wizard was stored under: C:\Documents and Settings\davin\Application Data\SSH\UserKeys\ To make it work with SmartSVN, you will have to convert your *private key* to OpenSSH format. One way to do this is to copy the file to a UNIX machine running OpenSSH and run: ssh-keygen -i -f Private_key > Private_key_openssh Setup: ~~~~~ SmartSVN -------------- You when you first run SmartSVN you will be using the Professional license or using the 'Foundation' version, which lacks a few of the features from the Professional version. You can purchase or get a demo license from http://www.syntevo.com/smartsvn/purchase.asp Once you've done this, you will be presented with a new dialog. Choose: Check out a new project Since this is the first time you are accessing the SOC repository, need to set up SmartSVN to know how to access to the repository. Click on "Manage..." In the "Repository Profiles" window: Click on "Add..." Click on "Enter SVN URL..." Enter svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos Click "Next..." Select "public/private-key-authentication" Enter the path to your private key file. Click "Next..." Enter a name if you like SOCREPOS Click "Finish" Select the new SVN-Location Click "OK" In "Check Out Project" Click "Next >" Click the "+" next to idl_socware Select "trunk" under idl_socware Click "Next >" Enter location of local directory for your local copy, e.g.: /home/yourname/idl_socware Click "Next >" Keep the selection "Check out a working copy and manage as project" Click "Next >" Click "Finish" It may take a couple of minutes to load all the files (SmartSVN is a bit slow for checkouts involving large numbers of files) You should now have a workspace which includes at least 3 subdirectories: external ssl_general themis TortoiseSVN ----------------- Create a directory where you want the IDL code to live e.g. Desktop/themis_socware open the directory in Explorer, and right click to get the context menu select TortoiseSVN-> Checkout ... In the dialog box, enter the URL of the repository svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/themis_socware Keep the other default settings and press OK If a security Alert pops up, press Yes to trust that you believe you are connecting to the real ambrosia (lucky you!) To Update Your Workspace With the Latest Software ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ At any time you can update your workspace: any changes made by others to the repository will be brought over to your workspace. In the Directories window, Right click the top level of your workspace, and select 'Update...' Keep the setting 'Update to: HEAD' (i.e. the latest revision), and 'Recurse into subdirectories' and press 'OK'. You will be asked to enter your passphrase. Just press OK if you are using an empty passphrase. If you are using the 'Professional' version, you can use SmartSVN to see if there are changes to be brought over, before you update: select 'Refresh Remote State'