Table Of Contents
Cisco Nexus 7000 Series NX-OS Virtual Device Context Commands
copy running-config startup-config vdc-all
limit-resource monitor-session
limit-resource monitor-session-erspan-dst
Cisco Nexus 7000 Series NX-OS Virtual Device Context Commands
This chapter describes the Cisco Nexus 7000 Series NX-OS virtual device context (VDC) commands.
allocate interface ethernet
To allocate Ethernet interfaces to a virtual device context (VDC), use the allocate interface ethernet command. To revert to the default settings, use the no form of this command.
allocate interface ethernet slot/port
allocate interface ethernet slot/port [- port]
allocate interface ethernet slot/port, ethernet slot1/port ... [, ethernet slot1/port]
no allocate interface ethernet slot/port
no allocate interface ethernet slot/port [- port]
no allocate interface ethernet slot/port, ethernet slot1/port ... [, ethernet slot1/port]
Syntax Description
Defaults
None
Command Modes
VDC configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
Initially, all interfaces belong to the default VDC. You can allocate individual interfaces, ranges of interface, or lists of interfaces.
Use the show vdc membership command to display the current allocation of interfaces among the VDCs on the physical device.
Note All configuration for the interface is lost when you allocate them to another VDC.
To remove the interface from the VDC and return them to the default VDC, you must enter VDC configuration mode for the default VDC and allocate the interface to the default VDC.
This command requires the Advanced Services license.
Examples
This example shows how to allocate one Ethernet interface to a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# allocate interface ethernet 2/1Moving ports will cause all config associated to them in source vdc to be removed. Are you sure you want to move the ports? [yes] yes
This example shows how to allocate a range of Ethernet interfaces on the same module to a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# allocate interface ethernet 2/1 - 4Moving ports will cause all config associated to them in source vdc to be removed. Are you sure you want to move the ports? [yes] yes
This example shows how to allocate a list of Ethernet interfaces on the same module to a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# allocate interface ethernet 2/1, ethernet 2/3, ethernet 2/5Moving ports will cause all config associated to them in source vdc to be removed. Are you sure you want to move the ports? [yes] yes
This example shows how to move an Ethernet interface back to the default VDC:
switch# configure terminalswitch(config)# vdc switchswitch(config-vdc)# allocate interface ethernet 2/1Moving ports will cause all config associated to them in source vdc to be removed. Are you sure you want to move the ports? [yes] yes
Related Commands
Command Descriptionshow vdc membership
Displays VDC interface membership information.
vdc
Creates or specifies a VDC and enters VDC configuration mode.
boot-order
To allocate the boot order value for a nondefault virtual device context (VDC), use the boot-order command.
boot-order number
Syntax Description
Defaults
1
Command Modes
VDC configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
The boot order feature has the following characteristics:
•Multiple VDCs can have the same boot order value.
•VDCs with lowest boot order value boot first.
•The Cisco NX-OS software completely starts all VDCs with the same boot order value before starting the VDCs with the next boot order value.
•The Cisco NX-OS software starts VDCs which have the same boot order value in parallel.
•You cannot change the boot order for the default VDC, only nondefault VDCs.
This command requires the Advanced Services license.
Examples
This example shows how to allocate one Ethernet interface to a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# boot-order 2Related Commands
Command Descriptionshow vdc detail
Displays detailed information about the VDCs.
vdc
Creates or specifies a VDC and enters VDC configuration mode.
copy running-config startup-config vdc-all
To copy the running configuration for all virtual device contexts (VDCs) to the startup configuration, use the show copy running-config startup-config vdc-all command.
copy running-config startup-config vdc-all
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
This command does not require a license.
Examples
This example shows how to copy the running configuration for all VDCs on the physical device to the startup configuration:
switch# copy running-config startup-config vdc-all[########################################] 100%cpu-share
To control CPU time during periods of contention, use the cpu-share command.
cpu-share priority
Syntax Description
priority
Specifies the priority of the vdc control cpu time during periods of contention. The range is from 1 to 10.
Defaults
5
Command Modes
Global configuration mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
VDCs being used for testing should have comparatively lower values than those vdcs being used for production work.
This command does not require a license.
Examples
This example shows how to set the VDC cpu share to 10:
switch(config)#
vdc fooNote: Creating VDC, one moment please ...
switch(config-vdc)#
cpu-share 10switch(config-vdc)#
Related Commands
ha-policy
To configure the high availability (HA) policy for a virtual device context (VDC), use the ha-policy command.
ha-policy {dual-sup {bringdown | restart | switchover} | single-sup {bringdown | reload | restart}}
Syntax Description
Defaults
Default VDC: dual-sup default is switchover
single-sup default is reloadNondefault VDC: dual-sup default is switchover
single-sup default is restartCommand Modes
VDC configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
You cannot change the HA policy for the default VDC.
This command requires the Advanced Services license.
Examples
This example shows how to specify the HA policy for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# ha-policy resetRelated Commands
Command Descriptionshow vdc
Displays VDC interface membership information.
vdc
Creates or specifies a VDC and enters VDC configuration mode.
limit-resource module-type
To configure the line card type resource limit for a virtual device context (VDC), use the limit-resource module-type command. To revert to the default, use the no form of this command.
limit-resource module-type [f1 | f2 | f2e | m1 | m1x1| m2x1]
no limit-resource module-type [f1 | f2 | f2e | m1 | m1x1| m2x1]
Syntax Description
Defaults
None
Command Modes
VDC configuration
Supported User Rolesnetwork-admin
Command History
Release Modification6.2(2)
Added the f2e keyword.
6.1(1)
Added the m2x1 keyword.
5.1(1)
This command was introduced.
Usage Guidelines
By default, both the M1 and F1 types of line cards are supported in a VDC.
Note In Cisco NX-OS Release 6.1x, an F2E module is treated as an F2 module type. For Cisco NX-OS Release 6.2(2), F2 module type is automatically upgraded to F2 F2E.
The Cisco Nexus 7710 switch and Cisco Nexus 7718 switch supports only F2E module types in both an Ethernet VDC and Storage VDC.
A VDC supports only the following line card type modes:
•limit-resource module-type M1(default)—This module restricts a VDC to M1 modules only.
•limit-resource module-type F1—This module restricts a VDC to F1 modules only.
•no limit-resource module-type—This module allows a combination of F1 and M1 modules in a VDC.
Note This command does not support VDC resource templates.
This command does not require a license.
Examples
This example shows how to enable the M2X1type line card in the VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource module-type m2x1switch(config-vdc)#This example shows how to configure the line card type for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource module-type f1This will cause all ports of unallowed types to be removed from this vdc. Continue? [yes]switch(config-vdc)This example shows how to revert to the default line card type for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource module-type f1This will cause all ports of unallowed types to be removed from this vdc. Continue? [yes]switch(config-vdc)#Related Commands
Command Descriptionshow vdc resource
Displays VDC resource limits information.
vdc
Creates or specifies a VDC and enters VDC configuration mode.
limit-resource m4route-mem
To configure IPv4 multicast route map memory resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource m4route-mem command. To revert to the default, use the no form of this command.
limit-resource m4route-mem [minimum min-value] maximum max-value
no limit-resource m4route-mem
Syntax Description
Defaults
For the default VDC, the default minimum and maximum limit value is 58 MB.
For a nondefault VDC, the default minimum and maximum limit value is 8 MB.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Release Modification5.0(2)
Changed the minimum and maximum values.
4.1(2)
This command was introduced.
Usage Guidelines
The multicast routing information base (RIB) for IPv4 is in shared memory. The total available shared memory for the RIB for all VDCs on a physical device with 4 GB of memory is 256 MB. You can have approximately 11,000 routes, each with 16 next-hops, in 4 MB of IPv4 multicast route map memory.
Note Take care when reserving IPv4 multicast routing map memory for a VDC not to reserve more of the shared memory than is available.
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for IPv4 multicast routing map memory takes affect only after a device reload or a stateful supervisor module switchover.
Note You can set only one value for the IPv4 multicast route memory resource maximum and minimum limits. If you specify a minimum limit, that is the value for both the minimum and maximum limits and the maximum limit is ignored. If you specify only a maximum limit, that is the value for both the minimum and maximum limits.
This command does not require a license.
Examples
This example shows how to configure the IPv4 multicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource m4route-mem minimum 8 maximum 64This example shows how to revert to the default IPv4 multicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource m4route-memThis example shows how to configure the IPv4 multicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource m4route-mem minimum 4 maximum 40dThis example shows how to revert to the default IPv4 multicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource m4route-memRelated Commands
limit-resource m6route-mem
To configure IPv6 multicast route map memory resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource u6route-mem command. To revert to the default, use the no form of this command.
limit-resource m6route-mem [minimum min-value] maximum max-value
no limit-resource m6route-mem
Syntax Description
Defaults
For the default VDC, the default minimum and maximum limit value is 8 MB.
For a nondefault VDC, the default minimum and maximum limit value is 2 MB.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Release Modification5.0(2)
Changed the minimum and maximum values.
4.1.(2)
This command was introduced.
Usage Guidelines
The multicast routing information base (RIB) for IPv6 is in shared memory. The total available shared memory for RIB in a physical device with 4 GB of memory is 256 MB for both IPv4 and IPv6 route map memory. You can have approximately 11,000 routes, each with 16 next-hops, in 4 MB of IPv6 route map memory.
Note Take care when reserving IPv6 route map memory for a VDC not to reserve more of the shared memory than is available.
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for IPv6 multicast routing map memory takes affect after a device reload or a stateful supervisor module switchover.
Note You can set only one value for the IPv6 multicast route memory resource maximum and minimum limits. If you specify a minimum limit, that is the value for both the minimum and maximum limits and the maximum limit is ignored. If you specify only a maximum limit, that is the value for both the minimum and maximum limits.
This command does not require a license.
Examples
This example shows how to configure the IPv6 multicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource m6route-mem minimum 8 maximum 12This example shows how to revert to the default IPv6 multicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource m6route-memThis example shows how to configure the IPv6 multicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource m6route-mem minimum 4 maximum 16This example shows how to revert to the default IPv6 multicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource m6route-memRelated Commands
limit-resource monitor-session
To configure switched port analyzer (SPAN) monitor session resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource monitor-session command. To revert to the default, use the no form of this command.
limit-resource monitor-session minimum min-value maximum {max-value | equal-to-min}
no limit-resource monitor-session
Syntax Description
Defaults
The default minimum is 0.
The default maximum is 2.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for SPAN monitor sessions takes affect immediately.
This command does not require a license.
Examples
This example shows how to configure the SPAN monitor session limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource monitor-session minimum 1 maximum 2This example shows how to revert to the default SPAN monitor session limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource monitor-sessionThis example shows how to configure the SPAN monitor session limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource monitor-session minimum 0 maximum 1This example shows how to revert to the default SPAN monitor session limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource monitor-sessionRelated Commands
limit-resource monitor-session-erspan-dst
To configure the encapsulated remote switched port analyzer (ERSPAN) destination monitor session resource limits for a virtual device context (VDC), use the limit-resource monitor-session-erspan-dst command. To revert to the default, use the no form of this command.
monitor-session-erspan-dst [minimum min-value | maximum max-value]
no monitor-session-erspan-dst [minimum min-value | maximum max-value]
Syntax Description
Defaults
The default minimum is 0.
The default maximum is 24.
Command Modes
VDC configuration
VDC resource template configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to configure the ERSPAN destination monitor session limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource monitor-session-erspan-dst minimum 5 maximum 15
switch(config-vdc)#This example shows how to revert to the default ERSPAN destination monitor session limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource monitor-session-erspan-dst minimum 5 maximum 15
switch(config-vdc)#Related Commands
limit-resource port-channel
To configure port channel resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource port-channel command. To revert to the default, use the no form of this command.
limit-resource port-channel minimum min-value maximum {max-value | equal-to-min}
no limit-resource monitor-session
Syntax Description
Defaults
The default minimum is 0.
The default maximum is 768.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Release Modification4.1(2)
Changed the default maximum limit from 192 to 768.
4.0(1)
This command was introduced.
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for port channels takes affect immediately.
This command does not require a license.
Examples
This example shows how to configure the port channel resource limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource port-channel minimum 8 maximum 64This example shows how to revert to the default port channel limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource port-channelThis example shows how to configure the port channel limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource port-channel minimum 4 maximum 128This example shows how to revert to the default port channel limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource port-channelRelated Commands
limit-resource u4route-mem
To configure IPv4 unicast route map memory resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource u4route-mem command. To revert to the default, use the no form of this command.
limit-resource u4route-mem [minimum min-value] maximum max-value
no limit-resource u4route-mem
Syntax Description
Defaults
For the default VDC, the default minimum and maximum limit value is 96 MB.
For a nondefault VDC, the default minimum and maximum limit value is 8 MB.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Usage Guidelines
The unicast routing information base (RIB) for IPv4 is in shared memory. The total available shared memory for the RIB for all VDCs on a physical device with 4 GB of memory is 256 MB. You can have approximately 11,000 routes, each with 16 next-hops, in 16 MB of IPv4 unicast route map memory.
Note Be careful when you are reserving IPv4 unicast routing map memory for a VDC that you do not reserve more of the shared memory than is available.
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for IPv4 unicast routing map memory takes affect only after a device reload or a stateful supervisor module switchover.
Note You can set only one value for the IPv4 unicast route memory resource maximum and minimum limits. If you specify a minimum limit, that is the value for both the minimum and maximum limits and the maximum limit is ignored. If you specify only a maximum limit, that is the value for both the minimum and maximum limits.
There are two options to make this command take effect:
•If this is a single-sup system, do a `copy run start' and reload the box.
•If there are two sup cards, you can do a system-switchover.
This command does not require a license.
Examples
This example shows how to configure the IPv4 unicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource u4route-mem minimum 8 maximum 64This example shows how to revert to the default IPv4 unicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource u4route-memThis example shows how to configure the IPv4 unicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource u4route-mem minimum 4 maximum 40This example shows how to revert to the default IPv4 unicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource u4route-memRelated Commands
limit-resource u6route-mem
To configure IPv6 unicast route map memory resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource u6route-mem command. To revert to the default, use the no form of this command.
limit-resource u6route-mem [minimum min-value] maximum max-value
no limit-resource u6route-mem
Syntax Description
Defaults
For the default VDC, the default minimum and maximum limit value is 24 MB.
For a nondefault VDC, the default minimum and maximum limit value is 4 MB.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Usage Guidelines
The unicast routing information base (RIB) for IPv6 is in shared memory. The total available shared memory for RIB in a physical device with 4 GB of memory is 256 MB for both IPv4 and IPv6 route map memory. You can have approximately 11,000 routes, each with 16 next-hops, in 16 MB of IPv6 route map memory.
Note Be careful when you are reserving IPv4 unicast routing map memory for a VDC that you do not reserve more of the shared memory than is available.
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for IPv6 unicast routing map memory takes affect after a device reload or a stateful supervisor module switchover.
Note You can set only one value for the IPv6 unicast route memory resource maximum and minimum limits. If you specify a minimum limit, that is the value for both the minimum and maximum limits and the maximum limit is ignored. If you specify only a maximum limit, that is the value for both the minimum and maximum limits.
This command does not require a license.
Examples
This example shows how to configure the IPv6 unicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource u6route-mem minimum 8 maximum 24This example shows how to revert to the default IPv6 unicast route memory limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource u6route-memThis example shows how to configure the IPv6 unicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource u6route-mem minimum 4 maximum 32This example shows how to revert to the default IPv6 unicast route memory limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource u6route-memRelated Commands
limit-resource vlan
To configure VLAN resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource vlan command. To revert to the default, use the no form of this command.
limit-resource vlan minimum min-value maximum {max-value | equal-to-min}
no limit-resource vlan
Syntax Description
Defaults
The default minimum is 16.
The default maximum is 4094.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for VLANs takes affect immediately.
This command does not require a license.
Examples
This example shows how to configure the VLAN limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource vlan minimum 32 maximum 2056This example shows how to revert to the default VLAN limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource vlanThis example shows how to configure the VLAN limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource vlan minimum 24 maximum 3000This example shows how to revert to the default VLAN limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource vlanRelated Commands
limit-resource vrf
To configure virtual routing and forwarding instance (VRF) resource limits for a virtual device context (VDC) or a VDC resource template, use the limit-resource vrf command. To revert to the default, use the no form of this command.
limit-resource vrf minimum min-value maximum {max-value | equal-to-min}
no limit-resource vrf
Syntax Description
Defaults
The default minimum is 16.
The default maximum is 1000.Command Modes
VDC configuration
VDC resource template configurationSupported User Rolesnetwork-admin
Command History
Release Modification5.0(2)
Changed the minimum and maximum values.
4.0(1)
This command was introduced.
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
The Cisco NX-OS software reserves the minimum limit for the resource. Changing the minimum limit for VRFs takes affect immediately.
This command does not require a license.
Examples
This example shows how to configure the VRF limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# limit-resource vrf minimum 32 maximum 1000This example shows how to revert to the default VRF limits for a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# no limit-resource vrfThis example shows how to configure the VRF limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# limit-resource vrf minimum 64 maximum 1000This example shows how to revert to the default VRF limits for a VDC resource template:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)# no limit-resource vrfRelated Commands
reload vdc
To reload a nondefault virtual device context (VDC), use the reload vdc command.
reload vdc
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode in a nondefault VDC
Supported User Rolesnetwork-admin
vdc-adminCommand History
Usage Guidelines
You can use the reload vdc command only in the nondefault VDCs.
Note Use the reload command to reload the default VDC, which also reloads all nondefault VDCs.
This command requires the Advanced Services license.
Caution Reloading a VDC disrupts all traffic on the VDC.
Examples
This example shows how to reload a nondefault VDC:
switch-TestVDC# reload vdcRelated Commands
show mac vdc
To display the MAC address of a specific virtual device context (VDC), use the show mac vdc command.
show mac vdc vdc-id
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to display the MAC address of a specific VDC:
switch# show mac vdc 1
vdc id = 1, management port mac address = f8:66:f2:09:f2:e8switch#Related Commands
Command Descriptionshow vdc
Displays virtual context device (VDC) information.
show vdc resource
Displays the virtual device context (VDC) resource information.
show resource
To display the resource usage for a virtual device context (VDC), use the show resource command.
show resource [monitor-sessions | port-channel | u4route-mem | u6route-mem | vlan | vrf]
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to display the resource usage for a VDC:
switch# show resourceResource Min Max Used Unused Avail----------- ----- ----- ------ -------- -------port-channel 0 192 4 0 188monitor-session 0 2 2 0 0vlan 16 4094 12 4 4082u6route-mem 16 256 16 0 232u4route-mem 32 256 32 0 208vrf 16 8192 2 14 8158show running-config vdc
To display the virtual device context (VDC) information in the default VDC running configuration, use the show running-config vdc command.
show running-config vdc
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
This command does not require a license.
Examples
This example shows how to display VDC information in the running configuration:
switch# show running-config vdcversion 4.0(1)vdc switch id 1limit-resource vlan minimum 16 maximum 4094limit-resource monitor-session minimum 0 maximum 2limit-resource vrf minimum 16 maximum 1000limit-resource port-channel minimum 0 maximum 192limit-resource u4route-mem minimum 32 maximum 256limit-resource u6route-mem minimum 16 maximum 256vdc Payroll id 2allocate interface Ethernet2/47limit-resource vlan minimum 16 maximum 4094limit-resource monitor-session minimum 0 maximum 2limit-resource vrf minimum 16 maximum 1000limit-resource port-channel minimum 0 maximum 192limit-resource u4route-mem minimum 8 maximum 256limit-resource u6route-mem minimum 4 maximum 256vdc Engineering id 3allocate interface Ethernet2/46limit-resource vlan minimum 16 maximum 4094limit-resource monitor-session minimum 0 maximum 2limit-resource vrf minimum 16 maximum 1000limit-resource port-channel minimum 0 maximum 192limit-resource u4route-mem minimum 8 maximum 256limit-resource u6route-mem minimum 4 maximum 256vdc resource template MyTemplateshow running-config vdc-all
To display the running configurations for all virtual device contexts (VDCs), use the show running-config vdc-all command.
show running-config vdc-all [all]
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
This command does not require a license.
Examples
This example shows how to display the running configurations for all VDCs:
switch# show running-config vdc-all!Running config for vdc: switchswitchto vdc switchversion 4.0(1)snmp-server enable traps entitypower redundancy-mode combined forcefeature tacacs+feature pbrfeature private-vlanfeature interface-vlanfeature dot1xfeature lacpfeature glbpfeature dhcpfeature eoufeature tunnelfeature ctslogging level glbp 6role name MyRoleusername adminbackup password 5 $1$Oip/C5Ci$oOdx7oJSlBCFpNRmQK4na. role network-operatorusername admin password 5 $1$x.9srJIq$jvKISFQ1sxR4oi44YanxJ0 role network-adminusername User1 password 5 $1$Dm4XUUyR$V1/3B25/84g3YRkOt3Rj50 role network-operatortelnet server enablessh key rsa 768 forcekernel core target 0.0.0.0kernel core limit 1aaa group server radius aaa-private-sguse-vrf managementvlan dot1Q tag nativesystem default switchportno system default switchport shutdownsnmp-server user User1 auth md5 0xbc9d5254b8aedec4747ad156d8726ae0 priv 0xbc9d5254b8aedec4747ad156d8726ae0 localizedkey engineID 128:0:0:9:3:0:24:186:216:63:188snmp-server user admin auth md5 0xbc9d5254b8aedec4747ad156d8726ae0 priv 0xbc9d5254b8aedec4747ad156d8726ae0 localizedkey engineID 128:0:0:9:3:0:24:186:216:63:188snmp-server enable traps licensevrf context managementip route 0.0.0.0/0 172.28.230.1logging level sysmgr 1logging server 172.28.254.254vdc switch id 1limit-resource vlan minimum 16 maximum 4094limit-resource monitor-session minimum 0 maximum 2limit-resource vrf minimum 16 maximum 1000limit-resource port-channel minimum 0 maximum 192limit-resource u4route-mem minimum 32 maximum 256limit-resource u6route-mem minimum 16 maximum 256vdc Payroll id 2allocate interface Ethernet2/47limit-resource vlan minimum 16 maximum 4094limit-resource monitor-session minimum 0 maximum 2limit-resource vrf minimum 16 maximum 1000limit-resource port-channel minimum 0 maximum 192limit-resource u4route-mem minimum 8 maximum 256limit-resource u6route-mem minimum 4 maximum 256vdc Engineering id 3allocate interface Ethernet2/46limit-resource vlan minimum 16 maximum 4094limit-resource monitor-session minimum 0 maximum 2limit-resource vrf minimum 16 maximum 1000limit-resource port-channel minimum 0 maximum 192limit-resource u4route-mem minimum 8 maximum 256limit-resource u6route-mem minimum 4 maximum 256vdc resource template MyTemplateinterface Vlan1interface Ethernet2/1shutdownswitchportswitchport monitorip access-group markin inip dhcp snooping limit rate 80ip arp inspection limit rate 300 burst interval 5interface Ethernet2/2shutdownno switchportinterface Ethernet2/2.1shutdowninterface Ethernet2/3no cdp enableshutdownstorm-control broadcast level 20storm-control unicast level 20switchportdot1x mac-auth-bypass....interface mgmt0ip address 172.28.231.193/23line consolespeed 115200logging level cdp 6event manager applet xmonitor session 1no shutmonitor session 2no shutsource interface Ethernet2/2 bothsource interface Ethernet2/5 bothdestination interface Ethernet2/1destination interface Ethernet2/3filter vlan 50monitor session 3no shutlogging level dhcp_snoop 6logging level eth_port_channel 6logging ip access-list cache entries 8000logging ip access-list cache interval 300logging ip access-list cache threshold 0acllog match-log-level 6!Running config for vdc: Payrollswitchto vdc Payrollim_verify_ifindex failed for 0x5000000status: 0x411a0000 - shared pss not openedif_info_status: 0x0version 4.0(1)username admin password 5 $1$f89fb1AG$TK6vd.TAq0rp9Gwzc7j6y0 role network-admitelnet server enablessh key rsa 768 forceaaa group server radius aaa-private-sguse-vrf managementsnmp-server user admin network-admin auth md5 0xddf68fa88ad2a5ea0818856db35fa9fpriv 0xddf68fa88ad2a5ea0818856db35fa9fb localizedkeyvrf context managementip route 0.0.0.0/0 172.28.230.1logging server 172.28.254.254interface Ethernet2/47logging ip access-list cache entries 8000logging ip access-list cache interval 300logging ip access-list cache threshold 0acllog match-log-level 6!Running config for vdc: Engineeringswitchto vdc Engineeringim_verify_ifindex failed for 0x5000000status: 0x411a0000 - shared pss not openedif_info_status: 0x0version 4.0(1)username admin password 5 $1$pPFrW5.g$rciQSDOB/A/c0N8eXf1081 role network-admitelnet server enablessh key rsa 768 forceaaa group server radius aaa-private-sguse-vrf managementsnmp-server user admin network-admin auth md5 0x67568a735d6a1f7e4833fd0de8c196fpriv 0x67568a735d6a1f7e4833fd0de8c196fb localizedkeyvrf context managementip route 0.0.0.0/0 172.28.230.1logging server 172.28.254.254interface Ethernet2/46logging ip access-list cache entries 8000logging ip access-list cache interval 300logging ip access-list cache threshold 0acllog match-log-level 6show startup-config vdc-all
To display the configuration information for all virtual device contexts (VDCs) in the startup configuration, use the show startup-config vdc-all command.
show startup-config vdc-all
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
This command does not require a license.
Examples
This example shows how to display information for all VDCs in the startup configuration:
switch# show startup-config vdc-allshow vdc
To display virtual context device (VDC) information, use the show vdc command.
show vdc [vdc-name] [detail]
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
In the default VDC, this command displays information about all VDCs on the physical device. In nondefault VDCs, this command display information only about the current VDC.
This command does not require a license.
Examples
This example shows how to display summary information about VDCs in the default VDC:
switch# show vdcvdc_id vdc_name state mac------ -------- ----- ----------1 switch active 00:18:ba:d8:3f:fd2 Payroll active 00:18:ba:d8:3f:fe3 MyVDC active 00:18:ba:d8:3f:ffThis example shows how to display detailed information about VDCs in the default VDC:
switch# show vdc detailvdc id: 1vdc name: switchvdc state: activevdc mac address: 00:22:55:79:a4:c1vdc ha policy: RELOADvdc dual-sup ha policy: SWITCHOVERvdc boot Order: 1vdc create time: Thu May 14 08:14:39 2009vdc restart count: 0vdc id: 2vdc name: payrollvdc state: activevdc mac address: 00:22:55:79:a4:c2vdc ha policy: RESTARTvdc dual-sup ha policy: SWITCHOVERvdc boot Order: 1vdc create time: Thu May 14 08:15:22 2009vdc restart count: 0vdc id: 3vdc name: testvdc state: activevdc mac address: 00:22:55:79:a4:c3vdc ha policy: RESTARTvdc dual-sup ha policy: SWITCHOVERvdc boot Order: 1vdc create time: Thu May 14 08:15:29 2009vdc restart count: 0This example shows how to display summary VDC information in a nondefault VDC:
switch-Payroll# show vdc Payrollvdc_id vdc_name state mac------ -------- ----- ----------2 Payroll active 00:18:ba:d8:3f:feThis example shows how to display detailed VDC information in a nondefault VDC:
switch-Payroll# show vdc Payroll detailvdc id: 2vdc name: payrollvdc state: activevdc mac address: 00:22:55:79:a4:c2vdc ha policy: RESTARTvdc dual-sup ha policy: SWITCHOVERvdc boot Order: 1vdc create time: Thu May 14 08:15:22 2009vdc restart count: 0show vdc current-vdc
To display the current virtual device context (VDC) identifier information, use the show vdc current-vdc command.
show vdc current-vdc
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can use this command in any VDC.
This command does not require a license.
Examples
This example shows how to display the current VDC identifier information:
switch-Payroll# show vdc current-vdcCurrent vdc is 2 - Payrollshow vdc membership
To display the interface membership information for the virtual device contexts (VDCs), use the show vdc membership command.
show vdc membership [status]
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can use this command only in the default VDC.
This command does not require a license.
Examples
This example shows how to display the interface membership information in the default VDC:
switch# show vdc membershipvdc_id: 1 vdc_name: switch interfaces:Ethernet2/1 Ethernet2/2 Ethernet2/3Ethernet2/4 Ethernet2/5 Ethernet2/6Ethernet2/7 Ethernet2/8 Ethernet2/9Ethernet2/10 Ethernet2/11 Ethernet2/12Ethernet2/13 Ethernet2/14 Ethernet2/15Ethernet2/16 Ethernet2/17 Ethernet2/18Ethernet2/19 Ethernet2/20 Ethernet2/21Ethernet2/22 Ethernet2/23 Ethernet2/24Ethernet2/25 Ethernet2/26 Ethernet2/27Ethernet2/28 Ethernet2/29 Ethernet2/30Ethernet2/31 Ethernet2/32 Ethernet2/33Ethernet2/34 Ethernet2/35 Ethernet2/36Ethernet2/37 Ethernet2/38 Ethernet2/39Ethernet2/40 Ethernet2/41 Ethernet2/42Ethernet2/43 Ethernet2/44 Ethernet2/45Ethernet2/48vdc_id: 2 vdc_name: Payroll interfaces:Ethernet2/47vdc_id: 3 vdc_name: MyVDC interfaces:Ethernet2/46This example shows how to display the interface membership information in a nondefault VDC:
switch-Payroll# show vdc membershipvdc_id: 2 vdc_name: Payroll interfaces:Ethernet2/47This example shows how to display the interface status information in a default VDC:
switch# show vdc membership statusvdc_id: 1 vdc_name: switch interfaces:Port Status---- ----------Eth2/1 OKEth2/2 OKEth2/3 OKEth2/4 OKEth2/5 OKEth2/6 OKEth2/7 OKEth2/8 OKEth2/9 OKEth2/10 OK...show vdc resource
To display the virtual device context (VDC) resource information, use the show vdc resource command.
show vdc resource [monitor-session | port-channel | u4route-mem | vlan | vrf] [detail]
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
This command does not require a license.
Examples
This example shows how to display summary VDC resource information:
switch# show vdc resourceport-channel 0 used 0 unused 192 free 192 totalmonitor-session 0 used 0 unused 2 free 2 totalvlan 14 used 34 unused 16370 free 16384 totalu4route-mem 48 used 0 unused 208 free 256 totalvrf 6 used 42 unused 8186 free 8192 totalThis example shows how to display detailed VDC resource information:
switch# show vdc resource detailport-channel 0 used 0 unused 192 free 192 total--------------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 0 192 0 0 192Payroll 0 192 0 0 192MyVDC 0 192 0 0 192monitor-session 0 used 0 unused 2 free 2 total-----------------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 0 2 0 0 2Payroll 0 2 0 0 2MyVDC 0 2 0 0 2vlan 14 used 34 unused 16370 free 16384 total------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 16 4094 10 6 4084Payroll 16 4094 2 14 4092MyVDC 16 4094 2 14 4092u4route-mem 48 used 0 unused 208 free 256 total-------------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 32 256 32 0 208Payroll 8 256 8 0 208MyVDC 8 256 8 0 208vrf 6 used 42 unused 8186 free 8192 total-----Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 16 8192 2 14 8158Payroll 16 8192 2 14 8158MyVDC 16 8192 2 14 8158This example shows how to display summary VDC resource information for port channels:
switch# show vdc resource port-channelport-channel 0 used 0 unused 192 free 192 totalThis example shows how to display detailed VDC resource information for port channels:
switch# show vdc resource port-channel detailport-channel 0 used 0 unused 192 free 192 total--------------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 0 192 0 0 192Payroll 0 192 0 0 192MyVDC 0 192 0 0 192show vdc resource template
To display the virtual device context (VDC) resource template information, use the show vdc resource template command.
show vdc resource template [vdc-template-name]
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
This command does not require a license.
Examples
This example shows how to display summary information for all VDC resource templates:
switch# show vdc resource templateMyTemplate------------Resource Min Max---------- ----- -----port-channel 8 64global-default----------------Resource Min Max---------- ----- -----u4route-mem 32 256vdc-default-------------Resource Min Max---------- ----- -----port-channel 0 192monitor-session 0 2vlan 16 4094u4route-mem 8 256vrf 16 8192This example shows how to display summary information for a specific VDC resource template:
switch# show vdc resource template MyTemplateMyTemplate------------Resource Min Max---------- ----- -----port-channel 8 64This example shows how to display detailed VDC resource information:
switch# show vdc resource detailport-channel 0 used 0 unused 192 free 192 total--------------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 0 192 0 0 192Payroll 0 192 0 0 192MyVDC 0 192 0 0 192monitor-session 0 used 0 unused 2 free 2 total-----------------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 0 2 0 0 2Payroll 0 2 0 0 2MyVDC 0 2 0 0 2vlan 14 used 34 unused 16370 free 16384 total------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 16 4094 10 6 4084Payroll 16 4094 2 14 4092MyVDC 16 4094 2 14 4092u4route-mem 48 used 0 unused 208 free 256 total-------------Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 32 256 32 0 208Payroll 8 256 8 0 208MyVDC 8 256 8 0 208vrf 6 used 42 unused 8186 free 8192 total-----Vdc Min Max Used Unused Avail----- ----- ----- ------ -------- -------switch 16 8192 2 14 8158Payroll 16 8192 2 14 8158MyVDC 16 8192 2 14 8158show vdc shared membership
To display the shared interfaces on a virtual device context (VDC), use the show vdc shared membership command.
show vdc shared membership
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to display the shared interfaces on the VDC:
switch# show vdc shared membership
vdc_id: 1 vdc_name: PE3_1 interfaces:vdc_id: 2 vdc_name: P2 interfaces:vdc_id: 3 vdc_name: CE3_1 interfaces:vdc_id: 4 vdc_name: test-vdc interfaces:switch#Related Commands
switchback
To switch back to the default virtual device context (VDC) from another VDC, use the switchback command.
switchback
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
This command requires the Advanced Services license.
Examples
This example shows how to switch back to the default VDC:
switch-MyVDC# switchbackswitch(config)#Related Commands
Command Descriptionshow current vdc
Displays information about the current VDC.
switchto vdc
Switches to a nondefault VDC.
switchto vdc
To switch to another virtual device context (VDC) from the default VDC, use the switchto vdc command.
switchto vdc vdc-name
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
•Only users with the network-admin or network-operator role can use the switchto vdc command. No other users are permitted to use it.
•No user can grant permission to another role to use the switchto vdc command.
•After a network-admin uses the switchto vdc command, this user becomes a vdc-admin for the new VDC. Similarly, after a network-operator uses the switchto vdc command, this user becomes a vdc-operator for the new VDC. Any other roles associated with the user are not valid after the switchto vdc command is entered.
•After a network-admin or network-operator uses the switchto vdc command, this user cannot use this command to switch to another VDC. The only option is to use the switchback command to return to the original VDC.
You can use this command only from the default VDC (VDC 1).
To return to the default VDC, use the exit from EXEC mode or the switchback command.
This command requires the Advanced Services license.
Examples
This example shows how to switch to a VDC:
switch# switchto vdc MyDeviceTAC support: http://www.cisco.com/tacCopyright (c) 2002-2008, Cisco Systems, Inc. All rights reserved.The copyrights to certain works contained in this software areowned by other third parties and used and distributed underlicense. Certain components of this software are licensed underthe GNU General Public License (GPL) version 2.0 or the GNULesser General Public License (LGPL) Version 2.1. A copy of eachsuch license is available athttp://www.opensource.org/licenses/gpl-2.0.php andhttp://www.opensource.org/licenses/lgpl-2.1.phpswitch-MyDevice#Related Commands
Command Descriptionshow current vdc
Displays information about the current VDC.
switchback
Returns to the default VDC.
system admin-vdc migrate
To configure the default VDC used for switchwide configuration to copy any local config from default VDC to a new VDC, use the system admin-vdc migrate command.
system admin-vdc migrate vdc
no system admin-vdc
Syntax Description
Defaults
Disabled
Command Modes
Global configuration mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to configure the default VDC used for switchwide configuration to copy any local config from default VDc to a new VDC:
switch(config)# system admin-vdc migrate vdc2switch(config)#Related Commands
Command Descriptionshow vdc
Displays whether the default VDC is configured for Ethernet or Admin VDC mode.
system module type
To enter switchwide VDC mode and specify which modules can be enabled on a chassis, use the system module type comman. To revert to the defaut settings and allow all modules, use the no form of this command.
system module-type module-type
no system module-type module-type
Syntax Description
Defaults
None
Command Modes
Global configuration mode
Supported User Rolesnetwork-admin
network-operator
vdc-admin
vdc-operatorCommand History
Usage Guidelines
You can enable a mix of F1, F2, F2E, M1, M1XL, and M2 Series modules.
Note In Cisco NX-OS Release 6.1x, an F2E module is treated as an F2 module type. For Cisco NX-OS Release 6.2(2), F2 module type is automatically upgraded to F2 F2E.
There are no restrictions on the type of mix allowed for the system module-type command.
The Cisco Nexus 7710 switch and Cisco Nexus 7718 switch supports only F2E module types in both an Ethernet VDC and Storage VDC.
Restrictions on the module types that can be mixed in a VDC are controlled by the limit-resource module-type command.
The modules that you do not enable must not be powered on after you configure this feature and enter y or yes.
An error message forces you to manually disable these modules before proceeding, which prevents major disruptions and service issues within a VDC.
This command does not require a license.
Examples
This example shows how to control the type of modules that are allowed in this chassis: :
switch# configure terminal
switch(config)# system module-type f1 m1xl f2 m2xl fc f2e
Modules of unsupported types will not be allowed to power on after this. Continue(y/n)?[yes]switch(config)#This example shows how to return to the default settings:switch(config)# system module-type f1 m1xl f2 m2xl fc f2eswitch(config)#Related Commands
template
To apply a virtual device context (VDC) resource template to a VDC, use the template command.
template vdc-template-name
Syntax Description
Defaults
None
Command Modes
VDC configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
You can use this command only in the default VDC (VDC 1).
This command does not require a license.
Examples
This example shows how to apply a resource template to a VDC:
switch# configure terminalswitch(config)# vdc MyDeviceswitch(config-vdc)# template MyTemplateRelated Commands
Command Descriptionshow vdc
Displays VDC interface membership information.
vdc
Creates or specifies a VDC and enters VDC configuration mode.
vdc
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
Syntax Description
Defaults
The default HA policy for the default VDC: dual-sup default is switchover
single-sup default is reloadThe default HA policy for nondefault VDCs: dual-sup default is switchover
single-sup default is restartThe default VDC ID is first available.
The default VDC resource template is the default template.
The default switchover policy is bringdown.Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Release Modification5.2(1)
Added the type and storage keywords.
4.0(1)
This command was introduced.
Usage Guidelines
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 VDC, the Cisco NX-OS software removes the interface configuration and moves the interfaces to the default VDC.
This command requires the Advanced Services license for creating and managing nondefault VDCs. It does not require a license for managing the default VDC.
Examples
This example shows how to create a VDC and enter VDC configuration mode:
switch# configure terminalswitch(config)# vdc MyDeviceNote: VDC creation is a time consuming process, please wait until the command completesswitch(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 terminalswitch(config)# vdc MyDevice ha-policy single-sup reloadNote: VDC creation is a time consuming process, please wait until the command completesswitch(config-vdc)#This example shows how to delete a VDC:
switch# configure terminalswitch(config)# no vdc MyDeviceDeleting this vdc will remove its config. Continue deleting this vdc? [no] yesNote: VDC deletion is a time consuming process, please wait until the command completesRelated Commands
vdc combined-hostname
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
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to change the CLI prompt for the nondefault VDCs to include the hostname:
switch# configure terminalswitch(config)# vdc combined-hostnameThis example shows how to change the CLI prompt for the nondefault VDCs to not include the hostname:
switch# configure terminalswitch(config)# no vdc combined-hostnamevdc resource template
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
Syntax Description
vdc-template-name
VDC resource template name. The name has a maximum length of 32 characters and is not case-sensitive.
Defaults
Resource Minimum MaximumIPv4 multicast route map memory1
8
8
IPv6 multicast route map memory1
2
2
IPv4 unicast route map memory1
8
8
IPv6 unicast route map memory1
4
4
Port channels
0
768
SPAN sessions
0
2
VLANs
16
4094
VRFs
16
8192
1 Route map memory limits are in megabytes.
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
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.
Examples
This example shows how to create or specify a VDC resource template and enter VDC resource template configuration mode:
switch# configure terminalswitch(config)# vdc resource template MyTemplateswitch(config-vdc-template)#This example shows how to delete a VDC resource template:
switch# configure terminalswitch(config)# no vdc resource template MyTemplateRelated Commands
vdc restart
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
Syntax Description
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Release Modification4.2(4)
This command was replaced by the reload vdc command.
4.2(1)
This command was introduced.
Usage Guidelines
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.
Examples
This example shows how to restart a VDC:
switch# configure terminalswitch(config)# vdc TestVDC restartRelated Commands
Command Descriptionreload vdc
Restarts the current VDC.
show vdc
Displays the information and status for all VDCs on the physical device.
vdc suspend
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
Syntax Description
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
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.
Examples
This example shows how to suspend VDC operation:
switch# configure terminalswitch(config)# vdc TestVDC suspendThis example shows how to resume VDC operation:
switch# configure terminalswitch(config)# no vdc TestVDC suspendRelated Commands
Command Descriptionshow vdc
Displays the information and status for all VDCs on the physical device.