netapp_eseries.santricity.na_santricity_firmware 模块 – NetApp E 系列管理固件。

注意

此模块是 netapp_eseries.santricity 集合 (版本 1.4.1) 的一部分。

如果您使用的是 ansible 包,则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装它,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install netapp_eseries.santricity

要在剧本中使用它,请指定:netapp_eseries.santricity.na_santricity_firmware

概要

  • 确保在 E 系列存储系统上激活特定固件版本。

参数

参数

注释

api_password

字符串 / 必需

用于对 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。

api_url

字符串 / 必需

SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。

示例 https://prod-1.wahoo.acme.com:8443/devmgr/v2

api_username

字符串 / 必需

用于对 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。

clear_mel_events

布尔值

此标志将强制激活固件,即使存储系统存在 mel-event 问题。

警告!这将清除所有存储系统 mel-events。后果自负!

选项

  • false ← (默认)

  • true

firmware

字符串 / 必需

固件文件的路径。

由于并发问题,当在代理的同一实例上同时升级多个系统时,请使用 netapp_eseries.santricity.na_santricity_proxy_firmware_upload 将固件和 nvsram 上传到 SANtricity Web Services Proxy。

nvsram

字符串

NVSRAM 文件的路径。

NetApp 建议在升级固件时升级 NVSRAM。

由于并发问题,当在代理的同一实例上同时升级多个系统时,请使用 netapp_eseries.santricity.na_santricity_proxy_firmware_upload 将固件和 nvsram 上传到 SANtricity Web Services Proxy。

ssid

字符串

要管理的阵列的 ID。此值对于每个阵列必须唯一。

默认值: "1"

validate_certs

布尔值

是否应验证 https 证书?

选项

  • false

  • true ← (默认)

wait_for_completion

布尔值

此标志将导致模块等待任何升级操作完成。

当需要对固件和 nvsram 进行更改并且任务针对 SANtricity Web Services Proxy 执行时,必须先完成固件安装才能安装 nvsram。

选项

  • false ← (默认)

  • true

备注

注意

  • E 系列 Ansible 模块需要 Web Services Proxy (WSP) 实例可用以管理存储系统,或者支持嵌入式 Web Services API 的 E 系列存储系统。

  • 嵌入式 Web Services 目前适用于 E2800、E5700、EF570 和更新的硬件型号。

  • netapp_eseries.santricity.netapp_e_storage_system 可用于配置由 WSP 实例管理的系统。

示例

- name: Ensure correct firmware versions
  na_santricity_firmware:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    nvsram: "path/to/nvsram"
    firmware: "path/to/bundle"
    wait_for_completion: true
    clear_mel_events: true
- name: Ensure correct firmware versions
  na_santricity_firmware:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    nvsram: "path/to/nvsram"
    firmware: "path/to/firmware"

返回值

常见的返回值已在 此处 记录,以下是此模块特有的字段

描述

msg

字符串

固件和 NVSRAM 的状态和版本。

返回: 始终

作者

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)