Created by: John McDonough on 09-03-2011 11:27:23 AM Overview
The Cisco UCS produces an XML formatted stream of information, the Event Stream, that can be consumed by other applications and utilized in any number of ways. Presented here is an explanation of how the UCS Event Stream can be utilized in conjunction with the Nexus 7000 XML API to create a VLAN on the Nexus 7000. The VLAN creation on the Nexus 7000 is triggered by a VLAN creation on the Cisco UCS.
The UCS Event Stream and VLAN events The UCS maintains an object database called the Management Information Tree. The objects are XML representations of UCS components (hardware, policies, configurations, etc...)
When an operation is performed on the UCS an object mutation occurs (creation/modification/deletion), for example VLAN creation or deletion. Information about the mutated object is sent to the UCS Event Stream. The UCS Event Stream is an XML stream that can be subscribed to by client applications and watched for object mutations as well as UCS faults, statistics, alerts, etc...
A VLAN operation, specifically creation would be of interest to upstream network elements. When a VLAN is created on the UCS via the CLI, GUI or API an event is sent to the event stream about the VLAN object that was created.
These are the Event Stream messages for creating VLAN 7k-integ-A with an id of 2222 on fabric A
The event stream messages are for individual VLANs on the distinct UCS switch fabrics. UCS VLANs are typically created on the global switch fabric, the differentiator for the VLAN is in the object's distinguished name (dn). The dns above are
A global fabric VLAN called 7k-integ dn would look like
Regardless of the fabric the event stream message will show the VLAN name and ID with a status of status="created" on creation and the VLAN name with a status of status="deleted" on deletion
The Nexus 7000
Utilizing this information, XML can be constructed to create or delete the VLAN on the N7K. Other integration methods can be utilized with the N7K, expect scripts, web services or ssh command chaining, however the focus here is the N7K XML API that is based on the IETF NETCONF network management protocol. http://tools.ietf.org/html/rfc4741
With an understanding of how to interact with the N7K XML API from the above document, the process to create and delete the VLANs described above are examples shown here are via command line interaction, however the intent would be to create a programmatic interaction utilizing a language's ssh libraries.
Connect to the N7K via ssh invoking the xmlagent
bash-3.00$ ssh email@example.com -s xmlagent User Access Verification Password:
Sandbox af205c78-86ac-4be0-a563-a030052f9a0f that is linked from:https://developer.cisco.com/learning/lab/imc-redfish-rest-api-101/step/1seems not longer available.Is there another sandbox with access to the Redfish interface from an C-series system ?Than...
Hi developers, I am trying to install the ACItoolkit into my windows 10 machine. I have downloaded it, but when trying to install it using the power shell, i am getting a permission denied error - PS D:\ACItoolKit\acitoolkit-master> lsDirect...
Hi,I am looking for a way to get the LLDP and CDP information of each ethernet-port of a fabric via REST-interface of DCNM?Infrastructure:DCNM, LAN Fabric, Version 11.3NK9-switchesIs this possible? Can someone give me a hint.... ThanksJuergen
Dear DevNet members.I'm looking for a way to send a REST API query to retrieve the field of "Overall Status" that appears in UCS Manager -> Equipment -> Chassis (see attached). This is just an example of trying to retrieve overall of status of Cisco...