Firefly 配置管理工具常见问题FAQ.docx
《Firefly 配置管理工具常见问题FAQ.docx》由会员分享,可在线阅读,更多相关《Firefly 配置管理工具常见问题FAQ.docx(23页珍藏版)》请在冰豆网上搜索。
Firefly配置管理工具常见问题FAQ
中国光大银行信息科技部
配置管理平台常见问题FAQ
版本V1.0
文档编号
保密等级
作者
最后修改日期
审核人
最后审批日期
批准人
最后批准日期
修改记录
日期
版本
作者/修改者
描述
审核人
2008-04-10
V1.0
创建文档
2008-06-23
V1.0
修订文档:
①增加2.7、2.8、2.9等章节
2009-01-09
V1.0
修订文档:
①增加常见问题标记;②增加第三章配置管理服务器的常见问题
1导言
本文档描述了在HanskyFirefly使用过程中,可能遇到的一些问题以及解决方法,作为使用Firefly的参考资料和指南。
本文档要时时维护,新遇到的问题随时添加,以便起到真正的指导作用。
其中红色字体为:
项目组成员在使用过程中经常出现的问题。
2FireflyClien常见问题
2.1安装常见问题
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;登录http:
//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目录中的内容剪切到他处;
然后:
进入firefly的命令行模式,执行修复工作区命令(如下图所示)
最后:
重新运行fireflyclient。
11)在解决合并冲突后用户没法checkin新的变更状态
解决:
使用命令hffcheck–repair修复本地工作区。
12)执行bringover过程中报错:
“gidif:
reachEOFinoriginal,expectmoredata.”
并且日志的最后几行显示:
“Error65687:
Filetypeerror.Bringovercancelled”
解决:
使用命令hffcheck–repair修复本地工作区。
13)bringover对话框中,文件图标显示为:
确定后出现提示:
“Anunhandledexceptionhasoccurredinyourapplication.…”
解决:
确认以下两个插件的版本号是否一致:
【Microsoft.NETFramework】和【MicrosoftVisualJ#.NETRedistributablePackage】,
若【.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步)
若同时为1.1版本------将两个插件全部删除重新安装,并保持同时为:
1.1
若同时为2.0版本------将两个插件全部删除重新安装,并保持同时为:
2.0
14)用户提交的文件不存在或“类型错误”
解决:
检查是否由于Firefly使用的服务器磁盘没有剩余空间引起。
15)“添加到版本控制”中不能直接检入
解决:
在将新文件“添加到版本控制”时,不要选择“保持检出”该默认选项
16)如果一次提交三万个以上文件,系统会产生错误
解决:
分批添加提交,每次添加提交文件少于三万个
17)提交文件时,提示“输入注释”
解决:
使用firefly工具提交文件时,要在注释中输入此次修改文件的目的,然后再选择提交
解决:
使用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<配置管理服务器地址>-proj<配置库项目名称>-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\:
\\ProgramFiles\\Hansky\\Firefly\\Client\\bin\\VDM.exe
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=********,把以前的服务器地址修改为新的服务器地址。