The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes the Cisco Nexus 1000V commands that begin with the letter C.
To set VXLAN capability for the port profile so that the port inheriting this port profile carries VXLAN traffic, use the capability vxlan command. To remove the VXLAN capability for the port profile, use the no form of this command.
Port profile configuration (config-port-prof)
|
|
This example shows how to set the VXLAN capability for the port profile:
n1000v(
config)#
capability vxlan
This example shows how to remove the VXLAN capability for the port profile:
n1000v(
config)#
no capability vxlan
|
|
---|---|
To change to a different directory from the one you are currently working in, use the cd command.
cd [ filesystem: [ //directory ] | directory ]
(Optional) File system name. Valid file systems are bootflash and volatile. |
|
(Optional) Directory name. The directory name is case-sensitive and can be up to 28 characters. |
|
|
You can only change to the directories that are on the active supervisor module.
Use the present working directory (pwd) command to verify the name of the directory that you are currently working in.
This example shows how to change to a different directory on the current file system:
This example shows how to change from the file system that you are currently working in to a different file system:
This example shows how to revert back to the default directory, bootflash:
|
|
---|---|
Displays the name of the directory that you are currently working in. |
To specify the Cisco Discovery Protocol version to advertise, use the cdp advertise command. To remove the cdp advertise configuration, use the no form of this command.
|
|
This example shows how to set Cisco Discovery Protocol Version 1 as the version to advertise:
n1000v(
config)#
cdp advertise v1
This example shows how to remove Cisco Discovery Protocol Version 1 as the configuration to advertise:
n1000v(
config)#
no cdp advertise v1
|
|
---|---|
To enable the Cisco Discovery Protocol globally on all interfaces and port channels, use the cdp enable command. To disable CDP globally, use the no form of this command.
|
|
Cisco Discovery Protocol can only be configured on physical interfaces and port channels.
This example shows how to enable Cisco Discovery Protocol globally and then display the Cisco Discovery Protocol configuration:
This example shows how to disable Cisco Discovery Protocol globally and then display the Cisco Discovery Protocol configuration:
n1000v(
config)#
no cdp enable
|
|
---|---|
Enables the Cisco Discovery Protocol on an interface or port channel. |
|
To enable the Cisco Discovery Protocol on an interface or port channel, use the cdp enable command. To disable it, use the no form of this command.
Interface configuration (config-if)
|
|
Cisco Discovery Protocol can only be configured on physical interfaces and port channels.
This example shows how to enable the Cisco Discovery Protocol on port channel 2:
This example shows how to disable the Cisco Discovery Protocol on mgmt0:
To specify the device ID format for the Cisco Discovery Protocol, use the cdp format device-id command. To remove it, use the no form of this command.
cdp format device-id { mac-address | serial-number | system-name }
no cdp format device-id { mac-address | serial-number | system-name }
Specifies the MAC address of a chassis in one of the following formats. |
|
Specifies the system name/fully qualified domain name (default). |
|
|
Cisco Discovery Protocol must be enabled globally before you configure the device ID format.
You can configure the Cisco Discovery Protocol on physical interfaces and port channels only.
This example shows how to configure the Cisco Discovery Protocol device ID with the MAC address format and then display the configuration:
n1000v(
config)#
cdp format device-id mac-address
n1000v
(config)# show cdp global
This example shows how to remove the Cisco Discovery Protocol device ID MAC address format from the configuration:
n1000v(
config)#
no cdp format device-id mac-address
To do set the maximum amount of time that the Cisco Discovery Protocol holds onto neighbor information before discarding it, use the cdp holdtime command. To remove the Cisco Discovery Protocol holdtime configuration, use the no form of this command.
Time that the Cisco Discovery Protocol holds on to neighbor information. The range is from 10 to 255 seconds. |
|
|
Cisco Discovery Protocol must be enabled globally before you configure the device ID format.
You can configure the Cisco Discovery Protocol on physical interfaces and port channels only.
This example shows how to set the Cisco Discovery Protocol holdtime to 10 second:
n1000v(
config)#
cdp holdtime 10
This example shows how to remove the Cisco Discovery Protocol holdtime configuration:
n1000v(
config)#
no cdp holdtime 10
|
|
---|---|
Displays the Cisco Discovery Protocol global configuration parameters. |
|
To set the refresh time for the Cisco Discovery Protocol to send advertisements to neighbors, use the cdp timer command. To remove the Cisco Discovery Protocol timer configuration, use the no form of this command.
Time before the Cisco Discovery Protocol sends advertisements to neighbors. The range is from 5 to 254 seconds. |
|
|
This example shows how to configure the Cisco Discovery Protocol timer to 10 seconds:
n1000v(
config)#
cdp timer 10
This example shows how to remove the Cisco Discovery Protocol timer configuration:
n1000v(
config)#
no cdp timer 10
|
|
---|---|
Displays the Cisco Discovery Protocol global configuration parameters. |
|
To create and define a channel group for all interfaces that belong to a port profile, use the channel-group auto command. To remove the channel group, use the no form of this command.
channel-group auto [ mode channel_mode ] [ sub-group sg-type { cdp | manual }] [ mac-pinning ]
Port profile configuration (config-port-prof)
|
|
The channel-group auto command creates a unique port channel for all interfaces that belong to the same module. The channel group is automatically assigned when the port profile is assigned to the first interface. Each additional interface that belongs to the same module is added to the same port channel. In Microsoft Hyper-V environments, a different port channel is created for each module.
– You need to know whether Cisco Discovery Protocol is configured in the upstream switches.
If configured, Cisco Discovery Protocol creates a subgroup for each upstream switch to manage its traffic separately.
If not configured, you must manually configure subgroups to manage the traffic flow on the separate switches.
– When configuring a port channel for vPC-HM, and the upstream switches do not support port channels, you can use MAC pinning, which automatically assigns each Ethernet member port to a unique subgroup.
– You can also configure vPC-HM on the interface. For more information, see the Cisco Nexus 1000V Interface Configuration Guide, Release 4.2(1)SV1(5.1).
This example shows how to configure a port profile for a port channel that connects to a single upstream switch and then display the configuration:
This example shows how to configure a port profile for a port channel that connects to multiple upstream switches that have the Cisco Discovery Protocol enabled and then display the configuration:
|
|
---|---|
Creates a port profile and places you into global configuration mode for the named port profile. |
|
To clear the counters for IP and MAC access control lists (ACLs), use the clear access-list counters command.
clear access-list counters [ access-list-name ]
(Optional) ACL name, whose counters the device clears. The name can be up to 64 alphanumeric, case-sensitive characters. |
|
|
If you specify an ACL, the name can be up to 64 alphanumeric, case-sensitive characters.
This example shows how to clear counters for all IP and MAC ACLs:
This example shows how to clear counters for an IP ACL named acl-ip-01:
|
|
---|---|
To clear Cisco Discovery Protocol information on an interface, use the clear cdp command.
clear cdp { counters | table } [ interface { control if_num | mgmt mgmt_num }]
network-admin
network-operator
|
|
This example shows how to clear the Cisco Discovery Protocol counters on all interfaces:
n1000V#
clear cdp counters
This example shows how to clear the Cisco Discovery Protocol cache on all interfaces:
n1000V#
clear cdp table
|
|
---|---|
Displays interfaces that have the Cisco Discovery Protocol enabled. |
To clear the history of commands you have entered into the command-line interface (CLI), use the clear cli history command.
|
|
Use the show cli history command to display the history of the commands that you entered at the CLI.
This example shows how to clear the command history:
|
|
---|---|
To clear the core files, use the clear cores command.
(Optional) Clears the core file on the logflash file system. |
|
|
Use the show system cores command to display information about the core files.
This example shows how to clear the core file:
This example shows how to clear the core on the logflash file system:
|
|
---|---|
To clear interface counters, use the clear counters command.
clear counters [ interface { all | ethernet slot/port | mgmt | port-channel port-channel-number | vethernet interface-number }]
Clears a virtual Ethernet interface. Virtual Ethernet interface number. The range is from 1 to 1048575. |
network-admin
network-operator
|
|
This example shows how to clear the Ethernet interface counters:
n1000v(
config)#
clear counters ethernet 2/1
|
|
---|---|
To clear the contents of the debug logfile, use the clear debug-logfile command.
|
|
This example shows how to clear the debug logfile:
|
|
---|---|
To clear the statistics for a Flexible NetFlow flow exporter, use the clear flow exporter command.
clear flow exporter { name exporter-name | exporter-name }
Flow exporter name. The maximum size is 63, case-sensitive, alphanumeric characters. |
|
|
You must have already enabled traffic monitoring with Flexible NetFlow using an exporter before you can use the clear flow exporter command.
This example shows how to clear the statistics for the flow exporter named NFC-DC-PHOENIX:
|
|
---|---|
To clear the counters for IP access control lists (ACLs), use the clear ip access-list counters command.
clear ip access-list counters [ access-list-name ]
(Optional) IP ACL name, whose counters you want cleared. The name can be up to 64 alphanumeric, case-sensitive characters. |
|
|
If specifying an ACL by name, it can be up to 64 alphanumeric, case-sensitive characters.
This example shows how to clear counters for all IP ACLs:
This example shows how to clear counters for an IP ACL named acl-ip-101:
|
|
---|---|
To clear the Internet Group Management Protocol (IGMP) statistics for an interface, use the clear ip igmp interface statistics command.
clear ip igmp interface statistics [ if-type if-number ]
(Optional) Interface type. For more information, use the question mark (?) online help function. (Optional) Interface number. The range of numbers is dependent of the interface. |
network-admin
network-operator
This example shows how to clear IGMP statistics for an interface:
n1000v#
clear ip igmp interface statistics ethernet 2/1
n1000v#
|
|
|
|
---|---|
To clear the Internet Group Management Protocol (IGMP) snooping statistics for VLANs, use the clear ip igmp snooping statistics vlan command.
clear ip igmp snooping statistics vlan { vlan-id | all }
VLAN number. The range is from 1 to 3967 and from 4048 to 4093. |
|
network-admin
network-operator
|
|
This example shows how to clear IGMP snooping statistics for VLAN 1:
n1000v#
clear ip igmp snooping statistics vlan 1
n1000v#
|
|
---|---|
To clear the statistics for all interfaces for Link Aggregation Control Protocol (LACP) groups, use the clear lacp counters command.
clear lacp counters [ interface port-channel channel-number ]
|
|
If you clear counters for a specific port channel, the allowable port channel numbers are from 1 to 4096.
If you do not specify a port channel number, the LACP counters for all LACP port groups are cleared.
If you clear counters for a static port-channel group, without the aggregation protocol enabled, the device ignores the command.
This example shows how to clear all the LACP counters:
n1000v#
configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
n1000v(config)#
clear
lacp counters
n1000v(config) #
This example shows how to clear all LACP counters for the LACP port-channel group 20:
n1000v#
configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
n1000v(config)#
clear
lacp counters interface port-channel 20
n1000v(config)#
|
|
---|---|
To uninstall a license file from a Virtual Supervisor Module (VSM), or to uninstall an evaluation license before installing a permanent license, use the clear license command.
|
|
If a license is in use, you cannot uninstall it. Before uninstalling the license file, all licenses must first be transferred from the Virtual Ethernet Modules (VEMs) to the VSM license pool.
This example shows how to remove the Enterprise.lic license file from a VSM:
|
|
---|---|
Transfers licenses from a source VEM to another VEM or to the VSM pool of available licenses. |
To end a session on a specified virtual teletype (VTY), use the clear line command.
network-admin
network-operator
|
|
This example shows how to end a session on a specified VTY:
n1000v(
config)#
clear line
|
|
---|---|
To clear messages from the logging file, use the clear logging logfile command:
|
|
This example shows how to clear messages from the logging file:
|
|
---|---|
To clear the current logging session, use the clear logging session command:
|
|
This example shows how to clear the current logging session:
|
|
---|---|
To clear the counters for MAC access control lists (ACLs), use the clear mac access-list counters command.
clear mac access-list counters [ access-list-name ]
(Optional) MAC ACL name, whose counters you want to clear. The name can be up to 64 alphanumeric, case-sensitive characters. |
|
|
If you want counters cleared for a specific MAC ACL, the name can be up to 64 alphanumeric, case-sensitive characters.
This example shows how to clear counters for all MAC ACLs:
This example shows how to clear counters for a MAC ACL named acl-mac-0060:
|
|
---|---|
To clear the Layer 2 dynamic address entries from the MAC address table, use the clear mac address-table dynamic command.
clear mac address-table dynamic [bridge-domain bridge_dom_ name | vlan vlan-id [ bridge-domain bridge_dom_ name ] ]
(Optional) Specifies the bridge domain. Bridge domain name. The name is a maximum of 128 characters. |
|
|
|
Use the clear mac address-table dynamic command with no arguments or keywords to remove all dynamic entries from the table.
To clear static MAC addresses from the table, use the no mac address-table static command.
If you enter the clear mac address-table dynamic command with no arguments or keywords, all dynamic addresses are removed. If you specify an address but do not specify an interface, the address is deleted from all interfaces. If you specify an interface but do not specify an address, the device removes all addresses on the specified interfaces.
This example shows how to clear all dynamic Layer 2 entries from the MAC address table:
n1000v#
configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
n1000v(config)#
clear
mac address-table dynamic
n1000v(config) #
This example shows how to clear all dynamic Layer2 entries for VLAN 342:
n1000v#
configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
|
|
---|---|
To clear the Network Time Protocol (NTP) statistics, use the clear ntp statistics command.
clear ntp statistics { all-peers | io | local | memory }
network-admin
network-operator
|
|
This example shows how to clear statistics for all NTP peers:
n1000v(
config)#
clear ntp statistics all-peers
|
|
---|---|
To clear the Secure Shell (SSH) host sessions, use the clear ssh hosts command.
|
|
This example shows how to clear all of the SSH host sessions:
|
|
---|---|
To clear the device reset-reason history, use the clear system reset-reason command.
|
|
This example shows how to clear the reset-reason history:
|
|
---|---|
To clear a user session, use the clear user command.
User identifier. The name is alphanumeric, not case-sensitive, and has a maximum of 32 characters. |
|
|
Use the show users command to display the current user sessions on the device.
This example shows how to clear all Secure Shell (SSH) host sessions:
|
|
---|---|
To define a command-line interface (CLI) variable for a terminal session, use the cli var name command. To remove the CLI variable, use the no form of this command.
cli var name variable-name variable-text
Variable name. The name is alphanumeric, case-sensitive, and has a maximum of 31 characters. Variable text. The text is alphanumeric, can contain spaces, and has a maximum of 200 characters. |
|
|
You can reference a CLI variable using the following syntax:
Instances where you can use variables in include the following:
You cannot reference a variable in the definition of another variable.
You can use the predefined variable, TIMESTAMP, to insert the time of day. You cannot change or remove the TIMESTAMP CLI variable.
You must remove a CLI variable before you can change its definition.
This example shows how to define a CLI variable:
This example shows how to reference the TIMESTAMP variable:
This example shows how to remove a CLI variable:
|
|
---|---|
To manually set the clock, use the clock set command.
Time of day. The format is HH : MM : SS. Day of the month. The range is from 1 to 31. Month of the year. The values are January, February, March,... |
|
|
Use this command when you cannot synchronize your device with an outside clock source, such as NTP.
This example shows how to manually set the clock:
|
|
---|---|
To configure the summer-time (daylight saving time) offset, use the clock summer-time command. To revert to the default, use the no form of this command.
clock summer-time zone-name start-week start-day start-month start-time end-week end-day end-month end-time offset-minutes
|
|
This example shows how to configure the offset for summer-time or daylight saving time:
This example shows how to remove the summer-time offset:
|
|
---|---|
To configure the time zone offset from Coordinated Universal Time (UTC), use the clock timezone command. To revert to the default, use the no form of this command.
clock timezone zone-name offset-hours offset-minutes
Zone name. The name is a 3-character string e.g., PST or EST. |
|
|
|
This example shows how to configure the time zone offset from UTC:
This example shows how to remove the time zone offset:
|
|
---|---|
To configure the number of bytes or packets in a flow as a nonkey field and collect the number of bytes or packets seen for a Flexible NetFlow flow record, use the collect counter command. To disable the counters, use the no form of this command.
collect counter { bytes [long ] | packets [long ]}
no collect counter { bytes [long ] | packets [long ]}
Flow record configuration (config-flow-record)
|
|
This example shows how to collect the total number of bytes from the flows as a nonkey field:
This example shows how to collect the total number of bytes from the flows as a nonkey field using a 64 bit counter:
This example shows how to collect the total number of packets from the flows as a nonkey field:
This example shows how to collect the total number of packets from the flows as a nonkey field using a 64-bit counter:
|
|
---|---|
Configures the counters as a nonkey field and collects the counter values. |
|
To collect the TIMESTAMP SYS-UPTIME for a NetFlow flow record, use the collect timestamp sys-uptime command. To disable the collection, use the no form of this command.
collect timestamp sys-uptime { first | last }
no collect timestamp sys-uptime { first | last }
Flow record configuration (config-flow-record)
|
|
This example enables collecting the sys-uptime for the time that the first packet was seen from the flows:
This example enables collecting the sys-uptime for the time that the most recent packet was seen from the flows:
|
|
---|---|
To collect Transmission Control Protocol (TCP) flags for a NetFlow flow record, use the collect transport tcp flags command. To disable the collection, use the no form of this command.
no collect transport tcp flags
Flow record configuration (config-flow-record)
|
|
This example shows how to collect the TCP flags:
|
|
---|---|
To enter global configuration mode, use the configure terminal command.
|
|
The configuration changes you make in the global configuration mode are saved in the running configuration file. To save these changes persistently across reboots and restarts, you must copy them to the startup configuration file using the copy running-config startup-config command.
This example shows how to enter global configuration mode:
|
|
---|---|
Saves the running configuration persistently through reboots and restarts by copying it to the startup configuration. |
|
To copy a file from a source to a destination, use the copy command.
copy source-url destination-url
The default name for the destination file is the source filename.
|
|
The entire copying process may take several minutes, depending on the network conditions and the size of the file and differs from protocol to protocol and from network to network.
The colon character (:) is required after the file system URL prefix keywords (such as bootflash).
In the URL syntax for ftp:, scp:, sftp:, and tftp:, the server is either an IP address or a hostname.
The format of the source and destination URLs varies according to the file or directory location. You may enter either a command-line interface (CLI) variable for a directory or a filename that follows the Cisco NX-OS file system syntax ( filesystem : [ / directory ] [ / filename ]).
The following tables list URL prefix keywords by the file system type. If you do not specify a URL prefix keyword, the device looks for the file in the current directory.
Table 3-1 lists URL prefix keywords for bootflash and remote writable storage file systems.
Table 3-2 lists the URL prefix keywords for nonwritable file systems.
This example shows how to copy a file within the same directory:
This example shows how to copy a file to another directory:
This example shows how to copy a file to another supervisor module:
This example shows how to copy a file from a remote server:
|
|
---|---|
To copy the running configuration to the startup configuration, use the copy running-config startup-config command.
copy running-config startup-config
|
|
Use this command to save configuration changes in the running configuration to the startup configuration in persistent memory. When a device reload or switchover occurs, the saved configuration is applied.
This example shows how to save the running configuration to the startup configuration:
|
|
---|---|
Displays the differences between the running configuration and the startup configuration. |
|
Erases the startup debug configuration in the persistent memory. |