Billing configuration

xDR files integration

In order to allow JeraSoft billing to fetch xDR files from your equipment you will need the following:

1. User account on the equipment that has access to the xDR files.
2. SSH keys from the billing nodes uploaded to the equipment (for SSH protocol, if your equipment supports only FTP – you can skip this step).

Creating SSH keys

Follow these steps to create SSH keys and grant your JeraSoft Billing access to the xDR-files storage:

1. Log into you JeraSoft Billing node (repeat for each node in the cluster)
2. Upload SSH keys by using following command:

   sudo -u vcs ssh-copy-id -p <port> <username>@<hostname>

Replace <username>@<hostname> with credentials of the user account that has permissions to access xDR-files, and <port> with the SSH port (default is 22).

warning

Ensure that after logging into the equipment over SSH default Bash Shell is launched without any extra login messages.

Billing configuration

In order to configure xDR files integration on the JeraSoft billing side you need to perform following steps:

1. Create Data Source

   1. Go to "Integrations → Data Sources" and click "Add Source"
   2. Fill in the credentials for the equipment server
      1. We recommend using SSH protocol to access the server, but if your equipment doesn't support it – use SFTP or FTP instead

2. Enable integration

   1. Go to "Integrations → Gateways" and either click "New Gateway" or edit already created gateway
   2. Make sure to set the following parameters for xDR-files processing:
      1. Files Collector – mark checkbox to enable xDR files processing (fetching and parsing);
      2. Collector Type – select type of the collector matching your equipment;
      3. Data Source – select the pre-created data source

3. Check system services

   1. Make sure that both "Files Collector" and "Files Downloader" are enabled in the "System → System Services" section.

info

Check Data Sources and Gateways in the User Guide for more information.

Typical xDR paths

Below is a list of some typical xDR location paths depending on the equipment. Make sure to re-check it with your actual deployment since the paths may change depending on the version.

Equipment	Path
Aloe MVTS I	/usr/local/mvts/billing/bill*
Aloe MVTS Pro	/var/cdrs/bill*
Aloe RTU	/var/cdrs/bill*
Aloe Transit SBC	/var/cdrs/*
Asterisk	/var/log/asterisk/cdr-billing/*
Genband (Nextone)	/home/nextone/cdrs/*.CDR
Sansay VSX/VSXi	/cdr/20*
Freeswitch	/usr/local/freeswitch/log/cdr-csv/Master.csv.2*
FusionPBX	/var/log/freeswitch/cdr-csv/Master.csv*
VOS3000	/home/kunshi/vos3000/server/cdrs/cdr_*
VOS5000	/home/kunshi/vos5000/server/cdrs/cdr_*

RADIUS/SIP integration

RADIUS and SIP integration procedure is very similar to the one you need to perform for the xDR files. Please log into your JeraSoft Billing and perform the following steps:

1. Enable integration

   1. Go to "Integrations → Gateways" and either click "New Gateway" or edit already created gateway
   2. Make sure to set the following parameters for xDR-files processing:
      1. IP Address – set to the IP address of your equipment that will be used to communicate to the billing cluster
      2. RADIUS Server – mark checkbox to RADIUS (accounting, authorization, sometimes routing);
         1. Collector Type – select type of the collector matching your equipment;
      3. SIP Server – mark checkbox to SIP Redirect (dynamic routing);
         1. Collector Type – select type of the collector matching your equipment;

2. Check system services

   1. Make sure that "RADIUS Server" and/or "SIP Redirect Server" are enabled in the "System → System Services" section.

info

Check Gateways in the User Guide for more information, especially about extra options available for the RADIUS server.