Collected by Khaled Al-Sham’aa (www.ar-php.com) CVSNT 2.5.03 Installation on Windows 2003 Notice: This guide is written as an installation help for CVSNT 2.5.03 and higher on Windows 2003 server. Most of the discussion is also valid for installation on Windows XP-Pro (see below for an important setting). NOTE! You cannot use XP-Home for CVSNT! Installation of the CVSNT server File system type: Make sure your system is only using the NTFS file system! Also make sure you are logged on as an administrator of the PC (using an account with administrative priviliges). And most important: Use the local disk on the CVSNT server! IMPORTANT for XP-Pro users: You MUST switch off Simple File Sharing, which is the default for XP (as recommended by Microsoft to make XP somewhat compatible with Win95-98-ME)! You do this by opening a Windows Explorer and then use the menu command Tools/Folder Options. Select the View tab and scroll down to the bottom where you find this item. Uncheck it now! Page 1 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Now for the actual installation and configuration: Get the latest release of CVSNT Download the latest CVSNT installation from http://www.cvsnt.org Create CVS directories Create two directories on the target machine, c:\cvsrepos (for the repository, which will contain modules, which will contain your files) and c:\cvsrepos\cvstemp (for temporary scratch files used by CVSNT internally). If you have a separate disk partition to spare for CVS then use that instead. The important point here is that the disk where the repository is located on is NTFS. Directory security and permissions Give c:\cvsrepos\cvstemp security settings that allows full control for all accounts including SYSTEM. Important: The cvstemp directory must NOT be located in either c:\WINNT\Temp or anywhere in the "C:\Documents and Settings" tree because these locations have imposed restrictions on user access! Notice that on XP-Pro out of the box from Microsoft the permissions cannot be set like this until "Simple File Sharing" is switched off (see above). So you must do this if you use XP-Pro. XP-Home is totally unsuitable for CVSNT! If you have a separate disk partition to spare for CVS then use them instead, e.g. f:\cvsrepo and f:\ cvsrepos\cvstemp. It is okay to use subdirectories for these key locations, example: d:\AppsData\cvsrepo e:\temp\cvstemp Important: Avoid spaces in the path leading to your repository. Give c:\cvstemp security settings that allows full control for all accounts including SYSTEM (remember: SYSTEM is not included in Everyone). Page 2 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Install CVSNT Windows XP and 2003 Note : On some machines the WMI service may cause an access denied error. To prevent this you must stop the WMI service before the install and then restart the service after the install completes. Run the downloaded CVSNT setup file and make sure to change the installation path to c:\programs\cvsnt (I am paranoid about removing any spaces in paths used by cvs!) Start screen: Page 3 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) License agreement: Setup Type (Choose Custom to select install directory): Page 4 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Installation component selection screen: Note: I strongly recommend that you install CVSNT to a path that does NOT contain any embedded spaces. Ready To Install! Page 5 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Install Progress: Installation Done! Page 6 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Reboot You must reboot after installing CVSNT for the first time for all NT/Win2000/XP installations. If you do not restart, you will get a "Repository initialization failed" error when you try to create a repository. Note that it is not necessary to reboot the server if you are merely upgrading CVSNT. This is necessary because services will not see the updated system path until after the system is restarted. Page 7 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Configuring the CVSNT server and repository CVSNT Control Panel configuration Open Control Panel and look for the CVSNT applet (the green fish): Start the applet with this icon: Page 8 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) CVSNT is configured from the CVSNT Control Panel, which can be reached via the shortcut link placed under the Start menu during installation. Now open the CVSNT control panel applet and do the following: Page 9 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Shut down the CVSNT service Check that the CVSNT Service is not running (Start button is enabled). This is the initial screen showing that both services are running: If it is started then stop it. You can leave the Lock Service running. Page 10 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Repository creation The tab will initially look like this: Add repository Now you will add a repository to the server. This is done using the "Add" button. When you click this a dialogue shows up where you will define your repository. Page 11 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Repository folder Click the ellipsis button for Location to bring up the folder browser. Now you can browse to the location you want for your repository and add a new folder here. NOTE: I strongly advice NOT to use paths with embedded spaces for CVS! Name repository Now fill in the description and the name of the repository as well. NOTE: Do NOT accept the suggested name, which is the same as the folder path! Instead only use the bare folder name with a leading / like this: Page 12 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Initializing the repository When you click the OK button there will be a dialog where CVSNT offers to initialize the new repository. When you click Yes then the new folder will be converted to a real repository: First repository added! Now the list of repositories has been populated with the first repository: You can add as many as you like (almost) but please do not fall for the temptation to use one repository for each and every project! There are a lot of possibilities to streamline the development process using CVSNT, but many of these use the virtual modules concept and this is only possible within a single repository. Page 13 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Server Settings Now go on to the Server Settings tab. Here the default settings are all right for now, except the Temporary Directory setting. NOTICE about Domains: You can set the Default domain entry to either the CVSNT server PC name (as in the example above) or the domain name to which the CVSNT server belongs. CVSNT will strip the domain part from all accounts that log on using the default domain before processing. All other logons will be processed using their complete names (DOMAIN\username). The result of this is that all users that "belong" to the domain specified in this box will be logged using only the account name, likewise these usernames will be supplied to the administrative scripts without the domain name. All others will have a domain name added. This must be accounted for in any admin script used. The CVSROOT/users file is one such admin file that needs to be handled with care concerning domain and non-domain entries. Temp dir: Use the ellipsis button to browse for the folder prepared for this purpose above: Page 14 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Compatibility On the next tab (Compatibility Options) there is nothing you need to change for now: Page 15 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Plugins and protocols The Plugins tab define a lot of the extra features of CVSNT including some aspects of the connection protocols. The screen list the available plugins and when you select a line you will be able to configure this plugin by clicking the configure button: Sserver configuration Here is the configuration window for the SSERVER protocol plugin. Please set it like this: Page 16 of 33 Collected by Khaled Al-Sham’aa (www.ar-php.com) Advanced settings The final tab on the Control Panel deals with advanced configuration settings and you need not change anything here. Apply configuration changes Now click the Apply button! This is really important , nothing will happen unless you do this! Note that after you have done this the Apply button is disabled. Start the CVSNT service Go back to the first tab and click the Start button . After a few moments the Stop button will be highlighted. Now CVSNT runs (success!) Restart the server In order for you to be able to use the command line cvs you need to have the path variable set to include the location of the cvs.exe just installed (c:\programs\cvsnt). Since the installer will have put this into the system path variable it will work if you restart the server. You can check this by going to a command window and typing the command: cvs --ver If this results in an error message then you should restart the server PC before continuing.