Configuring Diameter-based RACF

In the following configuration examples, we assume that your baseline configuration passes SIP traffic, with the Oracle Communications Session Border Controller (OCSBC) in the role of an Access OCSBC. In this example, you perform realm configuration and external bandwidth manager configuration. You also configure media profiles with the bandwidth parameters you reserve at the RACF.

Diameter Support Realm Configuration

To configure the realm configuration for Diameter support in a CAC scenario:

In Superuser mode, type configure terminal and press Enter.
```
ORACLE# configure terminal
```
Type media-manager and press Enter to access the media-related configurations.
```
ORACLE(configure)# media-manager
```
Type realm-config and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.
```
ORACLE(media-manager)# realm-config
ORACLE(realm-config)#
```
Type select and the number of the pre-configured sip interface you want to configure.
```
ORACLE(realm-config)# select 1
ORACLE(realm-config)#
```
mm-in-realm—Set this parameter to enabled so that calls from devices in the same realm have their media flow through the Oracle Communications Session Border Controller to be subject to CAC. The default value is disabled. The valid values are:
- enabled | disabled
mm-in-network—Set this parameter to enabled so that the Oracle Communications Session Border Controller will steer all media traveling between two endpoints located in different realms, but within the same network. If this field is set to disabled, then each endpoint will send its media directly to the other endpoint located in a different realm, but within the same network. The default value is enabled. The valid values are:
- enabled | disabled
ext-bw-manager—Enter the name of the external bandwidth manager configuration instance to be used for external CAC for this Realm.
Save your work using the ACLI done command.

External Bandwidth Manager Configuration

To configure the external bandwidth manager:

In Superuser mode, type configure terminal and press Enter.
```
ORACLE# configure terminal
```
Type media-manager and press Enter to access the media-related configurations.
```
ORACLE(configure)# media-manager
```
Type ext-policy-server and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.
```
ORACLE(media-manager)# ext-policy-server
ORACLE(ext-policy-server)#
```
name—Enter the name for this external bandwidth manager instance. This parameter is used to identify the PDP that will be used in each Realm configuration.
state—Set the state of this ext-policy-server configuration to enabled to run this CAC. The default value is enabled. The valid values are:
- enabled | disabled
operation-type—Enter bandwidth-mgmt for this external policy server configuration element to perform RACF/External Policy Server functions. The default value is disabled. The valid values are:
protocol—Enter Diameter to support Diameter-based CAC. The default value is C-SOAP.
address—Enter the IP address or FQDN of an external policy server, or enter the name of a policy-group preceded by the PAG: prefix. IP addresses can by IPv4 or IPv6.
port—Enter the port number the diameter connection connects to on the RACF. The system ignores this parameter if the address parameter is set to a policy-group or an FQDN. The valid range is:
- Minimum—0
- Maximum—65535
realm—Enter the name of the Realm in which this Oracle Communications Session Border Controller defines the RACF to exist. This is NOT necessarily the Realm where the Oracle Communications Session Border Controller performs admission control. The system ignores this parameter if the address parameter is set to a policy-group.
transport-protocol—Enter the transport protocol used to connect to this external policy server.
- TCP (Default)
- SCTP
local-multi-home-addrs—Applies to SCTP. Enter an IP address that is local to the OCSBC and can be used by this external policy server as an alternate connection point. This address must be the same type as the address parameter, either IPv4 or IPv6
remote-multi-home-addrs—Applies to SCTP. Enter an IP address that can be used by this OCSBC as an alternate connection point. This address must be the same type as the address parameter, either IPv4 or IPv6.
sctp-send-mode—Applies to SCTP. Specifies the SCTP delivery mode..
- ordered (Default)
- unordered
permit-conn-down—Enter enabled if this external policy server configuration can permit new calls into the network when the policy server connection is down. The default value is disabled. The valid values are:
product-name—Enter text string that describes the vendor-assigned name for the RACF. This parameter is required.
application-mode—Enter the type of interface you want to use. Your choices are: Rq, Rx, Gq, e2, and none.
application-id—Enter a numeric application ID that describes the interface used to communicate with the RACF. The default value is zero (0). The valid range is:
- Minimum—0
- Maximum—999999999
framed-ip-addr-encoding—Enter the format of the Frame-IP-Address (AVP 8) value in Diameter messages. The default value is octet-string. The valid values are:
- ascii-string—Example: 192.168.10.1
- octet-string—Example: 0xC0A80A01
dest-realm-format—Enter the format you want to use for the Destination-Realm AVP. The default value is user_with_realm. The valid values are:
- user_with_realm | user_only | realm_only
domain-name-suffix—Enter the suffix you want to use for Origin-Realm and Origin-Host AVPs that have a payload string constructed as a domain name Your value can be any string, to which the system will prepend with a dot if you do not include one. The default value is .com.
allow-srv-proxy—Set to enabled in order to include the proxy bit in the header. The presence 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). The default is enabled. The valid values are:
- 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.
reserve-incomplete—Set this parameter to enabled when communicating with a PDP via Diameter. The parameter allows the Oracle Communications Session Border Controller to make admission requests before learning all the details of the flows and devices (e.g., not knowing the final UDP port numbers for the RTP media streams until after the RTP has begun). The default value is enabled. The valid values are:
- enabled (default)—This mode supports the usual behavior when the AAR is sent upon SDP offer as well as SDP answer. This mode ensures backwards compatibility.
- orig-realm-only—This mode allows calls originating from a realm with a policy server associated with it to send the AAR upon SDP offer. However, calls terminating at a realm with a policy server associated with it send the AAR post SDP exchange.
- disabled—This mode allows no bandwidth reservation for incomplete flows.
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. RTCP information is the number of the RTP port plus one (RTP port + 1 = RTCP ports) for all sessions.
trans-expires—Set the amount of time, in seconds, that the Oracle Communications Session Border Controller waits before performing an expiration if a Diameter base protocol transaction does not occur. The default value is 15 seconds. Valid values range between 1 and 15.
Save your work using the ACLI done command.

Media Profile Configuration

Values for the following parameters can be found in the PacketCable™ Audio/Video Codecs Specification PKT-SP-CODEC-I06-050812 document.

To configure the media profile configuration for Diameter support in a CAC scenario:

In Superuser mode, type configure terminal and press Enter.
```
ORACLE# configure terminal
```
Type session-router and press Enter to access the session router path.
```
ORACLE(configure)# session-router
```
Type media-profile and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.
```
ORACLE(session-router)# media-profile
ORACLE(media-profile)#
```
Type select and the number of the pre-configured media profile you want to configure.
```
ORACLE(media-profile)# select 1
ORACLE(media-profile)#
```
req-bandwidth—Enter the required bandwidth in Kbps for the selected media profile. This is the bandwidth that the Oracle Communications Session Border Controller will request from the policy server. The default value is zero (0). The valid values are:
- Minimum—0
- Maximum—4294967295
standard-pkt-rate—Enter the value to use for the standard packet rate for this codec when sending a request to the RACF for a bandwidth request.
Save your work using the ACLI done command.

Configuring the Rx Interface for SCTP

You configure the Rx interface for SCTP transport from the ext-policy-server element. See the SCTP Overview and configuration sections in this document's System Configuration chapter for information about SCTP operation and the global settings within the network-parameters element that apply to all SCTP operation.

From superuser mode, use the following command sequence to access sip-port configuration mode.

ORACLE# configure terminal
ORACLE(configure)# media-manager
ORACLE(media-manager)# ext-policy-server
ORACLE(ext-policy-server)#

Set the operation-type to bandwidth-mgmt for this external policy server configuration element to perform RACF/External Policy Server functions.
```
ORACLE(ext-policy-server)#  operation-type  bandwidth-mgmt
```
Set the application-id to 16777236 for the Rx interface. (See the guidelines in Application ID and Modes.)
```
ORACLE(ext-policy-server)#  application-id 16777236
```
Set the application-mode to Rx. (See the guidelines in Application ID and Modes.)
```
ORACLE(ext-policy-server)#  application-mode Rx
```
Use the address parameter to set the IPv4, IPv6 or FQDN address of the policy server.
```
ORACLE(ext-policy-server)# address 172.16.10.76
```
Retain the default value, 5060 (the well-known SIP port) for the port parameter.
```
ORACLE(ext-policy-server)# port 5060
```
Use the transport-protocol parameter to set the layer 4 protocol to SCTP.
```
ORACLE(ext-policy-server)# transport-protocol sctp
```
Use the remote-multi-homed-addrs parameter to specify a remote secondary address of the SCTP endpoint.
This address must be of the same type (IPv4 or IPv6) as that specified by the address parameter, unless the address is an FQDN.
```
ORACLE(ext-policy-server)#remote-multi-homed-addrs 182.16.10.76
```
Use the local-multi-homed-addrs parameter to specify a local secondary address of the SCTP endpoint.
This address must be of the same type (IPv4 or IPv6) as that specified by the address parameter, unless the address is an FQDN. Like the address parameter, this address identifies an OCSBC network interfaces.
```
ORACLE(ext-policy-server)# local-multi-homed-addrs 162.16.10.76
```

Use done, exit, and verify-config to complete configuration of this SCTP-based SIP port.

ORACLE(ext-policy-server)# done
ORACLE(media-manager)# exit
ORACLE(configure)# exit
ORACLE# verify-config
---------------------------------------------------------------------
Verification successful! No errors nor warnings in the configuration
ORACLE#

CAC Debugging

A new argument has been added to the show command for viewing CAC statistics. From the user prompt, type show ext-band-mgr.

ORACLE# show ext-band-mgr
10:11:38-194
EBM Status                 -- Period -- -------- Lifetime --------
                 Active    High   Total      Total  PerMax    High
Client Trans          0       0       0          0       0       0
Server Trans          0       0       0          0       0       0
Sockets               1       1       1          1       1       1
Connections           0       0       0          0       0       0
                           ---- Lifetime ----
                    Recent      Total  PerMax
Reserve                  0          0       0
Modify                   0          0       0
Commit                   0          0       0
Remove                   0          0       0
EBM Requests             0          0       0
EBM Installs             0          0       0
EBM Errors               0          0       0
EBM Rejects              0          0       0
EBM Expires              0          0       0
EBMD Errors              0          0       0

Retrieve the CAC statistics in the log.embd file.