Reference10:Voice Recorder/Setup: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
mNo edit summary
 
(72 intermediate revisions by 9 users not shown)
Line 1: Line 1:
'''This article is preliminary – The product and functions described are not actually available and can be modified or canceled in any moment!'''
The setup is stored in the directory where the recorder is running; therefore more recorders can be started on one single system using different directories. Please note that the setup file is a XML file but AES crypt, so not readable.
The setup is stored in the directory where the recorder is running; therefore more recorders can be started on one single system using different directories. Please note that the setup file is a XML file but AES crypt, so not readable.


Line 11: Line 7:
The software was developed under Win7 but should operate also using windows Server (while the player software is not running without special setups using windows server).
The software was developed under Win7 but should operate also using windows Server (while the player software is not running without special setups using windows server).


The recorder requires reporting Version 10, Build 10043 or higher.
The recorder requires reporting Version 10, Build 1134 or higher.


The recorder requires working Reporting software. The reporting can work on a physical gateway or on a VMware environment (even on a player). See relative articles how to setup the reporting tool.
The recorder requires working Reporting software. The reporting can work on a physical gateway or on a VMware environment (even on a player). See relative articles how to setup the reporting tool.


A standard problem in the recorder setup is the correct link to the PCAP files.  Therefore be precise in the relative Group and read the chapter.


= Recorder Setup =
= Recorder Setup =
Note: To map network drive an application must have administrator rights. Therefor the PC must run with admin credentials or at least the recorder application must be launched with administrator rights.
This decription concerns that screen:  
This decription concerns that screen:  






[[Image:RecSetup01.png]]
[[Image:RecSetup21.png]]


== GROUP GENERAL ==
== General ==


=== Recorder Name ===
=== Recorder Name ===
Line 33: Line 33:
Password of this setup, if blank no password is asked to access to this setup. Please note that this password is also the default password for the player and can therefore be an important security feature.
Password of this setup, if blank no password is asked to access to this setup. Please note that this password is also the default password for the player and can therefore be an important security feature.


=== Start in Taskbar ===
=== Customer Key ===
If checked the recorder will start minimized. Because the recorder has a complete user interface this software is not designed to run as a service. For automatic start-up include the .exe in the auto-start folder.
The recorder encodes the record data files (the XML) using an internal standard key. If in this field a User Key is defined the encoding is done using this key. Therefore also in all players has to be configured this key. Remember that the decoding in the player depends on the local setup of the player. If no user key is defined the standard system key is used. If a user key is found a decoding is tried using that user key, if decoding fails the system key is used, if even that fails no decoding is possible.
 
Therefore once a user encoding key is defined it should not be changed, otherwise the “old” user encoded records cannot be decoded.
 
So if not really required leave this field blank, if you define a user endcoding key think well about it and...


=== Write all operations in logfile ===
WARNING:  do not forget it (there is no way to find out the key).


Do not confuse the logfile with the error logfile, the error log is written in any case and named iREC_Error_Log.  This logfile is called iRECsys_Log.txt and contains all operational tasks like copy of file, converting ecc., not just events like startup or errors. This flag should be switched on just in special situation for example during installation of a new system or in case of error searching, because this file becomes very huge and there is no automatic limitation foreseen.
=== Encode audio ===


=== decrypt Key ===
Audio files are store in clear wave or mp3 format. Any media player could reproduce them, the integrity of those files is controlled from the innovaphone player. The audio file integrity data are stored in the encodet xml file.
The recorder crypt the record data files (the XML) using an internal standard key. If in this field a User Key is defined encryption is done using this key. Therefore also in all player has to be configured this key. The decryption in the player depends on the local setup of the player. If no user key is defined the standard system key is used. If a user key is found a decryption is tried using that user key, if decryption fails the system key is used, if even that fails no decryption is possible.  


Therefore once a user key is defined it could not be changed, otherwise the “old” user encrypted records cannot be decrypt.  
If this option is checked also the audio file will be encoded using the same key used for encoding the xml file (see description in “Customer key”).  


So if not really required leave this field blank, if you define a user key think well about it and  
Encoding cause more CPU load for the recorder and the audio file size is doubled.


WARNING:  do not forget it (there is no way to find out the key again for you).
Once encoded an audio file can be reproduced only with the innovaphone player, if a customer encoding key is configured just if also in the player that key is used. In that case the audio file can be reproduced just with the innovaphne Player using the customer encoding key.  


=== Do not Record empty Files ===
=== Do not Record empty Files ===
Line 55: Line 58:
The recorder can eliminate those files (recommended), but if for some reason you want keep those files (practically you just keep the call information from the reporting) do not flag this option.
The recorder can eliminate those files (recommended), but if for some reason you want keep those files (practically you just keep the call information from the reporting) do not flag this option.


== GROUP PBX ==
=== Save Setup in own directory ===


Communication to the PBX is necessary because of licensing. Like in other applications admin access and SOAP user is required. If no valid connection is up or no valid license found the system switch to the demo mode and will terminate operation after 20 minutes.
See [[Reference10:Voice_Recorder/System_Setup#Multiple_Voice_Recorder_and_Player|here]]


=== IP addr. ===
=== Do NOT save CDR data ===
Indicate the IP Address of the PBX where the Recording licenses are in (the license master). Typical license are displayed in the PBX as “VoiceRecorder2013=1” or similar.
If checked no CDR data are saved, just the audio files. If this option is switched on the player cannot display any additional call info. Also the integrity of the record cannot be assured (unknown) and a manipulation will not be detected. Also Agent notes are not possible and snapshots are disabled and even the original timestamp cannot be displayed on the player.  Note also that a record once stored with this option on cannot be recovered later on.


=== User / Password ===
=== Write clear XML copy, file extension ===
Of the PBX where the license are in. Dafault example: Admin / IP800


=== SOAP USER ===
The connection data and stored in encoded xml file. The innovaphone Player decode those data and display them automatically. On top the player can export the connection data in a clear (not encoded) format. Anyway some customer wants a copy of the connection data on a central point in a clear file format. If this option is marked the recorder will make a copy of the encoded xml file, the name is the same but the extension must be defined. Do not enter the dot in the file extension field.
The SOAP user in the PBX where the licenses are store has to be indicated. Usually it is a dummy user object in the PBX without any registration, for example a user called “SOAP” or “_TAPI_”.


=== HTTPS ===
=== Convert to Mono ===  
Check if the PBX is using HTTPS.
Audio files are stores in stereo format where the external caller is on the left channel while the internal audio is on the right channel. This allows for example to amplify one channel more than the other etc. If this flag is checked the audio file format is converted from stereo to mono and the file size is reduced about 50%.  


=== Agent Group ===
Remember that once converted to mono there is no way to restore the stereo image.


Put all extensions where the recording feature is required in a group (not active) and define here the name of this group.
=== One channel audio ===
If checked just on channel is recorded, typically the left one because there the internal caller is speaking. If requested also only the right caller can be recorded. In most countries recording just the internal caller (recording myself) is permitted without limitations.  


The recorder will read out all extensions during start up and initialize those belonging to this group. A result is that events from these extensions will be transmitted to the recorder. This is mandatory for external applications and a good idea also in general, because it reduce workload (basically because the recorder will “act” just when a call is terminated).
=== Softmigration/Slaves ===


The recorder is able to record even if this field is empty or an extension is not in the group; if a recording file is detected the recorder will ask the reporting if there is a relative CDR record stored and if yes proceed. If not after 5 seconds a new attempt is done. Therefore even after a restart recorded files in between are correctly processed.
(Build 1072 or later)


Please note that there is a different behavior using a native CF or a CF emulated by the Linux application. A native CF will show a file name immediately when recording starts while the Linux OS will show the file just when the call is terminated. Therefore if you use a Linux OS and a user is not in the group even the counter “Channels in recording” is not showing the correct value.
Check if the gateway is looped in between the PSTN and the PBX.


== GROUP EMAIL ALARM (option) ==
Do not mark in all other situaytions.


If the recorder switch on the master alarm a supervisor can be receive an email.
See relative Howto article for details.
The message object is "Voice Recorder " + Name of the recorder + " - ALARM NOTIFICATION", while the body text contains the last master alarm reason and the text "Automatic generated Alarm - Do NOT answer!".


Please note that a mail is sending just one time even if the error is recovered automatically (for example if the reporting is reachable again, then fails, then works etc.). To rearm the email the master alarm must be quit. This is intentionally to avoid tons of emails in case of toggling errors. The rule is that after an alarm email the application has to be checked.
=== Store PCAP files (no pcap2wav) ===


Audio files are saved in the PCAP format; the player is capable to reproduce even pcap files. This flag is mandatory if the recorder is used as a service (see relative article).


=== e-mail account ===
=== MP3 indicator lamp ===


Enter the destination email account for example kwa@innovaphone.com
If a conversion from wave to mp3 audio format is requested some external files and utilities has to be present in the recorder directory. During start up the recorder check if all those requires files are present and if yes mp3 compression is switched on automatically and the lamp is green, if not conversion to mp3 is switched off and the lamp is gray.  


If this field is empty the feature is off.
===Work as http Player server (no recording)===


=== e-mail server ===
(Build 1074 or higher)
Warning: If checked the recorder will be just a http fileserver for the player, no recording is done!


Enter the e-mail server, for example 155.5.23.24
Setup the storage path in the “Storage” tab and the Socket in the communication tab (COM WITH PLAYER). All other parameters are meaningless.


See realtive article.


=== Password ===
=== Work as Pcap to Wave converter (no recording) ===


Not necessary for Exchange but could be.
If flagged this application will detect in the storage subdirectories pcap file and convert them to wave or mp3 and performs the down mix can be done (stereo to mono, one cannel). This operational mode can be switched with the Player server mode if required.


== COM WITH PLAYER (option)==
=== Recording trunk for manual rec+ ann.===
Put in the number of the recording trunk for manual recording with announcement. Leave blank to disable feature.


Communication with the player is an option, indicating a port number it will be switched on from the recorder point of view and request from the player will be processed.
From build 1198.  


Indicate in the “port” field a free communication port while under “own IP address” the IP address of the PC is indicated (not settable here, is the address of this PC, automatically detected).
See [[Reference10:Concept_Voice_Recording_2014#Recording_Modes]] for feature description.


Be carefully in assigning the port number, no duplicate port number should be assigned and the port number must even be free from the server point of view.
=== XML/WQ for manual rec + ann.===


== GROUP REPORTING ==
Put in the number of the XML or WQ for manual recording with announcement. Leave blank to disable feature.


The setup parameter in this panel allows this recording software connect the innovaphone reporting and retrieve the CDR records. The Reporting can run on a gateway or VMware (player or native), there is no difference for this setup.
From build 1198.  


=== IP address ===
See [[Reference10:Concept_Voice_Recording_2014#Recording_Modes]] for feature description.


Enter the IP address of the device where the reporting is running. If you run the reporting on a PC enter the IP address indicated on the VMware virtual machine. If it is not visible enter “ifconfig” in the VMware panel, the address is shown under inet addr. Remember that the address is usually not 127.0.0.1 (even if the reporting is running on the same PC).
=== Start in Taskbar ===
If checked the recorder will start minimized. Because the recorder has a complete user interface this software is not designed to run as a service. For automatic start-up include the .exe in the auto-start folder.


=== User/Password ===
=== Trace ===


Enter the credential to access to the reporting, default is “reporting” and “linux”.  
Do not confuse the logfile with the error logfile, the error log is written in any case and named iREC_Error_Log. This trace/logfile is called iRECsys_Log.txt and contains all operational tasks like copy of file, converting ecc., not just events like startup or errors. This flag should be switched on just in special situation for example during installation of a new system or in case of error searching, because this file becomes very huge and there is no automatic limitation foreseen.


=== HTTPS ===
===Keep PCAP copy===


Check if the reporting is using HTTPS
If checked the recorder leaves a copy of the PCAP file in the sub directory “REC” of the Storage directory (from Build 1191).


===open trace folder ===


=== Path Reporting ===
This link shows you the path to the Log files.  In case of problems please send us always the error log file.


Enter the path to the main screen of the reporting, tipical (and default) is “/apps/innovaphone-reporting/report.php” and no modification is required.
== PBX ==


=== Trunk Access ===
Communication to the PBX is necessary because of licensing and SOAP traffic supervision. Like in other applications admin access and SOAP user is required.


Indicate the trunk access number (tipically "0")
[[Image:RecSetup89.PNG‎]]


=== Swap incoming/outgoing ===


What “incoming” or “outgoing” is depends on the point of view. If clicked “in” and “out” (“i”, “o”) are simply swapped.  
=== IP addr. ===
Indicate the IP Address of the PBX where the Recording licenses are in (the license master). Typical license are displayed in the PBX as “Recording10”.


== COM WITH EXTERNAL APPLICATION (option) ==
=== IP addr. Stby ===
Indicate the IP address of the standby PBX. Leave blank if there is none.


Necessary if the recorder is interfaced to an external application, see reference help in the main window for details. Leave all blank if no external application is required.
=== User / Password ===
Of the PBX where the license are in. Default example: admin / ip800


=== Agend Group ===
=== SOAP USER ===
The SOAP user in the PBX where the licenses are stored has to be indicated. Usually it is a dummy user object in the PBX without any registration, for example a user called “SOAP” or “_TAPI_”.


Put in the name of the agent group indicated in the SOAP object and in all agents.
=== Agent Group ===


=== Send TCP/IP Message – Lounch application string ===
Put all extensions where the recording feature is required in a group (not active) and define here the name of this group.


Select the desired interface mode, the parameter of the not selected one are skipped.
The recorder will read out all extensions during start up and initialize those belonging to this group. A result is that events from these extensions will be transmitted to the recorder.


=== Keep Alive ===
Just extensions being part of that group will be recorded; eventual records of objects not in this group will be deleted. If a record is detected but the relative object is not in that group a message like “Record skipped Agent not in group” is displayed (but no error is triggered).


Indicate in seconds the time period between sending keep alive messages from the recorder to the external application (default=10 seconds).
During start-up the recorder read out the number of license for recording stored in the PBX. Each time a object is in the recording group the number of free licenses is decreased. So the putting in the recording group is limited if the maximum number of license is reached.


=== IP address / Port ===
Please note that in special situations, for example if you have a trunk line object but also a External object (a gateway) to a remote PBX both objects has to be in the group, otherwise calls form the trunk to the gateway will not be recorded.


IP address / Port of the external application server.
=== TAN ===
Build 1167


Be carefully in assigning the port number, no duplicate port number should be assigned and the port number must even be free from the server point of view.
Enter If the the number of the TAN XML (TAN.xml) if TAN feature is active. If you do not record direct on the trunk or the user but on a special GW with prefix also that prefix could be necessary before the number of the XML( typically not). See Concept article for description of the TAN feature.


=== Lounch path ===
=== License Master ===


URL to be launched.
In scenarios with license master and recoding on slave PBX (do not confuse with the feature slave recording, in this case the recorder is just simply a recorder on a slave PBX) the relative licenses are stored in the master PBX, in normal scenarios just leave blank.


==== Use Stored Lic ====
If there are more recorders on one single PBX do not check this flag on the first one and start it. Than then start all other recorder with this flag switched on. Stop the first recorder, set the flag and start it again. In this way just one license per user is required. If the number of licenses change all recorder has to be stopped and the procedure repeated. Build 1164.


== GROUP STORAGE AND BACKUP ==
== Reporting ==
The recorder must get ticket from the innovaphone reporting tool. The Reporting can run on a gateway or VMware (player or native), there is no difference for this setup.


The setup parameter in this panel defines where the voice records are stored. While the Root storage Path is mandatory the backup path is a option.
When the recorder detect a call end (in normal operation because the SOAP will tell that) the recorder will ask the reporting if there is a related record. If yes the recorder check if the user is in the recording group, if yes the call will be processed, if not deleted. If the recording has no record to the call that could be because the recorder is to fast (the record is not jet processed by the reporting) or because this user has no reporting. Therefore the recorder waits and tries later. After 4 trials the recorder gives up and deletes the file.  Such a situation slows down the recorder and therefore all users should have the reporting or just users with reporting should produce records.  


=== Set Root storage path ===
[[Image:RecSetup03.png]]


The path indicated in this option is the working directory where the files after retrieving, naming and converting are written. It is also the directory where the player will look and search for files.
=== IP address ===


If you click the “Set” button a directory dialog box appear, select the directory where you want store the voice records and confirm. You can edit the path even manually, not recommended.
Enter the IP address of the device where the reporting is running.  


=== Set Backup path ===
If you run the reporting on a PC enter the IP address indicated on the VMware virtual machine.


This path is optional; if blank the feature is off.
If not visible enter “ifconfig” in the VMware panel, the address is shown under inet addr. Remember that the address is usually not 127.0.0.1 (even if the reporting is running on the same PC).


If you click the “Set” button a directory dialog box appear, select the directory where you want store a backup of the voice records and confirm. You can edit the path even manually, not recommended.
=== IP addr. Stby ===


Note that files stored in the backup directory are not visible for the player and even the automatic delete is not active. The indicated directory is typically on a NAS or SAN system.
Indicate the IP address of the standby reporting. Leave blank if there is none. Remember that both, active and standby PBX must sent the CDR tickets to both reporting applications and replication between must be switched on.


=== Delete records after moth ===
=== Follow Standby/Active PBX ===
If a switch (and especially an automatic switch back) to the active reporting is required flag this option “Follow Standby/Active PBX”. If this option is not flagged and the active PBX is on again the reporting will not switch back (until the recorder is not started again or the standby reporting fails).


The indicated number of month is the maximum storage depth. The minimum is 2 (so the actual and the last month will always be available), indicating 99 disable the feature. Deleted files cannot be recovered, the name of the deleted files are reported in the syslog.
=== User/Password ===


Note that file in the backup path will never be touched.
Enter the credential to access to the reporting, default is “admin” and “linux”.  


=== Path Reporting ===


== GROUP PCAP ==
Enter the path to the main screen of the reporting, typical (and default) is “/apps/innovaphone-reporting/report.php”. Should work normally, do not modify this setup.


The setup parameter in this panel allows this recording software retrieve the .pcap files. These files can be located on the Compact flash or on a external webdav server. Both cases are supported; please note that storing voce on a CF means low performance and additional workload for the PBX-CPU in case of file copy.
=== Try to reach reporting ===


=== Map Network Drive ===
In this field is shown the result of the input. You should be able to reach the reporting from the PC using a browser and this link.


A virtual drive should be mapped, typical letters are for example “K:” or “H:”. Indicate the letter including the “:”. Once started you will see in the explorer the network drive, if terminated correctly the network drive will be removed and is no longer visible in the explorer.
=== Swap incoming/outgoing ===


=== Detect automatically ===
What “incoming” or “outgoing” is depends on the point of view. If clicked “in” and “out” (“i”, “o”) are simply swapped.


If checked a free drive letter is detected automatically and assigned.  
=== No Reporting Sync ===
If checked the reporting is not synchronized with the voice recorder.
If not checked (default) the voice recorder informs the reporting if a stored recording is deleted and the database of the reporting is updated. Even if a Player delete a record (and has connection to the voice recorder) the recorder send relative information to the recorder, and the recorder again informs the reporting engine.


=== Search Path ===
=== Alarm if no CDR ticket found ===


This field must be blank in case of a CF, in case of a network access to a drive (webdav server) indicate the root or also the complete path (using or not the “Path PCAP” field). Observe that the IP Address is ignored if this field is not empty.
There must be for each recorded call a CDR ticket. If this option is checked an alarm (email) is trigger if there is no ticket. There are two situations where an alarm could trigger: if in online operation an agent (a user in the Agent group, means a user to record) end a call and there is no ticket after a time-out and after start-up where all pcap files buffered must be checked (agent or not) asking the reporting.


=== IP address ===
=== User A to force to incoming ===
(not shown in picture)


Enter the IP address in case of using a CF on a Gateway.
In some cases calls diverted to external numbers should be forced to be signed as incoming calls even they are form a Reporting point of view outgoing once. It is possible to define a caller A, if he did the call the direction will be forces to “I”.
Up to 50 extensions can be defined.(Hotfix 23)


=== User/Password ===


Enter the credential to access to the CF. If using a webdav server the PC where this application is running must have access to the relative directory without credential from the application.
== PCAP ==


=== HTTPS ===
[[Image:RecSetup23.png]]


Check if the CF is using HTTPS
Note that the setup for a compact flash (CF) is different than the one using a webdav!


If you use our CF with the innovaphone application platform the CF is considered as a webdav service.


NOTE: In the picture you see a typical setup for a CF drive where the reporting is running on a VMware, so not on the gateway.


If you use a IPxx10 gateway with the reporting running on the GW and therefore the linux application platform the CF is processed in a slightly different way. Remember that directories are case sensitive using linux , so be carefully in writing.
The recorder downloads the pcap records from the CF or webdav server. See examples Webdav and Compact Flash and observe the different required inputs.  


A typical setup would be this one:
There is no difference between a IPVA or a Webdav server on a hardware device, in the Webdav example you will see the path to an Application Webdav service on a IP810. In the example the pcap are stored in the directoy /MyPCAPpath. Basically also in the gateway or phone the path for the recording is that one.


Map MW drive:  H:
=== Follow Standby/Active PBX===


Search Path: /webdav/
If this flag is on in case of switch to the Standby PBX of the PBX connection also the PCAP path is swapped. If not the path is the same (scenario if for example an external Webdav server on a HA VMware is used).


IP addr. : The one of the application platform
=== User/Admin===


User + Password: the one of the application platform
Credentials for accessing the CF or Webdav server, see examples.


Path PCAP: iREC
=== Path PCAP===


In the example there will be mapped the directory “iREC” on the AP to drive H:
Path to the directory ahere the PCAP are stored. See examples.


If mapping fails you will see an error message in the Log windows, but you will also see that there is no mapped drive if you open the file explorer.
===HTTPS===


Self-explaining


===Delete old PCAP Files===


=== Path PCAP ===
After a number of cycles without response from the reporting the pcap file will be deleted. In a correct working system this should never happen because all users in the PBX should have the reporting. Default value = 500, minimum value=1.


Enter the missing path data to access the directory.
===Delete Pcap without CDR===


=== Try to find PCAP files ===
If no ticket is received after the number of cylices defined the recorder delete the pcap file.  Before doing that he tries to copy the pcap file in the TMP subdirectory of the storage path. At least those files are not lost. If this option is checked no emergency copy is done.


This info panel shows you in real time the resulting path in function of your setup inputs. The path indicated here is the one the software uses to reach the pcap files.
== Storage ==


== TCR (OPTION) ==
The setup parameter in this panel defines where the recorder stores the records. While the Root storage Path is mandatory, the backup path is a option.


If this option is checked the Recorder will work in the Thread call Recording mode (TCR), if not in the standard mode (STD).
=== Set Root storage path ===


If TCR is on records will be saved only if the user define this call by call. That could be done automatically if calls are processed by innovaphone IP-Phones or on demand during a call if innovaphone IP-Phones are used.  
The path indicated in this option is the working directory where the files after retrieving, naming and converting are written. It is also the directory where the player will look and search for files.


But it is also possible to mark a call after the call end for a certain period, after that period the recorded file will be deleted. TCR files contain always the entire voice call from the beginning on , even if the mark is done during or after the call.
If you click the “Set” button a directory dialog box appear, select the directory where you want store the voice records and confirm. You can edit the path even manually, not recommended.


=== Thread Call Recording ===
If destination of the storage you are using is a Webdav folder on the same LAP where you are saving the pcap files, and you want to use a mapped drive (for example F: or N:), mapping the drive using Windows feature will cause writing/reading issues, and Recording won't convert the file in .wav in the storage path.


Indicate the path to the XML file called from user to mark the call. Typically the XML is located at the CF, the example shows that the XML is running in the “TCR” directory of the CF.
To avoid this, use a third party software like "Net Drive" to create the network map.


=== Path TCR ===
=== Delete (records) after moth ===


Indicate the path to the XML file called from user to mark the call. Typically the XML is located at the CF, the example shows that the XML is running in the “TCR” directory of the CF.
The indicated number of month is the maximum storage depth. The minimum is 2 (so the actual and the last month will always be available), indicating 99 disable the feature. Deleted files cannot be recovered, the name of the deleted files are reported in the syslog.  


Note that file in the backup path will never be touched.


=== TCR flag Timeout ===
=== Set Backup path ===


After that timeout calls not marked are deleted. A typical value is 5 Minutes.
This path is optional; if blank the feature is off.


=== XML Number ===
If you click the “Set” button a directory dialog box appear, select the directory where you want store a backup of the voice records and confirm. You can edit the path even manually, not recommended.


If recording is done directly from the phone also the call to the XML marking a call is again a recorded call. Indicate the XML number so all calls to that number will be deleted automatically.
Note that files stored in the backup directory are not visible for the player and even the automatic delete is not active. The indicated directory is typically on a NAS or SAN system.


== Communication ==


This page shows 3 independent container:


= Reporting Setup =
[[Image:RecSetup05.png]]


In the reporting there is no special setup required. If running on a VMware assure that the reporting starts each time with the same IP address.
=== COM WITH EXTERNAL APPLICATION (option) ===


The recorder requires reporting Version 10, Build 10043 or higher.
Necessary if the recorder is interfaced to an external application, see reference help in the main window for details. Leave all blank if no external application is required.


Important: Each extension producing a .pcap file must be included in the reporting!
Do not confuse this section with interfacing reporting or player – these are options for external servers and applications.
If just some extensions should be recorded (and just for them reporting licenses are foreseen) a special setup in the routing is required to assure that just those extension will pass the recording GW.


= Gateway Setup =
=== Lounch application string ===


The voice has to transit a logical GW where the URL “Record to (URL)” is defined. Including or excluding extensions in the routing allow selective recording of just defined extension (or exclude some extensions). Also mapping in the PBX can be used to manipulate call routing. See relative chapters in the Wiki.  
When a record is detected a application can be triggered, see relative description.


Example:
=== Keep Alive ===


[[Image:VR006.png]]
Indicate in seconds the time period between sending keep alive messages from the recorder to the external application (default=10 seconds).


Note: The Media Properties for this GW has to be set to G711A Exclusive! Therefore just this codec can be recorded. The media relay flag has to be switched on to force audio pass-through (and therefore recording) also in case if IP to IP calls.
=== IP address / Port ===


IP address / Port of the external application server.


The CDR0 or CDR1 must point to the reporting tool (Type = “REMOTE-AP”, IP address and Port 80).
Be carefully in assigning the port number, no duplicate port number should be assigned and the port number must even be free from the server point of view.


= IP-Phone setup =
=== Lounch path ===


Voice recording can be done by the Gateway but also directly by the innovaphone IP-Phone.
URL to be launched.


Doing VR using the IP-Phone has the following advantages or disadvantages; it depends on your point of view and the scenario.
=== COM WITH PLAYER ===


- CPU-Load: No CPU power from the PBX is required, a Phone has enough CPU-Power to do that and more, and therefore it becomes an extremely scalable solution. If you do not use an external WebDAV server but a CF anyway the PBX CPU has some load (playing WebDAV server for the Phone)
Communication with the player is an option, indicating a port number, it will be switched on from the recorder point of view and request from the player will be processed.


- All calls on the phone are recorded (not just those crossing a gateway), so even internal calls (basically everything the phone is doing).
Indicate in the “port” field a free communication port while under “own IP address” the IP address of the PC is indicated.


- Al users working on the phone are recorded. This means also that each possible user on the phone must have the reporting license otherwise a call from that user will cause a major alarm.
The recorders try to find out automatically his “own” communication port; that sometimes fails in virtual environments. If the indicated IP address is not correct put in the right one (the on for this application).


- Transferred calls to other extensions are after the call transfer no longer recorded. In case of gateway recording it is different, until the call cross the gateway recording is done.  
Be carefully in assigning the port number, no duplicate port number should be assigned and the port number must even be free from the server point of view.


- If you mix both setup in a scenario you should avoid that a Phone is doing recording and cross a gateway doing recording too. If that happen recording is done in two points and you double for nothing disk space and resources (and confuse everybody).
To switch off this feature leave the port field blank.


- Only innovaphone IP-Phones IP2x2 series and “A”-types (like IP110A, but not IP110) can performing VR directly.
Note: If the recorders works as a fileserver for the player this address and port is the communication socket for the player (Build 1074 or higher).  


Password (build 1136):


If you like or must do recording not in the GW but in the IP-Phone, here is how:
Password for player to access to the recorder if the recorder act as http player server or even if a player want retrieve the recorder status. Leave blank if no password protection is required, if this field is blank eventual password in the player are ignored.


Switch on the recording has to be done in the phone setup file, there is no menu option.


Save the setup file of the phone, open an editor, edit the setup and load the setup up again.
=== GROUP EMAIL ALARM (option) ===


In the setup you will see a row beginning with “config change PHONE SIG”, that is the strategic point to edit.
If the recorder switch on the master alarm a supervisor can be receive an email.
The message object is "Voice Recorder " + Name of the recorder + " - ALARM NOTIFICATION", while the body text contains the last master alarm reason and the text "Automatic generated Alarm - Do NOT answer!".


The command to add is </record http://xx.yy.zz.uu/path>.
Please note that a mail is sending just one time even if the error is recovered automatically (for example if the reporting is reachable again, then fails, then works etc.). To rearm the email the master alarm must be quit. This is intentionally to avoid tons of emails in case of toggling errors. The rule is that after an alarm email the application has to be checked.  


Example:


Your config line is like that:
=== e-mail account ===


config change PHONE SIG /no-intrusion-tone on /prot H323 /gk-addr 172.16.88.98 /e164 37 /tones 0 /lcoder G711A,20, /coder G711A,20,
Enter the destination email account for example kwa@innovaphone.com


while you recording path is on the CF in the directory “RECORDING” and your PBX has the IP-Adress 172.16.88.98. you line must be the following:
If this field is empty the feature is off.


=== e-mail server ===


config change PHONE SIG /no-intrusion-tone on /prot H323 /gk-addr 172.16.88.98 /e164 37 /tones 0 /lcoder G711A,20, /coder G711A,20, /record http://172.16.88.98/DRIVE/CF0/RECORDING
Enter the e-mail server, for example 155.5.23.24




= Player Setup =
=== Password ===


This decription concerns the Player Setup, that or a similar screen:
Not necessary for Exchange but could be.


[[Image:Setup_03.png]]


== GROUP GENERAL ==
== TCR/MRK/RND ==


=== Player Name ===
[[Image:RecSetup06_2.png]]


Define the Name of this Player (use the CN user name is recommended), this name will appear on the main player window but will also identify the user in the central log file. If the Player communicate with the recorder the name is even required, also if the player should be integrated in a external application. If the player interacts with the iQM the name must be the CN (the same name than associated to a agent client) otherwise no recall is possible.  
===Thread Call Recording===
 
If checked the feature TRC is on, otherwise off (default).
=== Player Password ===
If this option is checked the Recorder will work in the Thread call Recording mode (TCR), if not in the standard mode (STD). No mixed mode is possible for one Recorder.
 
If TCR is on records will be saved only if the user define this call by call. That could be done automatically if calls are processed by innovaphone IP-Phones or on demand during a call if innovaphone IP-Phones are used.
If blank no password is required to access to this setup. If a password is defined it must be entered to access this setup. If a password is entered or changed the firmware check if in the indicated recording directory a centralized password is found. If yes this master password must be indicated correctly. This is done to avoid that a user delete the setup file, starts the player and access to the setup indicating the recording path and then being able to manipulate.
But it is also possible to mark a call after the call end for a certain period, after that period the recorded file will be deleted. TCR files contain always the entire voice call from the beginning on , even if the mark is done during or after the call.
 
=== See just number ===
 
The extension number indicated here is copied to the “Filter A” field of the Player. The “filter A” field is disabled automatically and therefore this user will see just “his” recordings. Like in the filter A and B fields also here wildcards can be used. “2?” for example will show all records from extension “20” to “29” while “203” will show just records of extension 203. If leaved blank this feature is off and the “Filter A” field enabled.
 
=== Start in Taskbar ===
 
If checked this application starts-up minimized in the taskbar.
 
=== Player always in foreground ===
 
Hold the player window in foreground. Note that the iQM Recall window can be enabled independently.
 
=== Set recording directory root ===
 
If pressed a directory dialog is opened and the path to the root directory of the recorder can be selected. Only in this way a normal browsing if the recorded records is possible. The root directory is the same one than the on indicated in the recorder (storage path).
 
== GROUP PERMISSIONS ==


=== Allow copy records ===
TCR flag Timeout: After that timeout calls not marked are deleted. A typical value is 5 minutes.


If checked records can be copied, if not the relative button is not shown in the player.
XML Number: If a user marks call he will call a XML, during the call using a 3conference party or after the call calling simply the xml. Of cause that “marking” calls to the xml should not be recorded (but the will if for example the phone has permanent recording on). Indicate the number of the xml, in this way the recorder will delete this “marking” calls.


=== Allow move (cut out) records ===
===Mark Records===
If this option is switched on a user can mark a record. Marked records are visible in the system playlist of the player.
This can be done during conversation (with innovaphone IP-Phone only) or after a record dialing a number. The mechanism is similar to the TCR and in fact there is used the same XML to do that. TCR is switched on no marking is possible (senseless, the user “marks” to record while this feature mark records in normal operation mode).


If checked records can be moved to other directories, if not the relative button is not shown in the player. Note that the move or delete button is never shown on backup directory.
===Delete Records===
Build 1188


=== Allow delete records ===
A user can skip (not store) some conversations. This is done using a similar mechanism used with the TCR. If at the end of the conversation a file is found this record will be deleted. Therefore it works only if this file is created during the conversation. This can be done calling the XML TCRec.xml  (with a feature key, the recording feature of a innvaphone IP Phone, putting the actual call on hold and call the xml or using an external application). The file has to be created in the recording directory/TMP.


If checked the user can delete records, if not the relative button is not shown in the player. Note that the move or delete button is never shown on backup directory.
File format: TCA-XXX_XXX.txt where xxx= the agent number.


=== Write record manipulation Log ===
Example: TCA-1234_1234.txt -> the record of the actual conversation of the agent 1234 will not be recorded.


If checked each copy, move or delete action will be logged in a central log file on the recorder directory (therefore all manipulations are logged in one single log file). Please note that copy move and delete operations are possible just on the working folders where the player is pointing (and typically not in the backup path).
The field itself could be empty, but observe that with Linux at least one character should be in.


=== Use also as Audio player ===
Please note also that the time of the reporting, PBX and webdav must be the same.
The Feature works also with the (old) CF.


If checked free browsing and playing of audio and video files is possible.
If a record is skipped because of theis feature he log will show the message “User Mark Record to delete found TCF=” and the Agent number.


The following file types are supported:
===Random Recording===
If marked conversations are recorded in a random way. Not every conversation will be recorded and recording is uses for example just for a statistic quality check.
There are two parameters that can be combined, a counter of records and a counter of calls for a agent. If for example the “Record in System” counter is set to 5 only each fifth call will be recorded. If the counter “Record for Agent” is set to 2 for a single agent will be recorded each 2nd conversation. Combined for a User it will be unforeseeable if a call will be recorded or not.


Audio: .wav, .mp3, .wma
==Slaves==


Video: .avi, .wmv, .mp4, .mpg
[[Image:RecSetup10.png]]


=== Allow edit record notes ===


If checked near the note text filed a button “Note” is displayed. The user can edit the note field and save the note pressing the note button. If non checked no “Note” button is displayed.
Slave PBX saves the PCAP record in a “far”, own compact flash/webdav while the CDR data are stores and saved in a central reporting.  


=== Allow access to backup files ===
Note: There must be a Master setup, it is not possible to have just slaves, a main site is required where for example the licenses for the recording are stored.


Enable browsing records in the backup directory, move and delete button is hided. The Year and month has to be entered manually, online browsing is not possible (setup search valued and press the search button).
The Slave setup is similar to the PCAP setup (IP-address, User, Password and PCAP- Path). The field “Name” is just to remember the site and select a site form the recorder main interface.


=== Set Backup directory ===
To add a new Slave-site select an empty line in the table, enter all data and press the save button.


If pressed a directory dialog is opened and the path to the backup directory of the recorder can be selected. The backup directory is the same one than the on indicated in the recorder (backup storage path).  
To delete a Slave-site select an existing line, delete the IP-address and press the save button.  


== GROUP RECORDER (option) ==
To modify a Salve site select an existing line, do the modification and press the save button.


=== Recorder Address ===
===Interval (min)===


IP Address from the recorder, could be 172.0.0.1 if running on the same PC, leave blank to switch feature off.
Set a time interval in minutes, shortest value should be 1 (do not enter 0). The slave PBX will be checked just after this timeout is expired.  
Example "20": The recorder check if there are PCAP-Files to import, than waits for 20 minutes before checking again.


=== Recorder Port ===
Note: Slave sites are checked after the main site is worked out. Therefore the main site records have a priority in handling. If for example the main site has continuously records to save the slave routines are delated.


Same port than the one indicated in the recorder setup (com with Player), leave blank if you don’t want that this player communicates with the recorder. Do not enter a value if no connection is desired, because continuous attempts to reach the recorder will occur.
In the interval line a “from” – “to” time span can be defined. Salves will be checked just in this timespan.  
Empty values means “always”.


Do not confuse with the other port numbers in this setup, duplicate port numbers will cause a system crash; the port number must even be free from the PC point of view. 9001 to 9099 could be a good range.
Example 1: “08:00” to “18:00” means “during worktime” while “22:00” to “04:00” means “during the night”.  


== GROUP 1rst party REMOTE CONTROL ==
Note: Also during the timespan the Interval timeout is observed.


As the name says this is the 1rt party remote control interface. If the interfacing with an external application is done using the 3rt party interface this option is not required.
Example: Interval = “5”, “14:00” to “23:00”: the recorder will import data form 14:00 to 23:00, checking each 5 minutes if there are any new records.


=== Port for RC ===
Note: The Recorder interface will show an additional Combo box where a slave site can be selected (showing the name fields). The operator can select a Salve site and force the download of the PCAP files. This is usefully if a specific record should be downloaded immediately.


Port for remote control of the player, the IP address is the one of the PC where this program is executed and could not be modified here.


== PANEL REMOTE CONTROL GENERALS (option) ==
== Audio compression ==


This setup is valid for 1rst and 3rd party remote control. This setup has no effect on normal operation of the player (just for remote control).
The wave audio files are jet G711 compressed but stored as a stereo file in a wave container format. Storing native PCM would requires about the double disk space and is not done. One minute of raw PCM requires about 2 MB while the recorder reduces as default this size at 1MB.  


=== Pop up on play if minimized ===
Unfortunately if switched on audio encoding will double again this size. Even if the customer wants a very long period of storing data or has limited disk space additional compression would be fine. Mp3 compression can be switched on using external 3rd party software.


If checked the player will pop up if minimized in the taskbar and a remote “Play” command is received.
The recorder can pilot automatically external applications called “lame.exe” and “Sox.exe”. Lame is an open source (GPL) tool and even SoX is an open source (GPL) tool (SoX is described also in another Wiki article).


=== Minimized if ejected ===
The recorder use no source code inside and calls the applications like a batch file (of cause providing relative command line info).


If checked and a remote control command eject is received the player is automatically minimized.
Do not “install” lame or SoX, just download the packages and copy the following files in the folder where the recorder is running:


- Sox.exe


== PANEL iQM (option) ==
- Lame.exe


=== Common Name ===
- Libgomp-1.dll


Common Name of the phone associated to the player. Required for recall directly from the recall list (phone goes off hock and will dial out the missed call).
- Pthreadgc2.dll


=== iQM TCP/IP Address and Port ===
- Zlib1.dll


Enter Address and port of the iQM server. Leave blank to switch off the feature. Do not enter data if no iQM server is online, the player will try continuously to reach the iQM server and slow down the system.
During start up the recorder check if those files are in the directory and if yes mp3 coding is on while if just one file is missing encoding is off. If you open the extended view of the recorder an mp3 Led shows you mp3 coding status (on or off).
Do not confuse with the other port numbers in this setup, duplicate port numbers will cause a system crash; the port number must even be free from the PC point of view. 9001 to 9099 could be a good range.


=== Recall list always in foreground ===
With mp3 option on the required file size is reduced about 75% (1 MB will become 250kB).


Hold the recall window in foreground. Note that the player window can be enabled independently.
Note that encoding audio files will double again the file size. Encoding can be done with wave or mp3 files. An encoded audio mp3 file requires anyway just 50% disk space that a clear wave file does.


Note: Latest release from sox there is no more a file called "Pthreadgc2.dll". You have to take release 14.4.1 or earlier.


=== Dock on player ===
= Other Setup =


The (independent) recall window will be docked to the player window.
For Reporting setup, PC setup, Gateway setup, IP-Phone Setup, Multiple Voice Recorder and Player see related Articles (System Setup)


= Related Articles =


“Save and Exit” saved this setup, “Exit (no save)” leaved this setup without saving.
* [[Reference10:Voice_Recorder/System_Setup]]
* [[Reference10:Voice_Player/Setup]]
* [[Reference10:Concept_Voice_Recorder]]


[[Reference10:Player_Voice_Recording]]


== Files ==
[[Howto:Last_Call_Recording]]


The Setup is stored in the directory where the player is running in a file named “iPlayer_Setup.xml”.
[[Howto:Universal_Track_Recording_Tool]]


The file is an xml file but his contend is encrypted and can therefore not be manipulated manually.
[[Howto:Integration_reporting_and_voice_recording]]


The local error and events are stored in a text file named “iPlay_Sys_Log.txt” in the directory where the software is running.
[[Howto:Soft-migration_%28looping_in_a_innovaphone_gateway%29_and_Voice_Recording]]


The last player position on the screen is stored in a file named “PlayerPos.txt”, if this file is missing or deleted the player will start up on the windows default startup position.
[[Howto:Player_over_http]]


Note: If the application starts on a hide position you can track it back to the main window activating the application on the taskbar and press the windows button + shift + left arrow.
[[Howto:Marking_a_record_in_Voicerecording]]


The manual setup of the Player is stored in a file names “iPlayer_User_Setup.xml” in the directory of the application. This file contains the actual values and options, for example the actual selected player volume. If the Player starts up again the user will found his previous selected switched and options.
= Download =
*[http://sox.sourceforge.net/ Download SoX executable for Win32 from sourceforge.net)]
*[http://sourceforge.net/projects/lame/files/lame/3.99/ Download Lame from sourceforge.net]

Latest revision as of 08:48, 4 September 2019

The setup is stored in the directory where the recorder is running; therefore more recorders can be started on one single system using different directories. Please note that the setup file is a XML file but AES crypt, so not readable.

In the headline of the setup the version is displayed, note that the version can be displayed also in the recorder main menu clicking on the innovaphone logo.

The setup described in this page concerns version 10.00 of the Recorder Software.

The software was developed under Win7 but should operate also using windows Server (while the player software is not running without special setups using windows server).

The recorder requires reporting Version 10, Build 1134 or higher.

The recorder requires working Reporting software. The reporting can work on a physical gateway or on a VMware environment (even on a player). See relative articles how to setup the reporting tool.

A standard problem in the recorder setup is the correct link to the PCAP files. Therefore be precise in the relative Group and read the chapter.

Recorder Setup

Note: To map network drive an application must have administrator rights. Therefor the PC must run with admin credentials or at least the recorder application must be launched with administrator rights.

This decription concerns that screen:


RecSetup21.png

General

Recorder Name

This Name is displayed on the headline of the main menu and also reported in the start- up message log file.

Password

Password of this setup, if blank no password is asked to access to this setup. Please note that this password is also the default password for the player and can therefore be an important security feature.

Customer Key

The recorder encodes the record data files (the XML) using an internal standard key. If in this field a User Key is defined the encoding is done using this key. Therefore also in all players has to be configured this key. Remember that the decoding in the player depends on the local setup of the player. If no user key is defined the standard system key is used. If a user key is found a decoding is tried using that user key, if decoding fails the system key is used, if even that fails no decoding is possible.

Therefore once a user encoding key is defined it should not be changed, otherwise the “old” user encoded records cannot be decoded.

So if not really required leave this field blank, if you define a user endcoding key think well about it and...

WARNING: do not forget it (there is no way to find out the key).

Encode audio

Audio files are store in clear wave or mp3 format. Any media player could reproduce them, the integrity of those files is controlled from the innovaphone player. The audio file integrity data are stored in the encodet xml file.

If this option is checked also the audio file will be encoded using the same key used for encoding the xml file (see description in “Customer key”).

Encoding cause more CPU load for the recorder and the audio file size is doubled.

Once encoded an audio file can be reproduced only with the innovaphone player, if a customer encoding key is configured just if also in the player that key is used. In that case the audio file can be reproduced just with the innovaphne Player using the customer encoding key.

Do not Record empty Files

Very short calls (typically seconds) causes very small recording files, so small that a reproduction is not possible (there is practically no audible audio data in).

The recorder can eliminate those files (recommended), but if for some reason you want keep those files (practically you just keep the call information from the reporting) do not flag this option.

Save Setup in own directory

See here

Do NOT save CDR data

If checked no CDR data are saved, just the audio files. If this option is switched on the player cannot display any additional call info. Also the integrity of the record cannot be assured (unknown) and a manipulation will not be detected. Also Agent notes are not possible and snapshots are disabled and even the original timestamp cannot be displayed on the player. Note also that a record once stored with this option on cannot be recovered later on.

Write clear XML copy, file extension

The connection data and stored in encoded xml file. The innovaphone Player decode those data and display them automatically. On top the player can export the connection data in a clear (not encoded) format. Anyway some customer wants a copy of the connection data on a central point in a clear file format. If this option is marked the recorder will make a copy of the encoded xml file, the name is the same but the extension must be defined. Do not enter the dot in the file extension field.

Convert to Mono

Audio files are stores in stereo format where the external caller is on the left channel while the internal audio is on the right channel. This allows for example to amplify one channel more than the other etc. If this flag is checked the audio file format is converted from stereo to mono and the file size is reduced about 50%.

Remember that once converted to mono there is no way to restore the stereo image.

One channel audio

If checked just on channel is recorded, typically the left one because there the internal caller is speaking. If requested also only the right caller can be recorded. In most countries recording just the internal caller (recording myself) is permitted without limitations.

Softmigration/Slaves

(Build 1072 or later)

Check if the gateway is looped in between the PSTN and the PBX.

Do not mark in all other situaytions.

See relative Howto article for details.

Store PCAP files (no pcap2wav)

Audio files are saved in the PCAP format; the player is capable to reproduce even pcap files. This flag is mandatory if the recorder is used as a service (see relative article).

MP3 indicator lamp

If a conversion from wave to mp3 audio format is requested some external files and utilities has to be present in the recorder directory. During start up the recorder check if all those requires files are present and if yes mp3 compression is switched on automatically and the lamp is green, if not conversion to mp3 is switched off and the lamp is gray.

Work as http Player server (no recording)

(Build 1074 or higher) Warning: If checked the recorder will be just a http fileserver for the player, no recording is done!

Setup the storage path in the “Storage” tab and the Socket in the communication tab (COM WITH PLAYER). All other parameters are meaningless.

See realtive article.

Work as Pcap to Wave converter (no recording)

If flagged this application will detect in the storage subdirectories pcap file and convert them to wave or mp3 and performs the down mix can be done (stereo to mono, one cannel). This operational mode can be switched with the Player server mode if required.

Recording trunk for manual rec+ ann.

Put in the number of the recording trunk for manual recording with announcement. Leave blank to disable feature.

From build 1198.

See Reference10:Concept_Voice_Recording_2014#Recording_Modes for feature description.

XML/WQ for manual rec + ann.

Put in the number of the XML or WQ for manual recording with announcement. Leave blank to disable feature.

From build 1198.

See Reference10:Concept_Voice_Recording_2014#Recording_Modes for feature description.

Start in Taskbar

If checked the recorder will start minimized. Because the recorder has a complete user interface this software is not designed to run as a service. For automatic start-up include the .exe in the auto-start folder.

Trace

Do not confuse the logfile with the error logfile, the error log is written in any case and named iREC_Error_Log. This trace/logfile is called iRECsys_Log.txt and contains all operational tasks like copy of file, converting ecc., not just events like startup or errors. This flag should be switched on just in special situation for example during installation of a new system or in case of error searching, because this file becomes very huge and there is no automatic limitation foreseen.

Keep PCAP copy

If checked the recorder leaves a copy of the PCAP file in the sub directory “REC” of the Storage directory (from Build 1191).

open trace folder

This link shows you the path to the Log files. In case of problems please send us always the error log file.

PBX

Communication to the PBX is necessary because of licensing and SOAP traffic supervision. Like in other applications admin access and SOAP user is required.

RecSetup89.PNG


IP addr.

Indicate the IP Address of the PBX where the Recording licenses are in (the license master). Typical license are displayed in the PBX as “Recording10”.

IP addr. Stby

Indicate the IP address of the standby PBX. Leave blank if there is none.

User / Password

Of the PBX where the license are in. Default example: admin / ip800

SOAP USER

The SOAP user in the PBX where the licenses are stored has to be indicated. Usually it is a dummy user object in the PBX without any registration, for example a user called “SOAP” or “_TAPI_”.

Agent Group

Put all extensions where the recording feature is required in a group (not active) and define here the name of this group.

The recorder will read out all extensions during start up and initialize those belonging to this group. A result is that events from these extensions will be transmitted to the recorder.

Just extensions being part of that group will be recorded; eventual records of objects not in this group will be deleted. If a record is detected but the relative object is not in that group a message like “Record skipped Agent not in group” is displayed (but no error is triggered).

During start-up the recorder read out the number of license for recording stored in the PBX. Each time a object is in the recording group the number of free licenses is decreased. So the putting in the recording group is limited if the maximum number of license is reached.

Please note that in special situations, for example if you have a trunk line object but also a External object (a gateway) to a remote PBX both objects has to be in the group, otherwise calls form the trunk to the gateway will not be recorded.

TAN

Build 1167

Enter If the the number of the TAN XML (TAN.xml) if TAN feature is active. If you do not record direct on the trunk or the user but on a special GW with prefix also that prefix could be necessary before the number of the XML( typically not). See Concept article for description of the TAN feature.

License Master

In scenarios with license master and recoding on slave PBX (do not confuse with the feature slave recording, in this case the recorder is just simply a recorder on a slave PBX) the relative licenses are stored in the master PBX, in normal scenarios just leave blank.

Use Stored Lic

If there are more recorders on one single PBX do not check this flag on the first one and start it. Than then start all other recorder with this flag switched on. Stop the first recorder, set the flag and start it again. In this way just one license per user is required. If the number of licenses change all recorder has to be stopped and the procedure repeated. Build 1164.

Reporting

The recorder must get ticket from the innovaphone reporting tool. The Reporting can run on a gateway or VMware (player or native), there is no difference for this setup.

When the recorder detect a call end (in normal operation because the SOAP will tell that) the recorder will ask the reporting if there is a related record. If yes the recorder check if the user is in the recording group, if yes the call will be processed, if not deleted. If the recording has no record to the call that could be because the recorder is to fast (the record is not jet processed by the reporting) or because this user has no reporting. Therefore the recorder waits and tries later. After 4 trials the recorder gives up and deletes the file. Such a situation slows down the recorder and therefore all users should have the reporting or just users with reporting should produce records.

RecSetup03.png

IP address

Enter the IP address of the device where the reporting is running.

If you run the reporting on a PC enter the IP address indicated on the VMware virtual machine.

If not visible enter “ifconfig” in the VMware panel, the address is shown under inet addr. Remember that the address is usually not 127.0.0.1 (even if the reporting is running on the same PC).

IP addr. Stby

Indicate the IP address of the standby reporting. Leave blank if there is none. Remember that both, active and standby PBX must sent the CDR tickets to both reporting applications and replication between must be switched on.

Follow Standby/Active PBX

If a switch (and especially an automatic switch back) to the active reporting is required flag this option “Follow Standby/Active PBX”. If this option is not flagged and the active PBX is on again the reporting will not switch back (until the recorder is not started again or the standby reporting fails).

User/Password

Enter the credential to access to the reporting, default is “admin” and “linux”.

Path Reporting

Enter the path to the main screen of the reporting, typical (and default) is “/apps/innovaphone-reporting/report.php”. Should work normally, do not modify this setup.

Try to reach reporting

In this field is shown the result of the input. You should be able to reach the reporting from the PC using a browser and this link.

Swap incoming/outgoing

What “incoming” or “outgoing” is depends on the point of view. If clicked “in” and “out” (“i”, “o”) are simply swapped.

No Reporting Sync

If checked the reporting is not synchronized with the voice recorder. If not checked (default) the voice recorder informs the reporting if a stored recording is deleted and the database of the reporting is updated. Even if a Player delete a record (and has connection to the voice recorder) the recorder send relative information to the recorder, and the recorder again informs the reporting engine.

Alarm if no CDR ticket found

There must be for each recorded call a CDR ticket. If this option is checked an alarm (email) is trigger if there is no ticket. There are two situations where an alarm could trigger: if in online operation an agent (a user in the Agent group, means a user to record) end a call and there is no ticket after a time-out and after start-up where all pcap files buffered must be checked (agent or not) asking the reporting.

User A to force to incoming

(not shown in picture)

In some cases calls diverted to external numbers should be forced to be signed as incoming calls even they are form a Reporting point of view outgoing once. It is possible to define a caller A, if he did the call the direction will be forces to “I”. Up to 50 extensions can be defined.(Hotfix 23)


PCAP

RecSetup23.png

Note that the setup for a compact flash (CF) is different than the one using a webdav!

If you use our CF with the innovaphone application platform the CF is considered as a webdav service.


The recorder downloads the pcap records from the CF or webdav server. See examples Webdav and Compact Flash and observe the different required inputs.

There is no difference between a IPVA or a Webdav server on a hardware device, in the Webdav example you will see the path to an Application Webdav service on a IP810. In the example the pcap are stored in the directoy /MyPCAPpath. Basically also in the gateway or phone the path for the recording is that one.

Follow Standby/Active PBX

If this flag is on in case of switch to the Standby PBX of the PBX connection also the PCAP path is swapped. If not the path is the same (scenario if for example an external Webdav server on a HA VMware is used).

User/Admin

Credentials for accessing the CF or Webdav server, see examples.

Path PCAP

Path to the directory ahere the PCAP are stored. See examples.

HTTPS

Self-explaining

Delete old PCAP Files

After a number of cycles without response from the reporting the pcap file will be deleted. In a correct working system this should never happen because all users in the PBX should have the reporting. Default value = 500, minimum value=1.

Delete Pcap without CDR

If no ticket is received after the number of cylices defined the recorder delete the pcap file. Before doing that he tries to copy the pcap file in the TMP subdirectory of the storage path. At least those files are not lost. If this option is checked no emergency copy is done.

Storage

The setup parameter in this panel defines where the recorder stores the records. While the Root storage Path is mandatory, the backup path is a option.

Set Root storage path

The path indicated in this option is the working directory where the files after retrieving, naming and converting are written. It is also the directory where the player will look and search for files.

If you click the “Set” button a directory dialog box appear, select the directory where you want store the voice records and confirm. You can edit the path even manually, not recommended.

If destination of the storage you are using is a Webdav folder on the same LAP where you are saving the pcap files, and you want to use a mapped drive (for example F: or N:), mapping the drive using Windows feature will cause writing/reading issues, and Recording won't convert the file in .wav in the storage path.

To avoid this, use a third party software like "Net Drive" to create the network map.

Delete (records) after moth

The indicated number of month is the maximum storage depth. The minimum is 2 (so the actual and the last month will always be available), indicating 99 disable the feature. Deleted files cannot be recovered, the name of the deleted files are reported in the syslog.

Note that file in the backup path will never be touched.

Set Backup path

This path is optional; if blank the feature is off.

If you click the “Set” button a directory dialog box appear, select the directory where you want store a backup of the voice records and confirm. You can edit the path even manually, not recommended.

Note that files stored in the backup directory are not visible for the player and even the automatic delete is not active. The indicated directory is typically on a NAS or SAN system.

Communication

This page shows 3 independent container:

RecSetup05.png

COM WITH EXTERNAL APPLICATION (option)

Necessary if the recorder is interfaced to an external application, see reference help in the main window for details. Leave all blank if no external application is required.

Do not confuse this section with interfacing reporting or player – these are options for external servers and applications.

Lounch application string

When a record is detected a application can be triggered, see relative description.

Keep Alive

Indicate in seconds the time period between sending keep alive messages from the recorder to the external application (default=10 seconds).

IP address / Port

IP address / Port of the external application server.

Be carefully in assigning the port number, no duplicate port number should be assigned and the port number must even be free from the server point of view.

Lounch path

URL to be launched.

COM WITH PLAYER

Communication with the player is an option, indicating a port number, it will be switched on from the recorder point of view and request from the player will be processed.

Indicate in the “port” field a free communication port while under “own IP address” the IP address of the PC is indicated.

The recorders try to find out automatically his “own” communication port; that sometimes fails in virtual environments. If the indicated IP address is not correct put in the right one (the on for this application).

Be carefully in assigning the port number, no duplicate port number should be assigned and the port number must even be free from the server point of view.

To switch off this feature leave the port field blank.

Note: If the recorders works as a fileserver for the player this address and port is the communication socket for the player (Build 1074 or higher).

Password (build 1136):

Password for player to access to the recorder if the recorder act as http player server or even if a player want retrieve the recorder status. Leave blank if no password protection is required, if this field is blank eventual password in the player are ignored.


GROUP EMAIL ALARM (option)

If the recorder switch on the master alarm a supervisor can be receive an email. The message object is "Voice Recorder " + Name of the recorder + " - ALARM NOTIFICATION", while the body text contains the last master alarm reason and the text "Automatic generated Alarm - Do NOT answer!".

Please note that a mail is sending just one time even if the error is recovered automatically (for example if the reporting is reachable again, then fails, then works etc.). To rearm the email the master alarm must be quit. This is intentionally to avoid tons of emails in case of toggling errors. The rule is that after an alarm email the application has to be checked.


e-mail account

Enter the destination email account for example kwa@innovaphone.com

If this field is empty the feature is off.

e-mail server

Enter the e-mail server, for example 155.5.23.24


Password

Not necessary for Exchange but could be.


TCR/MRK/RND

RecSetup06 2.png

Thread Call Recording

If checked the feature TRC is on, otherwise off (default). If this option is checked the Recorder will work in the Thread call Recording mode (TCR), if not in the standard mode (STD). No mixed mode is possible for one Recorder. If TCR is on records will be saved only if the user define this call by call. That could be done automatically if calls are processed by innovaphone IP-Phones or on demand during a call if innovaphone IP-Phones are used. But it is also possible to mark a call after the call end for a certain period, after that period the recorded file will be deleted. TCR files contain always the entire voice call from the beginning on , even if the mark is done during or after the call.

TCR flag Timeout: After that timeout calls not marked are deleted. A typical value is 5 minutes.

XML Number: If a user marks call he will call a XML, during the call using a 3conference party or after the call calling simply the xml. Of cause that “marking” calls to the xml should not be recorded (but the will if for example the phone has permanent recording on). Indicate the number of the xml, in this way the recorder will delete this “marking” calls.

Mark Records

If this option is switched on a user can mark a record. Marked records are visible in the system playlist of the player. This can be done during conversation (with innovaphone IP-Phone only) or after a record dialing a number. The mechanism is similar to the TCR and in fact there is used the same XML to do that. TCR is switched on no marking is possible (senseless, the user “marks” to record while this feature mark records in normal operation mode).

Delete Records

Build 1188

A user can skip (not store) some conversations. This is done using a similar mechanism used with the TCR. If at the end of the conversation a file is found this record will be deleted. Therefore it works only if this file is created during the conversation. This can be done calling the XML TCRec.xml (with a feature key, the recording feature of a innvaphone IP Phone, putting the actual call on hold and call the xml or using an external application). The file has to be created in the recording directory/TMP.

File format: TCA-XXX_XXX.txt where xxx= the agent number.

Example: TCA-1234_1234.txt -> the record of the actual conversation of the agent 1234 will not be recorded.

The field itself could be empty, but observe that with Linux at least one character should be in.

Please note also that the time of the reporting, PBX and webdav must be the same. The Feature works also with the (old) CF.

If a record is skipped because of theis feature he log will show the message “User Mark Record to delete found TCF=” and the Agent number.

Random Recording

If marked conversations are recorded in a random way. Not every conversation will be recorded and recording is uses for example just for a statistic quality check. There are two parameters that can be combined, a counter of records and a counter of calls for a agent. If for example the “Record in System” counter is set to 5 only each fifth call will be recorded. If the counter “Record for Agent” is set to 2 for a single agent will be recorded each 2nd conversation. Combined for a User it will be unforeseeable if a call will be recorded or not.

Slaves

RecSetup10.png


Slave PBX saves the PCAP record in a “far”, own compact flash/webdav while the CDR data are stores and saved in a central reporting.

Note: There must be a Master setup, it is not possible to have just slaves, a main site is required where for example the licenses for the recording are stored.

The Slave setup is similar to the PCAP setup (IP-address, User, Password and PCAP- Path). The field “Name” is just to remember the site and select a site form the recorder main interface.

To add a new Slave-site select an empty line in the table, enter all data and press the save button.

To delete a Slave-site select an existing line, delete the IP-address and press the save button.

To modify a Salve site select an existing line, do the modification and press the save button.

Interval (min)

Set a time interval in minutes, shortest value should be 1 (do not enter 0). The slave PBX will be checked just after this timeout is expired. Example "20": The recorder check if there are PCAP-Files to import, than waits for 20 minutes before checking again.

Note: Slave sites are checked after the main site is worked out. Therefore the main site records have a priority in handling. If for example the main site has continuously records to save the slave routines are delated.

In the interval line a “from” – “to” time span can be defined. Salves will be checked just in this timespan. Empty values means “always”.

Example 1: “08:00” to “18:00” means “during worktime” while “22:00” to “04:00” means “during the night”.

Note: Also during the timespan the Interval timeout is observed.

Example: Interval = “5”, “14:00” to “23:00”: the recorder will import data form 14:00 to 23:00, checking each 5 minutes if there are any new records.

Note: The Recorder interface will show an additional Combo box where a slave site can be selected (showing the name fields). The operator can select a Salve site and force the download of the PCAP files. This is usefully if a specific record should be downloaded immediately.


Audio compression

The wave audio files are jet G711 compressed but stored as a stereo file in a wave container format. Storing native PCM would requires about the double disk space and is not done. One minute of raw PCM requires about 2 MB while the recorder reduces as default this size at 1MB.

Unfortunately if switched on audio encoding will double again this size. Even if the customer wants a very long period of storing data or has limited disk space additional compression would be fine. Mp3 compression can be switched on using external 3rd party software.

The recorder can pilot automatically external applications called “lame.exe” and “Sox.exe”. Lame is an open source (GPL) tool and even SoX is an open source (GPL) tool (SoX is described also in another Wiki article).

The recorder use no source code inside and calls the applications like a batch file (of cause providing relative command line info).

Do not “install” lame or SoX, just download the packages and copy the following files in the folder where the recorder is running:

- Sox.exe

- Lame.exe

- Libgomp-1.dll

- Pthreadgc2.dll

- Zlib1.dll

During start up the recorder check if those files are in the directory and if yes mp3 coding is on while if just one file is missing encoding is off. If you open the extended view of the recorder an mp3 Led shows you mp3 coding status (on or off).

With mp3 option on the required file size is reduced about 75% (1 MB will become 250kB).

Note that encoding audio files will double again the file size. Encoding can be done with wave or mp3 files. An encoded audio mp3 file requires anyway just 50% disk space that a clear wave file does.

Note: Latest release from sox there is no more a file called "Pthreadgc2.dll". You have to take release 14.4.1 or earlier.

Other Setup

For Reporting setup, PC setup, Gateway setup, IP-Phone Setup, Multiple Voice Recorder and Player see related Articles (System Setup)

Related Articles

Reference10:Player_Voice_Recording

Howto:Last_Call_Recording

Howto:Universal_Track_Recording_Tool

Howto:Integration_reporting_and_voice_recording

Howto:Soft-migration_(looping_in_a_innovaphone_gateway)_and_Voice_Recording

Howto:Player_over_http

Howto:Marking_a_record_in_Voicerecording

Download

Retrieved from "https://wiki.innovaphone.com/index.php?title=Reference10:Voice_Recorder/Setup&oldid=53419"