StarTeam操作手冊.doc

StarTeam平臺操作手冊一、 對象和目標 誰可能從本教程中獲得益處？ StarTeam初級用戶 公司新員工 本教程目標 掌握StarTeam的基本操作 了解配置管理規(guī)范二、 StarTeam在配置管理中的作用 提供一個共享平臺 安全可靠的文件管理 版本管理 項目周期開發(fā)中，進行有效的分支管理。三、 StarTeam基本操作(一) Add Server準確輸入StarTeam 服務(wù)器的ip地址（2）以及端口號(49201)，并為這個設(shè)置在本地命名為“第一研究室”。(二) 登錄項目出現(xiàn)服務(wù)器選擇畫面，如下所示：點擊“Log On As”按鈕：出現(xiàn)登錄畫面成功登錄后，第一研究室自動展開，列出當(dāng)前用戶有權(quán)看到的所有項目選擇“測試項目”，點擊“完成”按鈕，進入項目畫面(三) 新建項目點擊“Project/New”菜單，出現(xiàn)如下畫面：點擊“下一步”，出現(xiàn)如下畫面：選擇工作目錄，也就是項目在本地的位置，然后按“下一步”點擊“完成”就可以了。(四) 選擇視圖選擇“View/Select View”菜單，出現(xiàn)如下畫面：選擇視圖“項目樣板”，點擊“OK”即可(五) 創(chuàng)建視圖選擇“View/New”菜單，出現(xiàn)如下畫面選擇“下一步”選擇子目錄作為新的視圖，點擊“下一步”修改工作目錄，如果采用默認得目錄，將會造成和根視圖沖突，點擊“下一步”：選擇視圖標簽（Confiuration as of）或加入已有標簽(Labeld configuration)，也可以選擇浮動配置。(六) 視圖比較和合并選擇“View/Compare/Merge”，選擇項目，點擊“完成”，出現(xiàn)視圖比較畫面分別選擇不同的視圖標簽左右兩邊分別選擇相同的目錄，如果有不同的地方，將會在下面顯示選擇差異項，右鍵出現(xiàn)畫面：選擇合并或共享來獲得想要合并的內(nèi)容。(七) 選擇標簽 StarTeam的標簽（View Label）主要用來記錄事件，如里程碑; 和代碼分支沒有必然的聯(lián)系 Starteam 的 Label 是建立在視圖中，針對一個View中所有文件，也就是View Label。 View Label非常靈活，可以將后來新增加的文件加入到View Label中。我們在使用時是將View Label分為以下兩種來進行標識 Baseline Label項目的基線標記 Build Label項目的構(gòu)建標記標簽分視圖標簽和修訂標簽，視圖標簽用于對整個視圖作標記；修訂標簽用于對部分文件或目錄打標記。標記的目的是為了取版本或文件的方便以及新舊版本的對照。假如我想取標記為Buile #1014的版本，可以按如下操作：點擊“OK”即可。標簽在凍結(jié)前，可以自由的往標簽中加內(nèi)容，也可以從標簽中移走內(nèi)容。(八) 創(chuàng)建標簽選擇“View/Label”，出現(xiàn)如下畫面：如果是視圖標簽，將直接和當(dāng)前視圖附接，如果是修訂標簽，將不附接任何內(nèi)容。(九) 文件操作 上傳文件 將需要載入的文件進行正確的標識后放到本地相應(yīng)工作路徑 在starteam中F5刷新，會看到該文件為not in view狀態(tài)，選中文件，執(zhí)行add in 操作即可。 在開發(fā)目錄中中有部分類型文檔是限制載入的，如：.pch,.scc, .dll, .exe, .obj, .clw, Add in 操作： 主菜單中File-add files或右鍵菜單add files或工具條可以將文件上傳到服務(wù)器。 添加文件時要注意：一定要將臨時文件和二進制文件（編譯過程的目標文件，可執(zhí)行文件等）排除在外，以免引入數(shù)據(jù)垃圾。因為 Starteam 很難將文件徹底從服務(wù)器端刪除。 更新文件 選中需要更新的文件，check out and lock 打開，編輯，保存（此時文件保存是在本地）。 在starteam中F5刷新一下，會看到剛才編輯的文件為modified狀態(tài)。 選中文件，check in and unlock Check out and lock便捷操作：工具條中 按鈕 Check in and unlock便捷 操作：工具條中 按鈕 查看文件最新版本 All descants 按鈕：是否展示子目錄中文件。 查看一批文件：選中文件所在目錄，在右上的展示框中選中文件（支持shift和crtl批量選擇），點擊工具條上 按鈕，即可將文件check out到本地相應(yīng)目錄。 查看所有文件：在主菜單中或者選中一個文件在其右鍵菜單中選擇File-check out all菜單，即可將本項目所有文件一次性check out到本地相應(yīng)目錄。 便捷查看單個文件： 選中文件，雙擊，文件被打開。并且本地相應(yīng)路徑會有該文件的current版本。 查看文件歷史和歷史文件 查看文件歷史選中文件，選擇history按鈕，在右下展示框中會有文件的歷史信息：何時誰建立文件，何時誰修改文件等。 查看歷史文件內(nèi)容 選中歷史信息，右鍵選擇Open revision content 文件properties選中文件右鍵properties菜單，或者主菜單File-properties 文件狀態(tài) 五種正常文件狀態(tài) Not in view：文件在本地，不在服務(wù)器中(Add files or delete) Currut：本地和服務(wù)器中文件版本一致(無需任何操作) Modified：本地文件版本比服務(wù)器中新(Check in) Out of date：服務(wù)器中文件版本比本地新(Check out) Missing：文件在服務(wù)器中，本地沒有(Check out) 兩種不正常文件狀態(tài) Merge：本地與服務(wù)器中文件版本有交叉(比較) Unknown：Starteam對文件狀態(tài)的辨識有錯誤 (Update Status、統(tǒng)一客戶端與服務(wù)器時間、 Force Check In或者Force Check Out （但小心覆蓋）)(十) 個性化設(shè)置 更改密碼新添加的用戶在第一次登陸時要求更改密碼，如下圖對話框： 如果需要修改密碼可以按照以下操作進行：Tools Server Administration選擇所在的Server點擊My Account 設(shè)定本地工作路徑默認工作路徑的設(shè)置 Folder Create Working Folders默認路徑?jīng)]有空間或者本地沒有默認路徑的磁盤號時候，可以在viewproperties中設(shè)置個性的本地工作路徑。四、 StarTeam和開發(fā)環(huán)境的整合 StarTeam和Delphi7的整合選擇“Select Porject”菜單，從服務(wù)器下載項目點擊“OK”，就會將服務(wù)器上的項目取下來并使本地和服務(wù)器建立連結(jié)。選擇“New Project”菜單，可以從本地上傳項目到服務(wù)器。當(dāng)本地和服務(wù)器連接后，就可以操作文件了選擇“Check in File”上傳文件和修改選擇“Check Out File”從服務(wù)器取文件 StarTeam和.Net環(huán)境的整合選擇“Pull Solution”或者 “Pull Project”可以將解決方案或項目取到本地選擇“Place Solution”或者“Place Project”可以將本地項目或解決方案上傳到服務(wù)器選擇“Update Project”菜單可以從服務(wù)器獲取最新的版本，并保存本地修改，如果發(fā)生沖突會提示合并。選擇“Commit Project” 菜單可以將本地的修改保存到服務(wù)器上。選擇“Check In” 菜單可以將某一項或者幾項的修改保存到服務(wù)器上選擇“Check Out” 菜單可以將服務(wù)器上的指定的文件下載到本地選擇“Find” 菜單可以將得到項目的所有項列表以及每一項在服務(wù)器上的狀態(tài)選擇“Compare Contents” 菜單可以服務(wù)器和本地文件的區(qū)別選擇“Pending Check Out” 菜單可以將系統(tǒng)認為需要Check Out的所有文件列出來，供用戶選擇同理，選擇“Pending Check In” 菜單可以將系統(tǒng)認為需要Check In的所有文件列出來，供用戶選擇選擇“Revert” 菜單系統(tǒng)將只取和本地文件相應(yīng)的早期版本，不考慮后期版本。 StarTeam和Java環(huán)境Eclipse3.1的整合選擇“Synchronize Outgoing”是本地修改模式，可以將文件和項目簽出到本地，修改后通過Synchronize with server 將修改的內(nèi)容保存到服務(wù)器；選擇“Synchronize Incoming”是服務(wù)器修改模式，表示修改來自服務(wù)器；選擇“Lock/Unlock”表示對文件加鎖，以便排他操作；選擇“Label”可以設(shè)定標簽，標示項目的修改和進度。五、 StarTeam管理員備份 下面的文件必須備份： 配置文件starteam-server-configs.xml：這個文件在StarTeam Server的安裝目錄，包含了數(shù)據(jù)倉庫的信息以及sqlserver、數(shù)據(jù)源的相關(guān)信息。 數(shù)據(jù)庫文件：必須記下數(shù)據(jù)庫的名稱，并用備份數(shù)據(jù)庫命令備份 數(shù)據(jù)倉庫HiveArchives folder: *.*Attachments folder: *.*或者干脆備份數(shù)據(jù)倉庫的所有東西，記下倉庫路徑 備份方案： 建立任務(wù)：鎖定StarTeam Serverstcmd server-mode -s Administrator:ASEC-HUPING:49201 -mode lock建立sqlserver任務(wù)：夜里0：00 備份數(shù)據(jù)庫建立任務(wù)：夜里1：00起拷貝以上配置文件、數(shù)據(jù)倉庫文件和數(shù)據(jù)庫文件到指定目錄；COPY F:Program FilesBorlandStarTeam Server 2005starteam-server-configs.xml C:BackupForStarTeamXCOPY F:phuTest C:BackupForStarTeam /E建立任務(wù)：解鎖StarTeam Se