Overview #

The Imonitor ndsimonhealth configuration file lets you modify default settings for the Imonitor Agent Health page. You can enable or disable Agent Health options, set reporting levels and ranges for options, and set server reporting levels.

Location#

ServerConfiguration File
NetWaresys:\system\ndsimonhealth.ini
Windows NT and Windows 2000install directory\novell\NDS\ndsimon.ini
Linux, Solaris, AIX, and HP-UX/etc/ndsimonhealth.conf
8.8 Linux/etc/opt/novell/eDirectory/conf/ndsimonhealth.conf

There are three types of options you can set in the ndsimonhealth configuration file.#

Enable/disable only options#

To disable an option, remove the pound sign (#) from in front of the option and replace any levels listed after the colon (:) with OFF. To set reporting levels of these options, remove the # character from in front of the option and add a reporting level after the colon. Valid levels are WARN, MARGINAL, and SUSPECT. For these options, you can input only one reporting level.

General options that take a range of settings#

These options can be enabled and disabled or have their reporting level set, as well as the ranges for those reporting levels.

To set the reporting level for any of these options, use the option name followed by -active: and the reporting levels you want. For example, to set time_delta active, add the following line to the configuration file:

time_delta-active: WARN

To set time_delta inactive, add the following line to the configuration file:

time_delta-active: OFF

When entering ranges, the specified range is the range that this reporting level should not be displayed for.

See the time_delta example below for an example of how to set an option to be active for all three reporting levels and how to set the ranges. In this example, anything not in the range -2 to 2 is at least marginal, anything not in the range -5 to 5 is at least suspect, and anything not in the range -10 to 10 is a warning.

      time_delta-active: WARN | SUSPECT | MARGINAL 
      time_delta-Min_Warn:      -10 
      time_delta-Min_Suspect:    -5 
      time_delta-Min_Marginal:   -2 
      time_delta-Max_Marginal:    2 
      time_delta-Max_Suspect:     5 
      time_delta-Max_Warn:        10
For help on any of these options, enter the following URL in iMonitor:
http://XXX.XXX.XXX.XXX:PORT/nds/help?hbase=/nds/health/OPTION_NAME

XXX.XXX.XXX.XXX:PORT is the IP address and port where iMonitor can be reached, and OPTION_NAME is the name of the option you want help on (for example, time_delta).

To view the currently set levels and ranges, use your browser to go to the health page that contains the option you are interested in, then add the following to the end of the URL line in the browser:

&op=setup

Options that need custom or complex settings#

There are three different server reporting levels that can be set:
  • WARN detects servers running a version of eDirectory that should be upgraded as soon as possible.
  • SUSPECT detects servers running a version of eDirectory that should be noted for upgrade.
  • MARGINAL detects servers running a version of eDirectory that is not current.

These options set the reporting level if the server version falls within the specified range.

Sample Contents#

The ndsimonhealth configuration file lets you modify default settings for the Agent Health page. You can enable or disable Agent Health options, set reporting levels and ranges for options, and set server reporting levels.

The main file is /usr/share/ndsimon/ndsimonhealth.conf and some sample contents are shown below.

#-----------------------------------------------------------------.
# There are three distinct types of options you can set in this   |
# configuration file:                                             |
#                                                                 |
# 1.  Enable/disable only options.                                |
#                                                                 |
# 2.  General options that take a range of settings.              |
#                                                                 |
# 3.  Options that need custom or complex settings. These         |
#     options are listed at the end of this file, and each        |
#     option has comment lines describing how it should           |
#     be set.                                                     |
#-----------------------------------------------------------------.

#-----------------------------------------------------------------.
# The following items are enable/disable only.                    |
#                                                                 |
# To disable an option, remove the # sign from in front of the    |
# option and replace any levels listed after the colon (:) with   |
# OFF. To set reporting levels of these options, remove the #     |
# sign from in front of the option, and add a reporting level     |
# after the colon. Valid levels are WARN, MARGINAL, and SUSPECT.  |
# For these options, you can input only one reporting level.      |
#-----------------------------------------------------------------.

time_sync-active: WARN
agent_process_obit-active: MARGINAL
agent_process_extref-active: MARGINAL
agent_process_limber-active: MARGINAL
agent_process_schema-active: MARGINAL

#-----------------------------------------------------------------.
# The following options may be enabled/disabled or have their     |
# reporting level set, as well as the ranges for those reporting  |
# levels.                                                         |
#                                                                 |
# To set the reporting level for any of these options, use the    |
# option name followed by -active: and the reporting levels you   |
# want. For example, to set time_delta active, add the following  |
# line to this file:                                              |
#                                                                 |
# time_delta-active: WARN                                         |
#                                                                 |
# To set time_delta inactive, add the following line to this      |
# file:                                                           |
#                                                                 |
# time_delta-active: OFF                                          |
#                                                                 |
# Please note when entering ranges that the specified range is    |
# the range for which this reporting level should not be          |
# displayed.                                                      |
#                                                                 |
# See the time_delta example below for an example of how to set   |
# an option to be active for all three reporting levels, and      |
# how to set the ranges. In this example, anything not in the     |
# range -2 to 2 is at least marginal, anything not in the range   |
# -5 to 5 is at least suspect, and anything not in the range      |
# -10 to 10 is a warning.                                         |
#                                                                 |
# time_delta-active: WARN | SUSPECT | MARGINAL                    |
# time_delta-Min_Warn:     -10                                    |
# time_delta-Min_Suspect:  -5                                     |
# time_delta-Min_Marginal: -2                                     |
# time_delta-Max_Marginal:  2                                     |
# time_delta-Max_Suspect:   5                                     |
# time_delta-Max_Warn:      10                                    |
#                                                                 |
#                                                                 |
# For help on any of these options, enter the following URL:      |
#                                                                 |
# http://XXX.XXX.XXX.XXX:PORT/nds/help?hbase=/nds/health/         |
# OPTION_NAME                                                     |
#                                                                 |
# where XXX.XXX.XXX.XXX:PORT is the IP address and port where     |
# iMonitor can be reached, and OPTION_NAME is the name of the     |
# option for which help is desired (for example, time_delta).     |
#                                                                 |
# To view the currently set levels and ranges, use your browser   |
# to go to the health page that contains the option you are       |
# intrested in, then add the following to the end of the URL      |
# line in the browser:                                            |
#                                                                 |
# &op=setup                                                       |
#-----------------------------------------------------------------.

time_delta-active: WARN | SUSPECT
time_delta-Min_Warn:     -10
time_delta-Min_Suspect:  -5
time_delta-Max_Suspect:   5
time_delta-Max_Warn:      10

#unit is in seconds
replica_on-active: WARN | SUSPECT 
replica_on-Max_Suspect: 14400
replica_on-Max_Warn:    86400

#unit is in seconds
last_successful-active: WARN | SUSPECT 
last_successful-Max_Suspect: 14400
last_successful-Max_Warn:    86400

#unit is in seconds
last_attempt_sync-active: WARN | SUSPECT 
last_attempt_sync-Max_Suspect: 14400
last_attempt_sync-Max_Warn:    86400

#unit is in seconds
send_delta-active: WARN | SUSPECT 
send_delta-Max_Suspect: 14400
send_delta-Max_Warn:    86400

#unit is in seconds
recv_delta-active: WARN | SUSPECT 
recv_delta-Max_Suspect: 14400
recv_delta-Max_Warn:    86400

#unit is in seconds
replica_synthetic-active: WARN | SUSPECT 
replica_synthetic-Max_Suspect: 14400
replica_synthetic-Max_Warn:    86400

#unit is in seconds
replica_purge_time-active: WARN | SUSPECT 
replica_purge_time-Max_Suspect: 14400
replica_purge_time-Max_Warn:    86400

#unit is in seconds
perishable_data-active: WARN | SUSPECT 
perishable_data-Max_Suspect: 14400
perishable_data-Max_Warn:    86400

#unit is in seconds
schema_converge_time-active: WARN | SUSPECT 
schema_converge_time-Max_Suspect: 86400
schema_converge_time-Max_Warn:    172800

#unit is in seconds
schema_future_time-active: WARN | SUSPECT | MARGINAL
schema_future_time-Max_Marginal: 3600
schema_future_time-Max_Suspect: 86400
schema_future_time-Max_Warn: 604800

ring_readable-active: MARGINAL
ring_readable-Min_Marginal:   3
     
ring_subref-active: SUSPECT
ring_subref-Min_Suspect:        0

ring_total_count-active: MARGINAL
ring_total_count-Min_Marginal:   0

#long_db_lock is in milliseconds
long_db_lock-active: WARN | SUSPECT | MARGINAL
long_db_lock-Min_Warn:     0
long_db_lock-Min_Suspect:  0
long_db_lock-Min_Marginal: 0
long_db_lock-Max_Marginal:  60000
long_db_lock-Max_Suspect:   300000
long_db_lock-Max_Warn:      600000

max_db_writers-active: WARN | SUSPECT | MARGINAL
max_db_writers-Min_Warn:     0
max_db_writers-Min_Suspect:  0
max_db_writers-Min_Marginal: 0
max_db_writers-Max_Marginal: 15
max_db_writers-Max_Suspect:  30
max_db_writers-Max_Warn:     45

#db_wqueue_time is in milliseconds
db_wqueue_time-active: WARN | SUSPECT | MARGINAL
db_wqueue_time-Min_Warn:     0
db_wqueue_time-Min_Suspect:  0
db_wqueue_time-Min_Marginal: 0
db_wqueue_time-Max_Marginal: 60000
db_wqueue_time-Max_Suspect:  300000
db_wqueue_time-Max_Warn:     600000

max_accesses-active: WARN | SUSPECT | MARGINAL
max_accesses-Min_Warn:     0
max_accesses-Min_Suspect:  0
max_accesses-Min_Marginal: 0
max_accesses-Max_Marginal: 75
max_accesses-Max_Suspect:  150
max_accesses-Max_Warn:     250


#-----------------------------------------------------------------.
# There are three different server reporting levels that can be   |
# set:                                                            |
#                                                                 |
# 1. Warn detects servers running a version of eDirectory that    |
#    should be upgraded as soon as possible.                      |
# 2. Suspect detects servers running a version of eDirectory      |
#    that should be noted for upgrade.                            |
# 3. Marginal detects servers running a version of eDirectory     |
#    that is not current.                                         |
#                                                                 |
# Note: These options set the reporting level if the server       |
# version falls within the specified range.                       |
#-----------------------------------------------------------------.

ServerVersions-Warn: 6.0-6.08; 7.0-7.47; 8.0-8.50; 85.00-85.29
ServerVersions-Suspect: 6.08-6.16; 7.47-7.60; 8.51-8.82; 85.30-85.99; 10110.0-10350.06
#ServerVersions-Marginal: 6.0-85.22

#-----------------------------------------------------------------.
# ValidACLFlags   controls what flags iMonitor believes are valid |
# when Validating entries                                         |
#-----------------------------------------------------------------.

ValidACLFlags: 0x6000007F

#-----------------------------------------------------------------
# Compare_Exception_Class_Domain-List controls which list a differences 
# in domain containment for two compared class definitions should be placed in.  
# Valid values are "diff" for the difference list "expected" for the 
# expected differences list.  Cross tree comparisions differences for domain 
# containment will always be placed in the differences list.
#
# Default value: expected.
#------------------------------------------------------------------- 
Compare_Exception_Class_Domain-List: expected


#-----------------------------------------------------------------
# Compare_Exception_Attribute_String-List controls which list a
# a differences of the string flag for two compared email syntax attribute 
# definitions should be placed.  Valid values are "diff" for the difference list
# "expected" for the expected differences list.  Cross tree comparisions
# differences in the string flag will always be placed in the differences list.
#
# Default value: expected.
#------------------------------------------------------------------- 
 

More Information#

There might be more information for this subject on one of the following:

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-10) was last changed on 24-Nov-2012 09:20 by jim