2.20. Show, Clear, and Tools Command Reference
This section provides an overview of the show, clear, debug and tools command reference.
Topics in this section include:
2.20.1. Command Hierarchies
 | Note: For information on egress multicast group commands, refer to the 7450 ESS, 7750 SR, 7950 XRS, and VSR Layer 2 Services and EVPN Guide: VLL, VPLS, PBB, and EVPN. |
2.20.1.1. Show Commands
2.20.1.1.1. ETH-CFM Show Commands
2.20.1.1.2. PW-Port Show Commands
2.20.1.1.3. NGE Show Commands
2.20.1.2. Clear Commands
2.20.1.3. Tools Perform Commands
The following commands are applicable to the 7750 SR and 7450 ESS.
2.20.1.4. Tools Dump Commands
5.4. Configuring PIM with CLI
This section provides information to configure PIM using the command line interface.
5.4.1. PIM Configuration Overview
PIM is not enabled by default. When PIM is enabled, data is forwarded to network segments with active receivers that have explicitly requested the multicast group. When enabled, at least one interface must be specified in the PIM context as PIM is an interface function. Creating an interface enables PIM.
5.4.2. Basic PIM Configuration
Perform the following basic PIM configuration tasks:
- Enable PIM (required)
- Add interfaces so the protocol establishes adjacencies with the neighboring routers (required)
- Configure a way to calculate group-to-RP mapping (required) by either:
- Static group-to-RP mapping
- Enable Candidate RP/Bootstrap mechanism on some routers.
- Enable unicast routing protocols to learn routes towards the RP/source for reverse path forwarding (required)
- Add SSM ranges (optional)
- Enable Candidate BSR (optional)
- Enable Candidate RP (optional)
- Change hello interval (optional)
- Configure route policies (bootstrap-export, bootstrap-import, import join and register)
5.4.3. Configuring PIM Parameters
5.4.3.1. Enabling PIM
When configuring PIM, make sure to enable PIM on all interfaces for the routing instance, otherwise multicast routing errors can occur.
Use the following CLI syntax to enable PIM.
The following example displays the detailed output when PIM is enabled.
5.4.3.2. Configuring PIM Interface Parameters
The following example displays the command usage to configure PIM interface parameters:
The following example displays the PIM configuration:
2.20.2. Command Descriptions
This section provides show command descriptions and output.
| Note: For VLL, VPLS, and PBB show, clear, and debug commands, refer to the 7450 ESS, 7750 SR, 7950 XRS, and VSR Layer 2 Services and EVPN Guide: VLL, VPLS, PBB, and EVPN. For IES and VPRN show, clear, and debug commands, refer to the 7450 ESS, 7750 SR, 7950 XRS, and VSR Layer 3 Services Guide: IES and VPRN. |
2.20.2.1. Service Commands
customer
Syntax
Context
Description
This command displays service customer information.
Parameters
Output
The following shows an example of customer information.
Table 15 describes the show customer command output fields:
Table 15: Service Commands Customer Field Descriptions
Label | Description |
Customer-ID | Displays the ID that uniquely identifies a customer. |
Contact | Displays the name of the primary contact person. |
Description | Displays generic information about the customer. |
Phone | Displays the phone or pager number to reach the primary contact. |
Total Customers | Displays the total number of customers configured. |
Site | Displays the multi-service site name. A multi-service customer site is a group of SAPs with common origination and termination points. |
Description | Displays information about a specific customer's multi-service site. |
Assignment | Displays the port ID, MDA, or card number, where the SAP's that are members of this multi- service site are defined. |
I. Sched Pol | Displays the ingress QoS scheduler policy assigned to this multi-service site. |
E. Sched Pol | Displays the egress QoS scheduler policy assigned to this multi-service site. |
Service-ID | Displays the ID that uniquely identifies a service. |
SAP | Displays the SAP assigned to the service. |
fdb-mac
Syntax
Context
Description
This command displays the FDB entry for a given MAC address.
Parameters
Output
The following displays an example of service FDB MAC address information.
id
Syntax
5.4.3.3. Configuring PIM Join/Register Policies
Join policies are used in Protocol Independent Multicast (PIM) configurations to prevent the transportation of multicast traffic across a network and the dropping of packets at a scope at the edge of the network. PIM Join filters reduce the potential for denial of service (DoS) attacks and PIM state explosion—large numbers of Joins forwarded to each router on the RPT, resulting in memory consumption. Refer to the Importing PIM Join/Register Policies section of the Multicast Routing Guide for more information.
(*,G) or (S,G) is the information used to forward unicast or multicast packets.
- group-address matches the group address policy in join/prune messagesgroup-address “group-address-policy”
- source-address matches the source address in join/prune messagessource-address 192.168.0.1
- interface matches any join message received on the specified interfaceinterface port 1/1/1
- neighbor matches any join message received from the specified neighborneighbor 1.1.1.1
The following configuration example will not allow join messages for group 229.50.50.208/32 and source 192.168.0.1 but allows other join messages.
Configuring policy-statement
5.4.3.4. Importing PIM Join/Register Policies
The import command provides a mechanism to control the (*,G) and (S,G) state that gets created on a router. Import policies are defined in the config>router>policy-options context.
| Note: In the import policy, if an action is not specified in the entry then the default-action takes precedence. If no entry matches then the default-action also takes precedence. If no default-action is specified, then the default default-action is executed. |
Use the following commands to configure PIM parameters:
The following example displays the command usage to apply the policy statement which does not allow join messages for group 229.50.50.208/32 and source 192.168.0.0/16 but allows join messages for 192.168.0.0/16, 229.50.50.208 (refer to the “Configuring Route Policy Components” section of the 7450 ESS, 7750 SR, 7950 XRS, and VSR Unicast Routing Protocols Guide).
The following example displays the PIM configuration:
5.4.3.5. Configuring Bootstrap Message Import and Export Policies
Bootstrap import and export policies are used to control the flow of bootstrap messages to and from the RP.
The following configuration example specifies that no BSR messages received or sent out of interface port 1/1/1.
5.4.4. Disabling PIM
Use the following CLI syntax to disable PIM.
The following example displays the command usage to disable multicast:
The following example displays the configuration output: