Skip Headers
Oracle® Communications Service Broker Social Voice Communicator Implementation Guide
Release 6.1

Part Number E29461-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

3 Configuring Charging for Social Voice Communicator Services

This chapter explains how to integrate Oracle Communications Service Broker Social Voice Communicator (SVC) with external charging applications.

About Charging

SVC supports offline and online Diameter-based charging applications. Specifically, it acts as a Diameter client or Charging Trigger Function (CTF) that reports session and event information related to SVC activities to external Diameter servers.

SVC supports Diameter offline (Rf) charging for all of its services and online (Ro) charging for incoming calls to SVC subscribers. Charging can be event-based, session-based, or both.

Diameter messages are mainly composed of attribute-value pairs (AVPs) containing charging data. SVC supports AVPs from both the RFC 3855 and 3GPP TS 32.299 standards (standards-based AVPs) and additional AVPs supplied for SVC (non-standards based AVPs).

Configuring charging to work with SVC includes these general steps:

Configuring Online Charging for SVC Services

SVC supports Diameter Ro (online) charging of incoming calls only. This section assumes that you have:

SVC supports the Diameter Ro AVPs listed in the following sections:

To set up Diameter Ro charging for your SVC service:

  1. Open the Administration Console.

  2. In the navigation pane navigate to OCSB, Signaling Tier, then SSU Diameter.

  3. Configure SSU Diameter. Specifically, define Service Broker as the Diameter node, and define at least one Diameter peer. You must specify the IP address, host name, listening port number, and supported protocol for each node and peer. Ensure that the Application ID entry is set to 4 for Ro charging.

    For more information, see the discussion on configuring Diameter Signalling Server Units in Oracle Communications Service Broker Signaling Server Units Configuration Guide.

  4. Expand OCSB, Processing Tier and Interworking Modules.

  5. Create and configure an IM_OCF Interworking Module.

    For more information on the configuration settings, see the discussion on configuring IM-OCF in Oracle Communications Service Broker Modules Configuration Guide.

  6. Configure the Service Broker Orchestration Engine.

    1. In the navigation pane, navigate to OCSB then Processing Tier.

    2. Click Orchestration Engine.

    3. Configure the Orchestration Engine to route traffic between your Service Broker and Oracle Communications Billing and Revenue Management (BRM). You do this by creating an Initial Filter Criteria (IFC) XML file that specifies the routing criteria.

      For more information on Orchestration Engine configuration, see the discussion on configuring the Orchestration Engine and the discussion on initial filter criteria in Oracle Communications Service Broker Modules Configuration Guide.

Be sure your Diameter charging server and media servers are running before you start generating traffic.

Configuring Offline Charging for SVC Services

The Service Broker SVC feature uses connections in the Signalling Tier to exchange messages with external Diameter servers. Therefore, to enable offline charging, you must configure the Diameter server connection settings in the Signaling Tier. You also configure the network-facing IMs and orchestration rules in the Processing Tier that integrate the VPN application with the external Diameter server.

The Diameter AVPs that are generated by the SVC application are defined by MBean attributes. The supported AVPs are listed in:

This section assumes that you have:

To set up Diameter Rf charging for SVC services:

  1. Configure SSU Diameter.

    Specifically, define Service Broker as the Diameter node, and define at least one Diameter peer. You need to specify the IP address, host name, listening port number, and supported protocol for each node and peer.

    For more information on the SSU Diameter configuration settings, see the discussion on configuring Diameter Signaling Server units in Oracle Communications Service Broker Signaling Domain Configuration Guide.

    Ensure that the SSU Diameter, Diameter Nodes, Routes, Application ID field is set to3 for Rf charging.

  2. Start and connect to the Administration Console process with a JMX MBean client.

  3. Configure event-based charging by navigating to the following MBean:

    oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.apps.svc.diametersvc,version=6.1.0,name0=diameterConfig,name1=enableChargingEventRf

  4. Set the enableChargingEvent Rf attribute to true. The default setting is false.

  5. Configure session-based charging by navigating to this MBean:

    oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.apps.svc.diametersvc,version=6.1.0,name0=diameterConfig,name1=enableChargingSessionRf

  6. Set the eventChargingSessionRf attribute to true. The default setting is false.

  7. In the Service Broker Signaling Domain, configure connectivity to the external Diameter charging server to which you want to send accounting reports.

    For instructions on how to perform this configuration, see the information about configuring Diameter Signaling Server Units in Oracle Communications Service Broker Signaling Server Units Configuration Guide.

The Service Broker SVC services now generates accounting request messages based on the service activities, which are transmitted to the charging server specified in the Service Broker Signalling Tier configuration.

SVC Diameter AVP Reference

The following sections list the AVPs generated by the SVC services.

SVC Diameter Ro AVPs from Diameter Base and Credit-Control Protocols

The AVPs defined by the Diameter base protocol (RFC3588) and Diameter Credit-Control (RFC 4006) that SVC supports are listed below.

The definitions of the attributes as generated by SVC conform to their definitions as stipulated by the public specification.

For complete information on the definition or purpose of a specific AVP, see the RFC 3588 Diameter Base Protocol.

  • Session-Id

  • Origin-Host

  • Origin-Realm

  • Destination-Host

  • Destination-Realm

  • Auth-Application-Id

  • Service-Context-Id

  • CC-Request-Type

  • CC-Request-Number

  • User-Name

Standards-based SVC Diameter Ro AVPs

The AVPs defined by 3GPP TS 32.299 Diameter Base Protocol that SVC supports are listed below.

The definitions of the attributes as generated by SVC conform to their definitions as stipulated by public specification.

For complete information on the definition or purpose of a specific AVP, see the 3GPP TS 32.299 specification.

  • Origin-State-Id

  • Event-Timestamp

  • Service-Information

  • Service-Information.Subscription-Id

  • Service-Information.Subscriber-Id.Subscription-Id-Type

  • Service-Information.Subscriber-Id.Subscription-Id-Data

  • Service-Information.Subscription-Id

  • Termination-Cause

  • Requested-Action

  • Multiple-Services-Indicator

  • Multiple-Services-Credit-Control

  • Used-Service-Unit

  • Reporting-Reason

  • CC-Time

  • Service-Identifier

Non-Standards Based Diameter Ro AVPs

Table 3-1 lists the non-standards based Diameter Ro AVPs that Service Broker uses for passing SVC service information. See "Configuring Online Charging for SVC Services" for instructions on how to implement these AVPs.

Table 3-1 SVC Diameter Ro Optional AVPs

AVP Name AVP Code Type Description

Service-Information.IMS-Information

876

Grouped

Transmits additional 3GPP service-specific information elements not covered by existing AVPs.

IMS-Information.Role-of-node

829

Enumerated

Specifies the role of the Application Server. Can be one of the following values:

0: ORIGINATING_ROLE The Application Server serves the calling party.

1: TERMINATING_ROLE The Application Server serves the callee.

IMS-Information.Event-Type

823

Grouped

Includes information about the type of chargeable telecommunication service or event for which the accounting-request and/or credit control request messages are generated.

Event-TypeSIP-Method

824

UTF8String

The SIP method name (for example, INVITE or UPDATE) that generated the accounting request. If the request is a one number Service request, one of the following values is also returned:

1: Join - interim REINVITE message

2: Leaving - Interim BYE message

IMS-Information.Node-Functionality

862

Enumerated

The node functionality identifier.

IMS-InformationUser-Session-ID

830

UTF8String

Contains the session identifier (the caller ID of the initial request).

IMS-Information.Time-Stamps

833

Grouped

Contains the times of the initial SIP request and the response.

Time-Stamps. SIP-Request-Timestamp

834

Timestamp

The SIP request timestamp in UTC format.

Time-Stamps. SIP-Response-Timestamp

835

Timestamp

The SIP request response timestamp in UTC format.

IMS-Information Service-ID

855

UTF8String

Identifies the service that the MRFC is hosting. For conferences, the conference ID is used.

IMS-Charging-Identifier

841

UTF8String

The IMS charging identifier (ICID) generated by the IMS node for the SIP session.

IMS-Information Calling-Party-Address

831

UTF8String

The address (SIP URI or TEL URI) of the calling party (Public User Identifier or Public Service Identity).

IMS-Information Called-Party-Address

832

UTF8String

The address of the callee. This is either the SIP URI or TEL URI from the initial request.

IMS-InformationRequested-Party-Address

1251

UTF8String

Contains the address (SIP URI or TEL URI) of the original target of the SIP request (Public User Identifier or Public Service Identity). Only present if different from the Called-Party-Address parameter (832).

IMS-InformationService-Specific-Info

1249

Grouped

Contains the service-specific data if provided by the Application Server or a PCEF (for pre-defined PCC rules).

Service-Specific-InfoService-Specific-Data

863

UTF8String

Can be one of the following values:

PLACE_CALL

TAKING_CALL

CLIDK_TO_DIAL

VOICEMAIL

GROUP_SERVICE

ONE-THE-FLY_CONFERENCING

Service-Specific-InfoService-Specific-Type

1257

Unsigned32

Contains the type of service-specific data:

0: SVC

IMS-InformationSDP-Media-Component

843

Grouped

Contains the media (SDP) used for a session. This is taken from the START message of the initial ACR. If the media changes, it is taken from an interim ACR.

SDP-MediaComponentSDP-Media-Name

844

UTF8String

Contains the value for m= line in the SDP data of the 200 OK message.

SDP-Media-ComponentSDP-Media-Description

845

UTF8String

Contains the value for the attribute-line for a media component. Specifies the media described in the SDP-Media-Name AVP.

IMS-InformationCause-Code

861

Integer32

Contains the code (from 3PP TS 32.299) for the Accounting-request [stop] and/or Account-request [event]. Values less than 0 are used for success codes; values greater than 1 are used for failure codes.


SVC Diameter Rf AVPs

The AVPs defined by RFC 3588 Diameter Base Protocol that SVC uses are listed below.

The definitions of the attributes as generated by SVC conform to their definitions as stipulated by the public specification.

For complete information on the definition or purpose of a specific AVP, see the RFC 3588 Diameter Base Protocol.

  • Session-Id

  • Origin-Host

  • Origin-Realm

  • Destination-Host

  • Destination-Realm

  • Accounting-Record-Type

  • Accounting-Record-Number

  • Acct-Application-Id

  • Acct-Interim-Interval

  • User-Name

  • Event-Timestamp

SVC Diameter Rf AVPs

The AVPs defined by 3GPP TS 32.299 Diameter Base Protocol that SVC uses are listed below.

The definitions of the attributes as generated by SVC conform to their definitions as stipulated by public specification.

For complete information on the definition or purpose of a specific AVP, see the 3GPP TS 32.299 specification.

  • Service-Context-Id

  • Service-Information

  • Service-Information.Subscription-Id

  • Service-Information.Subscriber-Id.Subscription-Id-Type

  • Service-Information.Subscriber-Id.Subscription-Id-Data

  • Service-Information.IMS-Information

  • IMS-Information.Role-of-node

  • IMS-Information.Event-Type

  • Event-Type.SIP-Method

  • IMS-Information.Node-Functionality

  • IMS-Information.User-Session-ID

  • IMS-Information.Time-Stamps

  • Time-Stamps.SIP-Request-Timestamp

  • Time-Stamps.SIP-Response-Timestamp

  • IMS-Information.Service-ID

  • IMS-Charging-Identifier

  • IMS-Information.Calling-Party-Address

  • IMS-Information.Called-Party-Address

  • IMS-Information.Requested-Party-Address

  • IMS-Information.Service-Specific-Info

  • Service-Specific-Info.Service-Specific-Data

  • Service-Specific-Info.Service-Specific-Type

  • IMS-Information.SDP-Media-Component

  • SDP-Media-Component.SDP-Media-Name

  • SDP-Media-Component.SDP-Media-Description

  • IMS-Information.Cause-Code