Configuring Hierarchical Rate-Limit Actions (SRC CLI)

You configure parent groups to create a hierarchy of rate-limits actions.

The type of action that you can create depends on the type of policy rule. See Policy Information Model.

Use the following configuration statements to configure rate-limit actions:

policies group name list name parent-group name {description description;}
policies group name list name parent-group name parent-group name {description description;}
policies group name list name parent-group name parent-group name {external-parent-group-reference external-parent-group-reference ;}
policies group name list name parent-group name external-parent-group-reference {external-parent-group-name external-parent-group-name;hierarchical-policy-parameter hierarchical-policy-parameter;}
policies group name list name parent-group name external-parent-group-reference hierarchical-policy-parameter {numeric-aggregation-node numeric-aggregation-node;level-aggregation-node level-aggregation-node;level-aggregation-node-id level-aggregation-node-id;}
policies group name list name parent-group name rate-limit {type type;committed-rate committed-rate;committed-burst committed-burst;peak-rate peak-rate;peak-burst peak-burst;excess-burst excess-burst;color-aware;}

To configure a parent group:

  1. From configuration mode, create a parent group in a policy list—for example, PGShared.
    [edit policies group parentGroupDefault list twoRate]user@host# edit parent-group PGShared
  2. Configure a rate limit for the parent group.
    [edit policies group parentGroupDefault list twoRate parent-group PGShared]user@host# edit rate-limit
    • Specify that the rate limit is either one rate or two rate. The rate-limit type determines the options that you can configure for a rate-limit action.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# set type type
    • (Optional) Configure the target rate for the traffic that the policy covers.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# set committed-rate committed-rate
    • (Optional) Configure the amount of bandwidth allocated to burst traffic in bytes.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# set committed-burst committed-burst
    • (Optional) For two-rate rate-limit profiles, specify the amount of bandwidth allocated to excess traffic flow over the committed rate.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# set peak-rate peak-rate
    • (Optional) For two-rate rate limit profiles, specify the amount of bandwidth allocated to burst traffic in excess of the peak rate.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# set peak-burst peak-burst
    • (Optional) For one-rate rate limit profiles, specify the amount of bandwidth allocated to accommodate burst traffic.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# set excess-burst excess-burst
    • (Optional) Set the rate-limit to color aware for the rate-limit to process color values set in the TOS byte of the packet header.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# set color-aware
  3. (Optional) Configure the rate-limit actions for traffic flows that:
    • Do not exceed the committed rate and burst size
    • Exceed the committed rate but remain below the peak burst size

    See Configuring Types of Actions for Rate-Limit Actions (SRC CLI).

  4. Enter a description for the parent group.
    [edit policies group parentGroupDefault list twoRate parent-group PGShared]user@host# set description description
  5. Step up one level in the edit hierarchy.
    [edit policies group parentGroupDefault list twoRate parent-group PGShared rate-limit]user@host# up [edit policies group parentGroupDefault list twoRate parent-group PGShared]
  6. (Optional) Configure the parent group to reference an external parent group. For example, to add a reference called epg1-ref:
    [edit policies group parentGroupDefault list twoRate parent-group PGShared]user@host# edit external-parent-group-reference epg1-ref
    • Specify the name of the external parent group that you want to reference. For example, to reference the external parent group epg1:
      [edit policies group parentGroupDefault list twoRate parent-group PGShared external-parent-group-reference epg1-ref]user@host# set external-parent-group-name epg1
    • Specify the name of the hierarchical policy parameter for the external parent group. For example, to associate the hierarchical policy parameter called hpp1:
      [edit policies group parentGroupDefault list twoRate parent-group PGShared external-parent-group-reference epg1-ref]user@host# set hierarchical-policy-parameter hpp1
    • Specify the attributes of the hierarchical policy parameter that you are referencing.
      [edit policies group parentGroupDefault list twoRate parent-group PGShared external-parent-group-reference epg1-reference hierarchical-policy-parameter hpp1]user@host# set numeric-aggregation-node numeric-aggregation-node user@host# set level-aggregation-node level-aggregation-node user@host# set level-aggregation-node-id level-aggregation-node-id

      For information about configuring the attributes of the hierarchical policy parameter, see Configuring Hierarchical Policy Parameters for External Parent Groups (SRC CLI).

  7. (Optional) Return to the rate-limit action configuration and verify the configuration.
    [edit policies group parentGroupDefault list twoRate parent-group PGShared]
    user@host# show 
    
  8. (Optional) Create another parent group within this parent group. For example:
    [edit policies group parentgroupDefault list twoRate parent-group PGShared]user@host# edit parent-group parent-group-name
  9. (Optional) Follow the instructions in this procedure for configuring the parent group.

Related Documentation