On this page
dellemc.openmanage.ome_identity_pool – Manages identity pool settings on OpenManage Enterprise
Note
This plugin is part of the dellemc.openmanage collection (version 3.0.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
|
|
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))
© 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/dellemc/openmanage/ome_identity_pool_module.html