You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Configuration

The NMIS 8 configuration items are stored in a text file /usr/local/nmis8/conf/Config.nmis.


Common Settings to Consider Adjusting

See this linked page for settings customers commonly change - NMIS8 Common Settings to Consider Adjusting. Customers typically to change authentication and email settings.


Settings

Configuration settings in the Config.nmis file are broken into sections.


SectionNameOriginal Value
Possible ValuesDescription
authenticationauth_banner_titleNMIS8


authenticationauth_buttons_visibletrue
true, false
authenticationauth_cookie_flavournmis
nmis, omk
authenticationauth_cw_company_id



authenticationauth_cw_private_key



authenticationauth_cw_public_key



authenticationauth_cw_server



authenticationauth_debug



authenticationauth_debug_remote_addr



authenticationauth_default_groups



authenticationauth_default_privilege



authenticationauth_expire\+30min


authenticationauth_htpasswd_encryptcrypt


authenticationauth_htpasswd_file<nmis_conf>/users.dat


authenticationauth_ldap_attr



authenticationauth_ldap_contextou=people,dc=opmantek,dc=com


authenticationauth_ldap_server192.168.1.5


authenticationauth_ldaps_server



authenticationauth_lockout_after0


authenticationauth_login_motdAuthentication required: Please log in with your appropriate username and password in order to gain access to this system


authenticationauth_login_titleNMIS8 login


authenticationauth_method_1htpasswd


authenticationauth_method_2



authenticationauth_method_3



authenticationauth_ms_ldap_attrsAMAccountName


authenticationauth_ms_ldap_basedc=corp,dc=opmantek,dc=com


authenticationauth_ms_ldap_debugfalse
true, false
authenticationauth_ms_ldap_dn_accnmis


authenticationauth_ms_ldap_dn_pswXXXXXXXXX


authenticationauth_ms_ldap_server192.168.1.5


authenticationauth_ms_ldaps_server



authenticationauth_radius_secret



authenticationauth_radius_server



authenticationauth_sso_domain



authenticationauth_user_name_regex[\w \-\.\@\`\']+
<regex>Deprecated
authenticationauth_web_keyPlease Change Me!








cssjquery_jdmenu_css<menu_url_base>/css/jquery.jdMenu.css
<relative url>
cssjquery_ui_css<menu_url_base>/css/smoothness/jquery-ui-1.9.2.custom.css
<relative url>
cssstyles<menu_url_base>/css/dash8.css
<relative url>






daemonsdaemon_fping_activetrue
true, false
daemonsdaemon_fping_dns_cachetrue
true, false
daemonsdaemon_fping_filenamefpingd.pl


daemonsdaemon_fping_run_escalationtrue
true, false
daemonsdaemon_ipsla_activefalse
true, false
daemonsdaemon_ipsla_filenameipslad.pl


daemonslogwatchfalse
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>
directoriesconfig_logs<nmis_logs>/config
<relative filepath>
directoriesdatabase_root<nmis_data>/database
<relative filepath>
directoriesjson_logs<nmis_logs>/json
<relative filepath>
directorieslog_root<nmis_logs>
<relative filepath>
directoriesmib_root<nmis_base>/mibs
<relative filepath>
directoriesplugin_root<nmis_conf>/plugins
<relative filepath>
directoriesreport_root<nmis_base>/htdocs/reports
<relative filepath>
directoriesscript_root<nmis_conf>/scripts
<relative filepath>
directoriesweb_root<nmis_base>/htdocs
<relative filepath>






emailmail_combinetrue
true, false
emailmail_domainyourdomain.com
<domain>
emailmail_fromnmis@yourdomain.com
<email>
emailmail_from_reportsnmis-reports@yourdomain.com
<email>
emailmail_password

<password>
emailmail_server127.0.0.1
<ip>
emailmail_server_ipproto

ipv4, ipv6If unset, defaults to ipv4.
emailmail_server_port25
<integer>
emailmail_use_tlsfalse
true, false
emailmail_useryour mail username
<username>






escalationescalate00
<integer>Seconds
escalationescalate1300
<integer>Seconds
escalationescalate1086400
<integer>Seconds
escalationescalate2900
<integer>Seconds
escalationescalate31800
<integer>Seconds
escalationescalate42400
<integer>Seconds
escalationescalate53600
<integer>Seconds
escalationescalate67200
<integer>Seconds
escalationescalate710800
<integer>Seconds
escalationescalate821600
<integer>Seconds
escalationescalate943200
<integer>Seconds
expirationpurge_backup_after30*86400

backup files
expirationpurge_event_after7*86400

historic, closed events
expirationpurge_graphcache_after3600

cached graph images
expirationpurge_jsonlog_after30*86400

json log files
expirationpurge_outages_after86400

past non-recurring outages
expirationpurge_reports_after365*86400

html reports
expirationpurge_rrd_after30*86400

unused rrd files older than 30 days
expirationpurge_state_after30*86400

unused nmis state files






filesauth_log<nmis_logs>/auth.log
<filepath>
filescompany_logo

<filepath>
filesevent_log<nmis_logs>/event.log
<filepath>
filesevents<cgi_url_base>/events.pl
<filepath>
filesfpingd_log<nmis_logs>/fpingd.log
<filepath>
filesipsla<cgi_url_base>/ipsla.pl
<filepath>
filesipsla_log<nmis_logs>/ipsla.log
<filepath>
fileslogs<cgi_url_base>/logs.pl
<filepath>
filesnetwork<cgi_url_base>/network.pl
<filepath>
filesnmis<cgi_url_base>/nmiscgi.pl
<filepath>
filesnmis_favicon<menu_url_base>/img/nmis_favicon.png
<filepath>
filesnmis_help<menu_url_base>/img/question.png
<filepath>
filesnmis_home<menu_url_base>/img/home.png
<filepath>
filesnmis_log<nmis_logs>/nmis.log
<filepath>
filesnmis_slave<menu_url_base>/img/slave.png
<filepath>
filesnode<cgi_url_base>/node.pl
<filepath>
filesoutage_file<nmis_conf>/outage.dat
<filepath>
filespolling_log<nmis_logs>/polling.log
<filepath>
filesrrddraw<cgi_url_base>/rrddraw.pl
<filepath>
filessyslog_log<nmis_logs>/cisco.log
<filepath>






globalsglobal_collect_Description(CNOC|Collection)


globalsglobal_collect_ifDescr



globalsglobal_events_bandwidthtrue
true, false
globalsglobal_nocollect_Description



globalsglobal_nocollect_ifDescr



globalsglobal_nocollect_ifOperStatus



globalsglobal_nocollect_ifType



globalsglobal_nocollect_interface_down_days30
<integer>
globalsglobal_nocollect_noDescription



globalsglobal_noevent_Description



globalsglobal_noevent_ifDescr



globalsglobal_noevent_ifType



globalsglobal_thresholdtrue
true, falseadvanced thresholds enabled or not
globalsnode_name_ruleqr/^[a-zA-Z0-9_. -]+$/
<regex>note: rule MUST exclude '/'
globalsthreshold_falling_reset_dampening1.05
<decimal>
globalsthreshold_poll_cycletrue
true, falseperform threshold computations at the end of poll cycle
globalsthreshold_poll_nodetrue
true, falseor perform threshold computation with each node
globalsthreshold_rising_reset_dampening0.95
<decimal>
globalsuuid_namespace_namewww.domain.com
<domain>
globalsuuid_namespace_typeNameSpace_URL
<url>






graphgraph_amount48
<integer>
graphgraph_default_font_smallDEFAULT:8:Sans-Serif


graphgraph_default_font_standardDEFAULT:8:Sans-Serif


graphgraph_factor2
<integer>
graphgraph_height250
<integer>
graphgraph_splitTRUE


graphgraph_unithours


graphgraph_width700
<integer>
graphsmall_graph_height50
<integer>
graphsmall_graph_width400
<integer>
graphwin_height570
<integer>
graphwin_width835
<integer>






guiexport_summarisation_periods[ 300, 900, 1800, 3600, 4*3600 ]








iconsarrow_down<menu_url_base>/img/arrow_down.gif
<relative filepath>
iconsarrow_down_big<menu_url_base>/img/bigdown.gif
<relative filepath>
iconsarrow_down_black<menu_url_base>/img/arrow_down_black.gif
<relative filepath>
iconsarrow_down_green<menu_url_base>/img/arrow_down_green.gif
<relative filepath>
iconsarrow_up<menu_url_base>/img/arrow_up.gif
<relative filepath>
iconsarrow_up_big<menu_url_base>/img/bigup.gif
<relative filepath>
iconsarrow_up_red<menu_url_base>/img/arrow_up_red.gif
<relative filepath>
iconsback_icon<menu_url_base>/img/back.jpg
<relative filepath>
iconsbanner_image<menu_url_base>/img/NMIS_Logo.gif
<relative filepath>
iconscritical_net_icon<menu_url_base>/img/network-red.gif
<relative filepath>
iconsdoc_icon<menu_url_base>/img/doc.jpg
<relative filepath>
iconsfatal_net_icon<menu_url_base>/img/network-red.gif
<relative filepath>
iconshelp_icon<menu_url_base>/img/help.jpg
<relative filepath>
iconslft_icon<menu_url_base>/img/lft.jpg
<relative filepath>
iconslogs_icon<menu_url_base>/img/logs.jpg
<relative filepath>
iconsmajor_net_icon<menu_url_base>/img/network-amber.gif
<relative filepath>
iconsmap_icon<menu_url_base>/img/australia-line.gif
<relative filepath>
iconsminor_net_icon<menu_url_base>/img/network-yellow.gif
<relative filepath>
iconsmtr_icon<menu_url_base>/img/mtr.jpg
<relative filepath>
iconsnmis_icon<menu_url_base>/img/nmis.png
<relative filepath>
iconsnormal_net_icon<menu_url_base>/img/network-green.gif
<relative filepath>
iconsping_icon<menu_url_base>/img/ping.jpg
<relative filepath>
iconssummary_icon<menu_url_base>/img/summary.jpg
<relative filepath>
iconstelnet_icon<menu_url_base>/img/telnet.jpg
<relative filepath>
iconstrace_icon<menu_url_base>/img/trace.jpg
<relative filepath>
iconsunknown_net_icon<menu_url_base>/img/network-white.gif
<relative filepath>






javascriptcalendar<menu_url_base>/js/calendar.js
<relative url>
javascriptcalendar_setup<menu_url_base>/js/calendar-setup.js
<relative url>
javascriptjquery<menu_url_base>/js/jquery-1.8.3.min.js
<relative url>
javascriptjquery_ba_dotimeout<menu_url_base>/js/jquery.ba-dotimeout.min.js
<relative url>
javascriptjquery_bgiframe<menu_url_base>/js/jquery.bgiframe-2.1.2.js
<relative url>
javascriptjquery_jdmenu<menu_url_base>/js/jquery.jdMenu.js
<relative url>
javascriptjquery_positionby<menu_url_base>/js/jquery.positionBy.js
<relative url>
javascriptjquery_ui<menu_url_base>/js/jquery-ui-1.9.2.custom.js
<relative url>
javascriptnmis_common<menu_url_base>/js/commonv8.js
<relative url>






master_slaveauth_src_ip127.0.0.1


master_slavemaster_dashfalse
true, false
master_slavemaster_reportfalse
true, false
master_slavemaster_server_priority10
<integer>
master_slavemaster_sleep15
<integer>
master_slavenmis_master_poll_cyclefalse
true, false
master_slaveserver_communitysecret


master_slaveserver_masterfalse
true, false
master_slaveserver_usernmismst


master_slaveslave_communitysecret






true, false
menumenu_groups_activetrue
true, false
menumenu_groups_defer_loadfalse
true, false
menumenu_groups_foldouttrue
true, false
menumenu_groups_fulltrue
true, false
menumenu_maxitems30
<integer>
menumenu_start_page_id



menumenu_suspend_linktrue
true, false
menumenu_titleNMIS8


menumenu_types_activetrue
true, false
menumenu_types_defer_loadfalse
true, false
menumenu_types_foldouttrue
true, false
menumenu_types_fulltrue
true, false
menumenu_vendors_activefalse
true, false
menumenu_vendors_defer_loadfalse
true, false
menumenu_vendors_foldoutfalse
true, false
menumenu_vendors_fullfalse
true, false






metricsaverage_decimals2
<integer>
metricsaverage_diff0.1
<decimal>
metricsmetric_availability0.2
<decimal>
metricsmetric_comparison_first_period-8 hours


metricsmetric_comparison_second_period-16 hours


metricsmetric_health0.4
<decimal>
metricsmetric_int_utilisation_above-1
<integer>
metricsmetric_reachability0.4
<decimal>
metricsweight_availability0.1
<decimal>
metricsweight_cpu0.2
<decimal>
metricsweight_int0.3
<decimal>
metricsweight_mem0.1
<decimal>
metricsweight_reachability0.1
<decimal>
metricsweight_response0.2
<decimal>






mibsfull_mibnmis_mibs.oid,a3com.oid,dell.oid,ups.oid,akcp.oid
<filename>






modulesdisplay_community_rss_widgettrue
true, false
modulesdisplay_module_listtrue
true, false
modulesdisplay_network_viewtrue
true, false
modulesdisplay_opmaps_widgetfalse
true, false
modulesdisplay_opflow_widgetfalse
true, false
modulesopmaps_widget_width750
<integer>
modulesopmaps_widget_height450
<integer>
modulesopflow_widget_width750
<integer>
modulesopflow_widget_height460
<integer>
modulesrss_widget_width210
<integer>
modulesrss_widget_height460
<integer>






onlinenmis_docs_onlinehttps://community.opmantek.com/
<url>
onlinecommunity_rss_urlhttps://community.opmantek.com/rss/NMIS.xml
<url>






soundsound_fatal/nmis8/events/critical.wav
<filepath>
soundsound_critical/nmis8/events/critical.wav
<filepath>
soundsound_major/nmis8/events/major.wav
<filepath>
soundsound_typeaudio/wav


soundsound_minorundef


soundsound_warningundef


soundsound_normalundef


soundsound_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







sqldb_debug0
0,1
sqldb_events_sqlfasle
true, false
sqldb_hostlocalhost


sqldb_links_sqlfalse
true, false
sqldb_logging1
0,1
sqldb_namenmis


sqldb_passwordnmis


sqldb_port3306
<integer>
sqldb_prefix



sqldb_rootpasswordnmis


sqldb_rootusernmisadm


sqldb_serverlocalhost
<hostname>
sqldb_usernmis


sqlnmisdbnmisdb








syslogsyslog_eventsfalse
true, false
syslogsyslog_facilitylocal1


syslogsyslog_serverlocalhost:udp:514


syslogsyslog_use_escalationtrue
true, false






systemauto_expand_more_graphstrue
true, false
systembuttons_in_logsfalse
true, false
systemcache_summary_tablestrue
true, false
systemcache_var_tablestrue
true, false
systemcbqos_cm_collect_alltrue
true, false
systemdefault_authkey



systemdefault_authpassword



systemdefault_communityROpublic


systemdefault_graphtypeabits


systemdefault_privkey



systemdefault_privpassword



systemdefault_username



systemdemote_faulty_nodestrue
true, falsetry totally unpollable nodes just once a day?
systemdisable_interfaces_summaryfalse
true, false
systemdisable_nmis_process_eventsundef

to disable the generation of "nmis runtime exceeded" events, set this to 1 or true
systemdisplay_status_summaryfalse
true, false
systemdomain_name

<domain>
systemfastping_count3
<integer>
systemfastping_node_poll200
<integer>
systemfastping_packet56
<integer>
systemfastping_retries3
<integer>
systemfastping_sleep60
<integer>
systemfastping_timeout5000
<integer>
systemfile_size_warning100000000
<integer>
systemglobal_collecttrue
true, false
systemgraph_cache_maxage120
<integer>set to zero to disable graph caching
systemgroup_listNMIS8,DataCenter,Branches,Sales,Campus,HeadOffice,Open-AudIT


systemhttp_req_timeout60
<integer>
systeminterface_availability_value_when_downU


systeminterface_max_number5000
<integer>
systeminterface_util_labelUtil. 6hrs


systeminterface_util_period-6 hours


systemipsla_bucket_interval180
<integer>
systemipsla_collect_time60
<integer>
systemipsla_control_enable_othertrue
true, false
systemipsla_dnscachetime3600
<integer>
systemipsla_extra_buckets5
<integer>
systemipsla_maxthreads10
<integer>
systemipsla_mthreadtrue
true, false
systemipsla_mthreaddebugfalse
true, false
systemjson_node_fieldsuuid,supportGroup,cmdbType


systemkeep_event_historyfalse
true, falseset to false to disable keeping of closed events in history section
systemloc_from_DNSlocfalse
true, false
systemloc_from_sysLocfalse
true, false
systemloc_sysLoc_format^-*\\d{1,3}\\.\\d{1,4},-*\\d{1,3}\\.\\d{1,4},\\d{0,4},.
<regex>
systemlocation_field_namesysLocation

new configuration option to have a configurable field to use for location, e.g. sysLocation or location.

systemlog_max_table_lines25000
<integer>
systemlog_node_configuration_eventsfalse
true, false
systemlog_polling_timeundef

to enable the logging of polling time to the NMIS log, will log every node every 5 minutes, set this to 1 or true

systemmax_child_runtimeundef

maximum runtime of nmis collect or update (child) processes, unlimited if set to zero or undef
systemmodel_health_sectionscpu_cpm,entityMib,diskIOTable,ds3Errors,SONETErrors


systemnettype_listwan,lan,vpn,man,san,voice,default


systemnetwork_health_viewGroup


systemnetwork_summary_maxgroups30
<integer>
systemnetwork_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.

systemnmis_executable(/(bin|admin|install/scripts|conf/scripts)/[a-zA-Z0-9_\\.-]+|\\.pl|\\.sh)$
<regex>
systemnmis_groupnmis


systemnmis_hostlocalhost


systemnmis_host_protocolhttp


systemnmis_maxthreads10
<integer>
systemnmis_mthreadfalse
true, false
systemnmis_summary_poll_cyclefalse
true, false
systemnmis_usernmis


systemnmis4_compatibilityfalse
true, false
systemnode_button_in_logstrue
true, false
systemnode_configuration_eventsNode Configuration Change, Node Reset


systemnode_status_uses_status_summaryfalse
true, false

if this option is present and enabled, a nodes health impacts its reported summary, providing VERY granular status.

systemnode_summary_field_listhost,uuid,location,customer,businessService,serviceStatus,snmpdown,wmidown
<list>to have additional fields in the node summary data.
systemnodetype_listgeneric,switch,router,firewall,server
<list>
systemnon_stateful_eventsNode Configuration Change, Node Reset, NMIS runtime exceeded
<list>
systemos_cmd_file_decompressgzip -d -c
<command>
systemos_cmd_read_file_reversetac
<command>
systemos_execperm770
<integer>
systemos_fileperm660
<integer>
systemos_kernelname



systemos_posixfalse
true, false
systemoverall_node_status_coarsefalse
true, false

if this option is present use binary logic for node down and set the level to the overall_node_status_level

systemoverall_node_status_levelCritical


systempage_bg_color_fulltrue
true, false
systempage_refresh_time300
<integer>
systemping_count3
<integer>
systemping_packet56
<integer>
systemping_retries3
<integer>
systemping_timeout5000
<integer>
systemplugins_enabledtrue
true, false
systempolling_interval_factor0.9
<decimal>fraction of the polling interval after which node is considered for next poll
systemreport_files_max60
<integer>
systemresponse_time_threshold500
<integer>
systemroletype_listcore,distribution,access,default
<list>
systemselftest_cron_name(^|/)crond?$
<regex>regexp for finding your cron implementation
systemselftest_max_collect_age900
<integer>seconds, 15 min
systemselftest_max_nmis_procs50
<integer>
systemselftest_max_swap50
<integer>in percent
systemselftest_max_system_cpu60
<integer>utilization in percent
systemselftest_max_system_iowait20
<integer>in percent
systemselftest_max_update_age604800
<integer>seconds, one week
systemselftest_min_diskfree_mb25
<integer>
systemselftest_min_diskfree_percent10
<integer>
systemserver_adminroot@localhost
<email>
systemserver_namelocalhost


systemseverity_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
systemsnmp_max_msg_size1472
<integer>
systemsnmp_retries1
<integer>
systemsnmp_stop_polling_on_errortrue
true, false
systemsnmp_timeout5
<integer>
systemsnpp_server<server_name>


systemstateless_event_dampening900
<integer>
systemthreshold_period-default-15 minutes


systemthreshold_period-health-4 hours


systemthreshold_period-interface-15 minutes


systemthreshold_period-pkts-15 minutes


systemthreshold_period-pkts_hc-15 minutes


systemupnotify_stateful_eventsdown|proactive|alert


systemuse_jsontrue
true, false
systemuse_json_prettyfalse
true, false
systemverbose_nmis_process_eventstrue
true, falseproduce STDERR output (and thus cron emails) if killing nmis processes
systemwidget_refresh_time180
<integer>
systemwrap_node_namestrue
true, false






tables NMIS4Contacts_KeyContact


tables NMIS4Contacts_Table<nmis_conf>/contacts.csv
<relative filepath>
tables NMIS4Escalation_KeyGroup:Role:Type:Event:Event_Node:Event_Element


tables NMIS4Escalation_Table<nmis_conf>/escalation.csv
<relative filepath>
tables NMIS4Interface_Keynode:ifDescr


tables NMIS4Interface_Table<nmis_var>/interface.csv
<relative filepath>
tables NMIS4Locations_KeyLocation


tables NMIS4Locations_Table<nmis_conf>/locations.csv
<relative filepath>
tables NMIS4Nodes_Keynode


tables NMIS4Nodes_Table<nmis_conf>/nodes.csv
<relative filepath>
tables NMIS4Users_Keyuser


tables NMIS4Users_Table<nmis_conf>/users.csv
<relative filepath>






toolslft/usr/local/bin/lft
<filepath>
toolsmtr/usr/sbin/mtr
<filepath>
toolsssh_port

<integer>
toolsssh_urlssh://
<url>
toolsview_lftfalse
true, false
toolsview_mtrfalse
true, false
toolsview_pingtrue
true, false
toolsview_sshtrue
true, false
toolsview_telnettrue
true, false
toolsview_tracetrue
true, false






url<cgi_url_base>/cgi-nmis8
<relative url>
url<menu_url_base>/menu8
<relative url>
url<url_base>/nmis8
<relative url>
urlweb_report_root<url_base>/reports
<relative url>
  • No labels