|
|
This chapter explains the function and syntax of the IP multicast tools commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS IP and IP Routing Command Reference, Release 12.1.
To change the frequency, duration, or scope of beacon messages that the Manager sends to Test Senders and Test Receivers during a multicast routing monitor test, use the beacon manager configuration command. To restore the default value, use the no form of the command.
beacon [interval seconds] [holdtime seconds] [ttl hops]
Syntax Description
interval seconds (Optional) Frequency of beacon messages in seconds. The default value is 60 seconds, meaning one beacon message every 60 seconds. holdtime seconds (Optional) Length of the test period in seconds. The Test Sender and Test Receiver are respectively sending and receiving test data constantly during the hold time. The default value is 1 day (86400 seconds). ttl hops (Optional) Time-to-live (TTL) of the beacon messages. The default value is 32 hops.
To clear the status report cache buffer, use the clear ip mrm status-report EXEC command.
clear ip mrm status-report [ip-address]
Syntax Description
ip-address (Optional) Address of the Test Receiver. Clears only those status reports received from the Test Receiver having this IP address. If no address is specified, all status reports are cleared from the cache buffer.
To configure an interface to operate as a Test Sender or Test Receiver, or both, for Multicast Routing Monitor (MRM), use the ip mrm interface configuration command. To remove the interface as a Test Sender or Test Receiver, use the no form of the command.
ip mrm {test-sender | test-receiver | test-sender-receiver}
Syntax Description
test-sender Configures the interface to be a Test Sender. test-receiver Configures the interface to be a Test Receiver. test-sender-receiver Configures the interface to be both a Test Sender and Test Receiver (for different groups).
To configure a Test Sender or Test Receiver to accept requests only from Managers that pass an access list, use the ip mrm accept-manager global configuration command. To remove the restriction, use the no form of the command.
ip mrm accept-manager {access-list-name | access-list-number} [test-sender | test-receiver]
Syntax Description
access-list-name Named IP access list applied to the Managers. access-list-number Numbered IP access list applied to the Managers. test-sender (Optional) The access list applies only to the Test Sender. test-receiver (Optional) The access list applies only to the Test Receiver.
To identify a Multicast Routing Monitor (MRM) test and enter the mode in which you specify the test parameters, use the ip mrm manager global configuration command. To remove the test, use the no form of the command.
ip mrm manager test-name
Syntax Description
test-name Name of the group of MRM test parameters that follow.
To specify that an interface is the Manager for Multicast Routing Monitor (MRM), and to specify the multicast group address the Test Receiver will listen to, use the manager manager configuration command. To remove the Manager or group address, use the no form of the command.
manager type number group ip-address
Syntax Description
type number Interface type and number of the Manager. The IP address associated with this interface is the source address of the Manager. group ip-address IP multicast group address that the Test Receiver will listen to.
To query which neighboring multicast routers are "peering" with the local router, use the mrinfo EXEC command.
mrinfo [hostname | address] [source-address | interface]
Syntax Description
hostname | address (Optional) Queries the DNS name or IP address of the multicast router. If omitted, the router queries itself. source-address (Optional) Source address used on mrinfo requests. If omitted, the source address is based on the outbound interface for the destination. interface (Optional) Source interface used on mrinfo requests. If omitted, the source is based on the outbound interface for the destination.
To start or stop a Multicast Routing Monitor (MRM) test, use the mrmtest EXEC command.
mrm test-name {start | stop}
Syntax Description
test-name Name of the MRM test, as defined by the ip mrm manager command. start Starts the MRM test specified by test-name. stop Stops the MRM test specified by test-name.
To display IP multicast packet rate and loss information, use the mstat user EXEC command.
mstat source [destination] [group]
Syntax Description
source DNS name or the IP address of the multicast-capable source. destination (Optional) DNS name or address of the destination. If omitted, the command uses the system at which the command is typed. group (Optional) DNS name or multicast address of the group to be displayed. Default address is 224.2.0.1 (the group used for MBONE Audio).
To trace the path from a source to a destination branch for a multicast distribution tree, use the mtrace user EXEC command.
mtrace source [destination] [group]
Syntax Description
source DNS name or the IP address of the multicast-capable source. This is a unicast address of the beginning of the path to be traced. destination (Optional) DNS name or address of the unicast destination. If omitted, the mtrace starts from the system at which the command is typed. group (Optional) DNS name or multicast address of the group to be traced. Default address is 224.2.0.1 (the group used for MBONE Audio). When address 0.0.0.0 is used, the software invokes a weak mtrace. A weak mtrace is one that follows the RPF path to the source, regardless of whether any router along the path has multicast routing table state.
To configure the following, use the receivers command in manager configuration mode:
To restore the default values, use the no form of the command.
receivers {access-list-name | access-list-number} [sender-list {access-list-name | access-list-number} [packet-delay]] [window seconds] [report-delay seconds] [loss percentage] [no-join] [monitor | poll]
Syntax Description ]
access-list name | access-list number IP named or numbered access list that establishes who the Test Receivers are. Only these Test Receivers are subject to the other keywords and arguments specified in this command. sender-list access-list name | access-list number (Optional) Specifies the sources that the Test Receiver should monitor. If the access list matches any access list specified in the senders command, the associated packet-delay milliseconds keyword and argument of that senders command is used in this command. Otherwise, packet-delay is required in this receivers command. packet-delay (Optional) Specifies the delay between test packets (in milliseconds). If the sender-list access list matches any access list specified in the senders command, the associated packet-delay milliseconds keyword and argument of that senders command is used in this command. Otherwise, the packet-delay argument is required in this receivers command. window seconds (Optional) Duration (in seconds) of a test period. This is a sliding window of time in which packet count is collected, so that the loss percentage can be calculated. Default is 5 seconds. report-delay seconds (Optional) Delay (in seconds) between staggered status reports from multiple Test Receivers to the Manager. The delay prevents multiple receivers from sending status reports to the Manager at the same time for the same failure. Receiver 1 sends status, seconds later Receiver 2 sends status, seconds later Receiver 3 sends status, and so on. This value is relevant only if there are multiple Test Receivers. The default is 1 second. loss percentage (Optional) Threshold percentage of packet loss required before a status report is triggered. The default is 0%, which means that a status report is sent for any packet loss. (This value is not applied to packet duplication; a fault report is sent for any duplicated packets.) Loss percentage calculation is explained in the "Usage Guidelines" section of this command. no-join (Optional) Specifies that the Test Receiver does not join the monitored group. The default is that the Test Receiver joins the monitored group. monitor | poll (Optional) Specifies whether the Test Receiver monitors the test group or polls for receiver statistics. The monitor keyword means the Test Receiver reports only if the test criteria are met. Poll means the Test Receiver sends status reports regularly, whether test criteria are met or not. The default is the monitor keyword.
Syntax Description
access-list name | access-list number IP named or numbered access list that defines which Test Senders are involved in the test and which Test Senders these parameters apply to. packet-delay milliseconds (Optional) Specifies the delay between test packets (in milliseconds). The default is 200 milliseconds, which results in 5 packets per second. rtp | udp (Optional) Encapsulation of test packets, either RTP-encapsulated or UDP-encapsulated. The default is RTP-encapsulated. target-only (Optional) Specifies that test packets are sent out on the targeted interface only (that is, the interface with the IP address that is specified in the Test Sender request target field). By default, test packets are sent as described in the all-multicasts keyword. all-multicasts (Optional) Specifies that the test packets are sent out on all interfaces that are enabled with IP multicast. This is the default way that test packets are sent. all-test-senders (Optional) Specifies that test packets are sent out on all interfaces that have test-sender mode enabled. By default, test packets are sent as described in the all-multicasts keyword. proxy_src (Optional) Source IP address for which the Test Sender will proxy test packets. Use this if you want to test, for a specific source, whether the multicast distribution tree is working.
To display Test Sender or Test Receiver information about Multicast Routing Monitor (MRM), use the show ip mrm interface EXEC command.
show ip mrm interface [interface-unit]
Syntax Description
interface-unit (Optional) Interface about which to display Test Sender or Test Receiver information. If no interface is specified, information about all Test Senders and Test Receivers is displayed.
To display test information for Multicast Routing Monitor (MRM), use the show ip mrm manager EXEC command.
show ip mrm manager [test-name]
Syntax Description
test-name (Optional) Name of the MRM test (as specified in the ip mrm manager command) for which to display information. If no name is specified, information about all Managers is displayed.
To display Multicast Routing Monitor (MRM) status reports of errors in the circular cache buffer, use the show ip mrm status-report EXEC command.
show ip mrm status-report [ip-address]
Syntax Description
ip-address (Optional) Displays information received from this IP address only. If no address is specified, all status reports in the cache buffer are displayed.
Syntax Description
test-packet port-number (Optional) UDP port number to which test packets are sent by a Test Sender. The port number must be even if the packets are RTP-encapsulated. The default port number is 16384. status-report port-number (Optional) UDP port number to which status reports are sent by a Test Receiver. The port number must be odd if the packets are RTCP-encapsulated. The default port number is 65535.
Posted: Wed Jul 26 14:54:51 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.