Installing and configuring CVS

These features are available in JBuilder Enterprise edition

This section provides information for installing and configuring a CVS client on your system.

After CVS is installed, see the "Configuring CVS in JBuilder" topic below to learn how to configure the connection to CVS in JBuilder.

Note: The most current versions of CVS available for Windows, Solaris 7, and Linux are included on the Companion Tools CD-ROM that comes with JBuilder Enterprise edition. See the platform-specific installation instructions to find out where to download CVS from the web.

Tip: If you already have CVS installed, check the version number by entering cvs -version at the command line.

Configuring your computer for CVS

To install CVS and configure your computer to recognize it, load the Companion Tools CD-ROM into your CD drive and follow the platform-specific steps below:

Windows 95/98

To install CVS version 1.10.8,

  1. Create a new folder called cvs.
  2. Look in the Companion Tools CD for the CVS folder. Look inside that for the Windows NT/2000 folder.
  3. Extract the ZIP files from the Windows NT/2000 folder into the cvs folder.

This will install CVS in the folder. When the installation is complete, configure your computer to recognize the CVS installation:

  1. Select Start|Run.

  2. Enter sysedit in the text field. This will bring up all system files.

  3. Look at the autoexec.bat file.

  4. Add a SET PATH line to the CVS executable. If CVS is installed at the root of the C: drive, your line of code will look like this:

    SET PATH=C:\CVS;%PATH%

  5. Save the altered autoexec.bat file.

  6. Restart your computer to apply the changes.

Windows NT

To install CVS version 1.10.8,

  1. Create a new folder called cvs.
  2. Look in the Companion Tools CD for the CVS folder. Look inside that for the Windows NT/2000 folder.
  3. Extract the files in the ZIP archive from the Windows NT/2000 folder into your new cvs folder.

This installs the CVS client in your cvs folder.

When the installation is complete, configure your computer to recognize the CVS installation:

  1. Click the Start button, choose Settings, then choose Control Panel.
  2. In the Control Panel, double-click System.

  3. Select the Environment tab.

  4. Look for the PATH environment variable under System Variables.

If you're interested in installing a CVS server on Windows NT, there is a readme file in the ZIP archive that tells you how to do so.

Windows 2000

To install CVS version 1.10.8,

  1. Create a new folder called cvs.
  2. Look in the Companion Tools CD for the CVS folder. Look inside that for the Windows NT/2000 folder.
  3. Extract the ZIP files from the Windows NT/2000 folder into the cvs folder.

This will install CVS in the folder. When the installation is complete, configure your computer to recognize the CVS installation:

  1. Right-click on the My Computer icon.

  2. Select Properties from the right-click menu. This displays the System Properties dialog box.

  3. Select the Advanced tab.

  4. Click the Environment Variables button. This brings up the Environment Variables dialog box.

  5. Look in the User Variables area. Select the Path variable.

  6. Click Edit. This brings up the Edit User Variables dialog box.

  7. Insert the path to your cvs.exe file and a semicolon right before %PATH%. For example, if C:\cvs is the path to your installation, the entry would look like this: C:\cvs;%PATH%.

  8. Click OK in the Edit User Variables dialog box.

  9. Click OK in the Environment Variables dialog box.

  10. Click OK in the System Properties dialog box.

Solaris

To install CVS on a Solaris platform,

  1. Enter su at the command line to switch to your system root.
  2. Enter:

    pkgadd -d cvs-1.10.7.sol7-sparc-local

This will install CVS version 1.10.7 from the Companion Tools CD onto your system root.

Solaris users may use the version of CVS that Sunfreeware.com provides for your specific platform instead. Go to http://sunfreeware.com/ and choose your platform from the column in the upper right of the page. Then choose the available version of CVS in the lower right column. See the installation instructions at http://sunfreeware.com/download.html to learn how to install it correctly from that site.

If CVS is already installed and in the system path, then you probably don't need to make further modifications. Verify that CVS is in your system path and that you are using version 1.10.7 or 1.10.8 by entering cvs -version at the command prompt.

If CVS is installed outside of the system path, such as in your home directory,

  1. Edit the PATH environment variable in your shell's init file.
  2. Add specifications for the path to your CVS directory to the PATH environment variable. Separate the directories for the PATH specification with a colon.
  3. Log out and then log in again to apply the changes.

Linux

To install CVS on a Linux platform,

  1. Enter su at the command line to switch to the system root.
  2. Enter:

    rpm -Uvh cvs-1.10.7-7.i386.rpm

This will install CVS version 1.10.7 from the Companion Tools CD onto your system root.

The Linux version of CVS on the Companion Tools CD is tested and verified by Red Hat and is expected to be compatible with any RPM-based system.

If CVS is already installed and in the system path, then you probably don't need to make further modifications. Verify that CVS is in your system path and that you are using version 1.10.7 or 1.10.8 by entering cvs -version at the command prompt.

You can download CVS from http://www.cvshome.org/. Use either version 1.10.7 or 1.10.8 with JBuilder 4.

Configuring CVS in JBuilder

To set the default CVS root path in JBuilder,

  1. Select Project|Default Project Properties.
  2. Select the Team tab.
  3. Choose CVS as your version control system. This will activate the dialog.

    Project|Project Properties, Team page, with CVS selected

  4. Choose your connection type.
    Local means that the target CVS repository is accessible locally. PServer means that the target repository is on a server. It may require password access, but transmissions are not encrypted over this type of connection. Ext is a remote connection type in which transmissions can be encrypted so that they can't be read in transit.

    Note: If you are using an ssh secure connection, see the Help|Release Notes for more information.

  5. Enter your login settings.
    The available options will change according to the type of connection you choose.

  6. Set the module location.
    1. Enter the repository path. If your repository is local, you can click the ellipsis (...) button to browse to it.
    2. Enter the module name if you plan to use only one module for all your work. If you expect to use more than one module, you may leave the default module name blank.

  7. Choose additional functions.
    1. Check Autosave Files Before CVS Operations if you wish to automate saving. If you uncheck this, you will be prompted to save before JBuilder executes any CVS commands.
    2. Check Show Console Messages if you want JBuilder to display the console messages in the message pane at the bottom of the AppBrowser. To read a console message, double-click on the console icon in the message pane.

  8. If you want to erase what you have set in a new configuration, or if you want to keep changes you just made to an existing one, click Reset. Once you click OK, changes must be made manually.

  9. When you have set your configuration, click OK.
Notice that the status message at the bottom of the dialog changes to reflect what you set for connection type, login settings, and repository path. This information constitutes the CVSROOT variable for that connection. CVSROOT variables are constructed as follows:

Connection type CVSROOT syntax
Local :local:[repository path]
PServer :pserver:[username]@[server name]:[repository path]
Ext :ext:[username]@[server name]:[repository path]

You can set different connection properties for individual projects by selecting Team|Configure Version Control when you have the target project open in the AppBrowser.