dellemc.openmanage.ome_identity_pool – Manages identity pool settings on OpenManage Enterprise

Note

This plugin is part of the dellemc.openmanage collection (version 3.2.0).

To install it use: ansible-galaxy collection install dellemc.openmanage.

To use it in a playbook, specify: dellemc.openmanage.ome_identity_pool.

New in version 2.1.0: of dellemc.openmanage

Synopsis

  • This module allows to create, modify, or delete a single identity pool on OpenManage Enterprise.

Requirements

The below requirements are needed on the host that executes this module.

  • python >= 2.7.5

Parameters

Parameter Choices/Defaults Comments
ethernet_settings
dictionary
Applicable for creating and modifying an identity pool using Ethernet settings.
starting_mac_address and identity_count are required to create an identity pool.
identity_count
integer
Number of MAC addresses.
starting_mac_address
string
Starting MAC address of the ethernet setting.
fc_settings
dictionary
Applicable for creating and modifying an identity pool using fibre channel(FC) settings.
This option allows OpenManage Enterprise to generate a Worldwide port name (WWPN) and Worldwide node name (WWNN) address.
The value 0x2001 is beginning to the starting address for the generation of a WWPN, and 0x2000 for a WWNN.
starting_address and identity_count are required to create an identity pool.
identity_count
integer
Number of MAC addresses.identity_count is required to option to create FC settings.
starting_address
string
Starting MAC Address of FC setting.starting_address is required to option to create FC settings.
fcoe_settings
dictionary
Applicable for creating and modifying an identity pool using FCoE settings.
starting_mac_address and identity_count are required to create an identity pool.
identity_count
integer
Number of MAC addresses.
starting_mac_address
string
Starting MAC Address of the FCoE setting.
hostname
string / required
Target IP address or hostname.
iscsi_settings
dictionary
Applicable for creating and modifying an identity pool using ISCSI settings.
starting_mac_address, identity_count, iqn_prefix, ip_range and subnet_mask are required to create an identity pool.
identity_count
integer
Number of MAC addresses.
initiator_config
dictionary
Applicable for creating and modifying an identity pool using iSCSI Initiator settings.
iqn_prefix
string
IQN prefix addresses.
initiator_ip_pool_settings
dictionary
Applicable for creating and modifying an identity pool using ISCSI Initiator IP pool settings.
gateway
string
IP address of gateway.
ip_range
string
Range of non-multicast IP addresses.
primary_dns_server
string
IP address of the primary DNS server.
secondary_dns_server
string
IP address of the secondary DNS server.
subnet_mask
string
Subnet mask for ip_range.
starting_mac_address
string
Starting MAC address of the iSCSI setting.This is required option for iSCSI setting.
new_pool_name
string
After creating an identity pool, pool_name can be changed to new_pool_name.
This option is ignored when creating an identity pool.
password
string / required
Target user password.
pool_description
string
Description of the identity pool.
pool_name
string / required
This option is mandatory for state when creating, modifying and deleting an identity pool.
port
integer
Default:
443
Target HTTPS port.
state
string
    Choices:
  • present ←
  • absent
present modifies an existing identity pool. If the provided I (pool_name) does not exist, it creates an identity pool. - absent deletes an existing identity pool.
username
string / required
Target username.

Notes

Note

  • Run this module from a system that has direct access to DellEMC OpenManage Enterprise.

  • This module does not support check_mode.

Examples

---
- name: Create an identity pool using ethernet, FCoE, iSCSI and FC settings
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: present
    pool_name: "pool1"
    pool_description: "Identity pool with Ethernet, FCoE, iSCSI and FC settings"
    ethernet_settings:
        starting_mac_address: "50:50:50:50:50:00"
        identity_count: 60
    fcoe_settings:
        starting_mac_address: "70:70:70:70:70:00"
        identity_count: 75
    iscsi_settings:
        starting_mac_address: "60:60:60:60:60:00"
        identity_count: 30
        initiator_config:
            iqn_prefix: "iqn.myprefix."
        initiator_ip_pool_settings:
            ip_range: "10.33.0.1-10.33.0.255"
            subnet_mask: "255.255.255.0"
            gateway: "192.168.4.1"
            primary_dns_server : "10.8.8.8"
            secondary_dns_server : "8.8.8.8"
    fc_settings:
        starting_address: "30:30:30:30:30:00"
        identity_count: 45

- name: Create an identity pool using only ethernet settings
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    pool_name: "pool2"
    pool_description: "create identity pool with ethernet"
    ethernet_settings:
        starting_mac_address: "aa-bb-cc-dd-ee-aa"
        identity_count: 80

- name: Modify an identity pool
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    pool_name: "pool2"
    new_pool_name: "pool3"
    pool_description: "modifying identity pool with ethernet and fcoe settings"
    ethernet_settings:
        starting_mac_address: "90-90-90-90-90-90"
        identity_count: 61
    fcoe_settings:
        starting_mac_address: "aabb.ccdd.5050"
        identity_count: 77

- name: Modify an identity pool using iSCSI and FC settings
  dellemc.openmanage.ome_identity_pool:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    pool_name: "pool_new"
    new_pool_name: "pool_new2"
    pool_description: "modifying identity pool with iscsi and fc settings"
    iscsi_settings:
      identity_count: 99
      initiator_config:
        iqn_prefix: "iqn1.myprefix2."
      initiator_ip_pool_settings:
        gateway: "192.168.4.5"
    fc_settings:
      starting_address: "10:10:10:10:10:10"
      identity_count: 98

- name: Delete an identity pool
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: "absent"
    pool_name: "pool2"

Return Values

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

Key Returned Description
error_info
dictionary
on HTTP error
Details of the HTTP Error.

Sample:
{'error': {'@Message.ExtendedInfo': [{'Message': 'Unable to process the request because an error occurred: Ethernet-MAC Range overlap found (in this Identity Pool or in a different one) .', 'MessageArgs': ['Ethernet-MAC Range overlap found (in this Identity Pool or in a different one)"'], 'MessageId': 'CGEN6001', 'RelatedProperties': [], 'Resolution': 'Retry the operation. If the issue persists, contact your system administrator.', 'Severity': 'Critical'}], 'code': 'Base.1.0.GeneralError', 'message': 'A general error has occurred. See ExtendedInfo for more information.'}}
msg
string
always
Overall status of the identity pool operation.

Sample:
Successfully created an identity pool.
pool_status
dictionary
success
Details of the user operation, when state is present.

Sample:
{'Id': 29, 'IsSuccessful': True, 'Issues': []}


Authors

  • Sajna Shetty(@Sajna-Shetty)

  • Deepak Joshi(@Dell-Deepak-Joshi))