Previous page Next page

show penalty-setting link

Displays the penalty values that would be required to move a percentage of prefixes off a specified link.

Syntax
show [ last ] penalty-setting link <name> 
 
     [ move-percentage <percent> ]
 
     [ load]
 
     [ | { include | exclude | begin } <exp> ] 
 
     [ > <url> ]
 
Arguments
Prerequisites

System operations mode, any level access.

Description

The show penalty-setting link command displays the penalty values required to move various percentages of prefixes off the link specified by the name argument. See the penalty command for information about assigning penalties to service provider links.

NOTE: Output of the show penalty-setting link command is valid as long as the CNA decision-maker process uses the same winner-set-width and penalty values when selecting routes, for all prefixes. If you override these values for some prefixes using the decision-policy command, the suggested penalty settings will not be accurate.

If you use the last keyword, data used for the calculations will be obtained from the most recent snapshot image of the database.

If you use the move-percentage keyword with a percent value, the output will show the penalty value required to move the specified percentage of prefixes. If you omit the move-percentage keyword, the output will show the values required to move prefixes in 10% increments, up to 100%.

If you use the load keyword, data for each prefix will be weighted by an estimate of its load, and percentages will approximate traffic volume for each link instead of just showing numbers of prefixes.

For example, if you have a service provider link named link_1, you might get output similar to the following:

show penalty-setting link link_1
 

 
% of Total % moved Penalty req'd
 
        25       0             0
 
        22      10            35
 
        20      20            42
 
        17      32            46
 
        13      47            48
 
        11      56            49
 
         7      69            50
 
         5      76            51
 
         4      81            52
 
         2      90            56
 
         0     100           291
 

 

If you wanted to know how high to set the penalty in order to move 50 percent of the prefixes currently served by the link off the specified link, the command and output would look similar to the following:

CNA# show penalty-setting link ISP-1 move-percentage 50
 
Penalty setting information for link: ISP-1
 
Current penalty setting: 0
 

 

 
% of Total % moved Penalty req'd
 
        25       0             0
 
        11      56            49
 

 

The first line of numbers shows the current distribution on the link, at the current penalty setting.

The second line shows the penalty required to achieve the specified percentage of movement.

NOTE: Since neither prefixes nor penalty values can be fractional, the numbers in the table will be adjusted as necessary in order to be able to move whole prefixes or to display penalties as integers.This also means that the values in the middle column only approximate multiples of 10. And, if you specify a percentage that would require a fractional penalty, the output will be adjusted to the next highest penalty and its equivalent percentages. In the example, we asked for the penalty required to move 50 percent of the prefixes. Since that would require a penalty between 48 and 49, the output shows the higher integer, 49, which will move 56 percent of the prefixes.

The first column, % of Total, shows what percentage of the total prefixes known to CNA are currently being served by the link. The second column, % moved, tells you what percentage of those prefixes would be moved if the penalty were set to the value in the third column, Penalty Req’d.

You can pipe the command through one of the following filters:

The vertical-line pipe character | is required when a filter is used.

You can send the output to a remote file location, by piping the display to a remote URL (leading > required). See the copy command for URL syntax.


Previous page Next page