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.

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
The group name of a configured session agent group must be prefixed with SAG: For example:
  • policy-attribute: next-hop SAG:appserver
  • policy-attribute: next-hop lrt:routetable
  • policy-attribute: next-hop enum:lerg
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
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
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: configure terminal , and then session-router , and then local-policy , and then policy-attributes.

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.