Tunnel Builder Pro supplies bandwidth information (allocated, global pool, and subpool numbers) on a per-priority basis for each link in the network. The application reads this information from the output of the show mpls traffic topology command.

You can also update bandwidth information by clicking Update on the Tunnel Builder Pro Links window. Pressing Update causes the Tunnel Builder Pro server to go out to the seed router, get the MPLS topology, and update the bandwidth information for every link in the map. The bandwidth information is accurate as of the last Interior Gateway Protocol (IGP) update.

The IGP update process is completely separate from the Tunnel Builder Pro application and any map updates that occurs. The time between IGP updates is determined by a selected router configuration setting.

A utobandwidth

Autobandwidth automatically resizes a tunnel, based on its utilization. Autobandwidth decides whether to resize a tunnel at a specified collection frequency. The collection frequency is the number of seconds between samples of the tunnel output rate. A smaller number (more frequent sampling) increases the accuracy and responsiveness of autobandwidth, but increases network overhead and possibly degrades performance.

How to View and Modify Tunnels

This section contains the following procedures:

View Information About a Tunnel (optional)
Modify a Tunnel (optional)

V iew Information About a Tunnel

To view information about a primary tunnel, perform the following steps:

Step 1 Click the Tunnels tab. The Tunnels window shown in Figure 7-1 appears.

Figure 7-1: Tunnels Window

Step 2 Click Fetch. The Tunnel Information window in Figure 7-2 shows the following information for the tunnel:

Tunnel—Tunnel name.
Head—Name of the head node.
#—Tunnel number.
Type—Type of tunnel. Valid values are backup, mpls (primary), FRR (fast reroutable primary).
Oper—Operational status of the tunnel.
Admin—Administrative status of the tunnel.
Path—Path status. Valid values are valid and not valid.
Signalling—RSVP signalling status. Valid values are Connected and Down.

The information in the Oper, Admin, Path, and Signalling fields is current as of one of the following events, whichever occurred last:

Creation or last modification of the tunnel
Last fetch from the network

Figure 7-2: Tunnel Information Window

Step 3 To display additional information about an existing tunnel, select a tunnel in the table. The following information appears:

Destination—Ending address of the tunnel.
Bandwidth (Kbps)—Tunnel bandwidth.
Setup/Hold Priority—Tunnels that can preempt other tunnels. Valid values are 0 to 7, where a lower number indicates a higher priority.
Affinity—Affinity bits to use for the tunnel. Links in the tunnel must have attribute bits that match the tunnel affinity bits. Valid values are 0x0 to 0xFFFFFFFF.
Autoroute Announce—If this box is checked, when the tunnel is up, the IGP uses the tunnel in its shortest path first (SPF) calculation.
Autoroute Metric—A metric (absolute or relative) used by IGP if Autoroute Announce is checked.
AutoBW requested (Kbps)—If this feature is turned on, shows the current tunnel bandwidth requested by the Auto Bandwidth feature.
Explicit Route—Sequence of addresses in the explicit route (label-switched path) used by the tunnel.

M odify a Tunnel

To modify a primary tunnel, perform the following steps:

Step 1 Click the Tunnels tab. The Tunnels window shown in Figure 7-3 appears.

Figure 7-3: Tunnels Window

Step 2 Click Fetch. The tunnels are listed in the list box, as shown in Figure 7-4.

Figure 7-4: Tunnel Information Window

Step 3 Select the tunnel that you want to modify in the Tunnels list box or right-click the tunnel in the network map.

Step 4 Click Modify. The Confirmation message shown in Figure 7-5 appears, unless you previously disabled it.

Figure 7-5: Confirmation Message

Step 5 If you receive the Confirmation message, click OK or Cancel. If you click OK, the Modify Tunnel window shown in Figure 7-6 appears.

Figure 7-6: Modify Tunnel Window

Step 6 You can change any or all of the following items:

Path options—Number, path name, and lockdown.
Tunnel Name—Name that identifies the tunnel.
Bandwidth (Kbps)—Bandwidth for this tunnel.
Global pool/Sub-pool—Bandwidth comes from the global pool or the subpool.
Setup-Priority—When Tunnel Builder Pro signals an LSP for this tunnel, Tunnel Builder Pro uses the setup priority to determine what existing tunnels can be preempted. Valid values are 0 to 7, where a lower number indicates a higher priority. An LSP with a setup priority of 0 can preempt any LSP with a non-0 priority. The setup priority and hold priorities are typically configured to be equal. The setup priority cannot be better (numerically smaller) than the hold priority.
Hold-Priority—Determines if the tunnel should be preempted by other LSPs that are being signaled. Valid values are 0 to 7, where a lower number indicates a higher priority. The hold priority and the setup priority are typically configured to be equal.
Affinity—A 32-bit hexadecimal number representing attributes required for links carrying this tunnel. Valid values are 0x0 to 0xFFFFFFFF. The value of an attribute is 0 or 1.
Mask—Determines which link attribute the node should check. If a bit in the mask is 0, a link's attribute value for that bit is irrelevant. If a bit in the mask is 1, the link's attribute value and the tunnel's required affinity for that bit must match. A tunnel can use a link if the tunnel affinity equals the link attributes and the tunnel affinity mask. Any properties set to 1 in the affinity should also be 1 in the mask.
Autoroute Announce—If this box is checked, when the tunnel is up, IGP uses the tunnel in its shortest path first (SPF) calculation.
Autoroute Metric—A metric (absolute or relative) used by IGP if Autoroute Announce is checked. Enter a positive integer for an absolute metric, or a value from -10 to 10 for a relative metric.
Auto Bandwidth—Auto Bandwidth feature is on or off. If this feature is turned on, Tunnel Builder Pro shows the current tunnel bandwidth requested by the Auto Bandwidth feature.
Freq (Secs)—Collection frequency for Auto Bandwidth. Default is 86400 seconds (1 day).
Min (Kbps)—Minimum bandwidth to restrict the range over which the Auto Bandwidth feature can vary the tunnel bandwidth.
Max (Kbps)—Maximum bandwidth to restrict the range over which the Auto Bandwidth feature can vary the tunnel bandwidth.
Enable Fast Reroute—Set this option to designate the tunnel as a Fast Reroute (FRR) tunnel.

Note If you do not enter a value for the Bandwidth, Setup-Priority, Hold-Priority, Affinity, or Autoroute Metric field, the tunnel is configured with the default values specified on the head-end node.

Step 7 Click Apply or OK.

How to View and Modify TE Link Parameters

This section contains the following procedures:

View TE Link Parameters (optional)
Modify TE Link Parameters (optional)

V iew TE Link Parameters

To view TE link parameters, perform the following steps:

Step 1 Click the Links tab. The Links window shown in Figure 7-7 appears.

Figure 7-7: Links Window

Step 2 To view the traffic engineering attributes of a link, do one of the following:

In the Links list box, select the link. There are two addresses for each link, one address for each direction.
In the network map, click the link.

The link is highlighted in green on the network map.

The following bandwidth parameters are displayed for priority 0 through priority 7 traffic, in kilobytes per second:

Allocated—Bandwidth that is allocated for this link.
Global pool reservable—Bandwidth that is reservable in the global pool.
Subpool reservable—Bandwidth that is reservable in the subpool.

The following interface parameters are displayed:

Max Link Bandwidth—Maximum link bandwidth, in kilobytes per second.
Max Global Reservable—Maximum reservable global pool bandwidth, in kilobytes per second.
Max subPool Reservable—Maximum reservable subpool bandwidth, in kilobytes per second.
Attribute Bits—Attribute bits associated with the link.
TE Metric—Traffic engineering metric. Defaults to the BGP routing metric.

Note If the router for the link is running a version of Cisco IOS that does not support subpool bandwidth, the Max subPool Reservable field is not displayed.

Note You can modify all the fields except the TE Metric.

What to Do Next

You can modify the TE link parameters.

M odify TE Link Parameters

To modify TE link parameters, perform the following steps:

Step 1 (Optional) Click the Links tab. The Links window shown in Figure 7-8 appears.

Figure 7-8: Links Window

Step 2 In the Links list box, select the link for which you want to change values. The selected link is highlighted in green in the network map.

Step 3 You can change any or all of the following values:

MaxLink Bandwidth—Maximum link bandwidth, in kilobytes per second.
Max Global Reservable—Maximum reservable global pool bandwidth, in kilobytes per second.
Max subPool Reservable—Maximum reservable subpool bandwidth, in kilobytes per second.
Attribute Bits—Attribute bits associated with the link.

Note You can modify a link at either end of the node. Be sure to modify the values for the correct interface.

Step 4 Click Modify.

Step 5 (Optional) To update bandwidth allocation information, click Update. The information will be accurate as of the last BGP update.

How to View and Modify TE Node Parameters

This section contains the following procedures:

View TE Node Parameters (optional)
Modify TE Node Parameters (optional)

V iew TE Node Parameters

To view TE node parameters, perform the following steps:

Step 1 Click the Nodes tab. The Nodes window shown in Figure 7-9 appears.

Figure 7-9: Nodes Window

Step 2 To select the node for which you want to view information, do one of the following:

Select the node in the Nodes list box.
Click the node in the network map.

The following information for that node is displayed:

IGP ID.
MPLS traffic engineering (TE) ID.

Note If a node does not have MPLS TE configured correctly, it has an ID of 0.0.0.0 in the Nodes list box and in the network map.

Cisco IOS version.
Interfaces on that node. This information is listed in the Interfaces list box, and includes the following information:

IP addr—IP address of the interface.
Name—Name of the interface.
TE status—Status of traffic engineering. Valid values are enabled, not enabled, and running.
Subpool bw (Kbps)—Amount of bandwidth that is reservable in a subpool.
Global bw (Kbps)—Amount of bandwidth that is reservable in a global pool.

Static routes that have been configured from the node. The Static Routes list box shows the following information for each static route:

Destination—Destination IP address.
Mask—Subnet mask for the destination IP address.
Next Hop—Next hop, identified by the number of the tunnel or the TE ID of the end node.
Distance—(Optional) Administrative distance metric. Default is 1.

Auto bandwidth information. On designates that auto bandwidth has been set on the node; Off indicates that auto bandwidth has not been set on the node.

M odify TE Node Parameters

When you modify TE node parameters, you can do the following:

C reate a Static Route

A static route is useful for mapping traffic onto tunnels. To create a static route, perform the following steps:

Step 1 Click the Nodes tab. The Nodes window shown in Figure 7-10 appears.

Figure 7-10: Nodes Window

Step 2 Do one of the following:

In the Nodes list box, select the head-end node, and at the Static Routes field, click Create.
In the network map, right-click the head-end node of the tunnel (the default node is red) and choose Create Static Route from the drop-down menu.

The Create Static Route popup window shown in Figure 7-11 appears.

Figure 7-11: Create Static Route Window

Step 3 In the Destination Prefix field, enter the destination prefix of the static route.

Step 4 In the Mask field, enter the mask for the destination IP address.

Step 5 To select the tunnel that you want to use for the next hop, do one of the following:

In the "Select tunnel to use for next hop" list box, select a tunnel.
In the End node TE ID field, enter the traffic engineering ID for the next hop. To enter the traffic engineering ID, Shift-click the end node of a tunnel.

Step 6 (Optional) If you want a dynamic route to override the static route, enter a distance metric in the Distance field.

Step 7 (Optional) To create more static routes, click Apply and repeat Steps 2 through 6.

Step 8 When you are done creating static routes, click OK. For each static route that has been configured for a selected node, you can view the following information:

Destination—Destination IP address.
Mask—Subnet mask for the destination IP address.
Next Hop—Next hop, identified by the number of the tunnel or the TE ID of the end node.
Distance—Administrative distance metric. Default is 1.

D elete a Static Route

To delete a static route, perform the following steps:

Step 1 Click the Nodes tab.

Step 2 Select the static route.

Step 3 Click Delete.

C ontrol Autobandwidth

To control autobandwidth, perform the following steps:

Step 1 Click the Nodes tab. The Nodes window shown in Figure 7-12 appears.

Figure 7-12: Nodes Window

Step 2 In the Nodes list box, select the node for which you want to control autobandwidth.

Step 3 In the Auto Bandwidth field, click On if you want autobandwidth configured on that node. If you do not want autobandwidth configured on that node, click Off.

Note If the selected node does not support the Auto Bandwidth feature, the On and Off buttons are not displayed.

Step 4 Specify the collection frequency, in seconds (that is, the number of seconds between samples of the tunnel output rate). The default is 86400 seconds (1 day).

Step 5 Click Modify.

Troubleshooting Tips

The Tunnel Builder Pro application provides timely notification to the user of interface up or interface down events that affect any links in a network map.

What to Do Next

To make your changes permanent, see "Make Your Changes Permanent" in "Using Tunnel Builder Pro for the First Time."

Table of Contents