NX-OS 9000
Overview
The NX-OS 9000 node type is used for running Cisco Nexus 9000v, 9300v, and 9500v images. The NX-OS 9000 reference platform is a virtual platform that is designed to simulate a data center switch running Cisco Nexus 9000 software. The VM shares the same software image that runs on Cisco Nexus 9000 hardware platforms, but it does not implement any specific hardware emulation. When the software runs as a virtual machine, line card (LC) ASIC provisioning or any interaction from the control plane to hardware ASIC is handled by a software data plane.
Note:
There is limited support for this image from Cisco's Technical Advisory Center. The Cisco Nexus 9000v, 9300v, and 9500v VM images are not intended for use in a production network. They are intended for use with NetDevOps workflows and to enable rapid testing of changes to the network infrastructure or to infrastructure automation tools.
For more details about the VM images associated with the NX-OS 9000 node type, refer to the following resources:
Using N9Kv Nodes in CML
VM Images and Resource Settings
Use the NX-OS 9000 node definition for Nexus 9000v VM images, including the Nexus 9300v and 9500v.
Note that different N9Kv images may require different default settings for the VM's CPU and memory. If you are adding VM images for alternate versions of NX-OS 9000, you can override the NX-OS 9000 node definition's default settings for that specific VM image. For example, the Nexus 95000v 9.3(x) image requires a minimum of 4 vCPUs. When adding a Nexus 9500v image, you can set the image definition's Linux Native > CPUs to 4.
Known Issues
Jumbo frames work by default in the NX-OS 9000 nodes in CML, but configuring MTU on an interface is not supported by NX-OS 9000 until version 9.3(3). To use jumbo frames, change your lab to use a NX-OS 9000 VM image version of 9.3(3) or higher.
Limitations
NX-OS 9000v is performance limited when forwarding traffic. Achieved throughputs are ~2.3 Mb/s when passing traffic through one NX-OS 9000v device, and ~2.19 Mb/s when chained over two NX-OS 9000v devices. Baseline throughput was 307 Mbits/sec.
Features Tested with CML
Each CML release is tested with the bundled version of NX-OS 9000. The tests validate the following features:
Test Name |
Result |
CDP |
PASS |
SVI |
PASS |
Port-security |
PASS |
Port-channel |
PASS |
vPC |
PASS |
DHCP |
Not supported |
Spanning-tree |
PASS |
HSRP |
PASS |
Loopback |
PASS |
Routed port |
PASS |
The lab used for the tests is NX-OS 9500v Feature Tests, which is one of the sample labs included with CML on the Tools > Sample Labs page.

CDP
- peer device is detected on the interface and listed in the CDP table
- Neighbor type: IOSvL2
SVI
- Interface VLAN 100 configured with IP address 192.168.253.2
- Alpine Linux VM in VLAN 100 can successfully ping the interface vlan 100
Port-security
- Port goes to err-disabled state if there is violation
- Autorecovery also works, port goes back up if there is no violation
Port-channel
- Links successfully grouped into etherchannel using LACP
vPC
- successful vPC configuration
DHCP
Not supported on NX-OS 9000v
SPANNING-TREE
- Spanning-tree successfully calculates a loop-free topology for every VLAN
HSRP
- HSRP configured on two N9K devices
- VM can successfully ping HSRP IP address
- Verification: failover test
Loopback
- Loopback address configured on N9K
Routed Port
- Interface eth1/4 configured as routed port
- VM can successfully ping the IP address set on eth1/4
Interface counters
- Interface counters work in image version 3.2.6
- In previous versions they were always 0