MONITORING
There are several different ways to use the Domino SNMP Agent on a partitioned server.
If you want to use the Domino SNMP Agent on only one of your partitions, then configure it on that partition just as you would on any server. Do not configure it on any other partitions. With this option, you will get full functionality and control for one server partition. It is not necessary to configure the LNSNMP.INI as described below.
If you want to use the Domino SNMP Agent for out-of-band control on multiple partitions, configure it on each partition. With this option, you can control servers individually and receive SNMP traps for each partition, but you lose the ability to query certain branches of the lnInfo branch of the MIB, including all Domino server statistics. It’s also not possible to use SNMP to start a server that hasn’t otherwise been started since SNMP was itself started. If you don’t need to use SNMP to start partitions, it is not necessary to configure the LNSNMP.INI as described below.
If you want to manage multiple partitions and always be able to start their servers using SNMP, then it’s necessary to configure those partitions into LNSNMP.INI as described below. Configuring LNSNMP.INI also causes the virtual rows in the MIB’s lnServerTable to be allocated in the order specified in LNSNMP.INI instead of in the order that the partitions are started. The MIB’s lnServerTable contains a virtual row for each partition, so having prior knowledge about which row will represent a particular partition could simplify certain management functions.
The Microsoft® Windows® operating system limits all SNMP traps to using one IP address. On UNIX®, each partition needs a separate DNS entry in order to distinguish each trap origin. On the client side, while traps from partitions will be received, not all SNMP consoles can associate traps from partitions to map objects. In particular, due to a limitation of WINSNMP, which is used with OpenView Professional Suite, it cannot assign traps to Domino icons.
Configuring the LNSNMP.INI file
If you need to always be able to start partitions using SNMP, or if you need to know which virtual row in the MIB’s lnServerTable a partition will occupy, then you should perform the following steps.
Note By adding a server to LNSNMP.INI you’re implicitly allowing SNMP to start that server if asked to do so. The server may then disallow further SNMP initiated starts once its own configuration options become known. This situation becomes possible each time the Domino SNMP Agent is started because the Domino SNMP Agent does not retain server configuration information when it is stopped.
1. Create a file called LNSNMP.INI in the appropriate directory depending on platform:
Data_Directory: The directory that is the server's Domino data directory for a given partition
Server_Name: The name of your Server
Domino_Partition_Number: This value is arbitrary because Domino no longer uses numbers to uniquely identify partitions. However, for historical reasons, a value must still be present.
For example, if you have a UNIX server with two partitions and data directories of /home/domino/venus and /home/domino/saturn, your LNSNMP.INI file should look like this:
Server=/home/domino/venus;Venus Server;1
Server=/home/domino/saturn;Saturn Server;2
Note The case of the text to the right of the equals sign is significant in UNIX® environments.
If LNSNMP does not start properly, then check that the LNSNMP.INI file is correct. LNSNMP will always attempt to reference the LNSNMP.INI file.
See also