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.
Cisco Virtual Security Gateway for KVM Release Notes, Release 5.2(1)VSG2(1.3)
Dynamic (Virtualization-Aware) Operation
Setting Up Cisco VSG and VLAN Usages
Support for Fragmentation in Layer 3 Mode
Condition Match Criteria for a Rule or Zone
Cisco Virtual Security Gateway Documentation
Cisco Prime Network Services Controller Documentation
Cisco Nexus 1000V Series Switch Documentation
Obtaining Documentation and Submitting a Service Request
This document describes the features, limitations, and caveats for Cisco Virtual Security Gateway (VSG) and Cisco Prime Network Services Controller (PNSC) software for KVM. Use this document in combination with documents listed in the Related Documentation. The following is the change history for this document.
Cisco VSG for the Cisco Nexus 1000V Series switch is a virtual firewall appliance that provides trusted access to virtual data center and cloud environments with dynamic policy-driven operation, mobility-transparent enforcement, and scale-out deployment for dense multitenancy. Cisco VSG enables a broad set of multitenant workloads that have varied security profiles to share a common compute infrastructure. By associating one or more virtual machines into distinct trust zones, Cisco VSG ensures that access to trust zones is controlled and monitored through established security policies.
Together, Cisco VSG and the Cisco Nexus 1000V Virtual Ethernet Module provide the following benefits:
The Cisco Nexus 1000V VSM and VEM must be running in Red Hat Enterprise Linux (RHEL), OSP 6.0.
For additional compatibility information, see the Cisco Nexus 1000V Compatibility Information.
The Cisco VSG license is integrated with the Cisco Nexus 1000V Multi-Hypervisor License (Universal License). You need to install the Cisco Nexus 1000V Multi-Hypervisor License for Cisco VSG for KVM. When the Cisco Nexus 1000V Multi-Hypervisor License is installed, the license for Cisco VSG is automatically included.
The Cisco Nexus 1000V VSM is available in two modes: essential and advanced. VSG functionality is available only in the advanced mode. You need to install the Cisco Nexus 1000V Multi-Hypervisor License and change the VSM mode to advanced mode.
Note If you try to access VSG services with VSM in essential mode, an error message is generated on the VSM console indicating that the Cisco Nexus 1000V Multi-Hypervisor License is required for VSG.
This section provides the following information about this release:
Cisco VSG operates with the Cisco Nexus 1000V distributed virtual switch in the RHEL OSP6 hypervisor. Cisco VSG leverages the virtual network service data path (vPath) that is embedded in the Cisco Nexus 1000V VEM. The Cisco vPath steers traffic, whether external-to-VM or VM-to-VM, to Cisco VSG of a tenant. A split-processing model is applied where initial packet processing occurs in the Cisco VSG for policy evaluation and enforcement. After the policy decision is made, the Cisco VSG off-loads policy enforcement of remaining packets to Cisco vPath.
You can transparently insert Cisco VSG into the KVM environment where the Cisco Nexus 1000V distributed virtual switch is deployed. Upon insertion, one or more instances of the Cisco VSG is deployed on a per-tenant basis, which allows a highly scaled-out deployment across many tenants. Because tenants are isolated from each other, no traffic can cross tenant boundaries. Depending on the use case, you can deploy Cisco VSG at the tenant level, at the virtual data center (vDC) level, or at the vApp level.
Note Cisco VSG is not inherently multitenant. It must be explicit within each tenant.
Since the VMs are instantiated for a given tenant, association to security profiles and zone membership occurs immediately through binding with the Cisco Nexus 1000V port profile. Upon instantation, each VM is placed into a logical trust zone. Security profiles contain context-aware rule sets that specify access policies for traffic that enters and exits each zone. With the VM and network contexts, you can leverage custom attributes to define zones directly through security profiles. The profiles are applied to zone-to-zone traffic and external-to-zone/zone-to-external traffic. This enforcement occurs within a VLAN because a VLAN often identifies a tenant boundary.
The Cisco VSGs evaluate access control rules and then offloads enforcement to the Cisco Nexus 1000V VEM vPath module for performance optimization. Access is permitted or denied based on policies. The Cisco VSG provides policy-based traffic monitoring capability and generates access logs.
A virtualization environment is dynamic, where frequent additions, deletions, and changes occur across tenants and especially across VMs. Live migration of VMs can occur due to manual or programmatic VMotion events.
A Cisco VSG operates with the Cisco Nexus 1000V (and vPath), which supports a dynamic VM environment. Typically, a tenant is created with the Cisco VSG (standalone or active-standby pair) and on the Cisco PNSC. Associated security profiles are defined that include trust zone definitions and access control rules.
Each security profile is bound to a Cisco Nexus 1000V port profile (authored on the Cisco Nexus 1000V Virtual Supervisor Module. When a new VM is instantiated, you can assign appropriate port profiles to the virtual Ethernet port of the VM. Because the port profile uniquely refers to a security profile and VM zone membership, security controls are immediately applied. A VM can be repurposed by assigning a different port profile or security profile.
As VMotion events occur, VMs move across physical servers. The Cisco Nexus 1000V ensures that port profile policies and associated security profiles follow the VMs. Security enforcement and monitoring remain transparent to VMotion events.
A Cisco VSG is set up in an overlay fashion so that VMs can reach a Cisco VSG irrespective of its location. The vPath component in the Cisco Nexus 1000V VEM intercepts the packets from the VM and sends them to the Cisco VSG for further processing.
A Cisco VSG is configured with three vNICS that are each connected to one of the VLANs. The VLAN functions are as follows:
You can allocate one or more VM Data VLAN(s) for VM-to-VM communications. In a multitenant environment, the Management VLAN is shared among all tenants. The Service VLAN, HA VLAN, and the VM Data VLAN are allocated on a per-tenant basis. When VLAN resources are scarce, you can use a single VLAN for Service and HA functions.
The Cisco VSG now supports fragmentation in Layer 3(L3) mode. You can enable L3 fragmentation on VSM by using the l3-fragment command. Use the no form of this command to disable L3 fragmentation. When L3 fragmentation is enabled, you not need increase the uplink MTU (1500) for the additional vPath overhead. By default the L3 fragmentation is disabled on VSM. If the L3 fragmentation is disabled, you need to increase the uplink MTU to 1582 bytes for the additional vPath overhead.
The Cisco VSG is available in two different models based on the memory, number of virtual CPUs, and CPU speed. The following table lists the available Cisco VSG models.
The Cisco Virtual Security Gateway for KVM has the following limitations and restrictions:
– 10,000 vEth ports with up to 6000 vEth ports protected by VSG.
Workaround: To prevent this situation, configure the Service VLAN and the HA VLAN used by the Cisco VSG as system vlan vlan_number in the uplink port profile.
When the VEM communicates with the Cisco VSG in the Layer 2 mode, an additional header with 62 bytes is added to the original packet. The VEM fragments the packet if it exceeds the uplink MTU.
For better performance, increase the MTU of all links between the VEM and the Cisco VSG by 62 bytes to account for packet encapsulation which occurs for communication between vPath and the Cisco VSG. For example, if the MTU values of the client and server VMs and uplink are all 1500 bytes, set the uplink MTU to 1562 bytes.
– If the jumbo frames are enabled in the network, make sure the MTU of the client and server VMs are 82 bytes smaller than the uplink. For example, if the uplink MTU is 9000 bytes, set the MTU of the client and server VMs to 8918 bytes.
– When encapsulated traffic that is destined to a Cisco VSG is connected to a different subnet other than the vmknic subnet, the VEM does not use the KVM host routing table. Instead, the vmknic initiates an ARP for the remote Cisco VSG IP addresses. You must configure the upstream router to respond by using the proxy ARP feature.
– The VEM does not support a routing functionality and it is assumed that the upstream switch/router is configured with the proxy-ARP configuration.
Configuring a rule with a reset action for the non-TCP/UDP protocol will result in dropped traffic. However, the syslog generated for this traffic shows that the action performed for the traffic is reset as shown in the following example:
The CLI session for the Cisco VSG that is newly deployed will time out after a period of five minutes of an inactivity.
- gold001-vsg01# sh run | i line|timeout
As a workaround, when upgrade is done from 1.0x to 1.3 version of Cisco VSG, “exec-timeout 5” can be configured under “line console” and “line vty” command modes to enable a five minutes CLI session inactivity timeout.
VM names for VMs on KVM hosts that exceed 21 characters are not displayed properly on the VSM. When you use a show vservice command that displays the port profile name, for example, the show vservice port brief port-profile port-profile-name command, only VMs with names that are 21 characters or less are displayed correctly. Longer VM names may cause the VM name to be truncated, or extra characters to be appended to the VM name. Depending on the network adapter, the name length limitation may vary. For example:
– The E1000 or VMXNET 2 network adapters allow 26-character names. At 27 characters, the word ‘.eth’ is appended to the VM name. With each addition to the VM name, a character is truncated from the word ‘.eth’. After 31 characters, the VM name is truncated.
– The VMXNET 3 network adapters allow 21-character names. At 22 characters, the word ‘ethernet’ is appended to the VM name. With each addition to the VM name, a character is truncated from the word ‘ ethernet’. After 30 characters, the VM name is truncated.
Workaround: Use VM names of 21 characters or less to avoid this issue.
The following table presents a feature-based comparative analysis between two VSGs with a different number of virtual CPUs and Cisco PNSC.
If VSG Release 5.2(1)VSG2(1.3) is used with Cisco Nexus 1000V Release 5.2.(1)SV3(1.4), the maximum limits for Cisco Nexus 1000V are reduced to following:
Caveats are accessible through the Cisco Bug Search Tool. This web-based tool provides you with access to the Cisco bug tracking system, which maintains information about bugs and vulnerabilities in this product and other Cisco hardware and software products.
For more information about the Cisco Bug Search Tool, see the Bug Search Tool Help & FAQ.
This topic explains how to use the Bug Search Tool to search for a specific bug or to search for all bugs in a release.
Step 1 Go to Cisco Bug Search Tool.
Step 2 In the Log In screen, enter your registered Cisco.com username and password, and then click Log In. The Bug Search page opens.
Note If you do not have a Cisco.com username and password, you can register for them at http://tools.cisco.com/RPF/register/register.do.
Step 3 To search for a specific bug, enter the bug ID in the Search For field and press Enter.
Step 4 To search for bugs in the current release:
a. In the Search For field, enter the appropriate release name and press Enter. (Leave the other fields empty.)
b. When the search results are displayed, use the filter tools to find the types of bugs you are looking for. You can search for bugs by status, severity, modified date, and so forth.
Tip To export the results to a spreadsheet, click the Export Results to Excel link.
The following table describes the open caveats in Cisco VSG Release 5.2(1)VSG2(1.3).
This section contains information about the documentation available for Cisco Virtual Security Gateway and related products.
The following Cisco Virtual Security Gateway documents are available:
The Cisco Prime Network Services Controller (PNSC) documents are available at the following URL:
The Cisco Nexus 1000V Series Switch documents are available at the following URL:
For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation at: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.
Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation as an RSS feed and delivers content directly to your desktop using a reader application. The RSS feeds are a free service.