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.

Configuring CDR Server 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.


Transferring Call Accounting Files to a CDR Server

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.

  2. Make other required entries to define the CDR server and transfer parameters. See the CDR Server parameter table for descriptions.
  3. Click Save.
  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.


CDR Server Admin Parameter Descriptions

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.

File Postfix

Specifies the temporary extension used by Use File Postfix copies the file to the specific CDR server.

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 File Postfix 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)


Admin Request Commands

For each CDR Server Admin object created, additional Admin Request commands are available.


CDR Server Admin Request 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 (Force Current Server)

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

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

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

  4. The action concludes with the result.

  5. Click OK to Complete.

Admin Command Execution (Generate Ssh Public Keys)

  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.

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

  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 (Reset CDR Server Stats)

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

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

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

  4. The action concludes with the result.

  5. Click OK to complete.



  • No labels