In this section:

The CDR Server Admin window allows you to configure an SBC Core accounting object that controls transferring files to an external CDR server. Its parameters identify the remote server and login details.

The SBC supports transferring call accounting files (.ACT) to the CDR server through a user-configured port. The SBC also supports using either a username/password combination or a Secure Shell (SSH) public key to authenticate with the remote CDR server. The parameter Use Ssh Key File  must be enabled to generate an SSH public key.

The generated SSH public key must be installed on the CDR server to use SSH key-based authentication from the 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:
  • The SSH public key generated for the primary CDR server can also be used to authenticate the secondary CDR server. The SSH public key can be installed on both primary and secondary CDR servers.

  • The configured user must have access to /home/<user>/.ssh for reading the public key.

Admin List

To view the list of CDR Server Admin objects, on the SBC main screen, go to Administration > Accounting and Logs > CDR Server > Admin. The CDR Server Admin window is displayed. You can configure a primary and a secondary object. 

CDR Server - Admin List Window

 

Transferring Call Accounting Files (.ACT) to a CDR Server Using SSH Keys

To add new Admin settings that enable SSH key authentication, click New Admin on the Admin panel. The Create New Admin window appears:

  1. Click to enable the parameter Use Ssh Key File. 

    CDR Server - Create New Admin with SSH Key

  2. Make other required entries to define the CDR server and transfer parameters. See the CDR Server parameter table for descriptions.
  3. Click Save at the right hand bottom of the panel.
  4. Generate the SSH keys. For more information, see Admin Command Execution (generateSshPublicKeys)

Transferring Call Accounting Files (.ACT) to a CDR Server Without Using SSH Keys

To add new Admin settings without SSH key authentication, click New Admin on the Admin panel. The Create New Admin window appears:

  1. Do not enable the Use Ssh Key File parameter. Leave the default setting of Disable to use username/password authentication.

  2. Make other required entries to define the CDR server and transfer parameters. See the following table.

  3. Click Save at the right hand bottom of the panel.


The complete list of CDR Server Admin fields displayed are:

CDR Server - Create/Edit Admin Parameters

Parameter

Description

Type

Use this object to specify the CDR server type for this configuration:

  • Primary
  • Secondary

IP Address V4 or V6

The IP address of the external CDR server. The following IP address types are supported:

  • IPv4—This is V4 IP address in dotted decimal form (for example 128.127.50.224).
  • IPv6—This is V6 IP address in hexadecimal/colon form (for example, 1280:1276:3350:2224:2222:3333:8888:1245 or fd00:21:445:128::7880).
CDR PortSpecifies the SSH port number of the remote server. The value ranges from 1 to 65535 and the default value is 22.
Use Ssh Key File Enable this parameter to use SSH public key for authenticating the remote CDR server.  
  • Disable (default)
  • Enable

Username

Specifies the remote username.

Password

Specifies the remote server password.

Note: You can enter password in non-echo mode when prompted and not inline. 

Path

Specifies the remote directory path where the files should be transferred.

File Prefix

Specifies the remote file prefix that is used to form the remote file.
This prefix will be appended with a date stamp and sequence number once transferred.

Connection Timeout

The time to wait before timing out the connect operation, in seconds (default: 30 seconds). The values range between 15 and 120.

Transfer Timeout

The time to wait before timing out the file transfer (default 120). The values range between 15 and 600.

Buffer SizeSpecifies the buffer size for the new admins created. The value ranges from 4 to 1024 and the default value is 1024.
Use File Postfix

When enabled, this flag appends the string specified by the filePostFix field to the file name of the CDR file while the SBC transfers/writes it to the specified (primary or secondary) remote CDR server. This allows CDR server applications to determine when the file is completely transferred. 

  • Disable
  • Enable (default)

Modified: for 10.1.4

Admin Commands

For each CDR Server Admin object created, Admin Commands can be used.

Cdr Server - Admin Commands

 


The following options are displayed:

CDR Server - Admin Commands

Parameter

Description

Force Current Server

Use this request parameter to forcibly set the specified server as the current server.
Generate Ssh Public KeysUse this request parameter to generate the SSH public key to authenticate the remote CDR servers.
Reset CDR Server StatsUse this request parameter to reset the CDR server statistics.

Admin Command Execution (forceCurrentServer)

  1. Choose Force Current Server to set the specified server as current server.

  2. Click Select. A pop up window displays the selected command.

    Cdr Server - Admin Commands (forceCurrentServer)

     
  3. Click the  forceCurrentServer  button to proceed or Click Delete to exit the window.

  4. The action concludes with the result.

    CDR Server - Admin Commands Success

     

  5. Click OK to Complete.

Admin Command Execution (generateSshPublicKeys)

  1. Choose Generate Ssh Public Keys to generate SSH Public Keys for remote servers.

  2. Click Select. A pop up window displays the selected command.

    Admin Commands (generateSshPublicKeys)

  3. Click the generateSshPublicKeys  button to proceed or click Delete to exit the window.
    The pop-up window with the ssh keys displays.

    Admin Command Success

  4. Copy the ssh key displayed in the pop-up. The ssh key starts from "ssh-rsa" till the end of the text.
  5. Click Ok to complete.

  6. Paste the ssh key in the .ssh/authorized_keys file on the CDR server.

     Set the the directory permissions for .ssh  to 700 and the file permissions for authorized_keys to 600.

Admin Command Execution (resetCdrServerStats)

  1. Choose Reset CDR Server Stats to reset the CDR server statistics.

  2. Click Select. A pop up window displays the selected command.

    CDR Server - Admin Commands (resetCdrServerStats)

     
  3. Click the resetCdrServerStats  button to proceed or Click Delete to exit the window.

  4. The action concludes with the result.

    CDR Server - Admin Commands Success

     

  5. Click OK to complete.