Add_workflow_for_techpubs | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Panel | ||||
---|---|---|---|---|
In this section:
|
The Call Accounting Manager (CAM) generates Call Detail Records (CDRs) and supports accounting event logging on the
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
/var/log/sonus/sbx/evlog
directory. You can view these CDR CDRs by looking at files with the “.ACT” extension. It is useful to view the ACT logs during call debugging (to get the originating trunk group, calling and called numbers, codec used, and more). You can also view billing records (and other logs) while in EMA Platform Mode. Refer to Administration - Accounting and Logs for more information. Info | ||
---|---|---|
| ||
The SBC generates timestamps in the local time format in the ACT files for any of the fields that were previously in the GMT time format. |
You can send
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
This section describes the ASCII and streaming Call Detail Record (CDR) format.
Include Page | ||||
---|---|---|---|---|
|
Various
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
For GW-GW calls on the
and Spacevars 0 product2
Cloud, a CDR is only generated for the ingress leg. If the generation mode is configured as origination and the Spacevars 0 product2 populateRemoteGsxInfoState
flag is enabled, the SBC logs billing information from the termination node.
Note | ||||
---|---|---|---|---|
The “Service Group” object is not applicable to the
|
For more information on known limitations, refer to the applicable release notes at SBC Release Information page.
Info | ||||
---|---|---|---|---|
Additional references:
|
The CAM version of the SBC release V11.00.00 is 101.00.00 (major CAM version is 101, minor CAM version is 0, special CAM version is 0). The associated hex format of CAM file version is 00650000, displayed as 00650000 in the ASCII CAM file header as follows:
Code Block |
---|
Sonus Networks, Inc.00000000FF600000650000000000000128V11.00.00R000 0000000000000000000000000000ACT2022042504253100000000000000 |
Every event log file, including accounting logs, contains a file header. This header consists of a 128-character string terminated by a (line feed). Each field in the event log file header is defined in the following table:
Table 1: File Header Details
Field Offset | Field Length | Field Content | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 20 | ASCII OEM string, blank padded, (for example "Ribbon Communications, 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, "64"). | ||||||||||||
32 | 2 | Reserved | ||||||||||||
34 | 8 | New CAM File Version. This value is 100, and consists of:
| ||||||||||||
42 | 8 | Reserved | ||||||||||||
50 | 4 | Hex offset to start of data. In this example, "0128". | ||||||||||||
54 | 13 |
| ||||||||||||
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 (line feed) |
The one line footer, below, is appended to each log file (including accounting logs) when the file is closed under controlled conditions.
DDMMYYYY MMDDYYYY 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
Spacevars | ||
---|---|---|
|
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:
Code Block |
---|
% 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”.
Note |
---|
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, refer to:
The
Spacevars | ||
---|---|---|
|
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.
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.
If a CDR server is configured, the
Spacevars | ||
---|---|---|
|
To create a CDR server, use the following command syntax:
Code Block | ||
---|---|---|
| ||
% 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 | ||
---|---|---|
| ||
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> |
Initially, the accounting field is not set to ftp or automatically roll over. Use the following command to view Rollover settings for accounting (See "acct" row in the example):
Div | |||||
---|---|---|---|---|---|
| |||||
|
Span |
---|
To create the accounting file rollover and ftp, use the following command syntax:
Code Block | ||
---|---|---|
| ||
% 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 | |||||
---|---|---|---|---|---|
| |||||
|
Span |
---|
View CDR Server status using the following command:
Code Block | ||
---|---|---|
| ||
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] |
Span |
---|
Verify that the files were transferred to the FTP server by logging in to the CDR server and executing the following command:
Code Block | ||
---|---|---|
| ||
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 # |
Span |
---|
Execute the following command to view the successful and failed CDR file transfer:
Code Block | ||
---|---|---|
| ||
% 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 |
The
Spacevars | ||
---|---|---|
|
ACT
) to a CDR server through a user-configured port. The Spacevars | ||
---|---|---|
|
Use the following parameters within CDR server configuration to set up remote port and ssh key based authentication:
cdrPort
useSshKeyFile
generateSshPublicKeys
Note |
---|
The user can either use the existing username/password or the SSH public key to authenticate with the remote CDR server. The parameter |
To generate a new SSH public key, execute the following command:
Code Block | ||
---|---|---|
| ||
% 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.
Note |
---|
|
When downloading billing records (or other logs), you must use port 2024 to SFTP files from the
Spacevars | ||
---|---|---|
|
Code Block | ||
---|---|---|
| ||
% set oam accounting cdrServer admin primary cdrPort 2024 |
Using SSH public keys for CDR server authentication requires the following:
Anchor | ||||
---|---|---|---|---|
|
To enable SSH key based authentication, execute the following command:
Code Block | ||
---|---|---|
| ||
% set oam accounting cdrServer admin primary useSshKeyFile Enable |
Anchor | ||||
---|---|---|---|---|
|
To generate a new SSH public key, execute the following command:
Code Block | ||
---|---|---|
| ||
% request oam accounting cdrServer admin primary generateSshPublicKeys result success reason ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDclSOlVfVmmhatw5bDQRk7AaYvCRUUfHHbSvkCBb4T8zYdJ8JNw15rMSKk9hEkVdtEEZRJU4Q97C+3LbPknZrIMM+zmSRYmh2/LkGAlydSJ+sPe9i7zWFOLYeA3gitaKJSPgSjdb4WGgDq686Ei4yup9xYDbT8wAcosQsf3tfbqH2GetNJ8tAs3KjRi7FPhH1hHdXVyH0yW1mdGlMYvoFUeFCRjhE81oJhy2jMTJD9T3eQiJo4NZQZYOgALMQPi8fxaAgnuWmvrejNTn/PgRyGpQEs7HFHkX5zHW5M74PU/Z3S3Y2uSZlYrCQRf9Y2mUiK5R40bjsKz4TqIP5LfzhX [ok] |
Anchor | ||||
---|---|---|---|---|
|
The SSH public key is copied to the remote CDR server file /home/<user>/.ssh/authorized_keys
.
For configuration details, refer to Accounting - CLI.
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
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
The following accounting message types are supported by RADIUS protocol:
The process for sending accounting requests and responses is described below.
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
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.
Figure 1: RADIUS Client-Server Diagram
Info | ||||||||
---|---|---|---|---|---|---|---|---|
To configure the
|
The
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
Table 2: Allowed Standard Attributes
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 type of accounting message sent by the
| ||||||||
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. |
The
Spacevars | ||
---|---|---|
|
The
Spacevars | ||
---|---|---|
|
For more details, refer to Rf Interface Support.
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.