17 ADCampus五期版本升级操作指导V500R001B01升级

文档密级【内参】ADCampus五期版本升级操作指导(V500R001B01升级V500R002B01)TIME\@"yyyy'年'M'月'd'日'"2020年8月11日新华三机密，未经许可不得扩散第页新华三技术有限公司H3CTechnologiesCo.,Ltd.解决方案名称Solutionname密级Confidentialitylevel解决方案ADCampusV500R002B01内参解决方案版本Solutionversion共43页Total43pagesV500R002B01ADCampus五期版本升级操作指导(V500R001B01升级V500R002B01)配套SNACenter-E1205版本拟制宫玉09965日期2020/6/17评审人日期批准日期新华三技术有限公司NewH3CTechnologiesCo.,Ltd.版权所有侵权必究Allrightsreserved

修订记录RevisionRecord日期修订版本修改章节修改描述作者2020/5/18V1.0全文初稿完成宫玉099652020/5/21V1.1全文刷新SNACenter的R2配套为E1205宫玉099652020/6/1V1.23.11SNAE1205配套的licenseserver登录方式切换为https，端口号28443宫玉099652020/6/17V1.3全文根据用服二线意见更新宫玉099652020/8/3V1.4全文3.6.2step6中命令行应为/sbin/netconf-cli--save（save前有两个-）宫玉099652020/8/11V1.55注意事项增加6，当SNACenter备份或恢复失败时，根据附件文档操作排查。宫玉09965

目录1 概述 1-71.1 升级目标 1-71.2 升级顺序 1-71.3 组网模型 1-81.4 配套版本 1-92 升级前准备工作 2-102.1 版本准备 2-102.2 R1版本数据备份 2-102.2.1 组网信息备份 2-102.2.2 License备份 2-102.2.3 设备配置备份 2-112.2.4 SNAInstaller集群数据备份 2-112.2.5 SNAInstaller各组件安装包备份 2-112.2.6 SNACenter数据备份 2-122.2.7 SeerEngine-Campus数据备份 2-122.2.8 iMC数据库备份 2-142.2.9 微软DHCP插件备份 2-142.2.10 vDHCP数据备份（手工备份） 2-143 升级实施 3-153.1 卸载license并存档卸载文件 3-153.2 升级设备版本 3-163.3 升级iMC各组件 3-163.4 升级微软DHCP插件 3-163.5 升级SNACenter（卸载重装组件方式升级） 3-173.5.1 替换postUninstallHook.sh脚本 3-173.5.2 卸载R1版本SNACenterE1106 3-183.5.3 安装R2版本SNACenterE1205 3-193.6 升级vDHCP 3-203.6.1 升级vDHCP到R2版本 3-203.6.2 重建数据 3-203.7 升级SeerEngine-Campus 3-233.8 修改EIA的控制器参数 3-233.9 检查控制器业务状态 3-243.10 升级SNAInstaller到R2版本（重装ISO方式升级） 3-243.10.1 R2版本数据备份 3-243.10.2 重装ISO（安装V5R2版本的SNAInstaller） 3-273.10.3 搭建SNAInstaller集群 3-273.10.4 恢复SNAInstaller集群数据 3-283.10.5 恢复SNACenter 3-343.10.6 恢复vDHCP 3-363.10.7 恢复SeerEngine-Campus 3-363.10.8 数据恢复后检查控制器业务状态 3-373.11 迁移license 3-383.12 恢复控制器license连接 3-403.12.1 SNACenter重新连接LicenseServer。 3-403.12.2 SeerEngine重新连接LicenseServer 3-403.12.3 查看LicenseServer上的license使用情况 3-413.13 验证所有现网业务 3-414 升级回退（仅用于升级失败情况下恢复现网数据） 4-414.1 卸载license 4-414.2 iMC回退 4-424.3 微软DHCP插件回退 4-424.4 SNAInstaller回退 4-424.5 SNACenter回退 4-424.6 vDHCP回退 4-424.7 SeerEngine-Campus回退 4-424.8 设备版本和配置回退 4-434.9 license迁移 4-434.10 验证业务回退情况 4-435 注意事项 5-43概述升级目标将用户ADCampus网络的配套版本从V500R001B01升级到V500R002B01。升级顺序Step1：R1版本数据备份Step2：卸载licenseStep3：升级设备版本和iMC组件至R2版本Step4：升级SNACenter（卸载重装组件方式）至R2版本Step5：升级vDHCP至R2版本Step6：升级SeerEngine-Campus至R2版本Step7：升级SNAInstaller（重装ISO方式）至R2版本Step8：迁移license并恢复LicenseServer连接Step9：验证现网业务组网模型本文以五期R1配套版本的的组网和业务已经配置完成为前提进行介绍。具体配置方法请参考五期R1的相关配置指导。配套版本产品/组件升级前版本（R1配套）升级目标版本（R2配套）SNACenterE1106E1205SeerEngine-CampusE3103P05E3202vDHCPE1104R1108微软DHCP插件2.33.1iMC-PLATE0703H01E0703H01（无需升级)iMC-EIAE0604H04E0611P02iMC-EADE0604H01E0611H01iMC-WSME0602E0602（无需升级)S12500-S/S7500EE7591P04E7593P02无线ACRelease5426P02Release5430P01S5130-EIRelease3506Release3506（无需升级)升级前准备工作版本准备升级前需要准备好R1和R2的各产品配套版本,详见章节1.4配套版本。其中R2的版本用于本次升级，R1的版本用于升级失败情况下各产品数据的回退。R1版本数据备份升级前必须对现网R1版本的相关数据进行全面备份，用于升级失败情况下的数据恢复。组网信息备份升级前需要全面梳理并存档现网的组网配置信息，重点包括如下信息：各产品版本信息；设备IP地址信息和自动化模板中的地址池配置；LicenseServer登录信息、客户端配置信息、License文件信息；SNAInstaller集群信息（北向IP、集群内部IP）、SNAInstaller各个节点IP和登录信息；SNACenter用户信息、组件信息、网络配置信息、license连接信息；SeerEngine-Campus各个节点IP、集群IP、license连接信息；vDHCP各个节点IP和集群IP；iMC主机和冷备机的组件信息、IP地址、登录信息。License备份备份并存档现网使用的正式license文件。设备配置备份备份并存档现网所有设备的配置文件。SNAInstaller集群数据备份登录SNAInstaller页面(https://cluster_ip:8443/matrix/ui/)，单击[部署>备份恢复]菜单项，点击<开始备份>，备份SNAInstaller集群配置信息和应用的配置信息，备份完成后点击下载备份文件。SNAInstaller各组件安装包备份由于SNAInstaller数据备份过程中，未对应用安装包进行备份，为保证升级过程中出现问题能够及时回退版本，故需备份一份应用安装包到本地。请使用FTP传输工具连接登陆SNAInstaller的任意节点，将/opt/matrix/app/install/packages路径下当前已安装的R1版本对应的应用安装包备份保存至本地。需要导出SNACenter、SeerEngine-Campus和vDHCP的zip安装包。(图片仅供参考，请以实际环境为准)SNACenter数据备份浏览器地址栏输入http://cluster_ip:10080/portal/登录SNACenter页面，单击[系统>设置>备份恢复]菜单项，勾选SNACenter，开始备份应用数据。备份完成后点击下载，下载SNACenter组件的备份文件到本地。SeerEngine-Campus数据备份R1版本的SeerEngine-Campus无法直接在SNACenter中备份，需要跳转到SeerEngine-Campus隐藏页面进行备份。方法如下：Step1：登录SNACenter，在主页点击[系统>设置]。Step2：在设置页面点击[组件>园区网络>VCFC-Campus]右侧的组件详情按钮。Step3：在组件详情页面，点击[跳转]链接。Step4：页面会跳转到VCFC的页面，点击右上角的齿轮按钮。Step5：在[系统>备份恢复]页面进行备份，并导出备份文件归档。iMC数据库备份登录iMC后台，在监控代理进行数据库备份和归档。（主机和备机均需要）备注：1.如果是单机，备份的数据建议拷贝到本地。2.如果涉及到定制开发短信平台等相关定制，还需要备份安装目录，升级后检查相关定制功能是否可用。微软DHCP插件备份登录微软DHCP后台操作系统，将dhcp-plug-windows\server\imf\server\conf目录下的四个文件(dhcp_agent.cfg、imf.cfg、plugin.cfg、qvdm.conf)进行备份归档，防止数据丢失。其中dhcp_agent.cfg和qvdm.conf文件为原始文件，plugin.cfg和imf.cfg文件为DHCP服务器被控制器纳管后生成的文件。备注：微软DHCP主机和备机均需要进行备份归档。vDHCP数据备份（手工备份）R1版本的vDHCP无法直接在SNACenter中备份，需要登录vDHCP后台的docker容器将startup.xml文件导出进行备份。方法如下：Step1：登录vDHCP所在的节点Linux后台。Step2：进入/opt/matrix/app/data/vDHCPS/etc/cfg目录Step3：将startup.xml和startup.cfg下载到本地归档。备注：vDHCP的主机和备机均需要进行备份并分别归档。升级实施卸载license并存档卸载文件由于后面升级SNAInstaller时需要重装ISO，R1安装的licenseserver跟SNA共用服务器，重装时会被覆盖掉，为了避免重装ISO后，原先的license失效，需要在升级前将license卸载并存档。等ISO重装后再迁移。License卸载方法如下：Step1：登录LicenseServer，单击[License/安装]菜单项，进入激活文件管理页面。Step2：选定激活文件，在“操作”区段首先单击按钮，使激活文件进入已卸载状态，然后单击按钮（中间位置），导出卸载文件并保存。备注： 1.license需要使用正式license进行迁移操作。 2.license卸载需要在重装ISO之前进行。参照本章节3.1步骤即可。 3.license迁移需要等重装ISO之后再进行操作，方法详见章节3.11升级设备版本将设备版本升级到R2配套版本。备注：建议先升级设备版本，再升级控制器版本。升级iMC各组件将iMC各组件升级到R2配套版本。备注：iMC主机和冷备机均需要升级版本，升级后点击“校验“，确保主备机版本一致。升级微软DHCP插件微软DHCP插件与SeerEngine-Campus强相关，需要升级到R2B01配套的3.1版本。升级方法如下：Step1:打开旧版本插件安装目录，双击运行uninstall.bat文件，进行卸载旧版本插件的操作。Step2:在“服务”列表中找到“DHCPServer”服务并右键单击该服务，选择“停止”选项。Step3:将章节2.2.9中备份的文件(dhcp_agent.cfg、imf.cfg、plugin.cfg、qvdm.conf)复制到新版本的dhcp-plug-windows\server\imf\server\conf目录下。Step4:双击运行install.bat文件安装新版本的DHCP插件。Step5:进入“服务”选项，启动“DHCPServer”服务。Step6:HA模式下，升级DHCP插件后需重新配置插件服务(SNADHCPPlug和SNADHCPPlugStart共两个服务)的登录权限，权限修改之后需要重启2个插件服务。备注：HA模式下，主机和备机均需要升级插件，并修改登录权限。升级SNACenter（卸载重装组件方式升级）SNACenter从E1106升级到E1205为跨版本升级，需要以卸载重装的方式来进行升级。替换postUninstallHook.sh脚本由于卸载重装后license模块存在已知问题，为了规避该问题，需要在卸载SNACenterE1106版本前更换postUninstallHook.sh脚本。替换方法如下：Step1：使用FTP工具上传如下附件的postUninstallHook.sh脚本至SNAInstaller三个节点的/opt/matrix/app/install/metadata/SNACenter/licc/licc/scripts/目录下，替换原来的卸载脚本Step2：上传完成后执行如下命令赋予脚本执行权限。修改后通过“ls-l”命令查看详细信息，确认该文件有可执行权限。 chmod+xpostUninstallHook.sh备注：3个节点均需要替换文件卸载R1版本SNACenterE1106登录SNAInstaller页面，单击[部署>应用]菜单项，点击删除按钮卸载SNACenterE1106版本。安装R2版本SNACenterE1205升级完成后，登录SNACenter页面，默认登录密码admin@123，登录后跳转到首页，单击[系统>设置>组件]菜单项，检查系统升级后组件列表是否正常。单击[系统>设置>用户]菜单项，检查系统升级后用户列表是否正常。单击[系统>设置>license]菜单项，检查系统升级后组件列表是否正常。（由于之前license已卸载，应为逃生状态）备注： 1.R2版本的SNACenter缺省使用https协议和10443端口，URL如下 https://cluster_ip:10443/portal/ 2.SNACenter安装文件大约3G，上传时间较长，可提前上传。部署时间约30分钟。升级vDHCP升级vDHCP到R2版本登录SNACenter页面，单击[系统>设置>组件]菜单项，点击展开公共服务，点击vDHCP的升级按钮。将vDHCP升级到R2的配套版本R1108重建数据vDHCP升级到R2版本后，由于版本内部差异，会存在功能异常，需要手工替换后台的startup.xml重建数据。方法如下Step1：另外复制一份章节2.2.10备份的startup.xml进行修改， <DHCPConfig></DHCPConfig>中间加上如下配置并保存： <ServerConfig> <PingNumber>0</PingNumber> <PingTimeout>0</PingTimeout> </ServerConfig> 修改后如下图所示： Step2：分别登录主、备dhcp所在的节点后台，进入/opt/matrix/app/data/vDHCPS/etc/cfg目录，删除startup.cfg，startup.mdb和startup.xml这3个文件。备注：主备两个节点均需要删除文件。Step3：登录主节点后台，查询并删除vdhcp的两个pods。（只需要在主节点操作）Step4：分别登录主、备dhcp所在的节点后台的/opt/matrix/app/data/vDHCPS/etc/cfg目录，将step1中修改后的startup.xml文件上传到该目录。备注：主机和备机所在节点均需要上传，注意区分主机和备机的文件。不要混用。Step5：登录主节点再次查询并删除vdhcp的2个pods，之后kubectl会自动重建2个pods。（只需要在主节点操作）Step6：重新登录vdhcp主备的docker容器，执行/sbin/netconf-cli--save,将内存中的数据保存到startup.cfg，然后查看/mnt/flash:/startup.cfg这个文件的内容，确保与升级前的2.2.10章节step3中备份的startup.cfg文件配置一致。（重点关注地址池信息和IP绑定信息，如果不一致请重新执行step2至step6）升级SeerEngine-Campus登录SNACenter页面，单击[系统>设置>组件]菜单项，点击SeerEngine-Campus的升级按钮。将SeerEngine-Campus升级到R2B01的配套版本E3202。备注：升级时间大约30分钟，进度条在40%时会保持约20分钟，请耐心等待。修改EIA的控制器参数五期R1的SNACenter网管缺省使用http协议，端口使用10080。升级到R2之后，缺省使用https协议，端口使用10443，因此需要同步修改EIA上的控制器参数，如下所示：通信协议修改为https，端口修改为10443，密码与升级后的SNACenter网管登录密码保持一致即可。检查控制器业务状态升级SeerEngine-Campus后，需要登录网管，确认各项业务状态正常Step1：查看设备状态是否正常、审计设备配置是否有异常。Step2：查看基础服务中的EIA信息，可以同步成功。Step3：查看基础服务中的微软DHCP和vDHCP，点击同步可以成功。然后点击DHCP服务器名称链接，查看DHCP的详细信息，看各项数据是否有异常，如果添加失败的配置，重新下发即可。如下：升级SNAInstaller到R2版本（重装ISO方式升级）SNAInstaller无法直接从R1升级到R2，需重新安装R2版本的ISO镜像。安装ISO前，需要先对当前数据进行备份，然后重装ISO，最后恢复数据。R2版本数据备份此处备份与章节2.2备份不同，章节2.2中备份的是用户现网R1版本的数据。此处备份的是已经升级到R2版本之后的数据（SNACenter、SeerEngine-Campus、vDHCP），请另外存档。备份方法如下：Step1：备份SNAInstaller集群数据。登录SNAInstaller页面，单击[部署>备份恢复]菜单项，点击<开始备份>，备份SNAInstaller集群配置信息和应用的配置信息，备份完成后点击下载备份文件。备注：下载文件时请注意页面中的“创建时间“，需要选择本次备份生成的文件。不要选择R1版本时备份的数据。（页面默认根据创建时间降序排列）Step2：备份应用安装包。备份应用安装包用于后续的SNAInstaller备份恢复，登录SNAInstaller的任意节点，将/opt/matrix/app/install/packages路径下当前已安装的应用对应的应用安装包备份保存至本地。备注：需要备份SeerEngine-Campus、SNACenter、vDHCP的R2版本的zip安装包。如果本地已经有相关安装包，不需要从控制器上重复下载。使用本地的归档即可。Step3：备份SNACenter和组件登录SNACenter页面，单击[系统>设置>备份恢复]菜单项，勾选SNACenter、SeerEngine_Campus、vDHCP，点击<应用>，开始备份应用数据。备份完成后点击下载备份文件。（共3个文件）备注：1.备份的时候需要选SNACenter、SeerEngine-Campus和vDHCP。2.由于已知问题，需要检查一下下载的vDHCP压缩文件里的startup.xml，2个文件夹中的startup.xml文件均需要检查。如果xml文件里没有数据，可以登录主节点查询并删除vdhcp的2个pods，之后kubectl会自动重建2个pods，然后在页面中进行vDHCP数据备份。然后检查2个文件夹中的xml文件是否有数据。如果仍然没有数据，请重复删除pods和备份操作，直至有数据。重装ISO（安装V5R2版本的SNAInstaller）使用R2配套版本SNACenterE1205的ISO重装系统。备注： 1.安装ISO时，需要勾选安装LicneseServer。2.系统安装时各节点的IP地址、主机名、用户名、密码、网卡等信息都必须要和升级前的系统配置信 息保持一致，避免升级SNAInstaller系统后执行备份恢复失败。搭建SNAInstaller集群Step1：安装ISO之后，登录任意节点SNAInstaller网管，搭建集群，集群参数需要跟升级前保持一致。备注：只搭建集群即可，不要安装应用组件Step2：安装完成后登录系统控制台，使用如下命令查看SNAInstaller容器化应用部署平台是否部署完成。当显示active(running)时，表示SNAInstaller系统部署完成。恢复SNAInstaller集群数据Step1：上传安装包使用FTP工具上传3.10.1章节step2中备份的SNACenter、SeerEngine-Campus、vDHCP应用安装包文件至SNAInstaller三个master节点的/opt/matrix/app/install/packages/目录。备注：3个master节点均需要上传。请注意版本号是否正确，如果目录中已经有相关安装包，无需重复上传。Step2：上传备份文件。登录主master节点的SNAInstaller页面，https://[主master节点IP]:8443/matrix/ui/,默认密码admin@123。单击[部署>备份恢复]菜单项，选择3.10.1章节step1中的集群备份文件，点击上传。Step3：开始恢复。备份文件上传完成后，点击开始恢复，恢复SNAInstaller集群配置信息和应用的配置信息。Step4：确认参数检查备份文件信息中的各参数是否正确。（集群参数、节点信息、应用）（图片仅供参考，请以实际环境为准）Step5：备份文件信息检查完成后，点击下一步，进入备份恢复确认页，检查环境无异常后点击开始恢复。Step6：系统恢复过程中请耐心等待。（约40分钟）Step7：系统恢复完成后，提示应用恢复成功。点击确定。Step8：恢复完成后，跳转到概览页面，检查系统状态正常。备注：此时SNAInstaller系统的密码会恢复成备份文件时系统的登录密码，当SNAInstaller系统退出重新登录时需使用该密码，可手动在页面修改登录密码。Step9：点击页面右上角[更多>关于SNAInstaller]，查看系统版本为V500R002B03D001。Step10：点击页面[部署>集群>集群部署]，查看节点状态是否正常。Step11：点击页面[部署>应用>应用列表]，查看应用信息是否和系统升级前保持一致。恢复SNACenterStep1：登录SNACenter页面，单击[系统>设置>备份恢复]菜单项，选择3.10.1章节step3备份的SNACenter备份文件，点击上传，备份文件上传完成后点击开始恢复。Step2：备份恢复确认，点击确定开始恢复。Step3：等待恢复。Step4：约5分钟后，重新登录SNACenter。进入[系统>设置]页面，点击组件菜单，检查组件列表是否恢复并和升级之前保持一致Step5：点击用户菜单，检查用户列表是否恢复并和升级之前保持一致。恢复vDHCPStep1：登录SNACenter页面，单击[系统>设置>备份恢复]菜单项，选择3.10.1章节step3备份生成的vDHCP备份文件，点击上传，备份文件上传完成后点击开始恢复。Step2:备份恢复确认，点击确定开始恢复。(需等待约5分钟)恢复SeerEngine-CampusStep1：登录SNACenter页面，单击[系统>设置>备份恢复]菜单项，选择3.10.1章节step3备份生成的SeerEngine-Campus备份文件，点击上传，备份文件上传完成后点击开始恢复。Step2:备份恢复确认，点击确定开始恢复。(需等待约5分钟)数据恢复后检查控制器业务状态SeerEngine-Campus恢复数据后，需要查看SeerEngine-Campus网管页面，确认各项业务状态正常Step1：查看控制器集群状态、设备状态是否正常、审计设备配置是否有异常。Step2：查看基础服务中的EIA信息，可以同步成功。Step3：查看基础服务中的微软DHCP和vDHCP，点击同步可以成功。查看DHCP详细信息，看是否有异常，如果添加失败的配置，重新下发即可。如下：迁移license重装ISO并恢复组件数据之后，需要将之前的license迁移到新的LicenseServer上。方法如下Step1： 登录新LicenseServer，https://[节点IP]:28443/licsmanager，缺省密码admin/admin@h3c，重新配置客户端信息、连接端口。（与升级前的配置信息一致）备注：与R1版本不同，SNACenterE1205的ISO配套的LicenseServer版本为E1146H01，网管登录方式切换为了https方式，URL为“https://[节点IP]:28443/licsmanager/”，缺省密码admin/admin@h3cStep2：单击[License/安装]菜单项，在该页面单击<导出DID>按钮,获取该LicenseServer的设备信息文件。Step3：访问网址/cn/License，单击“设备授权迁移申请”，进入“设备授权迁移申请”页面。Step4： 在“产品分类”中选择对应的产品分类。在页面上填写相关信息。如下表所示：项目说明原设备信息上传卸载文件：需要上传此前获取到的卸载文件新设备信息上传新LicenseServer导出设备信息文件用户信息请填写您的用户信息，其中带“*”的项目必填 Step5：输入验证码并勾选“已阅读并同意法律声明所述服务条款各项内容”，再单击<提交>按钮，将生成新的License文件，请将生成的License文件保存到本地PC待用。Step6： 在新LicenseServer单击[License/安装]菜单项，进入激活文件管理页面。Step7：单击<安装激活文件>按钮，在弹出的对话框中单击<浏览>按钮，选择保存在本地的License文件。单击<确定>按钮，上传选中的License文件。上传成功后在激活文件管理页面会显示获取的授权信息。如下图所示：备注：Licenseserver的详细配置方法请参考《ADCampusV500R002B01维护手册》恢复控制器license连接迁移license到新的LicenseServer之后，需要在控制器页面重