Page History

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

1. Local hard disk—If accounting is enabled, then ASCII records are always written to the local disk.
2. An external server, for example: 
   1. To a DSI-L0 server—If configured, the ASCII records can be transferred to an external

      Spacevars
      0 company

       DSI server using SFTP.
   2. To an external billing server in an IMS network via the Rf Interface.
3. RADIUS server—RADIUS accounting records can be generated and sent to an external RADIUS server.

Call Detail Record Format

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

Various

• Administrator
• Operator
• FieldService
• Guest
• SecurityAuditor
• Calea

Since the RADIUS protocol does not provide a means to assign users to a group, the implementation currently hard codes every RADIUS authenticated user to the Administrator group.

For detailed information on RADIUS authentication, refer to Configuring SBC for RADIUS Authentication.

Viewing Billing Records 

As calls traverse the

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

 use many of the same CDR fields. Because of this, some fields in the “Accounting Records” table below do not apply to

For GW-GW calls on the

Call Detail Record Format

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

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

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”.

For configuration details, refer to:

• CLI: Event Log - CLI
• EMA: Event Log - Type Admin

Accounting File Roll-Over

The 

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.

How to Set Up SFTP from the SBC to a CDR Server

If a CDR server is configured, the 

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

   Code Block
   language none
   % 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>

   Span

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

   Code Block
   language none
   admin@SBC01> config admin@SBC01% set oam accounting cdrServer admin primary connectionTimeout 15 filePrefix SBC01 ipAddress 10.10.211.10 password sonus path

   [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>

   Span

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

   Code Block
   language none
   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>

   Span

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

   Div
   class pdf6pttext
   Code Block language none admin@SBC01>> show table oam eventLog typeAdmin MESSAGE ROLLOVER FILE RENAME DISK FILE SYSLOG SYSLOG SYSLOG RENAMESYSLOG FILE FILE QUEUE SAVE FILTER ROLLOVER START ROLLOVER ROLLOVER WRITE SYSLOG SYSLOG OPEN REMOTETHROTTLE EVENT REMOTELOG SERVER REMOTE OPENREMOTE TYPE STATE COUNT SIZE SIZE TO LEVEL TIME INTERVAL ROLLOVER TYPE ACTION INTERVAL ROLLOVER TYPEMODE ACTION STATE MODE FILES STATE LIMIT HOST VALIDATION NO PROTOCOL PORT FILESHOST ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- system system enabled 32 2048 10 disk major - 0 nonrepetitive stop default disabled disabled 5000 enabled 16disabled server1 16000 32 0.0.0. debug enabled 32 disk info 2048 -10 disk major - 0 nonrepetitive stop default disabled disabled 0.0.0.0- tcp disabled 514 server1 disabled debug0.0.0. trace enabled 1632 160002048 3210 disk info - 0 nonrepetitive stop default disabled 0.0.0.0 tcp default disabled disabled 514 - disabled trace enableddisabled 16 server1 160000.0.0. acct 32 enabled 32 disk info 2048 10 - disk major - 0 nonrepetitive stop default disabled 0.0.0.0disabled tcp- 514 disabled disabled acct server1 0.0.0. security enabled 1632 640002048 3210 disk info major - 0 nonrepetitive stop optimize disabled 0.0.0.0 tcp default disabled disabled - 514 disabled security enabled 16server1 0.0.0. audit 16000 32enabled 32 disk2048 major10 - disk info - 0 nonrepetitive stop default disabled disabled 0.0.0.0- tcp disabled 514 server1 disabled audit0.0.0. packet enabled 32 2048 10 disk infomajor - 0 nonrepetitive stop default disabled 0.0.0.0 tcpdisabled - 514 disabled disabled packetserver1 0.0.0. memusage enabled 32 2048 10 disk major - 0 nonrepetitive stop default disabled disabled 0.0.0.0- tcp disabled 514 server1 disabled0.0.0. [ok][2013-10-02 06:41:58]

   Span

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

   Code Block
   language none
   % 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.

   Span

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

   Div
   class pdf6pttext
   Code Block language none admin@SBC01%% set oam eventLog typeAdmin acct rolloverStartTime 20132018-1009-02T0613T06:30:00 rolloverInterval 900500 rolloverType repetitive rolloverAction start [ok][20132018-1008-0213 0612:4158:2511] [edit] admin@SBC01%admin@SBXUK11-1% commit Commit complete. [ok][20132018-1008-0213 0612:4158:2814] [edit] admin@SBC01% quit admin@SBC01>admin@SBXUK11-1% exit > show table oam eventLog typeAdmin MESSAGE FILE FILE SYSLOG SYSLOG RENAME SYSLOG RENAMEDISK FILE FILE QUEUE SAVE FILTER ROLLOVER START ROLLOVER ROLLOVER WRITE SYSLOG REMOTEOPEN REMOTE THROTTLE REMOTE EVENT OPENLOG TYPE STATE COUNT SIZE SIZE TO LEVEL TIMEROLLOVER START TIME INTERVAL ROLLOVER TYPE ACTION MODE STATE HOSTFILES PROTOCOL LIMIT PORT FILESVALIDATION ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- system enabled 1632 160002048 3210 disk info major - 0 0 nonrepetitive stop nonrepetitive defaultstop disabled 0.0.0.0 default tcp disabled disabled 5000 514 disabled debug enabled 1632 160002048 3210 disk major info- - 0 nonrepetitive stop default disabled 0.0.0.0disabled tcp- 514 disabled trace enabled 1632 160002048 3210 disk info - 0 0 nonrepetitive stop nonrepetitive stop default disabled 0.0.0.0 tcp default disabled disabled - 514 disabled acct enabled 1632 640002048 3210 disk infomajor 20132018-1009-02T0613T06:30:00-00:00 900500 repetitive start optimizedefault disabled 0.0.0.0disabled tcp - 514 disabled security enabled 1632 160002048 3210 disk major - 0 nonrepetitive stop default disabled 0.0.0.0disabled tcp- 514 disabled audit enabled 32 2048 10 disk info - 0 nonrepetitive stop default disabled 0.0.0.0 disabled tcp disabled - 514 disabled packet enabled 32 2048 10 disk major - 0 nonrepetitive stop default disabled 0.0.0.0disabled tcp- 514 disabled [ok][2013-10-02 06:41:58]

   Span

   View CDR Server status using the following command:

   Code Block
   language none
   admin@SBC01> show table oam accounting cdrServer status memusage enabled 32 2048 10 disk major - SUCCESSFULFAILEDPENDING TYPESTATEPROGRESSTRANSFERSTRANSFERS TRANSFERS ------------------------------------------------------------- primary active done 0 nonrepetitive 3 stop default disabled disabled 0 - 0 disabled [ok ][2013-10-02 07:27:19 ]

   Span

4. Verify that the files were transferred to the FTP server by logging in to the CDR server and executing View CDR Server status using the following command:

   Code Block
   language none
   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 admin@SBC01> show table oam accounting cdrServer status SUCCESSFUL FAILED PENDING TYPE STATE PROGRESS TRANSFERS TRANSFERS TRANSFERS ------------------------------------------------------------- primary active done 3 175 Oct 2 07:00 SBC01.20131002070000.1000023.ACT -rw-r--r--0 1 root other 175 Oct 2 07:15 SBC01.20131002071500.1000024.ACT root@hostname #0 [ok][2013-10-02 07:27:19]

   Span

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

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

   Code Block
   language none
   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
   Code Block
   language none
   % show table oam accounting cdrServer status other 175 Oct SUCCESSFUL2 FAILED07:00 SBC01.20131002070000.1000023.ACT -rw-r--r-- 1 root PENDING TYPE other STATE PROGRESS TRANSFERS 175 Oct 2 07:15 SBC01.20131002071500.1000024.ACT root@hostname #

   Span

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

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

SBC Standard Attributes

The

1. TRANSFERS TRANSFERS --------------------------------------------------------- primary active done 2 0 0 secondary standby idle 0 7 0

CDR Server Remote Port Configuration

Attribute Name

Attributes description

NAS-IP-Address

The IP Address of the

NAS -Identifier

The configured NAS Identifier for a given

Acct-Status-Type

The 

 supports transferring call accounting files (.ACT) to a CDR server through a user-configured port. The 

• “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.

Use the following parameters within CDR server configuration to set up remote port and ssh key based authentication:

• cdrPort
• useSshKeyFile 


• generateSshPublicKeys

To generate a new SSH public key, execute the following command:

% request oam accounting cdrServer admin primary generateSshPublicKeys

The generated SSH public key must be installed on CDR server to use ssh key based authentication from SBC. The SSH public key must be copied to the remote CDR server file /home/<user>/.ssh/authorized_keys. If the private key is compromised, the key must be re-generated. Once the key is re-generated, the CDR server must be updated with the new key.

Configuring the CDR Server Remote Port

When downloading billing records (or other logs), you must use port 2024 to SFTP files from the 

% set oam accounting cdrServer admin primary cdrPort 2024

1. Enabling SSH Key Based Authentication
2. Generating the SSH Public Key
3. Copying and Installing the SSH Public Key to CDR Servers

Anchor
Configuring SBC to Use SSH Key Based Authentication Configuring SBC to Use SSH Key Based Authentication

Enabling SSH Key Based Authentication

To enable SSH key based authentication, execute the following command:

% set oam accounting cdrServer admin primary useSshKeyFile Enable

Anchor
Generating the SSH Public Key Generating the SSH Public Key

Generating the SSH Public Key

To generate a new SSH public key, execute the following command:

% request oam accounting cdrServer admin primary generateSshPublicKeys
result success
reason 
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDclSOlVfVmmhatw5bDQRk7AaYvCRUUfHHbSvkCBb4T8zYdJ8JNw15rMSKk9hEkVdtEEZRJU4Q97C+3LbPknZrIMM+zmSRYmh2/LkGAlydSJ+sPe9i7zWFOLYeA3gitaKJSPgSjdb4WGgDq686Ei4yup9xYDbT8wAcosQsf3tfbqH2GetNJ8tAs3KjRi7FPhH1hHdXVyH0yW1mdGlMYvoFUeFCRjhE81oJhy2jMTJD9T3eQiJo4NZQZYOgALMQPi8fxaAgnuWmvrejNTn/PgRyGpQEs7HFHkX5zHW5M74PU/Z3S3Y2uSZlYrCQRf9Y2mUiK5R40bjsKz4TqIP5LfzhX
[ok]

Anchor
Copying and Installing the SSH Public Key to CDR Servers Copying and Installing the SSH Public Key to CDR Servers

Copying and Installing the SSH Public Key to CDR Servers

The SSH public key is copied to the remote CDR server file /home/<user>/.ssh/authorized_keys.

For configuration details, refer to Accounting - CLI.

RADIUS Accounting Support

Remote Authentication Dial In User Service (RADIUS) is a standardized protocol for supporting Authentication, Authorization, and Accounting (AAA) management in a distributed client-server architecture. The 

The following accounting message types are supported by RADIUS protocol:

• Accounting Request
• Accounting Response

The process for sending accounting requests and responses is described below.

• The

  Spacevars
  0 product

   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

  Spacevars
  0 product

   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

  Spacevars
  0 product

   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.

SBC Standard Attributes

The 

Rf Interface Support

The

The

For more details, refer to Rf Interface Support.

Generating CDRs in Q-SBC Format

By default, the SBC Core generates CDRs in the standard SBC Core (former Sonus) format. For deployments that require it, users with admin privileges can configure the SBC Core to generate CDRs in the format of the (former GENBAND) Q-series SBCs. Similar to SBC Core CDRs, the Q-SBC format is an ASCII-format text file with multiple records per file. When you enable the Q-SBC format, the SBC Core populates CDR log files according to the mapping shown in the Q-SBC to SBC Core CDR Mapping table. Refer to Generating CDRs in Q-SBC Format for more information

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

Accounting File Roll-Over

The

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

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

  Spacevars
  0 product

   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

  Spacevars
  0 product

   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

  Spacevars
  0 product

   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.

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”.

For configuration details, refer to:

• CLI: Event Log - CLI
• EMA: Event Log - Type Admin

Rf Interface Support

The

The

For more details, refer to Rf Interface Support page in the SBC Core Billing Guide section.

CDR Server Remote Port Configuration

The 

The following parameters are added in CDR server configuration to set remote port and ssh key based authentication:

• cdrPort
• useSshKeyFile


• generateSshPublicKeys

To generate a new SSH public key, execute the following command:

% request oam accounting cdrServer admin primary generateSshPublicKeys

The generated SSH public key must be installed on CDR server to use ssh key based authentication from SBC. The SSH public key must be copied to the remote CDR server file /home/<user>/.ssh/authorized_keys. If the private key is compromised, the key must be re-generated. Once the key is re-generated, the CDR server must be updated with the new key.

Configuring CDR Server Remote Port

% set oam accounting cdrServer admin primary cdrPort 2024

1. Enabling SSH Key Based Authentication
2. Generating the SSH Public Key
3. Copying and Installing the SSH Public Key to CDR Servers

To enable SSH key based authentication, execute the following command:

% set oam accounting cdrServer admin primary useSshKeyFile Enable

To generate a new SSH public key, execute the following command:

% request oam accounting cdrServer admin primary generateSshPublicKeys
result success
reason 
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDclSOlVfVmmhatw5bDQRk7AaYvCRUUfHHbSvkCBb4T8zYdJ8JNw15rMSKk9hEkVdtEEZRJU4Q97C+3LbPknZrIMM+zmSRYmh2/LkGAlydSJ+sPe9i7zWFOLYeA3gitaKJSPgSjdb4WGgDq686Ei4yup9xYDbT8wAcosQsf3tfbqH2GetNJ8tAs3KjRi7FPhH1hHdXVyH0yW1mdGlMYvoFUeFCRjhE81oJhy2jMTJD9T3eQiJo4NZQZYOgALMQPi8fxaAgnuWmvrejNTn/PgRyGpQEs7HFHkX5zHW5M74PU/Z3S3Y2uSZlYrCQRf9Y2mUiK5R40bjsKz4TqIP5LfzhX
[ok]

The SSH public key is copied to the remote CDR server file /home/<user>/.ssh/authorized_keys.

For configuration details, refer to Accounting - CLI.