Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc.
is strictly forbidden.
Trademarks used in this text: Dell™, the DELL logo, Dell Precision™, OptiPlex™, Latitude™,
PowerEdge™, PowerVault™, PowerConnect™, OpenManage™, EqualLogic™, KACE™,
FlexAddress™ and Vostro™ are trademarks of Dell Inc. Intel
®
Celeron
registered trademark and AMD Opteron™, AMD Phenom™, and AMD Sempron™ are trademarks
of Advanced Micro Devices, Inc. Microsoft
Windows V ista
States and/or other countries. Red Hat Enterprise Linux
trademarks of Red Hat, Inc. in the United States and/or other countries. Novell
trademark and SUSE ™ is a trademark of Novell Inc. in the United States and other countries. Oracle
is a registered trademark of Oracle Corporation and/or its affiliates. Citrix
XenMotion
and/or other countries. VMware
trademarks or trademarks of VMWare, Inc. in the United States or other countries.
Other trademarks and trade names may be used in this publication to refer to either the entities claiming
the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and
trade names other than its own.
are registered trademarks of Intel Corporation in the U.S. and other countries. AMD® is a
®
®
are either trademarks or registered trademarks of Microsoft Corporation in the United
®
are either registered trademarks or trademarks of Citrix Systems, Inc. in the United States
®
, Virtual SM P®, vMotion®, vCenter®, and vSphere® are registered
, Windows®, Windows Server®, MS-DOS® and
®
, Pentium®, Xeon®, Core™ and
®
and Enterprise Linux® are registered
®
is a registered
®
, Xen®, XenServer® and
®
Regulatory Models: PC5524, PC5524P, PC5548 and PC5548P
October 2013 Rev. A08
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 – FOR PROOF ONLY
This CLI Reference Guide describes how to use the CLI and a list of the CLI
commands and their arguments.
The CLI commands described in this document are organized according to
feature groups in separate sections.
This section describes how to use the CLI. It contains the following topics:
•CLI Command Modes
•Starting the CLI
•CLI Command Conventions
•Entering Commands
CLI Command Modes
To configure devices, the CLI is divided into various command modes. Each
command mode has its own set of specific commands. Entering a question
mark "?" at the console prompt displays a list of commands available for that
particular command mode.
A specific command, which varies from mode to mode, is used to navigate
from one mode to another. The standard order to access the modes is as
follows:
mode, and
When starting a session, the initial mode for non-privileged users is the User
EXEC mode. Only a limited subset of commands is available in the User
EXEC mode. This level is reserved for tasks that do not change the
configuration.
User EXEC
Interface Configuration
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Privileged users enter the Privileged EXEC mode directly using a password.
This mode provides access to the device Configuration modes.
The modes are described below.
CLI\files\CLI_Preface.fm
User EXEC Mode
After logging into the device, the user is automatically in
command mode unless the user is defined as a privileged user. In general, the
User EXEC
system information.
The user-level prompt consists of the device "host name" followed by the
angle bracket (>).
console>
The default host name is "console" unless it has been changed using the
hostname command in the
commands enable the user to perform basic tests, and display
Global Configuration
mode.
User EXEC
Privileged EXEC Mode
Privileged access is password-protected to prevent unauthorized use, because
many of the privileged commands set operating system parameters: The
password is not displayed on the screen and is case sensitive.
Privileged users enter directly into the
Use disable to return to the
User EXEC
Privileged EXEC
mode.
mode.
Global Configuration Mode
Global Configuration
system as a whole, rather than just a specific interface.
To enter the
EXEC mode, and press <Enter>.
The
Global Configuration
console(config)#
Use exit, end or ctrl/z to return to the Privileged EXEC mode.
Global Configuration
mode commands apply to features that affect the
mode, enter configure in the Privileged
mode prompt is displayed.
Interface Configuration Modes
Commands in the following modes perform specific interface operations:
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
connections. These include commands such as line speed, timeout
settings, etc. The
enter the
•
VLAN Database—
Global Configuration mode command
—Contains commands to configure the management
Line Configuration command
VLAN Database Interface Configuration
•
Management Access List—
access-lists. The
access-list is used to enter the
mode.
•
Port Channel—
example, assigning ports to a VLAN or port-channel. The
Configuration
Contains commands to configure port-channels, for
mode command interface
Port Channel Interface Configuration
•
SSH Public Key-Chain
device SSH public keys. The
key pubkey-chain
Configuration
•
Interface
Configuration
Configuration
mode.
—Contains commands that configure the interface. The
mode command
mode.
CLI\files\CLI_Preface.fm
Global Configuration
Contains commands to create a VLAN as a whole. The
Contains commands to define management
Global Configuration
mode command
mode.
vlan database
mode.
mode command management
line
is used to enter the
Management Access List Configuration
port-channel
mode.
—Contains commands to manually specify other
Global Configuration
ssh
is used to enter the
interface
SSH Public Key-chain
is used to enter the
is used to enter the
mode command crypto
is used to
Global
Global
Interface
Starting the CLI
The switch can be managed over a direct connection to the switch console
port, or via a Telnet connection. The switch is managed by entering
command keywords and parameters at the prompt. Using the switch CLI
commands is similar to entering commands on a UNIX system.
If access is via a Telnet connection, ensure the device has an IP address
defined, corresponding management access is granted, and the workstation
used to access the device is connected to the device prior to using CLI
commands.
Accessing the CLI from the Console Line
1.Start the device and wait until the startup procedure is complete. The User
Exec mode is entered, and the prompt "console>" is displayed.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
2.Configure the device and enter the ne ce ssa ry commands to complete the
required tasks.
3.When finished, exit the session with the quit or exit command.
CLI\files\CLI_Preface.fm
Accessing the CLI from Telnet
1.Enter telnet and the IP address of the device. A User Name prompt is
displayed.
2.Enter the User Name and Password. You are in the Privileged Exec mode.
3.Configure the device and enter the ne ce ssa ry commands to complete the
required tasks.
4.When finished, exit the session with the quit or exit command.
When another user is required to log onto the system, the login command is
entered in the Privileged EXEC command mode,. This effectively logs off the
current user and logs on the new user.
CLI Command Conventions
The following table describes the command syntax conventions.
ConventionsDescription
[ ]In a command line, square brackets indicates
an optional entry.
{ }In a command line, curly brackets indicate a
selection of compulsory parameters separated
by the | character. One option must be
selected. For example: flowcontrol {auto|on|off} means that for the flowcontrol
command either auto, on or off must be
selected.
Italic fontIndicates a parameter.
<Enter>Any individual key on the keyboard. For
example click <Enter>.Ctrl+F4Any combination keys pressed simultaneously
on the keyboard.
36
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Screen DisplayIndicates system messages and prompts
allWhen a p arameter is required to def ine a range
CLI\files\CLI_Preface.fm
appearing on the console.
of ports or parameters and all is an op tion, the
default for the command is all when no
parameters are defined. For example, the
command interface range port-channel has
the option of either entering a range of
channels, or selecting all. When the command
is entered without a parameter, it automatically
defaults to all.
Entering Commands
A CLI command is a series of keywords and arguments. Keywords identify a
command, and arguments specify configuration parameters. For example, in
the command "show interfaces status gi1/0/5" show, interfaces and status are
keywords, gi is an argument that specifies the interface type, and 1/0/5 is an
argument that specifies the port.
To enter commands that require parameters, enter the required parameters
after the command keyword. For example, to set a password for the
administrator, enter:
console(config)# username admin password smith
Help information can be displayed in the following ways:
•
Keyword Lookup
—The character ? is entered in place of a command. A
list of all valid commands and corresponding help messages are displayed.
•
Partial Keyword Lookup
—A command is incomplete and the character ?
is entered in place of a parameter. The matched parameters for this
command are displayed.
The following describes features that assist in using the CLI:
Terminal Command Buffer
Every time a command is entered in the CLI, it is recorded on an internally
managed Command History buffer. Commands stored in the buffer are
maintained on a First In First Out (FIFO) basis.These commands can be
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
recalled, reviewed, modified, and reissued. This buffer is not preserved across
device resets. The keys that can be used to access the history buffer are
described in Ta bl e 1 .
By default, the history buffer system is enabled, but it can be disabled at any
time. For information about the command syntax to enable or disable the
history buffer, see the history command.
There is a standard default number of commands that are stored in the buffer.
The standard number of 10 commands can be increased to 256. By
configuring 0, the effect is the same as disabling the history buffer system. For
information about the command syntax for configuring the command history
buffer, see the history size command.
To display the history buffer, see show history command.
Negating the Effect of Commands
For many configuration commands, the prefix keyword "no" can be entered to
cancel the effect of a command or reset the configuration to the default
value. This guide describes the negation effect for all applicable commands.
Command Completion
If the command entered is incomplete, invalid, or has missing or invalid
parameters, an appropriate error message is displayed.
To complete an incomplete command, press the <Tab> button. If the
characters already entered are not enough for the system to identify a single
matching command, press "?" to display the available commands matching
the characters already entered.
Incorrect or incomplete commands are automatically re-entered next to the
cursor. If a parameter must be added, the parameter can be added to the basic
command already displayed next to the cursor. The following example
indicates that the command interface requires a missing parameter.
Help may be requested at any point in a command by entering
a question mark '
entered incomplete command, the help list is empty. This
indicates that there is no command matching the input as it
currently appears. If the request is within a command, press
the Backspace key and erase the entered characters to a
point where the request results in a match.
Help is provided when:
1. There is a valid command and a help request is made for
entering a parameter or argument (e.g. 'show ?'). All
possible parameters or arguments for the entered command are
then displayed.
2. An abbreviated argument is entered and a help request is
made for arguments matching the input (e.g. 'show pr?').
?
'. If nothing matches the currently
history
The history Line Configuration mode command enables the command
history function. Use the no form of this command to disable the command
history function.
Syntax
history
no history
Default Configuration
The history command is enabled.
Command Mode
Line Configuration mode
User Guidelines
This command enables the command history function for a specified line.
Use the terminal history EXEC mode command to enable or disable the
command history function for the current terminal session.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The following example enables the command history function for Telnet.
Console(config)#
Console(config-line)#
line telnet
history
history size
The history size Line Configuration mode command changes the command
history buffer size for a particular line. Use the no form of this command to
reset the command history buffer size to the default value.
Syntax
history size
no history size
Parameters
number-of-commands—Specifies the number of commands the system
records in its history buffer. (Range: 0–
Default Configuration
The default command history buffer size is 10 commands.
Command Mode
Line Configuration mode
number-of-commands
256)
User Guidelines
This command configures the command history buffer size for a particular
line. Use the terminal history size EXEC mode command to configure the
command history buffer size for the current terminal session.
The allocated command history buffer is per terminal user, and is taken from
a shared buffer. If there is not enough space available in the shared buffer, the
command history buffer size () cannot be increased above the default size.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The following example changes the command history buffer size to 100
entries for a particular line
Console(config)#
Console(config-line)#
line telnet
history size
100
terminal history
The terminal history EXEC mode command enables the command history
function for the current terminal session. Use the no form of this command
to disable the command history function.
Syntax
terminal history
terminal no history
Default Configuration
The default configuration for all terminal sessions is defined by the history
Line Configuration mode command.
Command Mode
EXEC mode
User Guidelines
The command enables the command history for the current session. The
default is determined by the history Line Configuration mode command.
Example
The following example disables the command history function for the current
terminal session.
Console>
terminal no history
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The terminal history size EXEC mode command changes the command
history buffer size for the current terminal session. Use the no form of this
command to reset the command history buffer size to the default value.
Syntax
terminal history size
terminal no history size
Parameters
number-of-commands—Specifies the number of commands the system
maintains in its history buffer. (Range: 10–
Default Configuration
The default configuration for all terminal sessions is defined by the history
size Line Configuration mode command.
Command Mode
EXEC mode
number-of-commands
256)
User Guidelines
The terminal history size EXEC command changes the command history
buffer size for the current terminal session. Use the history Line
Configuration mode command to change the default command history
buffer size.
The maximum number of commands in all buffers is 256.
Example
The following example sets the command history buffer size to 20 commands
for the current terminal session.
Console>
terminal history size
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The terminal datadump EXEC mode command enables dumping all the
output of a show command without prompting. Use the no form of this
command to disable dumping.
Syntax
terminal datadump
terminal no datadump
Default Configuration
Dumping is disabled.
Command Mode
EXEC mode
User Guidelines
By default, a More prompt is displayed when the output contains more lines
than can be displayed on the screen. Pressing the Enter key displays the next
line; pressing the Spacebar displays the next screen of output. The terminal datadump command enables dumping all output immediately after entering
the show command.
This command is relevant only for the current session.
Example
The following example dumps all output immediately after entering a show
command.
Console>
terminal datadump
debug-mode
The debug-mode Privileged EXEC mode command mode switches to debug
mode.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Use the banner exec command to specify and enable a message to be
displayed when an EXEC process is created (The user has successfully logged
in), use the banner exec command in Global Configuration mode. Use the no
form of this command to delete the existing EXEC banner.
Syntax
banner exec
d message-text d
no banner exec
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
•d—Delimiting character of your choice—a pound sign (#), for example.
You cannot use the delimiting character in the banner message.
•
message-text
line messages. You can include tokens in the form of
—The message must start in a new line. You can enter multi-
$(token)
in the
message text. Tokens are replaced with the corresponding configuration
variable. Tokens are described in the User Guidelines. The message can
contain up to 2000 characters (after every 510 characters, you must press
<Enter> to continue).
Default Configuration
Disabled (no EXEC banner is displayed).
Command Mode
Global Configuration mode
User Guidelines
Follow this command with one or more blank spaces and a delimiting
character of your choice. Then enter one or more lines of text, terminating
the message with the second occurrence of the delimiting character.
When a user connects to a device, the message-of-the-day (MOTD) banner
appears first, followed by the login banner and prompts. After the user logs in
to the device, the EXEC banner is displayed.
Use tokens in the form of $(token) in the message text to customize the
banner. The tokens are described in the table below:
TokenInformation displayed in the banner
$(hostname)Displays the host name for the device.
$(domain)Displays the domain name for the device.
$(bold)Indicates that the next text is a bold text. Using this token
again indicates the end of the bold text.
$(inverse)Indicates that the next text is an inverse text. Using this
token again indicates the end of the inverse text.
$(contact)Displays the system contact string.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
$(location)Displays the system location string.
$(mac-
address)
Displays the base MAC address of the device.
CLI\files\User_Interface.fm
Use the no exec-banner line configuration command to disable the EXEC
banner on a particular line or lines.
Example
The following example sets an EXEC banner that uses tokens. The percent
sign (%) is used as a delimiting character. Note that the $(token) syntax is
replaced by the corresponding configuration variable.
Device(config)#
Enter TEXT message. End with the character '%'.
$(bold)Session activated.$(bold) Enter commands at the prompt.
%
When a user logs on to the system, the following output is displayed:
Session activated. Enter commands at the prompt.
banner exec
%
banner login
Use the banner login command in Global Configuration mode to specify and
enable a message to be displayed before the username and password login
prompts. Use the no form of this command to delete the existing Login
banner.
Syntax
banner login
no banner login
Parameters
•
Delimiting character of your choice
cannot use the delimiting character in the banner message.
d message-text d
—A pound sign (#), for example. You
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
—Message text. The message must start on a new line. You
CLI\files\User_Interface.fm
can enter multi-line messages. You can include tokens in the form of
$(token)
in the message text. Tokens are replaced with the corresponding
configuration variable. Tokens are described in the User Guidelines. The
message can contain up to 2000 characters (after every 510 characters, you
must press <Enter> to continue).
Default Configuration
Disabled (no Login banner is displayed).
Command Mode
Global Configuration mode
User Guidelines
Follow this command with one or more blank spaces and a delimiting
character of your choice. Then enter one or more lines of text, terminating
the message with the second occurrence of the delimiting character.
When a user connects to a device, the message-of-the-day (MOTD) banner
appears first, followed by the login banner and prompts. After the user logs in
to the device, the EXEC banner is displayed.
Use tokens in the form of $(token) in the message text to customize the
banner. The tokens are described in the table below:
TokenInformation displayed in the banner
$(hostname)Displays the host name for the device.
$(domain)Displays the domain name for the device.
$(bold)Indicates that the next text is a bold text. Using this
token again indicates the end of the bold text.
$(inverse)Indicates that the next text is an inverse text. Using this
token again indicates the end of the inverse text.
$(contact)Displays the system contact string.
$(location)Displays the system location string.
$(mac-
address)
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Use the no login-banner line configuration command to disable the Login
banner on a particular line or lines.
Example
The following example sets a Login banner that uses tokens. The percent sign
(%) is used as a delimiting character. Note that the $(token) syntax is
replaced by the corresponding configuration variable.
Device(config)# banner login %
Enter TEXT message. End with the character '%'.
You have entered $(hostname).$(domain)
%
When the login banner is executed, the user will see the following banner:
You have entered host123.ourdomain.com
banner motd
Use the banner motd command in Global Configuration mode to specify and
enable a message-of-the-day banner. Use the no form of this command to
delete the existing MOTD banner.
Syntax
banner motd
d message-text d
no banner motd
Parameters
•d—Delimiting character of your choice—a pound sign (#), for example.
You cannot use the delimiting character in the banner message.
•
message-text
line messages. You can include tokens in the form of
—The message must start on a new line. You can enter multi-
$(token)
in the
message text. Tokens are replaced with the corresponding configuration
variable. Tokens are described in the User Guidelines. The message can
contain up to 2000 characters (after every 510 characters, you must press
<Enter> to continue).
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Follow this command with one or more blank spaces and a delimiting
character of your choice. Then enter one or more lines of text, terminating
the message with the second occurrence of the delimiting character.
When a user connects to a device, the message-of-the-day (MOTD) banner
appears first, followed by the login banner and prompts. After the user logs in
to the device, the EXEC banner is displayed.
Use tokens in the form of $(token) in the message text to customize the
banner. The tokens are described in the table below:
TokenInformation displayed in the banner
$(hostname)Displays the host name for the device.
$(domain)Displays the domain name for the device.
$(bold)Indicates that the next text is a bold text. Using this token
again to indicates the end of the bold text.
$(inverse)Indicates that the next text is an inverse text. Using this
token again indicates the end of the inverse text.
$(contact)Displays the system contact string.
$(location)Displays the system location string.
$(mac-address)Displays the base MAC address of the device.
Use the no motd-banner line configuration command to disable the MOTD
banner on a particular line or lines.
Example
The following example sets an MOTD banner that uses tokens. The percent
sign (%) is used as a delimiting character. Note that the $(token) syntax is
replaced by the corresponding configuration variable.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Device(config)#
Enter TEXT message. End with the character '%'.
$(bold)Upgrade$(bold) to all devices begins at March 12
%
When the login banner is executed, the user will see the following banner:
Upgrade to all devices begins at March 12
banner motd
%
exec-banner
Use the exec-banner command in Line Configuration mode to enable the
display of exec banners. Use the no form of this command to disable the
display of exec banners.
Syntax
exec-banner
no exec-banner
Parameters
This command has no arguments or keywords.
Default Configuration
Disabled
Command Mode
Line Configuration mode
Example
console#
console(config)# line console
console(config-line)# exec-banner
console(config-line)# exit
console(config)# line telnet
console(config-line)# exec-banner
console(config-line)# exit
console(config)# line ssh
configure
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Use the login-banner command in Line Configuration mode to enable the
display of login banners. Use the no form of this command to disable the
display of login banners.
Syntax
login-banner
no login-banner
Parameters
This command has no arguments or keywords.
Default Configuration
Enabled
Command Mode
Line Configuration mode
Example
console#
console(config)# line console
console(config-line)# login-banner
console(config-line)# exit
console(config)# line telnet
console(config-line)# login-banner
console(config-line)# exit
console(config)# line ssh
console(config-line)# login-banner
configure
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Use the motd-banner command in Line Configuration mode to enable the
display of message-of-the-day banners. Use the no form of this command to
disable the display of MOTD banners.
Syntax
motd-banner
no motd-banner
Parameters
This command has no arguments or keywords.
Default Configuration
Enabled
Command Mode
Line Configuration mode
Example
console#
console(config)# line console
console(config-line)# motd-banner
console(config-line)# exit
console(config)# line telnet
console(config-line)# motd-banner
console(config-line)# exit
console(config)# line ssh
console(config-line)# motd-banner
configure
show banner
Use the show banner command in EXEC mode to display the configuration
of banners.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Device> show banner motd
Banner: MOTD
Line SSH: Enabled
Line Telnet: Enabled
Line Console: Enabled
10000 giga ports switch
console#
console# show banner login
Use the Macro Name Global Configuration mode command to create a user
defined macro.
Use the no form of this command to delete the macro definition.
Syntax
macro name [
no macro name [
Parameters
macro-name—Name of the macro. Macro names are case sensitive.
macro-name
macro-name
]
]
Default Configuration
The command has no default setting.
Command Mode
Global Configuration mode
User Guidelines
A macro can contain up to 3000 characters and up to 200 lines. Enter one
macro command per line. Use the @ character to end the macro. Use the #
character at the beginning of a line to enter comment text within the macro.
You can define mandatory keywords within a macro by using a help string to
specify the keywords. Enter #macro keywords word to define the keywords
that are available for use with the macro. The keyword name is case sensitive.
You can enter up to three keywords separated by a space. Only the first three
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
keywords are visible if you enter more than three macro keywords. The
command can be anywhere within the macro.
When creating a macro, do not use the exit or end commands or change the
command mode using interface interface-id. Doing so might cause
commands that follow exit, end or interface interface-id to be executed in a
different command mode.
You can modify a macro by creating a new macro with the same name as the
existing macro. The newer macro overwrites the existing macro.
Examples
The following example shows how to create a macro that defines the duplex
mode and speed:
Switch(config) # macro name dup
Enter macro commands one per line. End with the character ‘@’.
macro description dup
duplex full
speed auto
The following example shows how to create a macro with #macro keywords:
Switch(config) # macro name duplex
Enter macro commands one per line. End with the character ‘@’.
macro description duplex
duplex $DUPLEX
speed $SPEED
#macro keywords $ DUPLEX $ SPEED
@
The following example shows how to apply the macros to an interface:
Switch(config-if) # macro apply duplex $DUPLEX full $SPEED auto
Switch(config-if) # macro apply duplex ?
WORDkeyword to replace with value e.g. $DUPLEX, $SPEED
<cr>
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Switch(config-if) # macro apply duplex $DUPLEX ?
WORDValue of the first keyword to replace
<cr>
Switch(config-if) # macro apply duplex $DUPLEX full $SPEED ?
WORDValue of the second keyword to replace
CLI\files\750_Macro.fm
macro apply
Use the macro apply interface configuration command to apply a macro to an
interface or to apply and trace a macro configuration on an interface.
Syntax
macro {
[
Parameters
apply | trace} macro-name [parameter {value
parameter {value}
•
apply
—Apply a macro to the specific interface.
•
trace
—Apply and trace a macro to the specific interface.
•
macro-name
•
parameter
]
—Specify the name of the macro.
—(Optional) Specify unique parameter values that are specific
}] [
parameter {value}]
to the interface. You can enter up to three keyword-value pairs. Parameter
keyword matching is case sensitive. All matching occurrences of the
keyword are replaced with the corresponding value.
Default Configuration
The command has no default setting.
Command Mode
Interface Configuration mode
User Guidelines
You can use the macro trace macro-name Interface Configuration command
to apply and show the macros running on an interface or to debug the macro
to find any syntax or configuration errors.
If a command fails because of a syntax error or a configuration error the
macro continues to apply t) in the interface. Use the parameter value
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
keywords to designate values specific to the interface when creating a macro
that requires the assignment of a unique value.
Keyword matching is case sensitive. All matching occurrences of the keyword
are replaced with the corresponding value. Any full match of a keyword, even
if it is part of a large string, is considered a match and replaced by the
corresponding value.
Some macros might contain keywords that require a parameter value. You can
use the macro apply macro-name command to display a list of any required
values in the macro. If you apply a macro without entering the keyword
values, the commands are invalid and are therefore not applied.
When you apply a macro to an interface, the macro name is automatically
added to the interface. You can display the applied commands and macro
names by using the show running-configuration interface interface-id user
EXEC mode command.
A macro applied to an interface range behaves the same way as a macro
applied to a single interface. When a macro is applied to an interface range, it
is applied sequentially to each interface within the range. If a macro
command fails on one interface, it is nonetheless applied to the remaining
interfaces.
Use the macro description Interface Configuration mode command to enter
a description about which macros are applied to an interface. Use the no form
of this command to remove the description.
Syntax
macro description
no macro description
Parameters
text—Description text. The text can contain up to 160 characters.
Default Configuration
The command has no default setting.
Command Mode
Interface Configuration mode
User Guidelines
When multiple macros are applied on a single interface, the description text
is a concatenation of texts from a number of previously applied macros.
You can verify your setting by entering the show parser macro description
privileged EXEC modecommand.
text
Example
Switch(config) # interface gi1/0/2
Switch(config-if) # macro apply dup
Switch(config-if) # end
Switch(config) # interface gi1/0/3
Switch(config-if) # macro apply duplex $DUPLEX full $SPEED auto
Switch(config-if) # end
Switch # show parser macro description
InterfaceMacro Description
Use the macro global Global Configuration command to apply a macro to a
switch or to apply and trace a macro configuration on a switch.
Syntax
macro global {
{
value
}] [
apply | trace} macro-name [parameter {value
parameter {value}
]
}] [
parameter
Parameters
•
apply
—Apply a macro to the switch.
•
trace
—Apply and trace a macro to the switch.
•
macro-name
•
paramete
—Specify the name of the macro.
—(Optional) Specify unique parameter values that are specific
to the switch. You can enter up to three keyword-value pairs. Parameter
keyword matching is case sensitive. All matching occurrences of the
keyword are replaced with the corresponding value.
Default Configuration
The command has no default setting.
Command Mode
Global Configuration mode
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
You can use the macro global trace macro-name Global Configuration mode
command to apply and show the macros running on the switch or to debug
the macro in order to locate any syntax or configuration errors.
If a command fails because of a syntax error or a configuration error when you
apply a macro, the macro nonetheless continues to apply the remaining
commands to the interface.
Use the parameter value keywords to designate values specific to the switch
when creating a macro that requires the assignment of unique value.
Keyword matching is case sensitive. All matching occurrences of the keyword
are replaced with the corresponding value. Any full match of a keyword, even
if it is part of a large string, is considered a match and replaced by the
corresponding value.
Some macros might contain keywords that require a parameter value. You can
use the macro global apply macro-name command to display a list of any
required values in the macro. If you apply a macro without entering the
keyword values, the commands are considered invalid and are not applied.
When you apply a macro to the switch, the macro name is automatically
added to the switch. You can display the applied commands and macro names
by using the show running-configuration interface user EXEC mode
command.
macro global description
Use the macro global description Global Configuration command to enter a
description about which macros are applied to the switch. Use the no form of
this command to remove the description.
Syntax
macro global description
no macro global description
Parameters
text—Description text. The text can contain up to 160 characters.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
When multiple global macros are applied to a switch, the global description
text is a concatenation of texts from a number of previously applied macros.
You can verify your settings by entering the show parser macro description
privileged EXEC mode command.
show parser macro
Use the show parser macro User EXEC mode command to display the
parameters for all configured macros or for one macro on the switch.
Syntax
show parser macro [{brief | description [interface
macro-name}
]
interface-id
] | name
Parameters
•
brief—(Optional) Display the name of each macro.
•
description [interface]—(Optional) Display all macro descriptions.
•
interface-id—Or the description of a specific interface.
•
name macro-name—(Optional) Display information about a single macro
identified by the macro name.
Command Mode
User EXEC mode
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Use the ping command to send ICMP echo request packets to another node
on the network.
Syntax
ping [ip] {
[timeout
ipv4-address | hostname
time_out
]
} [
size packet_size
] [
count packet_count]
ping ipv6 {
packet_count
Parameters
•ip—Use IPv4 to check the network connectivity.
•
•
•
•
•
•
•
ipv6-address | hostname
] [timeout
ipv6
—Use IPv6 to check the network connectivity.
ipv4-address
ipv6-address
address is a Link Local address (IPv6Z address), the outgoing interface
name must be specified. Refer to the User Guidelines for the interface
name syntax.
hostname
packet_size
The default is 64 bytes. (IPv4:64-1518, IPv6: 68-1518)
packet_count
default is 4 packets. If 0 is entered, it pings until stopped (0–65535).
time-out
65535 milliseconds. The default is 2000 milliseconds (50–65535).
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
—Hostname to ping (160 characters. Maximum label size: 63.)
—Number of bytes in the packet not including the VLAN tag.
—Timeout in milliseconds to wait for each reply, from 50 to
time_out
—IPv4 address to ping.
—Unicast or multicast IPv6 address to ping. When the IPv6
—Number of packets to send, from 1 to 65535 packets. The
Press Esc to stop pinging. Following are sample results of the ping command:
•
Destination does not respond
—If the host does not respond, a “no answer
from host” appears within 10 seconds.
•
Destination unreachable
—The gateway for this destination indicates that
the destination is unreachable.
•
Network or host unreachable
—The switch found no corresponding entry
in the route table.
The format of an IPv6Z address is: <
>
name
•
interface-name
=
vlan<integer> | ch<integer> | isatap<integer> |
ipv6-link-local-address>%<interface-
<physical-port-name> | 0
•
integer
= <
•
decimal-number
•
physical-port-name
decimal-number> | <integer><decimal-number
=
0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
= Designated port number, for example
>
gi1/0/1
When using the ping ipv6 command to check network connectivity of a
directly attached host using its link local address, the egress interface may be
specified in the IPv6Z format. If the egress interface is not specified, the
default interface is selected. Specifying interface zone=0 is equivalent to not
defining an egress interface.
When using the ping ipv6 command with MC address, the information
displayed is taken from all received echo responses.
Examples
Console> ping ip 10.1.1.1
Pinging 10.1.1.1 with 64 bytes of data:
64 bytes from 10.1.1.1: icmp_seq=0. time=11 ms
64 bytes from 10.1.1.1: icmp_seq=1. time=8 ms
64 bytes from 10.1.1.1: icmp_seq=2. time=8 ms
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Console> ping ip yahoo.com
Pinging yahoo.com [66.218.71.198] with 64 bytes of data:
64 bytes from 10.1.1.1: icmp_seq=0. time=11 ms
64 bytes from 10.1.1.1: icmp_seq=1. time=8 ms
64 bytes from 10.1.1.1: icmp_seq=2. time=8 ms
64 bytes from 10.1.1.1: icmp_seq=3. time=7 ms
Console> ping ip 176.16.1.1
Pinging 176.16.1.1 with 64 bytes of data:
CLI\files\System_Management.fm
64 bytes from 176.16.1.1: icmp_seq=0. time=5 ms
64 bytes from 176.16.1.1: icmp_seq=1. time=5 ms
64 bytes from 176.16.1.1: icmp_seq=2. time=5 ms
64 bytes from 176.16.1.1: icmp_seq=3. time=5 ms
console> ping ipv6 FF02::1
Pinging FF02::1 with 64 bytes of data:
64 bytes from 3003::11: icmp_seq=1. time=0 ms
64 bytes from 3003::33: icmp_seq=1. time=70 ms
64 bytes from 3003::11: icmp_seq=2. time=0 ms
64 bytes from 3003::55: icmp_seq=1. time=1050 ms
64 bytes from 3003::33: icmp_seq=2. time=70 ms
64 bytes from 3003::55: icmp_seq=2. time=1050 ms
64 bytes from 3003::11: icmp_seq=3. time=0 ms
64 bytes from 3003::33: icmp_seq=3. time=70 ms
64 bytes from 3003::11: icmp_seq=4. time=0 ms
64 bytes from 3003::55: icmp_seq=3. time=1050 ms
64 bytes from 3003::33: icmp_seq=4. time=70 ms
64 bytes from 3003::55: icmp_sq=4. time=1050 ms
CLI\files\System_Management.fm
---- FF02::1 PING Statistics---4 packets transmitted, 12 packets received
traceroute
To discover (?) the routes that packets will take when traveling to their
destination, use the traceroute EXEC command.
Syntax
traceroute ip {
packet_count
[count
traceroute ipv6 {
[count
packet_count
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
—IPv4 address of the destination host. (Range: Valid IP
address)
•
ipv6-address
•
hostname
—IPv6 address of the destination host.
—Hostname of the destination host. (Range: 1–160 characters.
Maximum label size: 63.)
•
packet_size
—Number of bytes in the packet not including the VLAN tag.
The default is 64 bytes. (IPv4:64-1518, IPv6: 68-1518)
•
ttl max-ttl
The
—The largest TTL value that can be used. The default is 30.
traceroute
command terminates when the destination is reached or
when this value is reached. (Range: 1–255)
•
count packet_count
—The number of probes to be sent at each TTL level.
The default count is 3. (Range: 1–10)
•
timeout time_out
—The number of seconds to wait for a response to a
probe packet. The default is 3 seconds. (Range: 1–60)
•
source ip-address
—One of the interface addresses of the device to use as a
source address for the probes. The device will normally pick what it feels is
the best source address to use. (Range: Valid IP address)
•
tos tos
—The Type-Of-Service byte in the IP Header of the packet.(Range:
0—255)
Command Mode
EXEC mode
User Guidelines
The traceroute command works by taking advantage of the error messages
generated by routers when a datagram exceeds its time-to-live (TTL) value.
The traceroute command starts by sending probe datagrams with a TTL
value of one. This causes the first router to discard the probe datagram and
send back an error message. The traceroute command sends several probes at
each TTL level and displays the round-trip time for each.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The traceroute command sends out one probe at a time. Each outgoing
packet can result in one or two error messages. A "time exceeded” error
message indicates that an intermediate router has seen and discarded the
probe. A "destination unreachable" error message indicates that the
destination node has received the probe and discarded it because it could not
deliver the packet. If the timer goes off before a response comes in, the
traceroute command prints an asterisk (*).
The traceroute command terminates when the destination responds, when
the maximum TTL is exceeded, or when the user interrupts the trace with
Esc.
The traceroute command is not relevant to IPv6 link local addresses.
Example
Router> traceroute ip umaxp1.physics.lsa.umich.edu
Type Esc to abort.
Tracing the route to umaxp1.physics.lsa.umich.edu (141.211.101.64)
The following table describes the significant fields shown in the display:
FieldDescription
1Indicates the sequence number of the router in the
path to the host.
i2-gateway.stanford.eduHost name of this router.
192.68.191.83IP address of this router.
1 msec 1 msec 1 msecRound-trip time for each of the probes that are
sent.
The following are characters that can appear in the traceroute command
output:
FieldDescription
*The probe timed out.
?Unknown packet type.
AAdministratively unreachable. Usually, this output indicates that
an access list is blocking traffic.
FFragmentation required and DF is set.
HHost unreachable.
NNetwork unreachable.
PProtocol unreachable.
QSource quench.
RFragment reassembly time exceeded
SSource route failed.
UPort unreachable.
telnet
The telnet EXEC mode command enables logging on to a host that supports
Te ln e t.
Syntax
telnet {
ip-address
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
ip-address—Specifies the destination host IP address.
•
hostname—Specifies the destination host name. (Length: 1-160
characters. Maximum label length: 63 characters.)
•
port—Specifies the decimal TCP port number or one of the keywords
listed in the Ports table in the User Guidelines.
•
keyword
—Specifies the one or more keywords listed in the Keywords table
in the User Guidelines.
Default Configuration
The default port is the Telnet port (23) on the host.
By default, Telnet is enabled.
Command Mode
EXEC mode
User Guidelines
Telnet software supports special Telnet commands in the form of Telnet
sequences that map generic terminal control functions to operating systemspecific functions. To enter a Telnet sequence, press the escape sequence keys
(Ctrl-shift-6) followed by a Telnet command character.
Special Telnet Sequences
Telnet SequencePurpose
Ctrl-shift-6-bBreak
Ctrl-shift-6-cInterrupt Process (IP)
Ctrl-shift-6-hErase Character (EC)
Ctrl-shift-6-oAbort Output (AO)
Ctrl-shift-6-tAre You There? (AYT)
Ctrl-shift-6-uErase Line (EL)
At any time during an active Telnet session, available Telnet commands can
be listed by pressing the Ctrl-shift-6-? keys at the system prompt.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
A sample of this list follows. Note that the Ctrl-shift-6 sequence appears as
^^ on the screen.
Console> ‘Ctrl-shift-6’ ?
[Special telnet escape help]
^^ B sends telnet BREAK
^^ C sends telnet IP
^^ H sends telnet EC
^^ O sends telnet AO
^^ T sends telnet AYT
^^ U sends telnet EL
Ctrl-shift-6 x suspends the session (return to system
command prompt)
Several concurrent Telnet sessions can be opened, enabling switching
between the sessions. To open a subsequent session, the current connection
has to be suspended by pressing the escape sequence keys (Ctrl-shift-6) and x
to return to the system command prompt. Then open a new connection with
the telnet EXEC mode command.
This command lists concurrent Telnet connections to remote hosts that were
opened by the current Telnet session to the local device. It does not list Telnet
connections to remote hosts that were opened by other Telnet sessions.
Keywords Table
OptionsDescription
/echoEnables local echo.
/quiet Prevents onscreen display of all messages from
the software.
/source-interfaceSpecifies the source interface.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
OptionsDescription
/streamTurns on stream processing, which enables a raw
Ctrl-shift-6 xReturns to the System Command Prompt.
CLI\files\System_Management.fm
TCP stream with no Telnet control sequences. A
stream connection does not process Telnet options
and can be appropriate for connections to ports
running UNIX-to-UNIX Copy Program (UUCP) and
other non-Telnet protocols.
Ports Table
KeywordDescriptionPort Number
BGPBorde r G a te wa y Prot o co l179
chargenCharacter generator19
cmdRemote commands514
daytimeDaytime13
discardDiscard9
domainDomain Name Service53
echoEcho7
execExec512
fingerFinger79
ftpFile Transfer Protocol21
ftp-dataFTP data connections20
gopherGopher70
hostnameNIC hostname server101
identIdent Protocol113
ircInternet Relay Cha t 194
kloginKerberos login543
kshellKerberos shell544
loginLogin513
lpdPrinter service515
nntpNetwork News Transport Protocol119
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The default connection number is that of the most recent connection.
Command Mode
EXEC mode
Example
The following command switches to open Telnet session number 1.
Console>
resume
1
hostname
The hostname Global Configuration mode command specifies or modifies
the device host name. Use the no form of the command to remove the
existing host name.
Syntax
hostname
no hostname
Parameters
Name—specifies The Device Host Name. (Length: 1-160 Characters.
Maximum label length: 63 characters.)
Default Configuration
No host name is defined.
Command Mode
Global Configuration mode
Example
The following example specifies the device host name as ‘enterprise’.
name
Console(config)#
enterprise(config)#
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The reload Privileged EXEC mode command reloads the operating system.
Syntax
reload [slot
Command Mode
Privileged EXEC mode
Parameters
stack-member-number —Specifies the new master unit number. (Range:
1–8). If unspecified, reloads all the units.
Example
The following example reloads the operating system on all units.
stack-member-number]
Console#
This command will reset the whole system and disconnect your
current session. Do you want to continue? (y/n) [n]
reload
stack master
The stack master Global Configuration mode command forces a stack master
selection. Use the no form of this command to restore the default
configuration.
Syntax
stack master unit
no stack master
Parameters
unit —Specifies the new master unit number. (Range: 1–2)
Default Configuration
The default is no forced master.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Unit 1:
MAC address: 00:00:b0:87:12:11
Master: Forced.
Product: Fonseca 48. Sof tw ar e : 3. 30
Uplink unit: 8. Downlink unit: 2.
Status: Master
Active image: image-1.
Selected for next boot: im ag e -2 .
show switch
1
service cpu-utilization
The service cpu-utilization Global Configuration mode command enables
measuring CPU utilization. Use the no form of this command to restore the
default configuration.
Syntax
service cpu-utilization
no service cpu-utilization
Default Configuration
Measuring CPU utilization is enabled.
Command Mode
Global Configuration mode
User Guidelines
Use the show cpu utilization Privileged EXEC command to view information
on CPU utilization.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The following example clears the CPU traffic counters.
Console#
clear cpu counters
service cpu-counters
The service cpu-counters Global Configuration mode command enables
traffic counting to and from the CPU. To disable counting, use the no form of
this command.
Syntax
service cpu-counters
no service cpu-counters
Command Mode
Global Configuration mode
User Guidelines
Use the show cpu counters command to display the CPU traffic counters.
Example
The following example enables counting CPU traffic.
Console(config)#
service cpu-counters
show cpu counters
The show cpu counters EXEC mode command displays traffic counter
information to and from the CPU.
Syntax
show cpu counters
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
The following example displays information about the active users.
Console#
Username
---------Bob
John
Robert
Betty
Sam
show users
Protocol
----------Serial
SSH
HTTP
Telnet
Location
------------
172.16.0.1
172.16.0.8
172.16.1.7
172.16.1.6
show sessions
The show sessions EXEC mode command displays open Telnet sessions.
Syntax
show sessions
Command Mode
EXEC mode
User Guidelines
The command displays Telnet sessions to remote hosts opened by the current
Telnet session to the local device. It does not display Telnet sessions to
remote hosts opened by other Telnet sessions to the local device.
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
console# show system unit 2
System Type: PowerConnect 5548
System Up Time (days,hour:min:sec): 08,23:03:46
System Contact:
System Name:
System Location:
System MAC Address: 00:99:88:66:33:33
System Object ID: 1.3.6.1.4.1.674.10895.3031
Type: PowerConnect 5548
Main Power Supply Status: OK
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
------------- ------------------- ------------ 2 42 OK
CLI\files\System_Management.fm
show version
The show version EXEC mode command displays system version
information.
Syntax
show version [unit
Parameters
unit
unit
—Specifies the unit number. (Range: 1–8)
Command Mode
EXEC mode
Example
The following example displays system version information.
unit
]
console >
Unit
---------------------------------------
1 3.1312.1781.0.0
2
show version
SW Version Boot Version HW Version
3.1312.1781.0.0
system resources routing
The system resources routing Global Configuration mode command
configures the routing table maximum size. Use the no form of this
command to return to the default size.
Syntax
system resources routing
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Use the show system defaults command to display system defaults.
Syntax
show system defaults [
Parameters
section—Show information for specific session only. Available values are:
management, 802.1x, port, fdb, port-mirroring, spanning-tree, vlan, voicevlan, ip-addressing, network-security and qos-acl.
Command Mode
EXEC mode
Examples
console# show system defaults
System Mode: Router
Maximum units in stack: 8
# Management defaults
Telnet: Enabled (Maximum 4 sessions, shared with SSH)
SSH: Enabled (Maximum 4 sessions, shared with Telnet)
HTTP: Enabled, port 80 (Maximum 27 sessions)
HTTPS: Disabled
SNMP: Enabled.
User: first
SNMP version: V3
SNMP Local Engine ID: 0000000001
SNMP Notifications: Enabled
SNMP Authentication Notifications: Enabled
Console: Enabled.
Cryptographic keys are not generated
HTTPS certificate is not generated
Management ACL: No ACL is defined
AAA Telnet authentication login: Local user data base
section
]
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
AAA HTTP authentication login: Local data base
AAA HTTPS authentication login: Local data base
Radius accounting: Disabled
Radius: No server is defined
Tacacs: No server is defined
Syslog: No server is defined
Logging: Enabled
Logging to console: Informational messages
Logging to internal buffer: Informational messages
Logging to file: Error messages
Logging to remote server: Informational messages
Maximum no. of syslog messages: 200
SNTP: supported
SNTP Port No.: 123
SNTP Interface: Enabled
IP Domain Naming System: Enabled
DHCP Server: Enabled
DHCP Auto Configuration: Enabled
DHCP Option 67: Enabled
DHCP Option 82: Disabled
CLI\files\System_Management.fm
# IPv6 defaults
# 802.1x defaults
802.1X is disabled
Mode: Multiple host
Guest VLAN: Not defined
# Interface defaults in present unit
48 GE regular
2 10G fiberOptics
PoE: Enabled
POE mode: Port Limit
Duplex: Full
Negotiation: Enabled
Flow control: Off
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY
Mdix mode: auto
LAGs: No LAG is defined
Storm control: Disabled
Storm control mode: unknown unicast, broadcast, multicast
Port security: Disabled
LLDP: Enabled
LLDPDU Handeling: Filtering
Jumbo frames: Disabled
Port-Channel Load Balancing: Layer 2
# Bridging defaults
Maximum 16K entries
Aging time: 5 minutes
iSCSI: Enabled
iSCSI cos: 5, with no remark
# Port monitoring defaults
Port monitor is not defined
Maximum source port: 4
Maximum destination ports for mirroring: 2
# Spanning tree defaults
Spanning tree is Enabled
Spanning tree mode is Classic
Spanning tree interface: Enabled
Port fast: Disabled
BPDU handling: Filtering
BPDU Guard: Disabled
# Vlan defaults
DELL CONFIDENTIAL – PRELIMINARY 10/21/13 - FOR PROOF ONLY