STYLEREF文檔標題STYLEREF文檔標題文檔標題配置管理工具常見問題FAQSTYLEREF文檔標題STYLEREF文檔標題文檔標題神州數(shù)碼融信質(zhì)量管理體系 修改記錄日期版本作者/修改者描述審核人200V1.0創(chuàng)建文檔200V1.0修訂文檔：①增加2.7、2.8、2.9等章節(jié)2009-V1.0修訂文檔：①增加常見問題標記；②增加第三章配置管理服務(wù)器的常見問題目錄TOC\o\h\z\u1導(dǎo)言 12FireflyClien常見問題 12.1安裝常見問題 11) 安裝firelfy客戶端，需要先安裝java1.4+ 12) 在windows下安裝完firefly客戶端后，打不開firefly客戶端 13) 安裝完firefly客戶端后，運行程序時報：“Thetypeinitializerfor‘com.hansky.apps.firefly.gui.fe.FileExplorer’threwanexception.”； 1并且在配置FireflyClientSetting后保存時，報“Savelicenseconfigurationfilefailed” 14) 安裝完firefly客戶端后，運行程序時報：“UnabletoloadDLL(vjsnativ)” 25) 英文Windows2003SP1無法打開Firefly客戶端安裝文件，無法進行客戶端安裝 22.2客戶端連接服務(wù)器常見問題 21) Firefly客戶端連接不到Firefly服務(wù)器 22.3使用常見問題 32.3.1WINDOWS 31) 本地工作區(qū)變更集丟失，變更集鎖定，或網(wǎng)頁變更集中顯示的內(nèi)容與工作區(qū)不符 32) 如何永久刪除本地工作區(qū) 33) 如何找回丟失的文件 44) 打開工作區(qū)時出現(xiàn)“不能打開工作區(qū)，另一進程正在使用”錯誤 55) 不能初始化本地工作區(qū)，出現(xiàn)權(quán)限限制提示 56) 修改目錄名稱 57) 如果不想提交隱藏文件，如何操作? 58) 出現(xiàn)error：找不到存儲庫 69) 用客戶端解決沖突時選擇手工解決，需要手動復(fù)制黏貼代碼，會帶來錯誤隱患 610) 打開工作區(qū)報“Anunhandledexceptionhasoccurredinyourapplication.…” 611) 在解決合并沖突后用戶沒法checkin新的變更狀態(tài) 912) 執(zhí)行bringover過程中報錯：“gidif:reachEOFinoriginal,expectmoredata.” 9并且日志的最后幾行顯示：“Error65687:Filetypeerror.Bringovercancelled” 913) bringover對話框中，文件圖標顯示為： 10確定后出現(xiàn)提示：“Anunhandledexceptionhasoccurredinyourapplication.…” 1014) 用戶提交的文件不存在或“類型錯誤” 1115) “添加到版本控制”中不能直接檢入 1116) 如果一次提交三萬個以上文件，系統(tǒng)會產(chǎn)生錯誤 1117) 提交文件時，提示“輸入注釋” 1118) 使用firefly的windows客戶端查看文件歷史版本 1119) 使用firefly的windows客戶端進行文件版本之間的比較 1220) 刪除文件、添加同名該文件，重復(fù)多次，無法提交到服務(wù)器也無法撤銷操作 1321) 設(shè)定Fireflyclient超時門限 1322) 文件名大小寫 1323) 命名避免使用的字符：~#&();,*:"<>\?./ 1324) 關(guān)于文件過濾 1325) 打開客戶端時報初始化錯誤，報q9，配置服務(wù)器license報“保存配置錯誤” 1426) 如果不小心做了撤銷編輯操作，如何找回之前修改的文件? 142.3.2UNIX/LINUX 141) 初始化工作區(qū)失敗，報錯:”Can'tcreateworkspaceunderanexistingone” 142) 使用firefly的unix客戶端查看文件歷史版本 143) 使用firefly的unix客戶端獲取文件歷史版本 154) 使用firefly的unix客戶端進行文件版本之間的比較 155) 提交后查看歷史時，顯示亂碼，如下所示，查看該文件的注釋也是亂碼 156) 關(guān)鍵字轉(zhuǎn)換 157) 在工作區(qū)中執(zhí)行bringover報錯，報“java.lang.NullPointerException” 153FireflyServerExplorer常見問題 151) 查看某項目配置庫中已檢出的文件 152) 在啟用文件級訪問控制的情況下，更換服務(wù)器后，用戶更新文件的權(quán)限失效 163) 添加或編輯文件時出錯，Error65748：ACLDenied 164) 無法下載標記 175) 手工查找文件建立標記容易出錯 176) 使用命令下載標記 174集成Eclipse操作常見問題 171) 如果不小心刪除了文件，如何找回？ 172) 在Eclipse中安裝Firefly插件之后，"Firefly"菜單不出現(xiàn)，如何解決？ 173) 安裝Firefly插件，綁定Firefly后，文件沒有顯示文件控制圖標和版本號 174) 在Eclipse中文件沖突，解決沖突時選擇手動解決，報錯：mergetoolsnotfound。 175FireflyWeb常用功能 191) 使用firefly的web界面查看文件歷史版本 192) 使用firefly的web界面進行文件版本之間的比較 193) 查看某項目的配置庫操作歷史 204) 激活或者禁止Explorer集成 216服務(wù)器端常見問題 211) 服務(wù)器端出現(xiàn)自動掉ffd進程的情況 212) 提高服務(wù)器速度 213) 更換服務(wù)器地址后，firefly客戶端的本地工作區(qū)不能使用 214) 更換服務(wù)器后，修改“當前工作區(qū)設(shè)置”中“Firefly服務(wù)器主機”時，打不開工作區(qū) 21導(dǎo)言本文檔描述了在HanskyFirefly使用過程中，可能遇到的一些問題以及解決方法，作為使用Firefly的參考資料和指南。本文檔要時時維護，新遇到的問題隨時添加，以便起到真正的指導(dǎo)作用。其中紅色字體為：項目組成員在使用過程中經(jīng)常出現(xiàn)的問題。FireflyClien常見問題安裝常見問題安裝firelfy客戶端，需要先安裝java1.4+在windows下安裝完firefly客戶端后，打不開firefly客戶端原因：有可能是因為電腦里存在多個Framework版本（要檢查是否存在多個版本，在“控制面板”中的“添加/刪除程序”里查看）解決：方案一：把“多個版本.NetFramework配置文件”文件夾下的4個config文件復(fù)制Firefly安裝目錄下的\Client\bin目錄中即可。方案二：在“控制面板”中的“添加/刪除程序”，刪除掉以前安裝過的.NetFramework,，然后再安裝.NetFramework1.1版本。安裝完firefly客戶端后，運行程序時報：“Thetypeinitializerfor‘com.hansky.apps.firefly.gui.fe.FileExplorer’threwanexception.”；并且在配置FireflyClientSetting后保存時，報“Savelicenseconfigurationfilefailed”解決：將.net和J#的1.1版本都卸掉；安裝.net和J#的2.0版本后重啟計算機。安裝完firefly客戶端后，運行程序時報：“UnabletoloadDLL(vjsnativ)”解決：安裝vjredist.exe。英文Windows2003SP1無法打開Firefly客戶端安裝文件，無法進行客戶端安裝解決：拷貝其他機器上已經(jīng)安裝好的FireflyClient目錄到這臺機器上。注意安裝路徑要一致，否則需要手動修改%Hansky%\Firefly\Client\bin\java中的hff.bat文件中的路徑?？蛻舳诉B接服務(wù)器常見問題Firefly客戶端連接不到Firefly服務(wù)器原因：網(wǎng)絡(luò)連接；fireflyclientsetting問題LicenseServer設(shè)置本機系統(tǒng)時間，客戶機操作系統(tǒng)時間應(yīng)與Firefly服務(wù)器時間偏差不能超過24小時。LicenseIdlecount的個數(shù)，如果為0則沒有可用的License如下圖所示：解決：檢查網(wǎng)絡(luò)是否連通；檢查是否將fireflyclientsetting中的License服務(wù)器主機地址設(shè)置為firelfly服務(wù)器地址；LicenseServer：方案一：若出現(xiàn)NoServerLicense問題：登錄http://licenseserverip:8083察看是否有正確License；登錄http://fireflyserverip:8081使用admin用戶登錄，點擊"管理"->"刷新服務(wù)器license"。方案二：若出現(xiàn)NoLicenseavailable問題：檢查客戶端是否正確的設(shè)置了‘FireflyClientSetting’中的參數(shù)；登錄http://LicenseServerIP:8083,察看是否有正確的license。本機存在多個ip地址的情況下，連接firefly服務(wù)器時出現(xiàn)下列現(xiàn)象：使用Web可以登陸，但使用客戶端時彈出“找不到服務(wù)器”解決：在firefly命令行下執(zhí)行如下命令：hffsetrmc.client.usebindingtruehffsetrmc.client.bind.addressxxx.xxx.xxx.xxx(具體本機IP地址)注意：如果本機不存在多個IP，而之前綁定過的IP與當前機器IP不同，建議執(zhí)行命令：hffsetrmc.client.usebindingfalse取消綁定,而不是綁定為新的IP地址。使用常見問題WINDOWS本地工作區(qū)變更集丟失，變更集鎖定，或網(wǎng)頁變更集中顯示的內(nèi)容與工作區(qū)不符解決：出現(xiàn)以上問題，皆因為本地工作區(qū)受損，使用命令hffcheck-repair修復(fù)本地工作區(qū)。如何永久刪除本地工作區(qū)解決：方案一：FirelfyClient端操作菜單“工作區(qū)－>組織工作區(qū)—〉刪除相應(yīng)的工作區(qū)“方案二：Firefly命令行操作進入本地工作區(qū)的根目錄，執(zhí)行hffwsdelete命令如何找回丟失的文件問題：a）“非法刪除”的文件（不通過firefly刪除的文件）b）已提交的合法刪除的文件（通過firefly刪除的文件）c）未提交的合法刪除的文件（通過firelfly刪除的文件）解決：a）FireflyClient->工具->顯示丟失的文件—〉選擇文件后，點擊“獲取”按鈕b）：FireflyClient->工具->顯示已刪除文件列表—〉選擇文件后，點擊撤銷刪除，如下圖所示：c）：變更集—〉撤銷操作，如下圖所示：打開工作區(qū)時出現(xiàn)“不能打開工作區(qū)，另一進程正在使用”錯誤解決：打開本地工作區(qū)中的.firefly目錄,刪除其中的lockfile文件，如果沒有l(wèi)ockfile文件，則刪除properties.txt中的hansky.firefly.ws.lockport=*****此行，然后重新打開客戶端不能初始化本地工作區(qū)，出現(xiàn)權(quán)限限制提示解決：可能是對沒有權(quán)限的分支進行了初始化的操作，請看清要初始化的分支名稱后再進行初始化。修改目錄名稱解決：由于firefly是基于文件進行管理的，所以firefly工具不支持目錄重命名，所以要修改目錄名稱，只能建立一個新目錄，并把原目錄中的文件移動到新目錄中。另外，工具機制決定修改目錄名時，目錄下每個文件的版本號都會加一，如果文件數(shù)很多，效率較慢如果不想提交隱藏文件，如何操作?解決：a）Windows客戶端：打開客戶端，選擇：工具>選項>文件操作，當用戶添加一個目錄到Firefly配置庫中時，若選中復(fù)選框，目錄中的隱藏文件將不會被添加進去，如下所示：出現(xiàn)error：找不到存儲庫解決：關(guān)閉Firefly客戶端，清除本地工作區(qū).firefly目錄下的content和metadate目錄，然后重新打開Firefly的工作區(qū)。用客戶端解決沖突時選擇手工解決，需要手動復(fù)制黏貼代碼，會帶來錯誤隱患解決：1、可以在fireflyclient中集成其他的第三方比較、合并工具。2、自動工具提供給人的只是一種便利，真正的合并結(jié)果必須由人來決定、并把關(guān)。打開工作區(qū)報“Anunhandledexceptionhasoccurredinyourapplication.…”解決：（請按以下順序進行排查）1、確認fireflyclient的小版本號是否為：573（如下圖所示）2、確認以下兩個插件的版本號是否一致：【Microsoft.NETFramework】和【MicrosoftVisualJ#.NETRedistributablePackage】，若同時為1.1或2.0版本，則無需調(diào)整直接根據(jù)第3步進行排查；若【.NET】為2.0，而【J#】為其他版本需安裝【J#】的2.0版本（獲取路徑：7；用戶名：fly；密碼：flyfly；文件名：net2.0.zip）若【.NET】為其他版本，而【J#】為1.1需將‘多個版本.netFramework配置文件.rar’解壓后的四個文件，拷貝到%firefly安裝路徑%的bin目錄下即可；（經(jīng)過第2步的調(diào)整后，重新運行fireflyclient，若問題仍存在請進入第3步）3、首先：進入本地個人工作區(qū)目錄，將.firefly中的兩個目錄剪切：content和metadata；然后：進入firefly的命令行模式，執(zhí)行修復(fù)工作區(qū)命令（如下圖所示）最后：重新運行fireflyclient；（若問題仍存在請進入第4步）4、首先：進入本地個人工作區(qū)目錄，將.firefly中changes目錄中的內(nèi)容剪切到他處；然后：進入firefly的命令行模式，執(zhí)行修復(fù)工作區(qū)命令（如下圖所示）最后：重新運行fireflyclient。在解決合并沖突后用戶沒法checkin新的變更狀態(tài)解決：使用命令hffcheck–repair修復(fù)本地工作區(qū)。執(zhí)行bringover過程中報錯：“gidif:reachEOFinoriginal,expectmoredata.”并且日志的最后幾行顯示：“Error65687:Filetypeerror.Bringovercancelled”解決：使用命令hffcheck–repair修復(fù)本地工作區(qū)。bringover對話框中，文件圖標顯示為：確定后出現(xiàn)提示：“Anunhandledexceptionhasoccurredinyourapplication.…”解決：確認以下兩個插件的版本號是否一致：【Microsoft.NETFramework】和【MicrosoftVisualJ#.NETRedistributablePackage】，若【.NET】為2.0，而【J#】為其他版本需安裝【J#】的2.0版本（獲取路徑：7；用戶名：fly；密碼：flyfly；文件名：net2.0.zip）若【.NET】為其他版本，而【J#】為1.1需將‘多個版本.netFramework配置文件.rar’解壓后的四個文件，拷貝到%firefly安裝路徑%的bin目錄下即可；（經(jīng)過第2步的調(diào)整后，重新運行fireflyclient，若問題仍存在請進入第3步）若同時為1.1版本將兩個插件全部刪除重新安裝，并保持同時為：1.1若同時為2.0版本將兩個插件全部刪除重新安裝，并保持同時為：2.0用戶提交的文件不存在或“類型錯誤”解決：檢查是否由于Firefly使用的服務(wù)器磁盤沒有剩余空間引起?！疤砑拥桨姹究刂啤敝胁荒苤苯訖z入解決：在將新文件“添加到版本控制”時，不要選擇“保持檢出”該默認選項如果一次提交三萬個以上文件，系統(tǒng)會產(chǎn)生錯誤解決：分批添加提交，每次添加提交文件少于三萬個提交文件時，提示“輸入注釋”解決：使用firefly工具提交文件時，要在注釋中輸入此次修改文件的目的，然后再選擇提交解決：使用firefly工具提交文件時，要在注釋中輸入此次修改文件的目的，然后再選擇提交使用firefly的windows客戶端查看文件歷史版本解決：能夠列出文件所有歷史版本，并可以查看任意版本，選中文件，單擊右鍵，選擇“顯示文件歷史”，出現(xiàn)歷史選項，如下圖所示：選中時間段后，單擊“確定”，顯示出文件歷史，如下圖所示，選中想查看的版本進行查看即可。使用firefly的windows客戶端進行文件版本之間的比較解決：能夠進行文件當前版本與其他版本比較，選中文件，單擊右鍵，選擇“版本比較”，出現(xiàn)“比較版本”，如下圖所示：可以與前一版本進行比較，也可以選擇其他版本，也可以選擇其他文件，選擇好文件單擊“確定”即可。刪除文件、添加同名該文件，重復(fù)多次，無法提交到服務(wù)器也無法撤銷操作解決：首先將本地工作區(qū)中該文件的最終版本備份出來，然后把該文件手動刪掉（不通過firefly操作），然后執(zhí)行hffundo，撤銷與該文件有關(guān)的操做；然后再把該工作區(qū)的該文件手動刪掉，然后再執(zhí)行hffundo，直到與該文件有關(guān)的操作全部撤銷為止。設(shè)定Fireflyclient超時門限解決：hffsetrmc.client.connect.timeout<毫秒>例如：hffsetrmc.client.connect.timeout1000默認設(shè)置為2000在網(wǎng)絡(luò)環(huán)境不好時：希望提高上傳和下載成功率，調(diào)大門限值希望Fireflyclient反應(yīng)快，調(diào)小門限值文件名大小寫解決：跨平臺要求，建議文件名和目錄名均采用小寫命名避免使用的字符：~#&();,*:"<>\?./關(guān)于文件過濾解決：用戶可以在Fireflyclient的工具—〉選項—〉文件操作下的“不添加至版本控制的文件類型”內(nèi)容復(fù)選框中，設(shè)置不被添加到Firefly資源控制中的文件類型，如.bak，并選中“缺省使用文件過濾器”，如下圖所示：打開客戶端時報初始化錯誤，報q9，配置服務(wù)器license報“保存配置錯誤”解決：由于firefly和系統(tǒng)時間及時區(qū)有關(guān)，通常我們的電腦都用北京時區(qū)，而北京時區(qū)沒有firefly需要調(diào)用的類，所以可先將本機調(diào)整成其他時區(qū)，然后再調(diào)整回來即可。如果不小心做了撤銷編輯操作，如何找回之前修改的文件?解決：執(zhí)行撤銷編輯文件操作后，操作執(zhí)行前已發(fā)生變更的文件被存放在%本地工作區(qū)目錄%\.firefly\unedit\文件所在的目錄名稱\下，用戶可以恢復(fù)在文件中已做的變更，但只有最新變更的文件可被保存。UNIX/LINUX初始化工作區(qū)失敗，報錯:”Can'tcreateworkspaceunderanexistingone”解決：首先在網(wǎng)頁http://fireflyserver:8081上察看基于該目錄的中繼工作區(qū)是否已經(jīng)刪除；然后用ll–all命令查看本地目錄中是否含有.firefly文件夾，如果有將其刪除，重新進行初始化即可。使用firefly的unix客戶端查看文件歷史版本 解決：使用命令hffhist<文件名>，可以顯示指定工作區(qū)文件的歷史版本包括文件的版本號，修改時間，修改人，修改注釋等使用firefly的unix客戶端獲取文件歷史版本解決：使用命令hffget-v<要獲取的版本><文件名>，可以獲取指定工作區(qū)文件的歷史版本使用firefly的unix客戶端進行文件版本之間的比較解決：使用命令hffdiffs-v1<指定該文件的源版本>-v2<指定該文件的目標版本><文件名>，該操作比較本地工作區(qū)文件任意兩個版本的不同提交后查看歷史時，顯示亂碼，如下所示，查看該文件的注釋也是亂碼解決：AIX字符編碼的問題。編輯%Hansky%/Firefly/Client/bin/hff文件，在${JDK12HOME}/bin/java-Xms64m-Xmx256m后加參數(shù)-Dfile.encoding=GBK。關(guān)鍵字轉(zhuǎn)換解決：Firefly提供了使用關(guān)鍵字轉(zhuǎn)換功能，若選中該復(fù)選框，當用戶編輯文件并保存的本地變更之后，文件中的關(guān)鍵字將被轉(zhuǎn)換成實際的數(shù)值，如%G%將轉(zhuǎn)換為具體的時間。在工作區(qū)中執(zhí)行bringover報錯，報“java.lang.NullPointerException”解決：查看本地工作區(qū).firefly目錄下是否有resumelist.fdb文件，如果有該文件，刪除該文件即可。報該錯主要原因是部分文件被鎖定了，無法繼續(xù)執(zhí)行操作。FireflyServerExplorer常見問題查看某項目配置庫中已檢出的文件解決：運行FireflyServerExplorer，選中項目的配置庫，如下圖所示：選擇：工具<分支檢出列表，如下圖所示，可以列出配置庫中已檢出的文件，包括：文件名、檢出用戶及鎖定者，配置管理員可以根據(jù)文件列表通知相關(guān)用戶進行文件檢入在啟用文件級訪問控制的情況下，更換服務(wù)器后，用戶更新文件的權(quán)限失效解決：重新初始化工作區(qū)。添加或編輯文件時出錯，Error65748：ACLDenied解決：檢查是否已經(jīng)給該用戶的分配相應(yīng)的文件權(quán)限。無法下載標記解決：查看是否有相應(yīng)標記的下載權(quán)限；如果沒有，請標記的建立人員把標記bringover的權(quán)限分配給相應(yīng)人員手工查找文件建立標記容易出錯解決：對需要建立標記的文件生成文件列表，利用firefly命令行建立標記hffbrlabel-h<配置管理服務(wù)器地址>-proj<配置庫項目名稱>-b<配置庫名稱>-lf<文件列表><標記名稱>使用命令下載標記解決：hffdownload-h<配置管理服務(wù)器地址>-proj<配置庫項目名稱>-l<標記名稱>-d<下載的目標路徑>注：下載的目標路徑必須為空目錄集成Eclipse操作常見問題如果不小心刪除了文件，如何找回？解決：在Eclipse中選擇刪除操作，會觸發(fā)firefly將該文件從配置庫中刪除，所以要慎用。如果刪除，可通過web瀏覽器下載已刪除的文件，再重新上傳到配置庫中（firefly會將刪除文件按照目錄結(jié)構(gòu)移動到DELETE目錄下）。在Eclipse中安裝Firefly插件之后，"Firefly"菜單不出現(xiàn)，如何解決？解決：方案一：打開Eclipse，點擊菜單欄“Window”->“CustomizePerspective”->“Commands”，勾選“SourceCodeControl”。方案二：\eclipse\configuration\org.eclipse.update\目錄中的platform.xml，剪切出去，備份，重新打開Eclipse。安裝Firefly插件，綁定Firefly后，文件沒有顯示文件控制圖標和版本號解決：打開Eclipse，點擊菜單欄“Window”->“Preferences”，選擇“General->Appearance->LabelDecorations”，勾選“HSCCDecorator”。在Eclipse中文件沖突，解決沖突時選擇手動解決，報錯：mergetoolsnotfound。解決：打開C:\DocumentsandSettings\Administrator\Hansky\Firefly\Client\gui.dat文件（其中Administrator是當前系統(tǒng)的登錄用戶）參考附件中的gui.dat加入vdm.path，如：vdm.path=D:\\ProgramFiles\\Hansky\\Firefly\\Client\\bin\\VDM.exe路徑為FireflyClient的安裝路徑，注意用兩個"\"。修改完成后重新打開Eclipse，測試。附件gui.dat：#FireflyCommonProperties#ThuMay0717:09:17CST2009gui.showprogress