Table Of Contents
Using Policy Manager (UNIX)
Starting Cisco Info Center VPN Policy Manager
Stopping Cisco Info Center VPN Policy Manager
Starting the VPN Policy Manager Desktop
Viewing VPN Policy Manager Event Lists
Launching the ISC GUI
Using the MPLS Troubleshooting Tools
Selecting an MPLS Troubleshooting Tool
Show VRF Tool
Show VRF Route Tool
Show VRF Interface Tool
Show CEF-VRF Forwarding Table
VRF Ping Tool
VRF Traceroute
Using Policy Manager (UNIX)
This chapter describes how to use VPN Policy Manager using an Info Desktop running on the UNIX platform.
This chapter contains the following sections:
•
Starting Cisco Info Center VPN Policy Manager
•
Stopping Cisco Info Center VPN Policy Manager
•
Starting the VPN Policy Manager Desktop
•
Viewing VPN Policy Manager Event Lists
•
Launching the ISC GUI
•
Using the MPLS Troubleshooting Tools
Starting Cisco Info Center VPN Policy Manager
If you have configured Cisco Info Center VPN Policy Manager for automatic startup, then it starts up automatically when the Info Server host is started.
If you have configured Cisco Info Center VPN Policy Manager for manual startup, then it starts up when you start the Info Server using the /etc/init.d/nco start command.
Stopping Cisco Info Center VPN Policy Manager
To stop the Cisco Info Center VPN Policy Manager components on a host, enter the following command:
/etc/init.d/nco stop
Starting the VPN Policy Manager Desktop
You view Cisco Info Center Policy Manager events using an Info Desktop. To start the Info Desktop on a UNIX host:
Step 1
If the FLEXlm license server is running on a remote host, enter the following command to set the LM_LICENSE_FILE environment variable to point to the host running the license server.
setenv LM_LICENSE_FILE 27000@<hostname>
where hostname is the name of the host running the license server.
Step 2
In a terminal window, enter the following command to start the Info Desktop:
nco &
The Info Desktop login window appears.
Step 3
Enter your username and password.
The main Conductor Window appears.
For detailed information on using the Conductor, refer to the Cisco Info Center User Guide, 3.6 at the following URL:
http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/info_ctr/3_6/install/index.htm
Viewing VPN Policy Manager Event Lists
To view an event list:
Step 1
On the Conductor main window, click on the Event List icon:
A set of monitor boxes appears. Each monitor box lists specific categories of event based on the filters set up for the monitor box.
Figure 4-1 shows the default monitor boxes for Cisco Info Center VPN Policy Manager on the UNIX platform.
Figure 4-1 Default VPN Policy Manager Monitor Boxes and Views
Step 2
To display a list of events for the view, click the View button the lower right of the monitor box.
You can select the following event views:
•
All Events—Shows all events currently received by the Info Server.
•
Syslog—Shows all syslog events currently received.
Table 4-1 describes the events that are shown in this event view. For the Cisco Info Center VPN Policy Manager application, syslog events regarding PE routers are displayed.
Table 4-1 Syslog Events in the Syslog Events View
Event
|
Description
|
Example Event Summary
|
Link Up
|
Indicates that a physical interface on a device that provides a link used in MPLS has come up.
|
%LINK-3-UPDOWN: Interface ATM0/0/0 changed state to up
|
Link Down
|
Indicates that a physical interface on a device that provides a link used in MPLS has gone down.
|
%LINK-3-UPDOWN: Interface ATM0/0/0 changed state to down
|
Line Protocol Up
|
Indicates that a line protocol associated with an interface that provides a link used in MPLS has come up.
|
%LINEPROTO-5-UPDOWN" Line protocol on interface ATM7/0/0 changed state to up
|
Line Protocol Down
|
Indicates that a line protocol associated with an interface that provides a link used in MPLS has gone down.
|
%LINEPROTO-5-UPDOWN" Line protocol on interface ATM7/0/0 changed state to down
|
•
SNMP —Shows all SNMP trap events.
Cisco Info Center VPN Policy Manager includes filters for SNMP events that effect the MPLS network. Table 4-2 describes these SNMP events.
Table 4-2 SNMP Events
Event
|
Description
|
Enhanced Event Information
|
MPLS VRF Up
|
Indicates that an interface used with VPN Routing Forwarding (VRF) has come up.
|
The CE routers, Customers, VPNs, Sites and Providers affected by the event.
|
MPLS VRF Down
|
Indicates that an interface used with VRF has gone down.
|
The CE routers, Customers, VPNs, Sites and Providers affected by the event.
|
Link Up
|
Indicates that an interface associated with an MPLS link has come up.
|
The CE routers, Customers, VPNs, Sites and Providers affected by the event.
|
Link Down
|
Indicates that an interface associated with an MPLS link has gone down.
|
The CE routers, Customers, VPNs, Sites and Providers affected by the event.
|
•
ISC Logging—Shows events received from the ISC host.
Table 4-3 describes the events received from the ISC host through the Tibco Info Mediator. For these events, additional event information is collected by Cisco VPN Policy Manager and used to create enhanced events.
Table 4-3 ISC Logging Events
Event
|
Description
|
Enhanced Event Information
|
PE added
|
Indicates that a PE router has been added to the network.
|
The VPNs and MPLS customers affected by the event.
|
PE deleted
|
Indicates that a PE router has been deleted.
|
The VPNs and MPLS customers affected by the event.
|
CPE added
|
Indicates that a customer premises equipment (CPE) device has been added to the network.
|
The VPNs and MPLS customers affected by the event.
|
CPE deleted
|
Indicates that a CPE device has been deleted.
|
The VPNs and MPLS customers affected by the event.
|
•
All MPLS Events—Shows all MPLS events.
The MPLS Event view shows all MPLS events. MPLS events are events that are generated by Cisco VPN Policy Manager when VPN Routing Forwarding (VRF) interfaces on MPLS devices go up or down or when interfaces or line protocols on MPLS devices go up or down.
Table 4-4 describes the MPLS events.
Table 4-4 MPLS Events
Event
|
Description
|
CE event
|
Shows information about a customer edge router (CE router) affected when an interface or line protocol on an MPLS device goes up or down.
|
PE event
|
Shows information about a provider edge router (PCE router) affected when an interface or line protocol on an MPLS device goes up or down.
|
Customer event
|
Shows information about an MPLS customer who is affected when an interface or line protocol on an MPLS device goes up or down.
|
VPN event
|
Shows information about a VPN that is affected when an interface or line protocol on an MPLS device goes up or down.
|
•
MPLS CE—Shows all MPLS Customer Edge (CE) router events.
CE events are generated when an interface or line protocol on an MPLS device goes up or down. They provide information about a CE router that is affected by the event on the MPLS device.
•
MPLS Customer—Shows MPLS customer events.
MPLS Customer events are generated when an interface or line protocol on an MPLS device goes up or down. They provide information about an MPLS Customer who is affected by the event on the MPLS device.
•
MPLS PE—Shows all MPLS Provider Edge (PE) router events.
MPLS PE events are generated when an interface or line protocol on an MPLS device goes up or down. They provide information about a PE router that is affected by the event on the MPLS device.
•
MPLS VPN—Shows all MPLS Virtual Private Network (VPN) events.
MPLS events are generated when an interface or line protocol on an MPLS device goes up or down. They provide information about a VPN that is affected by the event on the MPLS device.
After you select a view, an event list appears.
Figure 4-2 shows a typical VPN Policy Manager event list.
Figure 4-2 A VPN Policy Manager Event List
Step 3
To view details about an event, click on the event.
When any VPN Policy Manager event is selected, you can launch the ISC GUI to obtain additional information about the event.
When a provider edge router event (PE event) is selected, you can use the VPN Policy Manager MPLS Troubleshooting tools to view more information about the VRF.
For information on how to use the MPLS Troubleshooting tools, see the following section, the "Using the MPLS Troubleshooting Tools" section.
Launching the ISC GUI
To launch the ISC GUI.
Step 1
When a VPN Policy Manager event is selected, right click on the event.
The Cisco Info Center VPN Policy Manager Alerts menu appears, shown in Figure 4-3.
Figure 4-3 The VPN Policy Manager Tools Menu
Step 2
Select Launch ISC GUI.
The ISC GUI launches and you are prompted for the ISC username and password.
For information on using the ISC GUI, refer to the ISC 3.2 documentation at the following URL:
http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/isc/index.htm
Using the MPLS Troubleshooting Tools
When a provider edge (PE) event is selected, you can use the MPLS Troubleshooting tools to obtain additional information about the event.
Table 4-5 describes the MPLS Troubleshooting Tools.
Table 4-5 The MPLS Troubleshooting Tools
Tool
|
Description
|
Show VRF
|
Logs in to the router that sent the event, issues the show ip vrf command, and shows the output from the command.
For information on using this tool, see the "Show VRF Tool" section.
|
Show VRF Route
|
Logs in to the router that sent the event, issues the show ip route vrf command, and shows the output from the command.
For information on using this tool, see the "Show VRF Route Tool" section
|
Show VRF Interface
|
Logs in to the router that sent the event, issues the show ip vrf interface command, and shows the output from the command
For information on using this tool, see the "Show VRF Interface Tool" section
|
Show CEF-VRF Forwarding Table
|
Logs in to the router that sent the event, issues the show ip cef vrf summary or the show ip cef vrf detail command, and shows the output from the command
For information on using this tool, see the "Show CEF-VRF Forwarding Table" section
|
VRF Ping
|
Logs in to the router that sent the event, issues the ping vrf command, and shows the output from the command.
For information on using this tool, see the "VRF Ping Tool" section
|
VRF Traceroute
|
Logs in to the router that sent the event, issues the traceroute vrf command, and shows the output from the command.
For information on using this tool, see the "VRF Traceroute" section
|
Selecting an MPLS Troubleshooting Tool
To select an MPLS Troubleshooting tool:
Step 1
Select a PE event.
Step 2
Right click on the event.
The Alerts menu appears.
Step 3
On the Alerts menu, select Tools.
The Tools menu appears, shown in Figure 4-4.
Figure 4-4 The Tools Menu
Step 4
On the Tools menu, select MPLS Troubleshooting Tools.
A pull-down menu appears showing the MPLS Troubleshooting Tool, shown in Figure 4-5.
Figure 4-5 MPLS Troubleshooting Tools Menu
Select the MPLS Troubleshooting tool that you want to run from the list of tools.
Show VRF Tool
Use the Show VRF tool to issue the show ip vrf command. This command displays the set of defined Virtual Private Network (VPN) routing/forwarding instances (VRFs) and associated interfaces.
To use the Show VRF tool:
Step 1
Right click on an MPLS PE event.
The Alerts Menu appears.
Step 2
Select Tools > MPLS Troubleshooting Tools > Show VRF
The Tool Parameter Dialog for the Show VRF Tool appears, as shown in Figure 4-6.
Figure 4-6 Tool Parameter Dialog for the Show VRF Tool
Step 3
Enter the Router User name, the Router Password and the Router Enable Password and then click OK.
The tool issues the show ip vrf command and displays the output.
Figure 4-7 shows sample output from the show ip vrf command.
Figure 4-7 Output from the Show VRF Tool
Show VRF Route Tool
Use the Show VRF Route tool to issue the show ip route vrf command. The show ip route vrf command displays the IP routing table associated with a Virtual Private Network (VPN) routing/forwarding instance (VRF).
To use the Show VRF Route tool:
Step 1
Right click on an MPLS PE event.
The Alerts Menu appears.
Step 2
Select Tools > MPLS Troubleshooting Tools > Show VRF Route
The Tool Parameter Dialog for the Show VRF Route Tool appears, as shown in Figure 4-8.
Figure 4-8 Tool Parameter Dialog for the Show VRF Route Tool
Step 3
Enter the Router User name, Router Password, Router Enable Password, and VRF Name and then click OK.
The tool issues the show ip route vrf command and displays the output.
Figure 4-9 shows sample output from the show ip route vrf command.
Figure 4-9 Output from the Show VRF Route Tool
Show VRF Interface Tool
Use the Show VRF Interface tool to issue the show ip vrf interface command. This command displays the VRF table associated with an interface.
To use the Show VRF Interface tool:
Step 1
Right click on an MPLS PE event.
The Alerts Menu appears.
Step 2
Select Tools > MPLS Troubleshooting Tools > Show VRF Interface.
The Tool Parameter Dialog for the Show VRF Interface Tool appears, as shown in Figure 4-10.
Figure 4-10 Tool Parameter Dialog for the Show VRF Interface Tool
Step 3
Enter the Router User name, Router Password, and Router Enable Password and then click OK.
The tool issues the show ip vrf interface command and displays the output.
Figure 4-11 shows sample output from the show ip vrf interface command.
Figure 4-11 Output from the Show VRF Interface Tool
Show CEF-VRF Forwarding Table
The Show CEF-VRF Forwarding Table tool issues the show ip cef vrf summary command or the show ip cef vrf detail command and displays the output. This command displays the Cisco Express Forwarding (CEF) forwarding table forwarding table associated with a Virtual Private Network (VPN) routing/forwarding instance (VRF).
To use the Show CEF-VRF Forwarding Table tool:
Step 1
Right click on an MPLS PE event.
The Alerts Menu appears.
Step 2
Select Tools > MPLS Troubleshooting Tools > Show CEF-VRF Forwarding Table.
The Tool Parameter Dialog for the Show CEF-VRF Forwarding Table Tool appears, as shown in Figure 4-10.
Figure 4-12 Tool Parameter Dialog for the Show CEF-VRF Forwarding Tool
Step 3
Enter the Router User name, Router Password, Router Enable Password, and VRF Name and then click OK.
Step 4
Pull down the menu in the Detail/Summary field and do one of the following:
•
To request a detailed report, select detail.
•
To request a summary report, select summary.
•
To request a report with only IP addresses (no detail or summary information), select none.
Step 5
Click OK.
The tool issues the show ip cef vrf summary or the show ip cef vrf detail command and displays the output.
Figure 4-13 shows sample output from the show ip cef vrf summary command.
Figure 4-13 Output from the Show CEF-VRF Forwarding Table Tool
VRF Ping Tool
To use the VRF Ping tool:
Step 1
Right click on an MPLS PE event.
The Alerts Menu appears.
Step 2
Select Tools > MPLS Troubleshooting Tools > VRF Ping.
The Tool Parameter Dialog for the VRF Ping Tool appears, as shown in Figure 4-14.
Figure 4-14 Tool Parameter Dialog for the VRF Ping Tool
Step 3
Enter the Router User name, Router Password, Router Enable Password, VRF Name, and VRF Destination IP address, then click OK.
The tool issues the ping vrf command and displays the output.
Figure 4-15 shows sample output from the ping vrf command.
Figure 4-15 Output from the Ping VRF Command
VRF Traceroute
To use the VRF Traceroute tool:
Step 1
Right click on an MPLS PE event.
The Alerts Menu appears.
Step 2
Select Tools > MPLS Troubleshooting Tools > VRF Traceroute.
The Tool Parameter Dialog for the VRF Traceroute Tool appears, as shown in Figure 4-16.
Figure 4-16 Tool Parameter Dialog for the VRF Traceroute Tool
Step 3
Enter the Router User name, Router Password, Router Enable Password, VRF Name, and VRF Destination IP, then click OK.
The tool issues the traceroute vrf command and displays the output.
Figure 4-17 shows sample output from the traceroute vrf command.
Figure 4-17 Output from the Traceroute VRF Command