Oracle® Communications Service Broker Modules Configuration Guide Release 6.1 E29454-01 |
|
|
PDF · Mobi · ePub |
This chapter describes how to set up an IM-OFCF ECE interworking module for use with the Oracle Communications Elastic Charging Engine (ECE).
The process of IM-OFCF ECE setup requires the following:
Adding an IM-OFCF ECE to your Oracle Communications Service Broker deployment. You can add as many modules of type IM-OFCF ECE as you need. See "Adding an IM-OFCF ECE to the Service Broker Deployment" for more information.
Configuring the IM-OFCF ECE. See "Configuring an IM-OFCF ECE" for more information.
To add an IM-OFCF ECE:
In the domain navigation pane, expand the OCSB node.
Expand the Processing Tier node.
Expand the Interworking Modules node.
Select IM Management.
On the bottom of the IM Management pane, click New.
In the New window, fill out the fields as follows:
In the Type list, select IMOFCFECE.
In the Version list, select the required version.
In the Name field, enter a name for this module as it should appear in the list of modules. In this field, you can only use lower case letters (a-z), upper case letters (A-Z), numbers (0-9), and underscores (_). If you attempt to use a character which is not allowed, Service Broker displays the error message and prompts you to enter a different name.
Click OK.
In the notification window that reminds you to commit the changes, click OK.
To add the new IM-OFCF ECE to your deployment, in the Change Center pane, click Commit.
A new module of type is now added to your Service Broker deployment. The new module is displayed in the domain navigation pane under the Interworking Modules node.
To configure an IM-OFCF ECE:
In the Change Center, click Lock & Edit.
In the domain navigation pane, under the Interworking Modules node, select the newly added IM-OFCF ECE.
The IM-OFCF ECE configuration consists of two main tabs:
Configuration tab
Rf ECE Mediation tab - Enables you to define how IM-OFCF ECE translates Rf messages to PCP messages and communicates with BRM applications. See "Configuring Rf ECE Mediation", for more information.
The IM-OFCF ECE configuration screen contains the tabs described in Table 26-1.
Table 26-1 IM-OFCF ECE Configuration Tabs
Subtab | Description |
---|---|
Call Handling |
Enables you to define how IM-OFCF ECE handles calls. See "Configuring Call Handling Parameters" for more information. |
Monitoring |
Enables you to define how Runtime MBeans and notifications should operate. See "Configuring Monitoring Parameters" for more information. |
Degraded Mode |
Enables you to set up how a session is charged when an online charging server is not available. See "Configuring the Degraded Mode" for more information. |
The Call Handling subtab enables you to define how IM-OFCF ECE handles calls.
Table 26-2 describes configuration parameters on the Call Handling tab.
Table 26-2 IM-OFCF ECE Call Handling Parameters
Name | Type | Description |
---|---|---|
Destination Alias |
STRING |
Specifies an alias of the offline charging server realm that you defined in the SSU PCP configuration. If you leave this field blank, the IM-OFCF ECE works in the degraded mode. |
Service Context |
STRING |
Specifies the Service-Context-Id AVP if this AVP is not set in the session that IM-OFCF PCP receives from the network. |
Failure Code For Processing Error |
STRING |
Specifies the SAL error that IM-OFCF PCP generates if IM-OFCF PCP failed to create an ACR. |
The Monitoring tab enables you to define how Runtime MBeans and notifications operate for an IM-OFCF ECE. For more information about configuring monitoring, see "Configuring Service Broker Monitoring" in "Monitoring Service Broker Using Runtime MBeans" in Oracle Communications Service Broker System Administrator's Guide.
In Online Mediation Solution Controller, Service Broker relies upon an external online charging server (OCS) to apply charges for the use of network services.
When an online charging server is unavailable, IM-OFCF ECE switches to the special mode known as degraded mode. This mode enables IM-OFCF ECE to continue a session and charge a mobile subscriber during the time when the charging server is temporarily unavailable.
To check the availability of the charging server, every time when IM-OFCF ECE sends an accounting request to the charging server, IM-OFCF ECE waits a specified period of time for a response from the server. If the server does not respond, IM-OFCF ECE switches to the degraded mode.
After IM-OFCF ECE switches to the degraded mode, IM-OFCF ECE handles the session until the session is terminated even if the online charging server becomes available. When the charging server becomes available again, IM-OFCF ECE sends the server charging information gathered during the session.
In the degraded mode, IM-OFCF ECE communicates with the Service Broker local charging server. The local online charging server performs the work of an external charging server. This means that the local charging server can receive Credit Control Requests (CCRs) from, and send Credit Control Answers (CCAs) to, IM-OFCF ECE.
M-OFCF ECE writes charging data records (CDRs) which it replays to the online charging server after this server becomes available again. The OCS applies charges to the mobile subscriber.
For more information, see the discussion on administrating the degraded mode in Oracle Communications Service Broker Online Mediation Controller Implementation Guide.
You use the Degraded Mode tab to configure the parameters of this mode as described in Table 26-3.
Table 26-3 Degraded Mode Parameters
Name | Type | Description |
---|---|---|
On OCF Failure |
STRING |
Specifies the behavior of IM-OFCF Ro when the OCF fails. Possible values:
Default value: USE_LOCAL_REFUSE |
CDR Mode |
STRING |
Specifies how IM-OFCF ECE writes CDRs. Possible options:
Default value: NORMAL |
CDR Writer Impl |
STRING |
Specifies the full path of the bundle that implements the CDR writer functionality. This is a preset parameter. Do NOT change the value of this parameter. |
CDR Writer Service |
STRING |
Specifies the full path of the CDR writer service. This is a preset parameter. Do NOT change the value of this parameter. |
Degraded Mode Timer |
INT |
Specifies the period of time, in milliseconds, that IM-OFCF ECE waits for a response from the online charging server. If the online charging server does not respond within the specified period of time, IM-OFCF ECE switches to the degraded mode. |
Local-OCF Alias |
STRING |
Specifies the alias of the local online charging server. This alias is mapped to the destination host and destination realm of the local online charging server as defined in the configuration of Diameter SSU outbound routing rules. For more information, see the discussion on configuring outbound destinations in Diameter SSUs in Oracle Communications Service Broker Signaling Server Units Configuration Guide. |
Local-OCF External Protocol |
STRING |
Specifies the protocol that IM-OFCF ECE uses to communicate with the local online charging server. |
Degraded Mode Error Codes |
STRING |
Specifies the error codes that trigger IM-OFCF Ro to enable the degraded mode. You can type several error codes separated by comma. |
IM-OFCF ECE translates Rf messages to ECE messages and communicates with ECE using the Rf ECE mediator.
You set up the mediator by configuring parameters on the subtabs located under the Rf ECE Mediation tab and described in Table 26-4.
Table 26-4 Rf ECE Mediation Subtabs
Subtab | Description |
---|---|
General |
Enables you to define how IM-OFCF ECE communicates with ECE. See "Configuring General Parameters" for more information. |
Service Types |
Enables you to set up mapping between Diameter Ro Service-Identifier AVP and ECE service types. See "Configuring Service Types Parameters" for more information. |
Processor mapping |
Enables you to map new Diameter Rf requests to PCP processors. See "Configuring Processor Mapping" for more information. |
Using the General subtab, you define how IM-OFCF ECE communicates with ECE. Table 26-5 describes the parameters that you can configure.
Table 26-5 Rf to ECE Mediation General Parameters
Name | Type | Description |
---|---|---|
incremental-mode |
BOOL |
Specifies how IM-OFCF ECE calculates the used quantity for the session. Possible values:
|
acr-timeout |
INT |
Specifies the period of time, in milliseconds, that IM-OFCF ECE waits for a response from the ECE. If IM-OFCF ECE does not receive a response within the specified period of time, IM-OFCF ECE handles the request in the degraded mode. |
Using the Service Types tab, you set up mapping between Diameter Rf Service-Identifier AVP and ECE service types. Table 26-6 describes the parameters that you can configure.
Table 26-6 Rf to ECE Mediation Service Types Parameters
Name | Type | Description |
---|---|---|
Service-Identifier AVP |
INT |
The Diameter Rf service identifier to be mapped to ECE service type |
ECE Product Type |
STRING |
The ECE product type to use for the corresponding Diameter Rf service id. For example, Data. |
ECE Event Type |
STRING |
The ECE event type to use for the corresponding Diameter Rf service id. For example, 3G. |
ECE Request Specification Version |
STRING |
The ECE request specification version. |
Default Service Type |
BOOL |
Set to:
|
Commonly used Accounting Record Types are mapped by default. Using the Processor Mapping tab, you can map new Diameter Rf requests to ECE processors.
To map new Diameter Rf requests to PCP processors:
In the Processor Mapping tab, in the navigation tree, click the New button.
In the Processor Mapping window enter the following values:
Accounting Record Type
Processor Class Name
All of the processors should implement the following interface:
oracle.ocsb.app.rcc.mediation.ece2rf.mapping.AccountRequestProcessor
Click the Apply button.