Bug #49306 Changes Needed for 2.2 Agent Installer
Submitted: 1 Dec 2009 22:08 Modified: 14 Jan 2010 15:26
Reporter: Andy Bang Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Enterprise Monitor: Installing Severity:S3 (Non-critical)
Version:2.2.0.1560 OS:Any
Assigned to: BitRock Merlin CPU Architecture:Any

[1 Dec 2009 22:08] Andy Bang
Description:
Based on changes we have made to the Agent in our upcoming 2.2 release, please make the following changes to the Agent installer.

1) New parameters in INI file
-----------------------------
The following 2 new parameters need to be added to the INI file, but *only on Windows*:

lua-cpath=!\\lua-?.dll
lua-path=!\\..\\lib\\mysql-proxy\\lua\\?.lua;!\\..\\lib\\mysql-monitor-agent\\lua\\?.lua

We have added them to the INI file template, but commented out.  What would be best is if they appear as above, and uncommented, when installing on Windows, and don't appear at all when installing on other platforms.

Note that we have observed that after installation the above lines end up as follows:

lua-cpath=!\\\\lua-?.dll
lua-path=!\\\\..\\\\lib\\\\mysql-proxy\\\\lua\\\\?.lua;!\\\\..\\\\lib\\\\mysql-monitor-agent\\\\lua\\\\?.lua

So it appears that the installer is escaping the backslashes during installation.  Please be sure that when they show up, they match the first form exactly.

2) The libexec subdirectory is not needed on Windows
----------------------------------------------------
Along with bin, lib, and others, there's a new libexec subdirectory.  However, this subdirectory should not be included on Windows.  We see how to remove it in mysql-monitor-agent.xml for Windows, but it is not clear to us how to do the same thing in mysql-monitor-agent-update-module.xml, so we are temporarily adding an empty libexec subdirectory to keep everything working.  Please update the project XML files accordingly so we can stop manually adding this on Windows.

3) Generating the Agent UUID
----------------------------
Please generate the Agent UUID as follows:

    mysql-proxy --plugins=agent --agent-generate-uuid

The differences between this and the way you do it now are:

    1) Using mysql-proxy.exe instead of msyql-monitor-agent
    2) Don't pass the --defaults-file parameter

The reason is that mysql-proxy.exe is the same as mysql-monitor-agent.exe, but without a service interface, so it starts faster.

How to repeat:
N/A
[2 Dec 2009 19:12] BitRock Merlin
Patch sent to Keith.
[2 Dec 2009 22:18] Enterprise Tools JIRA Robot
Keith Russell writes: 
Patch installed in versions => 2.2.0.1563.
[17 Dec 2009 21:00] Enterprise Tools JIRA Robot
Carsten Segieth writes: 
checked OK with build 2.2.0.1588
[14 Jan 2010 15:26] MC Brown
A note has been added to the 2.2.0 changelog noting the change in behavior, and the documentation for 2.2.0 has been modified to show the new method for generating the UUID.