Bug #71237 MEM 3.0.4 release notes provide incorrect information on new setting
Submitted: 27 Dec 2013 12:04 Modified: 22 Jan 2014 18:12
Reporter: Simon Mudd (OCA) Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Enterprise Monitor: Documentation Severity:S3 (Non-critical)
Version:3.0.4.2920 OS:Any
Assigned to: Philip Olson CPU Architecture:Any
Tags: host_and_datadir, host_plus_datadir, instance identity

[27 Dec 2013 12:04] Simon Mudd
Description:
The documentation for how MEM recognises a unique database instance provides conflicting instructions on how this should be configured. This lead to me to use the wrong values when trying to use the new functionality.

How to repeat:
This URL http://dev.mysql.com/doc/mysql-monitor/3.0/en/mem-unattended-execution.html specifies the parameters to use as mysql-identity-source=host_plus_datadir whereas the the release notes here http://dev.mysql.com/doc/mysql-monitor/3.0/en/mem-news-3-0-4.html says:

The mysql-identity-source Agent Installer (unattended) and agent.sh option was added. It determines how the unique identity for the MySQL instance is determined. The default option uses either the "server_uuid" variable if present, or generates a random new one. Passing in host_and_datadir uses a hash of the host identity and the path to the MySQL instance's data (datadir) directory.

I tried an install using the second option and this fails:

...

Error: There has been an error.
Invalid value "host_and_datadir" for --mysql-identity-source. Allowed values 
are: default host_plus_datadir
Use --help to get a list of valid options

Suggested fix:
Changing the parameter as stated in the first URL works.

I'd suggest fixing the URL for the release notes so that people don't use the wrong settings. Given the other documentation looks correct this should avoid any further confusion.
[31 Dec 2013 8:51] MySQL Verification Team
Hello Simon,

Thank you for the report.

Thanks,
Umesh
[22 Jan 2014 18:12] Philip Olson
Thank you for the bug report, this is now fixed.