ViewCVS是一個使用Python書寫的查看CVS代碼庫中的 所有數據 的軟件。它已經被很多的配置管理系統所使用， 也是現在開放源代碼產品中與cvsweb一樣可以選擇的CVS輔助工具。
安裝前的準備
在你的系統中應該已經有以下軟件已經安裝：
python 1.5以上的版本，這個沒有安裝也可以，因為ports在編譯時是會確定它是否安裝，如果沒有安裝會自動編譯并安裝的。
cvs，在FreeBSD中已經內置了cvs，所以不必擔心。
mysql 3.22以上的版本，如果你需要viewcvs將數據存入mysql，哪么你應該提前安裝該軟件。注意，這個軟件不是viewcvs運行所必須的。
在FreeBSD下安裝ViewCVS
在FreeBSD下安裝ViewCVS非常簡單，通過ports來安裝可以了：
root@~$cd /usr/ports/devel/viewcvs/
root@/usr/ports/devel/viewcvs$make install;make clean
這樣ViewCVS安裝到了/usr/local中的viewcvs-version目錄中（當前版本為0.9.2）。
配置基本的ViewCVS
將viewcvs中的viewcvs.conf.dist復制一個復本名為viewcvs.conf。這個文件是viewcvs所使用的主要的配置文件。在這個文件中少要設置以下參數：
cvs_roots
default_root
rcs_path
mime_types_file
cvs_roots設置
在viewcvs.conf中的cvs_roots的原始設置為：
cvs_roots =
Development : /home/cvsroot
我們需要將所有讓viewcvs要顯示的cvsroot一一加入列表中，格式為[CVSROOT名稱 ] :[CVSROOT路徑 ] ，以下為我的一個設置例子：
cvs_roots =
maven : /home/cvsd/cvs/maven，
hdsite : /home/cvsd/cvs/hdsite，
bsdhowto : /home/cvsd/cvs/bsdhowto
這里我設置了三個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的原始說明：
# vhost1 = glob1， glob2
# vhost2 = glob3， glob4
# [vhost1-section]
# option = value
# [vhost1-othersection]
# option = value
# [vhost2-section]
# option = value
大致一看基本上可以看明白了，使用一個名字給一個虛似主機，并說明這個虛似主機對應的url。每一個虛似主機都可以設置所有的節屬性，節的名稱加上虛似主機的名稱可以了。這是我設置的一個實例：
mavencn = maven.huangdong.com
bsd = bsd.huangdong.com
[mavencn-general]
default_root = maven
[bsd-general]
default_root = bsdhowto
我設置了兩個虛似主機：mavencn和bsd，分別對應maven.huangdong.com和bsd.huangdong.com兩個URL。在下面分別為兩個虛似主機設置了general節中的default_root屬性。
安裝的注意事項
首先一定要注意CVS中文件和目錄的權限設置，一定需要給web server運行的帳號以讀的權限。在我使用FreeBSD中ports里的cvsd服務時，我將它的umask設置為022。
注:任何轉載或摘抄請注明文章出處(中文FreeBSD用戶組 http://www.cnfug.org)
