community.general.ibm_sa_host – Adds hosts to or removes them from IBM Spectrum Accelerate Family storage systems.
Note
This plugin is part of the community.general collection (version 2.0.1).
To install it use: ansible-galaxy collection install community.general.
To use it in a playbook, specify: community.general.ibm_sa_host.
Synopsis
- This module adds hosts to or removes them from IBM Spectrum Accelerate Family storage systems.
Requirements
The below requirements are needed on the host that executes this module.
- python >= 2.7
- pyxcli
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| cluster  string  | The name of the cluster to include the host. | |
| domain  string  | The domains the cluster will be attached to. To include more than one domain, separate domain names with commas. To include all existing domains, use an asterisk ("*"). | |
| endpoints  string / required  | The hostname or management IP of Spectrum Accelerate storage system. | |
| host  string / required  | Host name. | |
| iscsi_chap_name  string  | The host's CHAP name identifier | |
| iscsi_chap_secret  string  | The password of the initiator used to authenticate to the system when CHAP is enable | |
| password  string / required  | Password for username on the spectrum accelerate storage system. | |
| state  string  | 
 | Host state. | 
| username  string / required  | Management user on the spectrum accelerate storage system. | 
Notes
Note
- This module requires pyxcli python library. Use ‘pip install pyxcli’ in order to get pyxcli.
Examples
- name: Define new host.
  community.general.ibm_sa_host:
    host: host_name
    state: present
    username: admin
    password: secret
    endpoints: hostdev-system
- name: Delete host.
  community.general.ibm_sa_host:
    host: host_name
    state: absent
    username: admin
    password: secret
    endpoints: hostdev-system
  Authors
- Tzur Eliyahu (@tzure)
    © 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
    https://docs.ansible.com/ansible/2.11/collections/community/general/ibm_sa_host_module.html