Configuration
The configuration options for opCharts are stored in a text file /usr/local/omk/conf/opCommon.nmis.
Common Settings to Consider Adjusting
Authentication
You may need to restart the omkd daemon / service after making changes to these items.
The file these settings are stored in is (Linux) /usr/local/omk/conf/opCommon.nmis and (Windows) c:\omk\conf\opCommon.nmis.
The settings are common to all Opmantek commercial applications.
| Section | Name | Original Value | Possible Values | Description | |
|---|---|---|---|---|---|
| authentication | auth_crowd_password | <password> | |||
| authentication | auth_crowd_server | <ip> | |||
| authentication | auth_crowd_user | <username> | |||
| authentication | auth_expire_seconds | 3600 | <integer> | ||
| authentication | auth_htpasswd_encrypt | crypt | crypt, plaintext, apache-md5 | ||
| authentication | auth_htpasswd_file | <omk_conf>/users.dat | <relative filepath> | ||
| authentication | auth_lockout_after | 0 | <integer> | seconds, 0 for none. | |
| authentication | auth_login_motd | Authentication required: default credentials are nmis/nm1888 | |||
| authentication | auth_method_1 | htpasswd | htpasswd, openaudit, radias, tacacs, crowd, system, ldaps, ldap, ms-ldap, ms-ldaps, novell-ldap, connectwise, pam | ||
| authentication | auth_method_2 | htpasswd, openaudit, radias, tacacs, crowd, system, ldaps, ldap, ms-ldap, ms-ldaps, novell-ldap, connectwise, pam | |||
| authentication | auth_method_3 | htpasswd, openaudit, radias, tacacs, crowd, system, ldaps, ldap, ms-ldap, ms-ldaps, novell-ldap, connectwise, pam | |||
| authentication | auth_ms_ldap_attr | sAMAccountName | |||
| authentication | auth_ms_ldap_base | CN=Users,DC=your_domain,DC=com | <ldap> | ||
| authentication | auth_ms_ldap_debug | true | true, false | ||
| authentication | auth_ms_ldap_dn_acc | CN=Administrator,CN=Users,DC=your_domain,DC=com | |||
| authentication | auth_ms_ldap_dn_psw | your_administrator_password | <password> | ||
| authentication | auth_ms_ldap_group | CN=Users,DC=your_domain,DC=com | <ldap> | ||
| authentication | auth_ms_ldap_server | your.ip.address.here | <ip> | ||
| authentication | auth_ms_ldaps_capath | required | |||
| authentication | auth_ms_ldaps_server | your.ip.address.here | <ip> | ||
| authentication | auth_ms_ldaps_verify | ||||
| authentication | auth_sso_domain | <domain> |
The email settings are used to email scheduled Queries and Reports. These should be changed to your required email server's settings.
To change these using the GUI in Open-AudIT navigate to menu -> Admin -> Configuration -> Email
You may need to restart the omkd daemon / service after making changes to these items.
The file these settings are stored in is (Linux) /usr/local/omk/conf/opCommon.nmis and (Windows) c:\omk\conf\opCommon.nmis.
The settings are common to all Opmantek commercial applications.
| Section | Name | Original Value | Possible Values | Description | |
|---|---|---|---|---|---|
| mail_domain | yourdomain.com | <domain> | |||
| mail_from | yourmailname@yourdomain.com | <email> | |||
| mail_password | your_password | <password> | |||
| mail_server | smtp.yourdomain.com | <fqdn> | |||
| mail_server_port | 25 | <integer> | |||
| mail_subject_prefix | [automatic] | ||||
| mail_use_tls | true | true, false | |||
| mail_user | your_user_account@your_domain.com | <username> |
Database
The database section contains connection details to your MongoDB database.
| Section | Name | Original Value | Possible Values | Description | |
|---|---|---|---|---|---|
| database | db_admin_port | 28017 | <integer> | ||
| database | db_connection_timeout | 20000 | <integer> | ||
| database | db_name | nmis | <name> | ||
| database | db_password | op42flow42 | <password> | ||
| database | db_ping_timeout | 2000 | <integer> | ||
| database | db_port | 27017 | <integer> | ||
| database | db_query_timeout | 5000 | <integer> | ||
| database | db_server | localhost | <hostname> | ||
| database | db_use_v26_features | 1 | <integer> | ||
| database | db_username | opUserRW | <username> | ||
| database | db_write_concern | 1 | <integer> |
NMIS
The NMIS section contains attributes related to the connected NMIS application.
| Section | Name | Original Value | Possible Values | Description | |
|---|---|---|---|---|---|
| nmis | <nmis_dir> | /usr/local/nmis8 | <filepath> | ||
| nmis | <nmis_logs> | /usr/local/nmis8/logs | <filepath> | ||
| nmis | nmis_cgi_url_base | /cgi-nmis8 | <url path> | ||
| nmis | nmis_dir | /usr/local/nmis8 | <filepath> | ||
| nmis | nmis_host_base | http://localhost | <url> | ||
| nmis | nmis_icon_small | <omk_url_base>/icons/nmis_sml.png | <relative url> | ||
| nmis | nmis_max_filtered_table_cache_size | 100 | <integer> | ||
| nmis | nmis_sensitive_property | ['community','privkey','privpassword','authkey','authpassword','wmiusername','wmipassword','username'] | |||
| nmis | nmisConf | Config | <filename> | Filename of NMIS config file, usually Config.nmis, sans nmis. | |
| nmis | prefer_local_nmis | false | true, false |
opCharts Specific Configuration
The opCharts section of opCommon.nmis is for opCharts specific configuration items only.
| Section | Name | Original Value | Possible Values | Description | |
|---|---|---|---|---|---|
| opcharts | <opcharts_map_icons> | <omk_url_base>/icons | <relative url> | ||
| opcharts | dashboard_template_dir | <omk_templates>/resources/dashboards/templates | <relative url> | ||
| opcharts | nmisx_cache_min_age_before_refresh | 60 | <integer> | ||
| opcharts | nmisx_cache_time | 900 | <integer> | ||
| opcharts | nmisx_db_cache_enable | 0 | <integer> | ||
| opcharts | nmisx_db_cache_node_health_sorting | 0 | <integer> | ||
| opcharts | nmisx_live_long_ap | 0 | 0, 1 | turn this on to keep nmisx objects for a long time, could cause high memory usage | |
| opcharts | nmisx_subnet_cache_time | 300 | <integer> | ||
| opcharts | nmisx_timing | 0 | <integer> | ||
| opcharts | opcharts_batch_insert_size | 256 | <integer> | ||
| opcharts | opcharts_custom_map_icons | ||||
| opcharts | opcharts_db_name | opcharts | |||
| opcharts | opcharts_default_map_icon | toaster | |||
| opcharts | opcharts_gui_business_service_show_pagesize | 0 | 0, 1 | Change to 1 for pagesize select in business services | |
| opcharts | opcharts_gui_chart_bulk_request | 1 | <integer> | ||
| opcharts | opcharts_gui_default_chart_x | 1 | <integer> | ||
| opcharts | opcharts_gui_default_chart_y | 1 | <integer> | ||
| opcharts | opcharts_gui_default_chart_y_few_charts | 2 | <integer> | ||
| opcharts | opcharts_gui_default_decimals | 2 | <integer> | ||
| opcharts | opcharts_gui_full_size_y | 3 | <integer> | ||
| opcharts | opcharts_gui_graph_max_entries_in_tooltip | 5 | <integer> | ||
| opcharts | opcharts_gui_interface_summary_list | ['Description'ifDescr'Hardware'ifSpeed'ifType'ipAdEntAddr1'ipAdEntNetMask1'] | |||
| opcharts | opcharts_gui_max_nodes_in_automap | 200 | <integer> | ||
| opcharts | opcharts_gui_max_num_connections_in_expanded_subnet | 5 | <integer> | ||
| opcharts | opcharts_gui_max_num_vertical_graphs | 5 | <integer> | ||
| opcharts | opcharts_gui_node_list_view_type | table | table, panel | ||
| opcharts | opcharts_gui_node_panel_display | kpi | |||
| opcharts | opcharts_gui_node_search_remote_cache_timeout | 10 | <integer> | ||
| opcharts | opcharts_gui_period_values | ["8h","12h","1d","2d","5d","7d","14d","30d","60d","90d","180d"] | |||
| opcharts | opcharts_gui_period_values_hd | ["15m","30m","1h","2h","4h"] | |||
| opcharts | opcharts_gui_refresh_time | 300 | <integer> | ||
| opcharts | opcharts_interface_graph_default_poller | Interface Utilisation - High Speed | |||
| opcharts | opcharts_map_api_key | ||||
| opcharts | opcharts_map_background_dir | <omk_url_base>/maps_background_dir | <relative url> | ||
| opcharts | opcharts_map_link_color_down | #FF0000 | |||
| opcharts | opcharts_map_link_color_error | #d9534f | |||
| opcharts | opcharts_map_link_color_normal | #ffd700 | |||
| opcharts | opcharts_map_link_color_ok | #59cf59 | |||
| opcharts | opcharts_map_link_color_uk | #999 | |||
| opcharts | opcharts_map_link_color_up | #00FF00 | |||
| opcharts | opcharts_map_link_color_warn | #ffa500 | |||
| opcharts | opcharts_maps_geographical_clustering | 1 | <integer> | ||
| opcharts | opcharts_maps_geographical_start_location | [-27.999707,153.404933] | |||
| opcharts | opcharts_max_dataset_width | 1008 | <integer> | To make things nice, this should divide by the resolution | |
| opcharts | opcharts_max_resource_lock_seconds | 86400 | <integer> | ||
| opcharts | opcharts_monitored_service_selector_sections | See Documentation | |||
| opcharts | opcharts_node_list_cols_per_page | 4 | <integer> | ||
| opcharts | opcharts_node_list_exporttocsv | ["info.system.name", "info.system.active", "info.system.cbqos", "info.system.collect", "info.system.customer", "info.system.group", "info.system.host", "info.system.intfCollect", "info.system.ifNumber", "info.system.location", "info.system.model", "info.system.nodeModel", "info.system.nodeType", "info.system.nodestatus", "info.system.nodeVendor", "info.system.notes", "info.system.ping", "info.system.roleType", "info.system.rttMonApplResponder", "info.system.serialNum", "info.system.server", "info.system.softwareImage", "info.system.softwareVersion", "info.system.sysContact", "info.system.sysLocation", "info.system.sysObjectName", "info.system.sysName", "info.system.sysUpTime",] | |||
| opcharts | opcharts_node_list_rows_per_page | 3 | <integer> | ||
| opcharts | opcharts_node_selector_sections | See Documentation | |||
| opcharts | opcharts_node_selector_show_more_at | 6 | <integer> | ||
| opcharts | opcharts_node_show_num_log_lines | 250 | <integer> | ||
| opcharts | opcharts_open_slave_nodes_in_new_window | false | true, false | ||
| opcharts | opcharts_redirect_slaves_to_nmis | false | true, false | ||
| opcharts | opcharts_topn_include_sparklines | 1 | <integer> | ||
| opcharts | opcharts_topn_max_updated_diff | 900 | <integer> | ||
| opcharts | opcharts_topn_properties | See Documentation | |||
| opcharts | opcharts_topn_time_between_runs | 299 | <integer> | ||
| opcharts | opcharts_upload_dir | <omk_public>/omk/uploads | <relative url> | ||
| opcharts | opcharts_upload_url | <omk_url_base>/uploads | <relative url> | ||
| opcharts | opchartsd_check_rate | 30 | <integer> | seconds, how often to check for new jobs | |
| opcharts | opchartsd_max_processes | 10 | <integer> | max allowed number of concurrent opchartsd worker processes | |
| opcharts | opchartsd_pid | /var/run/opchartsd.pid | <filepath> | ||
| opcharts | opchartsd_update_rate | 1 | <integer> | seconds, how often to wake up for job scheduling | |
| opcharts | upload_allowed_types | ['image/gif','image/jpeg','image/png','image/svg+xml'] |