Preface

Preface

Audience

Document Conventions

Related Documentation

Documentation Feedback

Obtaining Documentation and Submitting a Service Request

Chapter 1. D Commands

device-group

Chapter 2. F Commands

failaction

feature itd

Chapter 3. I Commands

ingress interface

itd

itd device-group

itd statistics

Chapter 4. L Commands

load-balance

Chapter 5. N Commands

node ip

node ipv6

Chapter 6. P Commands

probe

Chapter 7. S Commands

show itd

show itd statistics

shutdown (ITD)

Chapter 8. V Commands

virtual ip

virtual ipv6

vrf

Preface

- Preface

Preface

This preface describes the audience, organization, and conventions of the Book Title. It also provides information on how to obtain related documentation.

This chapter includes the following topics:

- Audience

- Document Conventions

- Related Documentation

- Documentation Feedback

- Obtaining Documentation and Submitting a Service Request

Audience

This publication is for experienced network administrators who configure and maintain Cisco NX-OS on Cisco Nexus 7000 Series Platform switches.

Document Conventions

Note

- As part of our constant endeavor to remodel our documents to meet our customers' requirements, we have modified the manner in which we document configuration tasks. As a result of this, you may find a deviation in the style used to describe these tasks, with the newly included sections of the document following the new format.

- The Guidelines and Limitations section contains general guidelines and limitations that are applicable to all the features, and the feature-specific guidelines and limitations that are applicable only to the corresponding feature.

Command descriptions use the following conventions:

Convention

Description

bold

Bold text indicates the commands and keywords that you enter literally as shown.

Italic

Italic text indicates arguments for which the user supplies the values.

[x]

Square brackets enclose an optional element (keyword or argument).

[x | y]

Square brackets enclosing keywords or arguments separated by a vertical bar indicate an optional choice.

{x | y}

Braces enclosing keywords or arguments separated by a vertical bar indicate a required choice.

[x {y | z}]

Nested set of square brackets or braces indicate optional or required choices within optional or required elements. Braces and a vertical bar within square brackets indicate a required choice within an optional element.

variable

Indicates a variable for which you supply values, in context where italics cannot be used.

string

A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

Examples use the following conventions:

Convention

Description

screen font

Terminal sessions and information the switch displays are in screen font.

boldface screen font

Information you must enter is in boldface screen font.

italic screen font

Arguments for which you supply values are in italic screen font.

< >

Nonprinting characters, such as passwords, are in angle brackets.

[ ]

Default responses to system prompts are in square brackets.

!, #

An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.

This document uses the following conventions:

Note

Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual.

Caution

Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Related Documentation

Documentation for Cisco Nexus 7000 Series Switches is available at:

- Configuration Guides

Click Here

- Command Reference Guides

Click Here

- Release Notes

Click Here

- Install and Upgrade Guides

Click Here

- Licensing Guide

Click Here

Documentation for Cisco Nexus 7000 Series Switches and Cisco Nexus 2000 Series Fabric Extenders is available at the following URL:

Click Here

Documentation Feedback

Obtaining Documentation and Submitting a Service Request

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.

To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What's New in Cisco Product Documentation RSS feed. RSS feeds are a free service.

Chapter 1. D Commands

- device-group

device-group

To add an existing device group to an Intelligent Traffic Director (ITD) service, use the device-group command. To remove the device group, use the no form of this command.

device-group device-group-name

no device-group device-group-name

Syntax Description

device-group-name

Name of the device group. You can enter up to 32 alphanumeric characters.

Command Default

None.

Command Modes

Device group configuration (config-device-group)

Command History

Release

Modification

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

Use the device-group command to add an existing device group to the ITD service. You can configure the device group using the itd device-group command.

Note

An ITD device group can have either IPv4 or IPv6 nodes, but not both.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to add a device group to an ITD:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# probe icmp
switch(config-device-group)# exit

switch(config)# itd test
switch(config-itd)# device-group dg

Related Commands

Command

Description

device-group

Creates an ITD device group.

feature itd

Enables the ITD service on the switch.

itd

Configures an ITD service.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.

probe

Configures the cluster group service probe for ITD.

Chapter 2. F Commands

- failaction

- feature itd

failaction

To enable traffic to be reassigned to an active Intelligent Traffic Director (ITD) node, use the failaction command. To disable the node reassignment, use the no form of this command.

failaction node reassign

no failaction node reassign

Syntax Description

This command has no arguments or keywords.

Command Default

None.

Command Modes

ITD configuration (config-itd)

Command History

Release

Modification

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

The failaction command enables traffic on failed nodes to be reassigned to the first available active node. Once the failed node comes back, it automatically resumes serving the connections.

Note

An ITD probe must be configured prior to using the failaction command.

Note

Only a device group with IPv4 nodes is supported with the failaction command.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to enable the reassignment of failed ITD nodes:

switch(config)# feature itd
switch(config)# itd test
switch(config-itd)# failaction node reassign

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

itd

Configures an ITD service.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.

probe

Configures the cluster group service probe for ITD.

feature itd

To enable the Intelligent Traffic Director (ITD) feature, use the feature itd command. To disable the ITD feature, use the no form of this command.

feature itd

no feature itd

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled.

Command Modes

Global configuration

Command History

Release

Modified

6.2(8)

This command was introduced.

Usage Guidelines

You must enable the ITD feature before you can configure ITD. When the ITD feature is disabled with the no command, all relevant configurations are removed.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to enable and verify the ITD feature:

switch# conf t
switch(config)# feature itd
switch# show feature | grep itd
itd                  1         enabled

Related Commands

Command

Description

show feature

Displays enabled and disabled features.

show itd

Displays ITD configuration information.

Chapter 3. I Commands

- ingress interface

- itd

- itd device-group

- itd statistics

ingress interface

To add an ingress interface or multiple interfaces to an Intelligent Traffic Director (ITD) service, use the ingress interface command. To remove the interface or interfaces, use the no form of this command.

ingress interface interface

no ingress interface interface

Syntax Description

interface

Ingress interface. You can enter a single interface, multiple interfaces, or a range of interfaces (see the usage guidelines section).

Command Default

None.

Command Modes

ITD configuration (config-itd)

Command History

Release

Modification

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

You can enter a single interface, multiple interfaces, or a range of interfaces using the ingress interface command:

- Use a comma (“,”) to separate multiple interfaces:

switch(config-itd)# ingress interface Ethernet 4/1, Ethernet 4/

- Use a hyphen (“-”) to separate a range of interfaces:

switch(config-itd)# ingress interface Ethernet 4/1-10
switch(config-itd)# ingress interface vlan 1-100

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to configure multiple ingress interfaces for the ITD service:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# probe icmp
switch(config-device-group)# exit
switch(config)# itd test
switch(config-itd)# device-group dg
switch(config-itd)# ingress interface Ethernet 4/1, Ethernet 4/2

This example shows how to configure a range of ingress interfaces for the ITD service:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# probe icmp
switch(config-device-group)# exit
switch(config)# itd test
switch(config-itd)# device-group dg
switch(config-itd)# ingress interface Ethernet 4/1-10

Related Commands

Command

Description

device-group

Adds an existing device group to an ITD service

feature itd

Enables the ITD service on the switch.

itd device-group

Creates an ITD device group.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.

itd

To configure an Intelligent Traffic Director (ITD) service and to enter into ITD configuration mode, use the itd command. To remove the ITD service, use the no form of this command.

itd service-name

no itd service-name

Syntax Description

service-name

Name of the ITD service. You can enter up to 32 alphanumeric characters.

Command Default

Disabled.

Command Modes

Global configuration

Command History

Release

Modified

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to configure an ITD service and to enter into ITD configuration mode:

switch(config)# feature itd
switch(config)# itd test
switch(config-itd)

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

show itd

Displays ITD configuration information.

itd device-group

To create an Intelligent Traffic Director (ITD) device group and enter device group configuration mode, use the itd device-group command. To remove the ITD device group, use the no form of this command.

itd device-group name

no itd device-group name

Syntax Description

name

Name of the ITD device group. You can enter up to 32 alphanumeric characters.

Command Default

Disabled.

Command Modes

Global configuration

Command History

Release

Modified

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to create a device group and enter into device group configuration mode:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)#

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

itd statistics

To enable the collection of statistics for the Intelligent Traffic Director (ITD) service, use the itd statistics command. To disable the collection of statistics, use the no form of this command.

itd statistics service-name

no itd statistics service-name

Syntax Description

service-name

Name of the ITD service.

Command Default

Disabled.

Command Modes

Global configuration

Command History

Release

Modified

6.2(10)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to create a device group and enter into device group configuration mode:

switch(config)# feature itd
switch(config)# itd statistics test

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

show itd statistics

Displays the statistics for the ITD service.

Chapter 4. L Commands

- load-balance

load-balance

To configure the buckets, mask position, and/or the load-balancing method of an Intelligent Traffic Director (ITD) service, use the load-balance command. To remove the configuration, use the no form of this command.

load-balance { method { src { ip | ip-l4port [ tcp | udp ] range x y } | dst { ip | ip-l4port [ tcp | udp ] range x y } } | buckets bucket-number | mask-position position }

no load-balance { method { src { ip | ip-l4port [ tcp | udp ] range x y } | dst { ip | ip-l4port [ tcp | udp ] range x y } } | buckets bucket-number | mask-position position }

method

Specifies the method of load/traffic distribution.

src

Specifies the source based load/traffic distribution.

ip

Specifies IP address based load/traffic distribution.

ip-l4port

Specifies IP address and Layer 4 port-based load/traffic distribution.

tcp

Specifies the TCP protocol.

udp

Specifies the UDP protocol.

range x y

Specifies the port range. The x and y values are non-overlapping values in the range 0-65535.

dst

Specifies the destination based load/traffic distribution.

buckets bucket-number

Specifies the number of buckets to create. The range is from 2 to 256, in powers of 2.

mask-position position

Specifies the mask position number. The range is from 0 to 31.

Command Default

None.

Command Modes

ITD configuration (config-itd)

Command History

Release

Modification

6.2(10)

The following keywords and arguments were added: ip-l4port, tcp, udp, range x y.

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

The options for the load-balance command are as follows:

- buckets—Specifies the number of buckets to create. Buckets must be configured in powers of two. One or more buckets are mapped to a node in the cluster.

If you configure more buckets than the number of nodes, the buckets are applied in a round-robin fashion across all the nodes.

- mask-position—Specifies the mask position of the load balancing. This command is useful when a packet classification has to be made based on specific octets or bit of an IP addresses. By default, the system uses the last octet/least significant bit (LSB) for bucketing. If you prefer to use nondefault bits/octets, you can use the mask-position keyword to provide the starting point at which the traffic classification is to be made. For example, the starting point is at the 8th bit for the second octet and the 16th bit for the third octet of an IP address.

- method—Specifies one of the following:

- source IP address.

- destination IP address.

- source IP address and source L4 port.

- destination IP address and destination L4 port.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to configure load balancing for ITD:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# probe icmp
switch(config-device-group)# exit
switch(config)# itd test
switch(config-itd)# device-group dg
switch(config-itd)# ingress interface Ethernet 4/1-10
switch(config-itd)# load-balance method dst ip-l4port range 10 20

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

ingress-interface

Adds an ingress interface or multiple interfaces to an ITD service.

itd

Configures an ITD service.

itd device-group

Creates an ITD device group.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.

probe

Configures the cluster group service probe for ITD.

Chapter 5. N Commands

- node ip

- node ipv6

node ip

To create an IPv4 cluster node for Intelligent Traffic Director (ITD), use the node ip command. To remove the cluster node, use the no form of this command.

node ip ipv4-address [ mode hot-standby ] [ standby ipv4-address ] [ weight value ]

no node ip ipv4-address [ mode hot-standby ] [ standby ipv4-address ] [ weight value ]

Syntax Description

ipv4-address

IPv4 address for the node.

mode hot-standby

(Optional) Specifies that the node is a standby node for any active node member of the device group.

standbyipv4-address

(Optional) Specifies that the node is a standby for the active node.

weight value

(Optional) Specifies proportionate weight for the node for weighted traffic distribution.

Command Default

None.

Command Modes

Device group configuration (config-device-group)

Command History

Release

Modification

6.2(10)

The following keywords and arguments were added: standby ipv4-address and weight value.

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

The node ip ip-address mode hot-standby command allows you to specify that a particular node is the standby node if a failure occurs. ITD redirects traffic away from the failed node to the newly active (standby) node. When the failed node becomes operational again, it is reinstated as an active node and traffic from the standby node is redirected back to the original node. The standby node reenters the pool of standby nodes.

The node ip ipv4-address standby ipv4-address command allows you to specify that a particular node is the standby node for the active node with which it is associated.

Note

An ITD device group can have either IPv4 or IPv6 nodes, but not both.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to configure IPv4 nodes for ITD:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.2
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4 weight 2
switch(config-device-group)# node ip 20.20.20.5 mode hot standby
switch(config-device-group)# node ip 20.20.20.6 standby 20.20.20.7

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

itd device-group

Creates an ITD device group.

node ipv6

Creates an IPv6 cluster node for ITD.

node ipv6

To create an IPv6 cluster node for Intelligent Traffic Director (ITD), use the node ipv6 command. To remove the cluster node, use the no form of this command.

node ipv6 ipv6-address [ mode hot-standby ] [ standby ipv6-address ] [ weight value ]

no node ipv6 ipv6-address [ mode hot-standby ] [ standby ipv6-address ] [ weight value ]

Syntax Description

ipv6-address

IPv6 address for the node in the format A:B::C:D.

mode hot-standby

(Optional) Specifies that the node is a standby node.

standbyipv6-address

(Optional) Specifies that the node is a standby for the active node.

weight value

(Optional) Specifies proportionate weight for the node for weighted traffic distribution.

Command Default

None.

Command Modes

Device group configuration (config-device-group)

network-adminvdc-admin

Command History

Release

Modification

6.2(10)

The following keywords and arguments were added: standby ipv6-address and weight value.

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

The node ipv6 ipv6-address mode hot-standby command allows you to specify that a particular node is the standby node if a failure occurs. ITD redirects traffic away from the failed node to the newly active (standby) node. When the failed node becomes operational again, it is reinstated as an active node and traffic from the standby node is redirected back to the original node. The standby node reenters the pool of standby nodes.

The node ipv6 ipv6-address standby ipv6-address command allows you to specify that a particular node is the standby node for the active node with which it is associated.

Note

An ITD device group can have either IPv4 or IPv6 nodes, but not both.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to configure IPv6 nodes for ITD:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ipv6 ffff:eeee::dddd:eeee fefe:efef::dcdc:cccc

This example shows how to configure weighted load balancing on the IPv6 nodes for ITD:

switch(config)# feature itd
switch(config)# itd device-group dg-v6

switch(config-device-group)# node ipv6 ffff:eeee::dddd:eeee fefe:efef::dcdc:cccc weight 2

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

itd device-group

Creates an ITD device group.

node ip

Creates an IPv4 cluster node for ITD.

Chapter 6. P Commands

- probe

probe

To configure the cluster group service probe for Intelligent Traffic Director (ITD), use the probe command. To remove the service probe, use the no form of this command.

probe { icmp | tcp port port-number | udp port port-number } [ dns name-server ipv4-address ] [ frequency seconds ] [ retry-up-count number ] [ retry-down-count number ] [ timeout seconds ]

no probe { icmp | tcp port port-number | udp port port-number } [ dns name-server ipv4-address ] [ frequency seconds ] [ retry-up-count number ] [ retry-down-count number ] [ timeout seconds ]

Syntax Description

icmp

Specifies the Internet Control Message Protocol (ICMP) as the probe for the device group.

tcp

Specifies the Transmission Control Protocol (TCP) as the probe for the device group.

port port-number

Specifies the port number of the protocol.

udp

Specifies the User Datagram Protocol (UDP) as the probe for the device group.

dns name-serveripv4-address

(Optional) Specifies the DNS query as the probe.

frequency seconds

(Optional) Specifies the frequency of the probe in seconds. The range is from 1 to 604800.

retry-up-count number

(Optional) Specifies the consecutive number of times the probe must have succeeded prior to the node being marked UP.

retry-down-count number

(Optional) Specifies the consecutive number of times the probe must have failed prior to the node being marked DOWN.

timeout seconds

(Optional) Length of the timeout period in seconds. The range is from 1 to 604800.

Command Default

None.

Command Modes

Device group configuration (config-device-group)

network-adminvdc-admin

Command History

Release

Modification

6.2(10)

The following keywords and arguments were added: dns name-server ipv4-address.

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

You can use the service probe to periodically monitor the node health. The ITD feature supports PING, TCP, and UDP probes. The connected appliance must support PING, TCP, or UDP probes and should be configured to respond to probes that are initiated by ITD.

ITD probes all cluster group nodes including the nodes that are configured as hot standby.

Note

Probes are not supported for a device group with IPv6 nodes.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to configure an ICMP probe:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# probe icmp

Related Commands

Command

Description

failaction

Enables traffic to be reassigned, following node failure.

feature itd

Enables the ITD service on the switch.

itd device-group

Creates an ITD device group.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.

Chapter 7. S Commands

- show itd

- show itd statistics

- shutdown (ITD)

show itd

To display the status and configuration for all or specified Intelligent Traffic Director (ITD) services, use the show itd command.

show itd [itd-name] [brief]

Syntax Description

itd-name

(Optional) Name of the ITD service. You can enter up to 32 alphanumeric characters.

brief

(Optional) Displays a summary of the ITD service information.

Command Default

None.

Command Modes

User EXEC

Privileged EXEC

Command History

Release

Modification

6.2(10)

The command output was modified.

6.2(8)

This command was introduced.

Usage Guidelines

The show itd command displays the status and configuration for all ITD service instances on the device.

The show itd itd-name command allows you to display information for the specific ITD service instance.

The brief keyword allows you to display summarized information.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to display information about all the ITD service instances on the device:

switch(config)# show itd
Name              Probe     LB Scheme   Status     Buckets
--------------    -----     ----------  --------   -------
WEB               ICMP      src-ip      ACTIVE     2
Device Group                                       VRF-Name
-------------------------------------------------- -------------
WEB-SERVERS
Pool                           Interface    Status Track_id
------------------------------ ------------ ------ ---------
WEB_itd_pool                   Po-1         UP      3
Virtual IP                             Netmask/Prefix  Protocol     Port
------------------------------------------------------ ------------ ----------
210.10.10.100 / 255.255.255.255                        IP            0
Node IP                   Config-State Weight Status     Track_id  Sla_id
------------------------- ------------ ------ ---------- --------- ---------
1    210.10.10.11         Active        1     OK          1        10001
Bucket List
-----------------------------------------------------------------------
WEB_itd_vip_1_bucket_1
Node IP                   Config-State Weight Status     Track_id  Sla_id
------------------------- ------------ ------ ---------- --------- ---------
2    210.10.10.12         Active        1     OK          2        10002
Bucket List
-----------------------------------------------------------------------
WEB_itd_vip_1_bucket_2

This example shows how to display summarized information about the ITD service:

switch(config)# show itd brief
Name              Probe   LB Scheme     Interface     Status    Buckets
--------------    -----   ----------    ----------    --------  --------
WEB               ICMP     src-ip       Eth3/3        ACTIVE     2
Device Group                                       VRF-Name
-------------------------------------------------- -------------
WEB-SERVERS
Virtual IP                             Netmask/Prefix  Protocol     Port
------------------------------------------------------ ------------ ----------
210.10.10.100 / 255.255.255.255                        IP           0
Node IP                   Config-State Weight Status     Track_id  Sla_id
------------------------- ------------ ------ ---------- --------- ---------
1    210.10.10.11         Active        1     OK          1          10001
2    210.10.10.12         Active        1     OK          2          10002

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

show itd statistics

Displays the statistics for ITD services.

show itd statistics

To display the statistics for the Intelligent Traffic Director (ITD) service, use the show itd statistics command.

show itd [ itd-name | all ] [ { src | dst } ip-address ] statistics [brief]

Syntax Description

itd-name

(Optional) Name of the ITD service. You can enter up to 32 alphanumeric characters.

all

(Optional) Displays all ITD statistics.

src

(Optional) Displays the ITD statistics for the source IP address.

dst

(Optional) Displays the ITD statistics for the destination IP address.

ip-address

(Optional) IPv4 or IPv6 address.

brief

(Optional) Displays a summary of the ITD service information.

Command Default

None.

Command Modes

EXEC

Privileged EXEC

Command History

Release

Modification

6.2(10)

The following keywords and arguments were added: all, src, dst, ip-address.

6.2(8)

This command was introduced.

Usage Guidelines

The show itd statistics command displays the statistics for all the ITD service instances on the device.

The show itd statistics itd-name command allows you to display the statistics for the specific ITD service instance.

The brief keyword allows you to display summarized information.

Before using the show itd statistics command, you must enable statistics by using the itd statistics service-name command:

switch(config)# itd statistics svc-name
switch(config)# show itd statistics

To clear the statistics use the no itd statistics service-name.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to display the traffic information for the ITD service:

switch(config)# show itd test statistics
Service        Device Group             VIP/mask               #Packets
-----------------------------------------------------------------------
test            dev              9.9.9.10 / 255.255.255.0         114611  (100.00%)
Traffic Bucket        Assigned to      Mode       Original Node   #Packets
-----------------------------------------------------------------------
test_itd_vip_0_acl_0  10.10.10.9       Redirect    10.10.10.9      57106  (49.83%)
Traffic Bucket        Assigned to      Mode       Original Node   #Packets
-----------------------------------------------------------------------
test_itd_vip_0_acl_1  12.12.12.9       Redirect    12.12.12.9      57505  (50.17%)

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

itd statistics

Enables the generation of statistics for the ITD service.

show itd

Displays the status and configuration for all or specified ITD services.

shutdown (ITD)

To shut down an instance of the Intelligent Traffic Director (ITD) in order to modify the parameters, use the shutdown command. To disable this function, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled.

Command Modes

ITD configuration (config-itd)

network-adminvdc-admin

Command History

Release

Modification

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

Before modifying service parameters or device-group parameters, you must execute the shutdown command. Once the required parameters are modified, you should issue the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to shut down the ITD service:

switch(config)# itd test
switch(config-itd)# shutdown

Related Commands

Command

Description

feature itd

Enables the ITD service on the switch.

Chapter 8. V Commands

- virtual ip

- virtual ipv6

- vrf

virtual ip

To configure the virtual IPv4 address of an Intelligent Traffic Director (ITD) service, use the virtual ip command. To remove the virtual IPv4 address, use the no form of this command.

virtual ip ipv4-address ipv4-network-mask [ tcp | udp { port-number | any } ] [ advertise { enable | disable } ]

no virtual ip ipv4-address ipv4-network-mask [ tcp | udp { port-number | any } ] [ advertise { enable | disable } ]

Syntax Description

ipv4-address

Virtual IPv4 address, in A.B.C.D format.

ipv4-network-mask

Virtual IP network mask, in m.m.m.m format.

tcp

(Optional) Allows the virtual IP address to accept flows from Transmission Control Protocol (TCP) connections only.

udp

(Optional) Allows the virtual IP address to accept flows from User Datagram Protocol (UDP) connections only.

port-number

Port number of the protocol. The range is from 0 to 65535.

any

Allows the virtual IPv4 address to accept flows destined to any port.

advertise enable

(Optional) Specifies that the virtual IP route is advertised to neighboring devices.

advertise disable

(Optional) Specifies that the virtual IP route is not advertised to neighboring devices.

Command Default

None.

Command Modes

ITD configuration (config-itd)

network-adminvdc-admin

Command History

Release

Modification

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

A virtual IP address (VIP) is an IP address assigned to multiple servers that are part of a device group, rather than being assigned to a specific single server or network interface card. Incoming data packets that are sent to the VIP address, are routed to actual servers from the Cisco Nexus 7000 Series device. Single or multiple VIPs can be configured as part of an ITD service. You can also specify a wildcard mask for a VIP address.

Note

The VIP has to be in a different subnet than the server IP.

The virtual ip ip-address ip-network-mask advertise enable command creates a route on the device that is advertised to neighboring routers. Those routers forward packets that are destined to the VIP to the ingress interface on the Cisco Nexus 7000 Series device.

In some instances, it is not feasible to configure all the VIP TCP or UDP port numbers. You can use the any keyword to allow the VIP to accept flows destined to any port.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

These examples show how to configure a VIP:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# probe icmp
switch(config-device-group)# exit
switch(config)# itd test1
switch(config-itd)# device-group dg
switch(config-itd)# ingress interface Ethernet 4/1-10
switch(config-itd)# virtual ip 4.4.4.4 255.255.0.0 tcp any advertise enable

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 1.1.1.1
switch(config-device-group)# node ip 1.1.1.2
switch(config-device-group)# node ip 1.1.1.3
switch(config-device-group)# node ip 1.1.1.4
switch(config-device-group)# exit

switch(config)# itd test2
switch(config-itd)# device-group dg
switch(config-itd)# virtual ip 11.22.33.44 255.255.255.255 tcp any
switch(config-itd)# virtual ip 11.22.33.55 255.255.0.0
switch(config-itd)# ingress interface Eth4/15
switch(config-itd)# no shutdown

Related Commands

Command

Description

device-group

Adds an existing device group to an ITD service.

feature itd

Enables the ITD service on the switch.

ingress-interface

Adds an ingress interface or multiple interfaces to an ITD service.

itd

Configures an ITD service.

itd device-group

Creates an ITD device group.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.

probe

Configures the cluster group service probe for ITD.

virtual ipv6

Configures the virtual IPv6 address of an ITD service.

virtual ipv6

To configure the virtual IPv6 address of an Intelligent Traffic Director (ITD) service, use the virtual ipv6 command. To remove the virtual IPv6 address, use the no form of this command.

virtual ipv6 ipv6-address { ipv6-network-mask | ipv6-prefix/length } [ ip | tcp { port-number | any } | udp { port-number | any } ] [ advertise { enable | disable } ]

no virtual ipv6 ipv6-address { ipv6-network-mask | ipv6-prefix/length } [ ip | tcp { port-number | any } | udp { port-number | any } ] [ advertise { enable | disable } ]

Syntax Description

ipv6-address

Virtual IPv6 address, in A:B::C:D format.

ipv6-network-mask

Virtual IPv6 network mask, in A:B::C:D format.

ipv6-prefix/length

IPv6 prefix length. The range is from 0 to 128.

ip

(Optional) Performs load balancing for IP connections only.

tcp

(Optional) Allows the virtual IPv6 address to accept flows from the Transmission Control Protocol (TCP) connections only.

port-number

Port number of the protocol. The range is 0-65535.

udp

(Optional) Allows the virtual IPv6 address to accept flows from the User Datagram Protocol (UDP) connections only.

any

Allows the virtual IPv6 address to accept flows destined to any port.

advertise enable

(Optional) Specifies that the virtual IPv6 route is advertised to neighboring devices.

advertise disable

(Optional) Specifies that the virtual IPv6 route is not advertised to neighboring devices.

Command Default

None.

Command Modes

ITD configuration (config-itd)

network-adminvdc-admin

Command History

Release

Modification

6.2(8)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

A virtual IP address (VIP) is an IP address assigned to multiple servers that are part of a device group, rather than being assigned to a specific single server or network interface card. Incoming data packets that are sent to the VIP address, are routed to actual servers from the Cisco Nexus 7000 Series device. Single or multiple VIPs can be configured as part of an ITD service.

Note

The VIP has to be in a different subnet than the server IP.

The virtual ipv6 ipv6-address advertise enable command creates a route on the device that is advertised to neighboring routers. Those routers forward packets that are destined to the VIP to the ingress interface on the Cisco Nexus 7000 Series device.

In some instances, it is not feasible to configure all the VIP TCP or UDP port numbers. You can use the any keyword to allow the VIP to accept flows destined to any port.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

These examples show how to configure a virtual IPv6 address:

switch(config)# feature itd
switch(config)# itd device-group dgv6
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# exit
switch(config)# itd test1
switch(config-itd)# device-group dg
switch(config-itd)# ingress interface Ethernet 4/1-10
switch(config-itd)# virtual ipv6 ffff:eeee::cccc:eeee dddd:efef::fefe:dddd tcp 10 advertise enable
switch(config-itd)# no shutdown

switch(config)# feature itd
switch(config)# itd device-group dgv6
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# exit

switch(config)# itd test2
switch(config-itd)# device-group dg
switch(config-itd)# virtual ipv6 11:22::33/64 tcp any
switch(config-itd)# virtual ipv6 11:22::44 ffff:ffff::ff tcp any
switch(config-itd)# ingress interface Eth4/14
switch(config-itd)# no shutdown

Related Commands

Command

Description

device-group

Adds an existing device group to an ITD service.

feature itd

Enables the ITD service on the switch.

ingress-interface

Adds an ingress interface or multiple interfaces to an ITD service.

itd

Configures an ITD service.

itd device-group

Creates an ITD device group.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.

probe

Configures the cluster group service probe for ITD.

virtual ip

Configures the virtual IPv4 address of an ITD service.

vrf

To specify a Virtual Routing and Forwarding (VRF) for an Intelligent Traffic Director (ITD) service, use the vrf command. To unspecify the VRF, use the no form of this command.

vrf vrf-name

no vrf vrf-name

Syntax Description

vrf-name

The VRF instance for the ITD service.

Command Default

None.

Command Modes

ITD configuration (config-itd)

network-adminvdc-admin

Command History

Release

Modification

6.2(10)

This command was introduced.

Usage Guidelines

You must ensure that ITD is enabled before you enter this command. You can enter the feature itd global configuration mode command to enable ITD.

All ingress interfaces and device-group nodes must belong to the VRF specified.

Note

Before modifying the service parameters or device-group parameters, you must enter the shutdown command. Once the required parameters are modified, you should enter the no shutdown command on the service.

This command requires the Enhanced Layer 2 Package license.

Examples

This example shows how to configure a VRF for the ITD service:

switch(config)# feature itd
switch(config)# itd device-group dg
switch(config-device-group)# node ip 20.20.20.3
switch(config-device-group)# node ip 20.20.20.4
switch(config-device-group)# node ip 20.20.20.5
switch(config-device-group)# probe icmp
switch(config-device-group)# exit

switch(config)# itd test
switch(config-itd)# device-group dg
switch(config-itd)# ingress interface Ethernet 4/1, Ethernet 4/2
switch(config-itd)# vrf RED

Related Commands

Command

Description

device-group

Adds an existing device group to an ITD service

feature itd

Enables the ITD service on the switch.

itd device-group

Creates an ITD device group.

ingress interface

Adds an ingress interface or multiple interfaces to an ITD service.

node ip

Creates an IPv4 cluster node for ITD.

node ipv6

Creates an IPv6 cluster node for ITD.