Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Tunnel Window Fields

This topic describes router-specific fields in the node, link, interface, demand, and tunnel tables as well as the Application Options windows.

Table 1: Tunnel Window Fields




This is the user-specified name of the route for this tunnel. If “Dynamic” is specified, the route will be chosen dynamically and the user should not configure a path in that entry. Otherwise, the user can specify a different


This field indicates the priority of this path/route in the “Opt” field. In the “Opt” field, NorthStar Planner will select the smallest number to be the primary route. For example, you may specify an Opt 2 for route “Backup1” and Opt 5 for “Backup2”. NorthStar Planner will sort these two routes and select “Backup1” to be the primary route since its Opt is smaller.


This field displays the user-configured route/path for this tunnel.

The route consists of a sequence of node IDs or names separated by “--”. Different delimiters are used to mark the distance relationship between nodes. A listed configured route for a tunnel would be something like “ATL--WDC--HOU--NYC”. This means the path of the tunnel begins at node Atlanta, goes to Washington DC, Houston, and terminates at node New York City.


This is the bandwidth required by the tunnel.


Indicates the type of the tunnel as specified in the Tunnel Attributes window. The user may edit this field by right-clicking on the table and selecting “Edit Type”.

Affinity/Mask (C)IncludeAll/ Exclude/ IncludeAny (J)

Allows you to set the affinity/mask of the tunnel for Cisco, or the include all, exclude, and include-any settings for Juniper admin groups to prohibit particular tunnels from routing on trunks with particular attributes (admin-groups). Trunk attributes effectively color the trunk, whereas a tunnel’s affinity/mask or include-all, exclude, and include-any settings determine which color trunks the tunnel is permitted to be placed upon. The user may edit this field by right-clicking on the table and selecting “Edit Affinity/Mask” for Cisco or “Edit Include-All/Exclude/Include-Any” for Juniper.


The priority field of the circuit specification consists of two numbers separated by a comma (,), or a back-slash (/). The first number defines the setup priority of the circuit, and the second number the holding priority of the circuit. The holding priority should be at the same or lower priority as the setup priority of the tunnel. It is assumed that this tunnel can only be bumped by a tunnel with a setup priority higher than its holding priority.


Displays any comments the user may be inclined to enter.

For more detail on the fields in the Table 2, see NorthStar Planner LSP Tunnels Overview.

  • Path Table : This button will open the Path Table window for the selected source node. The Path Table window lists the primary path from the source node to every other node in the network.

  • Show Route : This button will highlight the current path of the tunnel on the topology map with a yellow line. If you see a path displayed in gray then either the tunnel path is dynamically routed or is a loose route. This representation is the start and finish of a loose or dynamic path. This path will be established by the hardware under the parameters of the path and links.

  • Show All Paths : This button will highlight all paths from the path options table on the topology map with a yellow line. If you a path displayed in gray then either the tunnel path is dynamically routed or is a loose route. This representation is the start and finish of a loose or dynamic path. This path will be established by the hardware under the parameters of the path and links.

Table 2: Tunnel Type Parameter Generation



File Format

Tunnel Metric

A tunnel metric (absolute, relative or don’t care) used by IGP if Autoroute Announce is checked.

Absolute : Use tunnel metric as is

Relative : Set tunnel metric relative to IGP Metric (e.g., 10 would mean tunnel metric = IGP metric + 10)

Don’t Care : Tunnel metric defaults to IGP metric.

ABS= absolute_metric REL= relative_metric

Tunnel Option

Specifies whether the tunnel is primary, secondary, or standby. This option can be configured for a tunnel originating at a Juniper router by selecting Edit Type from the right-click menu of the bottom half of the Add Tunnel or Modify Tunnel window.



Indicates the tunnel’s Maximum Transmission Unit (default unit is in Bytes).


Max Delay

The maximum delay allowed for this tunnel. The max delay will be calculated either from the delay inputted on the links, or else the value set in the Delay Parameters section of the Design Options window (by default, 1ms per 100 miles).


Max Hop

The maximum number of hops allowed for this tunnel.


Max Cost

The maximum total admin cost (sometimes referred to as “distance” or “admin weight”) allowed for this tunnel. That is, the total admin cost of all the links that the tunnel traverses should not exceed this value.


Multicast Name

The tunnel belongs to this multicast group. Tunnels with the same multicast name are members of the same P2MP tree.


Routing Instance

OSPF routing instance/process ID


Autoroute Announce

Announces the presence of the tunnel by the routing protocol. When Autoroute announce is enabled, the IGP will include the tunnel in its shortest path calculation when the tunnel is up

NOAA (No Autoroute Announce) corresponds to not selecting this checkbox


Generic Router Encapsulation


Zero Backup Bandwidth

Cisco feature. During reroute, the tunnel bandwidth is 0. If this is a backup tunnel, then selecting this option would mean that bandwidth will not be reserved from the link(s) for this tunnel.


Policy Class

If there was a policy class established and applied to this tunnel, it would appear here. The user can click on the down arrow and review all policies that apply to the tunnel.


Guaranteed Bandwidth-TE

GB Tunnels can only be routed on trunks with available bandwidth in the SubPool.



Circuit cross-connect. This means that this tunnel is cross-connecting between two interfaces using CCC



No Border Flag. This is an artificial parameter used for design. When set, routing will not follow OSPF constraints. That is, the whole network will be treated like a flat network.



Indicates that administrative groups/link attributes will be ignored by this tunnel.



If checked, the tunnel will be routed using the current Interior Gateway Protocol’s metric rather than the tunnel metric. The current routing method can be found in the Design Options, Path Placement options pane.



Indicates that the LSP can be automatically reoptimized if the existing path becomes suboptimal.



Specifies a configlet template in the $WANDL_HOME/data/templates or /u/wandl/data/templates directory. This option allows you to select a manually-generated template to be used for the configlet generation process. Select the directory in which this template file is saved.

TMLT= templatename


For LDP tunneling. VPN traffic can only route over LDP enabled tunnels/links. For example, this will translate to the ldp-tunneling; statement for Juniper configurations.


  • Enable AutoBW: Specifies an auto-bandwidth tunnel, which will adjust according to the bandwidth over the tunnel

  • Minimum Rate/ Maximum Rate: Specifies the minimum and maximum bounds for the LSP’s bandwidth

  • Threshold: (percentage) The LSP’s bandwidth will be adjusted to the current flow bandwidth (MaxAvgBW) if the percentage difference between the current flow bandwidth and the LSP’s bandwidth is greater than or equal to this percentage.

  • Sample interval: The adjust interval (in seconds)

    • Format: AUTOBW=MinRate:MaxRate:Threshold:SampleInterval,

    • Example: AUTOBW=10.000K:1.800G:40:300

The Virtual Trunk tab is used to indicate traffic engineering tunnels advertised as links in an IGP network (OSPF or ISIS) and to indicate the corresponding metric assigned. Select the Virtual Trunk checkbox in order to configure the relevant protocol, area, and/or metric for which the virtual trunk will apply.

For Cisco, the corresponding statement would be “show mpls traffic-eng forwarding-adjacency”.

For Juniper, the corresponding statement would be the “label-switched-path name metric metric” statement under the hierarchcy level [edit protocols ospf area area-id] or “label-swiched-path name” under the hierarchy level [edit protocols isis

Table 3: Virtual Trunk Tab

Virtual Trunk

If a tunnel is marked as a virtual trunk, it is known to other routers and its metric and available bandwidth information will be broadcast to other routers as if it were a link. Just as a link has interfaces defined on both ends, two tunnels (one in each direction) must be defined as virtual trunks for this setting to take effect. Otherwise, the virtual trunk will be perceived as being “down”.

VT or VT_areanumber


The OSPF area assigned to the Virtual Trunk. This option applies only if Virtual Trunk is selected and the network uses OSPF routing (as opposed to, say, ISIS routing). A tunnel that is marked as a virtual trunk will be advertised as a link to other routers. If those routers perform OSPF area routing, they need to know what area this virtual trunk belongs to. Select the area from the pull-down box.

Table 4: Diversity Tab


If SITEDIV is selected, the program will pair tunnels with the same originating and terminating sites. Paired tunnels are routed diversely.

This field can also be used to specify the name of a group of tunnels this tunnel belongs to. When performing diverse path design, the program will try to design the paths of the tunnels in this group to be diverse.


Ddivgroupname where divgroupname is the name of a group of tunnels for which diverse paths is desired

Diverse Level

Allows users to specify path diversity requirements for tunnels with standby or secondary paths.

Select the desired level of diversity

NODEDIV for node disjoint paths

LINKDIV for link disjoint path

FACDIV for facility/SRLG disjoint paths




Tertiary Diverse

Indicates that if there is a third path for this tunnel (e.g., in the case of one primary plus two secondary paths), that all three paths should be designed to be diverse.

Users should add an entry for the second and third path and then design the path using the “Design > Tunnels > Path Design” option for NorthStar Planner to design this path.