【技术】如何在TDH社区版中进行服务升级

星环科技 2022-07-18

Transwarp Data Hub（TDH）社区版为用户提供了方便的升级方式，不论是选择物理集群、私有云还是公有云作为社区版的安装平台，都可以在本地集群通过应用市场试用、购买、升级高阶版本的产品组件工具。

实现时，应用升级需要执行哪些步骤，升级时需要哪些工具，如何将目前服务升级至指定版本，如何实现Manager的升级，本文将会对这些问题进行解答。

应用的升级

社区版Manager除了实现了产品安装、图形化运维、健康监控等传统功能外，还提供了应用市场模块，支持在线升级、应用独立部署，方便用户获取星环大数据平台的各种产品以及实现产品升级。

版本升级

进入应用市场后，可以通过“已安装服务”查看集群当前已安装的应用与相应版本。

点击“检查升级”按钮检查服务是否有新版本发布，如果服务出现“升级”按钮，则说明可以对该服务进行升级。

点击“升级”按钮可进入产品升级界面。

也可以进入产品查看详情页面了解各版本详情，选择目标版本，点击右侧的“立即升级”按钮后开始服务升级。

进入升级页面

进入升级配置页面，首先选择升级版本。

然后选择升级模式，Manager在这里提供了滚动升级和快速升级两种模式。

滚动升级
保证服务在升级的过程中依然可用，但是升级速度相对较慢。
快速升级
如果希望以更快的速度升级，可以选择快速升级，但是该服务在升级过程中将不可用。

开始升级

上述步骤完成后，系统开始自动升级服务，等待升级成功即可。

Transwarp Manager的升级

社区版与5.x的Manager和tos的升级脚本内置在安装包TDH-Basic-*.tar.gz中，升级前需要下载目标版本的安装包，并解压于Manager节点。解压出的transwarp/script目录包含以下三个文件：

UpgradeManager.sh：Manager升级脚本
CheckEnvironment.sh：环境自动检查脚本
Upgrade.conf：升级配置脚本

注意：5.0.1-final及之前的安装包未包含上述脚本，请至星环支持论坛（support.transwarp.cn）进行下载，并放在transwarp/script目录下。

脚本说明

Manager的升级通过UpgradeManager.sh一键实现。下面是它的三个相关参数：

脚本名	参数	说明
UpgradeManager.sh	upgradeCluster	一键升级整个集群
revertCluster	一键回滚整个集群
checkEnvironment	检查升级环境

升级前需要保证以下几点

检查升级脚本所在分区是否有足够空间，建议大于20G，如果需要升级至商业版建议大于50G。
检查docker vg是否有有足够空间，建议大于50G。
检查/etc/hosts和每台机器的hostname是否正常。
检查集群是否已正确配置无秘钥登录，以及无秘钥登录用户是否为NOPASSWD sudoer。

修改升级操作参数

接着按照需求修改升级配置文件Upgrade.conf ，下面是其中的各个参数与含义：

参数名	含义
ADMIN	管理界面admin的用户名。
PASSWORD	管理界面admin的密码。
IS_UPGRADE_BASIC	是否升级Manager及TOS，默认是true。选项为true时，需要下载TDH-Basic-*.tar.gz，并在Manager目录上解压。
IS_UPGRADE_REGISTRY	是否升级Registry Image，默认是false。选项为true且升级目标为商业版时，需要下载TDH-Image-Registry-*.tar.gz，并在Manager目录上解压。
REGISTRY_DATA_DIR	IS_UPGRADE_REGISTRY选项为true时：升级目标为商业版时，需要指定为TDH-Image-Registry-*.tar.gz包解压出的registry目录路径；升级目标为社区版时，保持为空即可。
REGISTRY_PORT	IS_UPGRADE_REGISTRY选项为true时，需要通过含参数指定一个可用端口供Registry服务使用。
IS_UPGRADE_MACHINE_LEARNING	是否升级Machine Learning相关Image，默认是false。选项为true时，需要下载TDH-Machine-Learning-*.tar.gz，并在Manager目录上解压。注意：此项仅升级目标为商业版时可以为true，升级到社区版时必须为false。
MACHINE_LEARNING_IMAGE	IS_UPGRADE_MACHINE_LEARNING选项为true时，需要通过该参数指定TDH-Machine-Learning-.tar.gz包解压出的TDH-machine-learning-.img文件路径。
USER	免密钥登录节点使用的用户名。默认是Manager安装时自动创建的transwarp用户，如果手动配置了其他免密钥登录用户，用户必须为NOPASSWD sudoer。
RSA	免密钥登录的私钥存放的位置。默认是界面自动配置的免密钥/etc/transwarp/transwarp-id_rsa，如果手动配置了其他免密钥，需要修改地址。