opConfig Configuration

opConfig Configuration

The configuration options for opConfig are stored in a text file /usr/local/omk/conf/opCommon.nmis.

Configuration items that are not application specific are detailed on the opCommon Configuration page.

Common Settings to Consider Adjusting

The items below are commonly changed by customers.

SectionNameOriginal ValueDescription
opconfigopconfig_gui_node_search_moderemoteThis mode doesn't show group memberships as nicely as mode prefetch, but scales much better for large installations.
opconfigopconfig_purging_keep_last100Keep the last 100 recent revisions.
opconfigopconfig_purging_purge_older_than31536000Purge revisions older than 1 year.
opconfigopconfigd_update_rate10How many seconds the process will run before restarted.
opconfigopconfig_url_basehttp://yourserver.yourdomain/For creating links in emails
opconfigopconfig_default_period8dThe default period for all GUI pages.
opconfigopconfig_maxthreads10This will depend on the number of devices being processed and the capacity of your server.
opconfigopconfig_audit_import_passwordnm1888This should be changed to a value that is not the default if you are using the import functionality.

Specific Configuration

The opConfig section of opCommon.nmis is for opConfig specific configuration items only.

SectionNameOriginal Value
Possible ValuesDescription
opconfigopconfig_application_headingundef


opconfigopconfig_audit_import1
0,1to enable this functionality
opconfigopconfig_audit_import_passwordnm1888
<password>
opconfigopconfig_audit_import_url_basehttp://localhost:8042/omk/open-audit/
<url>base for /nodes, /node_config_documents/
opconfigopconfig_audit_import_usernmis
<username>needs ro-access
opconfigopconfig_cli<omk_base>/bin/opconfig-cli.pl
<relative path>
opconfigopconfig_command_timeout20
<integer>
opconfigopconfig_dashboard_command_summaryfalse
true, falseshow the Unique & average commands summary
opconfigopconfig_db_namenmis

The name of the MongoDB database
opconfigopconfig_default_period8d
<days>
opconfigopconfig_disable_ios_ssh_connection_discoveryfalse
true, false
opconfigopconfig_disable_windows_connection_discoverytrue
true, false
opconfigopconfig_external_store<omk_var>/opconfig/external
<relative filepath>
opconfigopconfig_gui_node_search_moderemote
remote, prefetchremote or prefetch, or undef for old list
opconfigopconfig_gui_node_summary_list["name","group","location","customer","businessService","host"]

what node properties opconfig displays in the gui
opconfigopconfig_import_nodes_activatedtrue
true, false
opconfigopconfig_maxthreads10
<integer>
opconfigopconfig_mthreadTRUE
true, false
opconfigopconfig_opstatus_maxage604800
<integer>seconds, 1 week
opconfigopconfig_phrasebooks<omk_conf>/phrasebooks
<relative filepath>
opconfigopconfig_plugin_timeout20
<integer>
opconfigopconfig_purging_autoprotect_first_revisiontrue
true, falseprotect the first revision by default
opconfigopconfig_purging_keep_last100
<integer>keep 100 most recent revisions
opconfigopconfig_purging_purge_older_than31536000
<integer>purge revs older than 1 year (seconds)
opconfigopconfig_raise_alert_eventstrue
true, false
opconfigopconfig_raise_change_eventstrue
true, false
opconfigopconfig_refresh_time120
<integer>
opconfigopconfig_run_commands_on_separate_connectionfalse
true, false
opconfigopconfig_show_nmis_info_in_summary_graphtrue
true, false
opconfigopconfig_url_basehttp://yourserver.yourdomain/
<url>for creating links in emails
opconfigopconfigd<omk_base>/bin/opconfigd.pl
<relative filepath>
opconfigopconfigd_max_processes10
<integer>
opconfigopconfigd_pid/var/run/opconfigd.pid
<filepath>
opconfigopconfigd_run_tags_on_updateconfiguration


opconfigopconfigd_update_delay120
<integer>seconds, 2 min
opconfigopconfigd_update_rate10
<integer>seconds
opconfigopconfig_parsers[ '^show version$' => 'config_parsers/cisco-version.pm' ],
[ '^show ip interface$' => 'config_parsers/cisco-interface.pm' ],
[ '^show startup-config' => 'config_parsers/cisco-config.pm' ],
[ '^chkconfig$' => 'config_parsers/chkconfig.pm' ],
[ '^free -m$' => 'config_parsers/meminfo.pm' ],
[ '^audit$' => 'config_parsers/jsonpassthrough.pm' ],


config parsers: given in descending order of priority, HIGHEST PRIO first

opconfigopconfig_device_presetsnormal' => { wake_up => 0, settling_time => 0, timeout_factor => 1 },
slow' => { wake_up => 2, settling_time => 5, timeout_factor => 1.25 },


regexp (for command) => parser file name (relative to <omk_conf>)