local-policy
The local-policy configuration element determines where session signaling messages are routed and/or forwarded.
Parameters
- from-address
- Enter the source IP address, POTS number, E.164 number, or hostname for the local-policy element. At least one address must be set within this list, but it can include as many addresses as necessary. This parameter may be wildcarded, or entered with a DS: prefix (dialed string).
- to-address
- Enter the destination IP address, POTS number, E.164 number, or hostname for the local-policy element. At least one address must be set within this list, but it can include as many addresses as necessary. This parameter may be wildcarded.
- source-realm
- Enter the realms used to determine how to route traffic. This
list identifies incoming traffic on a realm and is used for routing by
ingress realm via the local policy element. Source-realm entries must be a
valid realm.
- Default: *
- description
- Provide a brief description of the local-policy configuration element
- activate-time
- Set the time when selected local-policy becomes valid
- deactivate-time
- Set the time when selected local-policy becomes invalid
- state
- Enable or disable the local-policy element
- Default: enabled
- Values: enabled | disabled
- parallel-forking
- Enable or disable parallel forking on this local-policy.
- Default: disabled
- Values: enabled | disabled
- policy-priority
- Set the policy priority parameter for this local policy. It is
used to facilitate emergency sessions from unregistered endpoints. This
value is compared against a policy priority parameter in a SIP interface
configuration element.
- Default: none
- Values: none | normal | non-urgent | urgent | emergency
- next-hop
-
Enter the next signaling host IP address, SAG, hostname, or ENUM config; ENUM is also an accepted value. You can use the following as next-hops:
Note:
This attribute is only present when the Routing entitlement is disabled.- IPv4 address or IPv6 address of a specific endpoint
- Hostname or IPv4 address or IPv6 address of a configured session agent
- Group name of a configured session agent group
- realm
-
Enter the egress realm, or the realm of the next hop. If traffic is routed using the local policy, and the selected route entry identifies an egress realm, then this realm field value will take precedence. This value must be a valid entry in a realm configuration.
Note:
This attribute is only present when the Routing entitlement is disabled. - action
-
Set this parameter to redirect if you want to send a redirect next-hop message back to the calling party with the information in the Contact. The calling party then needs to send an INVITE using that information.
Note:
This attribute is only present when the Routing entitlement is disabled.- Default: none
- Values:
- none—No specific action requested
- replace-uri—To replace the Request-URI with the next hop
- redirect—To send a redirect response with this next hop as contact
- terminate-recursion
-
Terminate route recursion with this next hop
Note:
This attribute is only present when the Routing entitlement is disabled.- Default: disabled
- Values: enabled | disabled
- app-protocol
-
Select the signaling protocol used when sending messages to the configured next-hop. When the SBC receives an ingress signaling message and uses local policy to determine the message’s destination, it will interwork the signaling between protocols (H.323<—>SIP or SIP<—>H.323) if the signaling type does not match the value configured in the app-protocol field.
Note:
This attribute is only present when the Routing entitlement is disabled.- Default: ""
- Values: "" | SIP | H323 | MGCP | H248 | BGF | BFD | SCF | RTSP | DD | DIAMETER | IKE | NONE
- methods
-
Enter the SIP methods you want to use for matching this set of policy attributes. Use a double-quoted string with space-separated items.
Note:
This attribute is only present when the Routing entitlement is disabled.- Values: INVITE | REGISTER | PRACK | OPTIONS | INFO | SUBSCRIBE | NOTIFY | REFER | UPDATE | MESSAGE | PUBLISH
- lookup
-
Enable multistage local policy routing, or leave the parameter at the default single for single stage local policy routing.
Note:
This attribute is only present when the Routing entitlement is disabled.- Default: single
- Values: single | multi
- next-key
-
Select the key to use for the next stage of local policy look-up.
Note:
This attribute is only present when the Routing entitlement is disabled.- Values: $TO | $FROM | $PAI
Path
local-policy is an element under the session-router path. The full path from the topmost ACLI prompt is: .
Note:
This is a multiple instance configuration element.