简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

升级 Element 软件

10/01/2024 贡献者

要升级NetApp Element 软件、您可以使用NetApp混合云控制UI或REST API。Element 软件升级期间会禁止某些操作，例如添加和删除节点，添加和删除驱动器以及与启动程序，卷访问组和虚拟网络等关联的命令。

从Element 12.5开始、Element软件升级不再支持NetApp HealthTools。如果您运行的是Element 11.0或11.1、则必须先"使用HealthTools升级到Element 12.3.x"使用NetApp混合云控制升级到Element 12.5或更高版本。

您需要的内容

* 管理员权限 * ：您拥有执行升级的存储集群管理员权限。
有效的升级路径：您已检查要升级到的Element版本的升级路径信息、并确认升级路径有效。https://kb.netapp.com/Advice_and_Troubleshooting/Data_Storage_Software/Element_Software/What_is_the_upgrade_matrix_for_storage_clusters_running_NetApp_Element_software%3F["NetApp 知识库：运行 NetApp Element 软件的存储集群的升级表"^]
* 系统时间同步 * ：您已确保所有节点上的系统时间均已同步，并且已为存储集群和节点正确配置 NTP 。必须在每节点Web UI中为每个节点配置一个DNS名称服务器(https://[IP address]:442，并且没有与时间偏差相关的未解决集群故障。
* 系统端口 * ：如果您使用 NetApp Hybrid Cloud Control 进行升级，则已确保必要的端口处于打开状态。有关详细信息、请参见 "网络端口" 。
* 管理节点 * ：对于 NetApp Hybrid Cloud Control UI 和 API ，您环境中的管理节点运行的是 11.3 版。
* 管理服务 * ：您已将管理服务捆绑包更新到最新版本。

在将Element软件升级到版本12.5或更高版本之前、您必须升级到最新的管理服务包。如果要将Element软件更新到版本12.5或更高版本、则需要使用管理服务2.21.61或更高版本才能继续。

* 集群运行状况 * ：您已验证集群是否已做好升级准备。请参阅。 "在升级存储之前，请运行 Element 存储运行状况检查"
已更新H610S存储节点的基板管理控制器(BMC)：您已升级H610S节点的BMC版本。请参见"发行说明和升级说明"。

升级过程时间：您已计划足够的时间执行升级。升级到Element软件12.5或更高版本时、升级过程时间会因您当前的Element软件版本和固件更新而异。

存储节点	当前Element软件版本	每个节点的大致软件和固件安装时间¹	每个节点的大致数据同步时间²	每个节点的大致升级总时间
具有最新固件³的所有SolidFire 和NetApp H系列节点	12.x	15分钟	10到15分钟	20到30分钟
H610S和H410S	12.x和11.8	60分钟	30到60分钟	90到120分钟
H610S	11.7及更早版本	90分钟	40到70分钟	每个H610S节点还必须等待130到160分钟 "完全关闭节点并断开电源"。

存储节点

当前Element软件版本

每个节点的大致软件和固件安装时间¹

每个节点的大致数据同步时间²

每个节点的大致升级总时间

具有最新固件³的所有SolidFire 和NetApp H系列节点

12.x

15分钟

10到15分钟

20到30分钟

H610S和H410S

12.x和11.8

60分钟

30到60分钟

90到120分钟

H610S

11.7及更早版本

90分钟

40到70分钟

每个H610S节点还必须等待130到160分钟 "完全关闭节点并断开电源"。

¹有关硬件的固件和驱动程序固件的完整列表，请参阅"SolidFire 存储节点支持的存储固件版本"。

²如果将写入IOPS负载较重的集群与较长的固件更新时间结合使用、则数据同步时间将会增加。

³从Element 12.7开始、不支持SF2405和SF9608存储节点以及FC0025和SF-FCN-01 FC节点。如果您尝试将其中一个节点升级到Element 12.7、则会看到一条错误、指出Element 12.7不支持此节点。

最终用户许可协议(EULA)：从管理服务2.20.69开始、您必须先接受并保存此EULA、然后才能使用NetApp Hybrid Cloud Control UI或API升级Element软件：
1. 在Web浏览器中打开管理节点的IP地址：
  https://<ManagementNodeIP>
2. 通过提供存储集群管理员凭据登录到 NetApp Hybrid Cloud Control 。
3. 选择靠近接口右上角的 * 升级 * 。
4. 此时将弹出EULA。向下滚动、选择*我接受当前更新和所有未来更新*、然后选择*保存*。

升级选项

选择以下 Element 软件升级选项之一：

使用 NetApp Hybrid Cloud Control UI 升级 Element 存储
使用 NetApp Hybrid Cloud Control API 升级 Element 存储

如果要将H610S系列节点升级到Element 12.5或更高版本、并且此节点运行的Element版本早于11.8、则需要对每个存储节点执行此中的其他升级步骤 "知识库文章"。如果您运行的是Element 11.8或更高版本、则不需要执行其他升级步骤。

使用 NetApp Hybrid Cloud Control UI 升级 Element 存储

您可以使用 NetApp Hybrid Cloud Control UI 升级存储集群。

有关使用NetApp混合云控制升级存储集群时的潜在问题及其解决方法，请参见此 "知识库文章"。

步骤

在Web浏览器中打开管理节点的IP地址：
```
https://<ManagementNodeIP>
```
通过提供存储集群管理员凭据登录到 NetApp Hybrid Cloud Control 。
选择靠近接口右上角的 * 升级 * 。
在 * 升级 * 页面上，选择 * 存储 * 。
- 存储 * 选项卡列出了安装过程中的存储集群。如果 NetApp Hybrid Cloud Control 无法访问某个集群，则该集群将不会显示在 * 升级 * 页面上。

从以下选项中进行选择，并执行一组适用于您的集群的步骤：

选项

步骤

运行Element 11.8及更高版本的所有集群

选择 * 浏览 * 上传您下载的升级软件包。
等待上传完成。进度条会显示上传状态。

如果您离开浏览器窗口，则文件上传将丢失。

成功上传并验证文件后，将显示一条屏幕消息。验证可能需要几分钟时间。如果在此阶段离开浏览器窗口，则会保留文件上传。

选择 * 开始升级 * 。

升级期间， * 升级状态 * 会发生更改，以反映此过程的状态。它也会根据您执行的操作而发生更改，例如暂停升级或升级返回错误。请参阅。升级状态更改

在升级过程中，您可以退出此页面，稍后再返回此页面以继续监控进度。如果集群行已折叠，则此页面不会动态更新状态和当前版本。必须展开集群行才能更新此表，您也可以刷新此页面。

升级完成后，您可以下载日志。

您要升级运行的 Element 版本早于 11.8 的 H610S 集群。

选择要升级的集群旁边的下拉箭头，然后从可用的升级版本中进行选择。
选择 * 开始升级 * 。升级完成后、UI将提示您执行其他升级步骤。
完成中所需的其他步骤，并在UI中 "知识库文章"确认您已完成第2阶段。

升级完成后，您可以下载日志。有关各种升级状态更改的信息，请参见升级状态更改。

升级状态更改

以下是用户界面中的 * 升级状态 * 列在升级过程之前，期间和之后显示的不同状态：

升级状态	说明
最新	集群已升级到最新可用的 Element 版本。
可用版本	可以升级较新版本的 Element 和 / 或存储固件。
进行中	正在升级。进度条会显示升级状态。屏幕上的消息还会显示节点级别的故障，并在升级过程中显示集群中每个节点的节点 ID 。您可以使用 Element UI 或适用于 vCenter Server 的 NetApp Element 插件 UI 监控每个节点的状态。
升级暂停	您可以选择暂停升级。根据升级过程的状态，暂停操作可能会成功或失败。您将看到一个 UI 提示，要求您确认暂停操作。要确保集群在暂停升级之前处于安全位置，可能需要长达两个小时才能完全暂停升级操作。要恢复升级，请选择 * 恢复 * 。
已暂停	您已暂停升级。选择 * 恢复 * 以恢复此过程。
错误	升级期间发生错误。您可以下载错误日志并将其发送给 NetApp 支持部门。解决此错误后，您可以返回到页面并选择 * 恢复 * 。恢复升级时，进度条会后退几分钟，而系统会运行运行状况检查并检查升级的当前状态。
完成并进行跟进	仅适用于从早于 118 的 Element 版本升级的 H610S 节点。升级过程的第1阶段完成后，此状态将提示您执行其他升级步骤(请参见 "知识库文章")。完成第 2 阶段并确认已完成后，状态将变为 * 最新 * 。

升级状态

说明

使用 NetApp Hybrid Cloud Control API 升级 Element 存储

您可以使用 API 将集群中的存储节点升级到最新的 Element 软件版本。您可以使用自己选择的自动化工具来运行 API 。此处介绍的 API 工作流使用管理节点上提供的 REST API UI 作为示例。

步骤

将存储升级软件包下载到可供管理节点访问的设备。

转到Element软件 "下载页面"并下载最新的存储节点映像。
将存储升级软件包上传到管理节点：
1. 在管理节点上打开管理节点 REST API UI ：
  https://<ManagementNodeIP>/package-repository/1/
2. 选择 * 授权 * 并完成以下操作：
  1. 输入集群用户名和密码。
  2. 将客户端ID输入为 mnode-client。
  3. 选择 * 授权 * 以开始会话。
  4. 关闭授权窗口。
3. 从 REST API UI 中，选择 * POST /packages* 。
4. 选择 * 试用 * 。
5. 选择 * 浏览 * 并选择升级软件包。
6. 选择 * 执行 * 以启动上传。
7. 从响应中，复制并保存软件包ID ("id"()，以供稍后使用。
验证上传状态。
1. 从 REST API UI 中，选择 * GET /v í packages / ｛ id ｝ /status* 。
2. 选择 * 试用 * 。
3. 在 * id * 中输入上一步复制的软件包 ID 。
4. 选择 * 执行 * 以启动状态请求。
  
  完成后、响应指示 state`为 `SUCCESS。
找到存储集群 ID ：
1. 在管理节点上打开管理节点 REST API UI ：
  https://<ManagementNodeIP>/inventory/1/
2. 选择 * 授权 * 并完成以下操作：
  1. 输入集群用户名和密码。
  2. 将客户端ID输入为 mnode-client。
  3. 选择 * 授权 * 以开始会话。
  4. 关闭授权窗口。
3. 从 REST API UI 中，选择 * 获取 /installations * 。
4. 选择 * 试用 * 。
5. 选择 * 执行 * 。
6. 从响应中，复制安装资产ID("id")。
7. 从 REST API UI 中，选择 * 获取 /installations/ ｛ id ｝ * 。
8. 选择 * 试用 * 。
9. 将安装资产 ID 粘贴到 * id * 字段中。
10. 选择 * 执行 * 。
11. 根据响应、复制并保存(`"id"`要升级的集群的存储集群ID ()、以供稍后使用。

运行存储升级：

在管理节点上打开存储 REST API UI ：
```
https://<ManagementNodeIP>/storage/1/
```
选择 * 授权 * 并完成以下操作：
1. 输入集群用户名和密码。
2. 将客户端ID输入为 mnode-client。
3. 选择 * 授权 * 以开始会话。
4. 关闭授权窗口。
选择 * POST /upgrades* 。
选择 * 试用 * 。
在参数字段中输入升级软件包 ID 。

在参数字段中输入存储集群 ID 。

有效负载应类似于以下示例：

{
  "config": {},
  "packageId": "884f14a4-5a2a-11e9-9088-6c0b84e211c4",
  "storageId": "884f14a4-5a2a-11e9-9088-6c0b84e211c4"
}

选择 * 执行 * 以启动升级。

响应应指示状态为 initializing：

{
  "_links": {
    "collection": "https://localhost:442/storage/upgrades",
    "self": "https://localhost:442/storage/upgrades/3fa85f64-1111-4562-b3fc-2c963f66abc1",
    "log": https://localhost:442/storage/upgrades/3fa85f64-1111-4562-b3fc-2c963f66abc1/log
  },
  "storageId": "114f14a4-1a1a-11e9-9088-6c0b84e200b4",
  "upgradeId": "334f14a4-1a1a-11e9-1055`-6c0b84e2001b4",
  "packageId": "774f14a4-1a1a-11e9-8888-6c0b84e200b4",
  "config": {},
  "state": "initializing",
  "status": {
    "availableActions": [
      "string"
    ],
    "message": "string",
    "nodeDetails": [
      {
        "message": "string",
        "step": "NodePreStart",
        "nodeID": 0,
        "numAttempt": 0
      }
    ],
    "percent": 0,
    "step": "ClusterPreStart",
    "timestamp": "2020-04-21T22:10:57.057Z",
    "failedHealthChecks": [
      {
        "checkID": 0,
        "name": "string",
        "displayName": "string",
        "passed": true,
        "kb": "string",
        "description": "string",
        "remedy": "string",
        "severity": "string",
        "data": {},
        "nodeID": 0
      }
    ]
  },
  "taskId": "123f14a4-1a1a-11e9-7777-6c0b84e123b2",
  "dateCompleted": "2020-04-21T22:10:57.057Z",
  "dateCreated": "2020-04-21T22:10:57.057Z"
}

复制(`"upgradeId"`响应中的升级ID。

验证升级进度和结果：

选择 * 获取 /upgrades/｛ upgradeId ｝ * 。
选择 * 试用 * 。
在 * 升级 Id* 中输入上一步中的升级 ID 。
选择 * 执行 * 。

如果在升级期间出现问题或存在特殊要求，请执行以下操作之一：

选项步骤

选项	步骤
您需要更正由于响应正文中的消息而导致的集群运行状况问题 `failedHealthChecks`。	转至为每个问题描述列出的特定知识库文章，或者执行指定的补救措施。如果指定了 KB ，请完成相关知识库文章中所述的过程。解决集群问题后，如果需要，请重新进行身份验证，然后选择 * PUT /upgrades/｛ upgradeId ｝ * 。选择 * 试用 * 。在 * 升级 Id* 中输入上一步中的升级 ID 。在请求正文中输入 `"action":"resume"`。 { "action": "resume" } 选择 * 执行 * 。
由于维护窗口正在关闭或其他原因，您需要暂停升级。	如果需要，请重新进行身份验证并选择 * PUT /upgrades/｛ upgradeId ｝ * 。选择 * 试用 * 。在 * 升级 Id* 中输入上一步中的升级 ID 。在请求正文中输入 `"action":"pause"`。 { "action": "pause" } 选择 * 执行 * 。
如果您要升级运行的Element版本早于11.8的H610S集群、则会在响应正文中显示相应状态 `finishedNeedsAck`。您必须对每个H610S存储节点执行其他升级步骤。	为每个节点完成此中的其他升级步骤 "知识库文章"。如果需要，请重新进行身份验证并选择 * PUT /upgrades/｛ upgradeId ｝ * 。选择 * 试用 * 。在 * 升级 Id* 中输入上一步中的升级 ID 。在请求正文中输入 `"action":"acknowledge"`。 { "action": "acknowledge" } 选择 * 执行 * 。

您需要更正由于响应正文中的消息而导致的集群运行状况问题 failedHealthChecks。

转至为每个问题描述列出的特定知识库文章，或者执行指定的补救措施。
如果指定了 KB ，请完成相关知识库文章中所述的过程。
解决集群问题后，如果需要，请重新进行身份验证，然后选择 * PUT /upgrades/｛ upgradeId ｝ * 。
选择 * 试用 * 。
在 * 升级 Id* 中输入上一步中的升级 ID 。
在请求正文中输入 "action":"resume"。
```
{
  "action": "resume"
}
```
选择 * 执行 * 。

由于维护窗口正在关闭或其他原因，您需要暂停升级。

如果需要，请重新进行身份验证并选择 * PUT /upgrades/｛ upgradeId ｝ * 。
选择 * 试用 * 。
在 * 升级 Id* 中输入上一步中的升级 ID 。
在请求正文中输入 "action":"pause"。
```
{
  "action": "pause"
}
```
选择 * 执行 * 。

如果您要升级运行的Element版本早于11.8的H610S集群、则会在响应正文中显示相应状态 finishedNeedsAck。您必须对每个H610S存储节点执行其他升级步骤。

为每个节点完成此中的其他升级步骤 "知识库文章"。
如果需要，请重新进行身份验证并选择 * PUT /upgrades/｛ upgradeId ｝ * 。
选择 * 试用 * 。
在 * 升级 Id* 中输入上一步中的升级 ID 。
在请求正文中输入 "action":"acknowledge"。
```
{
  "action": "acknowledge"
}
```
选择 * 执行 * 。

根据需要多次运行 * 获取 /upgrades/｛ upgradeId ｝ * API ，直到此过程完成。

在升级期间、会 status`指示 `running`是否未遇到错误。升级每个节点后，该值将 `step`更改为 `NodeFinished。

如果值为 100`且指示 `finished， state`则升级已成功完成 `percent。

使用 NetApp Hybrid Cloud Control 升级失败时会发生什么情况

如果驱动器或节点在升级期间发生故障， Element UI 将显示集群故障。升级过程不会继续到下一个节点，而是等待集群故障解决。UI 中的进度条显示升级正在等待集群故障解决。在此阶段，在 UI 中选择 * 暂停 * 将不起作用，因为升级会等待集群运行正常。您需要联系 NetApp 支持部门以协助进行故障调查。

NetApp Hybrid Cloud Control 具有预先设置的三小时等待时间，在此期间可能会发生以下情况之一：

集群故障将在三小时内得到解决，升级将继续进行。在这种情况下，您无需执行任何操作。
此问题在三小时后仍然存在，并且升级状态显示 * 错误 * 并显示红色横幅。解决问题后，您可以通过选择 * 恢复 * 来恢复升级。
NetApp 支持部门已确定需要暂时中止升级，以便在三小时内采取更正措施。支持人员将使用 API 中止升级。

在更新节点时中止集群升级可能会导致驱动器异常地从节点中删除。如果驱动器被异常删除，则在升级期间重新添加驱动器需要 NetApp 支持部门手动干预。节点执行固件更新或更新后同步活动可能需要较长时间。如果升级进度似乎停滞，请联系 NetApp 支持部门以获得帮助。

升级 Element 软件

Creating your file...

使用 NetApp Hybrid Cloud Control UI 升级 Element 存储

升级状态更改

使用 NetApp Hybrid Cloud Control API 升级 Element 存储

使用 NetApp Hybrid Cloud Control 升级失败时会发生什么情况

了解更多信息