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 |