EXPEDITION COMMON Command Line Interface Reference Manual
EXPEDITION COMMON Command Line Interface Reference Manual
Reference Manual
9033603-03
NOTICE
Enterasys Networks reserves the right to make changes in specifications and other information contained in this document
and its web site without prior notice. The reader should in all cases consult Enterasys Networks to determine whether any
such changes have been made.
The hardware, firmware, or software described in this document is subject to change without notice.
IN NO EVENT SHALL ENTERASYS NETWORKS BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR
CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR
RELATED TO THIS DOCUMENT, WEB SITE, OR THE INFORMATION CONTAINED IN THEM, EVEN IF ENTERASYS
NETWORKS HAS BEEN ADVISED OF, KNEW OF, OR SHOULD HAVE KNOWN OF, THE POSSIBILITY OF SUCH DAMAGES.
ENTERASYS NETWORKS, NETSIGHT, LANVIEW, and any logos associated therewith, are trademarks or
registered trademarks of Enterasys Networks, Inc. in the United States and other countries.
All other product names mentioned in this manual may be trademarks or registered trademarks of their respective companies.
ENTERASYS NETWORKS, INC.
PROGRAM LICENSE AGREEMENT
BEFORE OPENING OR UTILIZING THE ENCLOSED PRODUCT,
CAREFULLY READ THIS LICENSE AGREEMENT.
This document is an agreement (“Agreement”) between the end user (“You”) and Enterasys Networks, Inc. on behalf of itself
and its Affiliates (as hereinafter defined) (“Enterasys”) that sets forth Your rights and obligations with respect to the Enterasys
software program (including any accompanying documentation, hardware or media) (“Program”) in the package and prevails
over any additional, conflicting or inconsistent terms and conditions appearing on any purchase order or other document
submitted by You. “Affiliate” means any person, partnership, corporation, limited liability company, or other form of
enterprise that directly or indirectly through one or more intermediaries, controls, or is controlled by, or is under common
control with the party specified. This Agreement constitutes the entire understanding between the parties, and supersedes all
prior discussions, representations, understandings or agreements, whether oral or in writing, between the parties with respect
to the subject matter of this Agreement. The Program may be contained in firmware, chips or other media.
BY INSTALLING OR OTHERWISE USING THE PROGRAM, YOU REPRESENT THAT YOU ARE AUTHORIZED TO
ACCEPT THESE TERMS ON BEHALF OF THE END USER (IF THE END USER IS AN ENTITY ON WHOSE BEHALF
YOU ARE AUTHORIZED TO ACT, “YOU” AND “YOUR” SHALL BE DEEMED TO REFER TO SUCH ENTITY) AND
THAT YOU AGREE THAT YOU ARE BOUND BY THE TERMS OF THIS AGREEMENT, WHICH INCLUDES,
AMONG OTHER PROVISIONS, THE LICENSE, THE DISCLAIMER OF WARRANTY AND THE LIMITATION OF
LIABILITY. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT OR ARE NOT AUTHORIZED TO
ENTER INTO THIS AGREEMENT, ENTERASYS IS UNWILLING TO LICENSE THE PROGRAM TO YOU AND YOU
AGREE TO RETURN THE UNOPENED PRODUCT TO ENTERASYS OR YOUR DEALER, IF ANY, WITHIN TEN (10)
DAYS FOLLOWING THE DATE OF RECEIPT FOR A FULL REFUND.
IF YOU HAVE ANY QUESTIONS ABOUT THIS AGREEMENT, CONTACT ENTERASYS NETWORKS, LEGAL
DEPARTMENT AT (978) 684-1000.
You and Enterasys agree as follows:
1. LICENSE. You have the non-exclusive and non-transferable right to use only the one (1) copy of the Program provided
in this package subject to the terms and conditions of this Agreement.
2. RESTRICTIONS. Except as otherwise authorized in writing by Enterasys, You may not, nor may You permit any third
party to:
(i) Reverse engineer, decompile, disassemble or modify the Program, in whole or in part, including for reasons of error
correction or interoperability, except to the extent expressly permitted by applicable law and to the extent the parties
shall not be permitted by that applicable law, such rights are expressly excluded. Information necessary to achieve
interoperability or correct errors is available from Enterasys upon request and upon payment of Enterasys’
applicable fee.
(ii) Incorporate the Program, in whole or in part, in any other product or create derivative works based on the Program,
in whole or in part.
(iii) Publish, disclose, copy, reproduce or transmit the Program, in whole or in part.
(iv) Assign, sell, license, sublicense, rent, lease, encumber by way of security interest, pledge or otherwise transfer the
Program, in whole or in part.
(v) Remove any copyright, trademark, proprietary rights, disclaimer or warning notice included on or embedded in any
part of the Program.
3. APPLICABLE LAW. This Agreement shall be interpreted and governed under the laws and in the state and federal
courts of the Commonwealth of Massachusetts without regard to its conflicts of laws provisions. You accept the personal
jurisdiction and venue of the Commonwealth of Massachusetts courts. None of the 1980 United Nations Convention on
Contracts for the International Sale of Goods, the United Nations Convention on the Limitation Period in the International Sale
of Goods, and the Uniform Computer Information Transactions Act shall apply to this Agreement.
4. EXPORT RESTRICTIONS. You understand that Enterasys and its Affiliates are subject to regulation by agencies of
the U.S. Government, including the U.S. Department of Commerce, which prohibit export or diversion of certain technical
products to certain countries, unless a license to export the Program is obtained from the U.S. Government or an exception
from obtaining such license may be relied upon by the exporting party.
This manual provides reference information for the commands in the Enterasys X-
Pedition Command Line Interface (CLI). For product information not available in this
manual, see the manuals listed in Related Documentation on page 2.
What’s New?
The content of this manual includes the addition of new and extended capabilities for the following:
DHCP
enable Command on page 71. To find information about the show file command, go to file
Commands on page 79, then locate the description of the show file command within that
chapter.
Related Documentation
The X-Pedition documentation set includes the following items. Refer to these other
documents to learn more about your product.
Getting Help
For additional support related to the Common CLI syntax or this document, contact
Enterasys Networks using one of the following methods:
Before contacting Enterasys Networks for technical support, have the following
information ready:
• Your Enterasys Networks service contract number
• A description of any action(s) already taken to resolve the problem (e.g., changing mode
switches, rebooting the unit, etc.)
• The serial and revision numbers of all involved Enterasys Networks products in the network
• Network load and frame size at the time of trouble (if known)
• The device history (i.e., have you returned the device before, is this a recurring problem, etc.)
The Enterasys X-Pedition firmware is designed to move easily between Native and
Common CLI syntax.The following information instructs the user on maneuvering back
and forth between these syntaxes.
This command will switch the X-Pedition over to Common CLI syntax.
This command will return the X-Pedition CLI to the Native syntax. For more information
on Privileged mode, please see enable Command on page 71. For more information on the
terminal cli native command, see terminal cli native Command on page 357
Note: The current CLI syntax is saved in the system NVRAM. This means that if the
user reboots the X-Pedition while in Native CLI syntax, it will start up in Native
CLI syntax; likewise, if the X-Pedition is rebooted while in Common CLI syntax,
it will start up in Common CLI syntax.
Chapter 1
access-list Commands
The access-list commands allow the user to clear ACL (Access Control List) counters and
display those Access Control Lists currently configured on the X-Pedition
Command Summary
Table 1 lists the access-list commands. The sections following the table describe the
command syntax.
Purpose
Clears one or all ACL counters.
Format
clear access-list counters <num>|<name>
Mode
Enable
Description
The clear access-list counters command allows the user to clear Access Control List
counters.With ACL logging enabled, the router prints out a message verifying whether a
packet is forwarded or dropped, and counters record these statistics. With this command,
the user can clear the ACL counters.
Parameters
<num> Clears counter based on the ACL number.
Restrictions
None.
Example
To clear counters for Access Control List 100:
show access-lists
Purpose
Displays one or more ACLs.
Format
show access-lists [<num>|<string>|{interface <string>|all-ip}|service|{port <port-
list>|all-ports}]
Mode
Enable
Description
The show access-lists command allows the user to display currently configured Access
Control Lists. The parameters associated with this command further allow the user to sort
and display ACLs by name, interface, port, or service type.
Parameters
<num> Specifies ACL number.
Restrictions
None.
Chapter 2
aging Commands
The aging commands control aging of learned MAC address entries in the X-Pedition’s
L2 lookup tables or layer3/4 flows. Using the aging commands, you can show L2 or layer
3/4 aging information, set or disable L2 aging on specific ports, set or disable aging of
layer 3/4 flows, or set or disable NAT or LSNAT flows.
Command Summary
Table 2 lists the l2 and l3 aging commands. The sections following the table describe the
command syntax.
Purpose
Shows the L2 aging status for SwitchRouter ports.
Format
show mac-address-table aging-time
Mode
User
Description
The show mac-address-table aging-time command shows whether L2 aging is enabled
or disabled on SwitchRouter ports. For ports on which L2 aging is enabled, this command
also shows the aging time.
Parameters
None.
Restrictions
None.
Purpose
Shows the L3 aging status for X-Pedition ports.
Format
show mls aging
Mode
User
Description
The show mls aging command shows whether L3/4 aging is enabled or disabled on X-
Pedition ports. For ports on which L3/4 aging is enabled, this command also shows the
aging time.
Parameters
None.
Restrictions
None.
Example
To show whether layer 3/4 aging is enabled and the aging time for enabled ports:
Chapter 3
arp Commands
The arp commands enable you to add, display, and clear Address Resolution Protocol
(ARP) entries on the X-Pedition.
Command Summary
Table 3 lists the arp commands. The sections following the table describe the command
syntax.
arp add <host> mac-addr <MAC-addr> exit port <port> keep time <seconds>
arp clear <host> mac-addr <MAC-addr> exit port <port> keep time <seconds>
arp show <IPaddr>|all [undecoded] [unresolved] [interface <string>|all] [port
<port>]
show arp statistics <IFname>
arp add
Purpose
Adds an ARP entry.
Format
arp add <host> mac-addr <MAC-addr> exit-port <port> keep-time <seconds>
Mode
Privileged
Description
The arp add command allows the user to manually add ARP entries to the ARP table.
Typically, the X-Pedition creates ARP entries dynamically. Using the arp add command,
you can create an ARP entry to last a specific amount of time. If the exit port is not
specified, then packets to the IP address for which the ARP entry is created are transmitted
on all ports of the interface. If an ARP request is received from the host for which the ARP
entry was created, then the exit port is updated with the port on which the ARP request
was received, so that subsequent packets are transmitted on one port only.
Parameters
<host> Hostname or IP address of this ARP entry.
mac-addr <MAC-addr>MAC address of the host.
exit-port <port> The port for which you are adding the entry. Specify the port to
which the host is connected.
keep-time <seconds> The number of seconds this ARP entry should remain in the ARP
table. A value of 0 means this is a permanent ARP entry.
Restrictions
None.
Examples
To create an ARP entry for the IP address 10.8.1.2 at port et.4.7 for 15 seconds:
arp clear
Purpose
Removes an ARP entry from the ARP table.
Format
arp clear <host> mac-addr <MAC-addr> exit-port <port> keep-time <seconds>
Mode
Privileged
Description
The arp clear command lets you manually remove entries from the ARP table. The
command can remove both dynamic and permanent entries.
Parameters
<host> Hostname or IP address of the ARP entry to remove.
mac-addr <MAC-addr> MAC address of the host.
exit-port <port> The port for which you are clearing the entry. Specify the port
to which the host is connected.
keep-time <seconds> The number of seconds this ARP entry should remain in the
ARP table. A value of 0 means this is a permanent ARP entry.
Examples
To remove the ARP for the host 10.8.1.2 from the ARP table:.
arp show
Purpose
Displays the ARP table.
Format
arp show <IPaddr>|all [undecoded] [unresolved] [interface <string>| all] [port
<port>]
Mode
Privileged
Description
The arp show command displays the entire ARP table.
Parameters
<IPaddr> Shows the ARP entry for the specified IP address.
all Shows all entries in the ARP table.
undecoded Specify this optional parameter to show MAC addresses in hexadecimal
format.
unresolved Specify this optional parameter to show only MAC addresses in the ARP
table that have yet to be mapped to an network layer address.
interface Specify this optional parameter to show only addresses in the ARP table
that is associated with the specific interface.
<string> Specifies the interface name.
all Specifies all interfaces.
port Specify this optional parameter to show only addresses in the ARP table
that corresponds to a specific exit port.
<port> Specifies the exit port.
Purpose
Displays ARP statistics.
Format
show arp statistics <IFname>
Mode
Privileged
Description
The show arp statistics command displays ARP statistics, such as the total number of
ARP requests and replies.
Parameters
<IFname> Displays ARP statistics for the specified interface. Failing to specify an
interface will result in the display of ARP statistics for all interfaces.
Example
To display ARP statistics on interface ‘en0’:
Interface en0:
1 requests sent
19 replies sent
0 proxy replies sent
Last 5 Requests Sent
----- no arp requests sent -----
Last 5 Replies Sent
134.141.179.129 | Yago 16:BF:21 |2000-04-17 13:12:49
134.141.179.129 | Yago 16:BF:21 |2000-04-17 13:50:15
134.141.179.129 | Yago 16:BF:21 |2000-04-17 15:32:32
134.141.179.129 | Yago 16:BF:21 |2000-04-17 16:17:19
134.141.179.129 | Yago 16:BF:21 |2000-04-17 11:12:44
• requests sent Displays how many ARP requests have been sent
out to an ARP server for address resolution.
• replies sent Displays how many ARP replies have been sent
out to an ARP client in response to request
packets.
• proxy replies sent Displays how many proxy ARP replies have been
sent out in response to request packets. A proxy
router serving as a gateway to a subnet would
respond with a proxy reply.
• Last 5 Requests sent Displays the last five ARP requests sent,
including the following information: target MAC
address, date and time sent.
• Last 5 Replies sent Displays the last five ARP replies sent, including
the following information: target IP address, date
and time sent.
atm Command
The show atm command displays information specific to an Asynchronus Transfer Mode
(ATM) port.
Format
show atm [vpl port <port-list>] [vcl port <port-list>] [service <string>| all] [port-
settings <port-list>| all-ports]
Parameters
<port list> Is the port name, in the format: media.slot.port.vpi.vci
media Is the media type. This is at for an ATM port.
slot Is the slot number where the module is installed.
port Is the number of the port through which data is passing.
vpi Is the Virtual Path Identifier.
vci Is the Virtual Channel Identifier.
port-settings Shows the characteristics of an ATM port that were set by the port set
command. Specify all-ports to show characteristics of all ATM ports.
service Shows all defined ATM service profiles. Specify all to show all ATM
service profiles.
vcl port Shows VCL configurations on a port.
Specify at.slot.port to display all VCLs configured on the port.
Specify at.slot.port.vpl to display all VCLs for the specified VPL
configured on the port.
Specify at.slot.port.vpl.vcl to display only the specified VCL configured
on the port.
Restrictions
None.
Examples
To display information about the VPL configurations on ATM port 1:
• Last State Change Shows the last time the VP went up or down.
Time is in seconds relative to system bootup.
• Service Definition Shows the name of the defined service and its
traffic parameters
ubr-default
Service Class: UBR
Peak Bit Rate: Best Effort
Sustained Bit Rate: 0 Kbits/sec (0 cps)
Maximum Burst Size: 0 cells
Encapsulation Type: Routed LLC
F5-OAM: Responses Only
• Sustained Bit Rate Shows the average bit transmission rate (in
kilobits per second).
• Maximum Burst Size Shows how many cells can be transmitted at the
Peak Bit Rate.
• Port Type Shows the type of PHY interface for the port.
• Xmt Clock Source Shows the timing source for the port.
Local indicates the on board clock oscillator as
the timing source.
Loop indicates the receiver input as the timing
source.
• Service Definition Shows the name of the defined service on the port
and its traffic parameters.
Chapter 5
bgp Commands
The bgp commands let you display and set parameters for the Border Gateway Protocol
(BGP).
Command Summary
Table 4 lists the bgp commands. The sections following the table describe the command
syntax.
show ip bgp
Purpose
Displays entries in the BGP routing table.
Format
show ip bgp [<IPaddr><IPmask>] [to-file]
Mode
Privileged
Description
The show ip bgp command displays the IP address/netmask, next hop, and AS path for
each BGP route.
Parameters
<IPaddr><IPmask> Displays information about the specified route.
to-file Causes output to be saved in the file /gatedtrc/gated.dmp.
Restrictions
None.
Example
To display the BGP routing table:
Purpose
Displays routes in the BGP routing table with CIDR network masks.
Format
show ip bgp cidr-only [<IPaddr><IPmask>] [to-file]
Mode
Privileged
Description
The bgp show cidr-only command displays the same type of route information as the
show ip bgp command. The difference is that the show ip bgp cidr-only command limits
the display to CIDR routes only.
Parameters
<IPaddr><IPmask> Displays information about the specified CIDR route.
to-file Causes output to be saved in the file /gatedtrc/gated.dmp.
Restrictions
None.
Example
To display information all CIDR routes in the X-Pedition’s BGP route table:
Purpose
Displays routes that belong to a specified community.
Format
show ip bgp community {<community-id> <as-num>|no-export|no-advertise|no-
export-subconfed|reserved-community <hex-number>} [to-file]
Mode
Privileged
Description
The show ip bgp community command displays routes that belong to a specified
community in a specified autonomous system.
Parameters
<community-id>
This is the community identifier portion of a community split. It combines with the
autonomous-system value entered to create a value for the community attribute.
<as-num>
This is an autonomous system number.
no-export
This is a special community. It indicates the routes associated with this attribute must
not be advertised outside a BGP confederation boundary. Since the X-Pedition’s
implementation does not support confederations, this boundary is an AS boundary.
no-advertise
This is a special community. It indicates that the routes associated with this attribute
must not be advertised to other BGP peers.
no-export-subconfed
This is a special community. It indicates the routes associated with this attribute must
not be advertised to external BGP peers. (This includes peers in other members’
autonomous systems inside a BGP confederation.)
reserved-community <hex-number>
This option specifies one of the reserved communities not mentioned above. A
Restrictions
None.
Example
To display routes that belong to community 160 in AS 64900:
Purpose
Displays status information about BGP peer hosts.
Format
show ip bgp neighbor <IPaddr> received-routes|all-received-routes|advertised-routes
[to-file]
Mode
Privileged
Description
The show ip bgp neighbor command displays information related to a specified BGP
peer host. Two types of information can be displayed: routes received and accepted from a
BGP peer host, and all routes the X-Pedition has advertised to a peer host.
Parameters
<IPaddr> Specifies the IP address of a BGP peer host
received-routes Displays valid BGP routes received and accepted from the
specified peer host
all-received-routes Displays all valid BGP routes.
advertised-routes Displays all routes the X-Pedition has advertised to the specified
peer host.
to-file Causes output to be saved in the file /gatedtrc/gated.dmp.
Restrictions
None.
Examples
To display all valid BGP routes received and accepted from peer host 172.16.20.2:
Displays all routes the X-Pedition has advertised to peer host 172.16.20.2:
Purpose
Displays BGP Autonomous System (AS) path information.
Format
show ip bgp paths <ASpath> [to-file]
Mode
Privileged
Description
The show ip bgp paths command displays information about a specified AS path or all
AS paths. The AS path is listed along with the number of routes that use it.
Parameters
<ASpath> Will display information about the specified AS path.
to-file Causes output to be saved in the file /gatedtrc/gated.dmp.
Restrictions
None.
Example
To display information about all AS paths:
Purpose
Displays information about TCP and BGP connections to an Autonomous System.
Format
show ip bgp peer-as <ASnum> [to-file]
Mode
Privileged
Description
The show ip bgp peer-as command displays information about routers in a specified
autonomous system that are peered with the X-Pedition.
Parameters
<ASnum> The AS number of a peer autonomous system.
to-file Causes output to be saved in the file /gatedtrc/gated.dmp.
Restrictions
None.
Example
To display information about TCP and BGP connections to autonomous system 64901:
Purpose
Displays status information about BGP peers by group.
Format
show ip bgp peer-group external|internal|igp|routing [to-file]
Mode
Enable
Description
The show ip bgp peer-group command displays status information about BGP peers
according to their group.
Parameters
external Displays status information about external peers.
internal Displays status information about internal peers.
igp Displays status information about igp peers.
routing Displays status information about routing peers.
to-file Causes output to be saved in the file /gatedtrc/gated.dmp.
Restrictions
None.
Example
To display status information about external peers:
Purpose
Displays the BGP routes matching the AS path regular expression.
Format
show ip bgp regexp <exp>
Mode
Privileged
Description
The show ip bgp regexp command searches through all BGP routes that contain specified
keywords belonging to an AS path. These specified keywords are the AS path regular
expression upon which the search is executed. The expression string can be a combination
of AS numbers or names.
Some BGP character string shorthand conventions:
. Matches any AS number
* Zero or more repetitions
+ One or more repetitions
? Zero or one repetition
| Alternation
() Parentheses group subexpressions
Parameters
<exp> A string specifying the regular expression. Specify an AS.
Restrictions
None.
Example
To display the BGP routes starting with “64751”:
Purpose
Displays the status of all BGP connections.
Format
show ip bgp summary [to-file]
Mode
Privileged
Description
The show ip bgp summary command displays the status of all BGP peers of the X-
Pedition.
Parameters
to-file Causes output to be saved in the file /gatedtrc/gated.dmp.
Restrictions
None.
Example
To display the status of all BGP connections:
Purpose
Displays the BGP synchronization tree.
Format
show ip bgp sync-tree
Mode
Privileged
Description
The show ip bgp sync-tree command displays the BGP synchronization tree. The
synchronization tree is used by IBGP peers to resolve the next hop (forwarding address). It
gives information about routes that are orphaned because the next hop could not be
resolved.
Parameters
None.
Restrictions
None.
Examples
The following example shows the next hops for some of the routes that are not resolved
(by showing orphaned routes):
The following example shows the next hop for all the routes that are resolved.:
Chapter 6
cli Commands
The cli commands allow you to change the behavior of the Command Line Interface (CLI)
in terms of command completion and command history recall.
Command Summary
Table 5 lists the cli commands. The sections following the table describe the command
syntax.
show history
show terminal
terminal command-completion on|off
terminal history <buffer-size>
terminal length <screen-length>
terminal width <line-length>
terminal monitor
show history
Purpose
Displays the command history from the current CLI session.
Format
show history
Mode
User
Description
The show history command shows the commands you have issued during the current CLI
session. A number is associated with each command. A command’s number is useful for
re-entering, modifying, or negating the command.
Note: You also can perform a command history recall by entering !* at any command
prompt.
Parameters
None.
Restrictions
None.
show terminal
Purpose
Displays information about the current terminal settings.
Format
show terminal
Mode
User
Description
The show terminal command shows information about the terminal settings. The terminal
settings affect the display characteristics of your CLI session.
Parameters
None.
Restrictions
None.
Purpose
Turns on or off command completion support.
Format
terminal command completion on|off
Mode
User
Description
The terminal command completion command lets you enable or disable command
completion support. This command affects only the user’s current login session.
Parameters
on Turns on command completion.
off Turns off command completion.
Restrictions
None.
Purpose
Modifies command history recall characteristics.
Format
terminal history size buffer-size
Mode
User
Description
The terminal history size command lets you to set the size of the command history
buffer. Each command stored in this buffer can be recalled without having the user type in
the same, complete command again. By setting the size of this history buffer, one tells the
router how many of the most recently executed commands should be stored. When the
buffer is full, the oldest command is pushed out to make space for the newest command.
This command affects only the user’s current login session.
Parameters
<buffer-size> A number specifying how many of the most recently executed commands
should be kept. To disable history support, specify a size of 0.
Restrictions
None.
Examples
To set the history buffer size to 100 commands:
terminal length
Purpose
Modifies terminal screen’s column settings for the current session.
Format
terminal length <screen-length>
Mode
User
Description
The terminal length command lets you modify the terminal screen’s column size for the
current session.
Parameters
<screen-length> Number of columns for your terminal. Enter a number between 0-
512.
Restrictions
None.
Example
To set the number of columns to 100 lines:
terminal width
Purpose
Modify terminal screen’s row settings for current session.
Format
terminal width <line-length>
Mode
User
Description
The terminal width command allows you to modify the terminal screen’s row settings for
the current session. Specifying the number of rows available on your terminal causes the
system to automatically pause when screen output fills the entire screen.
Parameters
<line-length> Number of rows for your terminal. Enter a number between 0-512. To
prevent output from pausing after screen fills, set the value to 0.
Restrictions
None.
Examples
To set the number of rows to 100 lines:
terminal monitor
Purpose
Allows the current CLI session to receive or not receive console output.
Format
terminal monitor
Mode
Privileged
Description
Some system messages are normally only sent to the management console. The terminal
monitor command allows the current CLI session to also receive those messages. This
command is useful only if you have a current Telnet CLI session and you want the
debugging output that is normally sent to the management console to also be displayed on
the Telnet session.
Parameters
None.
Restrictions
None.
Chapter 7
copy Commands
Command Summary
Table 6 lists the copy commands. The sections following the table describe the command
syntax.
copy tftp| rcp| active| scratchpad| startup| <filename> tftp| rcp| active| scratchpad|
startup| <filename>
copy tftp flash
copy tftp
Purpose
Copy configuration information or files.
Format
copy tftp| rcp| active| scratchpad| startup| <filename> tftp| rcp| active| scratchpad|
startup| <filename>
Mode
Privileged
Description
The copy command is primarily for transferring configuration information. You can copy
configuration information between the X-Pedition and external hosts using protocols such
as TFTP or RCP. Within the X-Pedition, you can copy configuration information between
the X-Pedition file system, the scratchpad (configuration database), the active (running)
configuration or the Startup configuration. You also can use the copy command to make
backup copies of a configuration file.
If the X-Pedition has two Control Modules, you can copy the startup configuration of the
primary Control Module to the secondary Control Module.
Parameters
tftp Downloads or uploads a file on a TFTP server.
rcp Downloads or uploads a file on an RCP server.
active Specifies information from the active configuration database (the running
system configuration).
scratchpad Specifies configuration changes from the scratchpad.
startup Copies the Startup configuration information stored in the Control Module’s
NVRAM.
<filename> Specifies the name of a file on the X-Pedition’s local file system (NVRAM
or PCMCIA card).
Restrictions
The X-Pedition does not allow some combinations of source and destination pair.
Typically, you cannot have the same location for both source and destination; for example,
you cannot copy from one TFTP server directly to another TFTP server or copy from
scratchpad to scratchpad.
In addition, you cannot copy directly into the active configuration from anywhere except
the scratchpad. All changes to the running system must come through the scratchpad.
Examples
To copy configuration information from the scratchpad to the active database, enter the
following command. This command activates all the uncommitted changes, thus
immediately placing the changes into effect.
To copy the Startup configuration to a TFTP server for backup purposes, enter the
following command. The CLI prompts for the TFTP server’s IP address or hostname and
the filename:
To copy a previously saved configuration from a TFTP server to the Startup configuration,
enter the following command. Note the use of an URL to specify the TFTP server and the
filename.
To copy the active configuration to a remote server using RCP, enter the following
command. Notice that in this example a URL specifies the RCP user name, server, and
filename.
Purpose
Copies a system software image to the X-Pedition.
Format
copy tftp flash
Mode
Privileged
Description
The copy tftp flash command copies a system software image from a TFTP server into
the PCMCIA flash card on the Control Module. By default, if the X-Pedition has two
Control Modules, the system software image is copied to both Control Modules.
Parameters
None. The X-Pedition will prompt for information as needed.
Restrictions
None.
Chapter 8
dhcp Commands
The dhcp commands allow the user to display and clear scopes (sets of IP address pools
and network parameters) that are to be used by Dynamic Host Configuration Protocol
(DHCP) clients and apply them to interfaces on the X-Pedition.
Command Summary
Table 7 lists the dhcp commands. The sections following the table describe the command
syntax.
Format
dhcp show binding [active| expired| static]
Mode
Privileged
Description
The dhcp show binding command displays information from the lease database. If you do
not specify any parameters, the DHCP server displays the entire lease database.
Parameters
active Displays leases that are currently active.
expired Displays expired leases.
static Displays leases with static IP address assignments.
Restrictions
None.
Examples
To display information from the lease database:
Format
dhcp show num-clients
Mode
Privileged
Description
This dhcp show num-clients command displays the number of allocated bindings for the
DHCP server and the maximum number allowed.
Parameters
None.
Restrictions
None.
Examples
To display information:
Chapter 9
dvmrp Commands
The dvmrp commands allow the user to display information about Distance Vector
Multicast Routing Protocol (DVMRP) interfaces.
Command Summary
Table 8 lists the dvmrp commands. The sections following the table describe the command
syntax.
Purpose
Displays DVMRP interfaces.
Format
show ip dvmrp interface [<IPaddr>]
Mode
Privileged
Description
The show ip dvmrp interface command displays the state of an interface running
DVMRP, along with other neighbor-related information. Neighbors are displayed with
their DVMRP version and capability flags and Generation IDs; this information can help
in debugging. If rules are in effect for an interface, they are indicated by ExportPol or the
ImportPol flags.
Parameters
<IPaddr> Displays DVMRP information for the specified interface.
Restrictions
None.
Examples
Here is an example of the show ip dvmrp interface command.
Purpose
Displays DVMRP unicast routing table.
Format
show ip dvmrp route [<type> <slot/port> <IPaddr>]
Mode
Privileged
Description
The show ip dvmrp route command displays the contents of DVMRP unicast routing
table.
The DVMRP route shows the topology information for the internet multicasting sites. It is
independent of IP unicast routing table or protocol. In this table, the information is
presented about a address prefix (in form of network-address/network-mask length), the
interface and the uplink (parent) router through which this subnet can be reached. This
table also shows information about any routers/interfaces which consider this router as
their uplink (that is, those routers which depend on this router if traffic were to originate
from this subnet). These routers/interfaces are shown as children of the parent router.
Note: The show ip dvmrp route command can search on the basis of subnet and on the
basis of those routes whose parent is a particular interface and/or a particular
router.
Note: This command only shows DVMRP routes and not information about current
multicast sessions.
Parameters
<type>
<slot/port>
<IPaddr> Displays the route to the specified router.
Restrictions
None.
Examples
To display DVMRP routes offered by the next-hop router 207.137.137.1:
Purpose
Displays the rules in effect for filtering routes from DVMRP neighbor routers.
Format
show ip dvmrp rules
Mode
Privileged
Description
The show ip dvmrp rules command displays the filtering rules in effect for DVMRP
routes.
Parameters
None.
Restrictions
None.
Example
In this example, the following rules are in effect:
These rules prevent a directly connected route on this router from being visible to interface
corp and mbone. The leaf flag indicates there is no downstream neighbor on the interface.
enable Command
The enable command switches the CLI session from User mode to Privileged mode.
Format
enable
Mode
User
Description
The enable command switches your CLI session from User mode to Privileged mode.
After you issue the command, the CLI will prompt you for a password if a password is
configured. If no password is configured, a warning message advising you to configure a
password will display.
If a password is configured and you do not know your password -- or pressing Return does
not work -- see your X-Pedition administrator.
To exit from the Privileged mode and return to the User mode, use the exit command.
Parameters
None.
Restrictions
None.
exit Command
The exit command exits the current CLI mode to the previous mode. For example, if you
are in the Privileged mode, exit returns you to the User mode. If you are in User mode,
exit closes your CLI session and logs you off the X-Pedition.
Format
exit
Mode
All modes
Parameters
None.
Restrictions
None.
Chapter 12
fddi Commands
The fddi commands enable the user to clear and display information related to the Fiber
Distributed Data Interface (FDDI).
Command Summary
Table 9 lists the fddi commands. The sections following the table describe the command
syntax.
clear fddi
Purpose
Clears specified FDDI port.
Format
clear fddi <port-list>
Mode
Privileged
Description
The clear fddi command clears a specified FDDI port.
Parameters
<port-list> Specifies which FDDI port(s) to clear.
Restrictions
None.
show fddi
Purpose
Displays specified information for one or more FDDI ports.
Format
show fddi fddi-fdx-mode| fddi-mode| fddi-status| mac-group|
mac-restricted-token| media-type| path-group| port-group| ring-purger|
smt-config| smt-group| translation| version <port-list>| all-ports
Mode
Privileged
Description
The show fddi command displays specified information for one or more FDDI ports.
Parameters
fddi-fdx-mode Shows FDDI full duplex value for specified port(s).
fddi-mode Shows operating FDDI mode for specified port(s).
fddi-status Shows FDDI status for specified port(s).
mac-group Shows MAC configuration parameters for specified port(s).
mac-restricted-token Shows MAC restricted token time-out for specified port(s).
media-type Shows the media type for specified port(s).
path-group Shows PATH configuration parameters for specified port(s).
port-group Shows PORT configuration parameters for specified port(s).
ring-purger Shows ring purger value for specified port(s).
smt-config Shows SMT configuration parameters for specified port(s).
smt-group Shows SMT configuration parameters for specified port(s).
translation Shows IPX/ARP Appletalk translation settings.
version Shows firmware version of port(s) specified.
Restrictions
None.
Chapter 13
file Commands
The file commands enable the user to display a directory of the files on a storage device,
display the contents of a file on the console, and delete a file.
Command Summary
Table 10 lists the file commands. The sections following the table describe the command
syntax.
delete <file-name>
dir <device-name>
show file <file-name>
delete
Purpose
Deletes a file.
Format
delete <file-name>
Mode
Privileged
Description
The delete command deletes the specified file. The filename can include a device name.
By default, if a device name is not specified, it is assumed to be the bootflash: device
which is where all configuration files are stored.
Parameters
<file-name> Name of the file to delete. The filename can include a device name using
this format: <device>:<file-name>. By default, if a device name is not
specified, it is assumed to be the bootflash device. The bootflash device is
the default device for storing configuration files.
Restrictions
None.
Examples
To delete the file config.old:
dir
Purpose
Displays contents of a file system.
Format
dir <device-name>
Mode
User
Description
Displays a directory of the files on the specified storage device.
Parameters
<device-name> Device name. You can specify one of the following:
bootflash: The Control Module’s NVRAM.
slot0: The PCMCIA flash card in slot 0 (the upper slot).
slot1: The PCMCIA flash card in slot 1(the lower slot).
Restrictions
None.
Examples
To display the contents of the bootflash device:
show file
Purpose
Displays the contents of a file.
Format
show file <file-name>
Mode
Privileged
Description
Displays the contents of a file.
Parameters
<file-name> Name of the file to display. The filename can include a device name using
this format: <device>:<file-name>. By default, if a device name is not
specified, it is assumed to be the bootflash device. The bootflash device is
the default device for storing configuration files.
Restrictions
None.
Examples
To display the contents of the file startup (the startup configuration file):
filters Commands
The filters commands allow the user to display information on the following types of
security filters:
• Address filters. Address filters block traffic based on a frame’s source MAC address,
destination MAC address, or both. Address filters are always configured and applied
on the input port.
• Static entry filters. Static entry filters allow or force traffic to go to a set of destination
ports based on a frame’s source MAC address, destination MAC address, or both. Static
entry filters are always configured and applied on the input port. You can configure
source static entry filters, destination static entry filters, and flow static entry filters.
Source static entry filters allow or disallow frames based on their source MAC address;
destination static entry filters allow or disallow frames based on their destination MAC
address. Flow static entries allow or disallow traffic based on their source and
destination MAC addresses.
• Port-to-address locks. Port-to-address lock filters “lock” a user to a port or set of
ports, disallowing them access to other ports.
• Secure ports. Secure port filters shut down Layer 2 access to the X-Pedition from a
specific port or drop all Layer 2 packets received by a port. Used by themselves, secure
ports secure unused X-Pedition ports. When used in conjunction with static entry
filters, secure ports drop all received or sent traffic (depending on the static entry filter)
except traffic forced to or from the port by the static entry filter.
Command Summary
Table 11 lists the filters commands. The sections following the table describe the
command syntax.
Purpose
Displays the address filters.
Format
show filters [address-filter] [all-source| all-destination| all-flow] [source-mac
<MACaddr> des-mac <MACaddr>] [ports <ports-list>] [vlan <VLAN-num>]
Mode
Privileged
Description
The show filters [address-filter] command displays the address filters currently
configured on the X-Pedition.
Parameters
all-source| all-destination| all-flow
Specifies the types of filters you want to display.
source-mac <MACaddr>
Restricts the display to only those address filters that have been applied to this source
MAC address.
des-mac <MACaddr>
Restricts the display to only those address filters that have been applied to this
destination MAC address.
ports <port-list>
Restricts the display to only those address filters that have been applied to the
specified ports.
vlan <VLAN-num>
Restricts the display to only those address filters that have been applied to the
specified VLANs.
Restrictions
None.
Purpose
Displays the port address locks.
Format
show filters [port-address-lock] [ports <port-list>] [vlan <VLAN-num>] [source-mac
<MACaddr>]
Mode
Privileged
Description
The show filters [port-address-lock] command displays the port-address-lock filters
currently configured on the X-Pedition.
Parameters
ports <port-list>
Restricts the display to only those port address locks that have been applied to the
specified ports.
vlan <VLAN-num>
Restricts the display to only those port address locks that have been applied to the
specified VLANs.
source-mac <MACaddr>
Restricts the display to only those port address locks that have been applied to this
source MAC address.
Restrictions
None.
Purpose
Displays the port security filters.
Format
show filters [secure-port]
Mode
Privileged
Description
The show filters [secure-port] command displays the secure-port filters currently
configured on the X-Pedition.
Parameters
None.
Restrictions
None.
Purpose
Displays the static entry filters.
Format
show filters [static-entry] [all-source| all-destination| all-flow] ports <port-list> vlan
<VLAN-num> [source-mac <MAC-addr>] [des-mac <MAC-addr>]
Mode
Privileged
Description
The show filters [static-entry] command displays the static-entry filters currently
configured on the X-Pedition.
Parameters
all-source| all-destination| all-flow
Specifies the types of static entries you want to display.
ports <port-list>
Restricts the display to only those static entries that have been applied to the specified
ports.
vlan <VLAN-num>
Restricts the display to only those static entries that have been applied to the specified
VLANs.
source-mac <MACaddr>
Restricts the display to only those static entries that have been applied to this source
MAC address.
des-mac <MACaddr>
Restricts the display to only those static entries that have been applied to this
destination MAC address.
Restrictions
None.
Chapter 15
frame-relay Commands
The frame-relay commands allow you to clear frame relay service profiles, and monitor
frame relay High-Speed Serial Interface (HSSI) and standard serial ports.
Command Summary
Table 12 lists the frame-relay commands. The sections following the table describe the
command syntax.
clear frame-relay
Purpose
Clears the specified statistics counter.
Format
clear frame-relay [frame-drop-qdepth-counter] [max-frame-enqued-counter]
[frame-drop-red-counter] [rmon] [<port list>]
Mode
Enable
Description
The clear frame-relay command allows you to specify a particular statistic counter and
have those statistics reset to zero. There are statistic counters on each WAN port, and you
can use the clear frame-relay to clear the counter for an individual WAN port or for a
group of ports.
Parameters
frame-drop-qdepth-counter Specify this optional parameter to reset the frame drop
counter to zero.
max-frame-enqued-counter Specify this optional parameter to reset the max
enquedframes counter to zero.
frame-drop-red-counter Specify this optional parameter to reset the packet drop
counter to zero.
rmon Specify this optional parameter to reset the rmon counter
to zero.
<port list> The WAN port(s) that you wish to clear the counter.
Restrictions
Usage is restricted to WAN ports only.
Example
To clear the frame drop counter to zero on WAN port hssi3/1:
Purpose
Displays frame relay service profiles.
Format
show frame-relay service <service-name>| all
Mode
Privileged
Description
The show frame-relay service command allows the user to display the available frame
relay service profiles.
Parameters
<service name>The name of a particular pre-defined service profile.
all Displays all of the available frame relay service profiles.
Restrictions
None.
Example
To display the available frame relay service profiles named “prof1”:
Purpose
Displays frame relay statistics.
Format
show frame-relay stats [ports <port-list>| all-ports] [lmi] [last-error] [mibII]
[summary]
Mode
Privileged
Description
The show frame-relay stats command allows the user to display the following frame
relay port statistics for a given port:
• The last reported frame relay error.
• The active frame relay LMI parameters.
• The MIBII statistics for frame relay WAN ports.
Parameters
port <port name>
The port or ports for which you want to display statistics. Using the keyword all-ports
will display statistics for all available ports.
lmi
Specifying the lmi keyword allows you to display the active frame relay LMI
parameters.
last-error
Specifying the last-error keyword allows you to display the last reported frame relay
error for the given port.
mibII
Specifying the mibII keyword allows you to display the MIBII statistics for frame
relay WAN ports.
summary
Specifying the summary keyword allows you to display all of the summary
information for VC statistics.
Restrictions
The last error, mibii, and lmi commands are for ports only (no VC designators allowed).
Otherwise, the port name may have the “VC” designator.
Examples
To display statistics for serial port 1 of slot 3:
Chapter 16
igmp Commands
The igmp commands let you display Internet Group Management Protocol (IGMP)
parameters.
Command Summary
Table 13 lists the igmp commands. The sections following the table describe the command
syntax.
Purpose
Shows the interfaces running IGMP.
Format
show ip igmp interface <port-list>
Mode
Privilege
Description
The show ip igmp interface command shows memberships on a specified interface or for
a multicast group address. When you use the command to show interfaces by group, all
interfaces containing the group membership are shown.
Note: This command is similar to show ip igmp groups, except where the show ip
igmp interface command shows interface details, the show ip igmp groups
command shows ports.
Parameters
<port-list>
The port name, in the format: media.slot.port.vpi.vci
media Is the media type. This is at for an ATM port.
slot Is the slot number where the module is installed.
port Is the number of the port through which data is passing.
vpi Is the Virtual Path Identifier.
vci Is the Virtual Channel Identifier.
Restrictions
None.
Example
To show information about the interfaces running IGMP:
Purpose
Displays IGMP host memberships.
Format
show ip igmp groups <IPaddr>
Mode
Privileged
Description
The show ip igmp groups command displays IGMP host members on a specific interface
and/or for a particular multicast group.
Parameters
<Ipaddr> Address of the multicast group for which to display host memberships.
Restrictions
None.
Examples
To display host members for multicast group 225.0.1.20:
Purpose
Displays IGMP timers.
Format
show ip igmp timers
Mode
Privileged
Description
The show ip igmp timers command displays IGMP timers.
Parameters
None.
Restrictions
None.
Purpose
Displays IGMP VLANs.
Format
show ip igmp vlans
Mode
Privileged
Description
The igmp show vlans command displays IGMP VLANs.
Parameters
None.
Restrictions
None.
Chapter 17
ip Commands
The ip commands allow the user to display route table entries and various IP related
tables.
Command Summary
Table 14 lists the ip commands. The sections following the table describe the command
syntax.
ip clear reverse-flows
show ip hash-variant
show ip helper-address
show ip interface <port-list> [brief]
show ip reverse-flows
show ip route
show ip route [bgp| connected| ospf| ospf-ase| rip| static]
show ip route summary
show ip route static/show ip route rip
show tcp [dns-lookup]
show udp [dns-lookup]
ip clear reverse-flows
Purpose
Clears reverse flow statistics.
Format
ip clear reverse-flows
Mode
Privileged
Description
The ip clear reverse-flows command deletes all reverse flow statistics. Reverse flows are
IP traffic flows in the opposite direction, where source information becomes destination
information and vice versa.
Parameters
None.
Restrictions
None.
Example
To clear the reverse flow statistics:
show ip hash-variant
Purpose
Displays IP hash variant per module.
Format
show ip hash-variant
Mode
Privileged
Description
The show ip hash-variant command displays hash variant information. There are a total
of 16 modules using the hash variant feature (1-16).
Enabling hash variant causes a variation to the basic hashing algorithm. This variation will
prevent clustering of hash values and will provide a more even distribution across the L3
lookup table. Valid variant numbers are: 0-3, 4-7 (swizzled), and 8 (auto-hashed). The
default hashing algorithm is 0.
Swizzling shifts the hash value by a certain amount of bits, causing a more random
distribution across the L3 lookup table. Auto-hashing allows the X-Pedition to auto-select
a hashing algorithm optimized for ‘best case’ L3 table distribution.
Parameters
None.
Restrictions
None.
Example
To display IP hash variant information on all 16 modules:
show ip helper-address
Purpose
Displays the configuration of IP helper addresses.
Format
show ip helper-address
Mode
Privileged
Description
The show ip helper-address command displays the configuration of IP helper addresses
configured on the system.
Parameters
None.
Restrictions
None.
Example
The following example shows that interface int4 has one helper address configured while
interface int3 has one helper address configured for the port mapper service (port 111).
show ip interface
Purpose
Displays the configuration of IP interfaces.
Format
show ip interface <port-list> [brief]
Mode
Privileged
Description
The show ip interface command displays the configuration of an IP interface. If you issue
the command without specifying an interface name then the configuration of all IP
interfaces is displayed.
Parameters
<port-list> Port for which to display IP statistics.
brief This optional keyword displays a brief summary of IP interface status
and configuration.
Restrictions
None.
Example
To display the configuration of the IP interface “ethernet1/1”:
show ip reverse-flows
Purpose
Displays reverse flow statistics.
Format
show ip reverse-flows
Mode
Privileged
Description
The show ip reverse-flows command displays the reverse flow statistics. Reverse flows
are IP traffic flows in the opposite direction, where source information becomes
destination information and vice versa. This command shows the number of reverse flow
packets.
Parameters
None.
Restrictions
None.
Example
To display the reverse flow statistics:
show ip route
Purpose
Displays ARP entries on the IP routing table.
Format
show ip route
Mode
Privileged
Description
The show ip route command displays ARP entries on the IP routing table.
Parameters
None.
Restrictions
None.
Restrictions
None.
show ip route
Purpose
Displays various portions of the IP routing table.
Format
show ip route [bgp| connected| ospf| ospf-ase| rip| static]
Mode
Privileged
Description
This show ip route command displays the IP routing table. Different command options
can be used to show different aspects of the routing table.
Parameters
bgp Shows all BGP (Border Gateway Protocol) routes.
connected Shows all connected routes.
ospf Shows all OSPF (Open Shortest Path First) routes.
ospf-ase Shows all OSPF (Open Shortest Path First) Autonomous System-External
routes.
rip Shows all RIP (Routing Information Protocol) routes.
static Shows all manually defined routes.
Restrictions
None.
Purpose
Displays a summary of IP routing table entries.
Format
show ip route summary
Mode
Privileged
Description
The show ip route summary command displays a summary of all route entries.
Parameters
None.
Restrictions
None.
show tcp
Purpose
Displays all TCP connections and services.
Format
show tcp [dns-lookup]
Mode
Privileged
Description
The show tcp command displays all existing TCP connections to the X-Pedition as well as
TCP services available on the X-Pedition.
Parameters
dns-lookup This command attempts to do a reverse DNS lookup to look for the
hostname associated with the IP address and display the hostname
instead.
Restrictions
None.
Example
The following example displays all established TCP connections and services of the X-
Pedition.
show udp
Purpose
Displays all UDP connections and services.
Format
show udp [dns-lookup]
Mode
Privileged
Description
The show udp command displays all existing UDP connections to the X-Pedition
as well as UDP services available on the X-Pedition.
Parameters
dns-lookup This command attempts to do a reverse DNS lookup to look for the
hostname associated with the IP address and display the hostname
instead.
Restrictions
None.
Example
The following example displays all established UDP connections and services of
the X-Pedition
Chapter 18
ip-policy Commands
The ip-policy commands allow the user to clear and display the policies that cause the X-
Pedition to forward packets to a specified IP address based on information in a packet’s
L3/L4 IP header fields.
Command Summary
Table 15 lists the ip-policy commands. The sections following the table describe the
command syntax.
clear route-map
Purpose
Clears IP policy statistics.
Format
clear route-map [policy-name <name>|all]
Mode
Privileged
Description
The clear route-map command is used in conjunction with the show route-map
command, which gathers statistics about IP policies. The clear route-map command lets
you reset IP policy statistics to zero.
Parameters
<name> Specifies which active IP policy to clear.
all Causes statistics to be cleared for all IP policies.
Restrictions
None.
Examples
To clear statistics for IP policy p1:
show route-map
Purpose
Displays information about active IP policies.
Format
show route-map [[policy-name <name>|all] [interface <name>|all]]
Mode
Privileged
Description
The show route-map command displays information about active IP policies, including
profile definitions, policy configuration settings, and next-hop gateways. The command
also displays statistics about packets that have matched an IP policy statement as well as
the number of packets that have been forwarded to each next-hop gateway.
Parameters
policy-name <name>|all
Names a specific IP policy. Use the all keyword to display all active policies.
Note: The show route-map all command works identically to the show route-map
policy-name all command
interface <name>|all
Displays information about IP policies that have been applied to a specified interface.
If you use the all keyword, the command displays information about IP policies which
have been applied to all interfaces.
Restrictions
None.
Example
To display information about IP policy p1:
--------------------------------------------------------------------------------
IP Policy name : p1 1
Applied Interfaces : int1 2
Load Policy : first available 3
4 5 6 7 8 9 10
ACL Source IP/Mask Dest. IP/Mask SrcPort DstPort TOS Prot
--- -------------- ------------- --------- --------- --- ----
prof1 9.1.1.5/32 15.1.1.2 any any 0 IP
prof2 2.2.2.2/32 anywhere any any 0 IP
everything anywhere anywhere any any 0 IP
Legend:
1. The name of the IP policy.
2. The interface where the IP policy was applied.
3. The load distribution setting for IP-policy statements that have more than one next-
hop gateway; either first available (the default) or round-robin.
4. The names of the profiles (created with an acl statement) associated with this IP
policy.
5. The source address and filtering mask of this flow.
6. The destination address and filtering mask of this flow.
7. For TCP or UDP, the number of the source TCP or UDP port.
8. For TCP or UDP, the number of the destination TCP or UDP port.
9. The TOS value in the packet.
10. IP protocol (ICMP, TCP UDP).
11. The sequence in which the statement is evaluated. IP policy statements are listed in the
order they are evaluated (lowest sequence number to highest).
12. The rule to apply to the packets matching the profile: either permit or deny
13. The name of the profile (ACL) of the packets to be forwarded using an IP policy.
14. The number of packets that have matched the profile since the IP policy was applied
(or since the clear route-map command was last used)
15. The method by which IP policies are applied with respect to dynamic or statically
configured routes; possible values are Policy First, Policy Only, or Policy Last.
16. The list of next-hop gateways in effect for the policy statement.
17. The number of packets that have been forwarded to this next-hop gateway.
18. The state of the link the last time an attempt was made to forward a packet; possible
values are up, dwn, or N/A.
19. Implicit deny rule that is always evaluated last, causing all packets that do not match
one of the profiles to be forwarded normally (with dynamic routes).
Chapter 19
ip-redundancy
Commands
The ip-redundancy commands allow the user to both display and clear the Virtual Router
Redundancy Protocol (VRRP) on the X-Pedition. VRRP is defined in RFC 2338.
Command Summary
Table 16 lists the ip-redundancy commands. The sections following the table describe the
command syntax.
Purpose
Clears statistics gathered for VRRP.
Format
clear vrrp statistics interface <IFnum>
Mode
Privileged
Description
The clear vrrp statistics command resets a number of statistics to zero. These
statistics include the number of times a Backup router became the Master, the
number of VRRP advertisements received, and counts of VRRP packets that
contain errors.
Parameters
<IFnum> Causes VRRP statistics to be cleared for all virtual routers on
the specified interface.
Restrictions
None.
Example
To clear statistics for virtual routers on interface int1:
show vrrp
Purpose
Displays parameters for a virtual router.
Format
show vrrp [interface <IFnum>]| summary| verbose
Mode
Privileged
Description
The show vrrp command displays parameters for a virtual router.
Parameters
interface <IFnum>
Specifies the interface where the virtual router resides. If you choose this parameter,
you may enter the following keywords:
id <vrid> Identifies and displays information about a virtual router. Specify a
number between 1-255.
summary Displays summary information about each virtual router on the
interface.
verbose Displays detailed information about each virtual router on the
interface
summary
Displays summary information about each virtual router.
verbose
Displays detailed information about each virtual router.
Restrictions
None.
Examples
To show statistics for virtual router 1 on interface int1:
Chapter 20
ip-router Commands
The ip-router commands allow the user to monitor features and functions that work
across the various routing protocols.
Command Summary
Table 17 lists the ip-router commands. The sections following the table describe the
command syntax.
ip find rib-route
Purpose
Finds the active route in the RIB which the packet will use.
Format
ip find rib-route <IPaddr> [ignore-state]
Mode
Privileged
Parameters
<IPaddr>
Specifies the destination of the packet.
ignore-state
This optional parameter allows inactive routes to be considered in route
determination.
Restrictions
None.
show gated-config
Purpose
Displays the active or startup configuration file in GateD format.
Format
show gated-config active| permanent
Mode
Privileged
Parameters
active Shows the active GateD configuration file in RAM; this is the default.
permanent Shows the permanent GateD configuration file in NVRAM, if available.
Restrictions
None.
show ip route
Purpose
Displays routing information base.
Format
show ip route [summary]
Mode
Privileged
Description
The show ip route command shows the route-manager's routing information base (RIB).
For any given network, the routing daemon could have multiple routes. The active route to
any network is shown with a plus (+) sign next to it. The last active route is shown with a
minus (-) next to it. If a route has been the last active route and is also the current active
route, then it is shown with a asterisk (*) sign next to it. The legend is as follows:
• “+” Active Route
• “-” Last Active
• “*” Both
If the summary option is used, then additional information is displayed about these
routes. The announcements bits for the active route are shown, which displays the protocol
into which this route is advertised.
Parameters
summary Allows user to view additional information about the routes in the RIB.
Restrictions
None.
Examples:
A sample output of the show ip route command:
Note: To see a specific route, use the show ip route <network> command.
Purpose
Displays the state of GateD.
Format
show ip route <network> <mask> [detail]
Mode
Privileged
Description
The show ip route <network> command displays a specific route in the route-manager's
routing information base (RIB). For any given network, the routing daemon could have
multiple routes. The active route to any network is shown with a plus (+) sign next to it.
The last active route is shown with a minus (-) next to it. If a route has been the last active
route and is also the current active route, then it is shown with a asterisk (*) sign next to it.
The legend is as follows:
• “+” Active Route
• “-” Last Active
• “*” Both
If the detail option is used, then additional information is displayed about this routes. The
announcements bits for the active route are shown, which displays the protocol into which
this route is advertised.
Parameters
<network> <mask>
Allows user to specify a particular IP address mask for the RIB route in question.
detail
Allows user to view additional information about the routes in the RIB.
Restrictions
None.
Examples
A sample output of the ip-router show route detail command:
*Direct Preference: 0
*NextHop: 10.12.1.2 Interface: 10.12.1.2(to-c4500)
State: <Int Active Retain>
Age: 5:12:10 Metric: 0 Metric2: 0 Tag: 0
Task: IF
Announcement bits(5):
2-KRT 4-RIP.0.0.0.0+520 5-RIP.0.0.0.0+520
6-BGP_Sync_64805
7-BGP_Group_64805
AS Path: IGP (Id 1)
In this case there are two routes to network: 10.12.1.0 and 255.255.255.252. One of them
is a direct route and other route is learned through OSPF. The direct route has a better
preference (lower preference is considered better preference), and is thus the active route.
The direct route has been installed since 5 hours, 12 minutes and 10 seconds. This direct
route is being announced to the Forwarding Information Base (FIB) which is indicated by
KRT, over two RIP interfaces (which is indicated by 4-RIP.0.0.0.0+520, 5-
RIP.0.0.0.0+520) and also to the BGP internal peer-group for autonomous system 64805.
To see all the routes in the RIB, use the show ip route command.
Purpose
Displays the state of GateD.
Format
show ip route state
Mode
Privileged
Description
The show ip route state command displays information on the route-manager's routing
information base (RIB).
Parameters
None.
Restrictions
None.
Chapter 21
ipx Commands
The ipx commands let you add entries to the Internet Package Exchange (IPX) SAP table
for SAP servers and display the IPX forwarding database, RIP table, and SAP table.
Command Summary
Table 18 lists the ipx commands. The sections following the table describe the command
syntax.
Purpose
Finds an IPX address in the routing table.
Format
ipx find rip <address>
Mode
Privileged
Description
The ipx find rip command searches for an IPX address in the routing table.
Parameter
<address> The IPX network address of this interface. Specify the IPX address using its
hexadecimal value.
Restrictions
None.
Example
To find an IPX network in the route table:
Purpose
Finds a SAP entry in the routing table.
Format
ipx find sap [<type>| all] [<SrvcName>| all] [<network>| all] <entrytype>
Mode
Privileged
Description
The ipx find sap command searches for a SAP entry in the routing table.
Parameters
<type>| all Defines the types of service. Specify the service type using its hexadecimal
value. Specify all for all types of service.
<SrvcName>| all
Defines the IPX service. You can use any characters in the name except the
following: “* . / : ; < = > ? [ ] \ |
Note: Lowercase characters are changed to uppercase characters.
Specify all for all IPX services.
<network>| all
Defines the network on which the service resides. Specify an IPX network
address in the following format: <netaddr.> Example: a1b2c3d4. Specify all
for all networks.
<entrytype> Defines the types of entry you want to find. Specify one of the following:
all Finds static and dynamic SAP entries.
dynamic Finds only the dynamic SAP entries.
static Finds only the static SAP entries.
Restrictions
None.
Example
To find a SAP entry in the route table:
Purpose
Displays the RIP and SAP socket buffer sizes.
Format
show ipx buffers
Mode
Enable
Description
The show ipx buffers command displays the RIP and SAP socket buffer sizes.
Parameters
None.
Restrictions
None.
Purpose
Displays the configuration of IPX interfaces.
Format
show ipx interface <IFname> [brief]
Mode
Privileged
Description
The show ipx interface command displays the configuration of an IPX interface. If you
issue the command without specifying an interface name then the configuration of all IPX
interfaces is displayed.
Parameters
<IFname> Name of the IPX interface; for example, xp14.
brief Displays a brief summary of IPX interface status and configuration.
Restrictions
If you specify an interface name, the name must belong to an existing IPX interface.
Example
To display the configuration of all IPX interfaces:
Purpose
Show IPX RIP table output sorted by destination.
Format
show ipx rib destination
Mode
User
Description
The show ipx rib destination command displays IPX RIP table output sorted by
destination.
Parameters
None.
Restrictions
None.
Purpose
Displays IPX server information.
Format
show ipx servers {sorted [hops| net| name| type]}| unsorted
Mode
User
Description
The show ipx servers command displays IPX server information sorted by any, all, or
none of the optional arguments. Sorting is done based on the order of optional arguments
given.
Parameters
sorted Confirms that user wants information sorted. Accompanies one or all of the
following arguments:
hops Sorts by number of hops away the service is.
net Sorts by the interface type over which the service arrived.
name Sorts by the Sap service name.
type Sorts by the Sap service type.
unsorted Confirms that user does not want information sorted.
Restrictions
None.
Purpose
Shows summary of the IPX RIP/SAP tables.
Format
show ipx route
Mode
User
Description
The show ipx route command displays a summary of the IPX RIP/SAP tables.
Parameters
None
irdp Command
The show ip irdp command displays the state of router discovery on the X-Pedition.
Format
show ip irdp
Mode
Privileged
Description
The show ip irdp command displays the state of router discovery on the X-Pedition.
Parameters
None.
Restrictions
None.
Timers:
RouterDiscoveryServer Priority 30
RouterDiscoveryServer_SSR2_SSR3_IP <OneShot>
last: 10:17:21 next: 10:25:05 2
Task RouterDiscoveryServer:
Interfaces:
Interface SSR2_SSR3_IP: 3
Group 224.0.0.1: 4
minadvint 7:30 maxadvint 10:00 lifetime 30:00 5
Interface policy:
Interface SSR2_SSR3_IP* MaxAdvInt 10:00 7
Legend:
1. Information about the RDISC task.
2. Shows when the last router advertisement was sent and when the next advertisement
will be sent.
3. The interface on which router advertisement is enabled.
4. Multicast address.
5. Current values for the intervals between the sending of router advertisements and the
lifetime of addresses sent in a router advertisement.
6. IP address that is included in router advertisement. The preference of this address as a
default route is 0, the default value.
7. Shows configured values for the specified interface.
Chapter 23
load-balance Commands
The load-balance commands allow you to distribute session load across a pool of servers.
These commands provide a way to load balance network traffic to multiple servers.
Command Summary
Table 19 lists the load-balance commands. The sections following the table describe the
command syntax.
Purpose
Sets the status of a load balancing server.
Format
load-balance set server-status
Mode
Privileged
Description
The load-balance set server-status command allows you to set the status of a load
balancing server.
Parameters
None.
Restrictions
None.
Purpose
Displays load balance application content verification (acv) options.
Format
show load-balance acv-options
Mode
Privileged
Description
The show load-balance acv-options command allows you to display load balancing acv
options.
Parameters
None.
Restrictions
None.
Purpose
Displays load balancing hashing statistics.
Format
show load-balance hash-stats
Mode
Privileged
Description
The show load-balance hash-stats command allows you to display load balancing hash
statistics.
Parameters
None.
Restrictions
None.
Example
To display hash statistics:
+---------+----------------+------------------------+
| Index | Hash Depth | Hash Depth Occurrences |
+---------+----------------+------------------------+
|1 |0 |11882 |
|2 |1 |4226 |
|3 |2 |138 |
+---------+----------------+------------------------+
+---------+------------------------+----------------+
| Index | Hash Depth Occurrence | Hash Depth |
+---------+------------------------+----------------+
|1 |11882 |0 |
|2 |4226 |1 |
|3 |138 |2 |
+---------+------------------------+----------------+
Purpose
Displays load balancing source-destination bindings.
Format
show load-balance source-mappings
Mode
Privileged
Description
The show load-balance source-mappings command allows you to display load balancing
source-destination bindings.
Parameters
None.
Restrictions
None.
Example
To display source-destination bindings:
Current Mappings:
+----------------+-----+----------------+-----+----------------+-----+----+----+
| Source Address |Sport| Virtual IP |VPort| Dst. Address |DPort| FC | AC |
+----------------+-----+----------------+-----+----------------+-----+----+----+
|70.1.0.71 |1024 |50.1.1.18 |80 |52.1.1.73 |80 |2 |0 |
|70.1.0.71 |1025 |50.1.1.17 |80 |52.1.1.71 |80 |2 |0 |
|70.1.0.72 |1026 |50.1.1.17 |80 |52.1.1.72 |80 |2 |0 |
|70.1.0.72 |1027 |50.1.1.18 |80 |52.1.1.74 |80 |2 |0 |
Purpose
Displays load balancing statistics.
Format
show load-balance statistics
Mode
Privileged
Description
The show load-balance statistics command allows you to display load balancing
statistics.
Parameters
None.
Restrictions
None.
Example
To display load balance statistics:
Purpose
Displays hosts in a load balancing group.
Format
show load-balance virtual-hosts
Mode
Privileged
Description
The show load-balance virtual-hosts command allows you to display the hosts in a load
balancing group.
Parameters
None.
Restrictions
None.
Example
To display load balance groups:
+----------------+----------------+------+-------------+----------+------------+
| Group Name | Virtual IP | Port | Hosts Added | Hosts Up | Next Index |
+----------------+----------------+------+-------------+----------+------------+
|telnet |50.1.1.17 |23 |2 |2 |0 |
+----------------+----------------+------+-------------+----------+------------+
+-------+---------------+------+----------------+----+----+------------+
| Index | Host IP | Port | Client Count | OS | AS | Load Count |
+-------+---------------+------+----------------+----+----+------------+
|0 |52.1.1.73 |23 |0 |Up |Up |0 |
|1 |52.1.1.74 |23 |0 |Up |Up |0 |
+-------+---------------+------+----------------+----+----+------------+
+----------------+----------------+------+-------------+----------+------------+
| Group Name | Virtual IP | Port | Hosts Added | Hosts Up | Next Index |
+----------------+----------------+------+-------------+----------+------------+
|http |50.1.1.17 |80 |2 |2 |0 |
+----------------+----------------+------+-------------+----------+------------+
+-------+---------------+------+----------------+----+----+------------+
| Index | Host IP | Port | Client Count | OS | AS | Load Count |
+-------+---------------+------+----------------+----+----+------------+
|0 |52.1.1.71 |80 |0 |Up |Up |0 |
|1 |52.1.1.72 |80 |0 |Up |Up |0 |
+-------+---------------+------+----------------+----+----+------------+
logout Command
Format
logout
Mode
All modes
Description
The logout command ends your CLI session. If you have uncommitted changes in the
scratchpad, a message warns you that the changes are not saved and gives you an
opportunity to cancel the logout and save the changes.
Parameters
None.
Restrictions
None.
Chapter 25
mac-address-table
Commands
The mac-address-table commands allow the user to display various L2 tables related to
Media Access Control (MAC) addresses.
Command Summary
Table 20 lists the mac-address-table commands. The sections following the table describe
the command syntax.
Purpose
Shows all L2 flows (for ports in flow-bridging mode).
Format
show mac-address-table all-flows [vlan <VLAN-num>] [source-mac <mac>]
[undecoded]
Mode
User or Privileged
Description
The show mac-address-table all-flows command shows all the L2 flows learned by the
X-Pedition. The X-Pedition learns flows on ports that are operating in flow-bridging
mode.
Parameters
vlan <VLAN-num>
Specifies the VLAN number associated with the flows. The VLAN number can be
from 1 – 4095.
source-mac <mac>
Specifies the source MAC address of the flows. Enter the MAC address in either of
the following formats:
xx:xx:xx:xx:xx:xx
xxxxxx:xxxxxx
source
Specifies the source address associated with the flows.
destination
Specifies the destination address associated with the flows.
multicast
Specifies the multicast address associated with the flows.
Restrictions
None.
Purpose
Displays all MAC addresses currently in the L2 tables.
Format
show mac-address-table all-macs [vlan <VLAN-num>] [source-mac <mac>] [source]
[destination] [multicast]
Mode
User or Privileged
Description
The show mac-address-table all-macs command shows how many MAC addresses the
X-Pedition has in its L2 tables. You can format the displayed information based on
VLAN, source MAC address, destination MAC address or multicast.
Parameters
vlan <VLAN-num> Displays only MAC addresses in the specified VLAN.
source-mac <MACaddr>
Displays only the source MACaddress. Specify this address in either
of the following formats:
xx:xx:xx:xx:xx:xx
xxxxxx:xxxxxx
source Displays only source addresses.
destination Displays only destination addresses.
multicast Displays only multicast and broadcast addresses.
Restrictions
None.
Purpose
Shows information about all MAC addresses registered by the system.
Format
show mac-address-table bridge-management
Mode
User or Privileged
Description
The show mac-address-table bridge-management command shows MAC addresses that
have been inserted into the L2 tables for management purposes. Generally, these entries
are configured so that a port forwards a frame to the Control Module if the management
MAC matches the frame’s destination MAC.
An example of a bridge-management MAC is Spanning Tree’s bridge group address
(0180C2:000000), which is be registered in the L2 tables of X-Pedition ports on which the
Spanning Tree Protocol (STP) is enabled.
Parameters
None.
Restrictions
None.
Purpose
Displays information about multicast MAC addresses registered by IGMP.
Format
show mac-address-table igmp-mcast-registration [vlan <VLAN-num>]
Mode
User or Privileged
Description
The show mac-address-table igmp-mcast-registration command displays the multicast
MAC addresses that IGMP has registered with the L2 tables. The X-Pedition forwards the
multicast MAC addresses only to the ports that IGMP specifies.
Parameters
vlan <VLAN-num> Displays only the multicast MAC addresses registered for the
specified VLAN.
Restrictions
None.
Purpose
Displays information about a particular MAC address.
Format
show mac-address-table address <MACaddr> vlan <VLAN-num>
Mode
User or Enable
Description
The show mac-address-table address command displays the port number on which the
specified MAC address resides.
Parameters
<MACaddr> Specifies a MAC address. Enter the MAC address in either of the
following formats:
xx:xx:xx:xx:xx:xx
xxxxxx:xxxxxx
vlan <VLAN-num> Displays the MAC address for this VLAN.
Restrictions
None.
Purpose
Displays statistics for the MAC addresses in the MAC address tables.
Format
show mac-address-table mac-table-stats
Mode
User or Privileged
Description
The show mac-address-table mac-table-stats command displays statistics for the master
MAC address table in the Control Module and the MAC address tables on the individual
ports.
Parameters
None.
Restrictions
None.
Purpose
Displays information about MACs residing in a port's L2 table.
Format
show mac-address-table port-macs <port-list>| all-ports [verbose [vlan <VLAN-
num>] [source] [destination] [multicast] [undecoded] [no-stats]]
Mode
User or Privileged
Description
The show mac-address-table port-macs command shows the information about the
learned MAC addresses in individual L2 MAC address tables. Each port has its own MAC
address table. The information includes the number of source MAC addresses and the
number of destination MAC addresses in the table. If you enter the verbose option, the
MAC addresses also are displayed.
Parameters
<port-list>| all-ports
Specifies the port(s) for which you want to display MAC address information. You
can specify a single port or a comma-separated list of ports. If you use the all-ports
keyword, MAC address information is displayed for all ports.
verbose
Shows detailed statistics for each MAC address entry.
vlan <VLAN-num>
Specifies the type of MAC address for which you want to show statistics.
source
Displays statistics for only source addresses.
destination
Displays statistics for only destination addresses.
multicast
Displays statistics for only multicast and broadcast addresses.
undecoded
Displays the MAC addresses in hexadecimal format rather than undecoded format.
Undecoded format does not show the vendor name in place of the first three
hexadecimal digits (example: Enterasys:33:44:55). The default is undecoded
(example: 00:11:22:33:44:55).
no-stats
Lists the MAC addresses without displaying any statistics.
Restrictions
None.
Purpose
Shows whether IGMP is on or off on a VLAN.
Format
show mac-address-table vlan-igmp-status vlan <VLAN-num>
Mode
Privileged
Description
The show mac-address-table vlan-igmp-status command shows the multicast MAC
addresses that IGMP has registered with the L2 tables. This command also shows the ports
to which the multicast MAC addresses are forwarded.
Note: For IGMP forwarding to occur for a multicast MAC address, IGMP must be
enabled on the VLAN with which the MAC address is associated.
Parameters
vlan <VLAN-num> Specifies the VLAN number. The VLAN number can range from 1 –
4095.
Restrictions
None.
mtrace Command
The mtrace command tracks the multicast path from a source to the X-Pedition.
Format
mtrace <source>
Mode
Privileged
Description
The mtrace command tracks the multicast path from a source to a receiver. A trace probe
is sent in a reverse path from the receiver back to the source. As the probe passes from hop
to hop, it collects information such as interface address and packet counts from each
router. Because the mtrace command is executed with only the source parameter, a
multicast path is calculated from the source to the X-Pedition.
Parameters
<source> IP address of the source.
Restrictions
None.
Chapter 27
multicast Commands
The multicast commands allow the user to display information about IP multicast
interfaces.
Command Summary
Table 21 lists the multicast commands. The sections following the table describe the
command syntax.
Purpose
Displays information about IP multicast interfaces.
Format
show ip multicast interface
Mode
Privileged
Description
The show ip multicast interface command displays interfaces that are running IGMP or
DVMRP.
Note: This command is a superset of the show dvmrp interface and
show igmp interface commands.
Parameters
None.
Restrictions
None.
Example
To display IP multicast information:
show mroute
Purpose
Displays the IP multicast routing table.
Format
show mroute [child <IPaddr>] [group <IPaddr>] [parent <IPaddr>]
Mode
Privileged
Description
The show mroute command displays the IP multicast routing table entry for the specified
multicast group address.
This command lists all the multicast distribution trees, showing the parent interface (from
where the traffic is coming), and the children distribution interfaces (to which the traffic is
being forwarded). It would also show any cache information available either in hardware
forwarding mechanism or in the main processor (for software based forwarding).
Note: The cache information can be timed out when not enough traffic is present, but
multicast routes can still be present. Cache information is presented in number of
flows (Layer 4 sessions). Multicast routes stay at least for 5 minutes, while the
hardware forwarding mechanism can time out a flow faster.
Any pruning information, if present, is also shown.
The search can always be narrowed by looking at a particular group, and/or looking at a
particular parent interface, and/or looking at a particular child interface.
Multicast routes are not the same as DVMRP routes.
Parameters
child <IPaddr> Address of a child interface.
group <IPaddr> Address of a multicast group.
parent <IPaddr> Address of a parent interface.
Restrictions
None.
Examples
To display the IP multicast route entry for the group 225.0.0.10:
Chapter 28
nat Commands
The nat commands allow the user to clear and display Network Address Translation
(NAT) bindings for local (inside) and global (outside) network addresses.
Command Summary
Table 22 lists the nat commands. The sections following the table describe the command
syntax.
clear ip nat
Purpose
Clears NAT error statistics.
Format
clear ip nat out-of-globals| port-mode
Mode
Privileged
Description
The clear ip nat command allows you to clear specific NAT error statistics such as
out-of-globals messages in the case of dynamic bindings and port misconfiguration.
Parameters
out-of-globals Clears error statistics during dynamic binding in the case where there are
no more global IP addresses in the global address pool.
port-mode Clears error statistics that occur because of port misconfigurations. Such
cases are where the port is set to either destination-based forwarding or
host-flow based forwarding.
Restrictions
None
Example
To clear all out-of-global error statistics:
Purpose
Clears dynamic NAT bindings.
Format
clear ip nat translation [pool-specified [local-acl-pool <local-ACL>] [global-pool
<IPaddr/IPaddr-range]]
Mode
Privileged
Description
The clear ip nat translation command deletes dynamic address bindings. You can delete
the dynamic address bindings for specific address pools.
Parameters
pool-specified
Deletes NAT dynamic bindings based on local and global acl pools.
local-acl-pool <local-ACL>
The ACL that corresponds to the local IP address pool.
global-pool <IPaddr/IPaddr-range>
The global address pool, defined in one of the following ways:
A single IP address in the form a.b.c.d
An IP address range in the form 10.10.1.1-10.10.1.50
IP address and mask in the form 1.2.0.0/255.255.0.0 or 1.2.3.0/16
Restrictions
None.
Examples
To delete dynamic address bindings for the local address pool that corresponds to the ACL
‘lcl’ and the global address pool that corresponds to 136.1.1.1-136.1.1.254:
show ip nat
Purpose
Displays NAT information.
Format
show ip nat [statistics| timeouts| translations]
Mode
Privileged
Description
The show ip nat command allows you to display NAT address statistics, timeouts, and
translations.
Parameters
statistics Displays NAT statistics.
timeouts Displays the current set of timeouts.
translations Displays NAT translations.
Restrictions
None.
Examples
To display active NAT translations:
Chapter 29
ntp Commands
The ntp commands configure and display the characteristics of the NTP (Network Time
Protocol) client.
Command Summary
Table 23 lists the ntp commands. The sections following the table describe the command
syntax.
Purpose
Manually forces the X-Pedition to immediately synchronize with an NTP server.
Format
ntp synchronize server <host>
Mode
Privileged
Description
The ntp synchronize server command forces the X-Pedition to immediately synchronize
its clock with the NTP server.
Parameters
<host> Specifies the hostname or the IP address of the NTP server.
Restrictions
None.
Examples
To synchronize the X-Pedition against the NTP server 10.13.1.1:
show ntp
Purpose
Displays NTP information about the X-Pedition.
Format
show ntp
Mode
Privileged
Description
The show ntp command displays various NTP information about the X-Pedition, for
example, the last time a successful synchronization was made, synchronization interval,
NTP version number, etc.
Parameters
None.
Restrictions
None.
Example
xp# show ntp
NTP status:
Synchronization interval: 60 mins
Version: NTPv3
Last successful contact: Thu Jan 23 23:08:15 1999
Chapter 30
ospf Commands
The ospf commands allow the user to display parameters for the Open Shortest Path First
(OSPF) routing protocol.
Command Summary
Table 24 lists the ospf commands. The sections following the table describe the command
syntax.
show ip ospf
show ip ospf interface
show ip ospf
Purpose
Displays OSPF information.
Format
show ip ospf
Mode
Privileged
Description
The show ip ospf command displays information about the OSPF.
Parameters
None.
Restrictions
None.
Purpose
Displays OSPF interfaces.
Format
show ip ospf interface
Mode
Privileged
Description
The show ip ospf interface command displays all OSPF interfaces.
Parameters
None.
Restrictions
None.
ping Command
The ping command tests connection between the X-Pedition and an IP host.
Format
ping <hostname-or-IPaddr> packets <num> size <num> wait <num> [flood]
[dontroute]
Mode
Privileged
Description
The ping command test connection between the X-Pedition and an IP host. The ping
command sends ICMP echo packets to the host you specify.
• If the packets reach the host, the host sends a ping response to the X-Pedition and the
CLI displays messages stating that the host can be reached.
• If the host does not respond, the X-Pedition assumes the host cannot be reached from
the X-Pedition and the CLI display messages stating that the host did not reply.
Parameters
<hostname-or-IPaddr>
The host name or IP address you want to ping.
packets <num>
The number of ping packets you want to send. The default is 1.
size <num>
The packet size. For Ethernet, specify a number from 0 – 1364.
Restrictions
None.
Chapter 32
port Commands
Command Summary
Table 25 lists the port commands. The sections following the table describe the command
syntax.
show bmon
show bridging
show interfaces accounting| <port-list>
show port 8021
show port auto-negotiation <port-list>
show port auto-negotiation capabilities <port-list>
show port MAU [<port-list>]
show port MAU-statistics [<port-list>]
show bmon
Purpose
Displays broadcast monitoring information for X-Pedition ports.
Format
show bmon
Mode
Privileged
Description
The show bmon command allows the user to display broadcast monitoring information
for all X-Pedition ports.
Parameters
None.
Restrictions
None.
Example
To display the state of ports with broadcast monitoring:
The above example shows three ports, with the port ethernet6/8 shut down for 39 seconds.
show bridging
Purpose
Displays the bridging status of all X-Pedition ports.
Format
show bridging
Mode
Privileged
Description
The show bridging command lets you display bridging-status information for all X-
Pedition ports.
Parameters
None.
Restrictions
None.
Example
To display the bridging status for available ports:
show interfaces
Purpose
Displays the user defined descriptions of X-Pedition ports.
Format
show interfaces accounting| <port-list>
Mode
Privileged
Description
The show interfaces command allows you display the user defined description for X-
Pedition ports.
Parameters
accounting Displays interface accounting.
<port-list> Specifies the port(s) for which you want to display the description(s).
Restrictions
This command is valid for Ethernet and WAN only.
Examples
To display status for ethernet3/1-2:
Purpose
Displays 802.1p encapsulation status.
Format
show port 8021p
Mode
Privileged
Description
The show port 8021p command displays whether 802.1p encapsulation is enabled or
disabled on a port or list of ports. The 802.1p standard provides the ability to classify
traffic into eight priority categories or class of services. This classification scheme is based
upon MAC frame information and is used for QoS (Quality of Service) for VLANs.
Parameters
None.
Restrictions
None.
Example
To display 802.1p encapsulation status for port ethernet2/1:
Purpose
Displays auto-negotiation information.
Format
show port auto-negotiation <port-list>
Mode
Privileged
Description
The show port auto-negotiation command displays auto-negotiation information. This
command displays port number, administration status, current status, remote signaling,
fault advertised, and fault received. Auto-negotiation is a process whereby both ports on a
connection resolve the best line speed, duplex mode and flow control scheme to
communicate with each other.
Parameters
<port-list> Specifies the ports for which you want to display the description.
Failing to specify a port will result in the display of all the X-
Pedition ports.
Restrictions
None.
Example
To display auto-negotiation information for port ethernet2/1:
Purpose
Displays auto-negotiation capabilities.
Format
port show auto-negotiation capabilities <port-list>
Mode
Privileged
Description
The show port auto-negotiation capabilities command displays a list of port capabilities,
advertised capabilities, and any received capabilities from another port. Auto-negotiation
is a process whereby both ports on a connection resolve the best line speed, duplex mode
and flow control scheme to communicate with each other.
Parameters
<port-list> Specifies the ports for which you want to display capabilities. Failing to
specify a port will result in the display of all the X-Pedition ports.
Restrictions
None.
Example
To display auto-negotiation capabilities for port ethernet2/1:
Purpose
Displays Media Access Control information.
Format
show port MAU <port-list>
Mode
Privileged
Description
The show port MAU command displays Media Access Control (MAC) information. This
command displays port number, media type, default media type, jack type, operational
status, and support level.
Parameters
<port-list> Specifies the ports for which you want to display the description.
Restrictions
None.
Example
To display MAC information for port ethernet2/1:
Purpose
Displays Media Access Control statistics.
Format
show port MAU-statistics <port-list>
Mode
Privileged
Description
The show port MAU-statistics command displays Media Access Control (MAC)
statistics. This command displays port number, media availability, media availability state
exits totals, jabber (excessively long frames) state, jabbering state enters totals, and false
carriers totals.
Parameters
<port-list> Specifies the ports for which you want to display the description.
Restrictions
None.
Example
To display MAC statistics for port ethernet2/1:
Purpose
Shows the port mirroring status for ports and ACLs in the X-Pedition chassis.
Format
show port mirroring <port-list>| acls
Mode
Privileged
Description
The show port mirroring command shows the following port mirroring status
information for the specified ports or ACLs:
• Whether port mirroring is enabled
• The ports or slots that are being mirrored
• The mirroring mode (input port, output slot, or both)
Parameters
<port-list> Specifies the ports for which you want to display port mirroring status.
acls Displays information for all flow mirroring rules.
Restrictions
None.
Examples
To display the port mirroring status for port ethernet2/1:
Purpose
Displays various information about specified ports.
Format
show port status <port-list>
Mode
Privileged
Description
The show port status command lets you display port-status information for X-Pedition
ports.
Parameters
<port-list> Specifies the LAN/WAN ports for which you want to display status
information.
Restrictions
This command does not show Virtual Circuit (VC) information. To see the state of sub-
interfaces, you need to use the appropriate facility command, such as the show frame-
relay command.
Example
To display the port status for all ports on ethernet1/2:
Link Admin
Port Port Type Duplex Speed Negotiation State State Flags
---- --------- ------ ----- ----------- ----- ----- -----
et.1.1 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
et.1.2 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
et.1.3 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
et.1.4 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
et.1.5 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
et.1.6 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
et.1.7 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
et.1.8 10/100-Mbit Ethernet Half 10 Mbits Manual Up Up
show pvst
Purpose
Displays Spanning Tree (STP) information for a particular spanning tree.
Format
show pvst <name> interface <port-list>
Mode
Privileged
Description
The show pvst command allows the user to display Spanning-Tree information for a
particular spanning tree.
Parameters
<name> Specifies the name of the spanning tree for which you want to
display information.
interface <port-list> Specifies the ports for which you want to display information.
Restrictions
None.
Example
To display the spanning tree information for spanning tree ‘stp1’ on port ethernet2/1:
Purpose
Displays Spanning Tree (STP) information for X-Pedition ports.
Format
show stp interface <port-list>
Mode
Privileged
Description
The show stp interface command allows the user to display Spanning-Tree information
for X-Pedition ports.
Parameters
<port-list> Specifies the ports for which you want to display information. If no
port list is specified, the command will display information for all
X-Pedition ports.
Restrictions
None.
Example
To display the spanning tree information for all available ports:
Purpose
Displays VLAN information for X-Pedition ports.
Format
show vlan interface <port-list>
Mode
Privileged
Description
The show vlan interface command allows the user to display VLAN information about
X-Pedition ports.
Parameters
<port-list> Specifies the ports for which you want to display information.If no
port list is specified, the command will display information for all
X-Pedition ports.
Restrictions
None.
Example
To display the VLAN information for all available ports:
Chapter 33
ppp Commands
The ppp commands allow the user to specify and monitor Point-to-Point Protocol (PPP)
service profiles and PPP High-Speed Serial Interface (HSSI) and standard serial ports.
Command Summary
Table 26 lists the ppp commands. The sections following the table describe the command
syntax.
Purpose
Clears the specified statistics counter.
Format
ppp clear stats-counter ports <port list> [[frame-drop-qdepth-counter] [max-frame-
enqued-counter] [frame-drop-red-counter] [rmon]]
Mode
Privileged
Description
The clear ppp stats-counter command allows the user to specify a particular statistic
counter and reset those statistics to zero. There are statistic counters on each PPP WAN
port, and you can use the clear ppp stats-counter to clear the counter for an individual
WAN port or for a group of ports.
Parameters
ports <port list> The WAN port(s) for which you wish to clear counter.
frame-drop-qdepth-counter Specifying this optional parameter will reset the frame
drop counter to zero.
max-frame-enqued-counter Specifying this optional parameter will reset the max
enquedframes counter to zero.
frame-drop-red-counter Specifying this optional parameter will reset the packet
drop counter to zero.
rmon Specifying this optional parameter will reset the rmon
counter to zero.
Restrictions
Usage is restricted to PPP WAN ports only.
Example
To clear the frame drop counter to zero on WAN port hs.3.1:
Purpose
Restarts PPP LCP/NCP negotiation.
Format
ppp restart lcp-ncp ports <port list>
Mode
Privileged
Description
The ppp restart lcp-ncp command allows the user to reset and restart the LCP/NCP
negotiation process for PPP WAN ports.
Parameters
ports <port list> The ports for which you would like to re-establish LCP/NCP
negotiation.
Restrictions
This command line is available only for PPP WAN ports.
Example
To restart LCP/NCP negotiation on serial ports 1 and 2 of slot 4:
Purpose
Displays the PPP ports that have been added into an MLP bundle.
Format
show ppp mlp <mlp list>| all-ports
Mode
Privileged
Description
The show ppp mlp command allows the user to display information about one or more
MLP bundles.
Parameters
<mlp list> The name(s) of the MLP bundles on which you want information. You
can specify a single bundle or a comma-separated list of MLP bundles.
all-ports Displays information on all MLP ports.
Restrictions
None.
Example
To display the PPP ports for mp.1:
Purpose
Displays PPP service profiles.
Format
show ppp service <service name>| all
Mode
Privileged
Description
The show ppp service command allows you to display one or all of the available PPP
service profiles.
Parameters
<service name>The service profile you wish to display.
all Displays all of the available PPP service profiles.
Restrictions
None.
Example
To display the available PPP service profiles named profile_4:
Purpose
Displays bridge NCP, IP NCP, and link-status parameters.
Format
show ppp stats port <port> [bridge-ncp] [ip-ncp] [link-status] [summary]
Mode
Privileged
Description
The show ppp stats command allows the user to display parameters for bridge NCP, IP
NCP, and link-status on PPP WAN ports. You may specify one, two, or three of the
available parameter types.
Parameters
port <port> The PPP WAN port for which you wish to view bridge NCP, IP NCP, and/or
link-status parameters.
bridge-ncp Specifies that you wish to view bridging NCP parameters for the given port.
ip-ncp Specifies that you wish to view IP NCP parameters for the given port.
link-status Specifies that you wish to view link-status parameters for the given port.
summary Specifies that you wish to view summarized display.
Restrictions
None.
Example
To display the available link-status and IP NCP parameters for the PPP WAN interface
located at slot 4, port 1:
pvst Command
The show pvst command displays Shielded Twisted Pair (STP) bridging information for a
particular VLAN.
Format
show pvst <VLANid>
Mode
Privileged
Description
The show pvst command displays STP bridging information for a particular VLAN.
Parameters
<VLANid> The name of the VLAN for which to display STP information.
Note: For default VLAN, use stp commands.
Restrictions
For PVST, the spanning tree instance must have previously been created.
Chapter 35
qos Commands
Command Summary
Table 27 lists the qos commands. The sections following the table describe the command
syntax.
show qos ip
show qos ipx
show qos l2 all-destination all-flow ports <port-list> vlan <VLANid> source-mac
<MACaddr> dest-mac <MACaddr>
show qos precedence ip| ipx
show qos priority-map <string>| all
show qos wred [input port <port-list>| all-ports] [port <port-list>| all-ports]
show qos wfq <port-list>| all-ports
show qos ip
Purpose
Displays QoS information for IP flows.
Format
show qos ip
Mode
Privileged
Description
The show qos ip command allows the user to display QoS information for IP flows.
Parameters
None.
Restrictions
None.
Purpose
Displays QoS information for IPX flows.
Format
show qos ipx
Mode
Privileged
Description
The show qos ipx command allows the user to display QoS information for IPX flows.
Parameters
None.
Restrictions
None.
show qos l2
Purpose
Displays QoS information for L2 flows.
Format
show qos l2 all-destination all-flow ports <port-list> vlan <vlanID> source-mac
<MACaddr> dest-mac <MACaddr>
Mode
Privileged
Description
The show qos l2 command allows the user to display QoS information for L2 flows. You
may filter the display according to the following:
• Destinations
• Flows
• Ports
• VLANs
• Source MAC addresses
• Destination MAC addresses
• Priority
Parameters
all-destination
Filters the display to show all the L2 destination priorities.
all-flow
Filters the display to show all the L2 flow priorities.
ports <port-list>
Filters the display to show L2 priority information for specific ports.
vlan <vlanID>
Filters the display to show L2 priority information for specific VLANs.
source-mac <MACaddr>
Filters the display to show L2 priority information for specific source MAC addresses.
dest-mac <MACaddr>
Filters the display to show L2 priority information for specific destination MAC
addresses.
Restrictions
None.
Purpose
Displays IP or IPX precedence values.
Format
show qos precedence ip| ipx
Mode
Privileged
Description
The show qos precedence command allows the user to display the precedence values for
all fields in a flow.
IP flows consist of the following fields: destination port, destination address, source port,
source IP address, TOS, interface, protocol.
IPX flows consist of the following fields: destination network, source network, destination
node, source node, destination port, source port, interface.
Parameters
ip Displays the precedence values for IP flows.
ipx Displays the precedence values for IPX flows.
Restrictions
None.
Purpose
Displays the priority mapping and the ports that it is applied.
Format
show qos priority-map <string>| all
Mode
Privileged
Description
The show qos priority-map command allows the user to display the priority mapping that
is configured on a port. The command details how each set of 802.1p tag values is mapped
to a specific internal priority queue.
Parameters
<string> Specifies the name of the priority map.
all Displays all priority maps.
Restrictions
None.
Purpose
Displays WRED parameters for each port.
Format
show qos wred [input port <port list>| all-ports] [port <port list>| all-ports]
Mode
Privileged
Description
The show qos wred command allows the user to display WRED information for a certain
port or all ports. You may display WRED parameter information according to the
following:
• Input ports
• All Ports
Parameters
input port <port list>| all-ports
Displays input port WRED parameters. Specify all-ports to display parameters for all
ports.
port <port list>| all-ports
Displays WRED parameters for each port. Specify all-ports to display parameters for
all ports.
Restrictions
None.
Purpose
Displays bandwidth allocated for each port.
Format
show qos wfq port <port list>| all-ports
Mode
Privileged
Description
The show qos wfq command allows the user to display the bandwidth for each port
allocated with weighted-fair queuing.
Parameters
port <port list> |all-ports
Displays bandwidth allocated for each port. Specify a list of ethernet or wan ports.
Specify all-ports to display bandwidth for all ports.
Restrictions
None.
radius Command
The show radius command displays information about Remote Authentication Dial-In
Service (RADIUS) configuration on the X-Pedition.
Format
show radius
Mode
Privileged
Description
The show radius command displays statistics and configuration parameters related to
RADIUS configuration on the X-Pedition. The statistics displayed include:
accepts Number of times each server responded and validated the user successfully.
rejects Number of times each server responded and denied the user access, either
because the user wasn’t known, or the wrong password was supplied.
timeouts Number of times each server did not respond.
Parameters
None.
Restrictions
None.
rarpd Command
The show rarpd command displays information about the X-Pedition’s Reverse Address
Resolution Protocol (RARP) configuration.
Format
show rarpd interface| mappings
Mode
Privileged
Description
The show rarpd command displays information about the configuration of the X-
Pedition’s RARP server. You may list the MAC-to-IP address mappings or the interfaces
to which the X-Pedition responds to RARP requests.
Parameters
interface Lists the interfaces to which the X-Pedition responds to RARP requests.
mappings Displays the list of MAC-to-IP address mappings.
Restrictions
None.
rate-limit Command
Format
show rate-limit [all] | [policy-type flow-policies| aggregate-policies| portlevel-policies|
all] | [policy-name <name>] | [interface <interface>] | [port-level port <port list>|
all-port] | [port-level policy-name <name>] | [rate-limiting-mode]
Mode
Privileged
Description
The show rate-limit command displays information about rate limiting policies.
Parameters
all Displays information on all rate limit policies configured on the X-Pedition.
policy-type
The type of the rate limit policy. The keyword all shows all rate limit types. You can
specify the following types of policies:
flow-policies All flow policies
Restrictions
None.
--------------------------------------------------------------------------
Rate Limit Policy name : rlpol 1
Applied Interfaces : if0 2
3 4 5 6 7 8 9
ACL Source IP/Mask Dest. IP/Mask SrcPort DstPort TOS Prot
--- -------------- ------------- --------- --------- ---- ---
100 10.212.10.11/32 anywhere any any any IP
200 10.212.10.12/32 anywhere any any any IP
300 10.212.10.13/32 anywhere any any any IP
400 10.212.10.14/32 anywhere any any any IP
500 10.212.10.10/32 anywhere any any any IP
10 11 12 13
Seq ACL Rate Limit Exceed Action
--- ---- -------- -------------
10 100 26000 Low
10 200 26000 Low
10 300 26000 Low
10 400 26000 Low
10 500 26000 Low
Legend:
1. The name of the rate limit.
2. The IP interface to which the rate limit is applied.
3. The name of the ACL(s) that define the rate limit.
4. The source address and filtering mask specified by the ACL.
5. The destination address and filtering mask specified by the ACL.
6. The number of the TCP or UDP source port.
7. The number of the TCP or UDP destination port.
8. The Type of Service value.
9. The protocol for the ACL.
10. The sequence number for this policy.
11. The name of the ACL.
12. The rate limit for the flow.
reload Command
Format
reload
Mode
Privileged
Parameters
None.
Restrictions
None.
Chapter 40
rip Commands
The Routing Information Protocol, Version 1 and Version 2 (RIPv1 and RIPv2), is the
most commonly used interior gateway protocol. RIP selects the route with the lowest
metric as the best route. The metric is a hop count representing the number of gateways
through which data must pass in order to reach its destination. The longest path that RIP
accepts is 15 hops. If the metric is greater than 15, a destination is considered unreachable
and the X-Pedition discards the route. RIP assumes that the best route is the one that uses
the fewest gateways, that is, the shortest path. RIPv1 is described in RFC 1058 and RIPv2
is described in RFC 1723.
The rip commands allow the user to display various information about the RIP.
Command Summary
Table 28 lists the rip commands. The sections following the table describe the command
syntax.
rip trace [packets| request| response| local options] [detail] [send| receive]
show rip <option list>
rip trace
Purpose
Traces RIP packets.
Format
rip trace [packets| request| response| local-options] [detail| send| receive]
Mode
Privileged
Description
The rip trace command traces the following sets of RIP packets:
• RIP request packets sent or received by the X-Pedition
• RIP response packets sent or received by the X-Pedition
Depending on the options you specify, you may trace all packets, request packets only, or
receive packets only. In addition, you may choose to trace the request packets, receive
packets, or both that are sent by the X-Pedition, received by the X-Pedition, or all packets
(both sent packets and received packets).
Parameters
packets Traces all RIP packets, both request packets and response packets. This is the
default.
request Traces only request packets, such as REQUEST, POLL and POLLENTRY
packets.
response Traces only response packets.
For the packets, request, and response parameters, you may optionally specify one of the
following:
detail Shows detailed information about the traced packets.
send Shows information about traced RIP packets sent by the X-Pedition.
receive Shows information about traced RIP packets received by the X-Pedition.
Note: The default shows both send and receive packets.
local-options Sets trace options for this protocol only. Specify one or more of the
following:
all Turns on all tracing.
general Turns on normal and route tracing.
state Traces state machine transitions in the protocols.
normal Traces normal protocol occurrences.
Note: Abnormal protocol occurrences are always traced.
policy Traces application of protocol and user-specified policies to
routes being imported and exported.
task Traces system processing associated with this protocol or peer.
timer Traces timer usage by this protocol or peer.
route Traces routing table changes for routes installed by this
protocol or peer.
Restrictions
None.
show rip
Purpose
Displays RIP information.
Format
show rip <option-list>
Mode
Privileged
Description
The show rip command displays RIP information.
Parameters
<option-list>
Specifies the RIP dump information you want to display. Specify one or more of the
following:
all
Displays all RIP tables.
globals
Displays RIP globals.
timers
Displays RIP timers.
interface
Displays RIP interfaces.
active-gateways
Displays active gateways running RIP.
interface-policies
Displays RIP interface policies.
import-policies
Displays RIP import policies.
export-policies
Displays RIP export policies.
Restrictions
None.
rmon Commands
The rmon commands allow the user to display and set parameters for Remote Network
Monitor (RMON) device statistics on a per-port basis. RMON information corresponds to
RFCs 1757 and 2021.
Command Summary
Table 29 lists the rmon commands. The sections following the table describe the command
syntax.
Purpose
Clears currently-selected CLI RMON filters.
Format
clear rmon cli-filter
Mode
Privileged
Description
The clear rmon cli-filter command clears the CLI RMON filters that were applied with
the rmon apply cli-filter command.
Parameters
None.
Restrictions
None.
Purpose
Clears RMON statistics.
Format
clear rmon statistics
Mode
Privileged
Description
The clear rmon statistics command clears RMON statistics for all X-Pedition ports.
When you clear statistics, the X-Pedition sets the counters for the cleared statistics to 0,
then begins accumulating the statistics again.
Parameters
None.
Restrictions
None.
Purpose
Applies a specific CLI RMON filter.
Format
rmon apply cli-filter <filter-id>
Mode
Privileged
Description
The rmon apply cli-filter command applies a specific CLI RMON filter to the current
Telnet or Console session. This enables different users to select the different CLI filters.
Use the rmon clear cli-filter command to clear an applied filter.
Parameter
<filter id> This is a number between 1 and 65535 which identifies the filter ID to
apply.
Restrictions
None.
Example
To apply filter ID 2:
show rmon
Purpose
Displays statistics related to various RMON parameters.
Format
show rmon [alarms| events| filters| history| matrix| packet-capture| status]
Mode
Privileged
Description
The show rmon command displays statistics related to various RMON parameters.
Parameters
alarms Displays the RMON Alarm table.
events Displays configured events and the logs, if any, of triggered events.
filters Displays the contents of the Filter table.
history Displays statistical samples that are stored in the RMON History
group. Entries in this table are created automatically when default
tables are turned on for the Lite group.
matrix Displays entries in the Matrix table. Entries in this table are
automatically created when default tables are turned on for the
Standard group.
Note: If CLI filters have been applied, they will take effect when the
Matrix table is displayed. This command will display control rows and their
corresponding logs only if there are logs. A control row that has no data is
not displayed.
Chapter 42
sfs Commands
Command Summary
Table 30 lists the sfs commands. The sections following the table describe the command
syntax.
Purpose
Displays CDP Hello status of a port.
Format
show sfs cdp-hello port-status <port-list>| all-ports
Mode
Privileged
Description
The show sfs cdp-hello port-status command displays CDP Hello information of X-
Pedition ports.
Parameters
<port-list>| all-ports Specifies the ports for which you want to display information. The
all-ports keyword displays the selected information for all the X-
Pedition ports.
Restrictions
None.
Examples
To display CDP Hello status on all X-Pedition ports:
Purpose
Displays the transmit frequency of CDP Hello packets.
Format
show sfs cdp-hello transmit-frequency
Mode
Privileged
Description
The show sfs cdp-hello transmit-frequency command display the transmit frequency of
CDP Hello packets on the X-Pedition.
Parameters
None.
Restrictions
None.
Examples
To display the transmit frequency of CDP Hello packets:
Chapter 43
smarttrunk Commands
The smarttrunk commands allow the user to display parameters for SmartTRUNK
ports. SmartTRUNK ports are groups of ports that have been logically combined to
increase throughput and provide link redundancy.
Command Summary
Table 31 lists the smarttrunk commands. The sections following the table describe the
command syntax.
Purpose
Clears load distribution statistics for ports in a SmartTRUNK.
Format
clear smarttrunk load-distribution <num>
Mode
Privileged
Description
The clear smarttrunk load-distribution command is used in conjunction with the
show smarttrunk distribution command, which gathers statistics for the transmitted
bytes per second flowing through the SmartTRUNK and each port in it. The clear
smarttrunk load-distribution command lets you reset load distribution statistics to
zero.
Parameters
<num> Specifies name of one or more existing SmartTRUNKs.
Restrictions
None.
Example
To clear load distribution information from SmartTRUNK st.1:
show smarttrunk
Purpose
Displays information about SmartTRUNKs on the X-Pedition
Format
show smarttrunk [distribution| protocol-state| connections] <numlist>
Mode
Privileged
Description
The show smarttrunk command displays statistics about SmartTRUNKs on the X-
Pedition.
Parameters
distribution Provides statistics on how traffic is distributed across the ports in
a SmartTRUNK.
protocol-state Shows information about the control protocol on a
SmartTRUNK.
connections Shows information about the SmartTRUNK connection,
including the MAC address of the remote switch, and the module
number and port number of each remote port. Connection
information is reported only if the Hunt Group protocol is
enabled for the SmartTRUNK.
<numlist > Specifies name of one or more SmartTRUNKs.
Restrictions
None.
Examples
To show how traffic is distributed across the ports on all SmartTRUNKs:
Note: In the example above, SmartTRUNK st.2 has no control protocol enabled, so no
connection information is reported.
Chapter 44
snmp Commands
The snmp commands allow the user to display and test parameters for Simple Network
Management Protocol (SNMP).
Command Summary
Table 32 lists the snmp commands. The sections following the table describe the command
syntax.
show snmp
Purpose
Allows the user to display SNMP parameters, including SNMP community names.
Format
show snmp access| chassis-id| community| mibs| statistics| tfpt| trap
Mode
Privileged
Description
The show snmp command displays the following SNMP information:
• Community strings set on the X-Pedition
• SNMP Statistics
• IP address of SNMP trap target server
Parameters
access Displays the last five SNMP clients to access the X-Pedition.
chassis-id Displays the X-Pedition’s SNMP name.
tftp Displays tftp SNMP status.
trap Displays the IP address of the trap target server.
community Displays the X-Pedition’s community string.
statistics Displays SNMP statistics.
mibs Displays the SNMP MIB registry.
Restrictions
None.
Examples
The following command displays a log of SNMP access to the X-Pedition. The host that
accessed the X-Pedition and the X-Pedition system time when the access occurred are
listed.
Trap Table:
Index Trap Target Addr Community String Status
1. 10.15.1.2 public enabled
2. 1.2.3.4 public123 disabled
3. 5.6.7.8 public20 disabled
Purpose
Tests SNMPv1 notifications to currently configured managers.
Format
snmp test trap type coldstart| linkdown| linkup| ps-failure| ps-recover|
vrrpnewmaster
Mode
Privileged
Description
The snmp test trap command allows the user to test SNMPv1 notifications to currently
configured managers. The user may test the following notification types:
• Coldstart
• Linkdown
• Linkup
• PS-failure
• PS-recover
• VRRPNewMaster
Parameters
coldstart Tests the cold start trap notification.
linkdown Tests link down notification for ifIndex 1.
linkup Tests link up notification for ifIndex 1.
ps-failure Tests the power supply failure trap notification.
ps-recover Tests the power supply recover trap notification.
vrrpNewMasterTests the Virtual Router Redundancy New Master Trap.
Restrictions
None.
sonet Commands
The sonet commands allows the user to display various parameters for Synchronous
Optical Network (SONET) encapsulation. These commands also allow the user to
accommodate Packet-over-SONET (POS) and ATM (Asynchronous Transfer Mode)
transmission using the X-Pedition.
Packet-over-SONET technology provides the ability to transmit IP packets and ATM cells
over a SONET backbone by encapsulating them into a SONET frame. In reference to the
OSI Layer model, the SONET layer rests right beneath the IP layer or the ATM layer.
Based on the transmission mechanism of SONET frames, the result is larger traffic
bandwidth and faster line speed (OC-3), accommodating QoS guarantees as well as the
ability to deliver voice/video data over an internetwork.
SONET frames carry a large amount of data stored as overhead. This overhead
information provide the information for OAM&P (operation, administration,
management, and provisioning) capabilities, such as performance monitoring, automatic
protection switching, and path tracing.
Enterasys SONET technology features Automatic Protection Switching, performance
monitoring capabilities, as well as commercial circuit identification.
Command Summary
Table 33 lists the sonet commands. The sections following the table describe the command
syntax.
Purpose
Displays APS status.
Format
show sonet aps <SONETports>
Mode
Privileged
Description
The show sonet aps command allows the user to display APS (Automatic Protection
Switching) status. This command allows you to display such APS parameters as
protection level, working or protecting port, directionality, and switch status.
Parameters
<SONETports> Specifies the SONET port name(s).
Restrictions
None.
Example
To display the APS status for port so.2.1:
Purpose
Displays loopback status.
Format
show sonet loopback <SONETports>
Mode
Privileged
Description
The show sonet loopback command allows the user to display loopback status for a
specified SONET port. Loopback is used to verify connectivity between two devices.
Parameters
<SONETports> Specifies the SONET port name(s).
Restrictions
None.
Example
To display the loopback status for port so.2.1:
Purpose
Displays SONET optical line values.
Format
show sonet medium <SONET ports>
Mode
Privileged
Description
The show sonet medium command allows the user to display the various SONET optical
line values associated with a SONET port. This command will allow you to display values
such as framing status, line type, and administrator-specified circuit identifier.
Parameters
<SONETports> Specifies the SONET port name(s).
Restrictions
None.
Example
To display optical line values for port so.2.1:
Purpose
Displays received path trace messages.
Format
show sonet pathtrace <SONETports>
Mode
Privileged
Description
The show sonet pathtrace command allows the user to display path trace messages
received on a specified SONET port.
Parameters
<SONETports> Specifies the SONET port name(s).
Restrictions
None.
Example
To display the path trace messages for port so.2.1:
Chapter 46
statistics Commands
The statistics commands allow the user to display statistics for various X-Pedition
features. The user may also clear some statistics.
Command Summary
Table 34 lists the statistics commands. The sections following the table describe the
command syntax.
clear interface
Purpose
Clears various statistics.
Format
clear interface [<port-list>] [errors|packets|statistics]
Mode
Privileged
Description
The clear interface command clears port statistics, error statistics, or RMON statistics.
When you clear statistics, the X-Pedition sets the counters for the cleared statistics to 0,
then begins accumulating the statistics again.
Parameters
<port-list>
The ports for which you are clearing statistics. You can specify a single port or a
comma-separated list of ports. Example: ethernet1/3,ethernet.(1-3).(4,6-8). If no port
is specified, the clear interface command will clear statistics for all X-Pedition ports.
errors Clears all error statistics for the specified port.
packets Clears all packet statistics for the specified port.
statistics Clears all normal (non-error) statistics for the specified port.
Restrictions
None.
clear ip statistics
Purpose
Clears Internet Protocol (IP) statistics.
Format
clear ip statistics
Mode
Privileged
Description
The clear ip statistics command clears IP statistics for all X-Pedition ports. When you
clear statistics, the X-Pedition sets the counters for the cleared statistics to 0, then begins
accumulating the statistics again.
Parameters
None.
Restrictions
None.
Purpose
Clears IPX statistics.
Format
clear ipx statistics
Mode
Privileged
Description
The clear ipx statistics command clears IPX statistics for all X-Pedition ports. When you
clear statistics, the X-Pedition sets the counters for the cleared statistics to 0, then begins
accumulating the statistics again.
Parameters
None.
Restrictions
None.
Purpose
Displays internet control message protocol (ICMP) statistics.
Format
show ip icmp statistics
Mode
Privileged
Parameters
None.
Restrictions
None.
Example
To display ICMP statistics:
• messages with bad code fields Displays the number of ICMP messages
processed by the router with a bad code field. The
code field within the ICMP header uses a number
to specify the message content of the ICMP
message. An invalid number within the code field
would show in this statistic parameter.
• messages smaller than min length Displays the number of ICMP messages
processed by the router that didn’t meet a
minimum length requirement.
• message responses generated Displays the number of ICMP responses that have
been generated by the router in response to ICMP
messages.
show ip multicast
Purpose
Displays multicast statistics.
Format
show ip multicast
Mode
Privileged
Parameters
None.
Restrictions
None.
Example
To display multicast statistics:
show ip traffic
Purpose
Displays Internet Protocol (IP) and unicast IP routing statistics.
Format
show ip traffic
Mode
Privileged
Parameters
None.
Restrictions
None.
Example
To display IP and IP routing statistics:
IP Statistics:
• packets w/size smaller than min Displays the number of IP packets received by the
router that didn’t meet a minimum length
requirement.
• packets w/data size<data length Displays the number of IP packets received by the
router containing a data size smaller than the
specified data length. The data length field in
the IP header specifies the data length
contained within the packet.
• packets w/header length<data size Displays the number of IP packets received by the
router containing a IP header length smaller
than the data size within the packet.
• packets w/data length<header length Displays the number of IP packets received by the
router containing a data length smaller than
the IP header length.
• packets w/incorrect version number Displays the number of IP packets received by the
router with an incorrect IP version number.
The IP version number field in the IP header
is used to specify whether the packet is
formatted for IPv4 or IPv6.
• packets for this host Displays the total number of IP packets received
that were intended for the router as the
destination.
• packets for unknown protocol Displays the number of IP packets received by the
router that is of an unknown or unsupported
routed protocol.
• packets sent from this host Displays the total number of IP packets sent out
by the router.
• packets sent w/fabricated ip header Displays the total number of IP packets sent out
by the router after attaching an IP header onto
the packet.
• output packets dropped due to no bufsDisplays the total number of IP packets dropped
before being sent out by the router because of
lack of output buffer space.
• output datagrams fragmented Displays the total number of datagrams that were
fragmented into two or more IP packets
before being sent out by the router.
• datagrams that can’t be fragmented Displays the total number of datagrams that was
not successfully fragmented into two or more
IP packets.
Routing Statistics:
• new gateways due to redirects Displays the number of new gateways have been
added into the routing table due to redirects.
Purpose
Displays internetwork packet exchange (IPX) and IPX routing statistics.
Format
show ipx traffic
Mode
Privileged
Parameters
None.
Restrictions
None.
Example
To display IPX statistics:
Purpose
Displays port error statistics.
Format
show port errors [<port-list>]
Mode
Privileged
Parameters
<port-list> Specifies the port. If no port is specified, command will display port error
statistics for all physical and logical ports.
Restrictions
None.
Example
To display port error statistics on port ethernet2/1:
Port: et.2.1
----
Error Stats Error Stats
----------- -----------
Purpose
Displays port packet statistics.
Format
show port packets [<port-list>]
Mode
Privileged
Parameters
<port-list> Specifies the port. If no port is specified, command will display port
packet statistics for all physical and logical ports.
Restrictions
None.
Example
To display port packet statistics on port et.2.1:
Port: et.2.1
----
RMON Stats Received Transmitted
Unicast frames 0 0
Multicast frames 0 0
Broadcast frames 0 0
64 byte frames 0 0
Purpose
Displays normal (non-error) port statistics.
Format
show port stats [<port-list>]
Mode
Privileged
Parameters
<port-list> Specifies the port. If no port specified, command will display port
statistics for all physical and logical ports.
Restrictions
None.
Example
To display port statistics on port et.2.1:
Port: et.2.1
-------------
Port Stats Received Transmitted
Frames/Packets 0 0
. Bridged bytes 0 0
. Routed bytes 0 0
. Packet discards 0 0
. Packet errors 0 0
. Unicast packets 0 0
. Multicast packets 0 0
. Broadcast packets 0 0
• Frames/Packets
• Switched framesShows the number of frames that have been bridged or forwarded.
• Local framesShows the number of local frames (frames destined for a port that is the
same as the port of entry) that was dropped.
• Routed packets
• Switched (data)Shows the number of packets that was forwarded by the hardware.
• Consumed by CPUShows the number of packets that was sent to the control module
to be forwarded.
• Bytes
• Bridged bytesShows the number of total bytes that has been bridged.
• Routed bytesShows the number of total bytes that has been routed.
• IPX table misses Shows the number of times that an IPX packet
could not be resolved by the IPX Routing Table.
• IPX TC expirations Shows the number of IPX packets that have been
received by the port with a TC header with a value
of 1. The IPX packet will then be expired at this
point.
• Packet errorsShows the number of packets containing errors that was seen by the port
within a one-minute time period.
• Unicast packetsShows the number of unicast packets that was seen by the port within
a one-minute time period.
• Multicast packetsShows the number of multicast packets that was seen by the port
within a one-minute time period.
• Broadcast packetsShows the number of broadcast packets that was seen by the port
within a one-minute time period.
• Port stats Cleared Shows the date and time when the port stats were
last cleared.
Purpose
Displays active tasks.
Format
show processes cpu
Mode
Privileged
Parameters
None.
Restrictions
None.
Example
To display active tasks:
show rarp
Purpose
Displays reverse ARP statistics.
Format
show rarp [<IFname>]
Mode
Privileged
Parameters
<IFname> Specifies the interface name. If no interface name specified, command
will display reverse ARP statistics for all interfaces.
Restrictions
None.
Example
To display reverse ARP statistics on interface ‘en0’:
Interface en0:
0 requests received
0 replies sent
0 requests received on interface with rarpd disabled
0 requests received that failed sanity check
0 requests received that did not result in a match
Last 5 Requests Received
----- no rarp requests received -----
Last 5 Replies Sent
----- no rarp replies sent -----
Purpose
Displays Transmission Control Protocol (TCP) statistics.
Format
show tcp statistics
Mode
Privileged
Parameters
None.
Restrictions
None.
Example
To display TCP statistics:
show traffic
Purpose
Displays recent traffic summary statistics.
Format
statistics show summary-stats
Mode
Privileged
Parameters
None.
Restrictions
None.
Purpose
Displays User Datagram Protocol (UDP) statistics.
Format
show udp statistics
Mode
Privileged
Parameters
None.
Restrictions
None.
Example
To display UDP statistics:
stp Command
The show stp command displays Shielded Twisted Pair (STP) bridging information.
Format
show stp [bridge]
Mode
Privileged
Description
The show stp command, when followed by the bridge keyword, displays STP bridging
information for the X-Pedition.
Parameters
bridge Displays information for STP bridging.
Restrictions
None.
Chapter 48
system Commands
The system commands allow the user to display and change system parameters.
Command Summary
Table 35 lists the system commands. The sections following the table describe the
command syntax.
clock set
Purpose
Sets the system time and date.
Format
clock set <hh:mm:ss d m y>
Mode
Privileged
Description
The clock set command sets the system time and date for the X-Pedition. The X-Pedition
keeps the time in a battery-backed real-time clock. To display the time and date, enter the
show clock command.
Parameters
hh: A number from 0 - 23 for the hour, in military time. (Example: 06: [6 a.m.];
18: [6 p.m.]; the number 00 means midnight)
mm: A number from 0 - 59 for the minutes.
ss A number from 0 - 59 for the second.
day A number from 1 – 31 for the day.
month Name of the month. You must spell out the month name. (Example: March).
year Four-digit number for the year. (Example: 2000)
Restrictions
None.
disconnect
Purpose
Disconnects a specified Telnet session.
Format
disconnect <session-id>
Mode
Privileged
Description
The disconnect command kills the Telnet session specified by the session ID. Use the
show users command to display the list of current Telnet users and session IDs.
Parameters
<session-id>
The Telnet connection slot number, which can be 0, 1, 2, or 3. The show users
command displays the session ID number in the first column. You can only specify
one session ID per disconnect command.
Restrictions
None.
Example
To show the active Telnet sessions.
xp# disconnect 2
Telnet session 2 (from 10.9.0.1) killed
The example above shows the contents of the boot log file, which contains all the system
messages generated during bootup.
erase
Purpose
Deletes a system software image file from the PCMCIA flash card.
Format
erase <filename> primary-cm| backup-cm
Mode
Privileged
Description
The erase command deletes a system software image file from the PCMCIA flash card on
the Control Module.
Parameters
<filename> The name of the system software image file you want to delete.
primary-cm This parameter deletes the image file from the primary control module.
backup-cm This parameter deletes the image file from the backup control module.
Restrictions
None.
show bootlog
Purpose
Displays bootlog information.
Format
show bootlog
Mode
Privileged
Description
The show bootlog command displays the contents of the boot log file, which contains
all the system messages generated during bootup.
Parameters
None.
Restrictions
None.
show bootprom
Purpose
Displays bootprom information.
Format
show bootprom
Mode
Privileged
Description
The show bootprom command displays boot PROM parameters for TFTP
downloading of the system image. This information is useful only if you have
configured the system to download the system image via TFTP.
Parameters
None.
Restrictions
None.
show buffers
Purpose
Displays usage information.
Format
show buffers
Mode
Privileged
Description
The show buffers command displays usage information about various resources on the
X-Pedition.
Parameters
None.
Restrictions
None.
show clock
Purpose
Displays system time and date.
Format
show clock
Mode
Privileged
Description
The show clock command displays the system time and date determined with the clock
set command.
Parameters
None.
Restrictions
None.
show contact
Purpose
Displays contact information.
Format
show contact
Mode
Privileged
Description
The show contact command displays administrator contact information.
Parameters
None.
Restrictions
None.
show diagbus
Purpose
Displays system hardware information.
Format
show diagbus
Mode
Privileged
Description
The show diagbus command displays system hardware information.
Parameters
None.
Restrictions
None.
show environment
Purpose
Displays system environment information.
Format
show environment
Mode
Privileged
Description
The show environment command displays system environment information, such as
temperature and power supply status.
Parameters
None.
Restrictions
None.
show flash
Purpose
Lists the system software image files on the PCMCIA flash card.
Format
show flash backup-cm| primary-cm
Mode
Privileged
Description
The show flash command lists the system software image files contained on the PCMCIA
flash card on the Control Module.
Parameters
backup-cm This parameter lists the image files on the backup control module.
primary-cm This parameter lists the image files on the primary control module.
Restrictions
None.
show location
Purpose
Displays location of the X-Pedition.
Format
show location
Mode
Privileged
Description
The show location command displays the location of the X-Pedition.
Parameters
None.
Restrictions
None.
show login-banner
Purpose
Displays login banner for the X-Pedition.
Format
show login-banner
Mode
Privileged
Description
The show login-banner command displays the X-Pedition’s login banner.
Parameters
None.
Restrictions
None.
show logging
Purpose
Displays SYSLOG information.
Format
show logging
Mode
Privileged
Description
The show logging command displays the IP address of the SYSLOG server and the
level of messages the X-Pedition sends to the server.
Parameters
None.
Restrictions
None.
Purpose
Displays SYSLOG buffer information.
Format
show logging buffer
Mode
Privileged
Description
The show logging buffer command shows how many SYSLOG messages the X-
Pedition’s SYSLOG message buffer can hold.
Parameters
None.
Restrictions
None.
show memory
Purpose
Displays memory resource information.
Format
show memory
Mode
Privileged
Description
The show logging buffer command displays information about memory resources on
the X-Pedition.
Parameters
None.
Restrictions
None.
show name
Purpose
Displays the X-Pedition’s name.
Format
show name
Mode
Privileged
Description
The show name command displays the name of the X-Pedition.
Parameters
None.
Restrictions
None.
show poweron-selftest-mode
Purpose
Displays Power-On Self Test (POST) information.
Format
show poweron-selftest-mode
Mode
Privileged
Description
The show poweron-selftest-mode command displays the type of Power-On Self Test
(POST) that should be performed, if any.
Parameters
None.
Restrictions
None.
show processes
Purpose
Displays information on the CPU.
Format
show processes
Mode
Privileged
Description
The show processes command displays the percentage of the CPU that is currently
being used.
Parameters
None.
Restrictions
None.
show running-config
Purpose
Displays system’s active configuration.
Format
show running-config
Mode
Privileged
Description
The show running-config command displays the active configuration of the system.
Parameters
None.
Restrictions
None.
show scratchpad
Purpose
Displays configuration information.
Format
show scratchpad
Mode
Privileged
Description
The show scratchpad command displays the configuration changes in the scratchpad.
These changes have not yet been activated.
Parameters
None.
Restrictions
None.
show sessions
Purpose
Displays Telnet session information.
Format
show sessions
Mode
Privileged
Description
The show sessions command lists the last five Telnet connections to the X-Pedition.
Parameters
None.
Restrictions
None.
show startup-config
Purpose
Displays contents of startup configuration file.
Format
show startup-config
Mode
Privileged
Description
The show startup-config command displays the contents of the startup configuration
file.
Parameters
None.
Restrictions
None.
show terminal
Purpose
Displays terminal information.
Format
show terminal
Mode
Privileged
Description
The show terminal command displays default terminal settings (number of rows,
number of columns, and baud rate).
Parameters
None.
Restrictions
None.
show timezone
Purpose
Displays the time zone.
Format
show timezone
Mode
Privileged
Description
The show timezone command shows the time zone offset from UCT in minutes.
Parameters
None.
Restrictions
None.
show uptime
Purpose
Displays up-time information.
Format
show uptime
Mode
Privileged
Description
The show uptime command shows how much time has elapsed since the most recent
reboot.
Parameters
None.
Restrictions
None.
show users
Purpose
Shows current Telnet connections to the X-Pedition.
Format
show users
Mode
Privileged
Description
The show users command shows all current Telnet connections to the X-Pedition.
Parameters
None.
Restrictions
None.
show version
Purpose
Shows software version running on X-Pedition.
Format
show version
Mode
Privileged
Description
The show version command displays the software version currently running on the X-
Pedition.
Parameters
None.
Restrictions
None.
system hotswap
Purpose
Activates or deactivates a line card.
Format
system hotswap out| in <channel number>
Mode
Privileged
Description
The system hotswap out command deactivates a line card in a specified slot on the X-
Pedition, causing it to go offline. The command performs the same function as if you had
pressed the Hot Swap button on the line card.
The system hotswap in command causes a line card that was deactivated with the system
hotswap out command to go online again. The command performs the same function as if
you had removed the card from its slot and inserted it again.
See the Enterasys X-Pedition User Reference for more information on hot swapping line
cards.
Parameters
out Causes the line card in the specified slot to be deactivated.
in Causes an inactive line card in the specified slot to be reactivated.
Note: The system hotswap in command works only on a line card that was
deactivated with the system hotswap out command.
<channel number>
Specifies the slot where the line card resides. Enter any number between 0-15.
Restrictions
None.
Example
To deactivate the line card in slot 7 on the X-Pedition:
system image-choose
Purpose
Selects a system software image file.
Format
system image-choose <filename> primary-cm| backup-cm
Mode
Privileged
Description
The system image-choose command specifies the system software image file on the
PCMCIA flash card that you would like the X-Pedition to use the next time you reboot the
system.
Parameters
<filename> The name of the system software image file. If you would like to specify no
image chosen for the next reboot, enter none.
primary-cm This parameter specifies that the image file is chosen for the primary control
module.
backup-cm This parameter specifies that the image file is chosen for the backup control
module.
Restrictions
None.
system promimage-upgrade
Purpose
Upgrades the boot PROM software on the Control Module.
Format
system promimage-upgrade <hostname-or-IPaddr> <filename>
Mode
Privileged
Description
The system promimage-upgrade command copies and installs a boot PROM software
image from a TFTP server onto the internal memory on the Control Module. The boot
PROM software image is loaded when you power on the X-Pedition and in turn loads the
system software image file.
Parameters
<hostname-or-IPaddr>
The host name or IP address of the TFTP server or a TFTP URL.
<filename>
The name of the boot PROM software image file.
Restrictions
None.
Example
The command in the following example downloads a boot PROM image file from the
TFTP server 10.50.89.88.
tacacs-plus Command
The show tacacs command displays information about TACACS Plus configuration on
the X-Pedition.
Format
show tacacs
Mode
Enable
Description
The show tacacs command displays statistics and configuration parameters related to
TACACS Plus configuration on the X-Pedition. The statistics displayed include:
accepts Number of times each server responded and validated the user successfully.
rejects Number of times each server responded and denied the user access, either
because the user wasn’t known, or the wrong password was supplied.
timeouts Number of times each server did not respond.
Parameters
None.
Restrictions
None.
tech-support Command
The show tech-support command displays general information about the X-Pedition for
use when reporting a problem.This command is available in Common CLI syntax only.
Format
show tech-support
Mode
Privileged
Description
The show tech-support command simultaneously lists the information found in each of
the following system commands:
• show buffers
• show hardware
• show interfaces
• show processes
• show running-config
• show version
This information is helpful when reporting a problem to Enterasys Technical Support.
Parameters
None.
telnet Command
Format
telnet <hostname-or-IPaddr> <socket-number>
Mode
User or Privileged
Description
The telnet command allows you to open a Telnet session to the specified host.
Parameters
<hostname-or-IPaddr>
The host name or IP address of the remote computer that you would like to access.
<socket-number>
The TCP port through which the Telnet session will be opened. If this parameter is not
specified, the Telnet port (socket number 23) is assumed. This parameter can be used
to test other ports; for example, socket number 21 is the port for FTP.
Restrictions
None.
The terminal cli native command switches the CLI environment over to the Native CLI
engine.
Format
terminal cli native
Mode
Privileged
Description
The terminal cli native command switches the CLI environment over to the Native CLI
engine. When executed in Privileged mode, the CLI of the system will become configured
to use the Native CLI commands and attributes.
Note: All current and future login sessions will use the Native CLI, until the user
switches back to the Common CLI engine.
Parameters
None.
Restrictions
None.
traceroute Command
The traceroute command traces the path a packet takes to reach a remote host.
Format
traceroute <host> [max-ttl <num>] [probes <num>] [size <num>] [source <host>]
[tos <num>] [wait-time <secs>] [verbose] [noroute]
Mode
User
Description
The traceroute command traces the route taken by a packet to reach a remote IP host. The
traceroute command examines the route taken by a packet traveling from a source to a
destination. By default, the source of the packet is the X-Pedition. However, one can
specify a different source and track the route between it and a destination. The route is
calculated by initially sending a probe (packet) from the source to the destination with a
TTL of 1. Each intermediate router that is not able to reach the final destination directly
will send back an ICMP Time Exceeded message. Subsequent probes from the source will
increase the TTL value by 1. As each Time Exceeded message is received, the program
keeps track of the address of each intermediate gateway. The probing stops when the
packet reaches the destination or the TTL exceeds the max-ttl value.
Parameters
<host>
Hostname or IP address of the destination
max-ttl <num>
Maximum number of gateways (“hops”) to trace
Restrictions
None.
Example
To display the route from the X-Pedition to the host othello in verbose mode:
vlan Command
The show vlan command displays a list of all VLANs active on the X-Pedition.
Format
show vlan
Mode
Privileged
Description
The show vlan command lists all the VLANs that have been configured on the X-
Pedition.
Parameters
None.
Restrictions
None.
Chapter 55
web-cache Commands
The web-cache commands allow you to transparently redirect HTTP requests to a group
of local cache servers. This feature can provide faster user responses and reduce demands
for WAN bandwidth.
Command Summary
Table 36 lists the web-cache commands. The sections following the table describe the
command syntax.
clear ip web-cache
Purpose
Clears statistics for the specified caching policy.
Format
clear ip web-cache all| cache-name <cache-name>
Mode
Privileged
Description
The clear web-cache command allows the user to clear statistics for all caching policies
or for specified policies.
Parameters
all
Clears statistics for all caching policies.
cache-name <cache-name>
Clears statistics for the specified caching policy.
Restrictions
None.
Examples
To clear statistics for the caching policy ‘websrv1’:
show ip web-cache
Purpose
Displays information about caching policies.
Format
show ip web-cache [all] [cache-name <cache-name>| all] [servers cache <cache-
name>| all]
Mode
Privileged
Description
The show web-cache command allows the user to display web caching information for
specific caching policies or server lists.
Parameters
all
Displays all web cache information for all caching policies and all server lists.
cache-name <cache-name>| all
Displays web cache information for the specified caching policy. all displays all
caching policies.
servers cache <cache-name>| all
Displays information for the servers configured for the specified caching policy. all
displays all configured cache servers.
Restrictions
None.
Examples
To display web cache information for a specific caching policy:
5 6 7 8 9 10 11
ACL Source IP/Mask Dest. IP/Mask SrcPort DstPort TOS Port
--- -------------- ------------- --------- --------- --- ----
deny207 172.89.1.1/32 207.135.0.0/16 any http 0 IP
12 13 14
Server Max con IP address
---- -- ------- ----------
s1 2000 176.89.10.50 - 176.89.10.60
Access Users 15
------ -----
Permit All Users
Deny profile deny207
Legend:
1. The name of the cache policy.
2. The outbound interface where the cache policy was applied, typically an interface that
connects to the Internet.
3. Destination sites for which HTTP requests are not redirected to cache servers and are
sent direct.
4. The HTTP port used by a proxy server.
5. The names of the profiles (created with an acl statement) associated with this cache
policy.
6. The source address and filtering mask.
7. The destination address and filtering mask.
8. The source port.
9. The destination port.
10. The TOS value in the packet.
11. The protocol.
12. The server list name.
13. The maximum number of connections that can be handled by each server in the server
list.
14. The list or range of IP addresses of the servers in the server list.
15. The hosts (users) whose HTTP requests are redirected to the cache servers and the
hosts whose HTTP requests are not redirected to the cache servers. If no permit
command is specified, all HTTP requests are redirected to the cache servers.
To display information for all configured web cache servers:
2 3 4 5 6
Block IP address Max Conn Used Cnt Status
----- ---------- -------- -------- ------
s1 176.89.10.50 2000 0 Down
s1 176.89.10.51 2000 0 Down
s1 176.89.10.52 2000 0 Down
s1 176.89.10.53 2000 0 Down
s1 176.89.10.54 2000 0 Down
s1 176.89.10.55 2000 0 Down
s1 176.89.10.56 2000 0 Down
s1 176.89.10.57 2000 0 Down
s1 176.89.10.58 2000 0 Down
s1 176.89.10.59 2000 0 Down
s1 176.89.10.60 2000 0 Down
Legend:
1. The name of the cache policy.
2. The server list name.
3. The IP address of a server in the server list.
4. The maximum number of connections that can be handled by the server.
5. The number of connections currently being handled by the server.
6. The current status of the server.
CLI Conversion
Matrix
The following matrix allows the user to convert X-Pedition Native CLI commands to
Common CLI commands.
acl clearcounters aclname all | interface | clear access-list counters <num> | <name> PRIV
service | port
acl show [aclname <string> | all] | show access-lists [<num> | <string> | PRIV
[interface <string> | all-ip] | [service] | [port {interface <string> | all-ip} | service | {port
<port-list> | all-ports] | [all] <port-list> \ all-ports}]
AGING COMMANDS
ARP COMMANDS
arp add <host> mac-addr <MAC-addr> arp add <host> mac-addr <MAC-addr> PRIV
exit-port <port> keep-time <seconds> exit-port <port> keep-time <seconds>
arp clear <host> | all [interface <string> | arp clear <host> mac-addr <MAC-addr> PRIV
all] [port <port>] exit-port <port> keep-time <seconds>
arp show <IPaddr> | all [undecoded] arp show <IPaddr> | all [undecoded] PRIV
[unresolved] [interface <string> | all] [port [unresolved] [interface <string> | all] [port
<port>] <port>]
ATM COMMAND
BGP COMMANDS
bgp show routes <IPaddr-mask> | default | show ip bgp [<IPaddr> <IPmask>] [to- PRIV
all [to-terminal | to-file] file]
bgp show peer-host <IPaddr> received- show ip bgp neighbor <IPaddr> routes | PRIV
routes | all-received-routes | advertised- received-routes | advertised-routes [to-file]
routes [to-terminal | to-file]
bgp show peer-as <number> [to-terminal | show ip bgp peer-as <number> [to-file] PRIV
to-file]
bgp show peer-group-type external | internal show ip bgp peer-group external | internal | PRIV
| igp | routing [to-terminal | to-file] igp | routing [to-file]
bgp show summary [to-terminal | to-file] show ip bgp summary [to-file] PRIV
CLI COMMANDS
cli set history size <num> | default | terminal history size <buffer-size> USER
maxsize
cli set terminal rows <num> columns terminal length <screen-length> USER
<num> terminal width <line-length>
COPY COMMANDS
DHCP COMMANDS
dhcp show binding [active | expired | static] show ip dhcp binding [active | expired | PRIV
static]
DVMRP COMMANDS
dvmrp show routes host <IPaddr> | show ip dvmrp route [<port-list> | PRIV
interface <IPaddr> | net <netaddr> | router <IPaddr>]
<IPaddr>
ENABLE COMMAND
EXIT COMMAND
FDDI COMMANDS
fddi show fddi-fdx-mode | fddi-mode | fddi- show fddi fddi-fdx-mode | fddi-mode | fddi- PRIV
status | mac-group | mac-restricted-token | status | mac-group | mac-restricted-token |
media-type | path-group | port-group | ring- media-type | path-group | port-group | ring-
purger | smt-config | smt-group | translation | purger | smt-config | smt-group | translation |
version <port-list> | all-ports version <port-list> | all-ports
FILE COMMANDS
FILTERS COMMANDS
filters show port-address-lock [ports <port- show filters [port-address-lock] [ports PRIV
list>] [vlan <VLANnum>] [source-mac <port-list>] [vlan <VLANnum>] [source-
<MACaddr>] mac <MACaddr>]
filters show static-entry [all-source | all- show filters [static-entry] [all-source | all- PRIV
destination | allow-flow] ports <port-list> destination | allow-flow] ports <port-list>
vlan <VLANnum> [source-mac vlan <VLANnum> [source-mac
<MACaddr> dest-mac <MACaddr>] <MACaddr> dest-mac <MACaddr>]
IGMP COMMANDS
igmp show interfaces [group <IPaddr> | show ip igmp interface <port-list> PRIV1
interface <name/IPaddr>]
igmp show memberships [group <IPaddr> | show ip igmp groups <IPaddr> PRIV
port <port-list>]
IP COMMANDS
IP-POLICY COMMANDS
ip-policy clear policy-name <name> | all clear route-map [policy-name <name> | all] PRIV
IP-REDUNDANCY COMMANDS
ip-redundancy clear vrrp-stats interface clear vrrp <VRid> interface <name> PRIV
<name> id <VRid>
ip-redundancy set vrrp <VRid> interface show vrrp <VRid> interface <name> PRIV
<name> [priority <num>] [adv-interval
<num>] [preempt-mode enabled | disabled |
owner-disabled] [auth-type none | text]
[auth-key <key>] [warmup-period <num>]
IP-ROUTER COMMANDS
ip-router find route <IPaddr> [ignore-state] ip find rib-route <IPaddr> [ignore-state] PRIV
ip-router show state [all] [memory] [timers] show ip route state PRIV
[to-file] [to-terminal] [task <string> | all |
gii | icmp | inet | interface | krt | route]
IPX COMMANDS
ipx find sap <type> | all <SRVCname> | all ipx find sap <type> | all <SRVCname> | all PRIV
<network> | all <entrytype> <network> | all <entrytype>
ipx show interfaces <interface> [brief] show ipx interface [<interface>] PRIV
ipx show servers hops | net | name | type show ipx servers {sorted [hops | net | name | USER
type]} | unsorted
ipx show tables routing | rip | sap | summary show ipx route USER
l2-tables show all-flows {vlan <VLANnum> show mac-address-table all-flows [vlan USER
[source-mac <MACaddr>]} [undecoded] <VLANnum>] [source-mac <MACaddr>] PRIV
[undecoded]
l2-tables show port-mac <port-list> | all- show mac-address-table port-macs <port- USER
ports {[vlan <VLANnum>] [source] list> | all-ports {verbose [vlan PRIV
[destination] [multicast] [undecoded] [no- <VLANnum>] [source] [destination]
stats] verbose} [multicast] [undecoded] [no-stats]}
LFAP COMMANDS
LOAD-BALANCE COMMANDS
LOGOUT COMMAND
MTRACE COMMAND
MULTICAST COMMANDS
multicast show mroutes [child <IPaddr>] show mroute [child <IPaddr>] [group PRIV
[group <IPaddr>] [parent <IPaddr>] <IPaddr>] [parent <IPaddr>]
NAT COMMANDS
NTP COMMANDS
OSPF COMMANDS
PING COMMAND
PORT COMMANDS
port show autonegotiation <port-list> | all- show port autonegotiation <port-list> | all- PRIV
ports ports
port show MAU <port-list> | all-ports show port MAU <port-list> PRIV
port show MAU-statistics <port-list> | all- show port MAU-statistics <port-list> PRIV
ports
port show mirroring-status <port-list> | all- show port-mirroring [<port-list> | acls] PRIV
ports | all-acls
port show port-status <port-list> | all-ports show port status <port-list> PRIV
port show stp-info <port-list> | all-ports show stp interface <port-list> PRIV
port show pvst-info <port-list> | all-ports show pvst <name> interface <port-list> PRIV
port show vlan-info <port-list> | all-ports show vlan interface <port-list> PRIV
PPP COMMANDS
ppp clear stats-counter [frame-drop-qdepth- clear ppp stats-counter ports <port-list> PRIV
counter] [max-frame-enqued-counter] {[frame-drop-qdepth-counter] [max-frame-
[frame-drop-red-counter] [rmon] port enqued-counter] [frame-drop-red-counter]
<port-list> [rmon]}
ppp restart lcp-ncp ports <port-list> ppp restart lcp-ncp ports <port-list> PRIV
ppp show mlp <port-list> | all-ports show ppp mlp <port-list> | all-ports PRIV
ppp show service <service-name> | all show ppp service <service-name> | all PRIV
ppp show stats port <port> [bridge-ncp] show ppp stats port <port> [bridge-ncp] PRIV
[ip-ncp] [link-status] [summary] [ip-ncp] [link-status] [summary]
QOS COMMANDS
qos show l2 all-destination all-flow ports show qos l2 all-destination all-flow ports PRIV
<port-list> vlan <VLANnum> source-mac <port-list> vlan <VLANnum> source-mac
<MACaddr> dest-mac <MACaddr> <MACaddr> dest-mac <MACaddr>
qos show wred [input port <port-list> | all- show qos wred [input port <port-list> | all- PRIV
ports] [port <port-list> | all-ports] ports] [port <port-list> | all-ports]
qos show wfq port <port-list> | all-ports show qos wfq <port-list> | all-ports PRIV
RADIUS COMMAND
RARPD COMMAND
RATE-LIMIT COMMAND
rate-limit show [all] | [policy-type flow- show rate-limit [all] | [policy-type flow- PRIV
policies | aggregate-policies | portlevel- policies | aggregate-policies | portlevel-
policies | all] | [policy-name <name>] | policies | all] | [policy-name <name>] |
[interface <interface>] | [port-level port [interface <interface>] | [port-level port
<port-list> | all-port] | [port-level policy- <port-list> | all-port] | [port-level policy-
name <name>] | [rate-limiting-mode] name <name>] | [rate-limiting-mode]
REBOOT COMMAND
RIP COMMANDS
rip trace [packets | request | response | local- rip trace [packets | request | response | local- PRIV
options] [detail] [send | receive] options] [detail] [send | receive]
RMON COMMANDS
rmon show <option-list> show rmon [alarms | capture | events | filter | PRIV
history | matrix | statistics | task | topn]
SFS COMMANDS
sfs show cdp-hello port-status <port-list> | show sfs cdp-hello port-status <port-list> | PRIV
all-ports all-ports
SMARTTRUNK COMMANDS
SNMP COMMANDS
SONET COMMANDS
STATISTICS COMMANDS
statistics clear [port-errors | port-packets | clear interface [<port-list>] [errors | packets PRIV
port-stats] <port-list> | statistics]
statistics show port-errors <port-list> | all- show port errors [<port-list>] PRIV
ports
statistics show port-stats <port-list> | all- show port stats [<port-list>] PRIV
ports
STP COMMAND
SYSTEM COMMANDS
system set date year <num> month <num> clock set <hh:mm:ss> <day> <month> PRIV
day <num> hour <num> min <num> <year>
second <num>
system image delete <filename> [primary- erase <filename> [primary-cm | backup- PRIV
cm | backup-cm] cm]
system hotswap [out | in] channel system hotswap [out | in] channel PRIV
<number> <number>
system image choose <filename> [primary- system image choose <filename> [primary- PRIV
cm | backup-cm | none] cm | backup-cm]
TACACS COMMAND
TACACS-PLUS COMMAND
TELNET COMMAND
traceroute <host> [max-ttl <num>] [probes traceroute <host> [max-ttl <num>] [probes USER
<num>] [size <num>] [source <host>] [tos <num>] [size <num>] [source <host>] [tos
<num>] [wait-time <secs>] [verbose] <num>] [wait-time <secs>] [verbose]
[noroute] [noroute]
VLAN COMMAND
WEB-CACHE COMMANDS
web-cache clear [all | cache-name <cache- clear ip web-cache [all | cache-name PRIV
name>] <cache-name>]
web-cache show [all] [cache-name <cache- show ip web-cache [all] [cache-name PRIV
name> | all] [servers cache <cache-name> | <cache-name> | all] [servers cache <cache-
all] name> | all]