Oracle® Communications Service Broker Modules Configuration Guide Release 6.1 Part Number E29454-01 |
|
|
PDF · Mobi · ePub |
This chapter describes how to set up an IM-OFCF PCP interworking module.
The process of IM-OFCF PCP setup requires the following:
Adding an IM-OFCF PCP to your Oracle Communications Service Broker deployment. You can add as many modules of type IM-OFCF PCP as you need. See "Adding an IM-OFCF PCP to the Service Broker Deployment" for more information.
Configuring the IM-OFCF PCP. See "Configuring an IM-OFCF PCP" for more information.
To add an IM-OFCF PCP:
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 IMOFCFPCP.
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 PCP to your deployment, in the Change Center pane, click Commit.
A new module of type IM-OFCF PCP 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 PCP:
In the Change Center, click Lock & Edit.
In the domain navigation pane, under the Interworking Modules node, select the newly added IM-OFCF PCP.
The IM-OFCF PCP configuration consists of two main tabs:
Configuration tab
Rf PCP Mediation tab - Enables you to define how IM-OFCF PCP translates Rf messages to PCP messages and communicates with BRM applications. See "Configuring Rf PCP Mediation", for more information.
The IM-OFCF PCP Configuration tab contains the subtabs described in Table 24-1.
Table 24-1 IM-OFCF PCP Configuration Tabs
Subtab | Description |
---|---|
Call Handling |
Enables you to define how IM-OFCF PCP 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 PCP handles calls.
Table 24-2 describes configuration parameters on the Call Handling tab.
Table 24-2 IM-OFCF PCP 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 PCP 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 PCP. 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 PCP switches to degraded mode. This mode enables IM-OFCF PCP to continue a session and charge a mobile subscriber during the time when the charging server is temporarily unavailable.
When IM-OFCF PCP sends an accounting request to the charging server, IM-OFCF PCP waits a specified period of time for a response from the server. If the server does not respond, IM-OFCF PCP switches to the degraded mode.
After IM-OFCF PCP switches to the degraded mode, IM-OFCF PCP handles the session in this mode until the session is terminated even if the online charging server becomes available. When the charging server becomes available again, IM-OFCF PCP sends the server charging information gathered during the session.
In the degraded mode, IM-OFCF PCP communicates with the Service Broker local charging server. The local online charging server assumes 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 PCP.
IM-OFCF PCP writes charging data records (CDRs) which it replays to the online charging server after this server becomes available again. The online charging server 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 24-3.
Table 24-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 PCP 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 PCP 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 PCP 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 PCP 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 PCP translates Rf messages to PCP messages and communicates with BRM applications using the Rf PCP mediator.
You set up the mediator by configuring parameters on the subtabs described in Table 24-4.
Table 24-4 Rf PCP Mediation Subtabs
Subtab | Description |
---|---|
General |
Enables you to define how IM-OFCF PCP communicates with BRM applications. See "Configuring General Parameters" for more information. |
Service Types |
Enables you to set up mapping between Diameter Ro Service-Identifier AVP and BRM service types. See "Configuring Service Types Parameters" for more information. |
Opcode 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 PCP communicates with BRM applications. Table 24-5 describes the parameters that you can configure.
Table 24-5 Rf to PCP Mediation General Parameters
Name | Type | Description |
---|---|---|
brm-client-program-name |
STRING |
The name representing IM-OFCF PCP as a BRM client application when accessing BRM. Default value: Matrix |
brm-object-type |
STRING |
Always set this value to gsm. |
incremental-mode |
INT |
Specifies how IM-OFCF PCP calculates the used quantity for the session. Possible values:
|
acr-timeout |
INT |
Specifies the period of time, in milliseconds, that IM-OFCF PCP waits for a response from the BRM application. If IM-OFCF PCP does not receive a response within the specified period of time, IM-OFCF PCP handles the request in the degraded mode. |
Using the Service Types tab, you set up mapping between Diameter Rf Service-Identifier AVP and BRM service types. Table 24-6 describes the parameters that you can configure.
Table 24-6 Rf to PCP Mediation Service Types Parameters
Name | Type | Description |
---|---|---|
BRM Service ID |
INT |
The Diameter Rf service identifier to be mapped to BRM service type. |
BRM Service Type |
STRING |
The BRM service type to use for the corresponding Diameter Rf service id. For example, |
Is 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 PCP 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.pcp2rf.mapping.AccountRequestProcessor
Click the Apply button.