你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

更新 Defender for IoT OT 监视软件

本文介绍如何在 OT 传感器和旧式本地管理控制台设备上更新 Defender for IoT 软件版本。

可以为你的传感器和旧式本地管理控制台购买预配置的设备，或者在自己的硬件计算机上安装软件。 无论哪种情况，都需要更新软件版本才可使用 OT 传感器和本地管理控制台的新功能。

有关详细信息，请参阅需要哪些设备？、用于 OT 监视的预配置物理设备以及 OT 监视软件发行说明。

注意

更新文件仅适用于当前支持的版本。 如果你的 OT 网络传感器具有不再受支持的旧软件版本，请开具支持票证以访问相关文件以进行你的更新。

先决条件

若要执行本文中所述的过程，请确保你具有：

• 要更新的 OT 传感器的列表，以及要使用的更新方法。 要更新的每个传感器必须同时已加入到 Defender for IoT 并已激活。

  更新方案	方法详细信息
  本地管理控制台	如果要更新的 OT 传感器连接到本地管理控制台，请在更新传感器之前先计划更新本地管理控制台。
  连接云的传感器	连接到云的传感器可以远程更新、直接从 Azure 门户更新，也可以使用下载的更新包手动进行更新。 远程更新要求你的 OT 传感器已安装版本 22.2.3 或更高版本。
  本地托管传感器	可以使用下载的更新包（通过连接的本地管理控制台或直接在 OT 传感器控制台上）更新本地管理的传感器。

• 所需的访问权限：

  • 要从 Azure 门户下载更新包或推送更新，需要以安全管理员、参与者或所有者用户的身份访问 Azure 门户。

  • 要在 OT 传感器或本地管理控制台上运行更新，需要以管理员用户的身份进行访问。

  • 要通过 CLI 更新 OT 传感器，需要以特权用户的身份访问传感器。

  有关详细信息，请参阅 Defender for IoT 的 Azure 用户角色和权限和使用 Defender for IoT 进行 OT 监视的本地用户和角色。

重要

建议验证是否定期运行传感器备份，尤其是在更新传感器软件之前。

有关详细信息，请参阅从传感器控制台备份和还原 OT 网络传感器。

验证网络要求

• 确保传感器可以访问 Azure 数据中心地址范围，并设置组织所用连接方法所需的任何额外资源。

  有关详细信息，请参阅 OT 传感器云连接方法和将 OT 传感器连接到云。

• 确保根据要更新到的新版本配置防火墙规则。

  例如，新版本可能需要使用新的或经过修改的防火墙规则来支持传感器访问 Azure 门户。 在“站点和传感器”页面中，选择“更多操作”>“下载传感器终结点详细信息”，以获取访问 Azure 门户所需的终结点的完整列表。

  有关详细信息，请参阅网络要求和 Azure 门户中的传感器管理选项。

更新 OT 传感器

本部分介绍如何使用任何受支持的方法更新 Defender for IoT OT 传感器。

发送或下载更新包和运行更新是两个单独的步骤。 每个步骤可以一个接一个地完成，也可以在不同的时间完成。

例如，你可能希望先将更新发送到传感器或下载并更新包，然后让管理员稍后在计划内维护时段运行更新。

如果使用的是旧式本地管理控制台，请确保先更新本地管理控制台，然后再更新任何已连接的传感器。

本地管理软件向后兼容，可以连接到安装了早期版本的传感器，但不能连接到安装了更高版本的传感器。 如果在更新本地管理控制台之前更新传感器软件，则更新后的传感器将与本地管理控制台断开连接。

选择要使用的更新方法：

Azure 门户（预览版）

此过程介绍如何将软件版本更新发送到一个或多个站点的 OT 传感器，然后使用 Azure 门户远程运行更新。 建议通过选择站点而不是单个传感器来更新传感器。

将软件更新发送到 OT 传感器

1. 在 Azure 门户的 Defender for IoT 中，选择“站点和传感器”。

   如果知道网站和传感器名称，则可以直接浏览或搜索它，或应用筛选器来帮助查找所需的网站。

2. 选择要更新的一个或多个传感器，然后选择“传感器更新”>“远程更新”>“步骤 1: 将包发送到传感器”。

   对于一个或多个单个传感器，请选择“步骤一：将包发送到传感器”。 还可以从传感器行右侧的“...”选项菜单使用此选项。

3. 在显示的“发送包”窗格中的“可用版本”下，从列表中选择软件版本。 如果未显示所需的版本，请选择“显示更多”以列出所有可用版本。

   若要跳转到新版本的发行说明，请选择窗格顶部的“了解详情”。

   页面的下半部分会显示所选传感器及其状态。 验证传感器的状态。 由于各种原因，传感器可能无法进行更新，例如，传感器已更新到要发送的版本，或者传感器出现断开连接等问题。

   

4. 检查要更新的传感器列表后，请选择“发送包”，然后会开始向传感器计算机传输软件。 可以在“传感器版本”列中查看传输进度，并且进度栏中会自动更新已完成百分比，因此可以看到该过程已启动，并且可以跟踪其进度，直到传输完成。 例如：

   

   传输完成后，“传感器版本”列更改为“ 准备更新”。

   将鼠标悬停在“传感器版本”值上可查看更新的源版本和目标版本。

从 Azure 门户安装传感器

要安装传感器软件更新，请确保在“传感器版本”列中看到“可以更新”图标。

1. 选择要更新的一个或多个站点，然后从工具栏依次选择“传感器更新”>“远程更新”>“步骤 2: 更新传感器”。 此时，屏幕右侧应会打开“更新传感器”窗格。

   

   对于单个传感器，还可以从“...”选项菜单中使用“步骤 2: 更新传感器”选项。

2. 在显示的“更新传感器”窗格中，验证更新详细信息。

   准备就绪后，依次选择“立即更新”>“确认更新”以在传感器上安装更新。 在网格中，“传感器版本”值会更改为“正在安装”，此时会出现显示完成百分比的更新进度栏。 该栏会自动更新，以便跟踪进度，直到安装完成。

   

   完成后，传感器值将切换为新安装的传感器版本号。

如果传感器因任何原因无法更新，则软件会还原为已安装的上一个版本，并触发传感器运行状况警报。 有关详细信息，请参阅了解传感器运行状况和传感器运行状况消息参考。

OT 传感器 UI

此过程介绍如何手动下载新传感器软件版本，然后直接在传感器控制台的 UI 上运行更新。

从 Azure 门户下载更新包

1. 在 Azure 门户的 Defender for IoT 中，选择“站点和传感器”>“传感器更新（预览版）”。

2. 在“本地更新”窗格中，选择传感器上当前安装的软件版本。

3. 在“本地更新”窗格的“可用版本”区域中，选择要针对软件更新下载的版本。

   “可用版本”区域列出了可用于特定更新方案的所有更新包。 你可能会有多个选项，但已有一个特定版本标记为“推荐”。 例如：

   

4. 在“本地更新”窗格中进一步向下滚动，然后选择“下载”以下载更新包。

   随即会下载更新包，文件语法名称为 sensor-secured-patcher-<Version number>.tar，其中 version number 是要更新到的版本。

   从 Azure 门户下载的所有文件均由信任根签名，以便计算机仅使用已签名资产。

从传感器 UI 更新 OT 传感器软件

1. 登录到你的 OT 传感器，选择“系统设置”>“传感器管理”>“软件更新”。

2. 在右侧的“软件更新”窗格中，选择“上传文件”，然后导航到下载的更新包并将其选中。

   

   更新过程随即开始，可能需要大约 30 分钟才能完成，并且会包括一两次重启。 如果计算机重启，请确保按照提示重新登录。

OT 传感器 CLI

此过程介绍如何通过 CLI 直接在 OT 传感器上更新 OT 传感器软件。

重要

如果使用的是本地管理控制台，请确保在更新任何连接的传感器之前更新了本地管理控制台。

从 Azure 门户下载更新包

1. 在 Azure 门户的 Defender for IoT 中，选择“站点和传感器”>“传感器更新（预览版）”。

2. 在“本地更新”窗格中，选择传感器上当前安装的软件版本。

3. 在“本地更新”窗格的“可用版本”区域中，选择要针对软件更新下载的版本。

   “可用版本”区域列出了可用于特定更新方案的所有更新包。 你可能有多个选项，但始终会有一个标记为为你“推荐”的特定版本。 例如：

   

4. 在“本地更新”窗格中进一步向下滚动，然后选择“下载”以下载软件文件。

   随即会下载更新包，文件语法名称为 sensor-secured-patcher-<Version number>.tar，其中 version number 是要更新到的版本。

从 Azure 门户下载的所有文件均由信任根签名，以便计算机仅使用已签名资产。

直接通过 CLI 从传感器更新传感器软件

1. 使用 SFTP 或 SCP 将已从 Azure 门户下载的更新包复制到 OT 传感器计算机。

2. 以 support 用户身份登录到传感器，访问系统 Shell，并将更新文件复制到更新过程可访问的位置。 例如：

   cd /var/host-logs/ 
   mv <filename> /var/cyberx/media/device-info/update_agent.tar
   

3. 开始运行软件更新。 运行：

   curl -H "X-Auth-Token: $(python3 -c 'from cyberx.credentials.credentials_wrapper import CredentialsWrapper;creds_wrapper = CredentialsWrapper();print(creds_wrapper.get("api.token"))')" -X POST http://127.0.0.1:9090/core/api/v1/configuration/agent
   

   在更新过程中的某个时刻，你的 SSH 连接会断开。 这很好地表明更新正在运行。

4. 通过检查 install.log 文件继续监视更新过程。

   以 cyberx_host 用户身份登录传感器，并运行：

   tail -f /opt/sensor/logs/install.log
   

确认更新成功

若要确认更新过程是否已成功完成，请在以下位置中检查传感器版本以获取新的版本号：

• 在 Azure 门户中“站点和传感器”页上的“传感器版本”列中

• 在 OT 传感器控制台上：

  • 在标题栏中
  • 在“概述”页上>“常规设置”区域
  • 在“系统设置”>“传感器管理”>“软件更新”窗格中

• 在连接的本地管理控制台上的“站点管理”页上

升级日志文件位于 OT 传感器计算机上的 /opt/sensor/logs/legacy-upgrade.log 处，cyberx_host 用户可以通过 SSH 进行访问。

更新本地管理控制台

此过程介绍如何更新本地管理控制台软件。 在从 Azure 门户远程更新 OT 传感器或作为独立更新过程进行之前，可能需要执行这些步骤。

更新本地管理控制台大约需要 30 分钟。

重要

如果要在 OT 传感器过程中更新本地管理控制台，则必须在更新 OT 传感器之前更新本地管理控制台。

本地管理控制台上的软件版本必须等于或大于你的最新传感器版本。 每个本地管理控制台版本都向后兼容受支持的早期传感器版本，但无法连接到较新的传感器版本。

从 Azure 门户下载更新包

此过程介绍如何下载用于独立更新的更新包。 如果要将本地管理控制台与连接的传感器一起更新，建议改为使用“站点和传感器”页上的“更新传感器(预览版)”菜单。

1. 在 Azure 门户的 Defender for IoT 中，选择“开始使用”>“本地管理控制台”。

2. 在“本地管理控制台”区域中，选择最符合你的更新的下载方案，然后选择“下载”。

   随即会下载更新包，文件语法名称为 management-secured-patcher-<version number>.tar，其中 <version number> 是要更新到的软件版本号。

从 Azure 门户下载的所有文件均由信任根签名，以便计算机仅使用已签名资产。

更新本地管理控制台软件版本

1. 登录到你的本地管理控制台，选择“系统设置”>“版本更新”。

2. 在“上传文件”对话框中，选择“浏览文件”，然后浏览到并选择从 Azure 门户下载的更新文件。

   更新过程将启动，可能需要大约 30 分钟。 在升级期间，系统会重新启动两次。

3. 在出现提示时登录，并检查左下角列出的版本号，以确认是否列出了新版本。

后续步骤

有关详细信息，请参阅：

• 在 Azure 门户中使用 Defender for IoT 管理传感器
• 管理单个 OT 传感器
• 管理本地管理控制台
• 排查传感器的问题
• 排查本地管理控制台的问题