中国光大银行信息科技部配置管理平台常见问题FAQ

神州数码

aCllnlr>kC中HIN国AEV光ERB大RIGH银TBA行NK（一一^DigitalChina

中国光大银行信息科技部

配置管理平台常见问题FAQ

版本VLO

文档编号保密等级

作者最后修改日期

审核人最后审批日期

批准人最后批准日期

配置管理平台常见问题FAQ

修改记录

日期版本作者/修改者描述审核人

2008-04-10VI.0创建文档

2008-06-23VI.0修订文档：①增加2.7、2.8、2.9等章节

修订文档：①增加常见问题标记；②增加

2009-01-09VI.0

第三章配置管理服务器的常见问题

第II页

配置管理平台常见问题FAQ

目录

1导言........................................................................................1

2FireflyClien常见问题.........................................................................I

2.1安装常见问题.........................................................................1

1)安装firdfy客户端，需要先安装javal.4+.............................................................................1

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

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

<com.hansky.apps.firefly.gui.fc.FileExplorer,threwanexception."；........................................1

并且在配置FireflyClientSetting后保存时，报aSavelicenseconfigurationfilefailed"...」

4)安装完firefly客户端后，运行程序时报：MUnabletoloadDLL(vjsnativ)**..................2

5)英文Windows2003SP1无法打开Firefly客户端安装文件，无法进行客户端安装..…2

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

1)Firefly客户端连接不到Firefly服务器.......................................2

23使用常见问题.........................................................................3

2.3.1WINDOWS..........................................................................................................................................3

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

2)如何永久删除本地工作区.....................................................3

3)如何找回丢失的文件.........................................................4

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

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

6)修改目录名称................................................................5

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

8)出现error：找不到存储库....................................................6

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

10)打开工作区报"Anunhandledexceptionhasoccurredinyourapplication..6

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

12)执行bringover过程中报错："gidif:reachEOFinoriginal,expectmoredata.”.....9

并且日志的最后几行显示：“Error65687:Filetypeerror.Bringovercancelled”..............9

13)bringover对话框中，文件图标显示为：虏...................................10

确定后出现提示："Anunhandlcdexceptionhasoccurredinyourapplication.............10

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

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

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

17)提交文件时，提示“输入注释”..............................................H

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

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

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

21)设定Fireflyclient超时门限..................................................13

22)文件名大小写...............................................................13

23)命名避免使用的字符：................................13

24)关于文件过滤...............................................................13

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

笫III页

配置管理平台常见问题FAQ

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

2.3.2UNIX/LINUX....................................................................................................................................14

1）初始化工作区失败，createworkspaceunderanexistingonew................14

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

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

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

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

6）关键字转换.................................................................15

7）在工作区中执行bringover报错，报"javaJang.NullPointerException”.....................15

3FireflyServerExplorer常见问题..............................................................15

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

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

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

4）无法下载标记...............................................................17

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

6）使用命令下载标记...........................................................17

4集成Eclipse操作常见问题...................................................................17

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

2）在Eclipse中安装Firefly插件之后，"Firefly”菜单不出现，如何解决？..........17

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

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

5FireflyWeb常用功能........................................................................19

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

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

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

4）激活或者禁止Explorer集成.................................................21

6服务器端常见问题.........................................................................21

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

2）提高服务器速度.............................................................21

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

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

区21

第1V页

配置管理平台常见问题FAQ

1导言

本文档描述了在HanskyFirefly使用过程中，可能遇到的一些问题以及解决方法，作为使用Firefly

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

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

2FireflyClien常见问题

2.1安装常见问题

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

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

原因：

有可能是因为电脑里存在多个Framework版本（要检查是否存在多个版本，在“控制面板”中

的“添加/删除程序”甲杏看）

解决:

方案一：把“多个版本.NelFramework配置文件”文件夹下的4个config文件复制Firefly

安装目录下的\Qien八bin目录中即可。

方案二：在“控制面板”中的“添加/删除程序”，删除掉以前安装过的.NetFramework,,然

后再安装.NetFramework1.1版本。

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

tcom.hansky.apps.firefly.gui.fe.FileExplorer,threwanexception.w；

并且在配置FireflyClientSetting后保存时，报"Savelicenseconfigurationtilefailedw

ErrorX

Thetypeinitializerforvcom.hansky.apps.firefly,gui.fe.FileExplorer''threwanexception.

第1页

配置管理平台常见问题FAQ

解决:将.net和J#的1.1版本都卸掉；安装.net和J#的2.0扳本后重启计算机。

4)安装完firefly客户端后，运行程序时报："UnabletoloadDLL(vjsnativ)”

UnabletoloadDLL(vjsnativ).

匚麻豆二

解决：安装vjredist.exe。

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

解决：拷贝其他机器上已经安装好的FireflyClienl目录到这台机器上。注意安装路径要一致，否

则需要手动修改％色9丫％西丽丫\(3痴13叫ava中的hff.bat文件中的路径。

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

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

原因：

a)网络连接：

b)fireflyclientsetting问题

c)LicenseServer设置

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

第2页

配置管理平台常见问题FAQ

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

如下图所示：

解决:

a）检查网络是否连通；

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

c）LicenseServer：

方案一：若出现NoServerLicense问题：登录hltp://licenseserverip:8083察看是否有正确License；

登录hup:〃fireflyserverip:8081使用admin用户登录，点击"管理刷新服务港license"。

方案二：若出现NoLicenseavailable问题：检查客户端是否正确的设置\TireflyClientSetting,

中的参数：登录http:〃LicenseServerIP:8083,察看是否有正确的licensee

d）本机存在多个ip地址的情况下，连接firefly服务器时出现下列现象：使用Web可以登陆，但

使用客户端时弹出“找不到服务器”

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

hffsetrmc.client.usebindingtrue

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

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

rmc.cIient.usebindingfaIse取消绑定，而不是绑定为新的IP地址。

2.3使用常见问题

2.3.1WINDOWS

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

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

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

解决：

方案一：FirelfyClient端操作

第3页

配置管理平台常见问题FAQ

菜单“工作区一〉组织工作区一〉删除相应的工作区“

方案二：Firefly命令行操作

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

3）如何找回丢失的文件

问题：

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

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

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

解决：

a）FireflyClient-＞工具-＞显示丢失的文件一〉选择文件后，点击“获取”按钮

b）：FiretlyClient〉工具,显示已删除文件列表一〉选择文件后，点击撤销删除，如下图所示:

笫4页

配置管理平台常见问题FAQ

•、已文博越2£J

三

aO€u£T£CV«fd110M7-M22tom

SD€L£nOrwc/11M-10.130eitny

回D€LETfa”d11“dguM-10-1306i<ny

』

•dO€L£TED/i»d«19Ot-H-1102tom

yOCLETECMvd»1“dp，(M-10-B06i«ny

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

、

£@Cannotopenidve>dptotect修复不然打开一

臼$rc/diff.c1.1资他:srddiltc

DELETEO/:rc/ed<tc1116赊iroeditc____1

।国nsi$/e^_cmds.c12A[«rc/ex_cmdtc]C

Wsrc/Edit_newc10手加：src/Edit_neiG俄本比如

iffsrc/configurein1.1更新：“ckonfigW0撤消黑作1

冷其它交更集

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

解决:打开本地工作区中的.firefly目录，删除其中的lockfile文件，如果没有lockfile文件，则删除

properties.txt中的hansky.firefly.ws.lockport=*****此行，然后重新打开客户端

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

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

始化。

6）修改目录名称

解决：由于firefly是基于文件进行管理的，所以firefly工具不支持目录重命名，所以要修改目录名

称，只能建立一个新目录，并把原目录中的文件移动到新目录中。

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

效率较慢

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

解决：a）Windows客户端：打开客户端，选择：工具〉选项〉文件操作，当用户添加一个H录到Firefly

配置库中时，若选中复选框，目录中的隐藏文件将不会被添加进去，如下所示：

第5页

配置管理平台常见问题FAQ

8）出现error：找不到存储库

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

开Firefly的工作区。

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

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

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

10）打开工作区报“Anunhandledexceptionhasoccurredinyourapplication.****

笫6页

配置管理平台常见问题FAQ

FireflyClientfx"|

An'inhandledexceptionhasoccurredinyourapplication.

IfyouclickContinue,theapplicationwillignorethis

errorandattempttocontinue.IfyouclickQuit,the

applicationwillbeshutdownimmediately.

Objectreferencenotsettoaninstanceofanobject.

A:ContinueIQuit

Seetheendofthismessagefordetailsoninvoking人

just-in-time(JIT)debugginginsteadofthisdialogbox.

**************ExceptionText**************

System.NullReferenceException：Objectreferencenotsettoanins，

atcom.hansky.apps.firefly.client.core.IndexMaxiager.addlolndex

atcom.hansky.apps.firefly,client.core.IndexManager.applyLocal(

atcom.hansky.apps.firefly,client,core.IndexMan&ger.getLocalln*

atcom.hans城apps.firefly.gui.client.FireflyStatus.rebuildLoc：

atcom.hansky.apps.firefly.gui.client.FireflyStatus.reopen(Str：

V

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

1、确认fireflyclient的小版本号是否为：573（如下图所示）

2、确认以下两个插件的版本号是否一致：【Microsoft.NETFramework]fU[Microsoft

第7页

配置管理平台常见问题FAQ

VisualJ#.NETRedistributablePackage],

e若同时为1.1或2.0版本，则无需调整直接根据第3步进行排查；

e若［.NET］为2.0,而［J#］为其他版本……需安装□#】的2.0版本（获取路

径：7：用户名：fly；密码:flyfly；文件名：net2O.zip）

若［.NET］为其他版本，而［J#］为1.1——需将'多个版本.netFramework配置文

件.rar'解压后的四个文件，指贝到％firefly安装路径％的bin目录下即可；

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

3、首先：进入本地个人工作区目录，将.firefly中的两个目录剪切：content和metadata；

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

程序9MicrosoftOffice►

4Hansky3Firefly

迅雷软件►5FireflyClientSetting

Lb文档s►也1

HyperSnap6FireflyCommandLine(Java)

Q设置⑤>

Adobe►国FireflyServerExplorer

搜索©►

c：\FireflyCOBBandLineGTava)

Hansk</<R>FireflyClientConrnandShelluersion4.0forJaua

Copyright<C>HanskyInc.2006.Allrightsreserved.

Try'hff'formoreinfornation.

C：\ProgranFiles\Hansky\Firefl</\Client\bin>d：

D：21cdD：7M也个人工作区

D：\本地个人工作区》hffcheck-repair

程接到服务器

Stagingandlocalworkspaceareconsistant.

本地个人工柞区)

最后：重新运行fireflyclient；（若问题仍存在请进入第4步）

4、首先：进入本地个人工作区目录，将.firefly中changes目录中的内容剪切到他处:

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

笫8页

配置管理平台常见问题FAQ

福程序9MicrosoftOffice►

每Hansky］哺IFirefly►

（文档也）►E迅雷软件►击FireflyClientSetting

HyperSnap61cTFireflyCommandLine(Java)

设置⑤）►

Adobe►同FireflyServerExplorer

搜索©►

c：\FireflyCOBBandLine(Java)

Hanaky<R>Fivef1yClientCommandShe11URVJ;inn4-0FnviTaua

Copyright<C>HanskyInc.2006.Allrightsreserved.

Try'hff'formoreinformation.

C：XProgranFiles\Hansky\Firefly\Client\bin>d：

，\>|cdD：*地个人工作卤

D：\本地个人工作区>hFfcheck-repair

连接到服务器

Stagingandlocalworkspaceareconsistant.

D：\本地个人工柞区)

/

最后：重新运行fireflyclient。

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

解决：使用命令hffcheck-repair修复本地工作区。

12)执行bringover过程中报错："gidif:reachEOFinoriginal,expectmoredata.”

并且日志的最后几行显示："Error65687:Filetypeerror.Bringovercancelledw

笫9页

配置管理平台常见问题FAQ

FireflyClientLog.txt一记事本，!□1x|

文件鱼）编辑圾）格式©）查看包）帮助国）

Create:耿。喳辑数据楼型/仙2/殳计文档/初始存放同业机构表。60511.xls

Create:叫。晦辑数据模型/曲2/殳甘文超/潘春水2666G223关于增加同业机构代码的方案.

修改后.doc

create:映U嗨御数揖禊型/曲2暇计义梏/重要编码生成规则.IXI

Create:耿。晦辑数据模型/。43曜辑数据模型/CEB_EDW_Conceptual_LDM.ER1

Create:叫呵罗指数携橙型/G43睫辑数据,模型/CEB二EDW二LDM.ER1

Error65687:Filetypeerror.

Bringouercancelled

z\

解决：使用命令hffcheck-repair修复本地工作区。

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

确定后出现提示："Anunhandledexceptionhasoccurredinyourapplication.***n

第10页

配置管理平台常见问题FAQ

Bringover向导

-00320源系统资料凶

F003200数据字典整理

Bring。ver向导

Xm回口信贷酒管理急一I

Anunhandledexceptionhasoccurredinyourapplication.

IfyouclickContinue,th«applicationwillignorethis品苴系统

errorandattempttocontinue.IfyouclickQuit,the□□

+□D对公OCRM

applicationwillbeshutdo#nimmediately.

+□D影像平台

Objectreferencenotsettoaninstanceofanobject.因□D数据标准实施

E□亡I新一代核心业务;

+□D新个贷系统

+□□新园结系统

+□□理财产品代销系今

+□□票据系统

+□□管理合计系统।

mLlPp寸.左二I

I—I±r

包含醐除文件

<]:一(I下一步(£)>I取消I

解决：确认以下两个插件的版本号是否一致：【Microsoft.NETFramework］和【Microsoft

VisualJ#.NETRedistributablePackage］,

e若［.NET］为2.0,而［J#］为其他版本-―需安装［J#］的2.0版本（获取路径：

7；用户名:fly；密码:flyfly；文件名：net2.0.zip）

若［.NET］为其他版本，而［J#］为1.1--需将'多个版本.netFramework配置文

件.rar'解压后的四个文件，拷贝到％firefly安装路径％的bin目录下即可；

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

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

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

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

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

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

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

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

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

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

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

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

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

第II页

配置管理平台常见问题FAQ

解决：能够列出文件所有历史版本，并可以查看任意版本，选中文件，单击右键，选择“显示文件

历史”，出现历史选项，如下图所示：

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

即可。

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

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

较版本”，如下图所示：可以与前一版本进行比较，也可以选择其他版本，也可以选择其他

第12页

配置管理平台常见问题FAQ

文件，选择好文件单击“确定”即可。

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

解决：首先将本地工作区中该文件的最终版本备份出来，然后把该文件手动删掉（不通过firefly

操作），然后执行hfTundo,撤俏与该文件有关的操做；然后再把该工作区的该文件手动删

掉，然后再执行hffundo,直到与该文件有关的操作全部撤销为止。

21）设定Fireflyclient超时门限

解决：

a）hffsetnnc.client.connect.timeout〈毫秒〉

b）例如：hffsetrmc.client.connect.timeout1000

c）默认设置为2000

d）在网络环境不好时：

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

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

22）文件名大小写

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

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

24）关于文件过滤

解决：用户可以在Fireflyclient的工具一〉选项一〉文件操作下的“不添加至版本控制的文件类型”

内容夏选框中，设置不被添加到Firefly资源控制中的文件类型，如.bak,并选中“缺省使用

第13页

配置管理平台常见问题FAQ

文件过滤器”，如下图所示：

选项

通用文件镰作|当前工作区设置|第三方工具|

文件操作--------------------------------------

17使用关键字转换（K）r保持文件可写（短

r使用行结束符转换3）

CWindowsCViTIXCMacOS

r文件时间保持与服务器一致（D

r添加文件时保持文件时间（D

17执行Bringouer和提交时检查非法修改文件（0

r添加文件到版本控制中时跳过隐藏文件（即

厂保存本地变更之后释放编辑（锁定）信息（D）

文件过滤器

不添加至版本控制的文件类型（例如:*.bak,*.ds?）：

Ikbak

17块省使用文件过滤器（9

帮助®诵定|厂”…取消

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

解决：由于firefly和系统时间及时区有关，通常我们的电脑都用北京时区，而北京时区没有firefly

需要调用的类，所以可先将本机调整成其他时区，然后再调整回来即可。

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

解决：执行撤销编辑文件操作后，操作执行前已发生变更的文件被存放在％本地工作区目录％

\frefly\unedit\文件所在的目录名称'下，用户可以恢复在文件中已做的变更，但只有最新变

更的文件可被保存。

23.2UNIX/LINUX

1）初始化工作区失败，报错:"Can'tcreateworkspaceunderanexistingone”

解决：首先在网页hltp:〃fireflyserver:8（）81上察看基于该目录的中继工作区是否已经删除；然后用H

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

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

解决：使用命令hffhist〈文件名〉，可以显示指定工作区文件的历史版本包括文件的版本号，修改

第14页

配置管理平台常见问题FAQ

时间，修改人，修改注释等

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

解决：使用命令hffget-v＜要获取的版本〉〈文件名〉，可以获取指定工作区文件的历史版本

4）使用fi