版本升级工具使用说明书c220v1.2.3p1t

1、技术文件文件名称：C220V1.2.3P1T6 版本升级工具使用说明书文件：版本：共页(包括封面)/日期 拟制/日期 审核批准/日期 中兴通讯有线目录.5.6.升级概述3升级准备3升级策略文件中的步骤函数说明3参数文件及各参数说明3日志错误信息说明，异常信息操作指导3注意事项3C220V1.2.3P1T6 版本升级工具使用说明书1.升级概述UpgradeParameter.csv 参数文件新增:VER:InputPara(rebootagain)参数：网元原始版本不是 1.2 版本时，是否在重启一次网元后再重启一次，1 表示再次重启一次，0 表示不再次重启目标网元版本：V1.2.

2、3P1T6初始网元版本范围说明：V1.2.1P1 V1.2.1P4 V1.2.1P5 V1.2.2 V1.2.3 V1.2.3P1 V1.1.3P3 V1.1.3P2T6 V1.1.3P4 V1.1.3T21 V1.1.3T14 V1.1.1EP3T8 V1.1.1ET12 V1.1.2P1T6 V1.1.2P1T7 V1.1.2T10 V1.2.1T9。GCSAS（主备主控板）：版本40 分钟 版本激活 22 分钟GCSA（主备主控板）：版本45 分钟 版本激活 22 分钟GCSD（主备主控板）：版本40 分钟 版本激活 22 分钟2.升级准备创建 FTP 服务ftp 的目录固定为：升级工具

3、目录下的 MAoUEtclscript项目ftpdir，升级的版本文件放在此目录下上传的配置文件目录：升级工具目录下的 MAoUEtclscript项目ftpdirbackup，在此目录下，自动按网元 ip 地址创建子目录，网元配置文件按网元 ip 地址为目录存放3.注意事项建议使用网元的带内地址进行升级健康检查为灰色不需要执行（实际在版本步骤中有检测策略）)4.升级策略文件中的步骤函数说明1、Check：检查是否能够通网元2、 neTypeCheck：检查网元主控板类型是否正确，将查询得到的主控板类型与输入参数中设定的:VER:InputPara(systemInfo)值做比对3、 neVe

4、rCheck：获取原始网元版本信息，保存到:VER变量中:InputPara(startVer)4、 startrunNameCheck：配置文件名称检测是否为 startrun.dat，如果不是 startrun.dat，所有检测内容的 warn 打印内容增加此步骤失败信息5、 hwonlineCheck：查询单板状态，状态为 hwonline 的单板，所有检测内容的 warn打印内容增加此步骤失败信息。如命令行执行失败终止升级。6、 controlcardS usCheck：查询主控板状态，如果备用板状态为 offline 继续执行下面操作步骤；如果备用板状态为 STANDBY 检测主备用

5、主控板同步版本操作是否能成功。如过同步版本不成功，所有检测内容的 warn 打印内容增加此步骤失败信息。如命令行执行失败终止升级。7、 p2pCheck：检查网元是否有 p2p 配置，p2p 配置，所有检测内容的 warn 打印内容增加此步骤失败信息。如命令行执行失败终止升级。8、 uplinkVlanLengthCheck：查询上联口 vlan 配置中 tag 的valn 配置字符串长度是否超过 256，超过 256，所有检测内容的 warn 打印内容增加此步骤失败信息。如命令行执行失败终止升级。9、 qinquplinkVlanHybridCheck：全局 qinq 使能时查询上联口 vl

6、an mode 配置是否为hybrid非hybrid 模式的，所有检测内容的warn 打印内容增加此步骤失败信息。如命令行执行失败终止升级。10、uplinkInsameVlanCheck：查询状态为 up 的上联口vlan 配置，是否有上联端口的在同一 vlan 中，所有检测内容的 warn 打印内容增加此步骤失败信息。如命令行执行失败终止升级。11、nonsupportCardCheck：查询网元中是否配置了不支持的单板类型（配置板类型）。成功返回true(不论检测结果是否符合升级要求都返回TRUE)，命令行失败返回 flase。12、13、14、warnInfoCheck：检测是否有 w

7、arning 信息，有终止升级过程NeConfigSave：ftp 上传网元配置文件configchangeSistic：统计原始版本的配置文件升级到新版本后有些配置不能生效，在新版本下需要执行多少条配置命令实现原来的业务。15、16、17、18、19、20、21、22、23、在 s 24、deleteNousefulVerfile：删除网元中不存在实际单板类型的版本文件downVer：版本updateboot：更新 bootmainBackupVerSyn：主控板版本主备同步saveProsConfig：将重启前信息保存至文件rerosConfig：从文件中重启前信息NeInfobefore

8、reboot：保存重启前网元状态信息NeReboot：重启系统Srebootponcard：reboot 网元后，下重启 epfc 和 epfcb 线卡epfc 和 epfcb 线卡状态为 hwonline，Slotsushwonlinecheck：检测是否有 hwonline 状态单板。没有 hwonline 状态单板返回 TRUE，有 hwonline 状态单板返回 warning. 所有检测内容的 warn 打印内容增加此步骤失败信息。如命令行执行失败终止升级。25、neVerCheckAfterReboot：网元重启后检测网元版本是否为目的版本。成功返回 true，失败返回 flase

9、26、27、patchProc：打热补丁neCheckRun：验证重启后网元状态。成功返回 true(不论比对结果是否符合升级要求都返回 TRUE) ， 命令行失败返回 flase 。比对结果不符合升级要求时:VER:InputPara(warnInfo)值添加检测结果不符合升级要求内容,检测结果符合升级要求时:VER:InputPara(warnInfo)值不变28、downotherver：EPFCB 版本文件（只对 1.1.1 的版本执行此步骤，因为1.1.1 版本不支持 epfcb 板，为兼容升级后能使用 epfcb 板，增加 epfcb 版本）29、warnInfoCheck：检测是

10、否有 warning 信息，有终止升级过程且返回错误5.参数文件及各参数说明1、:VER2、:VER3、:VER4、:VER5在:VER:InputPara(systemInfo)：网元类型，如 C220:InputPara(controlCardSlot) ：主备主控板槽位号:InputPara(ControlcardNumber)：主控板类型个数用于线卡板类型参数:InputPara(ponCardControl_0)：主控板类型用于线卡参数、:VER:InputPara(ponCardCfgType_0)：:InputPara(ponCardControl_0)参数表示的主控板类型下，这

11、里要列出所有线卡板类型。线卡板的配置板类型。格式为 EPFC EPFCB,用于与下一个变量结合确定不同线卡板类型使用哪个版本文件；用于判断哪些板类型需要做 p2p 配置判断（所有线卡板都要判断 p2p）,只有线卡板需要判断 p2p 配置，上联板不需要6、:VER:InputPara(ponCardVer_0)：在:VER:InputPara(ponCardControl_0)参数表示的主控板类型下，用于与上一个变量结合确定不同线卡板类型使用哪个版本文件.格式为一个内为某一个类型线卡板对应版本文件，有多个表示对应上一个参数中多个线卡单板类型EPFC.bt EPFC.FW EPFC.MVR EPF

12、CB.bt EPFCB.FWEPFCB.MVR7、:VER8在:VER:InputPara(ponCardControl_1)：主控板类型用于线卡参数:VER:InputPara(ponCardCfgType_1)、：:InputPara(ponCardControl_1)参数表示的主控板类型下，这里要列出所有线卡板类型。线卡板的配置板类型。格式为 EPFC EPFCB,用于与下一个变量结合确定不同线卡板类型使用哪个版本文件；用于判断哪些板类型需要做 p2p 配置判断（所有线卡板都要判断 p2p）,只有线卡板需要判断 p2p 配置，上联板不需要9、:VER:InputPara(ponCardV

13、er_1)：在:VER:InputPara(ponCardControl_1)参数表示的主控板类型下，用于与上一个变量结合确定不同线卡板类型使用哪个版本文件.格式为一个内为某一个类型线卡板对应版本文件，有多个表示对应上一个参数中多个线卡单板类型EPFC.bt EPFC.FW EPFC.MVR EPFCB.bt EPFCB.FWEPFCB.MVR10、:VER板参数11、:VER12在:VER:InputPara(otherCardControlNumber)：主控板类型个数用于非线卡主控:InputPara(otherCardControl_0)：主控板类型用于非线卡主控板参数、:VER:In

14、putPara(otherCardCfgType_0)：:InputPara(otherCardControl_0)参数表示的主控板类型下，除了线卡板和主控板的配置板类型,格式与线卡板类似,用于与下一个变量结合确定不同板类型使用哪个版本文件；用于那些板添加时配置的板子类型与实际版本名称不同的情况。如：EIG EIGM EIGF CE1B13在:VER控板的、:VER:InputPara(otherCardVer_0)：:InputPara(otherCardControl_0)参数表示的主控板类型下，除了线卡板和主版本,格式与线卡板类似,用于与上一个变量结合确定不同上联板类型使用哪个版本文件。

15、如：EEIEIG.MVR EEIEIG.MVR EEIEIG.MVR CE1B.bt CE1B.MVR14、:VER15在:VER:InputPara(otherCardControl_1)：主控板类型用于非线卡主控板参数、:VER:InputPara(otherCardCfgType_1)：:InputPara(otherCardControl_1)参数表示的主控板类型下，除了线卡板和主控板的配置板类型,格式与线卡板类似,用于与下一个变量结合确定不同板类型使用哪个版本文件；用于那些板添加时配置的板子类型与实际版本名称不同的情况。如：EIG EIGM EIGF CE1B16在:VER控板的、:

16、VER:InputPara(otherCardVer_1)：:InputPara(otherCardControl_1)参数表示的主控板类型下，除了线卡板和主版本,格式与线卡板类似,用于与上一个变量结合确定不同上联板类型使用哪个版本文件。如：EEIEIG.MVR EEIEIG.MVR EEIEIG.MVR CE1B.bt CE1B.MVR17、:VER18、:VER如 V1.1.3P4 19 、:VER:InputPara(downtime)：版本失败时，反复尝试的次数:InputPara(newVer)：用于判断新版本是否成功的网元版本号，:InputPara(patchverlist) ：

17、 新版本的所有热补丁文件名。 如：GCSAS_r4.pat EPFC_r1.pat EPFCB_r1.pat20、:VER置板类型21、:VER22在:VER:InputPara(uplinkCardControlNumber)：主控板类型个数用于上联板的配:InputPara(uplinkCardControl_0)：主控板类型用于上联板的配置板类型:VER:InputPara(uplinkCardCfgType_0)、：:InputPara(uplinkCardControl_0)参数表示的主控板类型下，上联板的配置板类型（即除了线卡板主控板和 CE1B 和CL1A 板的单板）23、:VE

18、R24在:VER:InputPara(uplinkCardControl_1)：主控板类型用于上联板的配置板类型、:VER:InputPara(uplinkCardCfgType_1)：:InputPara(uplinkCardControl_1)参数表示的主控板类型下，上联板的配置板类型（即除了线卡板主控板和 CE1B 和CL1A 板的单板）25、:VER26、:VER:InputPara(startVerUsed)：原始版本列表:InputPara(nonsupportCardControlNumber)：主控板类型个数用于不支持的配置板类型参数27、:VER类型参数28在:VER配置板类型29、:VER类型参数30在:VER配置板类型31、:VER32、:VER:InputPara(nonsupportCardControl_0)：主控板类型用于不支持的配置板、:VER:InputPara(nonsupportCardCfgtype_0)：:InputPara(nonsupportCardControl_0)参数表示的主控板类型下，不支持的:InputPara(n