ext-policy-server

The ext-policy-server is used for configuring PDP/RACF or CLF functionality on the Oracle Communications Session Border Controller.

Parameters

name

Enter the name of this external policy server configuration

state

Enable or disable the operational state of this external policy server configuration

• Default: enabled
• Values: enabled | disabled

operation-type

Select the function this external policy server performs

• Default: disabled
• Values:
  • disabled
  • admission-control—Oracle Communications Session Border Controllercommunicates with a CLF to obtain location string
  • bandwidth-mgmt— Oracle Communications Session Border Controller acts as a PEP in a PDP/RACF deployment

protocol

Select the external policy server communication protocol

• Default: C-SOAP
• Values:
  • COPS—Standard COPS implementation. COPS client type is 0x7929 for CLF, and 0x7926 for PDP/RACF usage as defined in the operation-type parameter.
  • A-COPS—Vendor specific protocol. COPS client type is 0x4AC0 for admission-control operation-type.
  • SOAP—Not used
  • C-SOAP—Not used
  • DIAMETER—Connects the Oracle Communications Session Border Controller to the policy-server

address

Enter the IP address of external policy server

port

Enter the port on the external policy server to connect to for COPS messages. The standard port for COPS is 3288.

• Default: 80
• Values: Valid Range: 0-65535

realm

Enter the realm where the external policy server exists

num-connections

Enter the number of TCP connections to external policy server

• Default: 1
• Values: Min: 0 / Max: 65535

reserve-incomplete

Enable or disable admission requests being made before all of the details of the call are known

• Default: enabled
• Values:
  • Enabled—Supports the usual behavior when the AAR is sent upon SDP offer as well as SDP answer. This mode ensures backwards compatibility with releases prior to Release S-C6.1.0.
  • Orig-realm-only—Allows calls originating from a realm with a policy server associated with it to send the AAR upon SDP offer; calls terminating at a realm with a policy server associated with it send the AAR post SDP exchange.
  • Disabled—Allows no bandwidth reservation for incomplete flows.

permit-conn-down

Enable or disable the Oracle Communications Session Border Controller’s ability to permit calls if there is no connection to the external policy server.

• Default: disabled
• Values: enabled | disabled

permit-on-reject

Change this parameter to enabled if you want the Oracle Communications Session Border Controller to forward the session on at a “best-effort”. Leave this parameter set to disabled (Default), if you want the Oracle Communications Session Border Controller to deny the session on attempts to revert to the previously-requested bandwidth

• Default: disabled
• Values: enabled | disabled

permit-on-reject

Change this parameter to enabled if you want the Oracle Communications Session Border Controller to forward the session on at a “best-effort”. Leave this parameter set to disabled (default), if you want the Oracle Communications Session Border Controller to deny the session on attempts to revert to the previously-requested bandwidth.

• Default: disabled
• Values: enabled | disabled

disconnect-on-timeout

Disable this parameter to prevent timeouts triggered by Gate-Set or Gate-Delete message sequences between the Oracle Communications Session Border Controller and a policy server from tearing down their connection. Retaining the default (enabled) allows all timeouts to tear down and re-establish the TCP connection.

• Default: enabled
• Values: enabled | disabled

product-name

Enter the vendor product name

application-mode

Select the mode in which the policy server interface is operating

• Default: none
• Values: Rq | Rx | Gq | e2 | pktmm3

application-id

Enter the application mode of this interface

• Default: 0
• Values: Min: 0 / Max: 999999999

framed-ip-addr-encoding

Set the format of the Frame-IP-Address (AVP 8) value in Diameter messages.

• Default: octet-string
• Values: octet-string (i.e., 0xC0A80A01) | ascii-string (i.e., 192.168.10.1)

dest-realm-format

Set the format for the Destination-Realm AVP.

• Default: user_with_realm
• Values: user_with_realm | user_only | realm_only

ingress-realm-location

Set this parameter to configure the child realm or its parent for the Address-Realm in the Globally-Unique-Address AVL in DIAMETER UDR messages that the Oracle Communications Session Border Controller sends to the policy server.

• Default: realm-in
• Values:
  • realm-in—This setting means that the Oracle Communications Session Border Controller will use the same realm on which the REGISTRATION request arrived.
  • sip-interface—This setting means that the Oracle Communications Session Border Controller will use the realm associated with the SIP interface on which the REGISTRATION request arrived.
  • diam-address-realm - For the e2 interface, this value enables configurable Address-Realm AVPs. This setting points the Oracle Communications Session Border Controller to the associated realm from which it will learn Address-Realm AVP information.

user-name-mode

Determines how the User-Name AVP is constructed. Used primarily with e2 based CLF functionality.

• Default: none
• Values:
  • none—Oracle Communications Session Border Controller does not include the User-Name AVP in any UDRs
  • endpoint-ip—IP address of the registering endpoint is sent as the payload for the User-Name AVP
  • public-id—SIP-URI portion of the TO header from the register message is sent as the payload for the User-Name AVP
  • auth-user—Username attribute of the Authorization header from the register is sent as the payload for the User-Name AVP; if there is no authorization header, the Oracle Communications Session Border Controller will not consult the CLF and will forward the registration message.

domain-name-suffix

Sets the suffix for Origin-Realm and Origin-Host AVPs that have a payload string constructed as a domain name. If your entry does not include the dot, the system prepends one.

• Default: .com

gate-spec-mask

With this parameter, you can configure the Oracle Communications Session Border Controller to use a mask comprised entirely of zeros (0). The default value is 255. This parameter sets the value to use for the COPs pkt-mm-3 interface. This interface maintains a persistent TCP connection to the external policy server, even without repsonses to requests for bandwidth. This permits calls to traverse the Oracle Communications Session Border Controller even though the external policy server either fails to respond, or rejects the session.

• Default: 255
• Values: Min: 0 / Max: 255

allow-srv-proxy

Enable this parameter if you want to include the proxy bit in the header. The presense of the proxy bit allows the Oracle Communications Session Border Controller to tell the external policy server whether it wants the main server to handle the Diameter message, or if it is okay to proxy it to another server on the network (disabled)

• Default: enabled
• Values: enabled | disabled

wildcard-trans-protocol

Set this parameter from enabled if you want to use transport protocol wildcarding for Rx/Rq Flow-Description AVP (507) generation. Enabled sends a flow description of “ip”. Set this parameter to disabled if you want to use the specific media stream transport protocol.

• Default: disabled
• Values: enabled | disabled

watchdog-ka-timer

Enter the number of seconds to define the interval for watchdog/keep-alive messages; this is the time in which the Oracle Communications Session Border Controller must receive a COPS-KA message from the policy server to ensure collection is still valid.

• Default: 0
• Values: Min: 0 / Max: 999999999

include-rtcp-in-request

Change this parameter from disabled (default), to enabled so the Oracle Communications Session Border Controller will include RTCP information in AARs.

• Default: disabled
• Values: enabled | disabled

provision-signaling-flow

Enables the Oracle Communications Session Border Controller to send AARs to PCRFs after registration that includes the grouped Media-Component-Description AVP as described in 3GPP TS 29.213 section B1b [1], and the procedures specified in TS 29.214 section 4.4.5a.

• Default: disabled
• Values: enabled | disabled

max-timeouts

max number of request timeouts before the Oracle Communications Session Border Controller sets this external policy server to inactive.

• Default: 0
• Values: Min: 0 / Max: 200

max-connections

Number of external policy servers to be monitored as a server cluster

• Default: 1

srv-selection-strategy

Strategy used to select an external policy server from the cluster.

• Default: Failover

optimize-aar

Reduces the number of ARRs sent to the PCRF.

• Default: disabled
• Values: enabled | disabled

cache-dest-host

Used to enable the Diameter Multi-tiered Policy Server Support feature.

• Default: disabled
• Values: enabled | disabled

specific-action-subscription

Populates the Specific-Action AVP in an AAR message to indicate the subscription types it supports. When unconfigured, no Specific-Action AVP is sent.

• Default: blank
• Values:
  • loss-of-bearer
  • recovery-of-bearer
  • release-of-bearer
  • out-of-credit
  • successful-resources-allocation
  • failed-resources-allocation
  • access-network-info-report

specific-action-sig-flow-subscription

subscribes for signaling flow status change notifications

diameter-in-manip

Configure this parameter with the name of a diameter-manipulation to be applied on traffic inbound to the Oracle Communications Session Border Controller.

diameter-out-manip

Configure this parameter with the name of a diameter-manipulation to be applied to outbound traffic from this Oracle Communications Session Border Controller.

asynchronous-mode

Identifies whether to use the asynchronous mode of signaling on the external policy server interface rather than the default synchronous mode.

• Default: disabled
• Values: enabled | disabled

media-release

For scenarios wherein the SBC releases media, enabling this parameter allows the policy server request to include flow descriptions that accurately represent the IP addresses of the two endpoints instead of that of the Oracle Communications Session Border Controller.

• Default: disabled
• Values: enabled | disabled

options

Enter any customer-specific features and/or parameters for this external policy server. This parameter is optional.

Path

ext-policy-server is an element under the media-manager path. The full path from the topmost ACLI prompt is: configure terminal > media-manager > ext-policy-server.