CVS and ViewVC on the Mac

I’m working on a project right now that involves CVS and ViewVC. I decided to set up a test environment on my MacBook for this. It was pretty easy. CVS is apparently part of the standard Mac OS dev tools install, so it was already on the machine. I set up a test repository under my home directory and put a few files in there. There’s an article on the Apple site about CVS that could get you started if you’re not familiar with CVS.

Getting ViewVC up and running took a bit more effort, but wasn’t really difficult. If you just unpack it in a folder off your home directory, you can easily run it in standalone mode. My repository is under ~/sandbox, so “bin/standalone.py -r ~/sandbox” gets it running at localhost:7467/viewvc. (Python needs to be set up on your machine, but that too is part of the standard dev tools install.)

Installing ViewVC so it’s running under Apache takes a little more effort, but it’s not too hard. I used the standard “./viewvc-install” to do a standard install to /usr/local/viewvc-1.0.7. From there, I just edited the viewvc.conf file to set my CVS root. Then, I had to set up a couple of things in Apache. The Apache config on my Mac was in /etc/apache2/httpd.conf. I set up a script alias like this:
ScriptAlias /viewvc /usr/local/viewvc-1.0.7/bin/cgi/viewvc.cgi
I also set up a “Directory” section to point to “/usr/local/viewvc-1.0.7/bin/cgi/”. I think that’s all I had to do. After that, I could access the ViewVC site at localhost/viewvc.

I didn’t try to set up the ViewVC stuff that requires MySQL, but that probably wouldn’t be too hard.

Leave a Reply