[原創]ViewCVS安裝Howto

轉載請注名出處：
http://bsd.huangdong.com/server
FreeBSD Server Howto

前言 
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。

原文轉自：http://www.anti-gravitydesign.com