ibm.spectrum_virtualize.ibm_svc_host 模块 – 此模块管理 IBM Spectrum Virtualize 系列存储系统上的主机

注意

此模块是 ibm.spectrum_virtualize 集合 (版本 2.0.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install ibm.spectrum_virtualize。

要在剧本中使用它，请指定： ibm.spectrum_virtualize.ibm_svc_host。

注意

ibm.spectrum_virtualize 集合已重命名为 ibm.storage_virtualize，并将从 Ansible 12 中删除。如果您使用 ibm.spectrum_virtualize 中的内容，请更新剧本和角色中的 FQCN！创建新的剧本或角色时，请直接使用 ibm.storage_virtualize 中的内容。

ibm.spectrum_virtualize 1.0.0 中的新增功能

概要

  • 管理“mkhost”、“chhost”和“rmhost”主机命令的 Ansible 接口。

参数

参数

注释

clustername

字符串 / 必需

Spectrum Virtualize 存储系统的 hostname 或管理 IP。

domain

字符串

Spectrum Virtualize 存储系统的域名。

当参数 *clustername* 使用 hostname 时有效。

fcwwpn

字符串

要添加到主机的发起器 WWPN 列表。必须提供完整的 WWPN 列表。

参数 *fcwwpn* 和 *iscsiname* 是互斥的。

当 *state=present* 时必需，用于创建或修改光纤通道 (FC) 主机。

hostcluster

字符串

在 ibm.spectrum_virtualize 1.5.0 中添加

指定要将主机对象添加到其中的主机集群的名称。主机集群必须存在，然后才能将主机对象添加到其中。

参数 *hostcluster* 和 *nohostcluster* 是互斥的。

当 *state=present* 时有效，用于创建或修改主机。

iogrp

字符串

指定一组或多组输入/输出 (I/O) 组，主机可从中访问卷。指定后，此参数无法修改。

当 *state=present* 时有效，用于创建主机。

iscsiname

字符串

要添加到主机的发起器 IQN 列表。IQN 由逗号分隔。必须提供完整的 IQN 列表。

参数 *fcwwpn* 和 *iscsiname* 是互斥的。

当 *state=present* 时有效，用于创建主机。

log_path

字符串

调试日志文件的路径。

name

字符串 / 必需

指定新主机对象的名称或标签。

nohostcluster

布尔值

在 ibm.spectrum_virtualize 1.5.0 中添加

如果指定为 True，则主机对象将从主机集群中移除。

参数 *hostcluster* 和 *nohostcluster* 是互斥的。

当 *state=present* 时有效，用于修改现有主机。

选项

  • false

  • true

nqn

字符串

在 ibm.spectrum_virtualize 1.12.0 中添加

要添加到主机的发起器 NQN 列表。每个 NQN 由逗号分隔。必须提供完整的 NQN 列表。

当 *protocol=rdmanvme* 时必需，用于创建。

当 *state=present* 时有效，用于创建或修改主机。

old_name

字符串

在 ibm.spectrum_virtualize 1.9.0 中添加

重命名时指定主机的旧名称。

当 *state=present* 时有效，用于重命名现有主机。

password

字符串

Spectrum Virtualize 存储系统的 REST API 密码。

如果不使用 *token* 来验证用户，则需要 *username* 和 *password* 参数。

portset

字符串

在 ibm.spectrum_virtualize 1.12.0 中添加

指定要与主机关联的端口集。

当 *state=present* 时有效，用于创建或修改主机。

protocol

字符串

指定主机用于与存储系统通信的协议。“scsi”协议是唯一受支持的协议。

当 *state=present* 时有效，用于创建主机。

选项

  • "scsi"

  • "rdmanvme"

site

字符串

指定主机的站点名称。

当 *state=present* 时有效，用于创建或修改主机。

state

字符串 / 必需

创建或更新 (present) 或删除 (absent) 主机。

选项

  • "absent"

  • "present"

token

字符串

在 ibm.spectrum_virtualize 1.5.0 中添加

用于验证 Spectrum Virtualize 存储系统上用户的身份验证令牌。

要生成令牌，请使用 ibm.spectrum_virtualize.ibm_svc_auth 模块。

type

字符串

指定主机的类型。

当 *state=present* 时有效，用于创建或修改主机。

username

字符串

Spectrum Virtualize 存储系统的 REST API 用户名。

如果不使用 *token* 来验证用户，则需要 *username* 和 *password* 参数。

validate_certs

布尔值

验证证书。

选项

  • false ← (默认)

  • true

备注

注意

  • 此模块支持 check_mode。

示例

- name: Define a new iSCSI host
  ibm.spectrum_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host4test
    state: present
    iscsiname: iqn.1994-05.com.redhat:2e358e438b8a
    iogrp: 0:1:2:3
    protocol: scsi
    type: generic
    site: site-name
    portset: portset0
- name: Add a host to an existing host cluster
  ibm.spectrum_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host4test
    state: present
    hostcluster: hostcluster0
- name: Define a new FC host
  ibm.spectrum_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host4test
    state: present
    fcwwpn: 100000109B570216:1000001AA0570266
    iogrp: 0:1:2:3
    protocol: scsi
    type: generic
    site: site-name
- name: Rename an existing host
  ibm.spectrum_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    old_name: "host4test"
    name: "new_host_name"
    state: "present"
- name: Create an iSCSI host
  ibm.spectrum_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host_name
    iscsiname: iqn.1994-05.com.redhat:2e358e438b8a,iqn.localhost.hostid.7f000001
    state: present
- name: Delete a host
  ibm.spectrum_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: new_host_name
    state: absent

作者

  • Sreshtant Bohidar (@Sreshtant-Bohidar)

  • Rohit Kumar (@rohitk-github)