ServerIron ADX Switch and Router Guide
12.0.00
June 10, 2009

Table of Contents Previous Next Print


Configuring IP > Displaying IP Configuration Information and Statistics

Displaying IP Configuration Information and Statistics
The following sections describe IP display options for Layer 3 Switches and Layer 2 Switches.
Changing the Network Mask Display to Prefix Format
By default, the CLI displays network masks in classical IP address format (example: 255.255.255.0). You can change the displays to prefix format using the following CLI method.
To enable CIDR format for displaying network masks, entering the following command at the global CONFIG level of the CLI:
ServerIron(config)# ip show-subnet-length
Syntax: [no] ip show-subnet-length
Displaying Information for Jumbo Packets
The output of the show interfaces ethernet and show statistics ethernet command displays information about the number of packets received that were longer than 1518 octets. In the following examples, this output is highlighted in bold.
Syntax: show statistics ethernet
Displaying IP Information – ServerIron ADX running router code
You can display the following IP configuration information statistics on a ServerIron ADX:
The sections below describe how to display this information.
Displaying Global IP Configuration Information
To display global IP configuration information for the router, use one of the following methods.
USING THE CLI
To display IP configuration information, enter the following command at any CLI level:
Syntax: show ip
NOTE: This command has additional options, which are explained in other sections in this guide, including the sections below this one.
This display shows the following information.
 
Table 9.6: CLI Display of Global IP Configuration Information – Layer 3 Switch  
The Time-To-Live (TTL) for IP packets. The TTL specifies the maximum number of router hops a packet can travel before reaching the Brocade router. If the packet’s TTL value is higher than the value specified in this field, the Brocade router drops the packet.
The ARP aging period. This parameter specifies how many minutes an inactive ARP entry remains in the ARP cache before the router ages out the entry.
The maximum number of hops away a BootP server can be located from the Brocade router and still be used by the router’s clients for network booting.
The administrative distance of the route. The default administrative distance for static IP routes in Brocade routers is 1.
To list the default administrative distances for all types of routes or to change the administrative distance of a static route.
Displaying CPU Utilization Statistics
You can display CPU utilization statistics for IP protocols using the show process cpu command.
The show process cpu command includes CPU utilization statistics for ACL, NAT, 802.1x, and L2VLAN. L2VLAN contains any packet transmitted to a VLAN by the CPU, including unknown unicast, multicast, broadcast, and CPU forwarded Layer 2 traffic.
To display CPU utilization statistics for the previous one-second, one-minute, five-minute, and fifteen-minute intervals, enter the following command at any level of the CLI:
If the software has been running less than 15 minutes (the maximum interval for utilization statistics), the command indicates how long the software has been running. Here is an example:
To display utilization statistics for a specific number of seconds, enter a command such as the following:
When you specify how many seconds’ worth of statistics you want to display, the software selects the sample that most closely matches the number of seconds you specified. In this example, statistics are requested for the previous two seconds. The closest sample available is actually for the previous 1 second plus 80 milliseconds.
Syntax: show process cpu [<num>]
The <num> parameter specifies the number of seconds and can be from 1 – 900. If you use this parameter, the command lists the usage statistics only for the specified number of seconds. If you do not use this parameter, the command lists the usage statistics for the previous one-second, one-minute, five-minute, and fifteen-minute intervals.
Displaying IP Interface Information
To display IP interface information, enter the following command at any CLI level:
Syntax: show ip interface [ethernet <portnum>] | [loopback <num>] | [ve <num>]
This display shows the following information.
 
Note: If an “s” is listed following the address, this is a secondary address. When the address was configured, the interface already had an IP address in the same subnet, so the software required the “secondary” option before the software could add the interface.
Whether the IP address has been saved in NVRAM. If you have set the IP address for the interface in the CLI or Web Management interface, but have not saved the configuration, the entry for the interface in the Method field is “manual”.
The link status of the interface. If you have disabled the interface with the disable command, the entry in the Status field will be “administratively down”. Otherwise, the entry in the Status field will be either “up” or “down”.
Whether the interface can provide two-way communication. If the IP address is configured, and the link status of the interface is up, the entry in the protocol field will be “up”. Otherwise the entry in the protocol field will be “down”.
To display detailed IP information for a specific interface, enter a command such as the following:
This display shows the following information.
 
The physical port number or virtual interface (VE) number. VEs are shown as “v<num>”, where <num> is the number you assigned to the VE when you configured it. For example, VE 1 is shown as “v1”.
If a range of ports is listed in this field, the interface is a trunk group. If two ranges of ports are listed, the interface is a trunk group that spans multiple chassis modules.
The Maximum Transmission Unit (MTU), which specifies the maximum packet size for packets sent and received on this interface.
Displaying Interface Name in Syslog
By default an interface’s slot number (if applicable) and port number are displayed when you display Syslog messages. You can display the name of the interface instead of its number by entering a command such as the following:
ServerIron(config)# ip show-portname
This command is applied globally to all interfaces on a ServerIron ADX.
Syntax: [no] Ip show-portname
When you display the messages in the Syslog, you see the interface name under the Dynamic Log Buffer section. The actual interface number is appended to the interface name. For example, if the interface name is "lab" and its port number is "2", you see "lab2" displayed as in the example below:
Displaying ARP Entries
You can display the ARP cache and the static ARP table. The ARP cache contains entries for devices attached to the ServerIron ADX. The static ARP table contains the user-configured ARP entries. An entry in the static ARP table enters the ARP cache when the entry’s interface comes up.
The tables require separate display commands or Web management options.
Displaying the ARP Cache
To display the contents of the ARP cache, enter the following command at any CLI level:
Syntax: show arp [ethernet <portnum> | mac-address <xxxx.xxxx.xxxx> [<mask>] | <ip-addr> [<ip-mask>]] [<num>]
The ethernet <portnum> parameter lets you restrict the display to entries for a specific port.
The mac-address <xxxx.xxxx.xxxx> parameter lets you restrict the display to entries for a specific MAC address.
The <mask> parameter lets you specify a mask for the mac-address <xxxx.xxxx.xxxx> parameter, to display entries for multiple MAC addresses. Specify the MAC address mask as “f”s and “0”s, where “f”s are significant bits.
The <ip-addr> and <ip-mask> parameters let you restrict the display to entries for a specific IP address and network mask. Specify the IP address masks in standard decimal mask format (for example, 255.255.0.0).
NOTE: The <ip-mask> parameter and <mask> parameter perform different operations. The <ip-mask> parameter specifies the network mask for a specific IP address, whereas the <mask> parameter provides a filter for displaying multiple MAC addresses that have specific values in common.
The <num> parameter lets you display the table beginning with a specific entry number.
NOTE: The entry numbers in the ARP cache are not related to the entry numbers for static ARP table entries.
This display shows the following information. The number in the left column of the CLI display is the row number of the entry in the ARP cache. This number is not related to the number you assign to static MAC entries in the static ARP table.
 
ID of the entry. If multiple outgoing ports for a static route are configured, there will be more than one entry for that route as in route #6 above.
Dynamic – The ServerIron ADX learned the entry from an incoming packet.
Static – The ServerIron ADX loaded the entry from the static ARP table when the device for the entry was connected to the ServerIron ADX.
The number of minutes the entry has remained unused. If this value reaches the ARP aging period, the entry is removed from the table.
Note: Static entries do not age out.
Displaying the Static ARP Table
To display the static ARP table instead of the ARP cache, enter the following command at any CLI level:
This example shows two static entries. Note that since you specify an entry’s index number when you create the entry, it is possible for the range of index numbers to have gaps, as shown in this example.
NOTE: The entry number you assign to a static ARP entry is not related to the entry numbers in the ARP cache.
Syntax: show ip static-arp [ethernet <portnum> | mac-address <xxxx.xxxx.xxxx> [<mask>] |
<ip-addr> [<ip-mask>]] [<num>]
The ethernet <portnum> parameter lets you restrict the display to entries for a specific port.
The mac-address <xxxx.xxxx.xxxx> parameter lets you restrict the display to entries for a specific MAC address.
The <mask> parameter lets you specify a mask for the mac-address <xxxx.xxxx.xxxx> parameter, to display entries for multiple MAC addresses. Specify the MAC address mask as “f”s and “0”s, where “f”s are significant bits.
The <ip-addr> and <ip-mask> parameters let you restrict the display to entries for a specific IP address and network mask. Specify the IP address masks in standard decimal mask format (for example, 255.255.0.0).
NOTE: The <ip-mask> parameter and <mask> parameter perform different operations. The <ip-mask> parameter specifies the network mask for a specific IP address, whereas the <mask> parameter provides a filter for displaying multiple MAC addresses that have specific values in common.
The <num> parameter lets you display the table beginning with a specific entry number.
The maximum number of static entries that can be configured on the device using the current memory allocation. The range of valid memory allocations for static ARP entries is listed after the current allocation.
Displaying the Forwarding Cache
To display the IP forwarding cache, enter the following command at any CLI level:
Syntax: show ip cache [<ip-addr>] | [<num>]
The <ip-addr> parameter displays the cache entry for the specified IP address.
The <num> parameter displays the cache beginning with the row following the number you enter. For example, to begin displaying the cache at row 10, enter the following command: show ip cache 9.
The show ip cache command displays the following information.
 
Table 9.11: CLI Display of IP Forwarding Cache – Layer 3 Switch  
The IP address of the next-hop router to the destination. This field contains either an IP address or the value DIRECT. DIRECT means the destination is either directly attached or the destination is an address on this Brocade device. For example, the next hop for loopback addresses and broadcast addresses is shown as DIRECT.
Note: If the entry is type U (indicating that the destination is this Brocade device), the address consists of zeroes.
D – Dynamic
P – Permanent
F – Forward
U – Us
C – Complex Filter
W – Wait ARP
I – ICMP Deny
K – Drop
R – Fragment
S – Snap Encap
The port through which this device reaches the destination. For destinations that are located on this device, the port number is shown as “n/a”.
Displaying the IP Route Table
To display the IP route table, enter the following command at any CLI level:
Syntax: show ip route [<ip-addr> [<ip-mask>] [longer] [none-bgp]] | <num> | bgp | direct | ospf | rip | static | tunnel | summary ]
The <ip-addr> parameter displays the route to the specified IP address.
The <ip-mask> parameter lets you specify a network mask or, if you prefer CIDR format, the number of bits in the network mask. If you use CIDR format, enter a forward slash immediately after the IP address, then enter the number of mask bits (for example: 209.157.22.0/24 for 209.157.22.0 255.255.255.0).
The longer parameter applies only when you specify an IP address and mask. This option displays only the routes for the specified IP address and mask. See the example below.
The none-bgp parameter displays only the routes that did not come from BGP4.
The <num> option display the route table entry whose row number corresponds to the number you specify. For example, if you want to display the tenth row in the table, enter “10”.
The bgp option displays the BGP4 routes.
The direct option displays only the IP routes that are directly attached to the Layer 3 Switch.
The ospf option displays the OSPF routes.
The rip option displays the RIP routes.
The static option displays only the static IP routes.
The tunnel option displays only routes that are using an MPLS LSP as a shortcut.
The summary option (Service Provider release 09.1.01 and higher) displays a summary of the information in the IP route table.
The default routes are displayed first.
Here is an example of how to use the direct option. To display only the IP routes that go to devices directly attached to the Layer 3 Switch:
Notice that the route displayed in this example has “D” in the Type field, indicating the route is to a directly connected device.
Here is an example of how to use the static option. To display only the static IP routes:
Notice that the route displayed in this example has “S” in the Type field, indicating the route is static.
Here is an example of how to use the longer option. To display only the routes for a specified IP address and mask, enter a command such as the following:
This example shows all the routes for networks beginning with 209.159. The mask value and longer parameter specify the range of network addresses to be displayed. In this example, all routes within the range 209.159.0.0 – 209.159.255.255 are listed.
The summary option displays a summary of the information in the IP route table. The following is an example of the output from this command:
ServerIron# show ip route summary

IP Routing Table - 35 entries:
6 connected, 28 static, 0 RIP, 1 OSPF, 0 BGP, 0 ISIS, 0 MPLS
Number of prefixes:
/0: 1 /16: 27 /22: 1 /24: 5 /32: 1
Syntax: show ip route summary
In this example, the IP route table contains 35 entries. Of these entries, 6 are directly connected devices, 28 are static routes, and 1 route was calculated through OSPF. One of the routes has a zero-bit mask (this is the default route), 27 have a 22-bit mask, 5 have a 24-bit mask, and 1 has a 32-bit mask.
The following table lists the information displayed by the show ip route command.
B – The route was learned from BGP.
D – The destination is directly connected to this Layer 3 Switch.
R – The route was learned from RIP.
S – The route is a static route.
* – The route is a candidate default route.
O – The route is an OSPF route. Unless you use the ospf option to display the route table, “O” is used for all OSPF routes. If you do use the ospf option, the following type codes are used:
O – OSPF intra area route (within the same area).
IA – The route is an OSPF inter area route (a route that passes from one area into another).
E1 – The route is an OSPF external type 1 route.
E2 – The route is an OSPF external type 2 route.
SA – A static route that has multiple outgoing ports in its entry.
Clearing IP Routes
If needed, you can clear the entire route table or specific individual routes. To do so, use one of the following procedures.
To clear all routes from the IP route table:
ServerIron# clear ip route
To clear route 209.157.22.0/24 from the IP routing table:
ServerIron# clear ip route 209.157.22.0/24
Syntax: clear ip route [<ip-addr> <ip-mask>]
or
Syntax: clear ip route [<ip-addr>/<mask-bits>]
Displaying IP Traffic Statistics
To display IP traffic statistics, enter the following command at any CLI level:
The show ip traffic command displays the following information.
 
Table 9.13: CLI Display of IP Traffic Statistics – Layer 3 Switch  
The total number of IP packets fragmented by this device to accommodate the MTU of this device or of another device.
The number of packets dropped by the device because the value in the Protocol field of the packet header is unrecognized by this device.
The ICMP statistics are derived from RFC 792, “Internet Control Message Protocol”, RFC 950, “Internet Standard Subnetting Procedure”, and RFC 1256, “ICMP Router Discovery Messages”. Statistics are organized into Sent and Received. The field descriptions below apply to each.
The number of ICMP Router Discovery Protocol (IRDP) Advertisement messages sent or received by the device.
The number of TCP connections opened by this device in response to connection requests (TCP SYNs) received from other devices.
The number of TCP connections this device reset by sending a TCP RESET message to the device at the other end of the connection.
The number of TCP connections this device reset because the device at the other end of the connection sent a TCP RESET message.
The number of segments that this device retransmitted because the retransmission timer for the segment had expired before the device at the other end of the connection had acknowledged receipt of the segment.
The number of requests this device has received from another RIP router for all or part of this device’s RIP routing table.
The number of responses this device has sent to another RIP router’s request for all or part of this device’s RIP routing table.
The number of responses this device has received to requests for all or part of another RIP router’s routing table.
The number of RIP packets dropped by the device because the RIP version was either invalid or is not supported by this device.
The number of RIP packets dropped because the value in the Address Family Identifier field of the packet’s header was invalid.
Displaying IP Information – ServerIron ADX running switch code
You can display the following IP configuration information statistics on a ServerIron ADX running switch code:
Displaying Global IP Configuration Information
To display the IP configuration, enter the following command from any level of the CLI:
Syntax: show ip
This display shows the following information.
 
Table 9.14: CLI Display of Global IP Configuration Information – Layer 2 Switch  
The management IP address you configured on the ServerIron ADX. Specify this address for Telnet or Web management access.
The IP address of the most-recently contacted TFTP server, if the Layer 2 Switch has contacted a TFTP server since the last time the software was reloaded or the Layer 2 Switch was rebooted.
The name under which the Layer 2 Switch’s startup-config file was uploaded or downloaded during the most recent TFTP access.
The name of the Layer 2 Switch flash image (system software file) that was uploaded or downloaded during the most recent TFTP access.
Displaying ARP Entries
To display the ARP cache, enter the following command from any level of the CLI:
Syntax: show arp
This display shows the following information.
Table 9.15: CLI Display of ARP Cache  
Note: If the MAC address is all zeros, the entry is for the default gateway, but the Layer 2 Switch does not have a link to the gateway.
The number of minutes the entry has remained unused. If this value reaches the ARP aging period, the entry is removed from the cache.
Note: If the MAC address is all zeros, this field shows a random VLAN ID, since the Layer 2 Switch does not yet know which port the device for this entry is attached to.
Displaying IP Traffic Statistics
To display IP traffic statistics, enter the following command at any CLI level:
Syntax: show ip traffic
The show ip traffic command displays the following information.
 
Table 9.16: CLI Display of IP Traffic Statistics – Layer 2 Switch  
The total number of IP packets fragmented by this device to accommodate the MTU of this device or of another device.
The number of packets dropped by the device because the value in the Protocol field of the packet header is unrecognized by this device.
The ICMP statistics are derived from RFC 792, “Internet Control Message Protocol”, RFC 950, “Internet Standard Subnetting Procedure”, and RFC 1256, “ICMP Router Discovery Messages”. Statistics are organized into Sent and Received. The field descriptions below apply to each.
The number of ICMP Router Discovery Protocol (IRDP) Advertisement messages sent or received by the device.
The number of TCP connections opened by this device in response to connection requests (TCP SYNs) received from other devices.
The number of TCP connections this device reset by sending a TCP RESET message to the device at the other end of the connection.
The number of TCP connections this device reset because the device at the other end of the connection sent a TCP RESET message.
The number of segments that this device retransmitted because the retransmission timer for the segment had expired before the device at the other end of the connection had acknowledged receipt of the segment.
 

Configuring IP > Displaying IP Configuration Information and Statistics

Table of Contents Previous Next Print
Copyright © 2009 Brocade Communications Systems, Inc.