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:
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:
- ivr tcl scripts
The following are NOT supported and the calls discarded:
- 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.
This article was:
Thank you for your feedback!