配置管理工具常见问题FAQ版本V1.0修改记录目录1 导言 (1)2 配置管理工具的常见问题 (1)2.1 客户端安装 (1)2.2 firefly 客户端与firefly 服务器连接. (2)2.3 本地工作区常见问题 (2)2.4 提交文件 (5)2.5 firefly 服务器IP 地址发生变更. (5)2.6 启用文件级权限控制 (6)2.7 建立标记及设置标记权限 (6)2.8 文件历史版本及版本之间的比较 (6)2.9 配置库操作历史 (9)2.10 集成Eclipse 操作 (11)2.11 其它 (11)3 配置管理服务器的常见问题 (13)4 Firefly 在连接服务器时候的问题 (14)1 导言本文档描述了在Hansky Firefly 使用过程中，可能遇到的一些问题以及解决方法，作为使用Firefly 的参考资料和指南。

本文档要时时维护，新遇到的问题随时添加，以便起到真正的指导作用。

其中红色字体为：项目组成员在使用过程中经常出现的问题。

2 配置管理工具的常见问题2.1 客户端安装1）在unix 下安装firelfy 客户端，需要先安装java1.4+2）在windows 下安装完firefly 客户端后，打不开firefly 客户端原因：有可能是因为电脑里存在多个Framework 版本（要检查是否存在多个版本，在“控制面板” 中的“添加/ 删除程序”里查看）解决：方案一：把“ 多个版本.Net Framework 配置文件” 文件夹下的 4 个config 文件复制Firefly 安装目录下的\Client\bin 目录中即可。

补充：在给的安装包里面有一个叫：多个版本.Net Framework 配置文件的文件夹，里面有安装程序的四个配置文件client_setting.exefirefly_admin.exefirefly_client.exeserver_explorer.exe 以上是四个文件的名称！把这个四个文件拷贝到firefly 安装目录下的\client\bin 文件夹下方案二：在“控制面板”中的“添加/ 删除程序”，删除掉以前安装过的.Net Framework, ，然后再安装.Net Framework 1.1 版本2.2 firefly 客户端与firefly 服务器连接1) Firefly 客户端连接不到Firefly 服务器原因：a) 网络连接；b) firefly clie nt sett ing I、可题c) Lice nse Server 设置d) 本机系统时间，客户机操作系统时间应与Firefly 服务器时间偏差不能超过24小时。

e) License Idle count 的个数，如果为0则没有可用的License如下图所示：解决：a) 检查网络是否连通；b) 检查是否将firefly client setting 中的License服务器主机地址设置为firelfly 服务器地址；c) Lice nse Server :方案一：若出现No Server Lice nse 问题：登录http://lice nseserverip:8083 察看是否有正确License ;登录http://fireflyserverip:8081 使用admin 用户登录，点击”管理"->"刷新服务器license"。

方案二：若出现No License available 问题：检查客户端是否正确的设置了‘ Firefly Client Setting ' 中的参数；登录http://LicenseServerlP:8083, 察看是否有正确的license 。

2.3本地工作区常见问题1) Firefly 本地工作区变更集丢失，或变更集锁定，或网页变更集中显示的内容与工作区不符解决：出现以上问题，皆因为本地工作区受损，使用命令hff check -repair 修复本地工作区。

2）如何永久删除本地工作区解决:Firelfy Clie nt 端操作方案一：菜单“工作区一＞组织工作区一〉删除相应的工作区方案二：Firefly 命令行操作进入本地工作区的根目录，执行hff ws delete 命令3）如何找回丢失的文件问题：a）“非法删除”的文件（不通过firefly 删除的文件）b）已提交的合法删除的文件（通过firefly 删除的文件）c）未提交的合法删除的文件（通过firelfly 删除的文件）解决：a）:Firefly Client-＞工具-＞显示丢失的文件一〉选择文件后，点击“获取”按钮，如下图所示:b）:Firefly Client-＞工具-＞显示已删除文件列表一〉选择文件后，点击撤销删除，如下图所示:c ）:变更集一〉撤销操作，如下图所示:4）打开工作区时出现“不能打开工作区，另一进程正在使用”错误解决：打开本地工作区中的.firefly 目录，删除其中的lockfile 文件，如果没有lockfile 文件, 则删除 properties.txt 中的 hansky.firefly.ws.lockport=*****此行，然后重新打开客户端5） 不能初始化本地工作区，出现权限限制提示解决：可能是对没有权限的分支进行了初始化的操作，请看清要初始化的分支名称后再进行初始化。

6） 修改目录名称 解决：由于firefly是基于文件进行管理的，所以firefly工具不支持目录重命名，所以要修改目录名称，只能建立一个新目录，并把原目录中的文件移动到新目录中。

7） 使用 firefly unix 版本初始化工作区失败，报错： “Can't create a local workspace underan・ 丄・”existi ng one解决：首先在网页 http:// fireflyserver:8081上察看基于该目录的中继工作区是否已经删除；然后用ll - all 命令查看本地目录中是否含有.firefly文件夹，如果有将其删除，重新 进行初始化即可。

- Carnot open ^avrd [MOfed仪rrcfd^.QX * 督 r… i [/'•X.DTKI E .CtrdEdrt_ft8yu.c ■rr 凸6时晶9科re. inDELETEDJiTC/fdif 1 I d痕罚：irriEd rt_ne1 .1見第-士rcJfflnligj 勉：处胃少[匸A|trcJe*_cnidi c]2.4 提交文件1）在解决合并冲突后用户没法checkin 新的变更状态解决：使用命令hff check - repair 修复本地工作区。

2）用户提交的文件不存在或“类型错误”解决：检查是否由于Firefly 使用的服务器磁盘没有剩余空间引起。

3）“添加到版本控制”中不能直接检入解决：在将新文件“添加到版本控制”时，不要选择“保持检出”该默认选项4）如果一次提交三万个以上文件，系统会产生错误解决：分批添加提交，每次添加提交文件少于三万个5）提交文件时，提示“输入注释”解决：使用firefly 工具提交文件时，要在注释中输入此次修改文件的目的，然后再选择提交2.5 firefly 服务器IP 地址发生变更1）更换服务器地址后，firefly 客户端的本地工作区不能使用解决：打开本地工作区，显示未连接，此时打开：工具－＞选项，选择“当前工作区设置” 选项卡，将服务器主机设置为新的服务器地址，并确定；然后关闭工作区，退出，再重新打开firefly 客户端。

2）在更换服务器后，修改“当前工作区设置”中“ Firefly 服务器主机”时，打不开工作区解决：打开本地工作区的.firefly 文件夹，修改properties.txt 中这一行：hansky.firefly.server.host=******** ，把以前的服务器地址修改为新的服务器地址。

3）本机存在多个ip地址的情况下，连接firefly 服务器时出现下列现象：使用Web可以登陆，但使用客户端时弹出“找不到服务器”解决：在firefly 命令行下执行如下命令：hff set ebinding truehff set rmc.client.bind.address xxx.xxx.xxx.xxx（具体本机IP 地址）注意：如果本机不存在多个IP ，而之前绑定过的IP 与当前机器IP 不同，建议执行命令：hff set ebinding false 取消绑定, 而不是绑定为新的IP 地址。

2.6 启用文件级权限控制1)在启用文件级访问控制的情况下，更换服务器后，用户更新文件的权限失效解决：重新初始化工作区。

2) 添加或编辑文件时出错，Error 65748 ：ACL Denied 解决：检查是否已经给该用户的分配相应的文件权限。

2.7 建立标记及设置标记权限1) 无法下载标记解决：查看是否有相应标记的下载权限；如果没有，请标记的建立人员把标记bringover的权利分配给相应人员2) 手工查找文件建立标记容易出错解决：对需要建立标记的文件生成文件列表，利用firefly 命令行建立标记hff br label -h < 配置管理服务器地址> -proj < 配置库项目名称>-b < 配置库名称> -lf <文件列表> < 标记名称>3) 使用命令下载标记解决：hff download -h < 配置管理服务器地址> -proj < 配置库项目名称> -l < 标记名称> -d < 下载的目标路径> 注：下载的目标路径必须为空目录2.8 文件历史版本及版本之间的比较1) 使用firefly 的windows 客户端查看文件历史版本解决：能够列出文件所有历史版本，并可以查看任意版本，选中文件，单击右键，选择“显示文件历史”，出现历史选项，如下图所示：处I|障工⑴r AfitD f 3 月c地6® P £日百从ID叵価歼£月盅-至tt)- [F：n]拜3月汨+r刃阿i站履应u只壬亍-.Sffl.口习左)1石金e r筛立順鑫iu选中时间段后，单击“确定”，显示出文件历史，如下图所示，选中想查看的版本进行查看即可。

2) 使用firefly 的windows客户端进行文件版本之间的比较解决：能够进行文件当前版本与其他版本比较，选中文件，单击右键，选择“版本比较”，出现“比较版本”，如下图所示：可以与前一版本进行比较，也可以选择其他版本，也可以选择其他文件，选择好文件单击“确定”即可。