dellemc.openmanage.ome_smart_fabric module – Create, modify or delete a fabric on OpenManage Enterprise Modular
Note
This module is part of the dellemc.openmanage collection (version 8.5.0).
To install it, use: ansible-galaxy collection install dellemc.openmanage
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: dellemc.openmanage.ome_smart_fabric
.
New in dellemc.openmanage 2.1.0
Synopsis
This module allows to create a fabric, and modify or delete an existing fabric on OpenManage Enterprise Modular.
Requirements
The below requirements are needed on the host that executes this module.
python >= 3.8.6
Parameters
Parameter |
Comments |
---|---|
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation. |
|
Provide a short description of the fabric to be created or modified. |
|
Specify the fabric topology.See the use API https://www.dell.com/support/manuals/en-in/poweredge-mx7000/omem_1_20_10_ug/smartfabric-network-topologies to know why its topology. fabric_design is mandatory for fabric creation. Choices:
|
|
OpenManage Enterprise Modular IP address or hostname. |
|
Provide the name of the fabric to be created, deleted or modified. |
|
Provide the name of the fabric to be modified. |
|
Enable this configuration to allow Fabric Management Address to be included in LLDP messages. Notes: OpenManage Enterprise Modular 1.0 does not support this option. Some software networking solutions require a single management address to be transmitted by all Ethernet switches to represent the entire fabric. Enable this feature only when connecting to such a solution. Choices:
|
|
OpenManage Enterprise Modular password. |
|
OpenManage Enterprise Modular HTTPS port. Default: |
|
Service tag of the first switch. primary_switch_service_tag is mandatory for fabric creation. primary_switch_service_tag must belong to the model selected in fabric_design. |
|
Service tag of the second switch. secondary_switch_service_tag is mandatory for fabric creation. secondary_switch_service_tag must belong to the model selected in fabric_design. |
|
Notes: The create, modify, or delete fabric operation takes around 15-20 minutes to complete. It is recommended not to start an another operation until the current operation is completed. Choices:
|
|
The socket level timeout in seconds. Default: |
|
OpenManage Enterprise Modular username. |
|
If Configure Prior to collection version Choices:
|
Notes
Note
Run this module from a system that has direct access to Dell OpenManage Enterprise Modular.
This module supports
check_mode
.
Examples
---
- name: Create a fabric
dellemc.openmanage.ome_smart_fabric:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
state: present
name: "fabric1"
description: "fabric desc"
fabric_design: "2xMX9116n_Fabric_Switching_Engines_in_different_chassis"
primary_switch_service_tag: "SVTG123"
secondary_switch_service_tag: "PXYT456"
override_LLDP_configuration: "Enabled"
- name: Modify a fabric
dellemc.openmanage.ome_smart_fabric:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
state: present
name: "fabric1"
new_name: "fabric_gold1"
description: "new description"
- name: Delete a fabric
dellemc.openmanage.ome_smart_fabric:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
state: "absent"
name: "fabric1"
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Additional details of the fabric operation. Returned: when state=present and additional information present in response. Sample: |
|
Details of the HTTP Error. Returned: on HTTP error Sample: |
|
Returns the ID when an fabric is created, modified or deleted. Returned: success Sample: |
|
Overall status of the fabric operation. Returned: always Sample: |