MySQL Bugs: #56992: SNMP Trap settings are unclear between main settings and advisor level

Bug #56992	SNMP Trap settings are unclear between main settings and advisor level
Submitted:	24 Sep 2010 1:06	Modified:	28 Jan 2011 19:38
Reporter:	Jonathon Coombes	Email Updates:
Status:	Closed	Impact on me:	None
Category:	MySQL Enterprise Monitor: Documentation	Severity:	S2 (Serious)
Version:	2.2.3	OS:	Any
Assigned to:	John Russell	CPU Architecture:	Any
Tags:	documenation, mem, monitor, SNMP, traps

Description:
The manual states the following information:

Section 2.8.1
If you wish to enable SNMP traps globally, check the Enable SNMP Notifications checkbox. To enable SNMP traps only for specific rules run against specific servers or server groups leave this checkbox unchecked—enabling specific SNMP traps is done as rules are scheduled. For instructions on doing this see Section 2.3.2, “Scheduling Rules”. 

Section 2.3.2.1
If you haven't set up global SNMP traps and would like your Network Management System (NMS) to handle events related to a specific rule then check the Use SNMP Traps  checkbox. For more information about Simple Network Management Protocol (SNMP) see Simple Network Management Protocol (SNMP) Traps. 

This appears to be illogical and incorrect. The "Eanble SNMP Notifications" checkbox is what enable any form of SNMP trap to be used within MySQL Enterprise Monitor. 

How to repeat:
N/A

Suggested fix:
Correct the documentation so that SNMP is enabled globally and that this is a requirement for the rule specific SNMP traps as well.

Changing the wording of the "haven't" paragraph to:

If you have set up global SNMP traps, check the Use SNMP Traps
checkbox for a specific rule to make your Network Management System
(NMS) handle events related to that rule.

Changing the wording of global vs. specific instructions to:

To enable SNMP traps globally, check the Enable SNMP Notifications
checkbox. To enable SNMP traps for specific rules, also check the Use
SNMP Traps checkbox for each rule. 

These were the only places in the doc source I found that refer to these specific enabling actions for SNMP. (But the MEM doc source is somewhat scattered, so if I missed a reference please re-open.)

I'm making this change in the 2.2 and 2.3 manuals both.