Managing SNMP in InterSystems IRIS
Since SNMP is a standard protocol, the management of the InterSystems IRIS subagent is minimal. The most important task is to verify that the SNMP master agent on the system is compatible with the Agent Extensibility (AgentX) protocol (see InterSystems IRIS as a Subagent) and it is active and listening for connections on the standard AgentX TCP port 705. On Windows systems, the system automatically installs a DLL to connect with the standard Windows SNMP service. Verify that the Windows SNMP service is installed and started either automatically or manually.
Important:
Some SNMP master agents, notably Net-SNMP on Linux, do not enable AgentX by default and do not use TCP port 705 by default once they are enabled. For Net-SNMP you must modify the snmpd.conf file to enable communications with the InterSystems IRIS subagent. Recent versions of Net-SNMP also implement VACM (View-based Access Control Model) security and, by default, only allow access to the mib-2.system subtree; the InterSystems IRIS subagent starts and runs without error, but no SNMP requests are forwarded to InterSystems IRIS. You must expand the “views” defined in snmpd.conf to include the InterSystems IRIS MIB subtree.
Next, enable the monitoring service using the following steps:
-
Navigate to the Services page in the Management Portal (System Administration > Security > Services).
-
Click the %Service_Monitor service.
-
Select the Service enabled check box and click Save.
-
Return to the list of services page and ensure that the %Service_Monitor service is enabled.
Finally, configure the InterSystems IRIS SNMP subagent to start automatically at InterSystems IRIS startup using the following steps:
-
Navigate to the Monitor Settings page in the Management Portal (System Administration > Configuration > Additional Settings > Monitor).
-
Select Yes for the Start SNMP Agent at System Startup setting and click Save.
-
When you edit this setting, the InterSystems IRIS end of the SNMP interface immediately stops and starts.
You can also start and stop the InterSystems IRIS SNMP subagent manually or programmatically using the ^SNMP routine:
Do start^SNMP(<port>,<timeout>)
Do stop^SNMP
where <port> is the TCP port for the connection (default is 705) and <timeout> is the TCP port read timeout value (default is 20 seconds). Until the <timeout> value is reached, InterSystems IRIS logs any problems encountered while establishing a connection or answering requests in the SNMP.LOG file in the install-dir\mgr directory.
Note:
When the SNMP master agent is restarted, it may be necessary to manually restart the InterSystems IRIS SNMP subagent using the ^SNMP routine, as described in the foregoing.
