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 |
---|
|
- 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 |
---|
0 | Figure |
---|
1 | CDR 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:
Click to enable the parameter Use Ssh Key File.
Caption |
---|
0 | Figure |
---|
1 | CDR Server - Create New Admin with SSH Key |
---|
|
Image Modified |
- Make other required entries to define the CDR server and transfer parameters. See the CDR Server parameter table for descriptions.
- Click Save at the right hand bottom of the panel.
- 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:
Do not enable the Use Ssh Key File parameter. Leave the default setting of Disable to use username/password authentication.
Caption |
---|
0 | Figure |
---|
1 | CDR Server - Create New Admin without SSH Key |
---|
|
Image Modified |
- Make other required entries to define the CDR server and transfer parameters. See the following table.
- Click Save at the right hand bottom of the panel.
The complete list of CDR Server Admin fields displayed are:
Caption |
---|
0 | Table |
---|
1 | CDR Server - Create/Edit Admin Parameters |
---|
3 | CDR Admin table |
---|
|
Parameter | Description |
---|
Type | Use this object to specify the CDR server type for this configuration: | 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 Port | Specifies 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)enable 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 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 Size | Specifies 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 |
---|
0 | Figure |
---|
1 | Cdr Server - Admin Commands |
---|
|
|
The following options are displayed:
Caption |
---|
0 | Table |
---|
1 | 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 Keys | Use this request parameter to generate the SSH public key to authenticate the remote CDR servers. | Reset CDR Server Stats | Use this request parameter to reset the CDR server statistics. |
|
Admin Command Execution (forceCurrentServer)
Choose Force Current Server to set the specified server as current server.
Click Select. A pop up window displays the selected command.
Caption |
---|
0 | Figure |
---|
1 | Cdr Server - Admin Commands (forceCurrentServer) |
---|
|
|
- Click the forceCurrentServer button to proceed or Click Delete to exit the window.
The action concludes with the result.
Caption |
---|
0 | Figure |
---|
1 | CDR Server - Admin Commands Success |
---|
|
|
Click OK to Complete.
Anchor |
---|
| Admin Command Execution (generateSshPublicKeys) |
---|
| Admin Command Execution (generateSshPublicKeys) |
---|
|
Admin Command Execution (generateSshPublicKeys)
- Choose Generate Ssh Public Keys to generate SSH Public Keys for remote servers.
Click Select. A pop up window displays the selected command.
Caption |
---|
0 | Figure |
---|
1 | Admin Commands (generateSshPublicKeys) |
---|
|
|
Click the generateSshPublicKeys button to proceed or click Delete to exit the window.
The pop-up window with the ssh
keys displays.
Caption |
---|
0 | Figure |
---|
1 | Admin Command Success |
---|
|
|
- Copy the ssh key displayed in the pop-up. The ssh key starts from "ssh-rsa" till the end of the text.
- Click Ok to complete.
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)
- Choose Reset CDR Server Stats to reset the CDR server statistics.
Click Select. A pop up window displays the selected command.
Caption |
---|
0 | Figure |
---|
1 | CDR Server - Admin Commands (resetCdrServerStats) |
---|
|
|
- Click the resetCdrServerStats button to proceed or Click Delete to exit the window.
The action concludes with the result.
Caption |
---|
0 | Figure |
---|
1 | CDR Server - Admin Commands Success |
---|
|
|
Click OK to complete.