Preface

Preface

Audience

Document Conventions

Related Documentation

Documentation Feedback

Obtaining Documentation and Submitting a Service Request

Chapter 1. A Commands

access-list

Chapter 2. C Commands

catena

catena device-group

catena port-acl

catena port-group

catena vlan-group

chain

Chapter 3. D Commands

deny

Chapter 4. F Commands

feature catena

Chapter 5. I Commands

interface

Chapter 6. L Commands

load-balance port-channel

Chapter 7. N Commands

node

Chapter 8. P Commands

permit

probe

Chapter 9. Show Commands

show catena

show running-config catena

Chapter 10. V Commands

vlan

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

To provide technical feedback on this document, or to report an error or omission, please send your comments to nexus7k-docfeedback@cisco.com. We appreciate your 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. A Commands

- access-list

access-list

To configure a sequence list when creating a Catena chain, use the access-list command. To remove the configuration, use the no form of this command.

sequence-number access-list acl-name { vlan-group vg-name | ingress-port-group ipg-name } { egress-port-group epg-name | egress-device-group edg-name } [ mode mode ]

no sequence-number

Syntax Description

sequence-number

Sequence number in a chain. The range is from 1 to 4294967295.

acl-name

Access list name. Maximum length is 31 characters.

vlan-group

Specifies the VLAN group.

vg-name

VLAN group name. Maximum length is 31 characters.

ingress-port-group

Specifies the ingress port group.

ipg-name

Ingress port group name. Maximum length is 31 characters.

egress-port-group

Specifies the egress port group.

epg-name

Egress port group name. Maximum length is 31 characters.

egress-device-group

Specifies the egress device group.

edg-name

Egress device group name. Maximum length is 31 characters.

mode

(Optional) Specifies the mode for the received packets.

mode

Mode types. Valid values for the received packets are drop, bypass, or forward.

Command Default

None.

Command Modes

Catena configuration mode (config-catena)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

The Catena solution must be enabled and configured before using this command. You must also configure an access control list, a port group, a device group, a vlan group, and a chain for the Catena instance before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to use the access-list command when creating a Catena chain:

switch# configure terminal
switch(config)# catena ins1
switch(config-catena-instance)# chain 10
switch(config-catena)# 10 access-list acl11 vlan-group vg1 egress-port-group pg1 mode forward

Related Commands

Command

Description

catena

Creates a Catena instance.

catena device-group

Creates a device group.

catena port-group

Creates a port group.

catena vlan-group

Creates a VLAN group.

chain

Creates a chain ID.

Chapter 2. C Commands

- catena

- catena device-group

- catena port-acl

- catena port-group

- catena vlan-group

- chain

catena

To create a Catena instance, use the catena command. To remove the Catena instance, use the no form of this command.

catena instance-name

no catena instance-name

Syntax Description

instance-name

Catena instance name. Maximum length is 31 characters.

Command Default

None.

Command Modes

Configuration mode (config)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to enable a Catena instance:

switch# configure terminal
switch(config)# catena ins1
switch(config-catena-instance)# no shutdown

Related Commands

Command

Description

feature catena

Enables the Catena feature.

show catena

Displays the status and configuration for a specified Catena instance.

show running-config catena

Displays the running Catena configuration.

catena device-group

To create a device group, use the catena device-group command. To remove the device group, use the no form of this command.

catena device-group device-group-name

no catena device-group device-group-name

Syntax Description

device-group-name

Device group name. Maximum length is 31 characters.

Command Default

None.

Command Modes

Configuration mode (config)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to create a device group:

switch# configure terminal
switch(config)# catena device-group s-dg-1

Related Commands

Command

Description

catena port-group

Creates a port group.

catena vlan-group

Creates a VLAN group.

node

Assigns node to a device group.

probe

Configures a device-group probe.

catena port-acl

To create an ACL port, use the catena port-acl command. To remove the ACL port, use the no form of this command.

catena port-acl port-acl-name

no catena port-acl port-acl-name

Syntax Description

port-acl-name

Specifies the name of ACL port. Maximum length is 31 characters.

Command Default

The ACL port is not created by default and the transparent mode cannot be used.

Command Modes

Global configuration (config)

Command History

Release

Modification

Cisco NX-OS 8.2(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to create an ACL port:

switch# configure terminal
switch(config)# catena port-acl pa1

Related Commands

Command

Description

catena device-group

Creates a device group.

catena port-group

Creates a port group.

catena vlan-group

Creates a VLAN group.

deny

Prevents traffic from a source IP address to a destination IP address.

interface

Assigns an interface to a configured port group.

permit

Allows traffic from a source IP address to a destination IP address.

catena port-group

To create a port group, use the catena port-group command. To remove the port group, use the no form of this command.

catena port-group port-group-name

no catena port-group port-group-name

Syntax Description

port-group-name

Port group name. Maximum length is 31 characters.

Command Default

None.

Command Modes

Configuration mode (config)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to create a port group:

switch# configure terminal
switch(config)# catena port-group pg1

Related Commands

Command

Description

catena device-group

Creates a device group.

catena vlan-group

Creates a VLAN group.

interface

Assigns an interface to a configured port group.

catena vlan-group

To create a VLAN group, use the catena vlan-group command. To remove the VLAN group, use the no form of this command.

catena vlan-group vlan-group-name

no catena vlan-group vlan-group-name

Syntax Description

vlan-group-name

VLAN group name. Maximum length is 31 characters.

Command Default

None.

Command Modes

Configuration mode (config)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to create a VLAN group:

switch# configure terminal
switch(config)# catena vlan-group vg1

Related Commands

Command

Description

catena device-group

Creates a device group.

catena port-group

Creates a port group.

vlan

Assigns a VLAN to a configured VLAN group.

chain

To create a chain ID, use the chain command. To remove the chain ID, use the no form of this command.

chain chain-id

no chain chain-id

Syntax Description

chain-id

Chain ID. The range is from 0–2147483647.

Command Default

None.

Command Modes

Catena instance configuration mode (config-catena-instance)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to create a chain ID:

switch# configure terminal
switch(config)# catena ins1
switch(config-catena-instance)# chain 10

Related Commands

Command

Description

access-list

Creates a sequence list.

catena

Creates a Catena instance.

Chapter 3. D Commands

- deny

deny

To prevent traffic from a source IP address to a destination IP address, use the deny command. To remove a deny rule, if any, use the no form of this command.

[sequence-number] deny ip source-address destination-address

no sequence-number

Syntax Description

sequence-number

(Optional) Specifies the sequence number. The range is from 1–4294967295. The default is 10.

Note:
The sequence number is not optional in the no form of the deny command.

source-address

Specifies the source IP address.

destination-address

Specifies the destination IP address.

Command Default

No rule is created on traffic.

Command Modes

ACL port configuration (config-port-acl)

Command History

Release

Modification

Cisco NX-OS 8.2(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these tasks, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

This example shows how to deny traffic from a source IP address to a destination IP address:

switch(config)# catena port-acl pa1
switch(config-port-acl)# 2 deny ip host 0.0.0.0 host 10.0.0.1

Related Commands

Command

Description

catena

Creates a Catena instance.

catena port-acl

Configures an ACL port.

permit

Allows traffic from a source IP address to a destination IP address.

Chapter 4. F Commands

- feature catena

feature catena

To enable the Catena feature, use the feature catena command. To disable this feature, use the no form of this command.

feature catena

no feature catena

Syntax Description

This command has no arguments or keywords.

Command Default

The Catena feature is disabled.

Command Modes

Configuration mode (config)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to enable Catena:

switch# configure terminal
switch(config)# feature catena

Related Commands

Command

Description

show catena

Displays the status and configuration for the specified Catena instance.

show running-config catena

Displays the running Catena configuration.

Chapter 5. I Commands

- interface

interface

To assign an interface to a configured port group, use the interface command. To remove the interface from the port group, use the no form of this command.

interface interface-reference

no interface interface-reference

Syntax Description

interface-reference

Interface reference number.

Command Default

None.

Command Modes

Port group configuration mode (config-port-group)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to assign interfaces to a configured port group:

switch# configure terminal
switch(config)# catena port-group pg1
switch(config-port-group)# interface Eth 2/2
switch(config-port-group)# interface Eth 2/3

Related Commands

Command

Description

catena port-group

Creates a port group.

Chapter 6. L Commands

- load-balance port-channel

load-balance port-channel

To load balance the traffic in a port channel in a port group, use the load-balance port-channel command. To remove the load-balance, use the no form of this command.

load-balance port-channel

no load-balance port-channel

Syntax Description

load-balance

Specifies the Catena load-balance.

port-channel

Specifies the port channel of all interfaces in a port group.

Command Default

The traffic is not load balanced by default.

Command Modes

Port group configuration (config-port-group)

Command History

Release

Modification

Cisco NX-OS 8.2(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to load-balance a port channel in a port group:

switch# configure terminal
switch(config)# catena port-group pg1
switch(config-port-group)# load-balance port-channel

Related Commands

Command

Description

catena device-group

Creates a device group.

catena port-group

Creates a port group.

catena vlan-group

Creates a VLAN group.

interface

Assigns an interface to a configured port group.

Chapter 7. N Commands

- node

node

To assign a node to a configured device group, use the node command. To remove the node from the device group, use the no form of this command.

node { ip ipv4-address | IPv6 ipv6-address }

no node { ip ipv4-address | IPv6 ipv6-address }

Syntax Description

ip ipv4-address

Specifies the IPv4 address-based load or traffic distribution.

IPv6 ipv6-address

Specifies the-IPv6 address-based load or traffic distribution.

Command Default

None.

Command Modes

Device group configuration mode (config-device-group)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to assign a node to a device group:

switch# configure terminal
switch(config)# catena device-group s-dg-1
switch(config-device-group)# node ip 1.1.1.1
switch(config-device-group)# node ip 2.2.2.2

Related Commands

Command

Description

catena device-group

Creates a device group.

Chapter 8. P Commands

- permit

- probe

permit

To allow traffic from a source IP address to a destination IP address, use the permit command. To remove a permit rule, if any, use the no form of this command.

[sequence-number] permit ip source-address destination-address

no sequence-number

Syntax Description

sequence-number

(Optional) Specifies the sequence number. The range is from 1–4294967295. The default is 10.

Note:
The sequence number is not optional in the no form of the permit command.

source-address

Specifies the source IP address.

destination-address

Specifies the destination IP address.

Command Default

No rule is created on traffic.

Command Modes

ACL port configuration (config-port-acl)

Command History

Release

Modification

Cisco NX-OS 8.2(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these tasks, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

This example shows how to permit traffic from a source IP address to a destination IP address:

switch(config)# catena port-acl pa1
switch(config-port-acl)# 2 permit ip 209.165.200.225 10.0.0.1

Related Commands

Command

Description

catena

Creates a Catena instance.

catena port-acl

Configures an ACL port.

deny

Prevents traffic from a source IP address to a destination IP address.

probe

To configure a device-group probe, use the probe command. To remove the configuration, use the no form of this command.

probe probe-id [ control status ] [ host host-name ] [ frequency frequency-number | timeout timeout | retry-down-count down-count | retry-up-count up-count | ip ipv4-address ]

noprobe probe-id [ control status ] [ host host-name ] [ frequency frequency-number | timeout timeout | retry-down-count down-count | retry-up-count up-count | ip ipv4-address ]

Syntax Description

probe-id

Probe ID. You can specify ICMP, TCP, UDP, or DNS as the probe ID.

control status

(Optional) Specifies the control protocol status.

host host-name

(Optional) Specifies the host name.

frequency frequency-number

(Optional) Specifies the time interval, in seconds, between the successive probes sent to the node.

timeout timeout

(Optional) Specifies the amount of time, in seconds, to wait for the probe response.

retry-down-count down-count

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

retry-up-count up-count

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

ip ipv4-address

(Optional) Specifies the IP address-based load or traffic distribution.

Command Default

None.

Command Modes

Device group configuration mode (config-device-group)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to configure a device-group probe:

switch# configure terminal
switch(config)# catena device-group s-dg-1
switch(config-device-group)# node ip 1.1.1.1
switch(config-device-group)# node ip 2.2.2.2
switch(config-device-group)# probe icmp

Related Commands

Command

Description

catena device-group

Creates a device group.

node

Assigns a node to a device group.

Chapter 9. Show Commands

- show catena

- show running-config catena

show catena

To display the status and configuration of a specified Catena instance, use the show catena command.

show catena instance-name brief

Syntax Description

instance-name

Catena instance name. Maximum length is 31 characters.

Command Default

None.

Command Modes

User EXEC (#)
Privileged EXEC (#)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

EXAMPLE The following is sample output from the show catena command, which displays the status and configuration of a specified Catena instance:

switch# show catena ins1 brief
-----------------------------------
Instance name            Status
--------------         ---------
ins1                   ACTIVE
-----------------------------------

chain 10
10            acl1            vg1                pg1    mode forward
20            acl2            vg2                pg2    mode forward
30            acl3            vg3                pg3    mode forward

Related Commands

Command

Description

show running-config catena

Displays the running Catena configuration.

show running-config catena

To display the running Catena configuration, use the show running-config catena command.

show running-config catena

Syntax Description

This command has no arguments or keywords.

Command Default

None.

Command Modes

User EXEC (#)
Privileged EXEC (#)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

EXAMPLE The following is sample output from the show running-config catena command, which displays the running Catena configuration in transparent mode:

switch# show running-config catena

catena vlan-group vg1
vlan 10

catena vlan-group vg2
vlan 20

catena vlan-group vg3
vlan 30

catena port-group pg1
interface Eth9/1

catena port-group pg2
interface Eth9/2

catena port-group pg3
interface Eth9/3

catena ins1
chain 10
10 access-list acl11 vlan-group vg1 egress-port-group pg1 mode forward
20 access-list acl12 vlan-group vg2 egress-port-group pg2 mode forward
30 access-list acl13 vlan-group vg3 egress-port-group pg3 mode forward

no shutdown

EXAMPLE The following is sample output from the show running-config catena command, which displays the running Catena configuration in routed mode:

switch# show running-config catena

catena device-group s-dg-1
node ip 1.1.1.1
probe icmp

catena device-group s-dg-2
node ip 2.1.1.1
probe icmp

catena port-group pg1
interface Eth9/1

catena port-group pg2
interface Eth9/2

catena port-group pg3
interface Eth9/3

catena ins2
chain 20
30 access-list acl11 ingress-port-group pg1 egress-device-group s-dg-1 mode forward
40 access-list acl12 ingress-port-group pg2 egress-device-group s-dg-2 mode forward

no shutdown

Related Commands

Command

Description

show catena

Displays the status and configuration for the specified Catena instance.

Chapter 10. V Commands

- vlan

vlan

To assign a VLAN to a configured VLAN group, use the vlan command. To remove the VLAN from the VLAN group, use the no form of this command.

verify vlan-range

Syntax Description

vlan-range

Specifies the VLAN range. The range is from 1 to 3967.

Command Default

None.

Command Modes

VLAN group configuration mode (config-vlan-group)

Command History

Release

Modification

Cisco NX-OS 8.0(1)

This command was introduced.

Usage Guidelines

Catena must be enabled and configured before using this command. For more information about these task, see "Cisco Nexus 7000 Series Switches Configuration Guide: The Catena Solution."

Examples

The following example shows how to assign a VLAN to a VLAN group:

switch# configure terminal
switch(config)# catena vlan-group vg1
switch(config-vlan-group)# vlan 10
switch(config-vlan-group)# vlan 20-30
switch(config-vlan-group)# vlan 40,50

Related Commands

Command

Description

catena vlan-group

Creates a VLAN group.