opConfig Configuration

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.

Section

Name

Original Value

Description

Section

Name

Original Value

Description

opconfig

opconfig_gui_node_search_mode

remote

This mode doesn't show group memberships as nicely as mode prefetch, but scales much better for large installations.

opconfig

opconfig_purging_keep_last

100

Keep the last 100 recent revisions.

opconfig

opconfig_purging_purge_older_than

31536000

Purge revisions older than 1 year.

opconfig

opconfigd_update_rate

10

How many seconds the process will run before restarted.

opconfig

opconfig_url_base

http://yourserver.yourdomain/

For creating links in emails

opconfig

opconfig_default_period

8d

The default period for all GUI pages.

opconfig

opconfig_maxthreads

10

This will depend on the number of devices being processed and the capacity of your server.

opconfig

opconfig_audit_import_password

nm1888

This 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.

Section

Name

Original Value

 

Possible Values

Description

Section

Name

Original Value

 

Possible Values

Description

opconfig

opconfig_application_heading

undef

 

 

 

opconfig

opconfig_audit_import

1

 

0,1

to enable this functionality

opconfig

opconfig_audit_import_password

nm1888

 

<password>

 

opconfig

opconfig_audit_import_url_base

http://localhost:8042/omk/open-audit/

 

<url>

base for /nodes, /node_config_documents/

opconfig

opconfig_audit_import_user

nmis

 

<username>

needs ro-access

opconfig

opconfig_cli

<omk_base>/bin/opconfig-cli.pl

 

<relative path>

 

opconfig

opconfig_command_timeout

20

 

<integer>

 

opconfig

opconfig_dashboard_command_summary

false

 

true, false

show the Unique & average commands summary

opconfig

opconfig_db_name

nmis

 

 

The name of the MongoDB database

opconfig

opconfig_default_period

8d

 

<days>

 

opconfig

opconfig_disable_ios_ssh_connection_discovery

false

 

true, false

 

opconfig

opconfig_disable_windows_connection_discovery

true

 

true, false

 

opconfig

opconfig_external_store

<omk_var>/opconfig/external

 

<relative filepath>

 

opconfig

opconfig_gui_node_search_mode

remote

 

remote, prefetch

remote or prefetch, or undef for old list

opconfig

opconfig_gui_node_summary_list

["name","group","location","customer","businessService","host"]

 

 

what node properties opconfig displays in the gui

opconfig

opconfig_import_nodes_activated

true

 

true, false

 

opconfig

opconfig_maxthreads

10

 

<integer>

 

opconfig

opconfig_mthread

TRUE

 

true, false

 

opconfig

opconfig_opstatus_maxage

604800

 

<integer>

seconds, 1 week

opconfig

opconfig_phrasebooks

<omk_conf>/phrasebooks

 

<relative filepath>

 

opconfig

opconfig_plugin_timeout

20

 

<integer>

 

opconfig

opconfig_purging_autoprotect_first_revision

true

 

true, false

protect the first revision by default

opconfig

opconfig_purging_keep_last

100

 

<integer>

keep 100 most recent revisions

opconfig

opconfig_purging_purge_older_than

31536000

 

<integer>

purge revs older than 1 year (seconds)

opconfig

opconfig_raise_alert_events

true

 

true, false

 

opconfig

opconfig_raise_change_events

true

 

true, false

 

opconfig

opconfig_refresh_time

120

 

<integer>

 

opconfig

opconfig_run_commands_on_separate_connection

false

 

true, false

 

opconfig

opconfig_show_nmis_info_in_summary_graph

true

 

true, false

 

opconfig

opconfig_url_base

http://yourserver.yourdomain/

 

<url>

for creating links in emails

opconfig

opconfigd

<omk_base>/bin/opconfigd.pl

 

<relative filepath>

 

opconfig

opconfigd_max_processes

10

 

<integer>

 

opconfig

opconfigd_pid

/var/run/opconfigd.pid

 

<filepath>

 

opconfig

opconfigd_run_tags_on_update

configuration

 

 

 

opconfig

opconfigd_update_delay

120

 

<integer>

seconds, 2 min

opconfig

opconfigd_update_rate

10

 

<integer>

seconds

opconfig

opconfig_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

opconfig

opconfig_device_presets

normal' => { 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>)