Bug #72853 Instructions for Installation with tarball are Incomplete

• Submitted: 3 Jun 2014 15:50
• Modified: 21 Jan 2015 22:17
• Reporter: Daniel So
• Status: Closed
• Category: Connector / ODBC Documentation
• Severity: S3 (Non-critical)
• Version: 5.3.2
• OS: Any
• Assigned to: Daniel So
• CPU Architecture: Any

[3 Jun 2014 15:50] Daniel So

Description:
Instructions for installing Connector ODBC on Linux using the generic tarball are incomplete:

===
To install the driver from a tarball distribution (.tar.gz file), download the latest version of the driver for your operating system and follow these steps that demonstrate the process using the Linux version of the tarball, substituting the appropriate file and directory names based on the package you download:

shell> su root
shell> gunzip mysql-connector-odbc-5.2.2-i686-pc-linux.tar.gz
shell> tar xvf mysql-connector-odbc-5.2.2-i686-pc-linux.tar
shell> cd mysql-connector-odbc-5.2.2-i686-pc-linux

Read the installation instructions in the INSTALL file and execute these commands. 
===

It is not enough to just refer users to the INSTALL file.

[Thanks to Perry Harrington for first reporting the issue.]

How to repeat:
Check http://dev.mysql.com/doc/connector-odbc/en/connector-odbc-installation-binary-unix-tarball...

Suggested fix:
- Fill in all the essential steps
- Put in some documentation for myodbc-installer, here or at another place
- Add references to the dependency on unixodbc
- Add other important information

[21 Jan 2015 22:17] Daniel So

The "Installing Connector/ODBC from a Binary Tarball Distribution" section of the manual (http://dev.mysql.com/doc/connector-odbc/en/connector-odbc-installation-binary-unix-tarball...) has been updated with clear instructions for installing Connector/ODBC with a tarball. The updates will appear in the next build of the document.