local-policy > policy-attributes
The policy-attributes subelement in conjunction with local-policy make routing decisions for the session based on the next-hop field value.
Constraints
This element is only available when the Routing entitlement is enabled.
Parameters
- 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:
- 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.
- 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.
- 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
- carrier
- Enter the carrier for this local-policy. Carrier names are arbitrary names used to affect the routing of SIP signaling messages based on their being specified in the local-policy, session-agent, and the sip-config. These carrier names are global in scope, especially if they are exchanged in TRIP.
- start-time
- Set the time of day these policy attributes considered for
preference determination
- Default: 0000
- Values: Min: 0000 | Max: 2400
- end-time
- Set the time of day these policy attributes cease to be
considered for preference determination
- Default: 2400
- Values: Min: 0000 | Max: 2400
- days-of-week
- Enter the combination of days of the week plus holidays that
policy attributes can be considered for preference determination. A holiday
entry coincides with a configured holiday. At least one day or holiday must
be specified in this field.
- Default: U-S
- Values:
- U—Sunday
- M—Monday
- T—Tuesday
- W—Wednesday
- R—Thursday
- F—Friday
- S—Saturday
- H—Holiday
- cost
- Enter the cost configured for local policy to rank policy
attributes. This field represents the cost of a route relative to other
routes reaching the same destination address.
- Default: 0
- Values: Min: 0 | Max: 999999999
- state
- Enable or disable these policy attributes as part of the
local-policy element
- Default: enabled
- Values: enabled | disabled
- app-protocol
- Select the signaling protocol used when sending messages to the
configured next-hop. When the Oracle Communications Session Border Controller 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.
- Values: H323 | SIP
- media-profiles
- Enter the names of media-profile elements related to the policy attribute. Media profiles define a set of media formats that the Oracle Communications Session Border Controller can recognize in SDP. This list does not have to be configured. However, if this list is configured, there can be as many entries within it as necessary.
- terminate-recursion
- Terminate route recursion with this next hop
- Default: disabled
- Values: enabled | disabled
- 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.
- 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.
- Default: single
- Values: single | multi
- next-key
- Select the key to use for the next stage of local policy
look-up.
- Values: $TO | $FROM | $PAI
- auth-user-lookup
- Enter the name of the auth-attributes in your target realm.
- eloc-str-lkup
- Set this parameter to enabled for the Oracle Communications Session Border Controller to parse the emergency
location string, as received in a CLF Line Identifyier AVP, for emergency
LRT lookup.
- Default: enabled
- Values: enabled | disabled
- eloc-str-match
- Set this parameter to the attribute name found in
thelocation-string whose value will be used as a lookup key in the LRT named
in the next-hop parameter.
- Values: <string> string used as key for emergency LRT lookup
Path
policy-attributes is a subelement under the local-policy element. The full path from the topmost ACLI prompt is: .
Note:
You must select a local-policy element to which you want to add policy attributes before you enter those elements. If you do not select a local-policy element prior to entering configurations for the policy attributes, your information will be lost. This is a multiple instance configuration element.