23 Configuring R-IM-ASF SIP

The following sections describe how to configure R-IM-ASF SIP using the Service Broker Administration Console and Java MBeans.

Configuring R-IM-ASF SIP with the Administration Console

This section describes how to configure R-IM-ASF SIP module instances using the Service Broker Administration Console.

To access the R-IM-ASF SIP configuration screen:

In the domain navigation pane, expand OCSB.
Expand Processing Tier.
Select Interworking Modules.

A list of currently deployed Interworking Modules is displayed.
From the module list, select the module instance that you want to configure.

The R-IM-ASF SIP configuration pane contains the subtabs described in Table 23-1.

Table 23-1 R-IM-ASF Configuration Subtabs

Subtab	Description
Network Entity	Enables you to specify the URL address of the network entity with which the R-IM-ASF SIP communicates. See "Configuring the Network Entity Parameters" for more information.
Session Keep Alive	Enables you to define the keep-alive mechanism that R-IM-ASF SIP use to test session existence with the SIP network element. See "Configuring Session Keep Alive Parameters" for more information.
SIP	Enables you to configure standard SIP protocol parameters. See "Configuring SIP Parameters" for more information.
Charging Service	Enables you to define how R-IM-ASF sends credit reservation requests and specify whether R-IM-ASF reauthorizes a quota upon receiving various triggers from a CSCF. See "Charging Services" for more information.
Monitoring	Enables you to define how Runtime MBeans and notifications should operate. See "Configuring Monitoring Parameters" for more information.

Configuring the Network Entity Parameters

You use the Network Entity tab to specify the URL address of the network entity with which the R-IM-ASF SIP communicates.

Table 23-2 describes the parameter that you need to define.

Table 23-2 Network Entity Parameter

Name	Type	Description
Network Entity Address Alias	STRING	Specifies the address of the network entity with which the R-IM-ASF SIP communicates. Define the address in the SIP URI format. The alias that you provide must be defined in the SIP Network Entities tab on the SSU SIP configuration screen. See the "Configuring SIP Network Entities" section in the "Configuring SIP Signaling Server Units" chapter in the Oracle Communications Service Broker Signaling Domain Configuration Guide.

Name

Type

Description

Network Entity Address Alias

STRING

Specifies the address of the network entity with which the R-IM-ASF SIP communicates. Define the address in the SIP URI format.

The alias that you provide must be defined in the SIP Network Entities tab on the SSU SIP configuration screen. See the "Configuring SIP Network Entities" section in the "Configuring SIP Signaling Server Units" chapter in the Oracle Communications Service Broker Signaling Domain Configuration Guide.

Configuring Session Keep Alive Parameters

R-IM-ASF SIP performs regular checks of SIP sessions using a mechanism known as keep-alive mechanism. This mechanism enables the R-IM-ASF SIP to check whether or not a session is still in progress by periodically sending INFO requests to the SIP network element and checking the response. 200 OK response indicates that the session is still in progress. Any other response, or no response at all, indicates that the session was dropped.

Table 23-3 describes configuration parameters on the Session Keep Alive subtab.

Table 23-3 Session Keep Alive Parameters

Name	Type	Description
INFO Keep Alive Interval in Seconds	INT	Specifies the interval, in seconds, between consecutive invocations of INFO requests. To disable the keep-alive mechanism, set this parameter to -1. When this parameter is not defined, then the keep-alive mechanism is disabled.
INFO Keep Alive Time to Die	INT	Specifies the interval, in seconds, that the R-IM-ASF waits for a response to keep-alive messages. If there is no response within the time specified in this parameter, the session is ended.

Name

Type

Description

INFO Keep Alive Interval in Seconds

INT

Specifies the interval, in seconds, between consecutive invocations of INFO requests.

To disable the keep-alive mechanism, set this parameter to -1.

When this parameter is not defined, then the keep-alive mechanism is disabled.

INFO Keep Alive Time to Die

INT

Specifies the interval, in seconds, that the R-IM-ASF waits for a response to keep-alive messages.

If there is no response within the time specified in this parameter, the session is ended.

Configuring SIP Parameters

You use the SIP Parameters tab to configure standard SIP protocol parameters.

Table 23-4 describes configuration parameters on the SIP subtab.

Table 23-4 SIP Parameters

Name	Type	Description
Max Call Duration Timeout Interval in Minutes	INT	Specifies the maximum duration of established calls which are measured from OK to BYE. When this timer expires, IM-ASF SIP releases the session. Default value: 60 minutes
Retransmission Interval Limit	INT	Specifies a maximum retransmission interval for non-INVITE requests and INVITE responses. Default value: 20 seconds
T7 Timeout Interval in Seconds	INT	Specifies the time period in seconds during which the IM-ASF SIP waits for the first SIP provisional response (except for 100) after sending an INVITE request. Default value: 30 seconds
T9 Timeout Interval in Seconds	INT	Specifies the time period in seconds during which the IM-ASF SIP waits for an OK response or any call release response (for example, ERROR) after sending an INVITE request. Default value: 90 seconds

Charging Services

You can configure R-IM-ASF to monitor session duration and charge sessions. R-IM-ASF provides the following capabilities:

Credit reservation requests generation

R-IM-ASF sends these requests to IM-OCF through the OE. IM-OCF translates credit reservation requests to Diameter CCRs, which are then forwarded to a billing application.
Session monitoring and charging

R-IM-ASF monitors and charges a session on its own.
Quota reauthorization

You can specify whether R-IM-ASF reauthorizes a quota upon receiving various triggers from a CSCF.

To set up R-IM-ASF charging services, you use the Charging Services tab. This tab contains the subtabs described in Table 23-5.

Table 23-5 Charging Services Subtabs

Subtab	Description
General	Enables you to specify how R-IM-ASF sets up and sends credit reservation requests to the OE. See "General" for more information.
Reauthorization Triggers	Enables you to specify whether R-IM-ASF reauthorizes a quota upon receiving various triggers from a CSCF. See "Reauthorization Triggers" for more information.

Subtab

Description

General

Enables you to specify how R-IM-ASF sets up and sends credit reservation requests to the OE.

See "General" for more information.

Reauthorization Triggers

Enables you to specify whether R-IM-ASF reauthorizes a quota upon receiving various triggers from a CSCF.

See "Reauthorization Triggers" for more information.

General

The General subtab enables you to specify how R-IM-ASF sets up and sends credit reservation requests to the OE. The OE forwards these requests to an IM-OCF, which translates credit reservation requests to Diameter CCRs, which are then forwarded to a billing application.

Table 23-6 describes the configuration parameters that you need to specify for credit reservation requests.

Table 23-6 General Parameters

Name	Type	Description
Service Monitoring	STRING	Specifies the component that monitors session duration. Possible values: Internal R-IM-ASF monitors session duration on its own. R-IM-ASF cannot delegate service monitoring to a CSCF. None Session duration is not monitored. Default value: None
First Credit Reservation Request	STRING	Specifies when IM-OCF sends the first CCR to a billing application. This request is generated by R-IM-ASF and sent to IM-OCF through the OE. Possible values: Initial IM-OCF sends a request after a CSCF sends the first session setup message. Ringing IM-OCF sends a request after a CSCF sends a ringing indication. Answer IM-OCF sends a request after a CSCF sends an answer indication. Never Default value: Initial
Start Charging Phase	STRING	Specifies when R-IM-ASF starts charging a session. Possible values: Initial R-IM-ASF starts charging after a CSCF sends the first session setup message. Ringing R-IM-ASF starts charging after a CSCF sends a ringing indication. Answer R-IM-ASF starts charging after a CSCF sends an answer indication. Default value: Answer
Requested Duration	INT	Specifies the value to which IM-OCF needs to set the CC-time AVP in a CCR sent to a billing application.
Requested Volume	INT	Specifies the value to which IM-OCF needs to set the CC-Total-Octets AVP in a CCR sent to a billing application.
Requested Service Units	INT	Specifies the value to which IM-OCF needs to set the CC-Service-Specific-Units AVP in a CCR sent to a billing application.
Service Identifier	INT	Specifies the value to which IM-OCF needs to set the Service-Identifier AVP in a CCR sent to a billing application.
Tccd Timeout	INT	Specifies the maximum time, in seconds, that R-IM-ASF waits for a credit reservation response after sending a credit reservation request. If the timeout expires, R-IM-ASF releases the call. To disable the timeout timer, enter a negative value.

Reauthorization Triggers

The Reauthorization Triggers subtab enables you to specify whether R-IM-ASF reauthorizes a quota upon receiving various triggers from a CSCF.

Table 23-7 describes configuration parameters on the Reauthorization Triggers subtab.

Table 23-7 Reauthorization Triggers Parameters

Name	Type	Description
Info Received	STRING	Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Info Received trigger. Possible values: Yes R-IM-ASF always reauthorizes the quota. Dynamic R-IM-ASF reauthorizes the quota only if a change in the rating conditions was detected (for example, when a location is changed). No R-IM-ASF never reauthorizes the quota. Default value: Dynamic
Session Alerted	STRING	Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Alerted trigger. Possible values: Yes R-IM-ASF always reauthorizes the quota. Dynamic R-IM-ASF reauthorizes the quota only if a change in the rating conditions was detected (for example, when a location is changed). No R-IM-ASF never reauthorizes the quota. Default value: Dynamic
Session Connected	STRING	Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Connected trigger. Possible values: Yes R-IM-ASF always reauthorizes the quota. Dynamic R-IM-ASF reauthorizes the quota only if a change in the rating conditions was detected (for example, when a location is changed). No R-IM-ASF never reauthorizes the quota. Default value: Dynamic
Session ReInvite Complete	STRING	Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session ReInvite Complete trigger. Possible values: Yes R-IM-ASF always reauthorizes the quota. Dynamic R-IM-ASF reauthorizes the quota only if a change in the rating conditions was detected (for example, when a location is changed). No R-IM-ASF never reauthorizes the quota. Default value: Dynamic
Session Reinvited	STRING	Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Reinvited trigger. Yes R-IM-ASF always reauthorizes the quota. Dynamic R-IM-ASF reauthorizes the quota only if a change in the rating conditions was detected (for example, when a location is changed). No R-IM-ASF never reauthorizes the quota. Default value: Dynamic
Session Update Complete	STRING	Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Update Complete trigger. Yes R-IM-ASF always reauthorizes the quota. Dynamic R-IM-ASF reauthorizes the quota only if a change in the rating conditions was detected (for example, when a location is changed). No R-IM-ASF never reauthorizes the quota. Default value: Dynamic
Session Updated	STRING	Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Updated trigger. Yes R-IM-ASF always reauthorizes the quota. Dynamic R-IM-ASF reauthorizes the quota only if a change in the rating conditions was detected (for example, when a location is changed). No R-IM-ASF never reauthorizes the quota. Default value: Dynamic

Configuring Monitoring Parameters

The Monitoring tab enables you to define how Runtime MBeans and notifications operate for an R-IM-ASF. For more information about configuring monitoring, see "Configuring Monitoring with the Administration Console".

Configuring R-IM-ASF SIP with Java MBeans

Service Broker provides a set of MBeans that provide attributes and operations for configuring the R-IM-ASF SIP through JMX. Figure 23-1 shows the hierarchy of the R-IM-ASF SIP MBeans.

Figure 23-1 R-IM-ASF SIP MBeans Hierarchy

The following sections provide reference information for the R-IM-ASF SIP configuration MBeans.

Note:

MBeans described in this guide may include additional advanced attributes, which are not described in the guide. Advanced attributes are reserved for internal use. Do not change these attributes.

The following MBeans are common for all components of Service Broker and described in "Configuring Monitoring with Java MBeans":

MonitoringGeneralMBean
ThresholdCrossedNotificationRulesMBean
ThresholdCrossedNotificationRuleMBean
StateChangedNotificationRulesMBean
StateChangedNotificationRuleMBean

RimasfSipMBean

RimasfSipMBean is a root MBean for the R-IM-ASF configuration.

Factory Method

Created automatically

Attributes

None

Operations

ObjectName getSip()

Gets a reference to the instance of SipMBean

ObjectName getSessionKeepAlive()

Gets a reference to the instance of SessionKeepAliveMBean

ObjectName getMonitoringGeneral()

Gets a reference to the instance of MonitoringGeneralMBean

ObjectName getThresholdCrossedNotificationRules()

Gets a reference to the instance of ThresholdCrossedNotificationRulesMBean

ObjectName getStateChangedNotificationRules()

Gets a reference to the instance of StateChangedNotificationRulesMBean

ObjectName getAdvanced()

Gets a reference to the instance of AdvancedMBean

NetworkEntityMBean

Using NetworkEntityMBean, you specify the address of the network entity with which the RIM-ASF SIP communicates. The address must be in the SIP URL format.

The alias that you provide must be defined using SipNetworkEntitiesMBean and SipNetworkEntityMBean. See the "Configuring SIP SSU with Java MBeans" section in the "Configuring SIP Signaling Server Units" chapter in the Oracle Communications Service Broker Signaling Domain Configuration Guide.

Factory Method

Created automatically.

Attributes

AsAddress

For more information about this attribute, see Table 23-2.

Operations

None

SipMBean

SipMBean enables you to configure standard SIP protocol parameters.

Factory Method

Created automatically

Attributes

MaxCallDurationTimeoutIntervalInMinutes
RetransmissionIntervalLimit
t7TimeoutIntervalInSeconds
t9Timeout Interval in Seconds

For more information on these attributes, see Table 23-4.

Operations

None

SessionKeepAliveMBean

SessionKeepAliveMBean enables you to configure the keep-alive mechanism that R-IM-ASF SIP uses to test session existence with the SIP network element.

Factory Method

Created automatically

Attributes

InfoKeepAliveInterval
InfoKeepAliveTimeToDie

For more information on these attributes, see Table 23-3.

Operations

None

ChargingServiceMBean

ChargingServiceMBean enables you to define how IM-SCF sends credit reservation requests and to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.

Factory Method

Created automatically

Attributes

ServiceMonitoring
FirstCreditReservationRequest
StartChargingPhase
RequestedDuration
RequestedVolume
RequestedServiceUnits
ServiceIdentifier
TccdTimeout

For more information on these attributes, see Table 23-6.

Operations

None

ReAuthorizationTriggerTableMBean

ReAuthorizationTriggerTableMBean is a container for instances of ReAuthorizationTriggerTableEntryMBean. Each instance of ReAuthorizationTriggerTableEntryMBean represents a single reauthorization trigger that an MSC sends to IM-SCF.

Factory Method

Created automatically.

Attributes

None

Operations

ObjectName[] getReAuthorizationTriggerTableEntry()

Returns an array of references to instances of ReAuthorizationTriggerTableEntryMBean

ObjectName createReAuthorizationTriggerTableEntry()

Creates a new instance of ReAuthorizationTriggerTableEntryMBean

void destroyReAuthorizationTriggerTableEntry()

Destroys an existing instance of ReAuthorizationTriggerTableEntryMBean

ObjectName lookupReAuthorizationTriggerTableEntry()

Gets a reference to the instance of ReAuthorizationTriggerTableEntryMBean

ReAuthorizationTriggerTableEntryMBean

ReAuthorizationTriggerTableMBean enables you to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.

Factory Method

ReAuthorizationTriggerTable.createReAuthorizationTriggerTableEntry()

Attributes

Info Received
Session Alerted
Session Connected
SessionReInviteComplete
SessionUpdateComplete
Session Reinvited
Session Update Complete
Session Updated

For more information about these attributes, see Table 23-7.

Operations

None