You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

In this section:

The Call Accounting Manager (CAM) generates Call Detail Records (CDRs) and supports accounting events logging to the

Unable to show "metadata-from": No such page "_space_variables"
. The
Unable to show "metadata-from": No such page "_space_variables"
provides the ability to map CDR fields and other input parameters to RADIUS attributes (standard as well as vendor-specific attributes) and send to the appropriate RADIUS server.

Viewing Billing Records 

As calls traverse the SBC, Call Detail Records (CDRs) are generated and stored in /var/log/sonus/evlog/evlog directory. You can view these CDR by looking at files with the “.ACT” extension. It is useful to view these ACT logs during call debugging (to get the originating trunk group, calling and called numbers, codec used, etc.).

You may also view billing records (and other logs) from the EMA Platform Mode. See Administration - Accounting and Logs for more information.

When downloading billing records (or other logs), you must use port 2024 to SFTP files off of the SBC.

Call Detail Record Format

This section describes the ASCII and streaming Call Detail Record (CDR) format.

The
Unable to show "metadata-from": No such page "_space_variables"
supports only ASCII format.

Various

Unable to show "metadata-from": No such page "_space_variables"
 elements such as GSX 9000, PSX and
Unable to show "metadata-from": No such page "_space_variables"
 use many of the same CDR fields. Because of this, some fields in the “Accounting Records” table below do not apply to
Unable to show "metadata-from": No such page "_space_variables"
 call details, but instead simply indicate pass-though type messages (for example, ISUP and PSTN fields).

The “Service Group” object is not applicable to
Unable to show "metadata-from": No such page "_space_variables"
. Any references to “Service Group” must be mapped to “Trunk Group”.

For more information on known limitations, see the applicable release notes at SBC Release Information page.

See CDR Examples page for example CDRs.

See CDR to VSA Mapping  page for a mapping of CDR fields to Vendor Specific Attribute (VSA) fields for RADIUS servers.

See Vendor Specific Attributes Reference for a complete listing of

Unable to show "metadata-from": No such page "_space_variables"
-specific VSA fields.

Accounting File Version

The CAM version of

Unable to show "metadata-from": No such page "_space_variables"
 SW release V05.00.00 is 83.00.00 (major CAM version is 83, minor CAM version is 0, special CAM version is 0). The associated hex format of the CAM file version is "00530000" as shown in below header example.

Sonus Networks, Inc.00000000FF600000530000000000000060V05.00.00 00000000000000000000000000000000000ACT2014112715113200000000000000.

File Header

Every event log file, including accounting logs, contains a file header. This header consists of a 128-character string terminated by a carriage return. Each field in the event log file header is defined in the following table:

File Header Details

Field Offset

Field Length

Field Content

0

20

ASCII OEM string, blank padded, (for example "Sonus Networks, Inc.")

20

8

Reserved

28

2

Old CAM File Version. Always "FF".

30

2

Hex offset to the Event Log Type, or the number of bytes from the beginning of the record to the beginning of the Event Log Type field (in the above example, "60").

32

2

Reserved

34

8

New CAM File Version. This value is 00530000, and consists of:

  • 00530000—Major CAM Version, or the 4-digit hex value of decimal value 83. This field is incremented with major
    Unable to show "metadata-from": No such page "_space_variables"
    releases.
  • Minor CAM Version of "00"—This field is incremented when accounting changes are introduced in minor
    Unable to show "metadata-from": No such page "_space_variables"
    releases.
  • Special CAM version of "00"—This field is incremented when accounting changes are introduced in special builds of major
    Unable to show "metadata-from": No such page "_space_variables"
    releases.

42

8

Reserved

50

4

Hex offset to start of data. In this example, "0060".

54

13

Unable to show "metadata-from": No such page "_space_variables"
software revision. In this example, "V05.00.00".

67

29

Reserved

96

3

Event Log Type (same as file extension). In this example, "ACT".

99

16

File creation time.

115

12

Reserved

127

1

Header terminator (carriage return)

File Footer

The one line footer, below, is appended to each log file (including accounting logs) when the file is closed under controlled conditions.

DDMMYYYY HHMMSS: File administratively closed.

Controlled conditions include CLI commands (for example, set oam eventLog typeAdmin acct rolloverAction...) and automatic roll-overs when maximum file size is reached.

When an uncontrolled file closure occurs, such as an

Unable to show "metadata-from": No such page "_space_variables"
 switch-over or system failure, this footer may not be present.

How to Set Up SFTP from SBC to a CDR Server

If the CDR server is configured, SBC transfers the files through SFTP to the configured destination. If transfer fails, ACT files begin to accumulate. When SBC accumulates the maximum number of configured files, it deletes the oldest unsuccessfully transferred files first. Therefore, these files are lost. The trap sonusCpEventLogFileCountNotification - MAJOR indicates that the number of event log files (in this case accounting files) is approaching the configured maximum per fileCount parameter. There are different reasons for unsuccessful transfer, which includes network errors, insufficient bandwidth, disk capacity issues on destination, bad configuration, and so on. Therefore, this trap can be used to prevent the loss of accounting or billing data.

CDR files are removed when the fileCount configured for oam eventLog typeAdmin acct is reached. (see Event Log - CLI for configuration details)

The accounting files (in this case .ACT files) can be copied to the event log directory, which increases the file count (all .ACT files count toward total number). SBC application does not have knowledge of that copied file and cannot automatically delete the manually copied files. For example, 100000A.ACT is copied to 100000A-backup-debug-special-project.ACT.

 

  1. To create the CDR server, use the following command syntax:

    % set oam accounting cdrServer admin [primary | secondary] connectionTimeout <numeric: 15 to 600 seconds> filePrefix <name of SBC> ipAddress <ip address> password <password for ftp user> path <directory to ftp to> transferTimeout <numeric: 15 to 600 seconds> username <username of ftp user>

      An example to show the CDR server configuration and check the configuration is as follows:

    admin@SBC01> config
    admin@SBC01% set oam accounting cdrServer admin primary connectionTimeout 15 filePrefix SBC01 ipAddress 10.10.211.10 password sonus path /export/home/SBC01ACTrecs/ transferTimeout 15 username root
    admin@SBC01% commit
    admin@SBC01% quit
    
    admin@SBC01> show table oam accounting cdrServer admin
                                                                                    FILE    CONNECTION  TRANSFER
    TYPE     IP ADDRESS    USERNAME  PASSWORD         PATH                          PREFIX  TIMEOUT     TIMEOUT
    --------------------------------------------------------------------------------------------------------------
    primary  10.10.211.10  root      $3$qaO71mBy8l8=  /export/home/SBC01ACTrecs/  SBC01   15          15
    [ok][2013-10-02 06:14:49]
    admin@SBC01>

     

  2. Initially, the accounting field is not set to ftp or automatically roll over. Use the following command to view Rollover setting for accounting (See "acct" row in the example):

    admin@SBC01> show table oam eventLog typeAdmin
                                     MESSAGE                                                                        FILE                SYSLOG   SYSLOG    SYSLOG  RENAME
                       FILE   FILE   QUEUE    SAVE  FILTER  ROLLOVER START       ROLLOVER                 ROLLOVER  WRITE     SYSLOG    REMOTE   REMOTE    REMOTE  OPEN
    TYPE      STATE    COUNT  SIZE   SIZE     TO    LEVEL   TIME                 INTERVAL  ROLLOVER TYPE  ACTION    MODE      STATE     HOST     PROTOCOL  PORT    FILES
    -------------------------------------------------------------------------------------------------------------------------------------------------------------------------
    system    enabled  16     16000  32       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    debug     enabled  16     16000  32       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    trace     enabled  16     16000  32       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    acct      enabled  16     64000  32       disk  info    -                    0         nonrepetitive  stop      optimize  disabled  0.0.0.0  tcp       514     disabled
    security  enabled  16     16000  32       disk  major   -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    audit     enabled  32     2048   10       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    packet    enabled  32     2048   10       disk  major   -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    [ok][2013-10-02 06:41:58]

     

  3. To create the accounting file rollover and ftp, use the following command syntax:

    % set oam eventLog typeAdmin acct rolloverStartTime <CCYY-MM-DDTHH:MM:SS> rolloverInterval <number of seconds between each file rollover> rolloverType repetitive rolloverAction start
    where 'T' in 'DDTHH' is a constant used to indicate the Time follows.

      An example of the configuration and display of the accounting file rollover and ftp is as follows:

    admin@SBC01% set oam eventLog typeAdmin acct rolloverStartTime 2013-10-02T06:30:00 rolloverInterval 900 rolloverType repetitive rolloverAction start
    [ok][2013-10-02 06:41:25]
    [edit]
    admin@SBC01% commit
    Commit complete.
    [ok][2013-10-02 06:41:28]
    [edit]
    admin@SBC01% quit
    admin@SBC01> show table oam eventLog typeAdmin
                                     MESSAGE                                                                        FILE                SYSLOG   SYSLOG    SYSLOG  RENAME
                       FILE   FILE   QUEUE    SAVE  FILTER  ROLLOVER START       ROLLOVER                 ROLLOVER  WRITE     SYSLOG    REMOTE   REMOTE    REMOTE  OPEN
    TYPE      STATE    COUNT  SIZE   SIZE     TO    LEVEL   TIME                 INTERVAL  ROLLOVER TYPE  ACTION    MODE      STATE     HOST     PROTOCOL  PORT    FILES
    -------------------------------------------------------------------------------------------------------------------------------------------------------------------------
    system    enabled  16     16000  32       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    debug     enabled  16     16000  32       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    trace     enabled  16     16000  32       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    acct      enabled  16     64000  32       disk  info    2013-10-02T06:30:00  900       repetitive     start     optimize  disabled  0.0.0.0  tcp       514     disabled
    security  enabled  16     16000  32       disk  major   -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    audit     enabled  32     2048   10       disk  info    -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    packet    enabled  32     2048   10       disk  major   -                    0         nonrepetitive  stop      default   disabled  0.0.0.0  tcp       514     disabled
    [ok][2013-10-02 06:41:58]

     

  4. View CDR Server status using the following command:

    admin@SBC01> show table oam accounting cdrServer status
                               SUCCESSFUL  FAILED     PENDING
    TYPE     STATE   PROGRESS  TRANSFERS   TRANSFERS  TRANSFERS
    -------------------------------------------------------------
    primary  active  done      3           0          0
    [ok][2013-10-02 07:27:19]

     

  5. Verify that the files were transferred to the FTP server by logging in to the CDR server and executing the following command:

    ftp server:
    root@hostname # pwd
    /export/home/SBC01ACTrecs
    root@hostname # ls -l
    total 708
    -rw-r--r--   1 root     other     346730 Oct  2 06:45 SBC01.20131002064500.1000022.ACT
    -rw-r--r--   1 root     other        175 Oct  2 07:00 SBC01.20131002070000.1000023.ACT
    -rw-r--r--   1 root     other        175 Oct  2 07:15 SBC01.20131002071500.1000024.ACT
    root@hostname #

     

  6. Execute the following command to view the successful and failed CDR file transfer:

    % show table oam accounting cdrServer status
                               SUCCESSFUL  FAILED     PENDING
    TYPE      STATE  PROGRESS  TRANSFERS   TRANSFERS  TRANSFERS
    ---------------------------------------------------------
    primary   active  done     2           0          0
    secondary standby idle     0           7          0

SBC Standard Attributes

The SBC RADIUS application uses standard attributes from the RADIUS when possible. For CDR fields that cannot be mapped to the standard attributes, vendor-specific attributes are defined. The

Unable to show "metadata-from": No such page "_space_variables"
allows instances of the standard attributes in Accounting request message as per following table:

Allowed Standard Attributes

Attribute Name

Attributes description

NAS-IP-Address

The IP Address of the SBC generating accounting request.

NAS -Identifier

The configured NAS Identifier for a given

Unable to show "metadata-from": No such page "_space_variables"
. When sending RADIUS accounting messages, the NAS-Identifier field is populated with the corresponding value configured for the RADIUS server to which message is sent.

Acct-Status-Type

The type of accounting message sent by the

Unable to show "metadata-from": No such page "_space_variables"
. The
Unable to show "metadata-from": No such page "_space_variables"
uses the appropriate value of Acct-Status-Type corresponding to the CDR type to be generated.

  • “Value” field in Acct-Status-Type attribute is “1” when call accounting record type is “START”.
  • “Value” field in Acct-Status-Type attribute is “2” when call accounting record type is “STOP”.
  • “Value” field in Acct-Status-Type attribute is “3” when call accounting record type is “INTERMEDIATE”.
  • “Value” field in Acct-Status-Type attribute is “4” when call accounting record type is “ATTEMPT”.
  • “Value” field in Acct-Status-Type attribute is “5” when call accounting record type is “REBOOT”.
  • “Value” field in Acct-Status-Type attribute is “6” when call accounting record type is “SWITCHOVER”.

Acct-Session-Id

Uniquely identifies accounting records for a given call. It is possible to match all accounting records for a given call when correlating call records.

Acct-Session-Time

The number of seconds during which the user received service (duration of the call).

Acct-Terminate-Cause

The class of termination cause. This value is derived from the disconnect reasons class value.

Unable to show "metadata-from": No such page "_space_variables"
accounting records may be sent to three different locations:

  • Local hard disk—If accounting is enabled, then ASCII records are always written to the local disk.
  • An external server:
    • To DSI-L0 server—If configured, the ASCII records are transferred to the external Sonus DSI server through SFTP.
    • To external billing server from IMS network via Rf Interface.
  • RADIUS server—RADIUS accounting records can be generated and sent to an external RADIUS server.

Accounting File Roll-Over

The SBC application maintains a configurable maximum of up to 1024 accounting files. Once the configured limit of files is reached, the application deletes the oldest files first to accommodate the new files.

When accounting file names reach the maximum value of 1FFFFFF.ACT, the next file name rolls over to 1000001.ACT. Use the “Rename Open Files” flag to rename the most recent accounting file with the ”ACT.OPEN” extension. This flag is accessible from the EMA at “System Configuration” > “CDR and Servers” tab.

Global Charge Reference

The Global Charge Reference (GCR) feature allows correlation of calls across networks where the calls are originated from and terminated at different third-party devices. The GCR field is populated in the CDRs of the SBC if the GCR is received in a gateway protocol message from a GSX9000.

The GSX9000 receives or generates the GCR parameter through an ISUP parameter. The GCR is used in conjunction with SIP call-id’s to associate calls that interwork between SIP and ISUP protocols across multiple network devices.

RADIUS Support

RADIUS is a standardized protocol for supporting Authentication, Authorization, and Accounting (AAA) management in a distributed client-server architecture. The SBC acting as a RADIUS client can send call-accounting records to an external RADIUS server. For a description of Sonus CDR to RADIUS VSA field mapping, please see Managing Billing Records.

The following message types are supported by RADIUS protocol:

  • Accounting Request
  • Accounting Response
  • Access-Request
  • Access-Accept
  • Access-Reject

The accounting request and its response for a transaction methodology is described below.

  • The SBC sends an accounting-request with Accounting-Status-Type value "Accounting-on". At a later time, this transaction informs the server about the new accounting client that will send the accounting messages to the NAS/resource usage by user.
  • When the SBC connects the call, the accounting starts. The accounting-request contains the Accounting-Status-Type with the value "Start". The "Start" records contains the following:
  • User identification
  • Network address
  • Point of attachment
  • Unique session identifier
  • Next, the SBC records the status change by NAS to the RADIUS server for this active session. The accounting-request now contains the Accounting-Status-Type with the value "Interim". The interim record usually conveys the current session duration and information on the current data usage.
  • When the user network access is closed, the NAS issues a final Accounting Stop record to the RADIUS server, providing the information on the final usage in the terms of the following:
  • Time
  • Packets transferred
  • Data transferred
  • Reason for disconnect
  • Other information related to the call

The accounting-request contains the Accounting-Status-Type with the value "Stop". The primary purpose of this data is to bill the user. The data is also used for statistical purposes and for general network monitoring.

RADIUS Client-Server Diagram

To configure up to three RADIUS servers per SBC, see Accounting - CLI.

To configure SBC for RADIUS authentication, see Configuring SBC for RADIUS Authentication.

 

Renaming Open Accounting Files

The SBC includes the ability to rename a currently-open accounting file using a known suffix to make it easily identifiable by external applications. To activate this feature, simply enable the flag “Rename Open Files” using EMA GUI or CLI. 

CLI syntax example:

% set oam eventLog typeAdmin acct renameOpenFiles enable

Once this flag is enabled, on the next accounting file open activity, the suffix .OPEN is appended to the filename using the format <shelf><sequence number>.ACT.OPEN (currently open files are not affected).

For example, as accounting file 1000099 is created with this feature already enabled, the file is named “1000099.ACT.OPEN”.

If a file closes due to a rollover, logging shutdown or system shutdown, it is renamed to the original format: <shelf><sequence number>.ACT.

For configuration details, see:

Rf Interface Support

The

Unable to show "metadata-from": No such page "_space_variables"
acting as a P-CSCF or IBCF supports Rf interface-based offline billing in compliance with standard IMS as well as file-based and stream-based CDRs. The SBC can select either CDR/streaming-based charging or Rf Interface depending on whether the system-wide flag, enableRfApp, is enabled or not. See Signaling - Global - CLI or Signaling - Diam Sig Controls for configuration details.

The

Unable to show "metadata-from": No such page "_space_variables"
Diameter node supports both Rf application along with the existing Rx application. The Diameter node uses "Route Table" to find peer for outbound request based on destination realm and application.

For more details, see Rf Interface Support page in the Managing Billing Records section.

 

  • No labels