Cisco Nexus 7000 Series NX-OS Virtual Device Context Configuration Guide, Release 4.0 - Configuring VDC Resource Templates [Cisco Nexus 7000 Series Switches]

Table Of Contents

Configuring VDC Resource Templates

Information About VDC Resource Templates

Licensing Requirements for VDC Templates

Guidelines and Limitations

Configuring VDC Resource Templates

Verifying the VDC Resource Template Configuration

Example VDC Resource Template Configuration

Default Settings

Additional References

Related Documents

Feature History for VDC Resource Templates

Configuring VDC Resource Templates

This chapter describes how to configure virtual device context (VDC) resource templates on NX-OS devices.

This chapter includes the following sections:

•Information About VDC Resource Templates

•Licensing Requirements for VDC Templates

•Guidelines and Limitations

•Configuring VDC Resource Templates

•Verifying the VDC Resource Template Configuration

•Example VDC Resource Template Configuration

•Default Settings

•Additional References

•Feature History for VDC Resource Templates

Information About VDC Resource Templates

VDC resource templates set the minimum and maximum limits for shared physical device resources when you create the VDC. The Cisco NX-OS software reserves the minimum limit for the resource to the VDC. Any resources allocated to the VDC beyond the minimum are based on the maximum limit and availability on the device.

You can explicitly specify a VDC resource template or you can use the default VDC template provided by the NX-OS software. VDC templates set limits on the following resources:

•IPv4 route memory

•IPv6 route memory

•Port channels

•Switch Port Analyzer (SPAN) sessions

•VLANs

•Virtual routing and forwarding instances (VRFs)

Note The IPv4 and IPv6 route memory available 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 13 MB of route memory. The show routing memory estimate routes number-of-routes next-hops number-of-next-hops command shows the amount of unicast RIB (IPv4 RIB and IPv6 RIB) shared memory needed to support the specified number of routes and next hops.

If you do not set a limit for a resource in a VDC resource template, the default limits for that resource are the same as those in the default VDC resource template. Table 2-1 and Table 2-2 list the default VDC resource template limits.

Table 2-1 Default VDC Resource Template Limits for Cisco NX-OS Release 4.0(1a) and Earlier Releases

Resource

Minimum

Maximum

IPv4 route memory¹

8

256

IPv6 route memory¹

4

256

Port channels

0

256

SPAN sessions

0

2

VLANs

16

4094

VRFs

16

8192

¹Route memory limits are in megabytes.

Table 2-2 Default VDC Resource Template Limits for Cisco NX-OS Release 4.0(2) and Later Releases

Resource

Minimum

Maximum

IPv4 route memory¹

8

320

IPv6 route memory¹

4

192

Port channels

0

256

SPAN sessions

0

2

VLANs

16

4094

VRFs

16

8192

¹Route memory limits are in megabytes.

Note You cannot change the limits in the default VDC resource template.

Any changes that you make to a VDC resource template do not affect any VDCs you created using that VDC resource template. To update a VDC with the new limits in the VDC resource, you must explicitly reapply the template to the VDC (see Chapter 4, "Managing VDCs").

Note Only the network administrator can change a VDC template in the default VDC.

Licensing Requirements for VDC Templates

The following table shows the licensing requirements for this feature:

Product

License Requirement

NX-OS

VDC templates require no license. Any feature not included in a license package is bundled with the Cisco NX-OS system images and is provided at no extra charge to you. For a complete explanation of the NX-OS licensing scheme, see the Cisco Nexus 7000 Series NX-OS Licensing Guide, Release 4.1.

Guidelines and Limitations

VDC templates have the following guidelines and limitations:

•VDC templates can only be created by the network administrator in the default VDC.

•You can create a maximum of 64 VDC templates.

Configuring VDC Resource Templates

The maximum amount of system resources assigned to a VDC is limited by the VDC resource template used when the VDC is created. You can create VDC resource templates to use when creating VDCs to use resource limits other than those provided in the default VDC resource template. You can create a maximum of 64 VDC resource templates.

Note If you do not set limits for a resource in a VDC resource template, the default limits are the limits for that resource in the default VDC resource template (see Table 2-1).

Note You can have a maximum of two SPAN monitoring sessions on your physical device.

Note You cannot change the configuration of the default resource templates.

SUMMARY STEPS

1. config t

2. vdc resource template vdc-template-name

3. limit-resource monitor-session minimum min-value maximum {max-value | equal-to-min}

limit-resource port-channel minimum min-value maximum {max-value | equal-to-min}

limit-resource u4route-mem minimum min-value maximum max-value

limit-resource u6route-mem minimum min-value maximum max-value

limit-resource vlan minimum min-value maximum {max-value | equal-to-min}

limit-resource vrf minimum min-value maximum {max-value | equal-to-min}

4. exit

5. show vdc resource template

6. copy running-config startup-config

DETAILED STEPS
Command

Purpose
Step 1
config t
Example:
switch# config t
switch(config)#
Enters configuration mode.
Step 2
vdc resource template vdc-template-name
Example:
switch(config)# vdc resource template TemplateA
switch(config-vdc-template)#
Specifies the VDC resource template name and enters VDC resource template configuration mode. The name is a maximum of 32 characters and is not case sensitive.
Step 3
limit-resource monitor-session minimum min-value maximum {max-value | equal-to-min}
Example:
switch(config-vdc-template)# limit-resource monitor-session minimum 1 maximum equal-to-min
Specifies the limits for SPAN monitor session resources. The default minimum value is 0. The default maximum value is 2. The range is from 0 to 2. The equal-to-min keyword automatically sets the maximum limit equal to the minimum limit.

Note You can have a maximum of two SPAN monitoring sessions on your physical device.
limit-resource port-channel minimum min-value maximum {max-value | equal-to-min}
Example:
switch(config-vdc-template)# limit-resource port-channel minimum 4 maximum 128
Specifies the limits for port channels. The default minimum value is 0. The default maximum value is 256. The range is from 0 to 256. The equal-to-min keyword automatically sets the maximum limit equal to the minimum limit.
limit-resource u4route-mem minimum min-value maximum max-value
Example:
switch(config-vdc-template)# limit-resource u4route-mem minimum 4 maximum 40
Specifies the limits for IPv4 route memory in megabytes. The default minimum value is 8.

In Cisco NX-OS Release 4.0(1a) and earlier releases, the default maximum value is 256 and the range for both values is from 1 to 256. In Cisco NX-OS Release 4.0(2) and later releases, the default maximum value is 320 and the range for both values is from 1 to 320.
limit-resource u6route-mem minimum min-value maximum max-value
Example:
switch(config-vdc-template)# limit-resource u6route-mem minimum 4 maximum 32
Specifies the limits for IPv6 route memory in megabytes. The default minimum value is 4.

In Cisco NX-OS Release 4.0(1a) and earlier releases, the default maximum value is 256. In Cisco NX-OS Release 4.0(2) and later releases, the default maximum value is 192. The range for both values is from 1 to 256.
limit-resource vrf minimum min-value maximum {max-value | equal-to-min}
Example:
switch(config-vdc-template)# limit-resource vrf minimum 32 maximum 4096
Specifies the limits for VRF. The default minimum value is 16. The default maximum value is 8192. The range is from 16 to 8192. The equal-to-min keyword automatically sets the maximum limit equal to the minimum limit.
Step 4
exit
Example:
switch(config-vdc-template)# exit
switch(config)#
Exits VDC template configuration mode.
Step 5
show vdc resource template
Example:
switch(config)# show vdc resource template
(Optional) Displays VDC template configuration information.
Step 6
copy running-config startup-config
Example:
switch(config)# copy running-config startup-config
(Optional) Copies the running configuration to the startup configuration.
Verifying the VDC Resource Template Configuration

To display VDC resource template configuration information, perform one of the following tasks:

Command

Purpose

show running-config {vdc | vdc-all}

Displays the VDC information in the running configuration.

show vdc resource template [template-name]

Displays the VDC template configuration.

For detailed information about the fields in the output from this command, see the Cisco Nexus 7000 Series NX-OS Virtual Device Context Command Reference, Release 4.1.

Example VDC Resource Template Configuration

The following example shows how to configure a VDC resource template:
vdc resource template TemplateA
  limit-resource port-channel minimum 4 maximum 128
  limit-resource span-ssn minimum 1 maximum equal-to-min
  limit-resource vlan minimum 32 maximum 1024
  limit-resource vrf minimum 32 maximum 4096
Default Settings

Table 2-3 and Table 2-4 lists the default settings for VDC resource template parameters.

Table 2-3 Default VDC Resource Template Settings For Cisco NX-OS Release 4.0(1) and Release 4.0(1a)

Parameter

Minimum

Maximum

Port channel resource limit

0

256

SPAN session resource limit

0

2

VLAN resource limit

16

4094

VRF resource limit

16

8192

Nondefault VDCs

IPv4 route memory resource limit¹

8

256

IPv6 route memory resource limit¹

4

256

Default VDC

IPv4 route memory resource limit¹

32

256

IPv6 route memory resource limit¹

16

256

¹Route memory limits are in megabytes.

Table 2-4 Default VDC Resource Template Settings For Cisco NX-OS Release 4.0(2) and Later Releases

Parameter

Minimum

Maximum

Port channel resource limit

0

256

SPAN session resource limit

0

2

VLAN resource limit

16

4094

VRF resource limit

16

8192

Nondefault VDCs

IPv4 route memory resource limit¹

8

320

IPv6 route memory resource limit¹

4

192

Default VDC

IPv4 route memory resource limit¹

32

320

IPv6 route memory resource limit¹

16

192

¹Route memory limits are in megabytes.

Additional References

For additional information related to implementing VDCs, see the following sections:

•Related Documents

Related Documents

Related Topic

Document Title

DCNM Licensing

Cisco Nexus 7000 Series NX-OS Licensing Guide, Release 4.1

VDC commands

Cisco Nexus 7000 Series NX-OS Virtual Device Context Command Reference, Release 4.1

Feature History for VDC Resource Templates

Table 2-5 lists the release history for this feature.

Table 2-5 Feature History for VDC Resource Templates

Feature Name

Releases

Feature Information

IPv4 unicast route memory resource

4.0(2)

Changed the default maximum value from 256 to 320.

IPv6 unicast route memory resource

4.0(2)

Changed the default maximum value from 256 to 192.