Knowlege base

PBX Configuration

Article ID: 51
Last updated: 21 Jan, 2020

This section describes:

  • Cisco Unified CallManager Configuration
  • Cisco Unifiled CallManager Express Configuration and Caveats

Cisco Unifiled CallManager Configuration

On the Unified CallManager enable CDR by selecting the “System” -> “Service Parameters” menu.

Then from the select box click on “CallManager service”

On the System section, set the 'CDR Enable Flag' to TRUE

As of CDR enablement, the CDRs will be generated by the Cisco Unified Communications cluster.

Note: Make sure the above configuration is applied to all nodes of the cluster where Cisco CallManager service is active.

Warning: Calls made before enabling CDR will NOT be available as no CDR was provided by the Cisco Unified Communications cluster.

Please ensude that call trace information is not sent through FTP. Enabling call tracing will cause the PBX to generate diagnostic files (which names have the "cdm_" prefix) that can interphere with BillyBlue's activity. To disable CDM files generation, on the same configuration page locate the Clusterwide parameters" section. Set "Call Diagnostics Enabled" to Disabled.

Then on the top right select “Navigation” -> “Cisco Unified Serviceability”

And from the “Tools” menu select “CDR Management”

Select Add new from Billing Application Server Parameters

Insert the name/IP address of the Application Suite server where is running the Imagicle Billing with following parameters:

  • username: anonymous
  • password: billyblues
  • directory path: /billyblues/

Click on the “Add” button. If the FTP connection to the server running on the Imagicle Application Suite (IAS) is successful, the Billing Application will be added. If no connection can be established the operation will fail.

Quick FTP troubleshooting tips
  • Check read and write permissions on the ccm5cdr folder
  • Open IIS manager to know the log folder location and check FTP logs
  • Press the Current conntecions button to see
  • Use windows FTP client to test the connection

Tips for Cisco CuCM users: MGCP reporting

When a gateway is controlled by MGCP, the voice port number is stored in the Line field in Imagicle Billing calls database. When you setup your reports and alarms you can show, filter or group the calls by this field to monitor your lines activity.

Cisco Unifiled CallManager Express Configuration

Imagicle Billing for CallManager Express relies on the CDR through FTP feature, which is available on CME beginning with version 7. IOS and CME versions which do not send CDRs through FTP are not supported. To enable this feature, enter the following commands through a privileged login:

gw-accounting file
 primary ftp x.x.x.x/BibCme1/ username anonymous password SvBillyBlues$
 secondary ifs flash:cdrbib
 maximum buffer-size 15
 maximum retry-count 4
 maximum fileclose-timer 60
 maximum cdrflush-timer 65
 cdr-format detailed
 acct-template callhistory-detail
 !

where x.x.x.x is the BilyBlues server name/IP address and BibCme1 is the first FTP folder automatically created by the setup program. If you need to configure more gateways, use BibCme2 for the second gateway, BibCme3 for the third an so on. The setup program creates ten FTP folders.

Troubleshooting CuCME configuration

You can use the following command to force CUCME to send CDRs to BillyBlues:

file-acct flush with-close

This command must be manually entered whenever the network connections between the router and Imagicle Billing fails for a long time (loger than the configured timeout multiplied the number of retries).

The following debug commands may be used for troubleshooting:

debug voip fileacct
debug voip dump-file-acct

If debug shows problems in sending CDR to Imagicle Billing, you can reset the file accounting system through the command:

file-acct reset

BillyBlue's for Callmanager Express caveats

Imagicle Billing supports a lot of call dynamics and reports incoming, outgoing and internal calls.

Different commands/approaches for mapping external to internal numbers are supported:

  • num-exp
  • translation-rule
  • ivr tcl scripts

The following are NOT supported and the calls discarded:

  • Dialplan-pattern
  • Ephone-dn secondary
Internal calls and dial plan length

BillyBlues for CuCME distinguishes internal from external calls through the dialing plan length. This is a parameter to be configured through the configuration wizard. Calls to number shorter or equal to the dialing plan lenght are considered internal. The maximun supported lenght for a dial plan is 5 digits.

  • Dialing plans longer than 5 digits are NOT supported (corner case)
  • Outgoing calls to numbers shorter than the dialing plan are NOT accounted (i.e. are reported as internal calls). E.g calls to emergency number 0911 with a dialing plan 4 digits long.
Overlapped dial plans

In multi-site CuCME environments, overlapped dialing plans are NOT supported. For example: 201 cannot exist on different sites.

Article ID: 51
Last updated: 21 Jan, 2020
Revision: 4
Views: 3126
Print Export to PDF Subscribe Share
This article was:  
Prev   Next
Product Administration     User guides