Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated per comment on 7.2 page
Panel

In this section:

Table of Contents
maxLevel2

 

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.

Info
titleNote:
  • 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. 

Caption
0Figure
1CDR Server - Admin List Window
 Image Modified

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

    Caption
    0Figure
    1CDR Server - Create New Admin with SSH Key

    Image Modified

  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. 

    Caption
    0Figure
    1CDR Server - Create New Admin without SSH Key

    Image Modified

  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:

Caption
0Table
1CDR Server - Create/Edit Admin Parameters
3CDR Admin table

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 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 Disable (default)
  • enableEnable

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 ranges range between 15 and 600120.

Transfer Timeout

The time to wait before timing out the file transfer (default 120). The values ranges 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.

Admin Commands

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

Caption
0Figure
1Cdr Server - Admin Commands
 

 

The following options are displayed:

Caption
0Table
1CDR 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.

    Caption
    0Figure
    1Cdr 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.

    Caption
    0Figure
    1CDR Server - Admin Commands Success
     
  5. Click OK to Complete.

Anchor
Admin Command Execution (generateSshPublicKeys)
Admin Command Execution (generateSshPublicKeys)
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.

    Caption
    0Figure
    1Admin 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.

    Caption
    0Figure
    1Admin 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.

    Info

     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.

    Caption
    0Figure
    1CDR 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.

    Caption
    0Figure
    1CDR Server - Admin Commands Success
     
  5. Click OK to complete.