变更ROMA Site协同版实例规格

方案概述

ROMA Site协同版实例规格变更目前仅支持实例从3VM的基础版扩容为4VM的专业版，即增加一台同规格虚拟机。各集成组件强制依赖实例，不可单独变更。

ROMA Site协同版实例规格变更包含站点规格变更和实例规格变更两部分。其中实例规格变更时，又可分为新站点容器扩容和已有容器升级两种场景。

新站点容器扩容：会在新增节点上部署新的服务容器。
已有容器升级：会对已有容器的CPU和内存分配有较大的改动，大部分组件都会有变化。

注意事项

部分组件在实例规格变更过程中会中断业务，建议在业务影响小的时间段内变更规格。
实例规格变更过程中，会将所有集成组件一起扩容至目标配套规格。
实例规格变更过程中，请不要执行其他操作，避免操作冲突导致实例规格变更失败。
实例规格变更功能仅对白名单用户开放。

变更影响

ROMA Site实例规格变更过程中对系统的影响如表1所示。

表1 变更过程的影响
组件	影响说明
ROMA Site整体	ROMA Site实例规格变更过程中，服务集群内部只有部分容器对外提供服务，降低ROMA Site性能和可靠性，建议客户在业务低峰时间进行升级。
FDI	ROMA Site实例规格变更过程中，数据源、数据集成任务上的操作会出现部分请求错误，不影响已部署业务。 ROMA Site实例规格变更过程中，正在执行中的数据集成任务可能会中断，部分执行间隔较短（如调度计划1分钟一次）的任务执行时间存在5-6分钟波动，导致单次任务执行时间会覆盖多次调度计划。建议先停止所有数据集成任务，等待规格变更完成后再重新启动任务。如果定时任务正好在规格变更过程中调度时，部分调度日志显示时间可能比用户制定的调度时间晚2-3分钟，为正常现象，属于Quartz补偿调度任务机制影响。 ROMA Site实例规格变更过程中，部分调度日志显示会存在展示异常，实际该次任务正常调度，数据正常读取写入。 ROMA Site实例规格变更过程中，MQS升级会影响FDI内部topic的创建，导致任务调度跳过，属于正常现象。 ROMA Site实例规格变更过程中，fdiplugin升级完成后，可能出现下一次正常调度跳过情况，这是由于quartz补偿调度的任务还在执行中导致的，属于正常现象。
APIC	ROMA Site实例规格变更过程中，查询类操作不受影响，其他创建、修改、删除等操作无法操作。 ROMA Site实例规格变更过程中，用户的长连接API业务会中断，如果客户端有重试机制，则业务不受影响。 ROMA Site实例规格变更过程中，已有周期内的流量控制和客户端配额的计数器清零，最高会出现两倍的阈值，需要用户在规格变更前评估系统承载能力，可临时调整阈值为原来的一半。 ROMA Site实例规格变更过程中，可能出现自定义后端的连接闪断，或出现数据后端权限校验失败问题（错误信息为：Error Return Object: xxx, Executor Exception: Access denied. Exception during pool initialization）。若API使用了自定义认证，可能会偶现自定义认证失败（错误信息为：Internal server error: xxx auth failed）。如果客户端有重连机制，则重连时可以恢复正常。 ROMA Site实例规格变更过程中，如果客户端调用了使用MQSUtils的函数API，可能会持续收到5xx响应码或者异常信息“com.huawei.livedata.util.MqsUtilsException”和“org.apache.rocketmq.client.exeception.MQSClientException”，待规格变更完成后可恢复。建议客户端延迟20-30分钟后重试，或者将函数API中的MQSUtils替换为Kafka。
LINK	ROMA Site实例规格变更过程中，查询类业务不受影响，但不建议在规格变更过程中进行创建、更新、删除、导入等操作。 ROMA Site实例规格变更过程中，设备连接可能会中断。如果设备端有重连机制，重连时可以恢复连接。

准备资源

在进行ROMA Site实例规格变更前，需要准备以下资源：

虚拟机：与之前机器相同规格且相同架构的Linux机器。
工具：需要安装Docker、NTP、Haveged服务，Docker安装请参考安装Docker，NTP配置请参考时间同步，Haveged的安装请参考安装Haveged。浏览器用于登录华为云控制台，要求Chrome 97及以上版本、Edge或Firefox 97及以上版本。
实例规格变更需要APIC特定版本支持，请联系技术支持进行确认。

变更前检查

变更前请确认所有节点机器软件安装正常。
- 查看Docker、NTP、Haveged是否安装并且正常启动。
- Haveged已下载安装包并上传到节点上。
  安装Haveged：rpm -ivh haveged-1.9.13-3.oe1.x86_64.rpm
  
  开机启动：systemctl enable haveged
  
  重启：service haveged restart
  
  查看服务状态：service haveged status
变更前请确认新增节点机器磁盘是否挂载正常。
磁盘挂载到指定目录：/opt/roma/data和/opt/roma/logs
变更前请确认新增节点机器端口是否开放正常。
用户准备好虚拟机资源后，需要检查虚拟机是否开放了各组件需要的端口，其中，对外服务端口为7000、40001-40010、80、443、9092、9094、1883、8443，需要保证这些端口对外互通，其他端口保持内部互通。
变更前请确认华为云环境运行正常。
- 能够正常登录控制台。
- 当前站点信息状态为“运行中”及节点信息都显示为“运行中”。
变更前请确认新增节点机器的网卡名称和站点配置的名称一致。
变更前请联系技术支持确定站点的CPU架构是否正确填写。
变更前请确认站点模板为3VM基础版且带基本的子服务（APIC、FDI、MQS、LINK）。

变更站点规格

登录ROMA Connect控制台，在左侧导航栏选择“Site实例”。
在“Site实例”页面单击要变更规格实例上的“更多”，选择“规格变更”。
确认变更规格后单击“规格升级”。
当前仅支持从3VM的基础版规格变更为4VM的专业版规格。
再次单击“规格升级”，系统将自动创建边缘节点。
边缘节点创建完成后，单击“下载边缘节点配置文件”下载包含边缘节点密钥等信息的配置文件。
备份下载的边缘节点配置文件中的“node.tar.gz”文件到本地。

如果用户侧虚拟机出现故障需要重置时，则需要使用备份的“node.tar.gz”文件。
配置文件下载后，待系统将边缘节点连接上云，连接完成后单击“下载核心软件安装工具”按钮，下载对应的安装工具。当前支持X86_64和arm64，请下载对应的安装程序。
备份下载的核心软件安装工具中的“edge-installer_1.0.27_x86_64.tar.gz”文件到本地。

如果用户侧虚拟机出现故障需要重置时，则需要使用备份的“edge-installer_1.0.27_x86_64.tar.gz”文件。

其中，1.0.27为安装工具版本号，x86_64为CPU架构类型，请以实际场景为准。
单击下载纳管脚本压缩包install_site.tar.gz，参考表4编辑其中的install_site.conf文件，将新增的节点IP填写到VM4中，并填写cpu_request、mem_request、data_disk_size和log_disk_size。
上传下载下来的证书压缩包、安装工具、install_site.conf和install_site.sh四个文件到新增节点的临时目录。
登录并进入新增节点的临时目录，执行命令 sh install_site.sh install_site.conf，并按照要求输入密码完成机器纳管。
返回控制台，单击“站点详情”，查看所有纳管节点是否正常运行。