Firefly 配置管理工具常见问题FAQWord格式文档下载.docx

1、1）安装firelfy 客户端，需要先安装java1.4+2）在windows下安装完firefly客户端后，打不开firefly客户端原因：有可能是因为电脑里存在多个Framework 版本（要检查是否存在多个版本，在“控制面板”中的“添加/删除程序”里查看）解决：方案一：把 “多个版本.Net Framework配置文件” 文件夹下的4 个config文件复制Firefly安装目录下的Clientbin目录中即可。方案二：在“控制面板”中的“添加/删除程序”，删除掉以前安装过的 .Net Framework,，然后再安装.Net Framework 1.1版本。3）安装完firefly客户

2、端后，运行程序时报：“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客户端后，运行程序时报：“Unable to load DLL（vjsnativ）”安装vjredist.exe 。5）英文Windows 200

3、3 SP1无法打开Firefly客户端安装文件，无法进行客户端安装拷贝其他机器上已经安装好的Firefly Client目录到这台机器上。注意安装路径要一致，否 则需要手动修改%Hansky%FireflyClientbinjava中的hff.bat文件中的路径。2.2 客户端连接服务器常见问题1）Firefly 客户端连接不到Firefly 服务器a）网络连接；b）firefly client setting问题c）License Server 设置d）本机系统时间，客户机操作系统时间应与Firefly服务器时间偏差不能超过24小时。e）License Idle count的个数，如果为0则

4、没有可用的License如下图所示：a）检查网络是否连通；b）检查是否将firefly client setting 中的License服务器主机地址设置为firelfly 服务器地址；c）License Server：若出现No Server License问题：登录http:/licenseserverip:8083 察看是否有正确License；/fireflyserverip:8081 使用admin用户登录，点击管理-刷新服务器license。若出现No License available问题：检查客户端是否正确的设置了 Firefly Client Setting 中的参数；登录

5、http:/LicenseServerIP:8083, 察看是否有正确的license。d）本机存在多个ip地址的情况下，连接firefly服务器时出现下列现象：使用Web可 以登陆，但使用客户端时弹出“找不到服务器”在firefly命令行下执行如下命令： hff set rmc.client.usebinding true hff set rmc.client.bind.address xxx.xxx.xxx.xxx（具体本机IP地址）注意：如果本机不存在多个IP，而之前绑定过的IP与当前机器IP不同，建议执行命令：hff set rmc.client.usebinding false取消绑

6、定,而不是绑定为新的IP地址。2.3 使用常见问题2.3.1 WINDOWS1）本地工作区变更集丢失，变更集锁定，或网页变更集中显示的内容与工作区不符出现以上问题，皆因为本地工作区受损，使用命令hff check -repair修复本地工作区。2）如何永久删除本地工作区Firelfy Client端操作菜单“工作区 组织工作区删除相应的工作区“Firefly命令行操作进入本地工作区的根目录，执行hff ws delete命令3）如何找回丢失的文件问题：a）“非法删除”的文件（不通过firefly删除的文件）b）已提交的合法删除的文件（通过firefly删除的文件）c）未提交的合法删除的文件（通

7、过firelfly删除的文件）a）Firefly Client-工具-显示丢失的文件 选择文件后，点击“获取”按钮b）：Firefly Client-显示已删除文件列表选择文件后，点击撤销删除，如下图所示：c）：变更集撤销操作，如下图所示：4）打开工作区时出现“不能打开工作区，另一进程正在使用”错误打开本地工作区中的.firefly目录,删除其中的lockfile文件，如果没有lockfile文件，则删除properties.txt中的hansky.firefly.ws.lockport=*此行，然后重新打开客户端5）不能初始化本地工作区，出现权限限制提示可能是对没有权限的分支进行了初始化的操

8、作，请看清要初始化的分支名称后再进行初始化。6）修改目录名称由于firefly是基于文件进行管理的，所以firefly工具不支持目录重命名，所以要修改目录名称，只能建立一个新目录，并把原目录中的文件移动到新目录中。 另外，工具机制决定修改目录名时，目录下每个文件的版本号都会加一，如果文件数很多，效率较慢7）如果不想提交隐藏文件，如何操作?a） Windows客户端：打开客户端，选择：工具选项文件操作，当用户添加一个目录到Firefly配置库中时，若选中复选框，目录中的隐藏文件将不会被添加进去，如下所示：8）出现error：找不到存储库关闭Firefly客户端，清除本地工作区.firefly目录

9、下的content和metadate目录，然后重新打开Firefly的工作区 。9）用客户端解决冲突时选择手工解决，需要手动复制黏贴代码，会带来错误隐患1、可以在firefly client中集成其他的第三方比较、合并工具。2、自动工具提供给人的只是一种便利，真正的合并结果必须由人来决定、并把关。10）打开工作区报“An unhandled exception has occurred in your application.” （请按以下顺序进行排查）1、确认firefly client的小版本号是否为：573 （如下图所示）2、确认以下两个插件的版本号是否一致：【Microsoft .NE

10、T Framework】和【Microsoft Visual J# .NET Redistributable Package】， 若同时为1.1或2.0版本，则无需调整直接根据第3步进行排查；若【.NET】为2.0，而【J#】为其他版本 - 需安装【J#】的2.0版本（获取路径：10.1.101.77；用户名：fly；密码：flyfly；文件名：net2.0.zip）若【.NET】为其他版本，而【J#】为1.1 - 需将多个版本.net Framework配置文件.rar解压后的四个文件，拷贝到%firefly安装路径%的bin目录下即可；（经过第2步的调整后，重新运行firefly clie

11、nt，若问题仍存在请进入第3步）3、首先：进入本地个人工作区目录，将.firefly中的两个目录剪切：content和metadata； 然后：进入firefly的命令行模式，执行修复工作区命令（如下图所示）最后：重新运行firefly client；（若问题仍存在请进入第4步）4、首先：进入本地个人工作区目录，将.firefly中changes目录中的内容剪切到他处；重新运行firefly client。11）在解决合并冲突后用户没法checkin新的变更状态使用命令hff check repair 修复本地工作区。12）执行bringover过程中报错：“gidif:reach EOF i

12、n original,expect more data.”并且日志的最后几行显示： “Error 65687: File type error . Bringover cancelled”13）bringover对话框中，文件图标显示为：确定后出现提示： “An unhandled exception has occurred in your application.”确认以下两个插件的版本号是否一致：若同时为1.1版本 - 将两个插件全部删除重新安装，并保持同时为：1.1若同时为2.0版本 - - 将两个插件全部删除重新安装，并保持同时为：2.014）用户提交的文件不存在或“类型错误”检查是

13、否由于Firefly使用的服务器磁盘没有剩余空间引起。15）“添加到版本控制”中不能直接检入在将新文件“添加到版本控制”时，不要选择“保持检出”该默认选项16）如果一次提交三万个以上文件，系统会产生错误分批添加提交，每次添加提交文件少于三万个17）提交文件时，提示“输入注释”使用firefly工具提交文件时，要在注释中输入此次修改文件的目的，然后再选择提交18）使用firefly的windows客户端查看文件历史版本能够列出文件所有历史版本，并可以查看任意版本，选中文件，单击右键，选择“显示文件历史”，出现历史选项，如下图所示：选中时间段后，单击“确定”，显示出文件历史，如下图所示，选中想查看

14、的版本进行查看即可。19）使用firefly的windows客户端进行文件版本之间的比较能够进行文件当前版本与其他版本比较，选中文件，单击右键，选择“版本比较”，出现“比较版本”，如下图所示：可以与前一版本进行比较，也可以选择其他版本，也可以选择其他文件，选择好文件单击“确定”即可。20）删除文件、添加同名该文件，重复多次，无法提交到服务器也无法撤销操作首先将本地工作区中该文件的最终版本备份出来，然后把该文件手动删掉（不通过firefly操作），然后执行hff undo，撤销与该文件有关的操做；然后再把该工作区的该文件手动删掉，然后再执行hff undo，直到与该文件有关的操作全部撤销为止。2

15、1）设定Firefly 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的工具选项文件操作下的“不添加至版本控制的文件类型”内容复选框中，设置

16、不被添加到Firefly资源控制中的文件类型，如.bak，并选中“缺省使用文件过滤器”，如下图所示 ：25）打开客户端时报初始化错误，报q9，配置服务器license报“保存配置错误”由于firefly和系统时间及时区有关，通常我们的电脑都用北京时区，而北京时区没有firefly需要调用的类，所以可先将本机调整成其他时区，然后再调整回来即可。26）如果不小心做了撤销编辑操作，如何找回之前修改的文件?执行撤销编辑文件操作后，操作执行前已发生变更的文件被存放在%本地工作区目录% .fireflyunedit文件所在的目录名称 下，用户可以恢复在文件中已做的变更，但只有最新变更的文件可被保存。2.3

17、.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客户端获取文件历史版本使用命令hff get -v

18、 ，可以获取指定工作区文件的历史版本4）使用firefly的unix客户端进行文件版本之间的比较使用命令hff diffs -v1 -v2，该操作比较本地工作区文件任意两个版本的不同5）提交后查看历史时，显示乱码，如下所示，查看该文件的注释也是乱码AIX字符编码的问题。编辑%Hansky%/Firefly/Client/bin/hff文件，在$JDK12HOME/bin/java -Xms64m -Xmx256m后加参数 -Dfile.encoding=GBK。6）关键字转换Firefly提供了使用关键字转换功能，若选中该复选框，当用户编辑文件并保存的本地变更之后，文件中的关键字将被转换成实际

19、的数值，如%G%将转换为具体的时间。7）在工作区中执行bringover报错，报“java.lang.NullPointerException”查看本地工作区.firefly目录下是否有resumelist.fdb文件，如果有该文件，删除该文件即可。 报该错主要原因是部分文件被锁定了，无法继续执行操作。3 Firefly Server Explorer常见问题1）查看某项目配置库中已检出的文件运行Firefly Server Explorer，选中项目的配置库，如下图所示：选择：工具分支检出列表，如下图所示，可以列出配置库中已检出的文件，包括：文件名、检出用户及锁定者，配置管理员可以根据文件列

20、表通知相关用户进行文件检入2）在启用文件级访问控制的情况下，更换服务器后，用户更新文件的权限失效重新初始化工作区。3）添加或编辑文件时出错，Error 65748：ACL Denied检查是否已经给该用户的分配相应的文件权限。4）无法下载标记查看是否有相应标记的下载权限；如果没有，请标记的建立人员把标记bringover的权限分配给相应人员5）手工查找文件建立标记容易出错对需要建立标记的文件生成文件列表，利用firefly命令行建立标记hff br label -h -proj -b -lf 标记名称6）使用命令下载标记hff download -h -l -d 注：下载的目标路径必须为空目录

21、4 集成Eclipse操作常见问题1）如果不小心删除了文件，如何找回？在Eclipse中选择删除操作，会触发firefly将该文件从配置库中删除，所以要慎用。如果删除，可通过web浏览器下载已删除的文件，再重新上传到配置库中（firefly会将删除文件按照目录结构移动到DELETE目录下）。2）在Eclipse中安装Firefly插件之后，Firefly菜单不出现，如何解决？打开Eclipse，点击菜单栏“Window” - “Customize Perspective” - “Commands” ，勾选“Source Code Control”。 方案二：eclipseconfigurati

22、onorg.eclipse.update目录中的platform.xml，剪切出去，备份，重新打开Eclipse。3）安装Firefly插件，绑定Firefly后，文件没有显示文件控制图标和版本号打开Eclipse，点击菜单栏 “Window” - “Preferences”，选择“General - Appearance - Label Decorations”，勾选“HSCC Decorator”。4）在Eclipse中文件冲突，解决冲突时选择手动解决，报错：merge tools not found。打开C:Documents and SettingsAdministratorHansk

23、yFireflyClientgui.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:17 CST 2009gui.showprogress=falsevtree.path=D:Program FilesHanskyFir

24、eflyClientbinVTree.exedefault.resource=STRINGS_CN:GB2312last.access.local=tomclient.path=D:Program FilesHanskyFireflyClientbinfirefly_client.exevdm.path=D:gui.showmissing=truegui.edit.update=true5 Firefly Web常用功能1）使用firefly的web界面查看文件历史版本从web界面登陆配置管理系统，找到要进行查看的文件并选中文件，出现如下界面，选择“历史”既可以查看相应的历史版本，选择“原始数

25、据”即可以获取当前版本的文件2）使用firefly的web界面进行文件版本之间的比较选中要进行版本比较的文件，点击历史，出现如下界面，选择“版本”，即可查看相应版本的内容，选择“比较版本”，可以进行任意版本的比较。3）查看某项目的配置库操作历史登陆web界面，选中要进行查看的项目，选中配置库，如下图所示：选择“历史”，界面如下所示，可以查看用户在配置库中所作的操作，包括：操作、用户、变更、工作区和变更时间4）激活或者禁止Explorer集成激活：%Firefly%clientbinshell禁止：%Firefly%clientbinshell -u6 服务器端常见问题1）服务器端出现自动掉ff

26、d进程的情况a）先排查ffd启动的log，查看是否为firefly系统自身原因； b） 查看操作系统message日志，排查系统自动杀掉进程的原因，如：是否由于Free swap: 0kB（交换内存设置过小）等2）提高服务器速度为了提高Firefly服务器性能，建议设置防病毒程序忽略扫描Firefly存储库目录3）更换服务器地址后，firefly客户端的本地工作区不能使用打开本地工作区，显示未连接，此时打开：工具选项，选择“当前工作区设置”选项卡，将服务器主机设置为新的服务器地址，并确定；然后关闭工作区，退出，再重新打开firefly客户端。4）更换服务器后，修改“当前工作区设置”中“Firefly服务器主机”时，打不开工作区打开本地工作区的.firefly文件夹，修改properties.txt中这一行：hansky.firefly.server.host=*，把以前的服务器地址修改为新的服务器地址。