Overview#

Allows for customization of iMonitor.

File Name and Location#

The file name and location is different on different OS systems.
ServerConfiguration File
NetWaresys:\system\ndsimon.ini
Windows NT and Windows 2000install directory\novell\NDS\ndsimon.ini
Linux, Solaris, AIX, and HP-UX/etc/ndsimon.conf
8.8 Linux/etc/opt/novell/eDirectory/conf/ndsimon.conf

There are two groups of parameters that you can set in the ndsimon configuration file.#

Parameters that apply to how the iMonitor executable itself runs#

Except on NetWare, when the iMonitor executable loads, it will attempt to listen on the traditional HTTP port 80. If that port is in use, it will back off to port 8008. If that port is in use, iMonitor will then back off again, increasing the port by 2 (8010, 8012, etc.) up to 8078.

Where SSL is configured and available, a similar bind pattern is attempted. First, port 81 is tried, and then 8009, 8011, 8013, etc.

This allows iMonitor to coexist with a Web server running on the same server. However, on some platforms, iMonitor might load before the installed Web server does, or you might want iMonitor to bind to a port of your choice. Both regular and SSL ports can be configured using the HttpPort and the HttpsPort parameters respectively. Commented-out examples exist in the shipping configuration file. By default, iMonitor binds to all NIC addresses on the server where it loads. However, there is an Address parameter that you can use to specify a list of addresses, in comma delimited format, to bind to.

On NetWare, similar port selection rules are used, but they are controlled by the NetWare Remote Manager HTTP stack (httpstk.nlm) and work as specified in the NetWare Remote Manager documentation.

Parameters that apply to specific features or pages#

The configuration file that ships with iMonitor contains samples of the parameters that can be modified. These parameters are preceded by a pound sign (#). This indicates that they are commented out or not used when iMonitor parses the configuration file. For the shipping configuration file, iMonitor uses all internally bound default values for these parameters. To enable any of these parameters or to add any parameters, simply delete the # character from the beginning of the line.

Ndsimon.conf Contents#

By default, all entries in the file are "commented" out and the file has no effect on the default installation.

The file is on 8.8 Linux /etc/opt/novell/eDirectory/conf/ndsimon.conf and the some sample contents are shown below:

#-----------------------------------------------------------------.
#   !!!      Note: By default this file has no effect.       !!!  |
#                                                                 | 
#        To change any of the defaults, you must remove           |
#        the '#' character on the line below the box.             | 
#       All the parameter values must be specified in UTF-8.      |
#-----------------------------------------------------------------'


#--------------------------------------------------------------------------------------------.
# Directory where error documentation is installed.                                          |
# Default for (WIN32) is  lang\ndsimon\errors\en_us                                          |
# Default for (NLM)   is sys:\system\lang\ndsimon\errors\en_us                               |
# Default for (UNIX)  is /opt/novell/eDirectory/lib/nds-modules/lang/ndsimon/errors/en_us    |
#--------------------------------------------------------------------------------------------'
#DirError: sys:\system\lang\ndsimon\errors\en_us 


#------------------------------------------------------------------------------------------.
# Directory where help documentation is installed.                                         |
# Default for (WIN32) is lang\ndsimon\help\en_us                                           |
# Default for (NLM)   is sys:\system\lang\ndsimon\help\en_us                               |
# Default for (UNIX)  is /opt/novell/eDirectory/lib/nds-modules/lang/ndsimon/help/en_us    |
#------------------------------------------------------------------------------------------'
#DirHelp: sys:\system\lang\ndsimon\help\en_us 


#----------------------------------------------------------------------------.
# Directory where images (icons, gifs, etc.) are installed.                  |
# Default for (WIN32) is ndsimon\public\images                               |
# Default for (NLM)   is sys:\system\ndsimon\public\images                   |
# Default for (UNIX)  is /opt/novell/eDirectory/lib/ndsimon/public/images    |
#----------------------------------------------------------------------------'
#DirImage: sys:\system\ndsimon\public\images 


#------------------------------------------------------------------------.
# Directory where trace files are kept.                                  |
# Default for (WIN32) is ndsimon\dstrace                                 |
# Default for (NLM)   is sys:\system\ndsimon\dstrace                     |
# Default for (UNIX)  is /var/opt/novell/eDirectory/data/dstrace         |
#------------------------------------------------------------------------'
#DirTrace: sys:\system\ndsimon\dstrace


#--------------------------------------------------------------------.
# Novell-supported URL where error code documentation can be located.|
#--------------------------------------------------------------------'
#ErrorDocsURL: http://www.novell.com/documentation/lg/nwec/docui/index.html

#----------------------------------------------------------------.
# Novell-supported URL where the user can search for information.|
#----------------------------------------------------------------'
#SupportSearchURL: http://www.novell.com/search/support/kb_index.html

#------------------------------------------------------------------------------------.
# Novell-supported URL where the user can search for information on specified errors.|
# The following options are appended together to form a query for errors like this.  |
#       SupportSearchErrorTidsURL Error Num SupportSearchErrorTidsURLQuery                |
#------------------------------------------------------------------------------------'
#SupportSearchErrorTidsURL: http://search.novell.com/NSearch/SearchServlet?template=ResultListTerseTemplate.html&numhits=20&theme=support&collection=Support&query=
#SupportSearchErrorTidsURLQuery: +(/Product_Class=Novell%20Directory%20Services)

#--------------------------------------------------------.
# Maximum number (up to 2500) of concurrent trace files. |
#--------------------------------------------------------'
#MaxTraceFiles: 11


#------------------------------------------------------------------------------------.
# The Maximum Trace File Size (up to 104857600 bytes - 100Mb) is specified in bytes. |
#------------------------------------------------------------------------------------'
#MaxTraceFileSize: 2097152


#-----------------------------------------------------------------------------.
# To start trace automatically when NDSiMon is loaded, simply copy the options|
# you want out of the query portion of the URL on the address line of your    |
# browser after visiting the trace options page and starting trace manually.  |
#SupportSearchErrorTidsURLQuery: +(/Product_Class=Novell%20Directory%20Services)

#--------------------------------------------------------.
# Maximum number (up to 2500) of concurrent trace files. |
#--------------------------------------------------------'
#MaxTraceFiles: 11


#------------------------------------------------------------------------------------.
# The Maximum Trace File Size (up to 104857600 bytes - 100Mb) is specified in bytes. |
#------------------------------------------------------------------------------------'
#MaxTraceFileSize: 2097152


#-----------------------------------------------------------------------------.
# To start trace automatically when NDSiMon is loaded, simply copy the options|
# you want out of the query portion of the URL on the address line of your    |
# browser after visiting the trace options page and starting trace manually.  |
# Below is an example.                                                        |
#-----------------------------------------------------------------------------'
#Trace Options:?Control=Submit&Option=4&Option=5&Option=7&Option=10&Option=13&Option=15&Option=19&Option=21&Option=23&Option=32&Option=34&Option=35&Option=36&Option=40&Option=43&Prefix=0&Prefix=1&Prefix=2

#-----------------------------------------------------------------------------.
# This switch is used to control access to the server.                        |
# 0 -> Allows access based on rights. This implies that without               |
#      authenticating, this server can be used to view anything [public]      |  
#      has rights to.                                                         |
# 1 -> (default) Must be authenticated as a valid user.                       |
# 2 -> Must be authenticated as a supervisor of this box.                     |
# 4 -> Must be authenticated as a console operator of this box.               |
# 8 -> Allows access if DS is closed.                                         |
# Setting LockMask: 14 means they must be a supervisor or console operator,   |
# or allow access if DS is closed.                                            |
#-----------------------------------------------------------------------------'
LockMask: 1


#-----------------------------------------------------------------------------.
# Number of minutes of inactivity allowed before a connection is logged out.  |
# The default is 30 minutes.                                                  |
# Note : This option controls the cached connection from NDSiMon to NDS,      |
# and allows iMon to reduce its resource requirements for users who have      |
# been idle for a long period of time. If a user rerequests information from  |
# the server after a prolonged idle period, it is possible that the browser   |
# will have retained cached credential information which will be used to      |
# reestablish the connection between iMon and NDS. To prevent the browser     |
# from retaining cached information, the user must close all instances of the |
# browser. This option only applies to non-NetWare platforms.                 |
#-----------------------------------------------------------------------------'
#Login Connection Timeout: 30


#-------------------------------------------------------------.
# Maximum numbers of object to be displayed when listing a    |
# container, or displaying the search result.                 |
#-------------------------------------------------------------'
#Max Object List: 3000
#Max Object List With Attrs: 1000
#Max Object List With Values: 50

#-------------------------------------------------------------.
# Enable/Disable display of Reference attribute.              |
# Enable = 1                                                  |
# Disable = 0                                                 |
#-------------------------------------------------------------'
#Browse Reference By Default: 0

#-----------------------------------------------------------------------------.
# This switch is used to control whether or not a configuration page will     |
# restore an NDS Name (e.g. DN) to a text edit box from a previously saved    |
# configuration page.                                                         |
# 0 -> (default) Restores the saved name to the configuration page. This      |
#      implies that [public] might be able to see a name that would not       |
#      otherwise be accessible if someone with supervisor rights had          |
#      previously saved the configuration page with that name in it.          |
# 1 -> Must be authenticated as a supervisor of this box.                     |
#-----------------------------------------------------------------------------'
#CfgRestoreName: 0

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-6) was last changed on 24-Nov-2012 09:31 by jim