SevOne NMS 升级过程指南

1. 从您选择的网络浏览器中输入SevOneNMS 设备的URL。 例如，<SevOneNMS 设备 IP 地址>

2. 单击左侧群集层次结构中的 群集 ，然后选择右侧的群集升级选项卡，使用图形用户界面升级群集。 此选项卡将包含SevOneNMS 图形用户界面安装程序和升级历史记录的所有详细信息。

   

3. 如果已经执行了 "为升级做好准备"一节中的步骤，则已获得所需的升级文件，可以跳过 "步骤 1：通过 SFTP 服务器获取升级工件"下的字段。 如果没有，并且/data/upgrade文件夹中没有所需的升级文件，请执行 "准备升级 "一节中的步骤，或在以下字段中输入要升级的SevOneNMS 的值。
   • 服务器 IP- 供SevOneNMS 使用的 SFTP 服务器的 IP 地址或主机名。
   • 端口- 远程服务器上运行 SFTP 服务器的端口号。 默认值为端口 22。 SevOneNMS 将向该端口发送报告。
   • Username- 用于从远程服务器复制人工制品的用户名。
   • 密码-SevOneNMS 验证 SFTP 服务器所需的密码。
   • 升级工件的FilePath- 要下载 tar 文件的远程 SFTP 服务器上的工件路径。 用户必须具有读取工件的权限。
   • 单击 " 获取升级工件 "按钮，获取 SevOne NMS 用于升级的工件。 工件会被放到群集领导者的 /data/upgrade 目录中。
     注意：

     如果已在"群集管理器">"群集设置"选项卡>"SFTP"子选项卡上配置了 SFTP 服务器，则除路径外，将获取相同的配置。 您可以使用相同的服务器，也可以在此配置不同的服务器。

     根据文物的大小，这一步骤可能需要一些时间。

     如果没有 SFTP，可直接将工件复制到 Cluster Leader 的/data/upgrade目录。

4. 在 "步骤 2：添加域名"部分，在以下字段中输入要升级的SevOneNMS 的值。
   • 域名- 输入用逗号分隔的域名，请勿https:// 例如，test.sevone.com,test2.sevone.com。
   • 单击 "保存域名"按钮保存域名。
5. 在 "步骤 3：运行安装程序以使用新下载的升级工件和查看URL"部分，单击 "运行安装程序"按钮，使用工件中的最新版本升级SevOneNMS。 以下内容在后台处理。
   • 从工具中提取最新的安装程序。
   • 安装程序已升级到最新版本。
   • 生成安装程序的URL。

   

   您可以进入生成的URL，通过图形用户界面启动升级。 按照升级阶段一节中的步骤操作。

6. 群集升级历史"部分显示使用图形用户界面安装程序进行的所有先前升级的群集升级历史。
   详情如下

   • 起始版本- 升级前群集的SevOneNMS 版本。
   • 前向版本- 群集升级到的SevOneNMS 版本。
   • 现状 - The status of the upgrade. 即表明升级是正在进行、成功还是失败。
   • 升级完成时间- 该字段显示完成升级所需的时间。

1. 在开始升级之前，建议您执行升级预检，以识别并解决已知的潜在升级阻塞问题。

   
   SevOne-act check checkout --full-cluster
   
   SevOne-act check listening-ports --full-cluster
   

2. 一旦预检查成功完成，并确定和解决了已知的潜在升级受阻问题，请清理 /data/upgrade 目录。

   
   rm /data/upgrade/installRPMs.tar
   
   rm /data/upgrade/DigiCert-cs.crt
   
   rm /data/upgrade/ibm-sevone-cs.crt
   
   rm -rf /data/upgrade/ansible
   

3. 将目录更改为/data/upgrade

   
   cd /data/upgrade
   

4. 解压升级tar 文件。

   
   tar -xzvf v7.1.0-build<enter build number>.tar.gz
   

5. 将目录更改为/data/upgrade/ansible。

   
   cd /data/upgrade/ansible
   

6. 运行升级脚本启动从SevOneNMS7.0.1到SevOneNMS7.1.0 的升级。

   
   ./upgrade.sh
   

   重要：根据群集的大小，升级时间可能会有所不同；请等待升级成功完成。
   注意：以下标记为区分大小写的参数。 如果传递的标志/参数不止一个，则必须用单/双引号传递。

   重要： 对于升级前标志-e和-f、

   可以添加-e标记，跳过升级前的错误。

   可以添加-f标记，跳过升级前检查并强制安装。

   不过，即使通过-e或-f标志，也不会跳过某些预检查。 例如，在执行升级时，当前的SevOneNMS 版本必须是要升级到的SevOneNMS 版本之前的版本。 否则，您将收到"NMS 的起始版本应小于 NMS 的前进版本 消息。

   • -a:避免使用游戏本标签运行。
   • -c:防止hosts.ini自动再生。 如果不将此标记作为选项，hosts.ini将自动重新生成。
   • -e:如果发现升级前错误，则跳过该错误，仅在不使用-f选项时适用。
   • -f:跳过升级前检查并强制安装。
   • -n:n： 不要在屏幕会话中启动。 用于自动构建。
   • -s:s： 在不使用 UI 日志记录器的情况下运行升级。
   • -x:使用--hub-spoke-network选项进行升级前检查。
   • -h:显示此帮助。

   例如，

   跳过所有升级前检查运行升级、

   
   ./upgrade.sh -f

   使用轮毂-轮辐标志运行升级、

   
   ./upgrade.sh -x

   1. 安装程序将启动名为 ansible-{version}的屏幕会话。
      重要信息: 必须 不 拆离终端上的屏幕会话，因为正在进行的进程位于内存中，并且在升级期间软件包在设备上可能不再可用。

      在屏幕中完成 ansible-playbook 执行后，必须 退出 屏幕会话。

      在升级时使用单独的 ssh 连接到框，可能会在终端上显示一些 PHP/其他警告。 SevOne 建议您等待升级过程成功完成。

   2. 将同时更新所有 同级 / 主机 上的包。 [标记 :prepare_rpm ， install_rpm ， docker_setup]
   3. 数据库迁移在 clustermaster (mysqlconfig 和 mysqldata) 和 活动同级 (仅限 mysqldata) 上运行。 [标记: 数据库]
   4. 系统补丁同时在 所有同级 上运行。 [标记 :systempatch]
   5. 最后将在 所有主机 上执行清除操作。 [标记: 清除]
   6. 您的计算机上安装了SevOneNMS7.1.0。

      升级将打开 " TUI (基于文本的用户界面) " 或 " 终端用户界面 " 窗口，该窗口将进度拆分为 3 列。

      重要信息: 如果无法与屏幕会话交互，那么仍必须能够在 列 1中查看进度。 允许升级完成。
      • 列 1: 主机面板-显示每个主机的进度。
      • 列 2: "任务" 面板-显示正在执行的任务。
      • 列 3: "日志" 面板-显示与每个任务关联的日志。
        重要信息: FYI

        • 按 F1 以显示/隐藏 HELP。
        • Ctrl + C-终止可执行。

        要在面板/列之间导航，请按:

        • 1 -选择列 1 (主机面板)
        • 2 -选择列 2 ("任务" 面板)
        • 3 -选择列 3 ("日志" 面板)
        • 向上箭头 -将光标/日志向上移动
        • 向下箭头 -将光标/日志下移
        • 向左箭头 -向左移动光标/日志
        • 向右箭头 -向右移动光标/日志

        要从屏幕方式拆离，请按 Ctrl + A ，后跟字母 d。 要附加到屏幕方式，请输入 screen r。

        升级

        

        单击 F1 以在记录器中显示 HELP 菜单

        

7. 成功升级到SevOneNMS7.1.0 后，检查版本以确保您使用的是SevOneNMS7.1.0，即SevOneNMS7.1.0，如下例所示。

   示例

   
   podman exec -it nms-nms-nms SevOne-show-version
               

   SevOne 版本： 7.1.0
   内核版本： 4.18.0-553.8.1.el8_10.x86_64 #1 SMP Fri Jun 14 03:19:37 EDT 2024
   nginx 版本： 1.24.0
   MySQL 版本： 10.6.19-MariaDB
   PHP 版本： 8.3.12
   SSH/SSL 版本： OpenSSH_8.0p1, OpenSSL 1.1.1k FIPS 2021 年 3 月 25 日
   REST API 版本： 2.1.47, Build time 2024-08-26T14:05:20+0000, Hash 6d6a9c5
   
       英特尔® 至强® 处理器
       2 个内核 @ 2199.998MHz
       8GB 内存
       4GB 交换
       150 GB/分区
       150 GB /数据分区

1. 开始降级前，清理/data/upgrade目录。

   
   rm /data/upgrade/installRPMs.tar
   
   rm /data/upgrade/DigiCert-cs.crt
   
   rm /data/upgrade/ibm-sevone-cs.crt
   
   rm -rf /data/upgrade/ansible
   

2. 将目录更改为/data/upgrade

   
   cd /data/upgrade
   

3. 解压降级tar 文件。

   
   tar -xzvf v7.1.0-to-v7.0.1-build<enter build number>.tar.gz
   

4. 将目录更改为/data/upgrade/ansible。

   
   cd /data/upgrade/ansible
   

5. 运行降级脚本启动从SevOneNMS7.1.0到SevOneNMS7.0.1 的降级。

   
   ./reverse.sh
   

   重要：根据群集的大小，降级时间可能会有所不同；请等待降级成功完成。
   注意：以下标记为区分大小写的参数。 如果传递的标志/参数不止一个，则必须用单/双引号传递。

   • -a:避免使用游戏本标签运行。
   • -e:如果发现升级前错误，则跳过该错误，仅在不使用-f选项时适用。
   • -f:跳过升级前检查并强制安装。
   • -n:n： 不要在屏幕会话中启动。 用于自动构建。
   • -s:s： 在不使用 UI 日志记录器的情况下运行升级。
   • -x:使用--hub-spoke-network选项进行升级前检查。
   • -h:显示此帮助。

   例如，

   跳过所有升级前检查，运行降级、

   
   ./reverse.sh -f

   使用轮毂-辐条标志运行降级、

   
   ./reverse.sh -x

   要跳过升级前的错误检查来运行降级、

   
   ./reverse.sh -e

   1. 安装程序将启动名为 ansible-{version}的屏幕会话。
      重要信息: 必须 不 拆离终端上的屏幕会话，因为正在进行的进程位于内存中，并且在降级期间软件包可能在设备上不再可用。

      在屏幕中完成 ansible-playbook 执行后，必须 退出 屏幕会话。

      在降级时使用与框的单独 ssh 连接，可能会在终端上显示一些 PHP/其他警告。 SevOne 建议您等待降级过程成功完成后再执行。

   2. 将同时更新 所有同级/主机 上的软件包。 [标记 :prepare_rpm ， install_rpm 和 docker_setup]
   3. 反向数据库迁移在 clustermaster (mysqlconfig 和 mysqldata) 和 活动同级 (仅限 mysqldata) 上运行。 [标记: 数据库]
   4. 系统补丁同时在 所有同级 上运行。 [标记 :systempatch]
   5. 最后将在 所有主机 上执行清除操作。 [标记: 清除]
   6. 如果您使用的是 SevOne NMS 7.1.0 ， SevOne NMS 7.0.1 现在已安装在您的机器上，因为 SevOne NMS 7.1.0 是由 SevOne NMS 7.0.1 升级而来的。

      降级将打开 " TUI (基于文本的用户界面) " 或 " 终端用户界面 " 窗口，该窗口会将进度分割为 3 列。

      重要信息: 如果无法与屏幕会话交互，那么仍必须能够在 列 1中查看进度。 允许降级完成。
      • 列 1: 主机面板-显示每个主机的进度。
      • 列 2: "任务" 面板-显示正在执行的任务。
      • 列 3: "日志" 面板-显示与每个任务关联的日志。
        重要信息: FYI

        • 按 F1 以显示/隐藏 HELP。
        • Ctrl + C-终止可执行。

        要在面板/列之间导航，请按:

        • 1 -选择列 1 (主机面板)
        • 2 -选择列 2 ("任务" 面板)
        • 3 -选择列 3 ("日志" 面板)
        • 向上箭头 -将光标/日志向上移动
        • 向下箭头 -将光标/日志下移
        • 向左箭头 -向左移动光标/日志
        • 向右箭头 -向右移动光标/日志

        要从屏幕方式拆离，请按 Ctrl + A ，后跟字母 d。 要附加到屏幕方式，请输入 screen r。

        降级

        

        单击 F1 以在记录器中显示 HELP 菜单

        

6. 成功降级到SevOneNMS7.0.1 后，请检查版本以确保您使用的是SevOneNMS7.0.1，如下例所示。

   示例

   
   podman exec -it nms-nms-nms SevOne-show-version
               

   SevOne 版本： 7.0.1
   内核版本： 4.18.0-553.22.1.el8_10.x86_64 #1 SMP Wed Sep 11 18:02:00 EDT 2024
   nginx 版本： 1.14.1
   MySQL 版本： 10.6.18-MariaDB
   PHP 版本： 8.3.9
   SSH/SSL 版本： OpenSSH_8.0p1, OpenSSL 1.1.1k FIPS 2021 年 3 月 25 日
   REST API 版本： 2.1.47, Build time 2024-05-16T06:53:00+0000, Hash 07f225e
   
       英特尔® 至强® 处理器
       2 个内核 @ 2199.998MHz
       8GB 内存
       4GB 交换
       150 GB/分区
       150 GB /数据分区
   

7. 检查已安装的内核软件包。

   检查内核版本

   
   podman exec -it nms-nms-nms SevOne-show-version
   OR
   rpm -qa | grep kernel
   OR
   uname -r

   要点: 内核会在降级过程中自动更新，而并非每个 NMS 发行版都有新的内核。

   根据 NMS 发行版，内核版本必须为:

   SevOne NMS 版本	内核版本
   NMS7.0.1	4.18.0-553.el8_10.x86_64
   NMS7.1.0	4.18.0-553.8.1.el8_10.x86_64

   内核版本基于 NMS 发行版。

   内核版本必须基于 NMS 发行版。 否则，必须通过执行以下步骤来重新引导整个集群以应用新内核，否则不需要重新引导。

   
   SevOne-shutdown reboot

8. 确认 NMS 设备正在运行SevOneNMS7.0.1 版本。

   
   podman exec -it nms-nms-nms SevOne-show-version
               

   SevOne 版本： 7.0.1
   内核版本： 4.18.0-553.8.1.el8_10.x86_64 #1 SMP Fri Jun 14 03:19:37 EDT 2024
   nginx 版本： 1.14.1
   MySQL 版本： 10.6.18-MariaDB
   PHP 版本： 8.3.9
   SSH/SSL 版本： OpenSSH_8.0p1, OpenSSL 1.1.1k FIPS 2021 年 3 月 25 日
   REST API 版本： 2.1.47, Build time 2024-05-16T06:53:00+0000, Hash 07f225e
   
       英特尔® 至强® 处理器
       2 个内核 @ 2199.998MHz
       8GB 内存
       4GB 交换
       150 GB/分区
       150 GB /数据分区
   

9. 清理/data/upgrade目录。

   
   rm /data/upgrade/installRPMs.tar
   
   rm /data/upgrade/DigiCert-cs.crt
   
   rm /data/upgrade/ibm-sevone-cs.crt
   
   rm -rf /data/upgrade/ansible
   
   

10. 执行以下命令以识别错误 (如果有)。

    SevOne-act check checkout --full-cluster --verbose

在使用上述其中一个选项重新引导集群中的设备之前，必须记下集群中作为集群引导者的设备。 从 管理 > 集群管理器 > 集群概述 选项卡> 字段 集群引导者 提供作为 引导者的设备的名称。 例如，如以下截屏中所示， pandora-01 是 集群引导者。

在执行设备重新引导时不需要执行故障转移/故障恢复，但为了最大限度减少由于重新引导而导致的轮询停机时间，此选项可用于在主/辅助设备之间执行故障转移，重新引导和故障恢复。

必须按每个同级手动执行故障转移操作，建议不要同时在多个同级上执行故障转移。 但是，可以同时以 4 到 5 设备的批处理方式重新引导多个设备。 请务必注意，集群引导程序对的故障转移步骤必须在重新引导所有其他设备后最后完成。

如果升级位于完整的维护窗口中，并且在重新启动设备期间可接受轮询中断，那么您可以选择按任何顺序执行重新启动设备。 但是， SevOne 始终建议首先重新启动 passive 设备，然后重新启动所有同级的 active 设备。

从活动集群引导程序执行以下脚本。

for IP in $(SevOne-peer-list); do echo -en "IP: $IP \t"; ssh $IP 'echo -e "Hostname: $(hostname) \t
System Uptime: $(uptime)" '; done

1. 清理/data/upgrade目录。

   
   rm /data/upgrade/installRPMs.tar
   
   rm /data/upgrade/DigiCert-cs.crt
   
   rm /data/upgrade/ibm-sevone-cs.crt
   
   rm -rf /data/upgrade/ansible
   

2. 在重新引导成功完成后， SSH 返回到 SevOne NMS 集群的活动集群引导程序，以检查已安装的 内核 软件包。 请参阅下表以确认您具有正确的内核版本。

   检查内核版本

   
   podman exec -it nms-nms-nms /bin/bash
   
   SevOne-show-version
   OR
   rpm -qa | grep kernel
   OR
   uname -r

   重要： 内核会在升级过程中自动更新，并非每个 NMS 版本都有新内核。

   根据 NMS 发行版，内核版本必须为:

   SevOne NMS 版本	内核版本
   NMS7.1.0	4.18.0-553.8.1.el8_10.x86_64
   NMS7.0.1	4.18.0-553.el8_10

   内核版本基于 NMS 发行版。

   内核版本必须基于 NMS 发行版。 否则，必须通过执行以下步骤来重新引导整个集群以应用新内核，否则不需要重新引导。

   
   podman exec -it nms-nms-nms /bin/bash
   
   SevOne-shutdown reboot

3. 验证操作系统版本。 升级后确认版本为 Red Hat Enterprise Linux 。

   cat /etc/redhat-release
               

   Red Hat Enterprise Linux 发布 8.9 (Ootpa)

4. 执行以下命令以识别错误 (如果有)。

   SevOne-act check checkout --full-cluster --verbose

日志文件可在 /var/SevOne/ansible-upgrade/<fromVersion-toVersion>/<timestamp>/<peerIP>.log 中找到。

例如， /var/SevOne/ansible-upgrade/v7.0.1-v7.1.0/<timestamp>/<peerIP>.log

• 每个同级都将有自己的日志文件位于集群引导者上。
• 将为升级的每次运行创建新的日志文件，并按时间戳记文件夹进行拆分。