This document describes Cisco NXDB and the OVSDB plugin and the required hardware and software, features, and open caveats for using them with an NSXv controller and Cisco Nexus 9300 and 9300-EX platform switches.
Use this document in combination with the documents listed in the “Related Documentation” section.
Table 1 Online History Change
Date |
Description |
July 29, 2019 |
Created the release notes for OVSDB plugin 2.3.2. |
Cisco NXDB and the OVSDB Plugin
Installation and Configuration Information
Obtaining Documentation and Submitting a Service Request
Cisco Nexus Database (NXDB) is a subfeature of Cisco NX-API that enables the JavaScript Object Notation Remote Procedure Calls (JSON-RPC) processing functionality of NX-API. It enables you to configure a Cisco Nexus 9300 or 9300-EX platform switch for Layer 2 VXLAN from an external controller using JSON-RPC NX-API calls. NXDB is enabled on the switch using Cisco NX-OS.
The Open vSwitch Database (OVSDB) management protocol, as defined in RFC 7047, is a configuration protocol that allows the external controller and the Cisco Nexus 9300 or 9300-EX platform switch to communicate with one another. Cisco NX-OS does not natively support the OVSDB protocol, so an intermediate agent is needed to accept the OVSDB messages sent from the external controller and make the appropriate JSON-RPC NX-API calls. For this purpose, a separate OVSDB plugin is available that can be run either in the Guest Shell container or on an individual Linux server that is connected to the switch.
One of the following switches:
· A Cisco Nexus 9300 platform switch running Cisco NX-OS Release 7.0(3)I4(2) or a later release
· A Cisco Nexus 9300-EX platform switch running Cisco NX-OS Release 7.0(3)I6(1) or a later release
Any NSXv controller that follows OVSDB RFC 7047 and the Open vSwitch Manual
The N93-TP1K9=(SPARE) TP Services Package license (to use Cisco NXDB on the Cisco Nexus 9300 and 9300-EX platform switches)
The OVSDB plugin that is compatible with your Cisco NX-OS release and Cisco device:
Cisco NX-OS Release |
OVSDB Plugin Release |
JRE |
NSXv Release |
Cisco Switches |
7.0(3)I6(x) |
2.1.x |
jre-8u112-linux-x64.rpm |
6.3.x |
9300 and 9300-EX only |
7.0(3)I7(1) and 7.0(3)I7(2) |
2.2.x |
jre-8u112-linux-x64.rpm |
6.3.x |
9300 and 9300-EX only |
7.0(3)I7(3) and 7.0(3)I7(4) |
2.3.1 |
jre-8u112-linux-x64.rpm |
6.3.x |
9300 and 9300-EX only |
7.0(3)I7(5), 7.0(3)I7(6), and 9.3(1) |
2.3.2 |
jre-8u112-linux-x64.rpm |
6.4.x |
9300 and 9300-EX only |
Note: OVSDB plugin images are backward compatible with prior switch images. For example, 2.2.x will work with the 7.0(3)I6(x) switch image.
Table 2 lists the features that are introduced in OVSDB plugin 2.2.x and 2.3.x.
Table 2 New Features for OVSDB Plugin 2.2.x and 2.3.x
OVSDB Plugin Release |
New Feature Added |
Cisco NX-OS Release |
2.2.x |
Layer 3 gateway (HSRP, VRRP) |
7.0(3)I7(2) |
2.3.x |
Native VLAN support |
7.0(3)I7(3) |
For information on installing or upgrading the Cisco NX-OS image and the OVSDB plugin as well as configuring Cisco NXDB for use with NSXv controllers, see the Configuring NXDB for Cisco Nexus 9000 Series Switches and Communicating with NSXv Controllers (for Layer 2 VXLANs).
Table 3 lists the open caveats for OVSDB plugin 2.3.2. Tables 4 and 5 list the open caveats for Cisco NX-OS Releases 7.0(3)I7(6) and 9.3(1) with the OVSDB plugin and with third-party VMware. Click the bug ID to access the Bug Search tool and see additional information about the bug.
Table 3 Open Caveats for OVSDB Plugin 2.3.2
Bug ID |
Description |
Ucast_Macs_Local table is not updated after reloading VPC secondary |
Table 4 Open Caveats for Cisco NX-OS Releases 7.0(3)I7(6) and 9.3(1) with OVSDB Plugin 2.3.2
Bug ID |
Description |
Combination of BFD on uplinks and BFD over Vxlan is not supported |
· The entire Cisco Nexus 9000 Series NX-OS documentation set is available at the following URL:
To provide technical feedback on this document, or to report an error or omission, please send your comments to nexus9k-docfeedback@cisco.com. We appreciate your feedback.
For information on obtaining documentation and gathering additional information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/). This product includes software written by Tim Hudson (tjh@cryptsoft.com).
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: 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. (1110R)
OVSDB Plugin Release Notes, Release 2.3.2
© 2019 Cisco Systems, Inc. All rights reserved.