Bug #48589 MySQL Proxy installation details need updating
Submitted: 6 Nov 2009 3:59 Modified: 4 Dec 2009 11:02
Reporter: Jonathon Coombes Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Proxy: Documentation Severity:S3 (Non-critical)
Version:0.7.x OS:Any
Assigned to: MC Brown CPU Architecture:Any
Tags: mem, monitor, mysql-proxy, proxy

[6 Nov 2009 3:59] Jonathon Coombes 
Description:
The documentation regarding the installation of the MySQL proxy is outdated. Details in the manual at:

http://dev.mysql.com/doc/refman/5.1/en/mysql-proxy-install-binary.html

indicate the method as:

shell> tar zxf mysql-proxy-0.5.0.tar.gz
shell> cp ./mysql-proxy-0.5.0/sbin/mysql-proxy /usr/local/sbin

The proxy version is now 0.7.2, but more importantly, the above breaks installation when using the community binaries downloaded from the MySQL site. 

The binaries are compiled so that the subdirectories are searched relatively to each other, which means that the user has to copy not only the sbin directory, but also libexec, share etc to the appropriate /usr/local directory, more simply to add the new install directory to their path.

How to repeat:
Download latest mysql-proxy binary for Linux.

Follow installation directions as defined in the manual.

Suggested fix:
shell> cd /usr/local
shell> tar zxf mysql-proxy-0.7.2.tar.gz
shell> ln -s mysql-proxy-0.7.2 mysql-proxy
shell> export PATH=$PATH:/usr/local/mysql-proxy/sbin:/usr/local/mysql-proxy/bin

Make the PATH change by updating the appropriate system file (/etc/profile, /etc/bashrc, /etc/login.defs etc)
[4 Dec 2009 11:02] MC Brown 
The documentation has been updated with the instructions
[4 Dec 2009 11:05] MC Brown 
The documentation has been updated with the instructions