個(gè)人整理Firefly史上最全的常見問(wèn)題解決方案

..配置管理工具常見問(wèn)題FAQ版本V1.0文檔編號(hào)保密等級(jí)作者最后修改日期審核人最后審批日期批準(zhǔn)人最后批準(zhǔn)日期..修改記錄日期版本作者/修改者描述審核人200V1.0創(chuàng)建文檔200V1.0修訂文檔：①增加2.7、2.8、2.9等章節(jié)2009-V1.0修訂文檔：①增加常見問(wèn)題標(biāo)記；②增加第三章配置管理服務(wù)器的常見問(wèn)題..目錄TOC\o\h\z\u1導(dǎo)言12配置管理工具的常見問(wèn)題12.1客戶端安裝12.2firefly客戶端與firefly服務(wù)器連接22.3本地工作區(qū)常見問(wèn)題22.4提交文件42.5firefly服務(wù)器IP地址發(fā)生變更52.6啟用文件級(jí)權(quán)限控制52.7建立標(biāo)記及設(shè)置標(biāo)記權(quán)限62.8文件歷史版本及版本之間的比較62.9配置庫(kù)操作歷史82.10集成Eclipse操作102.11其它113配置管理服務(wù)器的常見問(wèn)題134Firefly在連接服務(wù)器時(shí)候的問(wèn)題13..導(dǎo)言本文檔描述了在HanskyFirefly使用過(guò)程中,可能遇到的一些問(wèn)題以及解決方法,作為使用Firefly的參考資料和指南。本文檔要時(shí)時(shí)維護(hù),新遇到的問(wèn)題隨時(shí)添加,以便起到真正的指導(dǎo)作用。其中紅色字體為：項(xiàng)目組成員在使用過(guò)程中經(jīng)常出現(xiàn)的問(wèn)題。配置管理工具的常見問(wèn)題客戶端安裝1在unix下安裝firelfy客戶端,需要先安裝java1.4+2在windows下安裝完firefly客戶端后,打不開firefly客戶端原因：有可能是因?yàn)殡娔X里存在多個(gè)Framework版本〔要檢查是否存在多個(gè)版本,在"控制面板"中的"添加/刪除程序"里查看解決：方案一：把"多個(gè)版本.NetFramework配置文件"文件夾下的4個(gè)config文件復(fù)制Firefly安裝目錄下的\Client\bin目錄中即可。補(bǔ)充：在給的安裝包里面有一個(gè)叫：多個(gè)版本.NetFramework配置文件的文件夾,里面有安裝程序的四個(gè)配置文件client_setting.exefirefly_admin.exefirefly_client.exeserver_explorer.exe以上是四個(gè)文件的名稱！把這個(gè)四個(gè)文件拷貝到firefly安裝目錄下的\client\bin文件夾下方案二：在"控制面板"中的"添加/刪除程序",刪除掉以前安裝過(guò)的.NetFramework,,然后再安裝.NetFramework1.1版本firefly客戶端與firefly服務(wù)器連接1Firefly客戶端連接不到Firefly服務(wù)器原因：網(wǎng)絡(luò)連接；fireflyclientsetting問(wèn)題LicenseServer設(shè)置本機(jī)系統(tǒng)時(shí)間,客戶機(jī)操作系統(tǒng)時(shí)間應(yīng)與Firefly服務(wù)器時(shí)間偏差不能超過(guò)24小時(shí)。LicenseIdlecount的個(gè)數(shù),如果為0則沒(méi)有可用的License如下圖所示：解決：檢查網(wǎng)絡(luò)是否連通；檢查是否將fireflyclientsetting中的License服務(wù)器主機(jī)地址設(shè)置為firelfly服務(wù)器地址；LicenseServer：方案一：若出現(xiàn)NoServerLicense問(wèn)題：登錄://licenseserverip:8083察看是否有正確License；登錄://fireflyserverip:8081使用admin用戶登錄,點(diǎn)擊"管理"->"刷新服務(wù)器license"。方案二：若出現(xiàn)NoLicenseavailable問(wèn)題：檢查客戶端是否正確的設(shè)置了‘FireflyClientSetting’中的參數(shù)；登錄://LicenseServerIP:8083,察看是否有正確的license。本地工作區(qū)常見問(wèn)題1Firefly本地工作區(qū)變更集丟失,或變更集鎖定,或網(wǎng)頁(yè)變更集中顯示的內(nèi)容與工作區(qū)不符解決：出現(xiàn)以上問(wèn)題,皆因?yàn)楸镜毓ぷ鲄^(qū)受損,使用命令hffcheck-repair修復(fù)本地工作區(qū)。2如何永久刪除本地工作區(qū)解決：方案一：FirelfyClient端操作菜單"工作區(qū)－>組織工作區(qū)—〉刪除相應(yīng)的工作區(qū)"方案二：Firefly命令行操作進(jìn)入本地工作區(qū)的根目錄,執(zhí)行hffwsdelete命令3如何找回丟失的文件問(wèn)題：a"非法刪除"的文件〔不通過(guò)firefly刪除的文件b已提交的合法刪除的文件〔通過(guò)firefly刪除的文件c未提交的合法刪除的文件〔通過(guò)firelfly刪除的文件解決：a：FireflyClient->工具->顯示丟失的文件—〉選擇文件后,點(diǎn)擊"獲取"按鈕,如下圖所示：b：FireflyClient->工具->顯示已刪除文件列表—〉選擇文件后,點(diǎn)擊撤銷刪除,如下圖所示：c：變更集—〉撤銷操作,如下圖所示：4打開工作區(qū)時(shí)出現(xiàn)"不能打開工作區(qū),另一進(jìn)程正在使用"錯(cuò)誤解決：打開本地工作區(qū)中的.firefly目錄,刪除其中的lockfile文件,如果沒(méi)有l(wèi)ockfile文件,則刪除properties.txt中的hansky.firefly.ws.lockport=*****此行,然后重新打開客戶端5不能初始化本地工作區(qū),出現(xiàn)權(quán)限限制提示解決：可能是對(duì)沒(méi)有權(quán)限的分支進(jìn)行了初始化的操作,請(qǐng)看清要初始化的分支名稱后再進(jìn)行初始化。6修改目錄名稱解決：由于firefly是基于文件進(jìn)行管理的,所以firefly工具不支持目錄重命名,所以要修改目錄名稱,只能建立一個(gè)新目錄,并把原目錄中的文件移動(dòng)到新目錄中。7使用fireflyunix版本初始化工作區(qū)失敗,報(bào)錯(cuò)："Can'tcreatealocalworkspaceunderanexistingone"解決：首先在網(wǎng)頁(yè)://fireflyserver:8081上察看基于該目錄的中繼工作區(qū)是否已經(jīng)刪除；然后用ll–all命令查看本地目錄中是否含有.firefly文件夾,如果有將其刪除,重新進(jìn)行初始化即可。提交文件1在解決合并沖突后用戶沒(méi)法checkin新的變更狀態(tài)解決：使用命令hffcheck–repair修復(fù)本地工作區(qū)。2用戶提交的文件不存在或"類型錯(cuò)誤"解決：檢查是否由于Firefly使用的服務(wù)器磁盤沒(méi)有剩余空間引起。3>"添加到版本控制"中不能直接檢入解決：在將新文件"添加到版本控制"時(shí),不要選擇"保持檢出"該默認(rèn)選項(xiàng)4如果一次提交三萬(wàn)個(gè)以上文件,系統(tǒng)會(huì)產(chǎn)生錯(cuò)誤解決：分批添加提交,每次添加提交文件少于三萬(wàn)個(gè)5提交文件時(shí),提示"輸入注釋"解決：使用firefly工具提交文件時(shí),要在注釋中輸入此次修改文件的目的,然后再選擇提交firefly服務(wù)器IP地址發(fā)生變更1更換服務(wù)器地址后,firefly客戶端的本地工作區(qū)不能使用解決：打開本地工作區(qū),顯示未連接,此時(shí)打開：工具－>選項(xiàng),選擇"當(dāng)前工作區(qū)設(shè)置"選項(xiàng)卡,將服務(wù)器主機(jī)設(shè)置為新的服務(wù)器地址,并確定；然后關(guān)閉工作區(qū),退出,再重新打開firefly客戶端。2>在更換服務(wù)器后,修改"當(dāng)前工作區(qū)設(shè)置"中"Firefly服務(wù)器主機(jī)"時(shí),打不開工作區(qū)解決：打開本地工作區(qū)的.firefly文件夾,修改properties.txt中這一行：hansky.firefly.server.host=********,把以前的服務(wù)器地址修改為新的服務(wù)器地址。3>本機(jī)存在多個(gè)ip地址的情況下,連接firefly服務(wù)器時(shí)出現(xiàn)下列現(xiàn)象：使用Web可以登陸,但使用客戶端時(shí)彈出"找不到服務(wù)器"解決：在firefly命令行下執(zhí)行如下命令：hffsetrmc.client.usebindingtruehffsetrmc.client.bind.addressxxx.xxx.xxx.xxx<具體本機(jī)IP地址>注意：如果本機(jī)不存在多個(gè)IP,而之前綁定過(guò)的IP與當(dāng)前機(jī)器IP不同,建議執(zhí)行命令：hffsetrmc.client.usebindingfalse取消綁定,而不是綁定為新的IP地址。啟用文件級(jí)權(quán)限控制1在啟用文件級(jí)訪問(wèn)控制的情況下,更換服務(wù)器后,用戶更新文件的權(quán)限失效解決：重新初始化工作區(qū)。添加或編輯文件時(shí)出錯(cuò),Error65748：ACLDenied解決：檢查是否已經(jīng)給該用戶的分配相應(yīng)的文件權(quán)限。建立標(biāo)記及設(shè)置標(biāo)記權(quán)限無(wú)法下載標(biāo)記解決：查看是否有相應(yīng)標(biāo)記的下載權(quán)限；如果沒(méi)有,請(qǐng)標(biāo)記的建立人員把標(biāo)記bringover的權(quán)利分配給相應(yīng)人員手工查找文件建立標(biāo)記容易出錯(cuò)解決：對(duì)需要建立標(biāo)記的文件生成文件列表,利用firefly命令行建立標(biāo)記hffbrlabel-h<配置管理服務(wù)器地址>-proj<配置庫(kù)項(xiàng)目名稱>-b<配置庫(kù)名稱>-lf<文件列表><標(biāo)記名稱>使用命令下載標(biāo)記解決：hffdownload-h<配置管理服務(wù)器地址>-proj<配置庫(kù)項(xiàng)目名稱>-l<標(biāo)記名稱>-d<下載的目標(biāo)路徑>注：下載的目標(biāo)路徑必須為空目錄文件歷史版本及版本之間的比較使用firefly的windows客戶端查看文件歷史版本解決：能夠列出文件所有歷史版本,并可以查看任意版本,選中文件,單擊右鍵,選擇"顯示文件歷史",出現(xiàn)歷史選項(xiàng),如下圖所示：選中時(shí)間段后,單擊"確定",顯示出文件歷史,如下圖所示,選中想查看的版本進(jìn)行查看即可。使用firefly的windows客戶端進(jìn)行文件版本之間的比較解決：能夠進(jìn)行文件當(dāng)前版本與其他版本比較,選中文件,單擊右鍵,選擇"版本比較",出現(xiàn)"比較版本",如下圖所示：可以與前一版本進(jìn)行比較,也可以選擇其他版本,也可以選擇其他文件,選擇好文件單擊"確定"即可。使用firefly的unix客戶端查看文件歷史版本解決：使用命令hffhist<文件名>,可以顯示指定工作區(qū)文件的歷史版本包括文件的版本號(hào),修改時(shí)間,修改人,修改注釋等使用firefly的unix客戶端獲取文件歷史版本解決：使用命令hffget-v<要獲取的版本><文件名>,可以獲取指定工作區(qū)文件的歷史版本使用firefly的unix客戶端進(jìn)行文件版本之間的比較解決：使用命令hffdiffs-v1<指定該文件的源版本>-v2<指定該文件的目標(biāo)版本><文件名>,該操作比較本地工作區(qū)文件任意兩個(gè)版本的不同使用firefly的web界面查看文件歷史版本解決：從web界面登陸配置管理系統(tǒng),找到要進(jìn)行查看的文件并選中文件,出現(xiàn)如下界面,選擇"歷史"既可以查看相應(yīng)的歷史版本,選擇"原始數(shù)據(jù)"即可以獲取當(dāng)前版本的文件使用firefly的web界面進(jìn)行文件版本之間的比較解決：選中要進(jìn)行版本比較的文件,點(diǎn)擊歷史,出現(xiàn)如下界面,選擇"版本",即可查看相應(yīng)版本的內(nèi)容,選擇"比較版本",可以進(jìn)行任意版本的比較。配置庫(kù)操作歷史查看某項(xiàng)目的配置庫(kù)操作歷史解決：登陸web界面,選中要進(jìn)行查看的項(xiàng)目,選中配置庫(kù),如下圖所示：選擇"歷史",界面如下所示,可以查看用戶在配置庫(kù)中所作的操作,包括：操作、用戶、變更、工作區(qū)和變更時(shí)間查看某項(xiàng)目配置庫(kù)中已檢出的文件解決：運(yùn)行FireflyServerExplorer,選中項(xiàng)目的配置庫(kù),如下圖所示：選擇：工具<分支檢出列表,如下圖所示,可以列出配置庫(kù)中已檢出的文件,包括：文件名、檢出用戶及鎖定者,配置管理員可以根據(jù)文件列表通知相關(guān)用戶進(jìn)行文件檢入集成Eclipse操作如果不小心刪除了文件,如何找回？解決：在Eclipse中選擇刪除操作,會(huì)觸發(fā)firefly將該文件從配置庫(kù)中刪除,所以要慎用。如果刪除,可通過(guò)web瀏覽器下載已刪除的文件,再重新上傳到配置庫(kù)中〔firefly會(huì)將刪除文件按照目錄結(jié)構(gòu)移動(dòng)到DELETE目錄下。其它提高服務(wù)器速度解決：為了提高Firefly服務(wù)器性能,建議設(shè)置防病毒程序忽略掃描Firefly存儲(chǔ)庫(kù)目錄設(shè)定Fireflyclient超時(shí)門限解決：hffsetrmc.client.connect.timeout<毫秒>例如：hffsetrmc.client.connect.timeout1000默認(rèn)設(shè)置為2000在網(wǎng)絡(luò)環(huán)境不好時(shí)：希望提高上傳和下載成功率,調(diào)大門限值希望Fireflyclient反應(yīng)快,調(diào)小門限值激活或者禁止Explorer集成解決：激活：%Firefly%\client\bin\shell禁止：%Firefly%\client\bin\shell-u文件名大小寫解決：跨平臺(tái)要求,建議文件名和目錄名均采用小寫命名避免使用的字符：~#&<>;,*:"<>\?./關(guān)于文件過(guò)濾解決：用戶可以在Fireflyclient的工具—〉選項(xiàng)—〉文件操作下的"不添加至版本控制的文件類型"內(nèi)容復(fù)選框中,設(shè)置不被添加到Firefly資源控制中的文件類型,如.bak,并選中"缺省使用文件過(guò)濾器",如下圖所示：關(guān)鍵字轉(zhuǎn)換解決：Firefly提供了使用關(guān)鍵字轉(zhuǎn)換功能,若選中該復(fù)選框,當(dāng)用戶編輯文件并保存的本地變更之后,文件中的關(guān)鍵字將被轉(zhuǎn)換成實(shí)際的數(shù)值,如%G%將轉(zhuǎn)換為具體的時(shí)間。打開客戶端時(shí)報(bào)初始化錯(cuò)誤,報(bào)錯(cuò)q9,配置服務(wù)器license的時(shí)候報(bào)"保存配置錯(cuò)誤"解決：由于firefly和系統(tǒng)時(shí)間及時(shí)區(qū)有關(guān),通常我們的電腦都用北京時(shí)區(qū),而北京時(shí)區(qū)沒(méi)有firefly需要調(diào)用的類,所以可先將本機(jī)調(diào)整成其他時(shí)區(qū),然后再調(diào)整回來(lái)即可。如何查看其它用戶在這個(gè)分支上所做的未提交的變更集的內(nèi)容？用戶可以查看其他用戶在這個(gè)分支上所作的尚未提交到服務(wù)器上的變更。方案一：在FireflyWeb界面上：打開瀏覽器,在地址欄輸入://FireflyServerIP:8081,然后輸入正確的用戶名和密碼登錄FireflyWeb。在FireflyWeb架構(gòu)樹上的指定項(xiàng)目下,選擇一個(gè)分支,信息面板上將會(huì)顯示該分支的屬性信息。在信息面板的分支屬性表單中,選擇中繼工作區(qū),則信息面板中將顯示分支下的所有中繼工作區(qū)。在信息面板的列表中,選擇想要查詢的用戶的中繼工作區(qū),則頁(yè)面上會(huì)顯示該中繼工作區(qū)的具體內(nèi)容。在中繼工作區(qū)屬性右側(cè),有一個(gè)操作面板,選擇變更集按鈕,可以查看這個(gè)用戶對(duì)工作區(qū)文件的變更,這些變更都是沒(méi)有提交到Firefly服務(wù)器上的變更。方案二：在FireflyClient界面上：在聯(lián)機(jī)狀態(tài)下,在FireflyClient界面上,打開一個(gè)本地工作區(qū)。用戶可以在變更集列表欄中查看到其他用戶的變更集信息,以及他們對(duì)工作區(qū)文件所做的變更。如果不小心做了撤銷編輯操