Oracle® Communications Service Broker Processing Domain Configuration Guide Release 6.0 Part Number E23525-02 |
|
|
View PDF |
The following sections describe how to configure R-IM-ASF SIP using the Service Broker Administration Console and Java MBeans.
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. |
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. |
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. |
You use the SIP Parameters tab to configure standard SIP protocol parameters.
Table 23-4 describes configuration parameters on the SIP subtab.
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 |
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. |
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.
Name | Type | Description |
---|---|---|
Service Monitoring |
STRING |
Specifies the component that monitors session duration. Possible values:
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:
Default value: Initial |
Start Charging Phase |
STRING |
Specifies when R-IM-ASF starts charging a session. Possible values:
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. |
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:
Default value: Dynamic |
Session Alerted |
STRING |
Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Alerted trigger. Possible values:
Default value: Dynamic |
Session Connected |
STRING |
Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Connected trigger. Possible values:
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:
Default value: Dynamic |
Session Reinvited |
STRING |
Specifies whether or not IM-SCF reauthorizes the quota on receiving the Session Reinvited trigger.
Default value: Dynamic |
Session Update Complete |
STRING |
Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Update Complete trigger.
Default value: Dynamic |
Session Updated |
STRING |
Specifies whether or not R-IM-ASF reauthorizes the quota on receiving the Session Updated trigger.
Default value: Dynamic |
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".
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.
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 is a root MBean for the R-IM-ASF configuration.
Created automatically
None
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
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.
Created automatically.
AsAddress
For more information about this attribute, see Table 23-2.
None
SipMBean enables you to configure standard SIP protocol parameters.
Created automatically
MaxCallDurationTimeoutIntervalInMinutes
RetransmissionIntervalLimit
t7TimeoutIntervalInSeconds
t9Timeout Interval in Seconds
For more information on these attributes, see Table 23-4.
None
SessionKeepAliveMBean enables you to configure the keep-alive mechanism that R-IM-ASF SIP uses to test session existence with the SIP network element.
Created automatically
InfoKeepAliveInterval
InfoKeepAliveTimeToDie
For more information on these attributes, see Table 23-3.
None
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.
Created automatically
ServiceMonitoring
FirstCreditReservationRequest
StartChargingPhase
RequestedDuration
RequestedVolume
RequestedServiceUnits
ServiceIdentifier
TccdTimeout
For more information on these attributes, see Table 23-6.
None
ReAuthorizationTriggerTableMBean is a container for instances of ReAuthorizationTriggerTableEntryMBean. Each instance of ReAuthorizationTriggerTableEntryMBean represents a single reauthorization trigger that an MSC sends to IM-SCF.
Created automatically.
None
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
ReAuthorizationTriggerTableMBean enables you to specify whether IM-SCF reauthorizes a quota upon receiving various triggers from an MSC.
ReAuthorizationTriggerTable.createReAuthorizationTriggerTableEntry()
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.
None