Difference between revisions of "Settings"

From VoIPmonitor.org
Jump to navigation Jump to search
Line 3: Line 3:
 
If you set id_sensor in /etc/voipmonitor.conf (default is blank) you must create sensor here if you want to download files from sensor like pcap graph wav etc.  
 
If you set id_sensor in /etc/voipmonitor.conf (default is blank) you must create sensor here if you want to download files from sensor like pcap graph wav etc.  
  
*Sensor ID: number defined in /etc/voipmonitor.conf id_sensor = N*Name: name of the sensor*Manager IP, Port: used for fetching data, such as pcap / graph files. Default port is 5029*Remote database parameter: this is useful only in case each sensor writes to different database and you want to find relevant legs in the “Legs by [CID|header]” CDR detail tab. If your sensors writes to the same database leave it blank.  
+
*Sensor ID: number defined in /etc/voipmonitor.conf id_sensor = N
 +
*Name: name of the sensor
 +
*Manager IP, Port: used for fetching data, such as pcap / graph files. Default port is 5029
 +
*Remote database parameter: this is useful only in case each sensor writes to different database and you want to find relevant legs in the “Legs by [CID|header]” CDR detail tab. If your sensors writes to the same database leave it blank.  
  
 
[[File:settings-sensors.png]]
 
[[File:settings-sensors.png]]
Line 43: Line 46:
 
*National prefix,2,3 - This is for classifying calls to national and international calls. This classification is used in Active calls section.
 
*National prefix,2,3 - This is for classifying calls to national and international calls. This classification is used in Active calls section.
 
*Max national number length - Calls with more digits will be international regardless on prefix
 
*Max national number length - Calls with more digits will be international regardless on prefix
*Date format - Date format with default Y-m-d. http://www.php.net/manual/en/function.date.php*Time format - Time format with default G:i:s. http://www.php.net/manual/en/function.date.php*Week start
+
*Date format - Date format with default Y-m-d. http://www.php.net/manual/en/function.date.php
 +
*Time format - Time format with default G:i:s. http://www.php.net/manual/en/function.date.php
 +
*Week start
 
== Intervals ==
 
== Intervals ==
 
[[File:settings-sysintervals.png]]
 
[[File:settings-sysintervals.png]]
*Default CDR interval - How many days will be filtered in CDR section by default*Default Legs by CID interval - Find all related calls which starts +- internal - default 5 seconds*Default Legs by header interval - Find all related calls which starts +- internal - default 5 seconds
+
*Default CDR interval - How many days will be filtered in CDR section by default
 +
*Default Legs by CID interval - Find all related calls which starts +- internal - default 5 seconds
 +
*Default Legs by header interval - Find all related calls which starts +- internal - default 5 seconds
 
== EMAIL HTTP REFERER ==
 
== EMAIL HTTP REFERER ==
 
[[File:settings-sysemailhttpreferer.png]]
 
[[File:settings-sysemailhttpreferer.png]]
  
*DEFAULT_EMAIL_FROM - Default email in From header*Disable email plain text - Some mailers (outlook 2003) does not like plain text and show only plain text part of email messages. If you do not see HTML part enable this option
+
*DEFAULT_EMAIL_FROM - Default email in From header
 +
*Disable email plain text - Some mailers (outlook 2003) does not like plain text and show only plain text part of email messages. If you do not see HTML part enable this option
 
== GEOIP ==
 
== GEOIP ==
 
[[File:settings-sysgeoip.png]]
 
[[File:settings-sysgeoip.png]]
*Use GEOIP local database - Enable or disable use of internal GEOIP database (if loaded)*GEOIP maxmind.com KEY - Personal key for maxmind.com geoip service*GEOIP ipinfodb.com KEY - Personal key for ipinfodb.com
+
*Use GEOIP local database - Enable or disable use of internal GEOIP database (if loaded)
 +
*GEOIP maxmind.com KEY - Personal key for maxmind.com geoip service
 +
*GEOIP ipinfodb.com KEY - Personal key for ipinfodb.com
 
== Advanced ==
 
== Advanced ==
 
[[File:settings-sysadvanced.png]]
 
[[File:settings-sysadvanced.png]]
  
*Enable CDR group panel - Enable/Disable CDR group bottom panel*ENABLE_CDR_FORCE_INDEX_CALLDATE - force index all queries by calldate column which can help on unoptimized mysql installations. Enable it only in case you know exactly what you are doing.*Enable database IP reverse lookup - If enabled in CDR IP addresses will be named by internal IP database lookup table*Enable DNS reverse lookup - If enabled in CDR IP address will be named by DNS*Enable database number lookup - If enabled in CDR tel. numbers will be named by internal prefix database lookup table*Disable rtpfirstleg param - Disable --rtp-firstleg when decoding audio from pcap. - disable only in case you know what you are doing.*Disable URL wav protection - if true, user is not checked against valid session when downloading WAV. Suitable for downloading WAV outside voipmonitor GUI. If you need to secure it, you can set WAV key*WAV download key - KEY used to download WAV files without user/pass authentication*Hide SIP domain in CDR - Hide SIP domain in CDR*Hide live play - Hide live play in active calls*Hide WAV play - Hide play buttons in CDR*Upload sniffer conf path - Path to sniffer voipmonitor.conf which is used when uploading pcap files.*CDR share key - String used to generate unique hashes in URL for sharing cdr
+
*Enable CDR group panel - Enable/Disable CDR group bottom panel
 +
*ENABLE_CDR_FORCE_INDEX_CALLDATE - force index all queries by calldate column which can help on unoptimized mysql installations. Enable it only in case you know exactly what you are doing.
 +
*Enable database IP reverse lookup - If enabled in CDR IP addresses will be named by internal IP database lookup table
 +
*Enable DNS reverse lookup - If enabled in CDR IP address will be named by DNS
 +
*Enable database number lookup - If enabled in CDR tel. numbers will be named by internal prefix database lookup table
 +
*Disable rtpfirstleg param - Disable --rtp-firstleg when decoding audio from pcap. - disable only in case you know what you are doing.
 +
*Disable URL wav protection - if true, user is not checked against valid session when downloading WAV. Suitable for downloading WAV outside voipmonitor GUI. If you need to secure it, you can set WAV key
 +
*WAV download key - KEY used to download WAV files without user/pass authentication
 +
*Hide SIP domain in CDR - Hide SIP domain in CDR
 +
*Hide live play - Hide live play in active calls
 +
*Hide WAV play - Hide play buttons in CDR
 +
*Upload sniffer conf path - Path to sniffer voipmonitor.conf which is used when uploading pcap files.
 +
*CDR share key - String used to generate unique hashes in URL for sharing cdr

Revision as of 16:47, 15 May 2013

Sensors

If you set id_sensor in /etc/voipmonitor.conf (default is blank) you must create sensor here if you want to download files from sensor like pcap graph wav etc.

  • Sensor ID: number defined in /etc/voipmonitor.conf id_sensor = N
  • Name: name of the sensor
  • Manager IP, Port: used for fetching data, such as pcap / graph files. Default port is 5029
  • Remote database parameter: this is useful only in case each sensor writes to different database and you want to find relevant legs in the “Legs by [CID|header]” CDR detail tab. If your sensors writes to the same database leave it blank.

Settings-sensors.png

CDR charts

Predefined charts used in CDR detail charts section

Settings-cdrcharts.png

Load GeoIP data

Loads GeoIP data into internal database which is then used for CDR detail map.

Settiongs-loadgeoip.png

System configuration

Basic

Settings-sysbasic.png

  • WEB URL - URL which will be used for hypertext links. For example in email alerts
  • sniffer data path - Directory path to the sniffer data (default /var/spool/voipmonitor)
  • default sensor hostname - default sniffer sensor hostname (localhost). If you have more sensors define it in settings -> sensors
  • default sensor TCP port - default sniffer sensor port (5029)

Database

Databse settings

Settings-sysdb.png

National

Settings-sysnational.png

  • Timezone - set correct timezone according to your Country / Town
  • National prefix,2,3 - This is for classifying calls to national and international calls. This classification is used in Active calls section.
  • Max national number length - Calls with more digits will be international regardless on prefix
  • Date format - Date format with default Y-m-d. http://www.php.net/manual/en/function.date.php
  • Time format - Time format with default G:i:s. http://www.php.net/manual/en/function.date.php
  • Week start

Intervals

Settings-sysintervals.png

  • Default CDR interval - How many days will be filtered in CDR section by default
  • Default Legs by CID interval - Find all related calls which starts +- internal - default 5 seconds
  • Default Legs by header interval - Find all related calls which starts +- internal - default 5 seconds

EMAIL HTTP REFERER

Settings-sysemailhttpreferer.png

  • DEFAULT_EMAIL_FROM - Default email in From header
  • Disable email plain text - Some mailers (outlook 2003) does not like plain text and show only plain text part of email messages. If you do not see HTML part enable this option

GEOIP

Settings-sysgeoip.png

  • Use GEOIP local database - Enable or disable use of internal GEOIP database (if loaded)
  • GEOIP maxmind.com KEY - Personal key for maxmind.com geoip service
  • GEOIP ipinfodb.com KEY - Personal key for ipinfodb.com

Advanced

Settings-sysadvanced.png

  • Enable CDR group panel - Enable/Disable CDR group bottom panel
  • ENABLE_CDR_FORCE_INDEX_CALLDATE - force index all queries by calldate column which can help on unoptimized mysql installations. Enable it only in case you know exactly what you are doing.
  • Enable database IP reverse lookup - If enabled in CDR IP addresses will be named by internal IP database lookup table
  • Enable DNS reverse lookup - If enabled in CDR IP address will be named by DNS
  • Enable database number lookup - If enabled in CDR tel. numbers will be named by internal prefix database lookup table
  • Disable rtpfirstleg param - Disable --rtp-firstleg when decoding audio from pcap. - disable only in case you know what you are doing.
  • Disable URL wav protection - if true, user is not checked against valid session when downloading WAV. Suitable for downloading WAV outside voipmonitor GUI. If you need to secure it, you can set WAV key
  • WAV download key - KEY used to download WAV files without user/pass authentication
  • Hide SIP domain in CDR - Hide SIP domain in CDR
  • Hide live play - Hide live play in active calls
  • Hide WAV play - Hide play buttons in CDR
  • Upload sniffer conf path - Path to sniffer voipmonitor.conf which is used when uploading pcap files.
  • CDR share key - String used to generate unique hashes in URL for sharing cdr