Local Policy Actiondef Configuration Mode Commands

Mode

The Local Policy Actiondef Configuration Mode is used to define the action definitions to be used for local QoS policies.

Exec > Global Configuration > Local Policy Service Configuration > Local Policy Actiondef Configuration

configure > local-policy-service service_name > actiondef actiondef_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-local-policy-actiondef)# 

Important


The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).



Important


For information on common commands available in this configuration mode, refer to the Common Commands chapter.


action

This command configures the action priority for an actiondef.

Product

P-GW

SAEGW

Privilege

Security Administrator, Administrator

Mode

Exec > Global Configuration > Local Policy Service Configuration > Local Policy Actiondef Configuration

configure > local-policy-service service_name > actiondef actiondef_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-local-policy-actiondef)# 

Syntax

action priority priority action_name arguments 
no action priority priority 

priority priority

Specifies a priority for the specified action.

priority must be a unique integer from 1 to 2048.

action_name arguments

The following actions are supported. arguments specify a set of parameters to be used when invoking the action.
  • activate-ambr uplink bandwidth downlink bandwidth

    Sets the aggregated maximum bit rate (AMBR) for the APN.

    Configures uplink and downlink bandwidth. bandwidth must be an integer from 1 to 1000000000.

  • activate-flow-detection { initiation | termination } ruledef ruledef_name

    Detects a flow and takes action.

    initiation ruledef : Checks for flow initiation and adds a rule definition.

    termination ruledef : Checks for flow termination and adds a rule definition.

    ruledef_name must be an existing ruledef.

  • activate-lp-rule name lprule_name

    Activates a local-policy rule within service scheme when a subscriber is in the configured RAI or TAI range.

    lprule_name must be an existing local-policy rule within the service scheme expressed as an alphanumeric string of 1 through 63 characters.


    Important


    Local-Policy can support up to 7 lp-rules to be activated for a given session.


    When the subscriber moves out of the configured RAI or TAI range, the local-policy rule is deactivated. This option is added as part of Location Based QoS Override feature. For more information on this feature, see the ECS Administration Guide.

  • activate-rule name rule_name

    Activates a rule within ECS rulebase for a subscriber.

    rule_name must be an existing rule within this local QoS policy service expressed as an alphanumeric string of 1 through 63 characters.

  • activate-rulebase name rulebase_name

    Associates the session with a specific rulebase.

    rulebase_name must be an existing rulebase within this local QoS policy service expressed as an alphanumeric string of 1 through 63 characters.

  • allow-requested-qos

    Allow a specific UE initiated QoS request.

  • allow-session

    Allows the session to continue.

  • deactivate-flow-detection { initiation | termination } ruledef ruledef_name

    Deactivates detection of flow and takes action.

    initiation ruledef : Checks for flow initiation and adds a rule definition.

    termination ruledef : Checks for flow termination and adds a rule definition.

    ruledef_name must be an existing ruledef.

  • deactivate-rule name rule_name

    Deactivates a rule within ECS.

    rule_name must be an existing rule within this local QoS policy service expressed as an alphanumeric string of 1 through 63 characters.

  • deactivate-rulebase name rulebase_name

    Disassociates the rulebase from a session.

    rulebase_name must be an existing rulebase within this local QoS policy service expressed as an alphanumeric string of 1 through 63 characters.

  • default-qos qci value arp value

    Sets the default QoS parameters for the session

    qci value must be an integer from 1 through 254.

    arp value must be an integer from 1 through 15 (StarOS v12.1 and earlier) or 1 through 127 (StarOS v12.2 and later).

  • event-triggers { default-bearer-qos-change | ecgi-change | qos-change | tai-change | uli-change }

    This action specifies to enable the event triggers – Default EPS bearer QoS change event trigger, ECGI-Change event trigger and QoS change event trigger.

    The ECGI-Change event trigger is added as part of Location Based Local-Policy Rule Enforcement feature. For more information on this feature, see the Gx Interface Support chapter in the administration guide for the product you are deploying.

    The TAI-Change and ULI-Change event triggers are added as part of Location Based QoS Override feature. For more information on this feature, see the ECS Administration Guide.

  • fetch-usage-from-up

    This action specifies to fetch the usage report from UP by sending Sx-modify request to UP and uses that usage report values in the CCR-U.

  • reconnect-to-server [ send-usage-report ]

    Reconnects to the PCRF server to handle fallback scenario. That is, when the session falls back to local policy, this action specifies to retry connecting to the PCRF server.

    send-usage-report : Triggers CCR-U with volume report immediately. The default behavior is that the CCR-U will not be triggered immediately.

    On timer-expiry, if the initial failure is due to CCR-U failure, and if send-ccru-immediate is configured, then CCR-U will be sent with the usage report immediately.

  • reject-requested-qos

    Rejects UE QoS resource request.

  • retry-count value

    Retry action. This applies to start-timer/activate-rule/activate-ruledef.

    value must be an integer from 0 through 65535.

  • start-timer name duration value retry-count value

    Starts a named timer. On expiry of this timer, the local policy engine is contacted to initiate the appropriate action, such as termination of a session.

    duration value : Enter a timer duration from 0 through 28800 seconds. A value of 0 can be used to leave the local policy until the subscriber disconnects. Default timer value is 14400 (seconds).

    retry-count specifies the maximum number of times the server will be retried before terminating the call.

    retry-count value must be an integer from 0 through 65535. Default retry count is 3.

  • stop-timer name

    Stops the designated timer.

  • terminate-session

    Terminates the session.


Note


It is recommended to use a maximum number of 45 action priorities in an actiondef for performance reasons.

no action priority priority

Deletes the specified action.

Usage Guidelines

Use this command to enable the setting of parameters to be used when invoking actions. Actions are a series of operations that are triggered by activated rules.

This command can be entered multiple times to configure multiple actions for an actiondef. The actions are examined in priority order until a match is found and the corresponding action is applied.

Example

The following command creates an action to allow a session to continue with priority set to 125 :
action priority 125 allow-session