PDF(1.3 MB) View with Adobe Reader on a variety of devices
ePub(1.3 MB) View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle)(852.2 KB) View on Kindle device or Kindle app on multiple devices
Updated:July 16, 2021
Document ID:213792
Bias-Free Language
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The Cisco Nexus 1000VE is a distributed virtual switch solution that is fully integrated within the VMware virtual infrastructure, including VMware vCenter, for the virtualization administrator. This solution offloads the configuration of the virtual switch and port groups to the network administrator to enforce a consistent data center network policy.
The Cisco Nexus 1000VE is compatible with any upstream physical access layer switch that is compliant with the Ethernet standard, including the Catalyst 6500 series switch, Cisco Nexus switches, and switches from other network vendors. The Cisco Nexus 1000VE is compatible with any server hardware that is listed in the VMware Hardware Compatibility List.
Contributed by Mohammed Majid Hussain and Jonathan Jordan, Cisco TAC Engineers.
Prerequisites
Pre-Requisites for Installing Nexus 1000 Virtual Edge (VE)
Cisco Nexus 1000 Virtual Edge installation has the following prerequisites:
You have downloaded the Cisco Nexus 1000VE VSM and VSE images.
You should have the VMware vCenter details and the administrator credentials.
You have an ESXi host to deploy the Cisco Nexus 1000VE VSM.
At least one ESXi host is available to deploy VSE for Cisco Nexus 1000VE.
You have at least two IP addresses available for VSM and VSE (Virtual Services Engine).
You have (N+1) IP addresses, where N is the number of ESXi hosts on which a VSE is deployed.
ESXi Host Prerequisites
ESX or ESXi hosts have the following prerequisites:
You have already installed and prepared vCenter Server for host management using the instructions from VMware.
You have already installed the VMware Enterprise Plus license on the hosts.
All VSE hosts must be running ESXi 6.0 U3 or later releases.
You have two physical NICs on each host for redundancy. Deployment is also possible with one physical NIC.
If you are using a set of switches, make sure that the interswitch trunk links carry all relevant VLANs. The uplink should be a trunk port that carries all VLANs that are configured on the host.
You must configure control and management VLANs on the host to be used for the VSM VM.
Make sure that the VM to be used for the VSM meets the minimum requirements listed in the following table.
All the vmnics should have the same configuration upstream.
Caution
VSM hardware version 11 is not supported. See table below for supported versions.
The VSM VM might fail to boot if RAM and CPU are not properly allocated. This document includes procedures for allocating RAM and setting the CPU speed.
This table lists the minimum requirements for hosting a VSM.
Table 1.Minimum Requirements for a VM Hosting a VSM
VSM VM Component
Minimum Requirement
VSM Hardware Version
7
Note
VSM hardware versions 7, 8, 9, and 10 are supported. VSM hardware version 11 is not supported.
1If you are installing the VSM using an OVA file, the correct RAM setting is made automatically during the installation of this file. If you are using the CD ISO image, seeDeploying Virtual Supervisor Moduleto reserve RAM and set the memory size.2If you are installing the VSM using an OVA file, the correct CPU speed setting is made automatically during the installation. If you are using the CD ISO image, seeDeploying Virtual Supervisor Moduleto reserve CPU and set the CPU reservation.
VSM Prerequisites
The Cisco Nexus 1000VE VSM software has the following prerequisites:
You have the VSM IP address.
You have installed the appropriate VMware vCenter Server.
If you are installing redundant VSMs, make sure that you first install and set up the software on the primary VSM before installing and setting up the software on the secondary VSM.
If you are using the OVA file for installation, make sure that the CPU speed is 2048 MHz or greater. If the CPU speed is less than 2048 MHz, then use ISO image for installation.
You have already identified the HA role for this VSM from the list in the following table.
Table 2.HA Roles
HA Role
Single Supervisor System
Dual Supervisor System
Standalone (test environment only)
X
HA
X
Note
A standalone VSM is not supported in a production environment.
The Cisco Nexus 1000VE VSE software has the following prerequisites:
If the hosts are in ESXi stateless mode, enable the PXE booted ESXi host settings underHome>Update Manager>Configuration>ESXi host/cluster.
You have a copy of your VMware documentation available for installing software on a host.
You have already obtained a copy of the VSE software file.
The ESXi server is capable of hosting a VSE that reserves two vCPUs and 8 GB of memory.
Upstream Switch Prerequisites
The upstream switch from the Cisco Nexus 1000VE has the following prerequisites:
If you are using a set of switches, make sure that the interswitch trunk links carry all relevant VLANs. The uplink must be a trunk port that carries all the VLANs that are configured on the host.
The following spanning tree prerequisites apply to the upstream switch from the Cisco Nexus 1000VE on the ports that are connected to the VSE.
On upstream switches, the following configuration is mandatory:
On your Catalyst series switches with Cisco IOS software, enter thespanning-tree portfast trunkorspanning-tree portfast edge trunkcommand.
On upstream switches we highly recommend that you enable Global BPDU Filtering and Global BPDU Guard globally.
On upstream switches, where you cannot globally enable BPDU Filtering and BPDU Guard, we highly recommend that you enter thespanning-tree bpdu filterandspanning-tree bpdu guardcommands.
For more information about spanning tree and its supporting commands, see the documentation for your upstream switch.
Enter the following commands on the upstream switch:
show running interface interface numberinterface GigabitEthernet interface numberdescription description of interfaceswitchportswitchport trunk encapsulation dot1qswitchport trunk native VLAN native VLANswitchport trunk allowed vlan list of VLANsswitchport mode trunkend
Requirements
Before installing the software, make topology decisions and gather any necessary information, as follows:
Decide whether to deploy the VSM as a VM on a vSphere host, cluster, or on a CSP.
Decide whether the management and Layer 3 control ports will be unified or separate.
Determine the domain ID.
Determine the management, subnet, and gateway IP addresses for the VSM.
Determine the administrative password for the VSM and VSEs.
Installing the Cisco Nexus 1000VE Manager VCenter Plugin
This section describes how to install the Cisco Nexus 1000VE vCenter Plugin. You must have working HTTPS traffic between your vCenter and Cisco Nexus 1000VE VSM, as vCenter will be downloading the plugin directly from the VSM.
If you cannot enable HTTPS traffic between your vCenter and Cisco Nexus 1000VE VSM, and you wish to use your own web server to host the Cisco Nexus 1000VE vCenter Plugin zip file, then download the Plugin Zip from Cisco Nexus 1000VE VSM by going to https://<N1KVE-VSM-IP>/vcplugin/.
Place the .Zip file in your preferred Web server path accessible over HTTPS from vCenter.
Follow the below steps to proceed with vCenter plugin installation.
Download Python script
Deploy VSM.
Browse to VSM using HTTPS://<VSM ip>.
Download “deploy_n1kve_plugin.py” python script to Python environment.
Python environment should be able to reach the vCenter Server.
Place the deploy_n1kve_plugin.py python script in a Python environment where the pyvmomi package is installed. Python version 2.7.9 or greater is mandatory.
Installing with Python 7.2.9+ in Windows
Commands you run are bold.
Download and install python 2.7.9+ to an easy to find folder such as c:\python27
C:\Python27\lib\distutils\dist.py:267: UserWarning: Unknown distribution option: 'python_requires' warnings.warn(msg) C:\Python27\lib\distutils\dist.py:267: UserWarning: Unknown distribution option: 'long_description_content_type' warnings.warn(msg) warning: no files found matching 'NOTICE'
warning: no files found matching 'requirements.txt' Adding requests 2.21.0 to easy-install.pth file
================================================================ .:|:.:|:. Cisco Systems Inc ================================================================ N1KVE Plugin for the vSphere Web Client deployment tool ---------------------------------------------------------------- In order to install the N1KVE Plugin for the vSphere Web Client, the following wizard will prompt you the following information:
- vCenter IP : The IP address of the vCenter where the plugin needs to be installed. - vCenter Username / password : The login information of a user with root privileges - Plugin version number : The version of the plugin to deploy - Plugin zip file URL : The URL where the vCenter will be able to download the N1KVE Plugin zip archive (HTTP or HTTPS). - Https server Thumbprint: The SHA thumbprint of the HTTPS server where the zip archive is located
vCenter IP: <Enter_IP_Address> vCenter Username: administrator@vsphere.local Password: Plugin zip file URL: https://<IP_Address>/vcplugin/n1kve-vcenter-plugin-1.0.1.zip <-------- We recommended using HTTPS for this as vCenter does not allow http connections by default. See troubleshooting section if customer used HTTP. Https server Thumbprint: 02:B5:C2:6A:37:00:3D:76:1D:F1:EA:79:71:55:B1:F5:35:BE:FE:E5 <-------- You need the : every 2 digits. Some browsers do not add this by default so you may need to add it to the thumbprint before pasting.
Connecting to the vCenter ... Fetching service instance content ... Checking the API version ... Installing the plugin ...
The plugin information was successfully installed on the vCenter <IP_Address>
--- Please Read --- The information provided was successfully pushed to the vCenter, but plugin installation is not over. You need to login into the vSphere Web Client and check for the Cisco N1KVE Plugin icon to ensure that the installation is successful If the plugin does not appear in the UI, check the vSphere Web Client log file to see what went wrong
In the Https server thumbprint field, leave this empty, if you are using HTTP. Otherwise, enter the SHA1 Thumbprint of the Web server used. The fields are separated with colons. For example:
To retrieve the HTTPS SHA1 Thumbprint used by the web server hosting the zip file.
Step 3 :
Log into the vSphere Web Client once the registration is completed.
Note: First login may take longer, as the vCenter will be downloading and deploying the plugin from the Web server.
Once the VMware vSphere Web Client loads, you will see the Cisco Nexus 1000VE Manager icon under Home > Operations and Policies. This allows you to manage your Nexus 1000VE.
N1KV-NG(config)# svs connection vCenter
N1KV-NG(config-svs-conn)# remote ip address <vCenter_IP_Address> N1KV-NG(config-svs-conn)# vmware dv dvs dvs-version N1KV-NG(config-svs-conn)# vmware dvs datacenter-name Datacenter N1KV-NG(config-svs-conn)# protocol vmware-vim N1KV-NG(config-svs-conn)# register-plugin remote username administrator@vsphere.local password password N1KV-NG(config-svs-conn)# connect Warning: Connection successful.ipg creation in progress.Check 'show ipg-info' for status
Ensure that you have configured a static IP pool or DHCP server in VMware vCenter. Also, make sure that you have associated it with a an appropriate network
Ensure that the VSM is already deployed.
On the Navigator Pane, click Content Libraries to open the Content Libraries page.
On the Getting Started tab, click Create new content library.
On theName and Locationpage, enter the content library name in theName text field and select the vCenter Server IP address from thevCenter Serverdrop-down list.
ClickNext.
On theConfigure content librarypage, verify that the default option,Local content library,is selected.
ClickNext.
On theAdd Storagepage, choose theSelect a datastoreoption and from theFiltertab, select a storage location.
ClickNext.
On theNavigatortab, select the new content library that you just created.
ChooseLocal fileoption and clickBrowseand navigate to the location of the VSE OVF file. Select the VSE OVF file and clickOpen.
In theSelect referenced filesdialog box, select the OVF referenced files and clickOpen.
On theSelect referenced filesdialog box, clickOk.
On theNew Content Library – Import Library Itemdialog-box, clickOk.
On theHomepage, clickRecent Taskstab at the bottom to check VSE file upload progress.
Navigate to Home tab on the VMware vSphere Web Client.
Click N1KVE Manager, and enter the VMware vCenter password and click Login. The N1KVE Manager page opens.
On the Installation tab, select a data center from the Select a DC drop-down list.
Select a vDS from the Select a VDS drop-down list to list the available Hosts.
Select the check-box for a Host from the list of Hosts and click the Physical Adapter icon to open Select PNICS for Outside VDS dialog-box.
In the Select PNICSs for Outside VDS dialog box, select a physical adapter and click Submit.
Select an OVF file from the OVF File drop-down list.
Enter the VSM IP address for the VSM IP text field.
Enter the Domain ID for the Domain IDtext field.
Select an Uplink Port Profile from the Uplink Port Profile drop-down list.
Select a Management Port Group from the Management Port Group drop-down list.
Select Auto for Datastore drop-down list.
Enter the VSE administrator password in the VSE Admin Password text-field.
Confirm the password in the Confirm Password text field.
Click Install.
Confirm that you are adding the physical adapters to the Vmware DVS and not the Nexus 1000VE DVS.
If you add the adapter to the N1KVE mamaged DVS then the traffic won't be switched by the VSE.
Verify
The module(s) should show up like so:
Troubleshoot
1. Unable to see Nexus 1000VE plugin in vCenter
If you are not able to see the Nexus 1000VE plugin in vCenter, check the following file in the vSphere Web Client:
vi /var/log/vmware/vsphere-client/logs/vsphere_client_virgo.log
If you encounter an error like so:
[ERROR] c-extensionmanager-pool-1841 70000645 100035 200016 com.vmware.vise.vim.extension.VcExtensionManager . The plugin package download was blocked because the URL is not secure. To allow http URLs add allowHttp=true to webclient.properties
Add allowHttp=true to webclient.properties:
/etc/vmware/vsphere-ui/webclient.properties
Note: The location could be different based on the OS
2. Unable to see VSE as a module after deploying it
Make sure you created the IP Pool in vCenter before the VSE was created, If not the VSE will not show up as a module.
You will have to assign ip address to it statically. Please open a case with Cisco TAC, in order to address this.
Use the ip addr del <IP_Address/Subnet mask> <Interface> to delete an entry.