HD <hd@huangdong.com>

前言
ViewCVS是一个使用Python书写的查看CVS代码库中的 所有数据 的软件。它已经被很多的配置管理系统所使用， 也是现在开放源代码产品中与cvsweb一样可以选择的CVS辅助工具。

安装前的准备
在你的系统中应该已经有以下软件已经安装：

python 1.5以上的版本，这个没有安装也可以，因为ports在编译时是会确定它是否安装，如果没有安装会自动编译并安装的。
cvs，在FreeBSD中已经内置了cvs，所以不必担心。
mysql 3.22以上的版本，如果你需要viewcvs将数据存入mysql，哪么你应该提前安装该软件。注意，这个软件不是viewcvs运行所必须的。

在FreeBSD下安装ViewCVS
在FreeBSD下安装ViewCVS非常简单，通过ports来安装就可以了：
这样ViewCVS就安装到了/usr/local中的viewcvs-version目录中（当前版本为0.9.2）。

配置基本的ViewCVS
将viewcvs中的viewcvs.conf.dist复制一个复本名为viewcvs.conf。这个文件是viewcvs所使用的主要的配置文件。在这个文件中最少要设置以下参数：

cvs_roots设置
在viewcvs.conf中的cvs_roots的原始设置为：
我们需要将所有让viewcvs要显示的cvsroot一一加入列表中，格式为[CVSROOT名称 ] :[CVSROOT路径 ] ，以下为我的一个设置例子：
这里我设置了三个CVSRoot让viewcvs能看到，它们的名字为maven、hdsite、bsdhowto。需要注意的是每个CVSRoot之间的设置使用逗号分开

default_root
default_root是用来设置在ViewCVS首页缺省显示的cvsroot项目。

rcs_path
在viewcvs.conf中的rcs_path的原始设置是没有的：

#rcs_path = /usr/bin/
我们可以看到它已经被注释了，如果你的rcs命令不在/usr/bin目录下，哪么将注释去除，改为rcs所在路径。在FreeBSD下默认rcs就在/usr/bin下，所以这个设置可以不动。

mime_types_file
在viewcvs.conf中的mime_types_file设置也是没有的：

#mime_types_file = /usr/local/apache/conf/mime.types
我们可以将它指向apache的mime设置，也可以自己来书写一个新的设置，我感觉它不是为web服务器所使用，应该是在独立运行时使用的配置项。

ViewCVS的其它配置
除基本设置外，还有一些其它的设置也很有用，在这里我们将一些有用的设置一一说明。

[general]中的其它设置
address用来设置在页面中显示管理联系人的邮件

address = HD

[vhosts]虚拟主机支持
如果你会有多个虚似主机来使用同一个cgi，就会发现每个主机可能需要不同的viewcvs.conf的设置，哪么在viewcvs.conf中提供了vhost的设置可能。这是viewcvs.conf的原始说明：

大致一看基本上就可以看明白了，使用一个名字给一个虚似主机，并说明这个虚似主机对应的url。每一个虚似主机都可以设置所有的节属性，节的名称加上虚似主机的名称就可以了。这是我设置的一个实例：
我设置了两个虚似主机：mavencn和bsd，分别对应maven.huangdong.com和bsd.huangdong.com两个URL。在下面分别为两个虚似主机设置了general节中的default_root属性。

安装的注意事项
首先一定要注意CVS中文件和目录的权限设置，一定需要给web server运行的帐号以读的权限。在我使用FreeBSD中ports里的cvsd服务时，我将它的umask设置为022。