CVS Setup Instructions
WebSprockets uses CVS for version control of all project programming. An account is required for access to all areas of WebSprockets CVS repository. Please contact us to request an account. The CVS repository is accessible on the web at http://cvs.websprockets.com/. Please bookmark this site for convenience.
Software
You will need a CVS client to access and use the WebSprockets CVS repository. The following are some of the more popular CVS client programs on the market:Windows
- TortoiseCVS. A handy CVS client which integrates into the right-click menu. The following Tortoise CVS Setup Guide is provided for your convenience.
- Xcode. This is a full-fledged IDE provided by Apple, which includes a CVS client. You will need to sign-up for a developer account with Apple to download Xcode. The download is very large, but you will only need to install the basic package. So be sure to do a custom install.
- Fink. This is a collection of UNIX apps ported to Mac OS X. It includes a CVS client, plus you'll have the option to install several other programs. It's harder to install, but you don't have to register with Apple to download it.
- CVL. A GUI front-end for CVS.
- BBEdit. This is the software WebSprockets recommends for interacting with CVS. BBEdit is an editor with integrated CVS support. You will still need to install CVS itself from Xcode or Fink. The BBEdit CVS FAQ page will provide several details about getting setup and going.
Direct Access
Direct access is available via ssh. The CVSROOT is::ext:joeuser@cvs.websprockets.com:/cvsroot
You will need to replace "joeuser" with your login.
Environment Variables
If you are on a UNIX-type system, you will need to set some environment variables. For Bourne-style shells (sh, ash, bash, zsh etc):
$ echo "export CVS_RSH=ssh" >> ~/.profile $ echo "export CVSROOT=:ext:joeuser@cvs.websprockets.com:/cvsroot" >> ~/.profile
For CSH-style shells (csh, tcsh), the commands are:
$ echo "setenv CVS_RSH ssh" >> ~/.profile $ echo "setenv CVSROOT :ext:joeuser@cvs.websprockets.com:/cvsroot" >> ~/.profile
You will need to log out and back in for these changes to take effect.
SSH Key Setup (Unix/Linux/Mac OS X only)
To avoid entering your CVS password for every CVS operation, you may set up key-based (passwordless) SSH access.
- Generate Keypair:
Run the following command in a terminal:
$ ssh-keygen -t dsa Generating public/private dsa key pair. Enter file in which to save the key (/home/joeuser/.ssh/id_dsa): [Enter] Created directory '/home/joeuser/.ssh'. Enter passphrase (empty for no passphrase): [Enter] Enter same passphrase again: [Enter] Your identification has been saved in /home/joeuser/.ssh/id_dsa. Your public key has been saved in /home/joeuser/.ssh/id_dsa.pub. The key fingerprint is: aa:bb:cc:dd:ee:ff:gg:hh:ii:jj:kk:ll:mm:nn:oo:pp joeuser@box - Copy Public Key:
After generating the keypair, you need to copy the public key to the CVS server:
$ scp ~/.ssh/id_dsa.pub joeuser@cvs.websprockets.com:.ssh/authorized_keys2
At this point, you should have key-based access to CVS.
Checking Out
To check out your site from CVS, run the following command:
$ cvs co example.com
This will place the current version of the example.com site into the folder named "example.com".