Bug #41652 2.12.2.1. Removing ... Service Manager needs Mac specific instructions
Submitted: 20 Dec 2008 2:11 Modified: 30 Jul 2009 10:19
Reporter: Donna Harmon Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Enterprise Monitor: Documentation Severity:S3 (Non-critical)
Version:2.0.1.7125 OS:MacOS
Assigned to: MC Brown CPU Architecture:Any

[20 Dec 2008 2:11] Donna Harmon
Description:
2.12.2. Removing the MySQL Enterprise Monitor: Unix and Mac OS X

The process for uninstalling the Service Manager and agent is different on Mac OS X than on Unix.  There needs to be a separate section 2.12.3 for Mac OS X uninstall.

How to repeat:
See 2.0 Doc

Suggested fix:
Create Separate Mac OS X section which includes the proper uninstall instructions which include running the "uninstall.app" located in the /Applications/mysql/enterprise/monitor/ directory.

Perhaps:
2.12.3. Removing the MySQL Enterprise Monitor: Mac OS X

2.12.3.1. Removing the MySQL Enterprise Service Manager

To remove the MySQL Enterprise Service Manager, run the uninstall.app located in the /Applications/mysql/enterprise/monitor/ directory.

During the uninstall process you will be given the option of saving existing data and log files. Choose this option if you plan to reinstall the MySQL Enterprise Monitor.

If you are not saving existing data, after uninstalling the MySQL Enterprise Service Manager you may remove the /Applications/mysql/enterprise/monitor directory.

Warning
If you chose not to remove existing data and log files when uninstalling the MySQL Enterprise Monitor do not remove the /Applications/mysql/enterprise/monitor directory; doing so will delete these files.

2.12.3.2. Removing the Monitor Agent

Prior to removal of the Monitor Agent you should stop any agents. Do this by changing to the init.d directory and issuing the
command, ./mysql-monitor-agent stop.

Run the uninstall.app file located in the /Applications/mysql/enterprise/agent directory

After uninstalling the Monitor Agent you may remove the /Applications/mysql/enterprise/agent directory.

Removing the Monitor Agent in this fashion will remove the default service, and all the configuration files for different instances.

2.12.3.2.1. Removing a Single Agent

If you are running more than one agent on the same machine and wish to remove only one of the agents, do not run the uninstall program.

To remove a single agent and leave other agents intact follow these steps:
1. Stop the agent
2. Confirm the location of the log files
3. Remove the agent as a daemon
4. Remove/Archive associated files

It is best to stop the agent before removing it; for instructions on stopping an agent see: Mac OS X – Section 2.5.2, “Starting and Stopping the Agent on Mac OS X”

You can confirm the location of the agent log files by checking the ini file. For more information on this topic see Section 2.6.1,
“MySQL Enterprise Monitor Agent (mysql-monitor-agent.ini) Configuration”.

You may then remove the agent as a daemon by removing its entry in the init.d directory.

You should also remove or archive any log or configuration files associated with this agent.

If you have installed any additional agents, remove them in the same fashion.

REMOVE: "and Mac OS X" from the 2.12.2 Heading
[30 Jul 2009 10:19] Enterprise Tools JIRA Robot
Martin MC Brown writes: 
Added an OSX uninstall section to the manual