NMIS Configuration
- Mark Unwin
- Jonathan O'Brien (Unlicensed)
- Keith Sinclair (Deactivated)
NMIS Configuration
This page contains several sections for both NMIS8 and NMIS9.
We have detailed a set of commonly configured attributes that most users will want to consider.
We also have a very detailed list of every option available that most users will not need to use, unless they have a specific use-case.
The NMIS8 configuration items are stored in a text file /usr/local/nmis8/conf/Config.nmis.
The NMIS9 configuration items are stored in a text file /usr/local/nmis9/conf/Config.nmis.
Common Settings to Consider Adjusting for NMIS8
Below are settings customers commonly change, typically authentication and email settings.
Authentication
authentication | auth_cookie_flavour | nmis | nmis, omk | User Management in NMIS8 | To configure NMIS to share authentication cookies with Opmantek Applications, it is necessary that you change the configuration item auth_cookie_flavour from the default "nmis" to "omk" and set the configuration item auth_web_key to the same value as the OMK application's first omkd_secrets configuration. |
authentication | auth_default_groups | As above | When accessing NMIS, you have a choice on how to handle authenticated users who do not have authorisations defined, you can reject them, or you can allow them default access. This is so that you do not have to define every user in the system if the authentication system is providing a reduced list of users, to have the users become an operator or guest by default and be able to see all groups of devices, the following would apply. 'auth_default_privilege' => 'guest', 'auth_default_groups' => 'all'. To prevent default authorisation, simply define them as blank, which is the default in the NMIS8 Install configuration. | ||
authentication | auth_default_privilege | As above | As above for auth_default_groups | ||
authentication | auth_ldap_context | ou=people,dc=opmantek,dc=com | As above | The base of context to attempt to bind to | |
authentication | auth_ldap_server | 192.168.1.5 | <ip> | As above | The LDAP server to use for autheitcation. |
authentication | auth_method_1 | htpasswd | As above | In the NMIS configuration you can configure multiple methods which are used for auth failure, so if ms-ldap fails, it will fail back to htpasswd for example. This means if you set auth_method_1 to be ldap and auth_method_2 to be htpasswd, and login with the default NMIS credentials (and you have not changed the password), the authentication for LDAP will fail, and then authentication with the users.dat will succeed and the user will be logged in. | |
authentication | auth_method_2 | As above | As above for auth_method_1 | ||
authentication | auth_ms_ldap_base | dc=corp,dc=opmantek,dc=com | As above | The LDAP Base to search from | |
authentication | auth_ms_ldap_dn_acc | nmis | As above | The DomainName\account to bind with | |
authentication | auth_ms_ldap_dn_psw | XXXXXXXXX | As above | The password for the above | |
authentication | auth_ms_ldap_server | 192.168.1.5 | <ip> | As above | The Active Directory server to use for authentication |
authentication | auth_sso_domain | As above | |||
authentication | auth_user_name_regex | [\w \-\.\@\`\']+ | <regex> | As above |
mail_combine | true | true, false | NMIS8 Email | ||
mail_domain | yourdomain.com | <domain> | As above | ||
mail_from | nmis@yourdomain.com | <email> | As above | ||
mail_from_reports | nmis-reports@yourdomain.com | <email> | As above | ||
mail_password | <password> | As above | |||
mail_server | 127.0.0.1 | <ip> | As above | ||
mail_server_ipproto | ipv4, ipv6 | As above | |||
mail_server_port | 25 | <integer> | As above | ||
mail_use_tls | false | true, false | As above | ||
mail_user | your mail username | <username> | As above |
Globals
globals | node_name_rule | ||||
globals | threshold_falling_reset_dampening | ||||
globals | threshold_rising_reset_dampening | ||||
globals | uuid_add_with_node | Using Unique Identifiers (UUID) for NMIS Nodes |
System
system | demote_faulty_nodes | true | true, false | For nodes that have been non-collectable for a long time NMIS offers to attempt collect operations only once every 24 hours. | |
system | display_status_summary | false | true, false | NMIS Node Status | |
system | fastping_interval | Added in NMIS 9.0.3 | |||
system | fastping_target_interval | Added in NMIS 9.0.3 | |||
system | graph_cache_maxage | ||||
system | nettype_list | wan,lan,vpn,man,san,voice,default | <list> | ||
system | network_viewNode_field_list | status,outage,sysName,host_addr,host_addr_backup, group,customer,location,businessService,serviceStatus, nodeType,nodeModel,polling_policy,sysUpTime,sysLocation, sysContact,sysDescr,ifNumber,lastUpdate, nodeVendor,sysObjectName,roleType,netType | <list> | Adding or Rearranging fields in the Node Details View | Controls which fields are shown in the Node View and in what order. |
system | node_status_uses_status_summary | false | true, false | NMIS Node Status | |
system | non_stateful_events | Node Configuration Change, Node Reset, NMIS runtime exceeded | <list> | ||
system | os_username | ||||
system | polling_interval_factor | 0.9 | <decimal> | Fraction of the polling interval after which node is considered for next poll | |
system | threshold_period-interface | -15 minutes | Added in NMIS 8.5 | ||
system | threshold_period-pkts | -15 minutes | Added in NMIS 8.5 | ||
system | threshold_period-pkts_hc | -15 minutes | Added in NMIS 8.5 |
Detailed NMIS8 Configuration
Below are detailed options for NMIS8 configuration.
Configuration settings in the Config.nmis file are broken into sections.
Section | Name | Original Value | Possible Values | Description | |
---|---|---|---|---|---|
authentication | auth_banner_title | NMIS8 | |||
authentication | auth_buttons_visible | true | true, false | ||
authentication | auth_cookie_flavour | nmis | nmis, omk | ||
authentication | auth_cw_company_id | ||||
authentication | auth_cw_private_key | ||||
authentication | auth_cw_public_key | ||||
authentication | auth_cw_server | ||||
authentication | auth_debug | ||||
authentication | auth_debug_remote_addr | ||||
authentication | auth_default_groups | ||||
authentication | auth_default_privilege | ||||
authentication | auth_expire | \+30min | |||
authentication | auth_htpasswd_encrypt | crypt | |||
authentication | auth_htpasswd_file | <nmis_conf>/users.dat | |||
authentication | auth_ldap_attr | ||||
authentication | auth_ldap_context | ou=people,dc=opmantek,dc=com | |||
authentication | auth_ldap_server | 192.168.1.5 | |||
authentication | auth_ldaps_server | ||||
authentication | auth_lockout_after | 0 | |||
authentication | auth_login_motd | Authentication required: Please log in with your appropriate username and password in order to gain access to this system | |||
authentication | auth_login_title | NMIS8 login | |||
authentication | auth_method_1 | htpasswd | |||
authentication | auth_method_2 | ||||
authentication | auth_method_3 | ||||
authentication | auth_ms_ldap_attr | sAMAccountName | |||
authentication | auth_ms_ldap_base | dc=corp,dc=opmantek,dc=com | |||
authentication | auth_ms_ldap_debug | false | true, false | ||
authentication | auth_ms_ldap_dn_acc | nmis | |||
authentication | auth_ms_ldap_dn_psw | XXXXXXXXX | |||
authentication | auth_ms_ldap_server | 192.168.1.5 | |||
authentication | auth_ms_ldaps_server | ||||
authentication | auth_radius_secret | ||||
authentication | auth_radius_server | ||||
authentication | auth_sso_domain | ||||
authentication | auth_user_name_regex | [\w \-\.\@\`\']+ | <regex> | Deprecated | |
authentication | auth_web_key | Please Change Me! | |||
css | jquery_jdmenu_css | <menu_url_base>/css/jquery.jdMenu.css | <relative url> | ||
css | jquery_ui_css | <menu_url_base>/css/smoothness/jquery-ui-1.9.2.custom.css | <relative url> | ||
css | styles | <menu_url_base>/css/dash8.css | <relative url> | ||
daemons | daemon_fping_active | true | true, false | ||
daemons | daemon_fping_dns_cache | true | true, false | ||
daemons | daemon_fping_filename | fpingd.pl | |||
daemons | daemon_fping_run_escalation | true | true, false | ||
daemons | daemon_ipsla_active | false | true, false | ||
daemons | daemon_ipsla_filename | ipslad.pl | |||
daemons | logwatch | false | true, false | ||
directories | <nmis_base> | /usr/local/nmis8 | <filepath> | ||
directories | <menu_base> | <nmis_base>/menu | <relative filepath> | ||
directories | <nmis_admin> | <nmis_base>/admin | <relative filepath> | ||
directories | <nmis_backups> | <nmis_data>/backups | <relative filepath> | ||
directories | <nmis_bin> | <nmis_base>/bin | <relative filepath> | ||
directories | <nmis_cgi> | <nmis_base>/cgi-bin | <relative filepath> | ||
directories | <nmis_conf> | <nmis_base>/conf | <relative filepath> | ||
directories | <nmis_data> | <nmis_base> | <relative filepath> | ||
directories | <nmis_logs> | <nmis_base>/logs | <relative filepath> | ||
directories | <nmis_menu> | <nmis_base>/menu | <relative filepath> | ||
directories | <nmis_models> | <nmis_base>/models | <relative filepath> | ||
directories | <nmis_var> | <nmis_data>/var | <relative filepath> | ||
directories | config_logs | <nmis_logs>/config | <relative filepath> | ||
directories | database_root | <nmis_data>/database | <relative filepath> | ||
directories | json_logs | <nmis_logs>/json | <relative filepath> | ||
directories | log_root | <nmis_logs> | <relative filepath> | ||
directories | mib_root | <nmis_base>/mibs | <relative filepath> | ||
directories | plugin_root | <nmis_conf>/plugins | <relative filepath> | ||
directories | report_root | <nmis_base>/htdocs/reports | <relative filepath> | ||
directories | script_root | <nmis_conf>/scripts | <relative filepath> | ||
directories | web_root | <nmis_base>/htdocs | <relative filepath> | ||
mail_combine | true | true, false | |||
mail_domain | yourdomain.com | <domain> | |||
mail_from | nmis@yourdomain.com | <email> | |||
mail_from_reports | nmis-reports@yourdomain.com | <email> | |||
mail_password | <password> | ||||
mail_server | 127.0.0.1 | <ip> | |||
mail_server_ipproto | ipv4, ipv6 | If unset, defaults to ipv4. | |||
mail_server_port | 25 | <integer> | |||
mail_use_tls | false | true, false | |||
mail_user | your mail username | <username> | |||
escalation | escalate0 | 0 | <integer> | Seconds | |
escalation | escalate1 | 300 | <integer> | Seconds | |
escalation | escalate10 | 86400 | <integer> | Seconds | |
escalation | escalate2 | 900 | <integer> | Seconds | |
escalation | escalate3 | 1800 | <integer> | Seconds | |
escalation | escalate4 | 2400 | <integer> | Seconds | |
escalation | escalate5 | 3600 | <integer> | Seconds | |
escalation | escalate6 | 7200 | <integer> | Seconds | |
escalation | escalate7 | 10800 | <integer> | Seconds | |
escalation | escalate8 | 21600 | <integer> | Seconds | |
escalation | escalate9 | 43200 | <integer> | Seconds | |
expiration | purge_backup_after | 30*86400 | backup files | ||
expiration | purge_event_after | 7*86400 | historic, closed events | ||
expiration | purge_graphcache_after | 3600 | cached graph images | ||
expiration | purge_jsonlog_after | 30*86400 | json log files | ||
expiration | purge_outages_after | 86400 | past non-recurring outages | ||
expiration | purge_reports_after | 365*86400 | html reports | ||
expiration | purge_rrd_after | 30*86400 | unused rrd files older than 30 days | ||
expiration | purge_state_after | 30*86400 | unused nmis state files | ||
files | auth_log | <nmis_logs>/auth.log | <filepath> | ||
files | company_logo | <filepath> | |||
files | event_log | <nmis_logs>/event.log | <filepath> | ||
files | events | <cgi_url_base>/events.pl | <filepath> | ||
files | fpingd_log | <nmis_logs>/fpingd.log | <filepath> | ||
files | ipsla | <cgi_url_base>/ipsla.pl | <filepath> | ||
files | ipsla_log | <nmis_logs>/ipsla.log | <filepath> | ||
files | logs | <cgi_url_base>/logs.pl | <filepath> | ||
files | network | <cgi_url_base>/network.pl | <filepath> | ||
files | nmis | <cgi_url_base>/nmiscgi.pl | <filepath> | ||
files | nmis_favicon | <menu_url_base>/img/nmis_favicon.png | <filepath> | ||
files | nmis_help | <menu_url_base>/img/question.png | <filepath> | ||
files | nmis_home | <menu_url_base>/img/home.png | <filepath> | ||
files | nmis_log | <nmis_logs>/nmis.log | <filepath> | ||
files | nmis_slave | <menu_url_base>/img/slave.png | <filepath> | ||
files | node | <cgi_url_base>/node.pl | <filepath> | ||
files | outage_file | <nmis_conf>/outage.dat | <filepath> | ||
files | polling_log | <nmis_logs>/polling.log | <filepath> | ||
files | rrddraw | <cgi_url_base>/rrddraw.pl | <filepath> | ||
files | syslog_log | <nmis_logs>/cisco.log | <filepath> | ||
globals | global_collect_Description | (CNOC|Collection) | |||
globals | global_collect_ifDescr | ||||
globals | global_events_bandwidth | true | true, false | ||
globals | global_nocollect_Description | ||||
globals | global_nocollect_ifDescr | ||||
globals | global_nocollect_ifOperStatus | ||||
globals | global_nocollect_ifType | ||||
globals | global_nocollect_interface_down_days | 30 | <integer> | ||
globals | global_nocollect_noDescription | ||||
globals | global_noevent_Description | ||||
globals | global_noevent_ifDescr | ||||
globals | global_noevent_ifType | ||||
globals | global_threshold | true | true, false | advanced thresholds enabled or not | |
globals | node_name_rule | qr/^[a-zA-Z0-9_. -]+$/ | <regex> | note: rule MUST exclude '/' | |
globals | threshold_falling_reset_dampening | 1.05 | <decimal> | ||
globals | threshold_poll_cycle | true | true, false | perform threshold computations at the end of poll cycle | |
globals | threshold_poll_node | true | true, false | or perform threshold computation with each node | |
globals | threshold_rising_reset_dampening | 0.95 | <decimal> | ||
globals | uuid_namespace_name | www.domain.com | <domain> | ||
globals | uuid_namespace_type | NameSpace_URL | <url> | ||
graph | graph_amount | 48 | <integer> | ||
graph | graph_default_font_small | DEFAULT:8:Sans-Serif | |||
graph | graph_default_font_standard | DEFAULT:8:Sans-Serif | |||
graph | graph_factor | 2 | <integer> | ||
graph | graph_height | 250 | <integer> | ||
graph | graph_split | TRUE | |||
graph | graph_unit | hours | |||
graph | graph_width | 700 | <integer> | ||
graph | small_graph_height | 50 | <integer> | ||
graph | small_graph_width | 400 | <integer> | ||
graph | win_height | 570 | <integer> | ||
graph | win_width | 835 | <integer> | ||
gui | export_summarisation_periods | [ 300, 900, 1800, 3600, 4*3600 ] | |||
icons | arrow_down | <menu_url_base>/img/arrow_down.gif | <relative filepath> | ||
icons | arrow_down_big | <menu_url_base>/img/bigdown.gif | <relative filepath> | ||
icons | arrow_down_black | <menu_url_base>/img/arrow_down_black.gif | <relative filepath> | ||
icons | arrow_down_green | <menu_url_base>/img/arrow_down_green.gif | <relative filepath> | ||
icons | arrow_up | <menu_url_base>/img/arrow_up.gif | <relative filepath> | ||
icons | arrow_up_big | <menu_url_base>/img/bigup.gif | <relative filepath> | ||
icons | arrow_up_red | <menu_url_base>/img/arrow_up_red.gif | <relative filepath> | ||
icons | back_icon | <menu_url_base>/img/back.jpg | <relative filepath> | ||
icons | banner_image | <menu_url_base>/img/NMIS_Logo.gif | <relative filepath> | ||
icons | critical_net_icon | <menu_url_base>/img/network-red.gif | <relative filepath> | ||
icons | doc_icon | <menu_url_base>/img/doc.jpg | <relative filepath> | ||
icons | fatal_net_icon | <menu_url_base>/img/network-red.gif | <relative filepath> | ||
icons | help_icon | <menu_url_base>/img/help.jpg | <relative filepath> | ||
icons | lft_icon | <menu_url_base>/img/lft.jpg | <relative filepath> | ||
icons | logs_icon | <menu_url_base>/img/logs.jpg | <relative filepath> | ||
icons | major_net_icon | <menu_url_base>/img/network-amber.gif | <relative filepath> | ||
icons | map_icon | <menu_url_base>/img/australia-line.gif | <relative filepath> | ||
icons | minor_net_icon | <menu_url_base>/img/network-yellow.gif | <relative filepath> | ||
icons | mtr_icon | <menu_url_base>/img/mtr.jpg | <relative filepath> | ||
icons | nmis_icon | <menu_url_base>/img/nmis.png | <relative filepath> | ||
icons | normal_net_icon | <menu_url_base>/img/network-green.gif | <relative filepath> | ||
icons | ping_icon | <menu_url_base>/img/ping.jpg | <relative filepath> | ||
icons | summary_icon | <menu_url_base>/img/summary.jpg | <relative filepath> | ||
icons | telnet_icon | <menu_url_base>/img/telnet.jpg | <relative filepath> | ||
icons | trace_icon | <menu_url_base>/img/trace.jpg | <relative filepath> | ||
icons | unknown_net_icon | <menu_url_base>/img/network-white.gif | <relative filepath> | ||
javascript | calendar | <menu_url_base>/js/calendar.js | <relative url> | ||
javascript | calendar_setup | <menu_url_base>/js/calendar-setup.js | <relative url> | ||
javascript | jquery | <menu_url_base>/js/jquery-1.8.3.min.js | <relative url> | ||
javascript | jquery_ba_dotimeout | <menu_url_base>/js/jquery.ba-dotimeout.min.js | <relative url> | ||
javascript | jquery_bgiframe | <menu_url_base>/js/jquery.bgiframe-2.1.2.js | <relative url> | ||
javascript | jquery_jdmenu | <menu_url_base>/js/jquery.jdMenu.js | <relative url> | ||
javascript | jquery_positionby | <menu_url_base>/js/jquery.positionBy.js | <relative url> | ||
javascript | jquery_ui | <menu_url_base>/js/jquery-ui-1.9.2.custom.js | <relative url> | ||
javascript | nmis_common | <menu_url_base>/js/commonv8.js | <relative url> | ||
master_slave | auth_src_ip | 127.0.0.1 | |||
master_slave | master_dash | false | true, false | ||
master_slave | master_report | false | true, false | ||
master_slave | master_server_priority | 10 | <integer> | ||
master_slave | master_sleep | 15 | <integer> | ||
master_slave | nmis_master_poll_cycle | false | true, false | ||
master_slave | server_community | secret | |||
master_slave | server_master | false | true, false | ||
master_slave | server_user | nmismst | |||
master_slave | slave_community | secret | |||
true, false | |||||
menu | menu_groups_active | true | true, false | ||
menu | menu_groups_defer_load | false | true, false | ||
menu | menu_groups_foldout | true | true, false | ||
menu | menu_groups_full | true | true, false | ||
menu | menu_maxitems | 30 | <integer> | ||
menu | menu_start_page_id | ||||
menu | menu_suspend_link | true | true, false | ||
menu | menu_title | NMIS8 | |||
menu | menu_types_active | true | true, false | ||
menu | menu_types_defer_load | false | true, false | ||
menu | menu_types_foldout | true | true, false | ||
menu | menu_types_full | true | true, false | ||
menu | menu_vendors_active | false | true, false | ||
menu | menu_vendors_defer_load | false | true, false | ||
menu | menu_vendors_foldout | false | true, false | ||
menu | menu_vendors_full | false | true, false | ||
metrics | average_decimals | 2 | <integer> | ||
metrics | average_diff | 0.1 | <decimal> | ||
metrics | metric_availability | 0.2 | <decimal> | ||
metrics | metric_comparison_first_period | -8 hours | |||
metrics | metric_comparison_second_period | -16 hours | |||
metrics | metric_health | 0.4 | <decimal> | ||
metrics | metric_int_utilisation_above | -1 | <integer> | ||
metrics | metric_reachability | 0.4 | <decimal> | ||
metrics | weight_availability | 0.1 | <decimal> | ||
metrics | weight_cpu | 0.2 | <decimal> | ||
metrics | weight_int | 0.3 | <decimal> | ||
metrics | weight_mem | 0.1 | <decimal> | ||
metrics | weight_reachability | 0.1 | <decimal> | ||
metrics | weight_response | 0.2 | <decimal> | ||
mibs | full_mib | nmis_mibs.oid,a3com.oid,dell.oid,ups.oid,akcp.oid | <filename> | ||
modules | display_community_rss_widget | true | true, false | ||
modules | display_module_list | true | true, false | ||
modules | display_network_view | true | true, false | ||
modules | display_opmaps_widget | false | true, false | ||
modules | display_opflow_widget | false | true, false | ||
modules | opmaps_widget_width | 750 | <integer> | ||
modules | opmaps_widget_height | 450 | <integer> | ||
modules | opflow_widget_width | 750 | <integer> | ||
modules | opflow_widget_height | 460 | <integer> | ||
modules | rss_widget_width | 210 | <integer> | ||
modules | rss_widget_height | 460 | <integer> | ||
online | nmis_docs_online | https://community.opmantek.com/ | <url> | ||
online | community_rss_url | https://community.opmantek.com/rss/NMIS.xml | <url> | ||
sound | sound_fatal | /nmis8/events/critical.wav | <filepath> | ||
sound | sound_critical | /nmis8/events/critical.wav | <filepath> | ||
sound | sound_major | /nmis8/events/major.wav | <filepath> | ||
sound | sound_type | audio/wav | |||
sound | sound_minor | undef | |||
sound | sound_warning | undef | |||
sound | sound_normal | undef | |||
sound | sound_levels | fatal,critical,major,minor,warning,normal | To enable audio feedback, set the severity levels that you want sound for, and point the sound_X to a suitable url | ||
sql | db_debug | 0 | 0,1 | ||
sql | db_events_sql | fasle | true, false | ||
sql | db_host | localhost | |||
sql | db_links_sql | false | true, false | ||
sql | db_logging | 1 | 0,1 | ||
sql | db_name | nmis | |||
sql | db_password | nmis | |||
sql | db_port | 3306 | <integer> | ||
sql | db_prefix | ||||
sql | db_rootpassword | nmis | |||
sql | db_rootuser | nmisadm | |||
sql | db_server | localhost | <hostname> | ||
sql | db_user | nmis | |||
sql | nmisdb | nmisdb | |||
syslog | syslog_events | false | true, false | ||
syslog | syslog_facility | local1 | |||
syslog | syslog_server | localhost:udp:514 | |||
syslog | syslog_use_escalation | true | true, false | ||
system | auto_expand_more_graphs | true | true, false | ||
system | buttons_in_logs | false | true, false | ||
system | cache_summary_tables | true | true, false | ||
system | cache_var_tables | true | true, false | ||
system | cbqos_cm_collect_all | true | true, false | ||
system | default_authkey | ||||
system | default_authpassword | ||||
system | default_communityRO | public | |||
system | default_graphtype | abits | |||
system | default_privkey | ||||
system | default_privpassword | ||||
system | default_username | ||||
system | demote_faulty_nodes | true | true, false | try totally unpollable nodes just once a day? | |
system | disable_interfaces_summary | false | true, false | ||
system | disable_nmis_process_events | undef | to disable the generation of "nmis runtime exceeded" events, set this to 1 or true | ||
system | display_status_summary | false | true, false | ||
system | domain_name | <domain> | |||
system | fastping_count | 3 | <integer> | ||
system | fastping_node_poll | 200 | <integer> | ||
system | fastping_packet | 56 | <integer> | ||
system | fastping_retries | 3 | <integer> | ||
system | fastping_sleep | 60 | <integer> | ||
system | fastping_timeout | 5000 | <integer> | ||
system | file_size_warning | 100000000 | <integer> | ||
system | global_collect | true | true, false | ||
system | graph_cache_maxage | 120 | <integer> | set to zero to disable graph caching | |
system | group_list | NMIS8,DataCenter,Branches,Sales,Campus,HeadOffice,Open-AudIT | |||
system | http_req_timeout | 60 | <integer> | ||
system | interface_availability_value_when_down | U | |||
system | interface_max_number | 5000 | <integer> | ||
system | interface_util_label | Util. 6hrs | |||
system | interface_util_period | -6 hours | |||
system | ipsla_bucket_interval | 180 | <integer> | ||
system | ipsla_collect_time | 60 | <integer> | ||
system | ipsla_control_enable_other | true | true, false | ||
system | ipsla_dnscachetime | 3600 | <integer> | ||
system | ipsla_extra_buckets | 5 | <integer> | ||
system | ipsla_maxthreads | 10 | <integer> | ||
system | ipsla_mthread | true | true, false | ||
system | ipsla_mthreaddebug | false | true, false | ||
system | json_node_fields | uuid,supportGroup,cmdbType | |||
system | keep_event_history | false | true, false | set to false to disable keeping of closed events in history section | |
system | loc_from_DNSloc | false | true, false | ||
system | loc_from_sysLoc | false | true, false | ||
system | loc_sysLoc_format | ^-*\\d{1,3}\\.\\d{1,4},-*\\d{1,3}\\.\\d{1,4},\\d{0,4},. | <regex> | ||
system | location_field_name | sysLocation | new configuration option to have a configurable field to use for location, e.g. sysLocation or location. | ||
system | log_max_table_lines | 25000 | <integer> | ||
system | log_node_configuration_events | false | true, false | ||
system | log_polling_time | undef | to enable the logging of polling time to the NMIS log, will log every node every 5 minutes, set this to 1 or true | ||
system | max_child_runtime | undef | maximum runtime of nmis collect or update (child) processes, unlimited if set to zero or undef | ||
system | model_health_sections | cpu_cpm,entityMib,diskIOTable,ds3Errors,SONETErrors | |||
system | nettype_list | wan,lan,vpn,man,san,voice,default | |||
system | network_health_view | Group | |||
system | network_summary_maxgroups | 30 | <integer> | ||
system | network_viewNode_field_list | status,outage,sysName,host_addr,host_addr_backup,group,customer,location, businessService,serviceStatus,nodeType,nodeModel,polling_policy,sysUpTime, sysLocation,sysContact,sysDescr,ifNumber,lastUpdate,nodeVendor,sysObjectName,roleType,netType | <list> | if this option is present, then *only* properties listed here will be shown in the node view and in precisely this order. custom properties are supported. | |
system | nmis_executable | (/(bin|admin|install/scripts|conf/scripts)/[a-zA-Z0-9_\\.-]+|\\.pl|\\.sh)$ | <regex> | ||
system | nmis_group | nmis | |||
system | nmis_host | localhost | |||
system | nmis_host_protocol | http | |||
system | nmis_maxthreads | 10 | <integer> | ||
system | nmis_mthread | false | true, false | ||
system | nmis_summary_poll_cycle | false | true, false | ||
system | nmis_user | nmis | |||
system | nmis4_compatibility | false | true, false | ||
system | node_button_in_logs | true | true, false | ||
system | node_configuration_events | Node Configuration Change, Node Reset | |||
system | node_status_uses_status_summary | false | true, false | if this option is present and enabled, a nodes health impacts its reported summary, providing VERY granular status. | |
system | node_summary_field_list | host,uuid,location,customer,businessService,serviceStatus,snmpdown,wmidown | <list> | to have additional fields in the node summary data. | |
system | nodetype_list | generic,switch,router,firewall,server | <list> | ||
system | non_stateful_events | Node Configuration Change, Node Reset, NMIS runtime exceeded | <list> | ||
system | os_cmd_file_decompress | gzip -d -c | <command> | ||
system | os_cmd_read_file_reverse | tac | <command> | ||
system | os_execperm | 770 | <integer> | ||
system | os_fileperm | 660 | <integer> | ||
system | os_kernelname | ||||
system | os_posix | false | true, false | ||
system | overall_node_status_coarse | false | true, false | if this option is present use binary logic for node down and set the level to the overall_node_status_level | |
system | overall_node_status_level | Critical | |||
system | page_bg_color_full | true | true, false | ||
system | page_refresh_time | 300 | <integer> | ||
system | ping_count | 3 | <integer> | ||
system | ping_packet | 56 | <integer> | ||
system | ping_retries | 3 | <integer> | ||
system | ping_timeout | 5000 | <integer> | ||
system | plugins_enabled | true | true, false | ||
system | polling_interval_factor | 0.9 | <decimal> | fraction of the polling interval after which node is considered for next poll | |
system | report_files_max | 60 | <integer> | ||
system | response_time_threshold | 500 | <integer> | ||
system | roletype_list | core,distribution,access,default | <list> | ||
system | selftest_cron_name | (^|/)crond?$ | <regex> | regexp for finding your cron implementation | |
system | selftest_max_collect_age | 900 | <integer> | seconds, 15 min | |
system | selftest_max_nmis_procs | 50 | <integer> | ||
system | selftest_max_swap | 50 | <integer> | in percent | |
system | selftest_max_system_cpu | 60 | <integer> | utilization in percent | |
system | selftest_max_system_iowait | 20 | <integer> | in percent | |
system | selftest_max_update_age | 604800 | <integer> | seconds, one week | |
system | selftest_min_diskfree_mb | 25 | <integer> | ||
system | selftest_min_diskfree_percent | 10 | <integer> | ||
system | server_admin | root@localhost | <email> | ||
system | server_name | localhost | |||
system | severity_by_roletype | { core => [ 'Critical', 'Major' ], distribution => [ 'Major', 'Minor' ], access => [ 'Minor', 'Warning' ], default => [ 'Major', 'Minor' ] } | for coloring the group status panel. 'default' applies to unlisted role types | ||
system | snmp_max_msg_size | 1472 | <integer> | ||
system | snmp_retries | 1 | <integer> | ||
system | snmp_stop_polling_on_error | true | true, false | ||
system | snmp_timeout | 5 | <integer> | ||
system | snpp_server | <server_name> | |||
system | stateless_event_dampening | 900 | <integer> | ||
system | threshold_period-default | -15 minutes | |||
system | threshold_period-health | -4 hours | |||
system | threshold_period-interface | -15 minutes | |||
system | threshold_period-pkts | -15 minutes | |||
system | threshold_period-pkts_hc | -15 minutes | |||
system | upnotify_stateful_events | down|proactive|alert | |||
system | use_json | true | true, false | ||
system | use_json_pretty | false | true, false | ||
system | verbose_nmis_process_events | true | true, false | produce STDERR output (and thus cron emails) if killing nmis processes | |
system | widget_refresh_time | 180 | <integer> | ||
system | wrap_node_names | true | true, false | ||
tables NMIS4 | Contacts_Key | Contact | |||
tables NMIS4 | Contacts_Table | <nmis_conf>/contacts.csv | <relative filepath> | ||
tables NMIS4 | Escalation_Key | Group:Role:Type:Event:Event_Node:Event_Element | |||
tables NMIS4 | Escalation_Table | <nmis_conf>/escalation.csv | <relative filepath> | ||
tables NMIS4 | Interface_Key | node:ifDescr | |||
tables NMIS4 | Interface_Table | <nmis_var>/interface.csv | <relative filepath> | ||
tables NMIS4 | Locations_Key | Location | |||
tables NMIS4 | Locations_Table | <nmis_conf>/locations.csv | <relative filepath> | ||
tables NMIS4 | Nodes_Key | node | |||
tables NMIS4 | Nodes_Table | <nmis_conf>/nodes.csv | <relative filepath> | ||
tables NMIS4 | Users_Key | user | |||
tables NMIS4 | Users_Table | <nmis_conf>/users.csv | <relative filepath> | ||
tools | lft | /usr/local/bin/lft | <filepath> | ||
tools | mtr | /usr/sbin/mtr | <filepath> | ||
tools | ssh_port | <integer> | |||
tools | ssh_url | ssh:// | <url> | ||
tools | view_lft | false | true, false | ||
tools | view_mtr | false | true, false | ||
tools | view_ping | true | true, false | ||
tools | view_ssh | true | true, false | ||
tools | view_telnet | true | true, false | ||
tools | view_trace | true | true, false | ||
url | <cgi_url_base> | /cgi-nmis8 | <relative url> | ||
url | <menu_url_base> | /menu8 | <relative url> | ||
url | <url_base> | /nmis8 | <relative url> | ||
url | web_report_root | <url_base>/reports | <relative url> |
Common Settings to Consider Adjusting for NMIS9
As per NMIS8 and also see Importing NMIS8 configuration into NMIS9
Detailed NMIS9 Configuration
As per NMIS8 and also see NMIS 9 Administration Notes