Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

About the Tunnel Tab

Use the Tunnel tab to view and manage tunnels (label-switched paths or LSPs).

To access this tab, select Network > Topology.

The Topology page appears, with the topology map at the center and the network information table at the bottom of the page. This table displays various tabs, including the Tunnel tab.

Tasks You Can Perform

  • Hide unrelated nodes and links—Select one or more tunnels and enable the Hide unrelated toggle button. Only the nodes and links that the selected tunnels pass through are displayed on the topology map.
  • From the Provisioning list, you can perform the following tasks:

    • Add a tunnel—See Add a Single Tunnel.

    • Add diverse tunnels—See Add Diverse Tunnels.

    • Add multiple tunnels—See Add Multiple Tunnels.

    • Manually reprovision tunnels—Select one or more tunnels for which provisioning has failed or the path isn’t the expected path, and click Reprovision. The tunnels are reprovisioned and a confirmation message appears on the top of the page.

      Note:

      You can reprovision only PCE-inititated and PCC-delegated tunnels.

    • Set current path as explicit path—When creating the tunnel, if you’ve configured the routing path type for one or more secondary or standby tunnels as Dynamic or Preferred and now want to configure this path as a strict explicit path, select the tunnel, and click Set current path as explicit path. A confirmation message appears on the top of the page and the routing path type is set to Required. When you set the routing path type as Required, the PCE considers this path as explicit. If the required path is not viable and available, the tunnel is down and the PCE doesn’t compute an alternate path.

    • Optimize tunnels—Select one or more tunnels for which you want to optimize the path, and click Trigger Tunnel optimization. The paths are optimized and a confirmation message appears on the top of the page.

      Note:

      You can optimize only PCE-inititated and PCC-delegated tunnels.

  • From the Delegation list, you an perform the following tasks:

    • Add or Remove delegation—To delegate one or more PCC-controlled LSPs to the PCE or return control of delegated LSPs to the PCC, select Configure Delegation. See Add and Remove LSP Delegation
    • Return delegation of LSPs to the PCC—Select one or more LSPs (Control Type: Delegated) that were previously delegated to the PCE and select Delegation > Return Delegation to PCC. Control of the selected LSPs is temporarily returned to the PCC for a period of time based on the router’s timer statement, and a confirmation message appears on the top of the page. The Control Type for the selected LSPs changes to Device Controlled.

  • From the View list, you can perform the following tasks:

    • View events for tunnels—To view historical events (such as actions performed on the tunnel and bandwidth changes) for a tunnel for a specific time range, select the tunnel and click Events. In the Events page that appears, choose the start date and end date from the calendar that is displayed. Click the Select Time link at the bottom-right corner of the calendar to select the time for which you want to retrieve the events. Alternatively, you can select one of the shortcuts at the bottom-left corner of the calendar to view the events for the current day, past hour, past day, or past week.

      Then, click OK. The events for the tunnel are displayed in the Events table for the selected time range.

      A graph with timeline view, which indicates the bandwidth spikes for a time period, is also displayed. You can drag the slider on the graph to select a custom time range. The events for the selected time range are displayed in the Events table.

      To download the displayed data to your local system as a comma-separated values (CSV) file, click Download.

      Note:

      The events displayed on the Events page are restricted to external communication to and from the Path Computation Element (PCE). Most of the communications internal to the PCE are captured only in the log files.

    • View tunnel traffic—To view traffic and bandwidth for a tunnel in graphical form, select the tunnel and click Tunnel Traffic. In the Tunnel Traffic page that appears, select the period for which you want to view the data. You can view data for the previous 3 hours, the previous day, the previous week, or choose from a custom time range by specifying the start and end dates and times.

    • View tunnel delay—At any given time, the PCE is aware of the paths of all tunnels in the network. Periodically, the PCE uses the reported link delays to compute the end-to-end tunnel delay as the simple sum of all link delays in the tunnel path. To view tunnel delay in graphical form, select the tunnel and click Tunnel Delay. In the Tunnel Delay page that appears, select the period for which you want to view the data. You can view data for the previous 3 hours, the previous day, the previous week, or choose from a custom time range by specifying the start and end dates and times.

      Note:

      To view tunnel delay, you must first:

      • Set the interval (in seconds) for the PCS to calculate tunnel latency.

        You can specify the interval in the lsp-latency-interval field in the Path Computation Server section of the Pathfinder page (Configuration > Network > Pathfinder) on the GUI or by using the CLI (set northstar path-computation-server lsp-latency-interval).

      • Configure routers to send JTI telemetry data and real-time performance monitoring (RPM) statistics to measure link delay. See Configure Routers to Send JTI Telemetry Data and RPM Statistics to the Data Collector for details.

  • From the Diagnostics list, you can perform the following tasks:

    • Run CLI commands—Select Show Tunnels, Run MPLS Ping, or Run MPLS Traceroute. The Diagnostics page appears, displaying the list of CLI commands that are running or that have completed. The Status column indicates whether running the command was successful or not. Select one or more rows in the table to display the results in the Results tab (in the lower part of the page).

      From the Diagnostics page, you can:

      • Initiate a new ping or traceroute command—From the New list, select either Ping or Traceroute.

        Based on what you select, the Ping or Traceroute page appears. The Default tab and Custom tab are similar for Ping and Traceroute.

        On the Default tab, you can:

        • Select the ingress and egress nodes from the From list and To list.

        • Choose to enable the Use Management IP address toggle button if the nodes have management IP addresses specified for out-of-band use.

        • Choose to enable the Advance Options toggle button to configure advanced parameters. For ping request packets, you can configure hexadecimal pattern, count, size, and IPv4 type-of-service (tos). For traceroute, you can configure the maximum time (in seconds) to wait for a response to the traceroute request after sending the final packet, and the maximum time-to-live value.

        On the Custom tab, you can:

        • Select the category of commands from the list at the top of the tab. The commands specific to the selected category appear in the List of Commands section.

          The options for both Ping and Traceroute include:

          • General Commands (only for Ping)

          • RSVP LSP Commands

          • P2MP Commands

          • SR LSP Commands

        • From the list of commands displayed, select the Select All check box to select all the commands in the category. Otherwise, select the check boxes beside the command variations of your choice.

        • If you select one or more commands from the list, the Selected Commands section appears. For commands that require the specification of variable parameters, a space for each parameter is displayed. Enter the appropriate value.

        • Click Submit to execute the commands. The Diagnostics page displays the new commands along with the status and results. When a traceroute command is successfully completed, the path is highlighted in the topology map.

  • Download details of all the tunnels—To view detailed information on all the tunnels displayed in the network information table, click Download. You can choose to open the comma-separated values (CSV) file with Excel or other applications, or save the file to your local system.

  • From the More list, you can perform the following tasks:

    • View details of the tunnel—Select a tunnel and click Show Detail. The Tunnel <Tunnel-Name> page appears, displaying the details (on the Details tab) and traffic on the tunnel for the time period that you selected (on the Traffic tab).

    • Provision secondary or standby tunnels—If you want to provide an alternate route in case the primary route fails, you can add additional secondary or standby tunnels for a tunnel. Select the tunnel and click Provision Secondary/Standby.

      The Add Tunnel page appears, where you can create a secondary or standby tunnel for the selected tunnel. After the secondary or standby tunnel that you created is provisioned, you can see it in the network information table and in the topology map.

      Note:

      This option is available only for PCE-initiated and PCC-controlled tunnels.

    • Run device collection to obtain the latest information—Select a tunnel and click Run Device Collection. A confirmation message appears indicating that a device collection task has been added. Navigate to the Task Scheduler page (Administration > Task Scheduler) to view details of the task.

    • Forcefully delete a tunnel—Sometimes, it is necessary to remove tunnels from the topology when deletion requests have been rejected by the devices or when a deletion request cannot be sent to the device because the device is decommissioned. Also, the internal model may be out-of-sync with the live network, so the tunnel may have been deleted from the router but may still appear in the GUI. In such cases, the Delete icon on the top-right corner of the network information table isn’t available. Instead, you can select one or more tunnels that you want to delete, and click Force Delete.

      An alert message appears, asking you to confirm the delete operation. Click Yes.

      A confirmation message appears indicating that the delete operation was successful.

    • Reload the network information table—To re-download the data model to your Web browser, click Reload. A REST API query is sent to the Paragon Automation server and the network information table is updated.

  • Edit (modify) parameters configured for tunnels—See Edit and Delete Tunnels.

  • Delete tunnels—See Edit and Delete Tunnels.