维护红宝书自动升级和自动更新的说明文档.docx
《维护红宝书自动升级和自动更新的说明文档.docx》由会员分享,可在线阅读,更多相关《维护红宝书自动升级和自动更新的说明文档.docx(18页珍藏版)》请在冰点文库上搜索。
维护红宝书自动升级和自动更新的说明文档
维护红宝书:
自动升级和自动更新的说明文档
文档记录:
版本
时间
修改者
描述
1.0
2007-07-04
田进恩
2.0
2008-7-15
田进恩
加入FAQ
2.1
2008-10-30
田进恩
加入自动文件更新的说明
2.2
2010-12-16
田进恩
加入通过行情主站升级的注意点
2.3
2012-6-30
田进恩
加入新升级方式(静默,按时间段,按产品)
程序安装文件的自动升级
1.自动升级工具Autoupex
客户端安装包中的Autoupex程序除支持新的按文件分别升级方式外,也支持老的按ZIP包升级方式。
如果要需要升级autoupex.exe文件本身,请将之改名为autoup1.exe放在升级包或升级目录下。
如果是带皮肤文件的升级工具,除了autoupex.exe改名外,也需要将res_autoup.dll改名为res_autoup1.dll放在升级包或升级目录下。
升级程序V2(需定制)
1.支持先下载升级包再升级,非交易时间或程序退出后仍后台升级,下次启动时完成升级。
2.支持流控
3.提高升级过程的稳健性
4.支持某版本前不提示安装,支持强制、静默、提示等升级方式
5.全新的升级界面,简洁易用,支持换肤,过程中支持图片轮播等
2.ZIP包方式进行整体升级
对于ZIP包升级方式,直接将要升级的所有文件打一个zip包(注意:
不要在zip包里面再打了一个同名目录,直接将这些文件打包),同时要人工制作一个同文件名的txt文件,这个txt文件只写明此次升级的版本号,这个版本号要与行情主站中的autoupinfo*.txt中设置的此次升级的版本号一致。
将这两个文件放在网站上同一个目录,同时在autoupinfo*.txt中指明这个URL路径。
注意:
如果对升级过程不非常清楚的情况下,建议按ZIP包方式进行升级。
3.按文件进行分别升级
自动升级文件制作工具AutoMakeUpdateInfoFile
用以下自动升级文件制作工具来处理:
a)将需要更新的文件放在一个目录下,设为文件本地目录注意:
目录下必要包含一个tdxw.daq,这个文件中配置的必须是本次升级的版本号。
b)新的升级除了提供txt文件(记录各文件的信息),还必须在txt同目录下放一个目录,这目录下放所有的可能需要更新的文件。
如果考虑到兼容性,也可以将此目录打成一个zip包,放在网站上(同原来一样)
c)输入本次的升级版本号。
目录下的tdxw.daq里也必须是这个版本号
d)点击生成开始生成txt文件
e)将生成的txt文件,zip文件(可选)以及整个升级文件目录都放在设置的URL下。
注意:
不要随便人工改动AutoMakeUpdateInfoFile生成的文件的大小写属性
注意:
一般情况下不推荐按文件分别进行升级。
如果存在汉字名的文件,则通过linux主站来按文件升级,会存在文件,不建议所以汉字文件名。
4.在行情主站里制作autoupinfo*.txt信息文件
制作方式同原来一样。
autoupinfo.txt特别集成版类型(比如招商新交易版)
autoupinfo2.txt普通集成版类型
autoupinfo3.txtLinux行情客户端类型,此时指定的不是URL,而是本地一个目录
autoupinfo4.txt普通集成版繁体版类型
autoupinfo5.txtVIP终端版本类型
autoupinfo6.txt特别集成版类型(由客户端的connect.cfg来决定)
autoupinfo….
此处决定用哪一个autoupinfo,取决了客户端connect.cfg中的[Other]域下面的WhichAutoUpInfo的配置。
注意:
如果WhichAutoUpInfo为1,则较特别,不是配置autoupinfo1.txt,而是配置autoupinfo.txt
尽管不一定有zip文件,在URL地址中也应该写成这个zip(主要是为了同以前的方式兼容)。
Win行情主站建议使用界面来生成。
Linux行情主站也可以将Win行情主站生成好的文件拷贝过来,也可以直接编辑autoupinfo*.txt文件。
格式如下:
6.0100
3.0000ExceptTradeTime
.100/new_zszq_autoup.zip
升级包说明
6.01表示是此次升级的版本号,3.00表示是必须强制升级的临界版本号(低于或等3.00版本的都会强制升级),有ExceptTradeTime字串表示在交易时间不提示升级。
对于升级,二代行情的交易时间是指[交易行情日:
9:
00-11:
4012:
50-15:
30],如果行情不是当日行情(比如周末),也不算是交易时间。
交易日的判断标准是指:
行情主站使用的行情日期是今天的日期(很多券商在测试升级时行情主站使用的不是今天的运行环境,所以在测试ExceptTradeTime就可能无效)
如果不设置升级说明的话,则客户端不弹出升级提示,只用于人工点“自动升级”才会升级。
注意:
设置好autoupinfo*.txt后,行情主站必须要重启才能生效
5.行情主站中与升级相关的设置
hostl.ini的相关设置
[Auth]
NeedAuth_ConnectNum=10000
;需要验证的连接数,当超过此值后,客户端的进入需要验证,缺省为10000
JYTimeAuth=1
;是否只在交易时间进行验证,为0表示在任何时间验证
LimitMinVer=0.0
;如果客户端的版本小于这个值,则不能使用此客户端
MustSameQSID=0
;客户端是不是需要必须与行情主站的QSID匹配
6.通过行情主站升级
通过行情主站的autoupinfo*.txt来控制,在其中第二行中加入“AutoupFromHQHost“的字样(主站版本为
6.0100
1.0000ExceptTradeTimeAutoupFromHQHost
.100/new_zszq_autoup.zip
升级包说明
同时将生成的txt文件,zip文件(可选)以及整个目录放在hostl所在目录下面的[update]下面
自动升级程序进入时会在第一个界面上说明“从行情主站上进行升级”(如下图)
关于通过行情主站升级的注意点:
●一般情况下不推荐通过行情主站升级。
●注意:
如果你的客户端是5.82以下版本的话(Autoupex.exe也是老版本的话):
通达信的高级Level2行情主站不支持通过行情主站升级(Update中读取的主站可能不一致,并且后台部署麻烦)。
本站当成VIP行情主站或当成试用主站来使用时也不支持通过行情主站升级(Update读取的站点可能不一致)。
●当采用通过行情主站来升级时,建议所有的行情主站都一次性配置好升级包,不要一部分配置一部分不配置(或配置成老的升级文件),这样有可能造成从配置成老的升级文件的主站上进行升级新版本,造成升级出错。
还有一个可能是:
行情主站对外是一个均衡器,均衡器站后有的主站配置了升级包,有的没有配置,这样也有可能造成读取错误的升级包。
7.如何配成不提示升级但人工点”自动升级”可升级的方式
如果在autoupinfo*.txt中不配置升级描述的话,则不弹出升级说明框,只能在"系统"->"自动升级"。
内核在5.693以上的(含5.693)才支持。
如果设置有静默升级时,同时设置有TIME时间段的话,在没有到达时间段时,可以通过点击"系统"->"自动升级"。
内核在5.82以上的(含5.82)才支持。
8.一些每次运行都将拷贝到T0002下面的文件
user.ini(用户个性化文件)
user_def.ini(缺省的用户个性化文件)
syscomm.ini(系统通讯配置文件,比如查找最快之类的)
Scheme.dat(系统配色方案)
PriCS.dat(公式文件)
PriGS.dat(公式文件)
hqtab.dat(行情分类TAB配置)
morehint.html(资讯级别不够时的提示网页文件)
stdqs.cfg(标准券商的资讯配置)
*tree*.cfg(券商的资讯树网页配置)
由于这些文件会自动拷到T0002下,所以需升级这些文件的话,只需要直接放在升级包中(不需要再在升级包中建一T0002目录放进去)
9.新5.82内核和新Autoupex支持的升级
新升级模式的前提:
主站在6.031以上版本。
客户端为5.82以上内核。
autoupinfo*.txt中的第四行的设置:
APP:
ALL,都明显提示
APP:
NONE,都不明显提示
APP:
101,120提示的包括产品集,如果用户的任一个产品串都不在里面,也不明显提示
如果APP:
后面有HINTVER3.00,这样的字样,则表示小于3.00的版本才会明显提示
autoupinfo*.txt中的第五行的设置(最多支持3段)
TIME:
0:
10-8:
30,11:
30-12:
40,15:
30-23:
40
静默升级设置:
●如果服务器的autoupinfo文件中的第二行有Silent字样,则在后台进行升级(不提示)。
(客户端会在满足提示时间段的1-11分钟内(随机),开始进行升级。
)
●如果服务器的autoupinfo文件中的第二行有DownSilent字样,则对低于强制升级版本号的客户端在后台进行升级(不提示),高于强制升级版本号的客户端还是进行提示升级。
如果是在周末,时间段控制无效。
注意点:
1.如果要设置TIME,就必须要有第四行的APP设置
2.如果是需要强制升级的话,与APP无关,也与TIME无关
例如autoupinfo28.txt的设置
2.0000
1.0000Silent
.100/new_zszq_autoup.zip
APP:
HINTVER1.40,101,120,
TIME:
0:
10-8:
30,11:
30-12:
40,15:
30-23:
40
以下为升级包说明内容
该设置的解释:
1.00及以下的版本强制设置;
1.40以下的版本提示升级;
2.00以下的版本可以人工升级;
采用静默方式;
在0:
10-8:
30,11:
30-12:
40,15:
30-23:
40这三个时间段随机启动升级;
只对有101,120这两个产品(如果有AppStore逻辑的话)的用户提示升级;
10.V6.187行情主站支持某个版本之后的升级
Win主站的界面设置
比如以上的设置,客户端版本在6.27-6.28间的才升级
Linux主站的设置
在autoupinfo*.txt的第一行设置成
6.28From6.27
就指定只升级6.27到6.28间的版本其它的不受影响
11.升级程序启动主程序时的操作
根据connect.cfg中的[Other]域的设置
如果设置有自动升级后自动创建本程序的桌面快捷方式的话
AutoupMakeLinkName=
如果设置有删除的快捷方式的话
AutoupDeleteLinkName1=
AutoupDeleteLinkName2=
如果设置有删除的某个文件的话
AutoupDeleteFile1=
AutoupDeleteFile2=
如果设置有执行的某个文件的话
AutoupRunFile1=
AutoupRunFile2=
12.升级完成后,如何做一个执行类操作
以更换上级目录的壳程序为例:
新的某个下辖的版本的客户端的升级包中放2个文件一个shellup.bat文件,一个需要覆盖新的TdxMerge.exe
同时在这个升级包中的connect.cfg中配置一下
[other]
AutoupRunFile1=shellup.bat
shellup.bat文件中这样写:
copy/yTdxMerge.exe..\
13.升级包的文件注意之处
T0002下面的user.ini(个性化文件)和scheme.dat(用户界面颜色方案)都不要放到升级包和安装包中,安装包中要放user_def.ini和scheme_def.ini。
不然容易覆盖用户的个性化设置。
程序配置文件的自动更新
1.怎样自动更新主站的配置列表
制作newhost.lst文件,其格式同connect.cfg中的行情主站,资讯主站,扩展行情主站,交易主站,VIP交易中心和绿色通道等,如下:
//行情主站
[HQHOST]
HostNum=2
HostName01=招商证券深圳行情一
IPAddress01=
Port01=7709
Weight01=
Areas01=
Yybids01=
HostName02=招商证券深圳行情二
IPAddress02=
Port02=7709
Weight02=
Areas02=
Yybids02=
//资讯主站
[INFOHOST]
HostNum=2
HostName01=招商证券深圳资讯一
IPAddress01=
Port01=7711
Weight01=
Areas01=
Yybids01=
HostName02=招商证券深圳资讯二
IPAddress02=
Port02=7711
Weight02=
Areas02=
Yybids02=
//扩展行情主站1
[DSHOST]
HostNum=2
HostName01=招商证券深圳一
IPAddress01=
Port01=7727
Weight01=
Areas01=
Yybids01=
HostName02=招商证券深圳二
IPAddress02=
Port02=7727
Weight02=
Areas02=
Yybids02=
//扩展行情主站2
[DSHOST2]
HostNum=2
HostName01=招商证券深圳一
IPAddress01=
Port01=7727
Weight01=
Areas01=
Yybids01=
HostName02=招商证券深圳二
IPAddress02=
Port02=7727
Weight02=
Areas02=
Yybids02=
//绿色通道
[TDXPROXY]
IP=
DESC=北京网通
Port=443
IP2=
DESC2=北京电信
Port2=443
//试用行情站点
[TRYHQHOST]
HostNum=2
HostName01=试用站1
IPAddress01=
Port01=7709
Weight01=
Areas01=
HostName02=试用站2
IPAddress02=
Port02=7709
Weight02=
Areas02=
[TQHOST]
;5.694以上内核行情才支持TQ主站的自动更新
HostNum=2
HostName01=TQ试用站1
IPAddress01=
Port01=7713
HostName02=TQ试用站2
IPAddress02=
Port02=7713
[CWSYS]
CWHostNum=2
CWHostName01=通达信服务器1
CWHost01=
CWPort01=7722
CWHostName02=通达信服务器2
CWHost02=
CWPort02=7722
[TPSYS]
TPHostNum=2
TPHostName01=通达信服务器1
TPHost01=
TPPort01=7615
TPHostName02=通达信服务器2
TPHost02=
TPPort02=7615
;如果CWSYS下的HasAddition为1的话,SMT和Timeout才会进行自动更换
[CWSYS]
HasAddition=1
SMT=5
TimeOut=5
[TPSYS]
SMT=5
TimeOut=5
制完newhost.lst后,再制作customcfg_*.zip文件(这个文件在打安装包时确定)
这个zip文件中安装newhost.lst文件,然后将customcfg_*.zip文件放在已安装所有行情主站的目录下.下次客户端重进时会自动更新主站列表。
newhost.lst中,如果是V6版本,交易和VIP交易中心的地址也会更新到eTrade.xml(eTrade.xmb)的相应位置,如果交易中心列表中有HostType等特别的附加特性,则不建议通过newhost.lst来升级,直接将eTrade.xml放在custom*.zip中进行自动更新。
2.其它配置文件的自动更新
通过customcfg_*.zip文件自动更新。
(不同的券商或版本配置的这个文件的文件名不一样,具体要看客户端的connect.cfg中的[Other]域下的OtherFileName的配置),可以实现很多文件的自动更新。
主要有以下两类:
●本来就应该放在T0002目录下面的文件,比如各大券商的资讯链接配置文件,比如:
xytree*.cfg,
zstree*.cfg
morehint.htm…
●应该放在主程序目录下的几种特别文件,比如:
jyfx.txt
lcxy.txt
jjfx.txt
lcfx.txt
zzfx.txt
ksfx.txt
welcome.bmp
logo.jpg
oem.bmp
oem.cfg
qscomte.dat
dsmarket.dat
dsys.dat
declare.txt
load.bmp
autoupex.exe
embui.dat(此文件不能错,否则不能登录)
pages.zip->拷贝到pages目录下
jspages.zip->拷贝到jspages目录下
figs.zip->拷贝到figs目录下
CTPMore.ini->拷贝到QHPlugins目录下
CTPMore.xml->拷贝到QHPlugins目录下
qh_jspage.zip->解压到QHPlugins目录的qh_jspage下
tc_jspage.zip->解压到TCPlugins目录的tc_jspage下
funcs_jy.zip->解压到funcs_jy目录下
files.zip->解压到files目录下
yht.zip->解压到yht目录下
对于交易V6版本,也支持eTrade.xml(包括eTrade.xmb)和TcOem.xml(包括TcOem.xmb)的自动更新,支持jyfx.txt,,lcfx.txt,zzfx.txt,ksfx.txt等文件更新到TCPlugins目录。
同时支持资源文件res*.dll的自动更新。
如果有pages.zip,jspages.zip,figs.zip在这个custom*.zip中,在自动更新时会将解压到主目录的pages,jspages,figs目录(很多券商有此目录用于首页)
customcfg*.zip这个文件更新的条件:
本地的这个文件同hostl上的这个文件内容有变化
通过CacheFileName和CacheFileName2文件自动更新。
connect.cfg中的CacheFileName和CacheFileName2如果有配置的话,也会采用同customcfg*.zip一样的自动更新策略。
首先要有配CacheFileName,再配CacheFileName2才有效。
CacheFileName配置的文件需要放在主站的xml目录下,如果配的是flash.zip的话,下载到客户端的T0002目录下面,如果配的是pytp.zip的话,下载到客户端的figs/pytp目录下。
配的是其它的话,下载到客户端的T0002/hq_cache目录来。
CacheFileName2配置的文件与CacheFileNameg一样(只是对于方正决策版时,需要放在主站的signals目录下,在客户端里面下载到T0002/signals目录下来)。
CacheFileName或CacheFileName2如果设置为flash.zip的话,一般包括下面文件:
tdxflash.css(flash样式文件)
logoflash.htm(登录界面的广告网页)
logoflash.swf(登录界面的广告Flash)
qsflash.htm(滚动条的广告网页)
qsflash.swf(滚动条的广告Flash)
关于升级的几处注意点
1.升级包需按照最新的安装包制作,升级包中不能加入AutoupEx.exe文件。
如果用zip方式升级时,还需制作一个与升级包同名的txt文件,里面是本次升级版本号,该版本号需与升级包内版本号一致。
2.若客户端AutoupEx.exe版本太老,可在custom*.zip中加入AutoupEx.exe文件,客户端进入后先更新AutoupEx.exe文件,再用这个AutoupEx.exe来完成升级。
3.在后台启用升级前,行情主站中custom*.zip包中需替换最新安装包中的相应文件,主站列表也应与最新升级包和安装包中一致。
否则会造成升级成功后再进入客户端,有些文件又被还原成老的文件。
如果只变更custom*.zip的话,每次发custom*.zip包后,需要将部署在线上的自动升级包中的对应文件也更新成一样(只改自动升级包中的对应文件,不动升级版本号),以保证用户启动AutoupEx升级得到的也是最新的文件。
4.打zip包请使用标准的Winrar和WinZip,zip压缩文件中直接就是各个文件或目录(请不要再加一层目录),请勿使用其它解压缩软件来打zip包,否则可能在升级过程中解压失败。
常见问题FAQ
●出现以下的问题如何解决?
原因1:
对应的网站或主站update目录下没有发?
.txt文件,下载不到这个txt文件。
原因2:
早期的自动升级程序的版本(V1.03以前)将所有的URL转成了小写的,如果实际网站升级URL中有大写的字符的话就会下载txt失败。
●在主站的autoupinfo*.txt中没有设置从主站升级,结果在升级时还是提示从主站升级。
是何原因?
原因:
行情主站的版本太旧,请更新至新版本。
●自动升级过程中,报某文件升级失败,是何原因?
原因1:
网络故障,请求不了这个文件。
原因2:
下载的zip文件不是一个合法的压缩格式,解压失败。
原因3:
zip文件包里面有一个autoupex.exe文件,autoupex.exe覆盖正在执行的autoupex.exe程序失败。
这种情况一般是由于升级包制作人员没有将升级包zip中的autoupex.exe文件改名为autoup1.exe。
原因4:
升级之前,tdxw.exe或交易exe还没有完全退出。
●自动升级完成后,程序文件没有得到任何更新变化,是何原因?
有可能是升级zip文件的压缩包格式有问题或没有完全上传完成,造成下载回来的zip包不能正常解压。
(有可能在某些机器上解压失败,有些机器上解压成功)
●为什么我在客户端设置的whichautoupinfo为7,在主站端也设置了相应的autoupinfo7.txt,但取的版本不对,是什么原因?
是主站没有升级成最新的版本,原来的版本只支持6个whichautoupinfo,新的不受限制,可以支持125个。