Chapter 1. Cisco MDS 9000 Series Ansible Modules

- nxos_devicealias - Configuration of Device Alias

- nxos_vsan - Configuration of VSAN

- nxos_zone_zoneset - Configuration of Zone/Zone set

nxos_devicealias - Configuration of Device Alias

Synopsis

Configures device alias for Cisco MDS NXOS.

Parameters

Parameter

Choices/Defaults

Comments

distribute

bool/False

Enable/Disable device-alias distribution

mode

Choices:

- basic

- enhanced

Default:

- basic

Mode of devices-alias, basic or enhanced

da

List of device-alias to be added or removed

name

Name of the device-alias to be added or removed

pwwn

pwwn to which the name needs to be associated with

remove

bool/False

Removes the device-alias if set to True

Notes

Examples

nxos_devicealias:
distribute: yes
mode: enhanced
da:
- { name: 'test1_add', pwwn: '56:2:22:11:22:88:11:67'}
- { name: 'test2_add', pwwn: '65:22:22:11:22:22:11:d'}
- { name: 'dev1', remove: True}
- { name: 'dev2', remove: True}
provider: "{{ creds }}"
register: result
- debug: var=result

Return Values

Status

nxos_vsan - Configuration of VSAN

Synopsis

Configures VSAN for Cisco MDS NXOS devices.

Parameters

Parameter

Choices/Defaults

Comments

vsan

List of vsan details to be added or removed.

id

vsan id

name

Name of the vsan

suspend

bool/False

Suspend the vsan if True

remove

bool/False

Removes the vsan if True

interface

List of vsan's interfaces to be added.

Notes

Examples

nxos_vsan:
provider: "{{ creds }}"
vsan:
- id: 922
name: vsan-SAN-A
suspend: False
interface:
- fc1/1
- fc1/2
- port-channel 1
remove: False
- id: 923
name: vsan-SAN-B
suspend: True
interface:
- fc1/11
- fc1/21
- port-channel 2
remove: False
- id: 1923
name: vsan-SAN-Old
remove: True
register: result
- debug: var=result

Return Values

Status

nxos_zone_zoneset - Configuration of Zone/Zone set

Synopsis

Configures Zone/Zone set for Cisco MD NXOS devices.

Parameters

Parameter

Choices/Defaults

Comments

zone_zoneset_details

List of zone/zoneset details to be added or removed

vsan

vsan id

mode

Choices:

- enhanced

- basic

Default:

- basic

Mode of the zone for the vsan

default_zone

Choices:

- permit

- deny

Default:

- deny

default zone behaviour for the vsan

smart_zoning

bool/False

Enables smartzoning on the vsan if True.

zone

List of zone options for that vsan.

name

name of the zone

remove

bool/False

Deletes the zone if True

members

Members of the zone that needs to be removed or added

pwwn

pwwn member of the zone, use alias 'device-alias' as option for device-alias member

remove

bool/False

Removes member from the zone if True

devtype

Choices:

- initiator

- target

- both

devtype of the zone member used along with Smart zoning config

zoneset

List of zoneset options for the vsan

name

name of the zoneset

remove

bool/False

Removes zoneset if True

action

Choices:

- activate

- deactivate

Default:

- deactivate

activates/de-activates the zoneset

members

Members of the zoneset that needs to be removed or added

name

name of the zone that needs to be added to the zoneset or removed from the zoneset

remove

bool/False

Removes zone member from the zoneset

Notes

Examples

nxos_zone_zoneset:
provider: "{{ creds }}"
zone_zoneset_details:
- vsan: 22
mode: enhanced
zone:
- name: zoneA
members:
- {pwwn: '11:11:11:11:11:11:11:11'}
- {device-alias: 'test123'}
- {pwwn: '61:61:62:62:12:12:12:12', remove: True}
- name: zoneB
members:
- {pwwn: '10:11:11:11:11:11:11:11'}
- {pwwn: '62:62:62:62:21:21:21:21'}
- name: zoneC
remove: True
zoneset:
- name: zsetname1
members:
- {name: zoneA}
- {name: zoneB}
- {name: zoneC, remove: True}
action: activate
- name: zsetTestExtra
remove: True
action: deactivate
- vsan: 21
mode: basic
smart_zoning: True
zone:
- name: zone21A
members:
- {pwwn: '11:11:11:11:11:11:11:11',devtype: 'both'}
- {pwwn: '62:62:62:62:12:12:12:12'}
- {pwwn: '92:62:62:62:12:12:1a:1a',devtype: 'both', remove: True}
- name: zone21B
members:
- {pwwn: '10:11:11:11:11:11:11:11'}
- {pwwn: '62:62:62:62:21:21:21:21'}
zoneset:
- name: zsetname21
members:
- {name: zone21A}
- {name: zone21B}
action: activate
register: result
- debug: var=result

Return Values

Status

Full Cisco Trademarks with Software License

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.

Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)