ViewCVS安裝Howto

　　 
　　前言

ViewCVS是一個使用Python書寫的查看CVS代碼庫中的 所有數據 的軟件。它已經被很多的配置管理系統所使用， 也是現在開放源代碼產品中與cvsweb一樣可以選擇的CVS輔助工具。
安裝前的準備

在你的系統中應該已經有以下軟件已經安裝：

1. python 1.5以上的版本，這個沒有安裝也可以，因為ports在編譯時是會確定它是否安裝，如果沒有安裝會自動編譯并安裝的。
2. cvs，在FreeBSD中已經內置了cvs，所以不必擔心。
3. 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。

原文轉自：http://www.kjueaiud.com