ibm.storage_virtualize.ibm_svc_host 模块 – 此模块管理 IBM Storage Virtualize 系列系统上的主机
注意
此模块是 ibm.storage_virtualize 集合 (版本 2.5.0) 的一部分。
如果您正在使用 ansible
包,您可能已经安装了此集合。 它不包含在 ansible-core
中。 要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install ibm.storage_virtualize
。
要在 playbook 中使用它,请指定:ibm.storage_virtualize.ibm_svc_host
。
ibm.storage_virtualize 1.0.0 中的新增功能
概要
用于管理 ‘mkhost’、‘chhost’ 和 ‘rmhost’ 主机命令的 Ansible 接口。
参数
参数 |
注释 |
---|---|
Storage Virtualize 系统的hostname 或管理 IP。 |
|
Storage Virtualize 系统的域。 当hostname 用于参数clustername时有效。 |
|
指定要分配给主机的草稿分区名称。 当 state=present 时有效,用于修改主机。 支持从 Storage Virtualize 系列系统 8.6.3.0 或更高版本。 |
|
要添加到主机的启动器 WWPN 的列表。必须提供完整的 WWPN 列表。 参数 fcwwpn 和 iscsiname 是互斥的。 当 state=present 时为必需,用于创建或修改光纤通道 (FC) 主机。 |
|
指定要将主机对象添加到的主机集群的名称。在将主机对象添加到主机集群之前,必须存在主机集群。 参数 hostcluster 和 nohostcluster 是互斥的。 当 state=present 时有效,用于创建或修改主机。 |
|
指定主机可以从中访问卷的一组或多个输入/输出 (I/O) 组。一旦指定,此参数将无法修改。 当 state=present 时有效,用于创建主机。 |
|
要添加到主机的启动器 IQN 的列表。 IQN 用逗号分隔。必须提供完整的 IQN 列表。 参数 fcwwpn 和 iscsiname 是互斥的。 当 state=present 时有效,用于创建主机。 |
|
调试日志文件的路径。 |
|
为新主机对象指定名称或标签。 |
|
如果指定为 参数 draftpartition 和 nodraftpartition 是互斥的。 当 state=present 时有效,用于修改现有主机。 支持从 Storage Virtualize 系列系统 8.6.3.0 或更高版本。 选项
|
|
如果指定为 参数 hostcluster 和 nohostcluster 是互斥的。 当 state=present 时有效,用于修改现有主机。 选项
|
|
如果指定为 参数 partition 和 nopartition 是互斥的。 当 state=present 时有效,用于修改现有主机。 支持从 Storage Virtualize 系列系统 8.6.1.0 或更高版本。 选项
|
|
要添加到主机的启动器 NQN 的列表。每个 NQN 用逗号分隔。必须提供完整的 NQN 列表。 当 protocol=rdmanvme 或 tcpnvme 时为必需,用于创建。 当 state=present 时有效,用于创建或修改主机。 |
|
指定重命名时主机的旧名称。 当 state=present 时有效,用于重命名现有主机。 |
|
指定要与主机关联的存储分区。 当 state=present 时有效,用于创建或修改主机。 支持从 Storage Virtualize 系列系统 8.6.1.0 或更高版本。 |
|
Storage Virtualize 系统的 REST API 密码。 如果不使用 token 对用户进行身份验证,则需要参数 username 和 password。 |
|
指定要与主机关联的端口集。 当 state=present 时有效,用于创建或修改主机。 |
|
指定主机用于与存储系统通信的协议。仅支持 ‘scsi’ 协议。 当 state=present 时有效,用于创建主机。 选项
|
|
指定主机的站点名称。 当 state=present 时有效,用于创建或修改主机。 |
|
创建或更新 ( 选项
|
|
用于验证 Storage Virtualize 系统上的用户的身份验证令牌。 要生成令牌,请使用 ibm.storage_virtualize.ibm_svc_auth 模块。 |
|
指定主机类型。 当 state=present 时有效,用于创建或修改主机。 |
|
Storage Virtualize 系统的 REST API 用户名。 如果不使用 token 对用户进行身份验证,则需要参数 username 和 password。 |
|
验证证书。 选项
|
注意
注意
此模块支持
check_mode
。
示例
- name: Define a new iSCSI host
ibm.storage_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.storage_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.storage_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.storage_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.storage_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: Create a tcpnvme host
ibm.storage_virtualize.ibm_svc_host:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: host_name
protocol: tcpnvme
nqn: nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06397
state: present
- name: Delete a host
ibm.storage_virtualize.ibm_svc_host:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: new_host_name
state: absent
- name: Add existing host to draft partition
ibm.storage_virtualize.ibm_svc_host:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: host_name
state: prersent
draftpartition: partition_name
- name: Remove a host from a draft partition
ibm.storage_virtualize.ibm_svc_host:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: host_name
state: present
nodraftpartition: True
- name: Create a fcnvme host
ibm.storage_virtualize.ibm_svc_host:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: host_name
protocol: fcnvme
nqn: nqn.2014-08.org.nvmexpress:b2071fa4-4356-410f-a4ae-7ebfab5b0e90
portset: portset_name
state: present