WinCVS與CVSNT簡明使用手則

1、前言：
CVS是版本控制的利器，目前在Linux和Windows下都有不同版本；但是國內大多數應用介紹都是基於Linux等開放源代碼的開放性軟體組織，而且講解的也不系統，讓人摸不著頭腦；Windows下的CVS使用介紹更是了了無幾。
本文是針對Windows的LAN環境下使用CVS的經驗介紹，一步一步的向您介紹如何配置和使用CVS的伺服器端和客戶端。同時，本文只使用到了CVS當中最基本的東西，還有很多更為高級的東西，本文暫不涉及。

1、前言：
CVS是版本控制的利器，目前在Linux和Windows下都有不同版本；但是國內大多數應用介紹都是基於Linux等開放源代碼的開放性軟體組織，而且講解的也不系統，讓人摸不著頭腦；Windows下的CVS使用介紹更是了了無幾。
本文是針對Windows的LAN環境下使用CVS的經驗介紹，一步一步的向您介紹如何配置和使用CVS的伺服器端和客戶端。同時，本文只使用到了CVS當中最基本的東西，還有很多更為高級的東西，本文暫不涉及。

2、安裝版本：
2.1、伺服器端(CVSNT)
1. 本文使用的是CVSNT-2.0.4，這是一個比較穩定的版本，不要使用最新的CVSNT-2.1.1，本人在使用中發現有比較嚴重的Bug。
2. 下載連接http://www.cvsnt.org 目前，它提供2.0.6和2.1.1版本的下載。
3. 上面連接還提供源代碼，有興趣的朋友還可以下載下來仔細研究：）。
4. 有心的朋友，仔細觀察就會發現http://www.cvsnt.org 並沒有提供任何客戶端的下載，那是因為CVS.exe既可以用於伺服器端又可以用於客戶端，WinCVS

是為了客戶端使用的方便而定制的外殼。（關於這一點，本人未得到任何證實，只是本人在使用過程中的一種體會，歡迎大家討論。）
2.2、客戶端(WinCVS)
1. 本文使用的是WinCVS-1.3b13，這應該是一個最新版本：），本人在使用過程中並沒有發現有任何嚴重的Bug。
2. 下載連接http://sourceforge.net/projects/cvsgui/
3. 此網站還提供豐富的CVS文檔和相關源代碼，以及多個OS下面的相關文檔和代碼；有收藏癖的朋友有福了：）。
4. WinCVS-1.3b13 使用的CVSNT的版本是CVSNT-2.0.2，在與伺服器端的CVSNT-2.0.4 版本配合使用時，未發現任何不相容或衝突現象。
5. 在本人的系統中用cvs version命令顯示的結果如下：
Client: Concurrent Versions System (CVSNT) 2.0.2 (client/server)
Server: Concurrent Versions System (CVSNT) 2.0.4 (client/server)
3、伺服器端(CVSNT)的安裝與配置：
3.1、伺服器端機器和環境配置：
1. 作業系統：Windows 2000 Professional SP2中文版
2. 機器名稱：Server
3. 機器地址：192.168.0.6 (內部IP)
4. 網路環境：100兆交換局域網
5. 硬盤分區格式：FAT32與NTFS都可以。
6. 準備2個CVSNT的工作目錄：
F:KHRoot (存放自己源代碼的根目錄)
F:KHTemp (存放CVS出錯資訊的目錄)
7. 本機上存在有的用戶列表：（由NT或本機的使用者創建）
Administrator (系統管理員)
Jackey (普通用戶)
Goury (普通用戶)
Riolee (普通用戶)
3.2、安裝CVSNT：
1. 下載CVSNT-2.0.4；使用administrator登陸到Server機器上。
2. 雙擊自解壓的exe文件，選擇Full Install，其他按照默認方式安裝；安裝完畢後可以在服務控制器中發現多了2個服務：cvsnt與cvslocking
3. 發送Service Control Panel到桌面，形成快捷方式。
4. 安裝程式會自動將CVS安裝路徑，設置到系統的Path環境變數當中，因此使用者可以在控制臺(cmd)中任意位置執行cvs.exe，這一點對下面的配置很重要！！
3.3、配置CVSNT伺服器：
1. 雙擊Service Control Panel快捷方式，在Service Status頁面，確認2個服務正常和穩定運行。
2. 選擇Repository頁面，點按Add按鈕，選擇已經準備好的F:KHRoot這個目錄，確認，OK，Yes，這時會在F:KHRoot下面建立CVSRoot目錄，這是CVS默認的管理目錄（默認模組）。如果報錯，那是系統Path路徑未設置正確。
3. 選擇Advanced頁面，勾上Use local users for pserver …，（Why? I don’t know!J）,在Temporary欄選擇已經準備好的F:KHTemp，確認，OK。
4. 點按【應用】按鈕，確認，退出，OK，搞定！！
3.4、小結：
1. 至此，CVSNT伺服器端基本配置完畢，下面進行WinCVS的使用和管理。
2. 由於CVS支援遠程管理，也就是客戶端與伺服器集成的特性，因此，我們將添加用戶、許可權控制、模組維護等所有的管理工作都放到遠端(WinCVS)進行管理，伺服器端這時可以Ctrl+Atl+Del進入鎖定狀態了，下面的所有工作都交給遠端的WinCVS來進行管理。

4 客戶端(WinCVS)的安裝與配置：
4.1 客戶端機器和環境配置：
1. 作業系統：Windows 2000 Professional SP2中文版
2. 機器名稱：YCW2000
3. 機器地址：192.168.0.2 (內部IP)
4. 網路環境：100兆交換局域網，可以直接訪問到Server
5. 硬盤分區格式：FAT32與NTFS都可以。
4.2 安裝WinCVS：
1. 下載WinCVS 1.3b13，全部按照默認安裝就可以了。
2. 啟動WinCVS，開始使用。特別注意：以下的所有操作都是在YCW2000(192.168.0.2)這台機器上遠程完成的，此時的Server(192.168.0.6)主機已經進入了鎖定狀態。
5 管理員使用WinCVS進行遠程管理：
5.1 配置WinCVS成管理員狀態：
1. 準備管理員工作目錄：(在YCW2000機器上)
E:CVSClientAdmin (管理員工作目錄)
E:CVSTemp (WinCVS臨時目錄)
2. 第一次啟動WinCVS時會自動彈出Preferences配置頁面，也可以通過Admin=>Preference功能表進入；第一次使用時需要配置如下的3個頁面：
General頁面設置：
注：按照圖示方式輸入即可，需要注意的是Path部分的格式是Unix路徑格式，它指的是CVSNT端設置的工作根目錄。
CVS頁面設置：

注：Home路徑是設置口令等文件的存放位置，必須指定，否則在登陸時，WinCVS也要彈出設置框。這個Home路徑需要Python.exe這個外挂程式才有效。這裡選擇已經準備好的路徑：ECVSTemp

WinCVS頁面設置：

注：此頁面設置WinCVS的外挂編輯程式，通常使用UltraEdit比較方便。
3. 設置管理員的工作路徑：可以點按圖標 ，或View=>Browse Location=>Change…功能表進行設置，選擇已經準備好的路徑：E:CVSClientAdmin，確認，OK，這時此目錄將出現在WinCVS的左邊導航欄【Workspace】內。
4. 至此，WinCVS就被配置成了遠程的管理員使用狀態，下面進行一般管理員需要的基本操作演練。演練的內容為：Administrator需要管理Jackey，Goury，Riolee三個用戶，分別為這3個用戶建立工作目錄，每個人只能訪問自己的工作目錄。同時，只有Administrator能夠進行許可權分配，其他人沒有任何管理許可權。
5.2 管理員進行管理演練：
1. 登陸遠程CVSNT：
l 選擇Admin=>Login功能表，默認設置，OK。
l 彈出口令輸入框，確認，OK。注意觀察輸出框【OutPut】的返回結果。
2. Checkout默認模組：（CVSRoot管理模組）
l 在左邊導航欄【Workspace】內，選擇【Admin】點按右鍵，選擇【Checkout modules…】，在【Checkout settings】中輸入CVSRoot，確定，OK。如下圖：

l 如果成功的話，會在【Admin】欄下增加一個【CVSRoot】目錄。表示您已經將【CVSRoot】這個管理模組下載到本地了。
3. CVS中目錄許可權介紹：
l 系統支援的目錄許可權列表：
r (讀取許可權)
w (寫入許可權)
c (創建和刪除許可權)
n (沒有任何許可權)
l 默認情況下，任何用戶都擁有任何目錄的所有許可權。
l 任何情況下只有目錄的擁有者和Administrator才有權力更改目錄的使用許可權。下面將會介紹如何修改目錄許可權和目錄的擁有者。
4. 修改CVSRoot的許可權：只讓Administrator擁有rcw三種全部許可權。
l 選中剛剛下載的【CVSRoot】模組，【Ctrl+L】或Admin=>Command Line…，彈出Command Line Settings對話方塊，直接執行CVS命令。
l 取消所有用戶的默認許可權：cvs chacl default:n 回車，OK，完成。
l 設置Administrator擁有所有許可權：cvs chacl administrator:rcw 回車，OK，完成。
l 更改【CVSRoot】的擁有者：cvs chown administrator 回車，OK，完成。
l 查看【CVSRoot】的許可權狀態：cvs lsacl 回車，OK，在【Output】中顯示：
Owner: administrator
default:n
administrator:rwc
l 【CVSRoot】的許可權配置完畢。
5. 編寫代碼庫中的模組文件，便於多用戶下載方便。
l 需要自己編寫的模組文件格式如下：(實現基本功能)
【模組一的描述】【n個空格或參數】【相對目錄路徑一(DirA)】
【模組二的描述】【n個空格或參數】【相對目錄路徑二(DirB)】
……
【模組X的描述】【n個空格或參數】【相對目錄路徑X(DirX)】
l 【描述資訊】與【相對路徑】在字面上不一致時，需要使用-a參數。
l 【相對路徑】指的是CVS會自動帶上根路徑，這裡是F:KHRoot，所以上面例子的完整路徑為：F:KHRootDirA
l 了解了模組文件結構，現在來實際操作一把：雙擊【CVSRoot】模組下的modules文件，用UltraEdit打開進行編輯。
l 為Jackey，Goury，Riolee三個用戶分配工作目錄和完成其他模組描述。
CVSRoot CVSRoot
Jackey工作目錄 -a Jackey
Goury工作目錄 -a Goury
Riolee工作目錄 -a Riolee
l 編輯完畢，存盤。回到WinCVS，選中modules這個文件【Ctlr+M】或右鍵選擇【Commit selection…】，默認設置，【確認】，OK，完成上傳。
6 . 為三個用戶分別上傳工作目錄：
l 在YCW2000機器上的E:CVSClientAdmin分別建立三個目錄分別名為：Jackey，Goury，Riolee，作為臨時交換目錄。
l 在新創建的每個目錄中用UltraEdit或拷貝一個Readme.txt作為引子文件！！：）
l 然後，回到WinCVS，在【Workspace】欄的【Admin】目錄下形成如下的目錄結構：

l 分別選中Goury，Jackey，Riolee，右鍵，點按【Import Module】，選擇【Continue】，其他全部使用默認值，【確定】，OK，完成上傳工作。
l 仔細觀察【Output】窗口，確認都成功上傳了。
l 轉移到系統的Explore程式中，刪除E:CVSClientAdmin目錄下的Jackey，Goury，Riolee三個目錄。然後回到WinCVS當中。(一定要刪除！！！：)
l 至此，就完成了工作目錄的上傳工作。
7. 【Checkout】下載3個用戶的工作目錄到【Admin】目錄下：
l 在【Workspace】欄選擇【Admin】目錄，右鍵，點按【Checkout Module…】,如下圖：

l 選擇【…】，得到CVSNT上最新的模組配置情況，彈出如下的資訊框：

l 這個結構圖就是剛才在modules當中編寫的模組文件格式資訊。選擇【Jackey工作目錄】，下載到YCW2000機器的E:CVSClientAdmin目錄下。
l 按照以上操作，依次分別下載【Goury工作目錄】和【Riolee工作目錄】。形成如下狀態：

8. 為三個用戶分別設置各自目錄的訪問許可權。（只有自己才能訪問自己的工作目錄）
l 選中【Goury】目錄，【Ctrl+L】或Admin=>Command Line…，彈出Command Line Settings對話方塊，直接執行CVS命令。
l 取消所有用戶的默認許可權：cvs chacl default:n 回車，OK，完成。
l 設置Goury擁有所有許可權：cvs chacl goury:rcw 回車，OK，完成。
l 查看【CVSRoot】的許可權狀態：cvs lsacl 回車，OK，在【Output】中顯示：
Owner: administrator
default:n
goury:rwc
l 按照以上的方法依次分別設置【Jackey】與【Riolee】的工作目錄訪問許可權。
l 至此，完成了3個用戶的目錄許可權分配。注意，雖然Administrator也沒有權力再次【Checkout】那3個用戶的工作目錄，但是它是這些目錄的擁有者又是Administrator，因此，只有它才有權力更改這些目錄的訪問許可權。
9. CVSNT系統中的用戶管理原則：
l CVSNT的用戶與本機(這裡是Server機器)上的NT用戶是相關聯的，即CVSNT用的全是本機上存在的已有用戶，因此在默認情況下可以不用設置任何用戶名，只要使用本機上已經存在的用戶名就可以用WinCVS進行登陸。
l 只有用Administrator身份登陸到CVSNT系統中，才有權力進行新用戶的創建和刪除。
l 使用CVS創建的新用戶，必須與伺服器端機器上的NT用戶相綁定，才能生效；因此，這個新用戶實際上是綁定它的NT用戶的一個替身，在CVS系統中稱為“別名”。
l 一個NT用戶可以有多個‘替身’或‘別名’，充當多個CVS用戶。
10. 用WinCVS進行新用戶的添加和刪除。(確保使用Administrator登陸)
l 【Ctrl+L】或Admin=>Command Line…，彈出Command Line Settings對話方塊，直接執行CVS命令。
l 添加新用戶【Killer】：cvs passwd -a Killer 回車，設置口令，OK，完成。
l 綁定【Killer】到【Jackey】：cvs passwd -r Jackey Killer 回車，設置口令，OK，完成。
l 兩次輸入的口令可以不同，但以第二次輸入的口令為最終口令。
l 刪除用戶【Killer】：cvs passwd -X Killer 回車，OK，完成。
l 其他特殊的功能查看passwd命令的幫助。
11.使用完畢後，一定要【Logout】，因為WinCVS退出時並不會自動登出自己在遠端的會話；這樣做是為了防止其他人接著打開WinCVS，不用登陸就可以完成你能進行的所有操作了。

6 WinCVS中常見的特殊操作：
6.1 如何刪除下載的文件或目錄：
1. 選中下載的某個或多個文件，執行【Remove】命令。
2. 再次選中這些文件，執行【Commit】命令就完成了刪除文件的操作。
3. 本質上CVS是不會刪除任何文件和目錄的，即使是執行了以上操作，刪除了某些文件，遠端CVS實際執行的是將提交刪除的文件放到了一個叫【Attic】的目錄下，因此，這些被刪除的文件是可以通過一定的方法恢復的。
6.2 如何恢復已經刪除的文件或目錄：
1. 在執行了【Remove】命令之後恢復文件。
l 【Ctrl+L】直接輸入命令cvs add xxxxx，或執行【Add Selection】界面操作。
l 這樣就可以直接恢復還未提交的刪除文件。
2. 在執行了【Commit】命令之後恢復文件。
l 只能用【Ctrl+L】直接輸入命令cvs add xxxxx，這時會得到一個空的文件。
l 選中這個空文件，執行【Update】操作，得到這個文件的實體。
l 再次選中這個文件，執行【Commit】操作，得到這個文件最新版本。
3. 由於CVS系統中本質上不會刪除任何目錄，因此，談不上對目錄的恢復，但是CVS系統默認情況下是要在用戶本機上（如：YCW2000）要刪除空目錄，因此，可以用如下方法得到已被刪除的空目錄：cvs checkout -p xxx，也可以在

Admin=>Preference的【Globals】頁面進行設置。
4. 可見，CVS系統能夠保證：只要上傳到伺服器的文件，無論你怎麼在遠程進行如何的操作，正常的或非正常的操作，都可以用Administrator登陸上去，通過以上的方法找到丟失的文件。除非用戶進入到遠端伺服器，將文件手動刪除，那就

沒辦法了：）
6.3 如何得到以前版本的文件：
1. 有時我們需要得到以前版本的文件，而WinCVS默認方式只傳遞最新的版本。
2. 選中某個文件，【Ctrl+G】或右鍵，點按【Graph selection…】，使用默認設置，就可以得到該文件所以版本的圖形結構描述。
3. 選中一個版本，右鍵，點按【Retrieve revision】，就可以得到相應的老版本文件。當然也可以得到最新版本的文件：）
6.4 有時WinCVS會變得異常緩慢，怎麼辦？
1. 確認安裝了WinCVS的機器上沒有安裝CVSNT伺服器端，因為它們使用的版本有可能不一致。
2. 只安裝了WinCVS，但以前安裝過其他版本的WinCVS，怎麼辦？
3. 先卸載所有的WinCVS系統，刪除安裝目錄下的殘留文件。
4. 打開註冊表編輯器，全程搜尋cvs關鍵字，找到一個刪除一個，一直到找不到為止！！：）
5. 重新安裝WinCVS，這個問題基本上就可以解決了，我就是這樣解決，不曉得你那裏如何？：）
7 其他說明：
1. 本文的重點在介紹如何讓使用者搭建CVSNT+WinCVS這個系統，因此重點介紹了管理員的常用操作，至於一般用戶使用到的操作，相對比較簡單和單一，使用WinCVS的次數多了，很快就會熟悉它了。
2. 這篇文檔只是窺探了CVS的一點皮毛而已，CVS當中還有很多高級的用法，以及上百個命令，還有很多新鮮的管理源代碼的方法，比如：tag，branch等模式；因此，熱烈歡迎大家積極探索，不斷共用，不斷進步。。。。。。。。
3. 另外，cvs.html這個幫助，裏面的資訊也很豐富，但是，很多地方寫得不夠清楚，需要不斷猜測和實踐才能知道怎麼回事，本文的很多經驗都是看這個幫助，如此這般，採用這個笨辦法得到的。。。。。。
4. 最後，祝願看到此文的人，得到的幫助、提高等好處大於或等於浪費的時間、反而退步等壞處！！