个人整理Firefly史上最全的常见问题解决方案

1、配置管理工具常见问题FAQ版本V1.0文档编号保密等级作者最后修改日期审核人最后审批日期批准人最后批准日期修改记录日期版本作者/修改者描述审核人2008-04-10V1.0创建文档2008-06-23V1.0修订文档：增加2.7、2.8、2.9等章节2009-01-09V1.0修订文档：增加常见问题标记；增加第三章配置管理服务器的常见问题1导言12配置管理工具的常见问题12.1 客户端安装12.2 firefly客户端与firefly服务器连接22.3 本地工作区常见问题22.4 提交文件52.5 firefly服务器IP地址发生变更52.6 启用文件级权限控制62.7 建立标记及设置标记权限

2、62.8 文件历史版本及版本之间的比较62.9 配置库操作历史92.10 集成Eclipse操彳112.11 其它113配置管理服务器的常见问题134Firefly在连接服务器时候的问题141导言本文档描述了在HanskyFirefly使用过程中，可能遇到的一些问题以及解决方法，作为使用Firefly的参考资料和指南。本文档要时时维护，新遇到的问题随时添加，以便起到真正的指导作用。其中红色字体为：项目组成员在使用过程中经常出现的问题。2配置管理工具的常见问题2.1客户端安装1）在unix下安装firelfy客户端，需要先安装java1.4+2）在windows下安装完firefly客户端后，打

3、不开firefly客户端原因：有可能是因为电脑里存在多个Framework版本（要检查是否存在多个版本，在“控制面板”中的“添加/删除程序”里查看）解决：方案一:把“多个版本.NetFramework配置文件”文件夹下的4个config文件复制Firefly安装目录下的Clientbin目录中即可。补充：在给的安装包里面有一i个叫：多个版本.NetFramework配置文件的文件夹，里面有安装程序的四个配置文件client_setting.exefirefly_admin.exefirefly_client.exeserver_explorer.exe以上是四个文件的名称！把这个四个文件拷贝到

4、firefly安装目录下的clientbin文件夹下方案二：在“控制面板”中的“添加/删除程序”，删除掉以前安装过的.NetFramework,然后再安装.NetFramework1.1版本2.2firefly客户端与firefly服务器连接1)Firefly客户端连接不到Firefly服务器原因：a)网络连接；b) fireflyclientsetting问题c) LicenseServer设置d) 本机系统时间，客户机操作系统时间应与Firefly服务器时间偏差不能超过24小时。e)LicenseIdlecount的个数，如果为0则没有可用的License如下图所示：解决：a)检查网络是否

5、连通；b)检查是否将fireflyclientsetting中的License服务器主机地址设置为巾relfly服务器地址；c)LicenseServer：方案一：若出现NoServerLicense问题：登录http:/licenseserverip:8083察看是否有正确License;登录http:/fireflyserverip:8081使用admin用户登录，点击管理-刷新服务器license。方案二：若出现NoLicenseavailable问题：检查客户端是否正确的设置了FireflyClientSetting中的参数；登录http:/LicenseServerIP:8083,察

6、看是否有正确的license。2.3本地工作区常见问题1)Firefly本地工作区变更集丢失，或变更集锁定，或网页变更集中显示的内容与工作区不符解决：出现以上问题，皆因为本地工作区受损，使用命令hffcheck-repair修复本地工作区。2）如何永久删除本地工作区解决：方案一：FirelfyClient端操作菜单“工作区组织工作区一删除相应的工作区方案二：Firefly命令行操作进入本地工作区的根目录，执行hffwsdelete命令3）如何找回丢失的文件问题：a）“非法删除”的文件（不通过firefly删除的文件）b）已提交的合法删除的文件（通过firefly删除的文件）c）未提交的合法删除

7、的文件（通过firelfly删除的文件）解决：a）:FireflyClient-工具-显示丢失的文件一选择文件后，点击获取按钮，如下图所示:b）:FireflyClient-工具-显示已删除文件列表一选择文件后，点击撤销删除，如下图所示:c）：变更集一撤销操作，如下图所示:LIHF.。|l111A|trcex_cmdtc.trdEdrt_ft8yu.fi10君加src/Edrt_nX场孝ttic秀拿WeciMtgwin11更都：trc/ranliguf而常/作h4）打开工作区时出现“不能打开工作区，另一进程正在使用错误解决：打开本地工作区中的.firefly目录，删除其中的lockfile文件

8、，如果没有lockfile文件,则删除properties.txt中的hansky.firefly.ws.lockport=*此行，然后重新打开客户端5）不能初始化本地工作区，出现权限限制提示解决：可能是对没有权限的分支进行了初始化的操作，请看清要初始化的分支名称后再进行初始化。6）修改目录名称解决：由于firefly是基于文件进行管理的，所以firefly工具不支持目录重命名，所以要修改目录名称，只能建立一个新目录，并把原目录中的文件移动到新目录中。7）使用fireflyunix版本初始化工作区失败，报错：Cantcreatealocalworkspaceunderanexistingone

9、解决：首先在网页http:/fireflyserver:8081上察看基于该目录的中继工作区是否已经删除；然后用ll-all命令查看本地目录中是否含有.firefly文件夹，如果有将其删除，重新进行初始化即可。2.4提交文件1）在解决合并冲突后用户没法checkin新的变更状态解决：使用命令hffcheck-repair修复本地工作区。2）用户提交的文件不存在或“类型错误”解决：检查是否由于Firefly使用的服务器磁盘没有剩余空间引起。3）“添加到版本控制”中不能直接检入解决：在将新文件“添加到版本控制”时，不要选择“保持检出”该默认选项4）如果一次提交三万个以上文件，系统会产生错误解决：分

10、批添加提交，每次添加提交文件少于三万个5）提交文件时，提示“输入注释”解决：使用firefly工具提交文件时，要在注释中输入此次修改文件的目的，然后再选择提交2.5 firefly服务器IP地址发生变更1）更换服务器地址后，firefly客户端的本地工作区不能使用解决：打开本地工作区，显示未连接，此时打开：工具-选项，选择“当前工作区设置”选项卡,将服务器主机设置为新的服务器地址，并确定；然后关闭工作区，退出，再重新打开firefly客户端。2）在更换服务器后，修改“当前工作区设置”中“Firefly服务器主机”时，打不开工作区解决：打开本地工作区的.firefly文件夹，修改properti

11、es.txt中这一行：hansky.firefly.server.host=*,把以前的服务器地址修改为新的服务器地址。3）本机存在多个ip地址的情况下，连接firefly服务器时出现下列现象：使用Web可以登陆,但使用客户端时弹出“找不到服务器”解决：在firefly命令行下执行如下命令：具体本机ip地址）hffsetrmc.client.usebindingtruehffsetrmc.client.bind.addressxxx.xxx.xxx.xxx(注意：如果本机不存在多个IP,而之前绑定过的IP与当前机器IP不同，建议执行命令：hffsetrmc.client.usebindingf

12、alse取消绑定，而不是绑定为新的IP地址。2.6 启用文件级权限控制1）在启用文件级访问控制的情况下，更换服务器后，用户更新文件的权限失效解决：重新初始化工作区。2）添加或编辑文彳时出错，Error65748:ACLDenied解决：检查是否已经给该用户的分配相应的文件权限。2.7 建立标记及设置标记权限1）无法下载标记解决：查看是否有相应标记的下载权限；如果没有，请标记的建立人员把标记bringover的权利分配给相应人员2）手工查找文件建立标记容易出错解决：对需要建立标记的文件生成文件列表，利用firefly命令行建立标记hffbrlabel-h-proj-b配置库名称-lf3）使用命令

13、下载标记解决：hffdownload-h-proj-l标记名称-d注：下载的目标路径必须为空目录2.8 文件历史版本及版本之间的比较1）使用firefly的windows客户端查看文件历史版本解决：能够列出文件所有历史版本，并可以查看任意版本，选中文件，单击右键，选择“显示文件历史”，出现历史选项，如下图所示：选中时间段后，单击“确定”，显示出文件历史，如下图所示，选中想查看的版本进行查看即可。2）使用firefly的windows客户端进行文件版本之间的比较出现解决：能够进行文件当前版本与其他版本比较，选中文件，单击右键，选择“版本比较”“比较版本”，如下图所示：可以与前一版本进行比较，也可

14、以选择其他版本，也可以选择其他文件，选择好文件单击“确定”即可。3）使用firefly的unix客户端查看文件历史版本解决：使用命令hffhist文件名,可以显示指定工作区文件的历史版本包括文件的版本号,修改时间,修改人,修改注释等4）使用firefly的unix客户端获取文件历史版本解决：使用命令5）使用firefly的unix客户端进行文件版本之间的比较hffget-v要获取白版本文件名，可以获取指定工作区文件的历史版本解决：使用命令hffdiffs-v1指定该文件的源版本-v2指定该文件的目标版本文件名,该操作比较本地工作区文件任意两个版本的不同6）使用firefly的web界面查看文件

15、历史版本解决：从web界面登陆配置管理系统，找到要进行查看的文件并选中文件，出现如下界面，选择“历史”既可以查看相应的历史版本，选择“原始数据”即可以获取当前版本的文件莒出Ehl口t%sf-ui卜窜口辱UNb-验vimh围1tMiIMdh41Ev图rw口Mi酒EttfE-Ofrufw9样片工QvIe，UwvttiRHVs-i/evoliKRAIVt宜*式川甲与事1iESI川单UM-获取当前版本文件直收Kit渣/1WN1MW才1E寸IK7二-Il寺有物史ajirnr短下对51fithAEirm也IHLTnltJqinm可3-087）使用firefly的web界面进行文件版本之间的比较,即可查看相

16、应版解决：选中要进行版本比较的文件，点击历史，出现如下界面，选择“版本”本的内容，选择“比较版本”，可以进行任意版本的比较。索FireflyMlryntgrHB3JXDELETE*Nd3&no心*reloadrntux*，卜gng1g.cJwgnrs事rw口.123271国力142f闻n1#j3Qn：?ncha-ir,.upLL1SK1292252313瓯mfAliiyiTHKViJ4MJV,SuMHHIM。lecawi比merased口到”，it)B*n&Miiraneh画!EImjlOJkiqfiv明5第，.工由师林文片历史M-t/pvai.iiIfrcl)Sw-亡，43工MM两皿8小口1

17、K5E看也门129】曾加15血查看目前版本内容2.9 配置库操作历史1）查看某项目的配置库操作历史解决：登陆web界面，选中要进行查看的项目，选中配置库，如下图所示:ffW-Ehtfuh已*TriEiiifttyadmknr口前必丫，圮HpIIqt=sGVimllUaiinSranch*多DevLGCjVim(9口pu2.UH-uqfiK但才。号JL的雄工作区.0_*制至it4J3牌杀力相？，点击历史:.;阑户口用鬣品gX用史玲交，；,乾重秋壬不慢定口1”包括：操作、用户、选择“历史”，界面如下所示，可以查看用户在配置库中所作的操作,SMTHfiURA1”13足口。%。；*力ggv内同网*AH

18、A0VxJi/MfiOOdsi11bytom分型，JI10rshipMMtttWfcr2.0,MB4tbuadP4ntiatadtoWindow。丸变更、工作区和变更时间Firefly操作IQfflyt咐default-project%HbRoWorldI-通vimMamfrrariClh工作区变更时间SniShgwwarnngmesgagewhenvimopensittiirtf-5encndmj102:火:仲cje白丽rn/中%vim2。I2口0*,U&：11如哺li；?.2.；:;j，U11fL9/12OQ4,0104-organtZEiH5tdllf?rrelatedmesources

19、,SupportWindows，日Birtwhoisusing比w?Q*占E2判7选择1UL3/2004.0043rnz.otJuofivbranchb?danR&lejse_2.o占n白whotTomwiJbeincnargo变更集rtdireleas？xtom0Der_i.0KBugfikBuofiwfor2.0.MottbugsartrelatedtoWindcw59&11.13/200+,00412）查看某项目配置库中已检出的文件解决：运行FireflyServerExplorer,选中项目的配置库，如下图所示:FireflySeirverExplairer-ECAS项目视图09操作（

20、8发展状森（A工具报表R都助后骑画.艇筑舞.岛i】贝才战科一气田曰Astip耽画画画develop次比较分支/标记乐台并目标分支（D.03合并合分支同步分支I导入（X）-Jj下载标识3.分支检出列表骼文件版本树也电文件级极限控制（短晶设置，_!x甘度喷嚏围殴.明目录继工作区,115标记uedong36:4202:26链接节点。选择：工具分支检出列表，如下图所示，可以列出配置库中已检出的文件，包括：文件名、检出用户及锁定者，配置管理员可以根据文件列表通知相关用户进行文件检入分支检出列表口文件名检出用尸领JE者111rcJcomp/busi/dk/bdkgstdpclinxinI|src/comp

21、/busi/ggJbggcmtproc.scrigzhijfDngr-lsrcfcomD/busi/is/bsl2dfilbxfrilcDcsongzlniong|src/comp/Lusi/kgAkgis?uePlS.手yrid口ngdomgJtrc/comp/usrdb/mt9S88.pcpnchunshuilinxinsonQhiyongsonq2hiyang;undngdongpanchunshui|src/pichuli/bb/t9965.pcl-lsrJpichuliJDlift96Z5dcxj-aohongMiIlinxinxiaohongcailinxin|sreftab1e/

22、btsnx.txt!$rcrtable/btanK_idK.txtrongguangpiingrongguangpingrongguangpingrongguangping|srcftable/btxmitM卜rcftabla/bbmx_idx.bdrongguangpingrongguangpingrongguangpingrongguangping|develop按用户名搜索:刷新全选清嗓释放美闭帮助加2.10 集成Eclipse操作1)如果不小心删除了文件，如何找回？所以要慎用。如(firefly会将删除解决：在Eclipse中选择删除操作，会触发巾refly将该文件从配置库中删除,果删

23、除，可通过web浏览器下载已删除的文件，再重新上传到配置库中文件按照目录结构移动到DELETE目录下)。2.11 其它1)提高服务器速度存储库目录解决：为了提高Firefly服务器性能，建议设置防病毒程序忽略扫描Firefly2)设定Fireflyclient超时门限解决：a) hffsetrmc.client.connect.timeoutb) 例如：hffsetrmc.client.connect.timeout1000c) 默认设置为2000d) 在网络环境不好时：i. 希望提高上传和下载成功率，调大门限值ii. 希望Fireflyclient反应快，调小门限值3)激活或者禁止Explo

24、rer集成解决:激活：%Firefly%clientbinshell禁止：%Firefly%clientbinshell-u4）文件名大小写解决：跨平台要求，建议文件名和目录名均采用小写5）命名避免使用的字符：#&（）；,*:?./6）关于文件过滤解决：用户可以在Fireflyclient的工具一选项一文件操作下的“不添加至版本控制的文件类型”内容复选框中，设置不被添加到Firefly资源控制中的文件类型，如.bak,并选中“缺省使用文件过滤器”，如下图所示：7）关键字转换解决：Firefly提供了使用关键字转换功能，若选中该复选框，当用户编辑文件并保存的本地变更之后，文件中的关键字将被转换成

25、实际的数值，如%G%F转换为具体的时间。8）打开客户端时报初始化错误，报错q9,配置服务器license的时候报“保存配置错误”解决：由于firefly和系统时间及时区有关，通常我们的电脑都用北京时区，而北京时区没有firefly需要调用的类，所以可先将本机调整成其他时区，然后再调整回来即可。9）如何查看其它用户在这个分支上所做的未提交的变更集的内容？用户可以查看其他用户在这个分支上所作的尚未提交到服务器上的变更。方案一：在FireflyWeb界面上：a）打开浏览器，在地址栏输入http:/FireflyServerIP:8081,然后输入正确的用户名和密码登录FireflyWeb。b）在FireflyWeb架构树上的指定项目下，选择一个分支，信息面板上将会显示该分支的属性信息。c）在信息面板的分支属性表单中，选择中继工作区，则信息面板中将显示分支下的所有中继工作区。d）在信息面板的列表中，选择想要查询的用户的中继工作区，则页面上会显示该中继工作区的具体内容。e）在中继工作区属性右侧，有一个操作面板，选择变更集按钮，可以查看这个用户对工作区文件的变更，这些变更都是没有提交到Firefly服务器上的变