Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    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.

    Modified: 2016-12-29