Configuring the SNMP Agent
The SNMP agent monitors host resources and the SRC components that use the host resources. The SNMP agent obtains most of its information from the directory. A local configuration file primarily stores bootstrapping information that cannot be stored in the directory.
The SDX SNMP agent cannot act as a master agent, and it can communicate with master agents only by using the Agent Extensibility (AgentX) protocol. The SDX SNMP agent runs as a subagent to an installed AgentX master agent, such as the Net-SNMP agent. This setup means that SNMP requests to the master agent for SDX MIB objects (typically on port 161) are automatically redirected to the SDX SNMP agent (on its configured port).
You can use the local configuration tool to configure the SNMP agent.
For information about using the local configuration tool, see Chapter 37, Configuring Local Properties.
For more information about the SNMP agent, see SRC-PE Monitoring and Troubleshooting Guide, Chapter 9, Configuring the SNMP Traps on a Solaris Platform.
- On the SAE host, log in as
root
or as an authorized nonroot admin user.- Start the local configuration tool from the SNMP agent installation directory.
/opt/UMC/agent/etc/config -l
The SNMP Agent screen appears.
![]()
- Configure the SNMP agent by completing the fields in the tabs of the SNMP Agent screen. These sections describe the fields for each tab:
- Configuring Directory Connection Parameters—Main tab
- Configuring SNMP Agent Logging—Loggers tab
- Configuring Communication with the Master Agent—SNMP tab
- Configuring Other SDX SNMP Agent Parameters—Other tab
- Click OK when you have completed the configuration, or click Cancel to cancel all changes made since you started the tool.
- Restart the SNMP agent for the changes to take effect.
See Starting the SDX SNMP Agent.
Configuring Directory Connection Parameters
Use the Main tab to configure directory connection parameters.
Configuration Directory URL
- URL of the directory server that stores the SNMP agent configuration data.
- Value—URL in the format ldap://<URL>
- Default—ldap://127.0.0.1/389
Backup Configuration Directory URLs
- URL of the backup directory server that stores the SNMP agent configuration data.
- Value—URL in the format ldap://<URL>
- Guidelines—Use a semicolon to separate URLs for multiple backup directory servers. Do not insert spaces on either side of the semicolon.
- Default—ldap://127.0.0.1/389
- Example—ldap://127.153.27.1/389;ldap://192.168.0.1/389
Directory Base DN
- The distinguished name (DN) of the directory used for the SNMP agent configuration data.
- Value—<DN>
- Guidelines—You must set this attribute if you use a directory-naming scheme different from the default.
- Default—o=umc
Configuration Directory Base DN
- The DN of the system management configuration in the directory server that provides the remaining configuration for the SNMP agent. If the entry does not exist, the entry and the subentries for the components and traps is automatically created in the system management configuration.
- Value—<DN>
- Guidelines—You can use the special value <base> to refer to the globally configured base DN.
- Default—ou=POP-ID, ou=System Management, ou=Configuration, o=Management, <base>
Configuration Directory Authentication DN
- The DN of the entry in the directory server that authenticates the SNMP agent's directory bind.
- Value—<DN>
- Guidelines—You can use the special value <base> to refer to the globally configured base DN.
- Default—cn=sysman, ou=components, o=operators, <base>
Configuration Directory Password
Connect Timeout [s]
- The time limit for establishing a connection to the directory server.
- Value—Number of seconds in the range 1-2147483. If you enter 0 or a negative value, the default configuration of the host's operating system is used.
- Default—20
Configuring SNMP Agent Logging
Use the Loggers tab shown in Figure 24 to configure the SNMP agent logging facility.
For more information about the logging attributes and about cleaning the logs, see SRC-PE Monitoring and Troubleshooting Guide, Chapter 4, Configuring Logging for SRC Components on a Solaris Platform.
![]()
Severity Levels
Log filters let you specify the level of severity for the event messages to be saved in log files. The event filter provides 128 levels of severity, numbered 1-127. A higher number indicates a higher level of severity. Common levels of severity also have a specific name, as shown in Table 23.
Enable info-level logging only when you are initially setting up the SRC software or when you are troubleshooting. Do not leave info-level logging on during normal network operation. Do not enable debug logs unless you have been advised to do so by the Juniper Networks Technical Assistance Center. During normal network operations, enable error-level logging.
Error Log Filter
- Enable or disable the error log, and specify the minimum severity level of event messages saved to the log file.
- Value—Severity level specified by name or number. See Severity Levels. The format is:
Error Log File
- Filename and path of the log to which error event messages are saved.
- Value—Path and filename of the log file in the format <pathname>/<filename.log>
Error Rollover File
- Filename of the rollover log file. When the log rollover size is exceeded, the contents of the primary log file are saved to the rollover file.
- Value—Path and filename of the rollover file in the format <pathname>/<filename.alt>
- <pathname>—Directory in which the rollover log file is stored
- <filename.alt>—Name of the rollover log file
Error Log Rollover Size
- Size of the primary log. If the rollover size is exceeded, the contents of the primary log are saved to the rollover log, overwriting any previous contents. New events are saved to the emptied primary log.
- Value—Number of kilobytes in the range 0-4294967295
- Default—1000000
Info Log Filter
- Enable or disable the info log, and specify the minimum severity level of event messages saved to the log file.
- Value—Severity level specified by name or number. See Severity Levels. The format is:
Info Log File
- Filename and path of the log to which info event messages are saved.
- Value—Path and filename of the log file in the format <pathname>/<filename.log>
Info Log Rollover File
- Filename of the rollover log file. When the log rollover size is exceeded, the contents of the primary log file are saved to the rollover file.
- Value—Path and filename of the rollover file in the format <pathname>/<filename.alt>
Info Log Rollover Size
- Size of the primary info log. When the rollover size is exceeded, the contents of the primary log are saved to the rollover log, overwriting any previous contents. New events are saved to the emptied primary log.
- Value—Number of kilobytes in the range 0-4294967295
- Default—1000000
Debug Log Filter
- Enable or disable the debug log, and specify the minimum severity level of event messages saved to the log file.
- Value—Severity level specified by name or number. See Severity Levels. The format is:
Debug Log File
- Filename of the log to which event messages are saved.
- Value—Path and filename of the log file in the format <pathname>/<filename.log>
Debug Log Rollover File
- Filename of the rollover log file. When the log rollover size is exceeded, the contents of the primary log file are saved to the rollover file.
- Value—Path and filename of the log file in the format <pathname>/<filename.alt>
Debug Log Rollover Size
- Size of the primary log. When the rollover size is exceeded, the contents of the primary log are saved to the rollover log, overwriting any previous contents. New events are saved to the emptied primary log.
- Value—Number of kilobytes in the range 0-4294967295
- Default—1000000
Error Syslog Filter
- Enable or disable the error system log, and specify the minimum severity level of event messages saved to the log file.
- Value—Severity level specified by name or number. See Severity Levels. The format is:
Error Syslog Hostname
- IP address or name of a host that collects error event messages by means of a standard system logging process.
- Value—IP address or hostname
- Default—loghost
Info Syslog Filter
- Enable or disable the information system log, and specify the minimum severity level of event messages saved to the log file.
- Value—Severity level specified by name or number. See Severity Levels. The format is:
Info Syslog Hostname
- IP address or name of a host that collects warning event messages by means of a standard system logging process.
- Value—IP address or hostname
- Default—loghost
Configuring Communication with the Master Agent
Use the SNMP tab shown in Figure 25 to configure communication with the SNMP master agent.
NOTE: If you change any of the parameters with the local configuration tool, you must restart the SDX SNMP agent.
![]()
Master Agent Port
- TCP port on which the SDX SNMP agent initiates the AgentX connection with the master agent. You must configure your master agent to accept AgentX connections from the SDX SNMP agent host on this port.
- Value—TCP port number
- Default—705
Master Agent IP Address
Configuring Other SDX SNMP Agent Parameters
Use the Other tab, shown in Figure 26, to configure parameters for the Java Runtime Environment (JRE), trap history, and the watchdog program.
![]()
Java Runtime Environment
Java Heap Size
- Maximum amount of memory available to the JRE.
- Value—Number of megabytes in the format <integer>m
- Guidelines—Change this value if you have problems caused by lack of memory. Set the value lower than the available physical memory to avoid low performance caused by disk swapping.
- Default—160m
Trap History Table Size
WatchDog Retries
- Number of times the agent watchdog attempts to restart the agent before sending a trap notification that the agent restart has failed.
- Value—Integer in the range 1-2147483647; 0 or a negative value suppresses the trap
- Default—10
Watchdog
- Polling interval at which the agent watchdog checks whether the agent is running correctly.
- Value—Number of seconds in the range 0-1000000000
- Default—100
Sysman Agent IOR Directory
- Folder that contains the interoperable object reference (IOR) files for SRC components. When the SNMP agent starts, it uses the IOR files in this directory to find SRC components that are already running so that it can connect to them. The SNMP agent also writes its IOR file to this directory so that components that start after the SNMP agent can find and connect to the SNMP agent.
- Value—Path to the folder that contains the IOR files
- Guidelines—By default, the IOR file is in the var folder, which is relative to the SNMP agent installation folder (/opt/UMC/agent). You need to change this property only if you installed the SNMP agent in a folder other than the default folder, or if you previously changed this property and now need it to point to the folder where the IOR file currently resides.
- Default—/var