Setting up Merlin CVS repository access from Windows XP

Setting up Merlin CVSrepository access fromWindows XPIn this document, we will outline the necessary steps you need to take to set up Windows XP read/write access to the new Merlin CVS repository hosted DESY Zeuthen and maintained by Harald Vogt. The document will also cover setting up WinCvs v2.0 () to use with the new repository.For more general information on the server and protocols used, please see Harald Vogt's ILC SOFTWARE web site (http://www-zeuthen.desy.de/linear_collider).What you will need to do1.request a cvs account and a write password (contact nicholas.walker@desy.de)2.download and install OpenSSH3.download and install ccvssh.exe4.download and install CVSNT (see step 7)5.set up the necessary Windows XP environmental variables6.perform a one-time ccvssh login (you will need the password from 1 for this)7.optional: download the latest version of WinCvs and configure it. Note that if youinstall WinCvs, you automatically get CVSNT (step 4) for free.1. Request a cvs account and a passwordWrite access to the repository is password protected. You will need to request a cvs account and an associated password from nicholas.walker@desy.de. You cannot change your password directly, but you may suggest one or request that it be changed. Currently registered developers will be sent a pre-assigned account and password.2. Download and install OpenSSH1.Go to /products/Win32OpenSSL.htmland download the installed ('Win32 OpenSSL v0.9.7f ' or later recommendedversion).2.Run the installer.The necessary SSH dll libraries are now installed.3. Download and install ccvssh.exe1.Download ccvssh.exe from http://www.desy.de/~merlin/cvs/ccvssh.exe.2.place this exec in a convenient directory that is on your windows PATHenvironmental variable (or alternatively add the directory to the PATH variable,see step 5).4. Download and install CVSNTNote: if you intend to download the latest version of WinCvs, you do not need to do this step. If you already have CVSNT installed, check that it is at least version 2.5.1.Go to 2.On the download panel on the right of the page, select Windows, fill in therequired details, select a download server and press 'Accept terms and download'.3.When requested, press 'save' and save the windows installer package (cvsnt-2.5.01.1927.msi) to a convenient location.4.Double click on downloaded installer package and follow installation instructions.5. Set up the necessary Windows XP environment variablesYou will need to set the following environment variables:variable name value commentCVSROOT :ext:user_id@cvssrv.ifh.de:/merlin user_id is your cvs useraccount, supplied on requestwith your password.CVS_RSH ccvssh Note ccvssh.exe must be onyour Windows path (PATHenvironment variable).Alternatively you can putspecify the complete pathexplicitly for this variable(e.g. C:\mycvs\ccvssh.exe)CVS_PASSFILE path\name of password file used byccvssh Specify here the path and name of the password file to be used by ccvssh. ccvssh will create this file when you first login.(e.g. C:\mycvs\.cvspass)PATH (optional) {PATH};path to ccvssh.exe append the path to the directorywhere ccvssh.exe is installed ifrequired.To set/modify the environment variables in Windows XP, do the following: •Click on the 'start' menu and open the 'Control Panel'•Make sure that 'classic view' is selected•double click on the 'System' icon•Under the 'Advanced' tab, click on 'Environment Variables' (see below)•The following dialog will appear•Under 'User variables for …', Click 'New' and add the three new variables (CVSROOT, CVS_RSH, CVS_PASSFILE). If they already exist, highlight them and click 'Edit'.•Once finished click OK twice to dismiss the dialog boxes•Note: at this point I would re-boot your PC (or at least re-login) so that the new values of the variables are visible to Windows applications.6. Perform a one-time ccvssh loginOpen a Windows cmd shell (click 'start', and then 'run', and type cmd in the dialog box and click OK).At the prompt in the shell window, typeloginccvssh(Note that if ccvssh.exe is not on the Windows path, you will first have to change to that directory, or type the entire path).When you are prompted for your password, enter your cvs password. Your should receive the exit message 'Login OK'.At this point, ccvssh has created the password file set in the CVS_PASSFILE environment variable. DO NOT MOVE, DELETE OR EDIT THIS FILE. Providing you do not alter this file in any way, there is no reason to repeat this login procedure.At this point, you should be able to use cvs directly from the cmd shell. Simply type (for example)Merlincocvsto checkout a copy of the Merlin library in the usual manner.7. Download the latest version of WinCvs and configure it (optional)I have checked that this works with WinCvs version 2.0.0.2 (build 2), which is the current stable release available from . If you do not have this version, I advise you to de-install your current version and download and install this (or newer) version.Note that installing WinCvs also installs CVSNT, and so there is no need to do this separately as outline in step 3.Launch WinCvs.Select 'Checkout Module…' from the 'Remote' menu item:•Enter the module name you wish to check out (e.g. Merlin)•If not already correct, type (or browse) the local folder where the local copy will be checked out to•Important: make sure that CVSROOT option is unchecked; the environment variables that you have set up will take care of setting the correct CVSROOT. You should now have successfully checked out a merlin module.。