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

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

《Firefly 配置管理工具常见问题FAQWord格式文档下载.docx》由会员分享，可在线阅读，更多相关《Firefly 配置管理工具常见问题FAQWord格式文档下载.docx（23页珍藏版）》请在冰豆网上搜索。

1）安装firelfy客户端，需要先安装java1.4+

2）在windows下安装完firefly客户端后，打不开firefly客户端

原因：

有可能是因为电脑里存在多个Framework版本（要检查是否存在多个版本，在“控制面板”中的“添加/删除程序”里查看）

解决：

方案一：

把“多个版本.NetFramework配置文件”文件夹下的4个config文件复制Firefly安装目录下的\Client\bin目录中即可。

方案二：

在“控制面板”中的“添加/删除程序”，删除掉以前安装过的.NetFramework,，然后再安装.NetFramework1.1版本。

3）安装完firefly客户端后，运行程序时报：

“Thetypeinitializerfor‘com.hansky.apps.firefly.gui.fe.FileExplorer’threwanexception.”；

并且在配置FireflyClientSetting后保存时，报“Savelicenseconfigurationfilefailed”

将.net和J#的1.1版本都卸掉；

安装.net和J#的2.0版本后重启计算机。

4）安装完firefly客户端后，运行程序时报：

“UnabletoloadDLL（vjsnativ）”

安装vjredist.exe。

5）英文Windows2003SP1无法打开Firefly客户端安装文件，无法进行客户端安装

拷贝其他机器上已经安装好的FireflyClient目录到这台机器上。

注意安装路径要一致，否

则需要手动修改%Hansky%\Firefly\Client\bin\java中的hff.bat文件中的路径。

2.2客户端连接服务器常见问题

1）Firefly客户端连接不到Firefly服务器

a）网络连接；

b）fireflyclientsetting问题

c）LicenseServer设置

d）本机系统时间，客户机操作系统时间应与Firefly服务器时间偏差不能超过24小时。

e）LicenseIdlecount的个数，如果为0则没有可用的License

如下图所示：

a）检查网络是否连通；

b）检查是否将fireflyclientsetting中的License服务器主机地址设置为firelfly服务器地址；

c）LicenseServer：

若出现NoServerLicense问题：

登录http:

//licenseserverip:

8083察看是否有正确License；

//fireflyserverip:

8081使用admin用户登录，点击"

管理"

->

"

刷新服务器license"

。

若出现NoLicenseavailable问题：

检查客户端是否正确的设置了‘FireflyClientSetting’中的参数；

登录http:

//LicenseServerIP:

8083,察看是否有正确的license。

d）本机存在多个ip地址的情况下，连接firefly服务器时出现下列现象：

使用Web可以登陆，但使用客户端时弹出“找不到服务器”

在firefly命令行下执行如下命令：

hffsetrmc.client.usebindingtrue

　hffsetrmc.client.bind.addressxxx.xxx.xxx.xxx（具体本机IP地址）

注意：

如果本机不存在多个IP，而之前绑定过的IP与当前机器IP不同，建议执行命令：

hffsetrmc.client.usebindingfalse取消绑定,而不是绑定为新的IP地址。

2.3使用常见问题

2.3.1WINDOWS

1）本地工作区变更集丢失，变更集锁定，或网页变更集中显示的内容与工作区不符

出现以上问题，皆因为本地工作区受损，使用命令hffcheck-repair修复本地工作区。

2）如何永久删除本地工作区

FirelfyClient端操作

菜单“工作区－>

组织工作区—〉删除相应的工作区“

Firefly命令行操作

进入本地工作区的根目录，执行hffwsdelete命令

3）如何找回丢失的文件

问题：

a）“非法删除”的文件（不通过firefly删除的文件）

b）已提交的合法删除的文件（通过firefly删除的文件）

c）未提交的合法删除的文件（通过firelfly删除的文件）

a）FireflyClient->

工具->

显示丢失的文件—〉选择文件后，点击“获取”按钮

b）：

FireflyClient->

显示已删除文件列表—〉选择文件后，点击撤销删除，如下图所示：

c）：

变更集—〉撤销操作，如下图所示：

4）打开工作区时出现“不能打开工作区，另一进程正在使用”错误

打开本地工作区中的.firefly目录,删除其中的lockfile文件，如果没有lockfile文件，则删除properties.txt中的hansky.firefly.ws.lockport=*****此行，然后重新打开客户端

5）不能初始化本地工作区，出现权限限制提示

可能是对没有权限的分支进行了初始化的操作，请看清要初始化的分支名称后再进行初

始化。

6）修改目录名称

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

另外，工具机制决定修改目录名时，目录下每个文件的版本号都会加一，如果文件数很多，效率较慢

7）如果不想提交隐藏文件，如何操作?

a）Windows客户端：

打开客户端，选择：

工具>

选项>

文件操作，当用户添加一个目录到Firefly配置库中时，若选中复选框，目录中的隐藏文件将不会被添加进去，如下所示：

8）出现error：

找不到存储库

关闭Firefly客户端，清除本地工作区.firefly目录下的content和metadate目录，然后重新打开Firefly的工作区。

9）用客户端解决冲突时选择手工解决，需要手动复制黏贴代码，会带来错误隐患

1、可以在fireflyclient中集成其他的第三方比较、合并工具。

2、自动工具提供给人的只是一种便利，真正的合并结果必须由人来决定、并把关。

10）打开工作区报“Anunhandledexceptionhasoccurredinyourapplication.…”

（请按以下顺序进行排查）

1、确认fireflyclient的小版本号是否为：

573（如下图所示）

2、确认以下两个插件的版本号是否一致：

【Microsoft.NETFramework】和【MicrosoftVisualJ#.NETRedistributablePackage】，

若同时为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------需将‘多个版本.netFramework配置文件.rar’解压后的四个文件，拷贝到%firefly安装路径%的bin目录下即可；

（经过第2步的调整后，重新运行fireflyclient，若问题仍存在请进入第3步）

3、首先：

进入本地个人工作区目录，将.firefly中的两个目录剪切：

content和metadata；

然后：

进入firefly的命令行模式，执行修复工作区命令（如下图所示）

最后：

重新运行fireflyclient；

（若问题仍存在请进入第4步）

4、首先：

进入本地个人工作区目录，将.firefly中changes目录中的内容剪切到他处；

重新运行fireflyclient。

11）在解决合并冲突后用户没法checkin新的变更状态

使用命令hffcheck–repair修复本地工作区。

12）执行bringover过程中报错：

“gidif:

reachEOFinoriginal,expectmoredata.”

并且日志的最后几行显示：

“Error65687:

Filetypeerror.Bringovercancelled”

13）bringover对话框中，文件图标显示为：

确定后出现提示：

“Anunhandledexceptionhasoccurredinyourapplication.…”

确认以下两个插件的版本号是否一致：

若同时为1.1版本------将两个插件全部删除重新安装，并保持同时为：

1.1

若同时为2.0版本------将两个插件全部删除重新安装，并保持同时为：

2.0

14）用户提交的文件不存在或“类型错误”

检查是否由于Firefly使用的服务器磁盘没有剩余空间引起。

15）“添加到版本控制”中不能直接检入

在将新文件“添加到版本控制”时，不要选择“保持检出”该默认选项

16）如果一次提交三万个以上文件，系统会产生错误

分批添加提交，每次添加提交文件少于三万个

17）提交文件时，提示“输入注释”

使用firefly工具提交文件时，要在注释中输入此次修改文件的目的，然后再选择提交

18）使用firefly的windows客户端查看文件历史版本

能够列出文件所有历史版本，并可以查看任意版本，选中文件，单击右键，选择“显示文件历史”，出现历史选项，如下图所示：

选中时间段后，单击“确定”，显示出文件历史，如下图所示，选中想查看的版本进行查看即可。

19）使用firefly的windows客户端进行文件版本之间的比较

能够进行文件当前版本与其他版本比较，选中文件，单击右键，选择“版本比较”，出现“比较版本”，如下图所示：

可以与前一版本进行比较，也可以选择其他版本，也可以选择其他文件，选择好文件单击“确定”即可。

20）删除文件、添加同名该文件，重复多次，无法提交到服务器也无法撤销操作

首先将本地工作区中该文件的最终版本备份出来，然后把该文件手动删掉（不通过firefly操作），然后执行hffundo，撤销与该文件有关的操做；

然后再把该工作区的该文件手动删掉，然后再执行hffundo，直到与该文件有关的操作全部撤销为止。

21）设定Fireflyclient超时门限

a）hffsetrmc.client.connect.timeout<

毫秒>

b）例如：

hffsetrmc.client.connect.timeout1000

c）默认设置为2000

d）在网络环境不好时：

i.希望提高上传和下载成功率，调大门限值

ii.希望Fireflyclient反应快，调小门限值

22）文件名大小写

跨平台要求，建议文件名和目录名均采用小写

23）命名避免使用的字符：

~#&

（）;

*:

"

<

>

\?

./

24）关于文件过滤

用户可以在Fireflyclient的工具—〉选项—〉文件操作下的“不添加至版本控制的文件类型”内容复选框中，设置不被添加到Firefly资源控制中的文件类型，如.bak，并选中“缺省使用文件过滤器”，如下图所示：

25）打开客户端时报初始化错误，报q9，配置服务器license报“保存配置错误”

由于firefly和系统时间及时区有关，通常我们的电脑都用北京时区，而北京时区没有firefly需要调用的类，所以可先将本机调整成其他时区，然后再调整回来即可。

26）如果不小心做了撤销编辑操作，如何找回之前修改的文件?

执行撤销编辑文件操作后，操作执行前已发生变更的文件被存放在%本地工作区目录%\.firefly\unedit\文件所在的目录名称\下，用户可以恢复在文件中已做的变更，但只有最新变更的文件可被保存。

2.3.2UNIX/LINUX

1）初始化工作区失败，报错:

”Can'

tcreateworkspaceunderanexistingone”

首先在网页http:

//fireflyserver:

8081上察看基于该目录的中继工作区是否已经删除；

然后用ll–all命令查看本地目录中是否含有.firefly文件夹，如果有将其删除，重新进行初始化即可。

2）使用firefly的unix客户端查看文件历史版本

使用命令hffhist<

文件名>

，可以显示指定工作区文件的历史版本包括文件的版本号，修改时间，修改人，修改注释等

3）使用firefly的unix客户端获取文件历史版本

使用命令hffget-v<

要获取的版本>

，可以获取指定工作区文件的历史版本

4）使用firefly的unix客户端进行文件版本之间的比较

使用命令hffdiffs-v1<

指定该文件的源版本>

-v2<

指定该文件的目标版本>

，该操作比较本地工作区文件任意两个版本的不同

5）提交后查看历史时，显示乱码，如下所示，查看该文件的注释也是乱码

AIX字符编码的问题。

编辑%Hansky%/Firefly/Client/bin/hff文件，在${JDK12HOME}/bin/java-Xms64m-Xmx256m后加参数-Dfile.encoding=GBK。

6）关键字转换

Firefly提供了使用关键字转换功能，若选中该复选框，当用户编辑文件并保存的本地变更之后，文件中的关键字将被转换成实际的数值，如%G%将转换为具体的时间。

7）在工作区中执行bringover报错，报“java.lang.NullPointerException”

查看本地工作区.firefly目录下是否有resumelist.fdb文件，如果有该文件，删除该文件即可。

报该错主要原因是部分文件被锁定了，无法继续执行操作。

3FireflyServerExplorer常见问题

1）查看某项目配置库中已检出的文件

运行FireflyServerExplorer，选中项目的配置库，如下图所示：

选择：

工具<

分支检出列表，如下图所示，可以列出配置库中已检出的文件，包括：

文件名、检出用户及锁定者，配置管理员可以根据文件列表通知相关用户进行文件检入

2）在启用文件级访问控制的情况下，更换服务器后，用户更新文件的权限失效

重新初始化工作区。

3）添加或编辑文件时出错，Error65748：

ACLDenied

检查是否已经给该用户的分配相应的文件权限。

4）无法下载标记

查看是否有相应标记的下载权限；

如果没有，请标记的建立人员把标记bringover的权限分配给相应人员

5）手工查找文件建立标记容易出错

对需要建立标记的文件生成文件列表，利用firefly命令行建立标记

hffbrlabel-h<

配置管理服务器地址>

-proj<

配置库项目名称>

-b<

配置库名称>

-lf<

文件列表>

标记名称>

6）使用命令下载标记

hffdownload-h<

-l<

-d<

下载的目标路径>

注：

下载的目标路径必须为空目录

4集成Eclipse操作常见问题

1）如果不小心删除了文件，如何找回？

在Eclipse中选择删除操作，会触发firefly将该文件从配置库中删除，所以要慎用。

如果删除，可通过web浏览器下载已删除的文件，再重新上传到配置库中（firefly会将删除文件按照目录结构移动到DELETE目录下）。

2）在Eclipse中安装Firefly插件之后，"

Firefly"

菜单不出现，如何解决？

打开Eclipse，点击菜单栏“Window”->

“CustomizePerspective”->

“Commands”，勾选“SourceCodeControl”。

方案二：

\eclipse\configuration\org.eclipse.update\目录中的platform.xml，剪切出去，备份，重新打开Eclipse。

3）安装Firefly插件，绑定Firefly后，文件没有显示文件控制图标和版本号

打开Eclipse，点击菜单栏“Window”->

“Preferences”，选择“General->

Appearance->

LabelDecorations”，勾选“HSCCDecorator”。

4）在Eclipse中文件冲突，解决冲突时选择手动解决，报错：

mergetoolsnotfound。

打开C:

\DocumentsandSettings\Administrator\Hansky\Firefly\Client\gui.dat文件（其中Administrator是当前系统的登录用户）

参考附件中的gui.dat加入vdm.path，

如：

vdm.path=D:

\\ProgramFiles\\Hansky\\Firefly\\Client\\bin\\VDM.exe

路径为FireflyClient的安装路径，注意用两个"

\"

修改完成后重新打开Eclipse，测试。

附件gui.dat：

#FireflyCommonProperties

#ThuMay0717:

09:

17CST2009

gui.showprogress=false

vtree.path=D\:

\\ProgramFiles\\Hansky\\Firefly\\Client\\bin\\VTree.exe

default.resource=STRINGS_CN\:

GB2312

last.access.local=tom

client.path=D\:

\\ProgramFiles\\Hansky\\Firefly\\Client\\bin\\firefly_client.exe

vdm.path=D\:

gui.showmissing=true

gui.edit.update=true

5FireflyWeb常用功能

1）使用firefly的web界面查看文件历史版本

从web界面登陆配置管理系统，找到要进行查看的文件并选中文件，出现如下界面，选择“历史”既可以查看相应的历史版本，选择“原始数据”即可以获取当前版本的文件

2）使用firefly的web界面进行文件版本之间的比较

选中要进行版本比较的文件，点击历史，出现如下界面，选择“版本”，即可查看相应版本的内容，选择“比较版本”，可以进行任意版本的比较。

3）查看某项目的配置库操作历史

登陆web界面，选中要进行查看的项目，选中配置库，如下图所示：

选择“历史”，界面如下所示，可以查看用户在配置库中所作的操作，包括：

操作、用户、变更、工作区和变更时间

4）激活或者禁止Explorer集成

激活：

%Firefly%\client\bin\shell

禁止：

%Firefly%\client\bin\shell-u

6服务器端常见问题

1）服务器端出现自动掉ffd进程的情况

a）先排查ffd启动的log，查看是否为firefly系统自身原因；

b）查看操作系统message日志，排查系统自动杀掉进程的原因，如：

是否由于Freeswap:

0kB（交换内存设置过小）等

2）提高服务器速度

为了提高Firefly服务器性能，建议设置防病毒程序忽略扫描Firefly存储库目录

3）更换服务器地址后，firefly客户端的本地工作区不能使用

打开本地工作区，显示未连接，此时打开：

工具－>

选项，选择“当前工作区设置”选项卡，将服务器主机设置为新的服务器地址，并确定；

然后关闭工作区，退出，再重新打开firefly客户端。

4）更换服务器后，修改“当前工作区设置”中“Firefly服务器主机”时，打不开工作区

打开本地工作区的.firefly文件夹，修改properties.txt中这一行：

hansky.firefly.server.host=********，把以前的服务器地址修改为新的服务器地址。