DCI Home
 
About the DCI
 
DCI Support
 
Components
Userid Management
Kerberos Authentication
AFS Filespace
License Management
User Environment
 
ipm
LSF
 
DCI Installation
UNIX
Windows NT

Using CVS at UNC-CH

CVS is a version control management system installed in AFS package space. To use CVS, it is recommended that a user set up a CVS repository in AFS space and access it using secure shell via the Isis login nodes. This document assumes that the user has a basic understanding of CVS; for more information, please see the CVS man page, or the online reference manual.

Setting up a Repository

First, make a directory in your personal, departmental or project AFS space to serve as your CVS repository. Then run the cvs init command to let CVS do the underlying work of setting up the repository. For example,

# mkdir /afs/isis/projects/test/cvsroot
# cvs -d /afs/isis/projects/test/cvsroot init

Accessing the Repository

Once the repository has been created in AFS space, there are two ways to access it. The simplist method is local access. This requires that AFS client software be installed on the workstation and that the user has a valid AFS token. With this method, the CVSROOT environment variable should be set to the local path to the CVS repository. Using the previous example, on a UNIX workstation CVSROOT would be be set to:

"/afs/isis/projects/test/cvsroot"

On a Windows workstation with /afs/isis/projects mounted as drive P, CVSROOT would be set to:

"P:\test\cvsroot"

If your workstation does not have AFS client software installed, the CVS repository can be accessed remotely, using an external rsh program to execute CVS commands on the Isis login nodes. Ssh is the preferred shell because it provides an encrypted connection between your workstation and the CVS repository. For remote access, the CVS_RSH environment variable should be set to "ssh" and the CVSROOT environment variable should be set to:

":ext:$USERNAME@login$NODE.isis.unc.edu:$PATHTOCVSROOT"

Here $USERNAME is the Isis userid, $NODE is a number between 0 and 6, and $PATHTOCVSROOT is the full AFS path to the CVS repository. Using the previous example, CVSROOT would be set to:

":ext:godehn@login0.isis.unc.edu:/afs/isis/projects/test/cvsroot"

When using ssh, do not use RSA keys for authentication. Instead, set it up so that a password must be supplied. This will ensure that valid AFS tokens are obtained on the server.

Obtaining the ssh binary

If your workstation is a UNIX host, please refer to the DCI Secure Shell page to obtain the ssh binaries. If you are using a Windows machine, you can use this stripped down version of the secure shell client. If you use this version, make sure your HOME environment variable is set; ssh uses it to store its configuration data. Also make sure that the path to the ssh program is in your PATH environment variable.




Maintained by: dci@unc.edu
Url: http://help.unc.edu/dci/dci_components/shared_apps/cvs/cvs.html
Last Updated: Nov 5, 1999