概要描述

Manager 5.x 之后的版本，升级至 Manager 9.4.0.0 的操作说明。

详细说明

1. 升级约束
2. 升级常见问题
3. 升级须知
4. 升级操作

1、升级约束

1. Manager 支持从哪些版本升级到 9.4.0.0？
   TDH Manager支持从 5.x 以上任何版本的直接升级，可以直接升级到 Manager 9.4.0.0，无需升级到某个中间过渡版本后再升级到 9.4.0.0。

2. 支持哪些操作系统升级至 9.4.0.0？
   如果没有做过国产化定制，是原生的支持 Manager安装的系统，那么可以放心的升级。
   Manager 9.4.0.0 对操作系统的支持，参考：环境要求：操作系统要求

3. 定制化版本是否可以升级？
   如果做过国产化定制，直接升级会导致国产化定制丢失，请提前检查确认。
   检查方法，若存在，表示应用过。如果没有输出，表示没有应用过。

   rpm -qa | grep transwarp-manager-common-linuxdistros

   

4. 检查 /var/lib/transwarp-manager 目录是否做了软连接
   执行以下命令，如果有输出，代表有做软连接。

   readlink /var/lib/transwarp-manager

   如果做了软连接，升级后软连接会断掉，需要重新创建一下。

2、升级常见问题（Q/A）

Q：升级时长
顺利的情况下，实测升级时长：14:00 开始，15:00结束。

Q：升级是否需要停服
从 7.0.2003a之后的版本 升级到 9.4.0.0，可以不需要停服。
如果不能确认版本，可以直接执行升级操作，升级检查项中会自动检查是否需要关闭服务。

如果需要停服，要将除TOS以外的服务都停掉，停掉后的检查命令如下，这条命令的输出为1，说明除TOS以外的服务都已经停掉。

kubectl get pod --all-namespaces | grep -v tos | wc -l

Q：升级是否会重启TOS
940 版本升级了 tos 版本到 2.1.5，所以会做初始化 tos 的操作，不过该操作不会影响现有服务。

Q：操作系统兼容性
Centos 7.4（不包含）以下的升级，需要更换 docker-runc：

分如下情况：

1. 如果当前是Manager 8.X以后的版本，无需手动替换，升级过程中会自动替换；
2. 如果当前是Manager 8.X以前的版本升级，无论升级到什么版本，都需要在tos初始化出错后，手动替换docker-runc，参考文档：手动替换docker-runc

如果当前Manager是手扶的国产系统上部署的，在这里找9400是否支持：Manager操作系统兼容性检查

如果不支持，请联系SLA解决。
如果支持，也可以直接升级。

Q：如果升级断开了怎么办
支持中断恢复，8179进程因断电或人为中断等原因造成中断后，重新执行 ./install ，会恢复到之前升级的进度，不影响继续升级。

3、升级须知（必读）

1. 需要先关闭高可用
   升级前如果Manager打开了HA，都需要先关闭后方可升级，都可以在 Manager 页面直接操作关闭HA。

2. 升级过程中切勿操作任何文件以及文件夹，有问题及时联系研发。

3. 升级前请检查是否做过国产化定制
   如果检查到有安装过这个rpm，会导致升级失败。
   执行升级前先手动备份以下两个目录，因为可能会被删除，需要借助备份恢复

   /etc/transwarp-manager/common/linuxdistros
   /var/lib/transwarp-manager/master/pub

4、升级步骤

升级过程中出现问题及时与我们联系！

Step1：启动升级程序

确保已经关闭了 Manager HA。
将安装包（点击下载）上传到当前 Manager 的节点，使用tar -xzvf 解压后，在解压包下，执行install程序，当显示如下提示，就可以登录 8179 端口的升级页面查看。

Step2：升级版本检查

只要满足升级的版本，就会看到如下界面，然后点击下一步进入配置页面

Step3：升级配置

通常配置页面上使用默认配置即可，点击进入下一步

【注意点】
这里的用户是Manager 8180可以登录的用户，需要保持在升级期间，不要在其他地方去登录它；
支持使用秘钥或者密码的方式进行服务器之间的通信，秘钥路径和密码要求所有节点一致；
如果不需要备份registry，这边可以不勾选。是否备份registry虚详细查看截图中的备份说明。

Step4：环境检查

如下界面为升级前的检查，如果有未通过项，会给出修改建议，修改完之后页面重试，否则将不能进入下一步升级(相比前作，新增了未安装节点检查)

Step5：执行升级

下图是真正的升级过程，不出错误等待升级完成即可

Step6：升级完成

后可点击"关闭"按钮进行后台安装程序的退出，至此，平台升级完成

Step7：打Manager系统补丁

在升级到Manager 9.4.0.0 后，安装 9.4.0.5 补丁（点击下载）。

等待5-10分钟后，页面会自动刷新，重新登录 Manager ，查看关于我们，确认更新是否成功。

step8: TOS 配置服务

登录 Manager 页面，点击上方全局服务，TOS，然后配置服务。

9. 检查

0、检查当前集群TOS证书过期时间，登录集群任意节点，执行下面的命令

openssl x509 -text -in /srv/kubernetes/ca.pem |grep Not

如果显示是 2120 年过期，则表示续签成功。

1、检查 bootstrap

head /srv/kubernetes/bootstrap.kubeconfig

输出的 certificate-authority-data 最后几位是 ：RU5EIENFUlRJRklDQVRFLS0tLS0K 代表续签完成。