Bug #72764 http://dev.mysql.com/downloads/fabric/ does not mention requirements
Submitted: 27 May 2014 14:36 Modified: 5 Nov 2015 1:39
Reporter: Simon Mudd (OCA) Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Fabric: Documentation Severity:S3 (Non-critical)
Version:1.4.3 OS:Linux (CentOS 6)
Assigned to: CPU Architecture:Any

[27 May 2014 14:36] Simon Mudd
Description:
"MySQL Utilities 1.4.3 GA (including MySQL Fabric) has been released" has just been announced, and I looked to download it.

Currently I'm not using the yum repo and so went to: http://dev.mysql.com/downloads/fabric/

I downloaded the CentOS 6 rpms but I notice a dependency is missing.

How to repeat:
[smudd@myhost ~]$ ls *.rpm
mysql-utilities-1.4.3-1.el6.noarch.rpm  mysql-utilities-extra-1.4.3-1.el6.noarch.rpm
[smudd@myhost ~]$ sudo yum localinstall *.rpm
Loaded plugins: fastestmirror, priorities, ...
...
Examining mysql-utilities-1.4.3-1.el6.noarch.rpm: mysql-utilities-1.4.3-1.el6.noarch
Marking mysql-utilities-1.4.3-1.el6.noarch.rpm to be installed
Loading mirror speeds from cached hostfile
...
Examining mysql-utilities-extra-1.4.3-1.el6.noarch.rpm: mysql-utilities-extra-1.4.3-1.el6.noarch
Marking mysql-utilities-extra-1.4.3-1.el6.noarch.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package mysql-utilities.noarch 0:1.4.3-1.el6 will be installed
--> Processing Dependency: mysql-connector-python >= 1.2.1 for package: mysql-utilities-1.4.3-1.el6.noarch
---> Package mysql-utilities-extra.noarch 0:1.4.3-1.el6 will be installed
--> Finished Dependency Resolution
Error: Package: mysql-utilities-1.4.3-1.el6.noarch (/mysql-utilities-1.4.3-1.el6.noarch)
           Requires: mysql-connector-python >= 1.2.1
...

I see thus that mysql-connector-python is missing and not mentioned or referenced in the .../downloads/fabric/ page.

I notice that on my home server which I've configured to use the yum repo the required dependencies are pulled in:

[smudd@server ~]$ sudo yum install  mysql-utilities
...
Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package mysql-utilities.noarch 0:1.4.1-1.el6 will be updated
---> Package mysql-utilities.noarch 0:1.4.3-1.el6 will be an update
--> Processing Dependency: mysql-connector-python >= 1.2.1 for package: mysql-utilities-1.4.3-1.el6.noarch
--> Running transaction check
---> Package mysql-connector-python.noarch 0:1.1.4-1.el6 will be updated
---> Package mysql-connector-python.noarch 0:1.2.2-1.el6 will be an update
...
================================================================================================================================================================================================================
 Package                                                 Arch                                    Version                                      Repository                                                   Size
================================================================================================================================================================================================================
Updating:
 mysql-utilities                                         noarch                                  1.4.3-1.el6                                  mysql-tools-community                                       941 k
Updating for dependencies:
 mysql-connector-python                                  noarch                                  1.2.2-1.el6                                  mysql-connectors-community                                  185 k

Suggested fix:
Add documentation to explain that there are requirements and how to include them.

Add the required rpm package for mysql-connector-python, or maybe better still provide (as you do with the RHEL5 / RHEL6 rpms) an rpm bundle of all packages (they're tiny anyway) so that the utility rpms can be downloaded together with any non-OS packages.

Note: my understanding is that the "repo" is the preferred method for downloading MySQL (and utilities etc) for RHEL 6 and later servers, yet there's no such reference to this anywhere. Is that actually the case as I can imagine that supporting 2 different sets of packages for the same OS is rather tedious?

I have not looked to move over to the new repo for existing servers and MySQL packages partly as a result of bug#72230.

Perhaps the MySQL utilities and connectors rpms can be used independently with the http://dev.mysql.com/downloads/ provided rpms. If that is the case it would be good to say they can be safely used together as pulling down the packages from that repo and obviously its dependencies does seem to work correctly and is much easier.
[28 May 2014 5:51] MySQL Verification Team
Hello Simon,

Thank you for the bug report.
Verified as described.

Thanks,
Umesh
[28 May 2014 6:01] MySQL Verification Team
// CentOS release 6.5

internal]# sudo yum localinstall *.rpm
Loaded plugins: fastestmirror, refresh-packagekit, security
Setting up Local Package Process
Examining mysql-utilities-1.4.3-1.el6.noarch.rpm: mysql-utilities-1.4.3-1.el6.noarch
Marking mysql-utilities-1.4.3-1.el6.noarch.rpm to be installed
Loading mirror speeds from cached hostfile
 * base: centos.mbni.med.umich.edu
 * extras: centos.chi.host-engine.com
 * updates: centos.aol.com
Examining mysql-utilities-extra-1.4.3-1.el6.noarch.rpm: mysql-utilities-extra-1.4.3-1.el6.noarch
Marking mysql-utilities-extra-1.4.3-1.el6.noarch.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package mysql-utilities.noarch 0:1.4.3-1.el6 will be installed
--> Processing Dependency: mysql-connector-python >= 1.2.1 for package: mysql-utilities-1.4.3-1.el6.noarch
---> Package mysql-utilities-extra.noarch 0:1.4.3-1.el6 will be installed
--> Finished Dependency Resolution
Error: Package: mysql-utilities-1.4.3-1.el6.noarch (/mysql-utilities-1.4.3-1.el6.noarch)
           Requires: mysql-connector-python >= 1.2.1
 You could try using --skip-broken to work around the problem
 You could try running: rpm -Va --nofiles --nodigest
[29 Apr 2015 21:46] Philip Olson
Posted by developer:
 
The Fabric and Utilities documentation was updated to better reflect the Python 2.6 and Connector/Python 1.2.2+ prerequisites. A request (Eventum #50604) was made to the web team to update the download pages for both Fabric and Utilities, to either mention the prerequisites or simply link to the related documentation.

Sorry it took so long to handle this bug, but thank you for the bug report.

I'm leaving this report open until the download page situation is known/resolved.
[5 Nov 2015 1:39] Philip Olson
The dev.mysql.com download pages do not refer to prerequisites, but this
information is documented. As a side note, Fabric was split from Utilities
since this bug was created, but the bug still applies to both Utilities and
Fabric. Here is the documentation:

Utilities:

http://dev.mysql.com/doc/mysql-utilities/1.6/en/mysql-utils-install-prerequisi
tes.html

Fabric:
  http://dev.mysql.com/doc/mysql-fabric/1.6/en/fabric-download.html

It's an interesting time for Fabric as it's currently a labs release, so its
requirements are not yet defined, but the stable Fabric (with Utilities 1.5)
are defined in the documentation.

For these reasons, this bug report is being closed. Please comment if you
have concerns.