1、Firefly 配置管理工具常见问题FAQ中国光大银行信息科技部配置管理平台常见问题FAQ版本 V1.0文 档 编 号保 密 等 级作 者最后修改日期审 核 人最后审批日期批 准 人最后批准日期修改记录日期版本作者/修改者描述审核人2008-04-10V1.0创建文档2008-06-23V1.0修订文档：增加2.7、2.8、2.9等章节2009-01-09V1.0修订文档：增加常见问题标记；增加第三章 配置管理服务器的常见问题1 导言本文档描述了在Hansky Firefly使用过程中，可能遇到的一些问题以及解决方法，作为使用Firefly的参考资料和指南。本文档要时时维护，新遇到的问题随时添
2、加，以便起到真正的指导作用。其中红色字体为：项目组成员在使用过程中经常出现的问题。2 Firefly Clien常见问题2.1 安装常见问题1)安装firelfy 客户端，需要先安装java1.4+2)在windows下安装完firefly客户端后，打不开firefly客户端原因：有可能是因为电脑里存在多个Framework 版本（要检查是否存在多个版本，在“控制面板”中的“添加/删除程序”里查看）解决：方案一：把 “多个版本.Net Framework配置文件” 文件夹下的4 个config文件复制Firefly安装目录下的Clientbin目录中即可。方案二：在“控制面板”中的“添加/删除
3、程序”，删除掉以前安装过的 .Net Framework,，然后再安装.Net Framework 1.1版本。3)安装完firefly客户端后，运行程序时报：“The type initializer for com.hansky.apps.firefly.gui.fe.FileExplorer threw an exception.”；并且在配置Firefly Client Setting后保存时，报“Save license configuration file failed”解决：将.net和J#的1.1版本都卸掉；安装.net和J#的2.0版本后重启计算机。 4)安装完firefly
4、客户端后，运行程序时报：“Unable to load DLL(vjsnativ)”解决：安装vjredist.exe 。5)英文Windows 2003 SP1无法打开Firefly客户端安装文件，无法进行客户端安装解决：拷贝其他机器上已经安装好的Firefly Client目录到这台机器上。注意安装路径要一致，否 则需要手动修改%Hansky%FireflyClientbinjava中的hff.bat文件中的路径。2.2 客户端连接服务器常见问题1)Firefly 客户端连接不到Firefly 服务器原因：a)网络连接；b)firefly client setting问题c)License
5、 Server 设置d)本机系统时间，客户机操作系统时间应与Firefly服务器时间偏差不能超过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 使用adm
6、in用户登录，点击管理-刷新服务器license。方案二：若出现No License available问题：检查客户端是否正确的设置了 Firefly Client Setting 中的参数；登录 http:/LicenseServerIP:8083, 察看是否有正确的license。d)本机存在多个ip地址的情况下，连接firefly服务器时出现下列现象：使用Web可 以登陆，但使用客户端时弹出“找不到服务器”解决：在firefly命令行下执行如下命令： hff set rmc.client.usebinding true hff set rmc.client.bind.address x
7、xx.xxx.xxx.xxx(具体本机IP地址)注意：如果本机不存在多个IP，而之前绑定过的IP与当前机器IP不同，建议执行命令：hff set rmc.client.usebinding false取消绑定,而不是绑定为新的IP地址。2.3 使用常见问题2.3.1 WINDOWS1)本地工作区变更集丢失，变更集锁定，或网页变更集中显示的内容与工作区不符解决：出现以上问题，皆因为本地工作区受损，使用命令hff check -repair修复本地工作区。2)如何永久删除本地工作区解决：方案一：Firelfy Client端操作菜单“工作区 组织工作区删除相应的工作区“方案二：Firefly命令行
8、操作进入本地工作区的根目录，执行hff ws delete命令3)如何找回丢失的文件问题：a）“非法删除”的文件（不通过firefly删除的文件）b）已提交的合法删除的文件（通过firefly删除的文件）c）未提交的合法删除的文件（通过firelfly删除的文件）解决：a）Firefly Client-工具-显示丢失的文件 选择文件后，点击“获取”按钮b）：Firefly Client-工具-显示已删除文件列表选择文件后，点击撤销删除，如下图所示： c）：变更集撤销操作，如下图所示：4)打开工作区时出现“不能打开工作区，另一进程正在使用”错误解决：打开本地工作区中的.firefly目录,删除其
9、中的lockfile文件，如果没有lockfile文件，则删除properties.txt中的hansky.firefly.ws.lockport=*此行，然后重新打开客户端5)不能初始化本地工作区，出现权限限制提示解决：可能是对没有权限的分支进行了初始化的操作，请看清要初始化的分支名称后再进行初始化。6)修改目录名称解决：由于firefly是基于文件进行管理的，所以firefly工具不支持目录重命名，所以要修改目录名称，只能建立一个新目录，并把原目录中的文件移动到新目录中。 另外，工具机制决定修改目录名时，目录下每个文件的版本号都会加一，如果文件数很多，效率较慢7)如果不想提交隐藏文件，如何
10、操作? 解决：a） Windows客户端：打开客户端，选择：工具选项文件操作，当用户添加一个目录到Firefly配置库中时，若选中复选框，目录中的隐藏文件将不会被添加进去，如下所示：8)出现error：找不到存储库解决：关闭Firefly客户端，清除本地工作区.firefly目录下的content和metadate目录，然后重新打开Firefly的工作区 。9)用客户端解决冲突时选择手工解决，需要手动复制黏贴代码，会带来错误隐患解决：1、可以在firefly client中集成其他的第三方比较、合并工具。2、自动工具提供给人的只是一种便利，真正的合并结果必须由人来决定、并把关。 10)打开工作
11、区报“An unhandled exception has occurred in your application.” 解决：（请按以下顺序进行排查）1、确认firefly client的小版本号是否为：573 （如下图所示）2、确认以下两个插件的版本号是否一致：【Microsoft .NET Framework】和【Microsoft Visual J# .NET Redistributable Package】， 若同时为1.1或2.0版本，则无需调整直接根据第3步进行排查；若【.NET】为2.0，而【J#】为其他版本 - 需安装【J#】的2.0版本（获取路径：10.1.101.77；用
12、户名：fly；密码：flyfly；文件名：net2.0.zip）若【.NET】为其他版本，而【J#】为1.1 - 需将多个版本.net Framework配置文件.rar解压后的四个文件，拷贝到%firefly安装路径%的bin目录下即可；（经过第2步的调整后，重新运行firefly client，若问题仍存在请进入第3步）3、首先：进入本地个人工作区目录，将.firefly中的两个目录剪切：content和metadata； 然后：进入firefly的命令行模式，执行修复工作区命令（如下图所示）最后：重新运行firefly client；（若问题仍存在请进入第4步）4、首先：进入本地个人工作
13、区目录，将.firefly中changes目录中的内容剪切到他处； 然后：进入firefly的命令行模式，执行修复工作区命令（如下图所示）最后：重新运行firefly client。 11)在解决合并冲突后用户没法checkin新的变更状态解决：使用命令hff check repair 修复本地工作区。12)执行bringover过程中报错：“gidif:reach EOF in original,expect more data.”并且日志的最后几行显示： “Error 65687: File type error . Bringover cancelled”解决：使用命令hff check
14、 repair 修复本地工作区。13)bringover对话框中，文件图标显示为： 确定后出现提示： “An unhandled exception has occurred in your application.”解决：确认以下两个插件的版本号是否一致：【Microsoft .NET Framework】和【Microsoft Visual J# .NET Redistributable Package】， 若【.NET】为2.0，而【J#】为其他版本 - 需安装【J#】的2.0版本（获取路径：10.1.101.77；用户名：fly；密码：flyfly；文件名：net2.0.zip）若【.
15、NET】为其他版本，而【J#】为1.1 - 需将多个版本.net Framework配置文件.rar解压后的四个文件，拷贝到%firefly安装路径%的bin目录下即可；（经过第2步的调整后，重新运行firefly client，若问题仍存在请进入第3步）若同时为1.1版本 - 将两个插件全部删除重新安装，并保持同时为：1.1若同时为2.0版本 - - 将两个插件全部删除重新安装，并保持同时为：2.014)用户提交的文件不存在或“类型错误”解决：检查是否由于Firefly使用的服务器磁盘没有剩余空间引起。15)“添加到版本控制”中不能直接检入解决：在将新文件“添加到版本控制”时，不要选择“保持
16、检出”该默认选项16)如果一次提交三万个以上文件，系统会产生错误解决：分批添加提交，每次添加提交文件少于三万个17)提交文件时，提示“输入注释”解决：使用firefly工具提交文件时，要在注释中输入此次修改文件的目的，然后再选择提交解决：使用firefly工具提交文件时，要在注释中输入此次修改文件的目的，然后再选择提交18)使用firefly的windows客户端查看文件历史版本解决：能够列出文件所有历史版本，并可以查看任意版本，选中文件，单击右键，选择“显示文件历史”，出现历史选项，如下图所示：选中时间段后，单击“确定”，显示出文件历史，如下图所示，选中想查看的版本进行查看即可。19)使用f
17、irefly的windows客户端进行文件版本之间的比较解决：能够进行文件当前版本与其他版本比较，选中文件，单击右键，选择“版本比较”，出现“比较版本”，如下图所示：可以与前一版本进行比较，也可以选择其他版本，也可以选择其他文件，选择好文件单击“确定”即可。20)删除文件、添加同名该文件，重复多次，无法提交到服务器也无法撤销操作解决：首先将本地工作区中该文件的最终版本备份出来，然后把该文件手动删掉（不通过firefly操作），然后执行hff undo，撤销与该文件有关的操做；然后再把该工作区的该文件手动删掉，然后再执行hff undo，直到与该文件有关的操作全部撤销为止。21)设定Firefl
18、y client超时门限解决：a)hff set rmc.client.connect.timeout b)例如：hff set rmc.client.connect.timeout 1000c)默认设置为2000d)在网络环境不好时：i.希望提高上传和下载成功率，调大门限值ii.希望Firefly client反应快，调小门限值22)文件名大小写解决：跨平台要求，建议文件名和目录名均采用小写23)命名避免使用的字符： # & ( ) ; , * : ? . /24)关于文件过滤解决：用户可以在Firefly client的工具选项文件操作下的“不添加至版本控制的文件类型”内容复选框中，设置不
19、被添加到Firefly资源控制中的文件类型，如.bak，并选中“缺省使用文件过滤器”，如下图所示 ：25)打开客户端时报初始化错误，报q9，配置服务器license报“保存配置错误”解决：由于firefly和系统时间及时区有关，通常我们的电脑都用北京时区，而北京时区没有firefly需要调用的类，所以可先将本机调整成其他时区，然后再调整回来即可。26)如果不小心做了撤销编辑操作，如何找回之前修改的文件? 解决：执行撤销编辑文件操作后，操作执行前已发生变更的文件被存放在%本地工作区目录% .fireflyunedit文件所在的目录名称 下，用户可以恢复在文件中已做的变更，但只有最新变更的文件可被
20、保存。2.3.2 UNIX / LINUX 1)初始化工作区失败，报错:”Cant create workspace under an existing one”解决：首先在网页http:/ fireflyserver:8081上察看基于该目录的中继工作区是否已经删除；然后用ll all命令查看本地目录中是否含有.firefly文件夹，如果有将其删除，重新进行初始化即可。2)使用firefly的unix客户端查看文件历史版本 解决：使用命令hff hist ，可以显示指定工作区文件的历史版本包括文件的版本号，修改时间，修改人，修改注释等3)使用firefly的unix客户端获取文件历史版本解决
21、：使用命令hff get -v ，可以获取指定工作区文件的历史版本4)使用firefly的unix客户端进行文件版本之间的比较解决：使用命令hff diffs -v1 -v2 ，该操作比较本地工作区文件任意两个版本的不同5)提交后查看历史时，显示乱码，如下所示，查看该文件的注释也是乱码解决：AIX字符编码的问题。编辑%Hansky%/Firefly/Client/bin/hff文件，在$JDK12HOME/bin/java -Xms64m -Xmx256m后加参数 -Dfile.encoding=GBK。 6)关键字转换解决：Firefly提供了使用关键字转换功能，若选中该复选框，当用户编辑文
22、件并保存的本地变更之后，文件中的关键字将被转换成实际的数值，如%G%将转换为具体的时间。7)在工作区中执行bringover报错，报“java.lang.NullPointerException”解决：查看本地工作区.firefly目录下是否有resumelist.fdb文件，如果有该文件，删除该文件即可。 报该错主要原因是部分文件被锁定了，无法继续执行操作。3 Firefly Server Explorer常见问题1)查看某项目配置库中已检出的文件解决：运行Firefly Server Explorer，选中项目的配置库，如下图所示： 选择：工具分支检出列表，如下图所示，可以列出配置库中已检
23、出的文件，包括：文件名、检出用户及锁定者，配置管理员可以根据文件列表通知相关用户进行文件检入2)在启用文件级访问控制的情况下，更换服务器后，用户更新文件的权限失效解决：重新初始化工作区。3)添加或编辑文件时出错，Error 65748：ACL Denied解决：检查是否已经给该用户的分配相应的文件权限。4)无法下载标记解决：查看是否有相应标记的下载权限；如果没有，请标记的建立人员把标记bringover的权限分配给相应人员5)手工查找文件建立标记容易出错解决：对需要建立标记的文件生成文件列表，利用firefly命令行建立标记hff br label -h -proj -b -lf 6)使用命令
24、下载标记解决：hff download -h -proj -l -d 注：下载的目标路径必须为空目录4 集成Eclipse操作常见问题1)如果不小心删除了文件，如何找回？解决：在Eclipse中选择删除操作，会触发firefly将该文件从配置库中删除，所以要慎用。如果删除，可通过web浏览器下载已删除的文件，再重新上传到配置库中（firefly会将删除文件按照目录结构移动到DELETE目录下）。2)在Eclipse中安装Firefly插件之后，Firefly菜单不出现，如何解决？ 解决：方案一：打开Eclipse，点击菜单栏“Window” - “Customize Perspective”
25、- “Commands” ，勾选“Source Code Control”。 方案二：eclipseconfigurationorg.eclipse.update目录中的platform.xml，剪切出去，备份，重新打开Eclipse。3)安装Firefly插件，绑定Firefly后，文件没有显示文件控制图标和版本号解决：打开Eclipse，点击菜单栏 “Window” - “Preferences”，选择“General - Appearance - Label Decorations”，勾选“HSCC Decorator”。 4)在Eclipse中文件冲突，解决冲突时选择手动解决，报错：m
26、erge tools not found。解决：打开C:Documents and SettingsAdministratorHanskyFireflyClientgui.dat文件（其中Administrator是当前系统的登录用户）参考附件中的gui.dat加入vdm.path，如：vdm.path=D:Program FilesHanskyFireflyClientbinVDM.exe路径为Firefly Client的安装路径，注意用两个。修改完成后重新打开Eclipse，测试。附件gui.dat ：#Firefly Common Properties#Thu May 07 17:09
27、:17 CST 2009gui.showprogress=falsevtree.path=D:Program FilesHanskyFireflyClientbinVTree.exedefault.resource=STRINGS_CN:GB2312last.access.local=tomclient.path=D:Program FilesHanskyFireflyClientbinfirefly_client.exevdm.path=D:Program FilesHanskyFireflyClientbinVDM.exegui.showmissing=truegui.edit.updat
28、e=true5 Firefly Web常用功能1)使用firefly的web界面查看文件历史版本解决：从web界面登陆配置管理系统，找到要进行查看的文件并选中文件，出现如下界面，选择“历史”既可以查看相应的历史版本，选择“原始数据”即可以获取当前版本的文件2)使用firefly的web界面进行文件版本之间的比较解决：选中要进行版本比较的文件，点击历史，出现如下界面，选择“版本”，即可查看相应版本的内容，选择“比较版本”，可以进行任意版本的比较。3)查看某项目的配置库操作历史解决：登陆web界面，选中要进行查看的项目，选中配置库，如下图所示：选择“历史”，界面如下所示，可以查看用户在配置库中所作
29、的操作，包括：操作、用户、变更、工作区和变更时间4)激活或者禁止Explorer集成解决：激活：%Firefly%clientbinshell禁止：%Firefly%clientbinshell -u6 服务器端常见问题1)服务器端出现自动掉ffd进程的情况解决：a）先排查ffd启动的log，查看是否为firefly系统自身原因； b) 查看操作系统message日志，排查系统自动杀掉进程的原因，如：是否由于Free swap: 0kB（交换内存设置过小）等2)提高服务器速度解决：为了提高Firefly服务器性能，建议设置防病毒程序忽略扫描Firefly存储库目录3)更换服务器地址后，firefly客户端的本地工作区不能使用解决：打开本地工作区，显示未连接，此时打开：工具选项，选择“当前工作区设置”选项卡，将服务器主机设置为新的服务器地址，并确定；然后关闭工作区，退出，再重新打开firefly客户端。4)更换服务器后，修改“当前工作区设置”中“Firefly服务器主机”时，打不开工作区解决：打开本地工作区的.firefly文件夹，修改properties.txt中这一行：hansky.firefly.server.host=*，把以前的服务器地址修改为新的服务器地址。
