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

1、文档标题配置管理工具常见问题faq版本 v1.0文 档 编 号保 密 等 级作 者最后修改日期审 核 人最后审批日期批 准 人最后批准日期第13页配置管理工具常见问题faq修改记录日期版本作者/修改者描述审核人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 提交文件42.5 firefly

2、服务器ip地址发生变更52.6 启用文件级权限控制52.7 建立标记及设置标记权限62.8 文件历史版本及版本之间的比较62.9 配置库操作历史82.10 集成eclipse操作102.11 其它113 配置管理服务器的常见问题134 firefly在连接服务器时候的问题131 导言本文档描述了在hansky firefly使用过程中，可能遇到的一些问题以及解决方法，作为使用firefly的参考资料和指南。本文档要时时维护，新遇到的问题随时添加，以便起到真正的指导作用。其中红色字体为：项目组成员在使用过程中经常出现的问题。2 配置管理工具的常见问题2.1 客户端安装1）在unix下安装fire

3、lfy 客户端，需要先安装java1.4+2）在windows下安装完firefly客户端后，打不开firefly客户端原因：有可能是因为电脑里存在多个framework 版本（要检查是否存在多个版本，在“控制面板”中的“添加/删除程序”里查看）解决：方案一：把 “多个版本.net framework配置文件” 文件夹下的4 个config文件复制firefly安装目录下的clientbin目录中即可。补充：在给的安装包里面有一个叫：多个版本.net framework配置文件 的文件夹，里面有安装程序的四个配置文件client_setting.exefirefly_admin.exefire

4、fly_client.exeserver_explorer.exe 以上是四个文件的名称！把这个四个文件拷贝到firefly安装目录下的clientbin文件夹下方案二：在“控制面板”中的“添加/删除程序”，删除掉以前安装过的 .net framework,，然后再安装.net framework 1.1版本2.2 firefly 客户端与firefly 服务器连接1）firefly 客户端连接不到firefly 服务器原因：a) 网络连接；b) firefly client setting问题c) license server 设置d) 本机系统时间，客户机操作系统时间应与firefly服务

5、器时间偏差不能超过24小时。e) license idle count的个数，如果为0则没有可用的license如下图所示：解决：a) 检查网络是否连通；b) 检查是否将firefly client setting 中的license服务器主机地址设置为firelfly 服务器地址；c) license server：方案一：若出现no server license问题：登录http:/licenseserverip:8083 察看是否有正确license；登录http:/fireflyserverip:8081 使用admin用户登录，点击管理-刷新服务器license。方案二：若出现no

6、license available问题：检查客户端是否正确的设置了 firefly client setting 中的参数；登录 http:/licenseserverip:8083, 察看是否有正确的license。2.3 本地工作区常见问题1）firefly本地工作区变更集丢失，或变更集锁定，或网页变更集中显示的内容与工作区不符解决：出现以上问题，皆因为本地工作区受损，使用命令hff check -repair修复本地工作区。2）如何永久删除本地工作区解决：方案一：firelfy client端操作菜单“工作区 组织工作区删除相应的工作区“方案二：firefly命令行操作进入本地工作区的根

7、目录，执行hff ws delete命令3）如何找回丢失的文件问题：a）“非法删除”的文件（不通过firefly删除的文件）b）已提交的合法删除的文件（通过firefly删除的文件）c）未提交的合法删除的文件（通过firelfly删除的文件）解决：a）：firefly client-工具-显示丢失的文件 选择文件后，点击“获取”按钮，如下图所示：b）：firefly client-工具-显示已删除文件列表选择文件后，点击撤销删除，如下图所示： c）：变更集撤销操作，如下图所示：4）打开工作区时出现“不能打开工作区，另一进程正在使用”错误解决：打开本地工作区中的.firefly目录,删除其中的l

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

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

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

11、工作区的.firefly文件夹，修改properties.txt中这一行：hansky.firefly.server.host=*，把以前的服务器地址修改为新的服务器地址。3) 本机存在多个ip地址的情况下，连接firefly服务器时出现下列现象：使用web可 以登陆，但使用客户端时弹出“找不到服务器”解决：在firefly命令行下执行如下命令： hff set rmc.client.usebinding true hff set rmc.client.bind.address xxx.xxx.xxx.xxx(具体本机ip地址)注意：如果本机不存在多个ip，而之前绑定过的ip与当前机器ip不同

12、，建议执行命令：hff set rmc.client.usebinding false取消绑定,而不是绑定为新的ip地址。2.6 启用文件级权限控制1）在启用文件级访问控制的情况下，更换服务器后，用户更新文件的权限失效解决：重新初始化工作区。2） 添加或编辑文件时出错，error 65748：acl denied解决：检查是否已经给该用户的分配相应的文件权限。2.7 建立标记及设置标记权限1） 无法下载标记解决：查看是否有相应标记的下载权限；如果没有，请标记的建立人员把标记bringover的权利分配给相应人员2） 手工查找文件建立标记容易出错解决：对需要建立标记的文件生成文件列表，利用fir

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

14、本比较，选中文件，单击右键，选择“版本比较”，出现“比较版本”，如下图所示：可以与前一版本进行比较，也可以选择其他版本，也可以选择其他文件，选择好文件单击“确定”即可。3） 使用firefly的unix客户端查看文件历史版本解决：使用命令hff hist ，可以显示指定工作区文件的历史版本包括文件的版本号，修改时间，修改人，修改注释等4） 使用firefly的unix客户端获取文件历史版本解决：使用命令hff get -v ，可以获取指定工作区文件的历史版本5） 使用firefly的unix客户端进行文件版本之间的比较解决：使用命令hff diffs -v1 -v2 ，该操作比较本地工作区文件

15、任意两个版本的不同6） 使用firefly的web界面查看文件历史版本解决：从web界面登陆配置管理系统，找到要进行查看的文件并选中文件，出现如下界面，选择“历史”既可以查看相应的历史版本，选择“原始数据”即可以获取当前版本的文件7） 使用firefly的web界面进行文件版本之间的比较解决：选中要进行版本比较的文件，点击历史，出现如下界面，选择“版本”，即可查看相应版本的内容，选择“比较版本”，可以进行任意版本的比较。2.9 配置库操作历史1） 查看某项目的配置库操作历史解决：登陆web界面，选中要进行查看的项目，选中配置库，如下图所示：选择“历史”，界面如下所示，可以查看用户在配置库中所作

16、的操作，包括：操作、用户、变更、工作区和变更时间2） 查看某项目配置库中已检出的文件解决：运行firefly server explorer，选中项目的配置库，如下图所示： 选择：工具分支检出列表，如下图所示，可以列出配置库中已检出的文件，包括：文件名、检出用户及锁定者，配置管理员可以根据文件列表通知相关用户进行文件检入2.10 集成eclipse操作1） 如果不小心删除了文件，如何找回？解决：在eclipse中选择删除操作，会触发firefly将该文件从配置库中删除，所以要慎用。如果删除，可通过web浏览器下载已删除的文件，再重新上传到配置库中（firefly会将删除文件按照目录结构移动到d

17、elete目录下）。2.11 其它1） 提高服务器速度解决：为了提高firefly服务器性能，建议设置防病毒程序忽略扫描firefly存储库目录2） 设定firefly client超时门限解决：a) hff set rmc.client.connect.timeout b) 例如：hff set rmc.client.connect.timeout 1000c) 默认设置为2000d) 在网络环境不好时：i. 希望提高上传和下载成功率，调大门限值ii. 希望firefly client反应快，调小门限值3） 激活或者禁止explorer集成解决：激活：%firefly%clientbinsh

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

19、体的时间。8） 打开客户端时报初始化错误，报错q9，配置服务器license 的时候报“保存配置错误”解决：由于firefly和系统时间及时区有关，通常我们的电脑都用北京时区，而北京时区没有firefly需要调用的类，所以可先将本机调整成其他时区，然后再调整回来即可。9） 如何查看其它用户在这个分支上所做的未提交的变更集的内容？用户可以查看其他用户在这个分支上所作的尚未提交到服务器上的变更。方案一：在firefly web界面上：a) 打开浏览器，在地址栏输入 http:/fireflyserverip:8081，然后输入正确的用户名和密码登录firefly web。 b) 在firefly

20、web架构树上的指定项目下，选择一个分支，信息面板上将会显示该分支的属性信息。c) 在信息面板的分支属性表单中，选择中继工作区，则信息面板中将显示分支下的所有中继工作区。 d) 在信息面板的列表中，选择想要查询的用户的中继工作区，则页面上会显示该中继工作区的具体内容。e) 在中继工作区属性右侧，有一个操作面板，选择变更集按钮，可以查看这个用户对工作区文件的变更，这些变更都是没有提交到firefly服务器上的变更。方案二：在firefly client界面上：在联机状态下，在firefly client界面上，打开一个本地工作区。用户可以在变更集列表栏中查看到其他用户的变更集信息，以及他们对工作区文件所做的变更。10） 如果不小心做了撤销编辑操作，如何找回之前修改的文件? 解决：执行撤销编辑文件操作后，操作执行前已发生变更的文件被存放在%本地工作区目录% .fireflyunedit文件所在的目录名称 下，用户可以恢复在文件中已做