Professional Documents
Culture Documents
AvayaECHI AutoAnswer DMCCLogger Call Analytics AgentLight QueueLight Avaya Monitoring Tool
UPINGET
Programming Blog of www.upinget.com
stay updated via rss
RECENT POSTS
Follow
ARCHIVES
August 2019
July 2019
May 2019
April 2019
March 2019
February 2019
January 2019
December 2018
The AvayaCDR tool captures Avaya CDR data over TCP/IP connection and stores the data in a file. Then the data file is
November 2018
daily archived and moved to a directory at a time that defined by you. The program can convert the CDR data into CSV
October 2018
format or import them into database. Since the tool uses ODBC, database such as MySQL, MariaDB and MSSQL are
September 2018
supported. Moreover, the program can send the CDR data to Splunk which enables you to search CDR record by specific
August 2018 field name, generate reports and dashboards very easily. The following features are supported:
July 2018
June 2018 Writes CDR data to a local file, rotates to a new file by daily or monthly
May 2018
Writes CDR data to MySQL, MariaDB and MSSQL database
April 2018
Writes CDR data to a CSV file, rotates to a new file every day
March 2018
August 2017 Downloads and Imports CDR data via Communication Manager or Session Manager SFTP interface
July 2017 Imports archived CDR data files and sends the data to database or Splunk
June 2017
Sends alert email to administrator when CDR link up down, DB up down or Splunk up down events
May 2017
Sends alert email to administrator when blacklisted number or country code found in the CDR data
April 2017
February 2017 Sends alert email to administrator when CDR data is received after office hour
January 2017 Acts as System Printer for Avaya Aura
December 2016
Supports Avaya Aura and IP Office
November 2016
September 2016
Supports Windows, CentOS 6.x, CentOS 7.x, Ubuntu 14.x, Ubuntu 16.x
June 2016
May 2016
April 2016
March 2016
January 2016
December 2015
November 2015
October 2015
We have created a VirtualBox OVA file which you can deploy it to VirtualBox or VMware Workstation or Player for testing.
September 2015 After deploying the OVA file, please modify the following for your own environment. The OVA file for VMWare can be
July 2015 found here.
June 2015
November 2014
OS : root/P@ssw0rd
October 2014
April 2014
We have recorded a video for Windows 2012 and Windows 7, please watch the video for Windows 2012 (64 bit) and
March 2014
Windows 7 (32 bit) before the installation
February 2014
Download the Avaya CDR Capturing Tool zip file here or backup site.
January 2014
March 2013
cd c:\program files\avayacdr
February 2013 avayacdr -i
October 2012 Open ODBC Data Source Administrator, create a System DSN called AVAYACDRCFG for Microsoft Access Driver
August 2012 (*.mdb) and select avayacdr.mdb which is located in the directory c:\program files\avayacdr
July 2012 Hint: make sure create a System DSN instead of User DSN, otherwise the program will startup without proper
parameters
CATEGORIES
If you are using 64 bit Windows OS, please use 32 bit ODBC Data Source Administrator
AgentLight
Analytics
Asterisk
Avaya CDR
BCMS
CMS
Daily Usage
DMCC
News
System Monitoring
TCP Gateway
TSAPI
META
Register
Log in Open the Access file, edit the value of parameter cdr_archive_dir, that is the location for archived files. E.g.
Entries RSS c:\\avayacdr\\
Comments RSS Hint: for the archive directory, make sure the format of double backslash (\\) is used because back slash is
WordPress.com escape character in c++.
You can edit the value of this parameter via the telnet console, the command is
Hint: you can edit the value of this parameter via the telnet console, the command is
Telnet to localhost and port number 14004, enter username tcpgate and password tcpgate01 to access the
program console
Enter the following command in the program console to add a listening port for Avaya CDR. E.g. add port 5001
Hint: If your Avaya sends data by Reliable Session Protocol, enter the following command
trace on asc
Enter the following command, you will get the help message
help
Enter the following command, you can perform the file archive immediately
archive now
Install Multiple Instances of AvayaCDR on the Same Machine
Follow the steps below if you want to install multiple copies of AvayaCDR on the same machine
Open Windows Command Prompt, enter the following command to register the program as service with startup
argument
AvayaCDR2 -i -a AVAYACDRCFG2
Hint: register AvayaCDR2 as program service and use AVAYACDRCFG2 DSN
Stop all instances of AvayaCDR and start the new AvayaCDR instance
Telnet to localhost and port number 14004, enter username tcpgate and password tcpgate01 to access the
program console
The following parameters must be changed for the new instance of AvayaCDR to work properly
cdr_archive_dir
cdr_remotedb_dsn
Hint: if you want to store CDR data in another DB, you need to modify the cdr_remotedb_dsn
64 bit Windows System
If AvayaCDR version >= 1.4.0, please download and install the Microsoft Visual C++ 2008 Service Pack 1
Redistributable Package MFC Security Update http://www.microsoft.com/en-hk/download/details.aspx?id=26368,
choose x86 version
If AvayaCDR version < 1.4.0, please download and install the Microsoft Visual C++ 2005 Service Pack 1
Redistributable Package MFC Security Update, http://www.microsoft.com/en-us/download/details.aspx?id=26347,
choose x86 version
Stop the Windows firewall because it enables by default and I don’t have time to figure out what ports are
required to open, you need to find it out yourself. AvayaCDR uses 14004 for telnet port. If you defined 5001 for
CDR data, you need to open this port in firewall as well.
Windows Uninstallation
Open Windows Command Prompt, enter the following commands to uninstall the program from Windows Service
cd c:\program files\avayacdr
avayacdr -u
Import CDR via SFTP interface
cdr_archive_dirsftp
Hint: The archive directory for sftp CDR files. The default value is c:\\avayacdrsftp\\
cdr_sftpdir
Hint: The remote directory that contains the CDR files. The default value is /var/home/ftp/CDR/
Hint: For a chroot sftp directory, the value is ./
cdr_sftpfilenameprefix (depreciated)
Hint: The filename prefix for CDR files. The default value is S
cdr_sftplicensekey
Hint: The license key to activate this feature
Open the program console, add your sftp host by the following command
Hint: username that created by your administrator for CDR retrieval over sftp protocol
Hint: encrypted password for sftp user. Use genpass command to generate an encrypted password
Hint: if dir is empty, the program uses the directory that specified in cdr_sftpdir
Input the following command to test the connectivity of sftp
sftptest
Hint: Test sftp login using the parameters provided by the add sftp command
The program will connect to your sftp hosts by every 30 seconds and imports the data to a file or database
We have recorded a video for this section, please watch this video for the setup on AvayaCDR side and this for
database side
The AvayaCDR is a 32bit application, make sure you use 32bit ODBC driver and use 32bit ODBC admin tool to create
the DSN
In order to store CDR data directly to MYSQL or MSSQL, you need to define the following parameters
Hint: the following screen dump as an example for MySQL system DSN
genpass
Hint: use this command to generate an encrypted password
You also need to define mapping of CDR data items to the table column names of your database. If you use
“customized” format, add paramcdr definitions according to your format. If you use “unformatted” format, please
refer this document to define the paramcdr definitions.
mmddyy” or “ddmmyy” or “yymmdd” if you want to send the data to Splunk as well.
Hint: use “
Hint: use “ seconds” or “minutes” or “6s” if you want to use the duration to calculate telecom charge
Hint: if your paramcdr is sec-dur, use “seconds” to convert the values to number of seconds
Hint: use “h:mm:ss” if you simply want to display a readable string to user
Hint: make sure Avaya side end with line-feed because the program use it as terminator for each
CDR record
disp paramcdr
Hint: this command shows the mapping table
reload
Hint: this command will reload the configuration and create the database connection according to the new
parameters.
trace on asc
Hint: this command turns on debug messages for database logging
In order to parse the CDR data and convert each record to CSV format, paramcdr must be defined
Use the console command add paramcdr to map your Avaya CDR data. For example,
Check if a parameter called “cdr_convertcsv” is set to “true” in the tParameter table. Or do it via program console
We have created a video for Splunk Logging, you can watch the video before the configuration
Use console command paramcdr to map your Avaya CDR data. For example,
Hint: Splunk need to know the date time in order index the CDR data
reload
Latest version of AvayaCDR supports backup Splunk configuration, please edit the following parameters
Create a token specific for AvayaCDR application, copy the token after its creation, it is suggested to create a token
for each specific application and link the token to it’s index
reload
If insert to Splunk failure, the data will be written to a local file called splunk_err.txt. You can upload the data to
Splunk manually using curl command
cdr_charge_ditem_duration
Hint: this is the Avaya duration data item name in the CDR string
cdr_charge_dbcol_subtotal
Hint: this is the database column/field name for the charge total
cdr_charge_dbcol_currency
Hint: this is the database column/field name for the charge currency
cdr_charge_dbcol_writetime
Hint: this is the database column/field name for the time of the charge record
cdr_charge_dbcol_description
Hint: this is the database column/field name for the description of the charge rate
Add your rate one by one by the “add rate” command, for example
add rate 354 code-used 186 dialed-num 0.3 usd minute fixed line
Hint: multiple data items will be matched to calculate the charge
Names Lookup
AvayaCDR can lookup CDR data items and logs the mapped names to database and Splunk
To enable names lookup, first define the mapping of target data item name to database or Splunk field name, use the
“add paramdict” command for the definition
add paramdict calling-num calling_name
add paramdict called-num called_name
To define the mapping of number to its naming, use the “ add dict” command
add dict * 52001 David
add dict * 50002 John
Extended Logging
Extended Logging is supported by latest version of AvayaCDR, please add/update the following parameters to enable
extended logging.
You can configure AvayaCDR as System Printer for Avaya, thanks Patrick Prevoo sharing the following screens
Follow the section of Writes CDR Data to MySQL or MSSQL Database or Splunk Integration to define the
necessary parameters first
Open the program console and enter the following command to import archived data
The program sends email notification when error occurred. Errors included CDR link down, remote DB down, etc.
Edit the value of parameter tg_emailserverip to define the IP address of your email server.
Edit the value of parameter tg_emailsmtpport to define the SMTP port number of your email server. The default
value is 25.
Edit the value of parameter tg_emailusername to define the username of email agent which is responsible to send
notification emails.
Telnet to localhost and port number 14004, enter username tcpgate and password tcpgate01 to access the
program console. Type genpass in the program console to generate an encrypted password string for the email
agent, copy the string for later use.
Edit the value of parameter tg_emailpasswd to define the password of the email agent. The password should be in
encrypted format, you can use console command genpass to generate the encrypted password.
Edit the value of parameter tg_emailsenderdisplay to define the display name of the email agent.
Edit the value of parameter tg_emailauth to define whether authentication is required between your AvayaCDR
machine and the email server. When your email server trust your machine, set it to false, otherwise set it to true.
Edit the value of parameter tg_emailssl to define whether SSL communication is required for the SMTP session. The
default value is false, set it to true when SSL is required.
Enter the following command in the program console to add your email address
test email
To define dialed number in the blacklist number pattern, enter the following command in the program console
Hint: The dialed-num is the data item name that we defined in the paramcdr table
To define calling number in the blacklist number pattern, enter the following command in the program console
Hint: The calling-num is the data item name that we defined in the paramcdr table
You need to define email function parameters, please refer to section “System Notification Email” for more
information.
To enable this feature, enter the following command in the program console
We have recorded a video for CentOS installation, you can watch the video before the installation
The following is for CentOS 6 only, the commands can be found in the centos6/installation.txt file
The executable file of 32bit version is “avayacdr”, the 64bit version is “avayacdr64”
chkconfig mysqld on
mysql -u root -p
flush privileges;
quit
[AVAYACDRCFG]
Description = MySQL connection to AvayaCDR
Driver = MySQL
Server = localhost
Port = 3306
Database = avayacdr
[AVAYACDRDBCFG]
Description = MySQL connection to AvayaCDR
Driver = MySQL
Server = localhost
Port = 3306
Database = avayacdr
useradd avayacdr
mkdir /usr/local/avayacdr
cp avayacdr /usr/local/avayacdr
chmod +x /usr/local/avayacdr/avayacdr
mkdir -p /var/log/avayacdr/archive/sftp
The following is for RedHat/CentOS 7 64 bit OS only, other Linux distribution is similar
reboot
mysql -u root -p
flush privileges;
quit
[AVAYACDRCFG]
Description = MySQL connection to AvayaCDR
Driver =MySQL ODBC 8.0 ANSI Driver
Server = localhost
Port = 3306
Database = avayacdr
[AVAYACDRDBCFG]
Description = MySQL connection to AvayaCDR
Driver =MySQL ODBC 8.0 ANSI Driver
Server = localhost
Port = 3306
Database = avayacdr
useradd avayacdr
mkdir /usr/local/avayacdr
cp avayacdr64 /usr/local/avayacdr
chmod +x /usr/local/avayacdr/avayacdr64
mkdir -p /var/log/avayacdr/archive/sftp
chmod +x /etc/rc.local
We have recorded a video for Ubuntu installation, you can watch the video before the installation
The following is for Ubuntu 14.04 only, the commands can be found in the ubuntu/installation.txt file
The executable file of 32bit version is “avayacdr”, the 64bit version is “avayacdr64”
mysql -u root -p
flush privileges;
quit
[MySQL]
Description = ODBC for MySQL
Driver = /usr/lib/x86_64-linux-gnu/odbc/libmyodbc.so
Setup = /usr/lib/x86_64-linux-gnu/odbc/libodbcmyS.so
UsageCount = 1
[MySQL]
Description = ODBC for MySQL
Driver = /usr/lib/i386-linux-gnu/odbc/libmyodbc.so
Setup = /usr/lib/i386-linux-gnu/odbc/libodbcmyS.so
UsageCount = 1
[AVAYACDRCFG]
Description = MySQL connection to AvayaCDR
Driver = MySQL
Server = localhost
Port = 3306
Socket = /var/run/mysqld/mysqld.sock
Database = avayacdr
[AVAYACDRDBCFG]
Description = MySQL connection to AvayaCDR
Driver = MySQL
Server = localhost
Port = 3306
Socket = /var/run/mysqld/mysqld.sock
Database = avayacdr
Auto start the daemon after server reboot, add the following before ‘exit 0’ to /etc/rc.local file
rm -f /tmp/avayacdr.log
su avayacdr -c '/usr/local/avayacdr/avayacdr'
Follow this guide to install MySQL ODBC driver “libmyodbc” on Ubuntu 16.04
The following screen dumps are cdr configuration of my site, yours maybe different.
Make sure Reliable Protocol is set to n if you simply use TCP to transmit CDR data
I use standard 5331 port, so I enter the following command in the program console
Share this:
Twitter Facebook
Like
Comments
Peter says:
December 31, 2018 at 7:42 am
Reply
Peter says:
December 31, 2018 at 7:43 am
Reply
Peter says:
January 2, 2019 at 2:48 am
Following your guide video on how to install AvayaCDR. When I arrive at telnet to localhost 14004 I get connection
refused.
What am I doing wrong?
Reply
Peter says:
January 2, 2019 at 5:09 am
I have a valid license key but I am now trying to move from CentOS 6 to 7, but stuck with not being able to
telnet to port 14004
Reply
Peter says:
January 2, 2019 at 5:25 am
upinget says:
January 2, 2019 at 7:06 am
The guide is updated to include CentOS 7.x installation. You need the latest version of AvayaCDR files in
order to work for CentOS 7.x.
This app used to work like a dream since 2014. All of a sudden since last week it has stopped automatically
archiving the file daily. I have restarted, upgraded, checked DB entries, but still no luck. Any advise?
Reply
gerhardvdm2015gerrrie says:
June 11, 2019 at 1:15 pm
This app used to work like a dream since 2014. All of a sudden since last week it has stopped automatically
archiving the file daily. I have restarted, upgraded, checked DB entries, but still no luck. Any advise?
Reply
upinget says:
June 11, 2019 at 1:19 pm
You can ask support if you have purchased the “1 Year Email Support Services”. Please contact
service@upinget.com.
Reply
Leave a Reply
Enter your comment here...
Blog at WordPress.com.