The Sybase CEP distribution assumes that you have an existing SNMP implementation, including a properly configured and working daemon or service. The configuration files for Net-snmp 5.4 are included in the Sybase CEP distribution.
In order to preserve existing SNMP configuration files, environment variables are used to append the Sybase CEP Server information to the user 's configuration. Care has been taken to not overwrite user configuration files but, as in all similar installation processes, you should back up your files before the files are modified. Please refer to http://net-snmp.sourceforge.net/docs/man/snmp_config.html and similar installation documentation for a thorough discussion of Net-snmp configuration.
The environment settings for Sybase CEP Server are provided in source code form in the file c8_snmp_common.c which can be modified as needed. This initial directory configuration may not be adequate for most needs. In particular, the configuration does not provide for community string settings, authorizations, MIBs for the large variety of hardware available, and so on. These environment variables have been exposed in this manner in an attempt to accomodate the various build-time configurations available to Net-snmp 5.4. The variables documented below are hard-coded into the original source Net-snmp 5.4 by the configuration process at build time. By patching the Net-snmp 4.5 source code with these environment variables, you can create your own configurations.
An effort has been made to ensure proper Net-SNMP operations for a wide variety of configurations. The reason Sybase CEP "soft-coded" these variable is that the net-snmp installation hard-codes these variables at compile time. You may have different settings and the enviromental override scheme is an attempt to accomodate these differences. You should not have to adjust your Net-SNMP settings for Sybase CEP Server.
Because the environmental settings are within Sybase CEP Server process, these settings do not affect other processes.
The Sybase CEP implementation of SNMP assumes a daemon is running. The Net-SNMP service cannot co-exist with the Windows SNMP service unless specific configuration instructions are followed. Refer to the README.win32 instructions for this installation configuration. Your are responsible for this and all other Net-SNMP installation configurations.
In the following list, the C8_INSTALL is the directory in which Sybase CEP Server is installed. The default locations of Net-SNMP files and directories are assumed.
INSTALL_BASE=C8_INSTALL/snmp
This is the snmp directory in the installation directory of Sybase CEP Server. This value is normally set to C:/usr for Windows and /usr/local for Linux; the same defaults in the source distribution. By setting this value to C8_INSTALL/snmp, you insure that your configuration and MIB files cannot be overwritten.
NETSNMP_DEFAULT_MIBS=C:/usr/share/snmp/mibs; D:/usr/share/snmp/mibs; C8_INSTALL/mibs
This is the location of the MIBs directory. The Net-snmp defaults are first. This is because you are expected to maintain your own MIBs. The Sybase CEP MIBs cannot cover all possible hardware configurations. On Linux the default MIB directory is /usr/local/share/snmp/mibs . MIBs directories, just as in Net-snmp, must contain MIBs and only MIBs. Non-MIB files are likely to cause syntax errors that will crash the MIB parser.
NETSNMP_PERSISTENT_DIRECTORY=C8_INSTALL/snmp
This directory is used only by the snmpd daemon and is not expected to be used in the Sybase CEP Server environment. This corresponds to the SNMP_PERSISTENT_DIR variable.
SNMPLIBPATH=C8_INSTALL/snmp
This is the location of the net-snmp libraries. Overriding this variable should be performed with caution if your version of net-snmp is not Net-snmp 5.4.
SNMPSHAREPATH=C8_INSTALL/snmp
The shared path. On linux this is /usr/local/share/snmp
SNMPCONFPATH=C8_INSTALL/snmp
A list of directories to search for configuration files. Refer to http://net-snmp.sourceforge.net/docs/man/snmp_config.htm for more information.
SNMPDLMODPATH=C8_INSTALL/snmp.
The dynamically linked library path. See http://net-snmp.sourceforge.net/docs/man/snmp_config.html for more information.
NETSNMP_TEMP_FILE_PATTERN=C8_INSTALL/snmp/snmpdXXXXXX
The temp file pattern for the mktemp() function.