Help Index Home > File > Configure > Extra > Preferences

Additional preference settings

Each line in the configuration text file /usr/local/inmsf/etc/config/global.prefs has the format:

  variable = value

with the semicolon character ';' being used to indicate comment fields.

These settings are only read when a process starts. Some processes run continuously, so they may have to be restarted before a new setting can take effect. The File>Control page allows either the data collection or the web server processes to be restarted. In the table below, the "Restart" column indicates which restart (if any) is required:

Setting Default Value Description Restart
KeepActiveMinutes 480 (8 hours) How long to keep the per-interface traffic database (rtcounters and rttraffic)
KeepHistoryDays 35 How long to keep the consolidated traffic database (historycounters, historyflows and events)
KeepFreeMBytes 400 The oldest history days will be deleted automatically if the disk partition fills.
dns.localsuffix <not set> If set to ".mycompany.com" then DNS names with this suffix will be displayed in their short form (with this suffix removed). web server
SNMPCounterPollInterval  30 (seconds) Unless overridden in the XML configuration file, this is the polling interval used to poll interface counters from an agent via SNMP. data collection and web server
SFlowSamplePort  6343 UDP port to listen on for sFlow® data collection and web server
IPFIXPort  4739 UDP port to listen on for IPFIX data collection and web server
NetFlowPort  9985 UDP port to listen on for NetFlow™ (version 1,5,7 or 9) data collection and web server
LFAPPort  3145 TCP port to listen on for Riverstone LFAP (version 5) data collection and web server
SFlowMIBSamplePort  26343 UDP port used for sFlow MIB data (configured automatically via SNMP) data collection and web server
XRMONSamplePort  19985 UDP port used for Hewlett Packard XRMON data (configured automatically via SNMP) data collection and web server
chart.trend.truncate  5 Number of legend entries (colors) in Traffic>Trend chart web server
chart.trend.height  350 (pixels) Height of Traffic>Trend chart web server
chart.circles.truncate  100 Maximum number of lines (top flows) displayed in Traffic>Circles chart web server
chart.circles.height  450 (pixels) Height of Traffic>Circles chart web server
event.syslog  <not set> Set to YES to configure the default event script to log events to syslog
event.mail  <not set> Set to an email address to configure the default event script to send events by email. sendmail(1) must be configured on the server for this to work. See /usr/local/inmsf/scripts/eventScript
event.trap  <not set> Set to the IP address of an SNMP trap listener to configure the default event script to send events as SNMP traps. The net-snmp-utils rpm package must be installed. The traps sent by the default event script are described by the trapMIB specification
event.severity  2 This integer controls which events are reported to syslog, mail or trap. Choices are 1 = All , 2 = Warn/Severe , 3 = Severe only .
session.timeout  30 (minutes) If your session is idle for this long, then it will terminate and you will have to log in again.
report.readurl.protocol.http  YES Set to NO to disable script access to URLs starting with "http". web server
report.readurl.protocol.https  YES Set to NO to disable script access to URLs starting with "https". web server
report.readurl.protocol.file  NO Set to YES to allow script access to URLs starting with "file". web server
interface.name  ifName Controls how interfaces are named. Valid settings are ifName, ifAlias, ifDescr or ifIndex (or a comma separated list of these in order of preference). web server
link.agent.label.0  <not set> Specify the name of the a link to be added to the Search > Agent/Interface page. web server
link.agent.url.0  <not set> Specify a link to be added to the Search > Agent/Interface page. The token {0} in the URL string will be replaced by the agent IP address. web server
link.interface.label.0  <not set> Specify the name of the a link to be added to the Search > Agent/Interface page. web server
link.interface.url.0  <not set> Specify a link to be added to the Search > Agent/Interface page. The token {0} in the URL string will be replaced by the agent IP address and the token {1} will be replaced by the ifIndex. web server
link.host.ipv4.label.0  <not set> Specify the name of the a link to be added to the Search > Host page. web server
link.host.ipv4.url.0  <not set> Specify a link to be added to the Search > Host page. The token {0} in the URL string will be replaced by the host IP address. web server
link.host.mac.label.0  <not set> Specify the name of the a link to be added to the Search > Host page. web server
link.host.mac.url.0  <not set> Specify a link to be added to the Search > Host page. The token {0} in the URL string will be replaced by the host MAC address. web server
link.protocol.label.0  <not set> Specify the name of the a link to be added to the Search > Protocol page. web server
link.protocol.url.0  <not set> Specify a link to be added to the Search > Protocol page. The token {0} in the URL string will be replaced by the protocol and the {1} token will be replaced by the port number. web server
report.snmp.allow  YES Allow snmp requests to be made from report templates and scripts. web server
search.snmp.allow  YES Allow snmp requests to be made in Search > Host. web server