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.
To create or specify a virtual device context (VDC) and enter VDC configuration mode, use the vdc command. To delete a VDC, use the no form of this command.
vdc vdc-name [ ha-policy { dual-sup { bringdown | restart | switchover } [ single-sup { bringdown | reload | restart } ] | single-sup { bringdown | reload | restart } [ dual-sup { bringdown | restart | switchover } ] } ] [ id vdc-id ] [ template vdc-template-name ] [ type storage ]
no vdc vdc-name
vdc-name |
VDC name. |
ha-policy |
(Optional) Specifies the high availability (HA) policy for the VDC when an unrecoverable error occurs. The default is restart. |
dual-sup |
Specifies the HA policy for devices with dual supervisor modules. |
bringdown |
Puts the VDC in a failed state. To recover from the failed state, you must reload the physical device. |
restart |
Deletes the VDC and recreates it using the startup configuration. |
switchover |
Initiates a supervisor module switchover. |
single-sup |
Specifies the HA policy for devices with a single supervisor module. |
reload |
Reloads the physical device and recreates the VDC using the startup configuration. |
id vdc-id |
(Optional) Specifies the VDC ID. The default is the first available number. |
template vdc-template-name |
(Optional) Specifies the VDC resource template. The default is the default VDC resource template. |
type |
(Optional) Creates VDC with a special set of services. |
storage |
(Optional) Specifies that the VDC should be used for storage only. |
The default HA policy for the default VDC: dual-sup default is switchover single-sup default is reload
The default HA policy for nondefault VDCs: dual-sup default is switchover single-sup default is restart
The default VDC ID is first available.The default VDC resource template is the default template. The default switchover policy is bringdown .
Global configuration
Release |
Modification |
---|---|
5.2(1) |
Added the type and storage keywords. |
4.0(1) |
This command was introduced. |
You can use this command only in the default VDC (VDC 1).
In the Release 5.2(1) and higher, the type storage VDC allows you to run Fibre Channel over Ethernet (FCoE) in the Cisco NX-OS Nexus 7000 Series switch. Thee VDC type storage cannot be the default VDC, and it can be only one of the VDCs. You cannot have two type storage VDCs on the device. Only FCoE VLANs can be assigned to the storage VLANs. For more information about FCoE, see Cisco NX-OS FCoE Configuration Guide for Cisco Nexus 7000 and Cisco MDS 9500.
When you create a VDC, the Cisco NX-OS software allocates the internal resources for the VDC. This process can take a few minutes to complete depending on the amount of internal resource you have requested for the VDC.
When you delete a non-default vdc, interfaces from that vdc are moved to unallocated pool.
This command requires the Advanced Services license for creating and managing nondefault VDCs. It does not require a license for managing the default VDC.
This example shows how to create a VDC and enter VDC configuration mode:
switch# configure terminal switch(config)# vdc MyDevice Note: VDC creation is a time consuming process, please wait until the command completes switch(config-vdc)#
This example shows how to create a VDC with a different single supervisor module HA policy than the default and enter VDC configuration mode:
switch# configure terminal switch(config)# vdc MyDevice ha-policy single-sup reload Note: VDC creation is a time consuming process, please wait until the command completes switch(config-vdc)#
This example shows how to delete a VDC:
switch# configure terminal switch(config)# no vdc MyDevice Deleting this vdc will remove its config. Continue deleting this vdc? [no] yes Note: VDC deletion is a time consuming process, please wait until the command completes
Command |
Description |
---|---|
show vdc |
Displays VDC status information. |
To change the command-line interface (CLI) prompt for the nondefault virtual device contexts (VDCs) to show both the default VDC name and the hostname, use the vdc combined-hostname command. To change the CLI prompt to show only the nondefault VDC name, use the no form of this command.
vdc combined-hostname
no vdc combined-hostname
This command has no arguments or keywords.
None
Global configuration
Release |
Modification |
---|---|
4.2(1) |
This command was introduced. |
This command does not require a license. When the prompt string length is more than 64 characters, only the first 64 characters is displayed.
This example shows how to change the CLI prompt for the nondefault VDCs to include the hostname:
switch# configure terminal switch(config)# vdc combined-hostname
This example shows how to change the CLI prompt for the nondefault VDCs to not include the hostname:
switch# configure terminal switch(config)# no vdc combined-hostname
To create or specify a virtual device context (VDC) resource template and enter VDC resource template configuration mode, use the vdc command. To delete a VDC resource template, use the no form of this command.
vdc resource template vdc-template-name
no vdc resource template vdc-template-name
vdc-template-name |
VDC resource template name. The name has a maximum length of 32 characters and is not case-sensitive. |
Resource |
Minimum |
Maximum |
---|---|---|
IPv4 multicast route map memory1 |
8 |
8 |
IPv6 multicast route map memory 1 |
2 |
2 |
IPv4 unicast route map memory 1 |
8 |
8 |
IPv6 unicast route map memory 1 |
4 |
4 |
Port channels |
0 |
768 |
SPAN sessions |
0 |
2 |
VLANs |
16 |
4094 |
VRFs |
16 |
8192 |
Global configuration
Release |
Modification |
---|---|
4.1(2) |
|
4.0(1) |
This command was introduced. |
You can use this command only in the default VDC (VDC 1).
You cannot change the default VDC resource template provided by the Cisco NX-OS software.
You can create up to 64 VDC resource templates.
This command does not require a license.
This example shows how to create or specify a VDC resource template and enter VDC resource template configuration mode:
switch# configure terminal switch(config)# vdc resource template MyTemplate switch(config-vdc-template)#
This example shows how to delete a VDC resource template:
switch# configure terminal switch(config)# no vdc resource template MyTemplate
Command |
Description |
---|---|
show vdc resource template |
Displays VDC status information. |
To restart a virtual device context (VDC) that is in the failed state due to a high availability (HA) failure, use the vdc restart command.
vdc vdc-name restart
vdc-name |
VDC name. |
None
Global configuration
Release |
Modification |
---|---|
4.2(4) |
This command was replaced by the reload vdc command. |
4.2(1) |
This command was introduced. |
You can use this command only from the default VDC (VDC 1).
This command requires the Advanced Services license.
Caution | Restarting a VDC disrupts all traffic on the VDC. |
This example shows how to restart a VDC:
switch# configure terminal switch(config)# vdc TestVDC restart
Command |
Description |
---|---|
reload vdc |
Restarts the current VDC. |
show vdc |
Displays the information and status for all VDCs on the physical device. |
To suspend virtual device context (VDC) operation, use the vdc suspend command. To resume the VDC operation, use the no form of this command.
vdc vdc-name suspend
no vdc vdc-name suspend
vdc-name |
VDC name. |
None
Global configuration
Release |
Modification |
---|---|
4.2(1) |
This command was introduced. |
You can use this command only from the default VDC (VDC 1).
You can only suspend a nondefault VDC.
This command requires the Advanced Services license.
Caution | Suspending a VDC disrupts all traffic on the VDC. |
This example shows how to suspend VDC operation:
switch# configure terminal switch(config)# vdc TestVDC suspend
This example shows how to resume VDC operation:
switch# configure terminal switch(config)# no vdc TestVDC suspend
Command |
Description |
---|---|
show vdc |
Displays the information and status for all VDCs on the physical device. |