Settings

From VoIPmonitor.org
Revision as of 15:58, 24 May 2013 by Festr (talk | contribs)
Jump to navigation Jump to search

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

CDR Custom header

Since VoIPmonitor sniffer version 7.0RC7 there is new feature Sniffer_configuration#custom_headers allowing storing custom SIP headers to database - view it and search by it. One of additional feature is to use any of custom header as key for pairing CDR together Call_Detail_Record_-_CDR#Legs_by_header


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

Localization

Localization allows creates national localizations for the whole GUI. It is not yet 100% complete. If you find some words you need to localize and it is not possible, please let us know.

There can be unlimited localizations and here is form which creates it:

Settings-localisationform.png

Settings-localisationgrid.png

The red number items signalize how many items are not localized yet - this is useful in case you upgrade the GUI which has some more features which needs to localize.

Changes are effective after you logout/login again.