Docs4dev
Docs
ansible / latest / collections / netapp_eseries / santricity / na_santricity_host_module.html

netapp_eseries.santricity.na_santricity_host – NetApp E-Series manage eseries hosts

Note

This plugin is part of the netapp_eseries.santricity collection (version 1.2.13).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install netapp_eseries.santricity.

To use it in a playbook, specify: netapp_eseries.santricity.na_santricity_host.

Synopsis

  • Create, update, remove hosts on NetApp E-series storage arrays

Parameters

Parameter Choices/Defaults Comments
api_password
string / required
The password to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
api_url
string / required
The url to the SANtricity Web Services Proxy or Embedded Web Services API.
Example https://prod-1.wahoo.acme.com:8443/devmgr/v2
api_username
string / required
The username to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
force_port
boolean
    Choices:
  • no
  • yes
Allow ports that are already assigned to be re-assigned to your current host
host_type
string
Host type includes operating system and multipath considerations.
If not specified, the default host type will be utilized. Default host type can be set using netapp_eseries.santricity.na_santricity_global.
For storage array specific options see netapp_eseries.santricity.na_santricity_facts.
All values are case-insensitive.
AIX MPIO - The Advanced Interactive Executive (AIX) OS and the native MPIO driver
AVT 4M - Silicon Graphics, Inc. (SGI) proprietary multipath driver
HP-UX - The HP-UX OS with native multipath driver
Linux ATTO - The Linux OS and the ATTO Technology, Inc. driver (must use ATTO FC HBAs)
Linux DM-MP - The Linux OS and the native DM-MP driver
Linux Pathmanager - The Linux OS and the SGI proprietary multipath driver
Mac - The Mac OS and the ATTO Technology, Inc. driver
ONTAP - FlexArray
Solaris 11 or later - The Solaris 11 or later OS and the native MPxIO driver
Solaris 10 or earlier - The Solaris 10 or earlier OS and the native MPxIO driver
SVC - IBM SAN Volume Controller
VMware - ESXi OS
Windows - Windows Server OS and Windows MPIO with a DSM driver
Windows Clustered - Clustered Windows Server OS and Windows MPIO with a DSM driver
Windows ATTO - Windows OS and the ATTO Technology, Inc. driver

aliases: host_type_index
name
string / required
If the host doesn't yet exist, the label/name to assign at creation time.
If the hosts already exists, this will be used to uniquely identify the host to make any required changes

aliases: label
ports
list / elements=string
A list of host ports you wish to associate with the host.
Host ports are uniquely identified by their WWN or IQN. Their assignments to a particular host are uniquely identified by a label and these must be unique.
label
string / required
A unique label to assign to this port assignment.
port
string / required
The WWN or IQN of the hostPort to assign to this port definition.
type
string / required
    Choices:
  • iscsi
  • sas
  • fc
  • ib
  • nvmeof
The interface type of the port to define.
Acceptable choices depend on the capabilities of the target hardware/software platform.
ssid
string
Default:
1
The ID of the array to manage. This value must be unique for each array.
state
string
    Choices:
  • absent
  • present ←
Set to absent to remove an existing host
Set to present to modify or create a new host definition
validate_certs
boolean
    Choices:
  • no
  • yes ←
Should https certificates be validated?

Notes

Note

  • The E-Series Ansible modules require either an instance of the Web Services Proxy (WSP), to be available to manage the storage-system, or an E-Series storage-system that supports the Embedded Web Services API.
  • Embedded Web Services is currently available on the E2800, E5700, EF570, and newer hardware models.
  • M(netapp_e_storage_system) may be utilized for configuring the systems managed by a WSP instance.

Examples

- name: Define or update an existing host named "Host1"
  na_santricity_host:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: "Host1"
    state: present
    host_type_index: Linux DM-MP
    ports:
      - type: "iscsi"
        label: "PORT_1"
        port: "iqn.1996-04.de.suse:01:56f86f9bd1fe"
      - type: "fc"
        label: "FC_1"
        port: "10:00:FF:7C:FF:FF:FF:01"
      - type: "fc"
        label: "FC_2"
        port: "10:00:FF:7C:FF:FF:FF:00"

- name: Ensure a host named "Host2" doesn"t exist
  na_santricity_host:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: "Host2"
    state: absent

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
api_url
string
on success
the url of the API that this request was proccessed by

Sample:
https://webservices.example.com:8443
id
string
on success when state=present
the unique identifier of the host on the E-Series storage-system

Sample:
00000000600A098000AAC0C3003004700AD86A52
msg
string
on success
A user-readable description of the actions performed.

Sample:
The host has been created.
ssid
string
on success
the unique identifer of the E-Series storage-system with the current api

Sample:
1


Authors

  • Kevin Hulquest (@hulquest)
  • Nathan Swartz (@ndswartz)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp_eseries/santricity/na_santricity_host_module.html