Chapter 1 How to Install MySQL Utilities

Table of Contents

1.1 Prerequisites
1.2 Source Code
1.3 Oracle Linux and Red Hat Linux 6
1.4 Debian Linux
1.5 Microsoft Windows
1.6 OS X

MySQL Utilities is available in a number of repository formats. Although you may not see your specific operating system or platform listed, we provide general repository formats for most platforms. If none of the available repositories are applicable to your platform, you can use the source code repository and install MySQL Utilities from the command line.

The latest MySQL Utilities downloads are available at http://dev.mysql.com/downloads/utilities/1.6.html. The following sections discuss each repository.

For information specific to Fabric, see Installing and Configuring MySQL Fabric.

1.1 Prerequisites

MySQL Utilities requires Python 2.6. All of the Python code is written to conform to this version of Python.

For connecting to MySQL, MySQL Utilities requires a MySQL Connector/Python General Availability (GA) release (version 2.0.4/2.1.2 or later). If you do not have Connector/Python installed, see the download section for Connector/Python to download the appropriate repository.

1.2 Source Code

The source code repository for MySQL Utilities includes all of the utility code as well as the MySQL Utilities library and manual pages. It is available as an architecture independent distribution, in either Zip archive format (.zip file) or compressed tar archive format (.tar.gz file), or as a RPM package (.rpm file).

You can use this repository to install on any platform that has Python 2.6 installed. For example, you can use the .tar.gz version of the repository to install MySQL Utilities on OS X or Ubuntu. Choose "Linux - Generic" from the download page, and then the file name similar to mysql-utilities-1.6.4.tar.gz.

After you download and unpack the repository distribution, open a terminal window and navigate to the directory containing the file. Then unpack the file and install MySQL Utilities using the setup.py script as shown below.

shell> unzip mysql-utilities-1.6.4.zip
shell> cd mysql-utilities-1.6.4
shell> python ./setup.py build
shell> sudo python ./setup.py install
Note

Using this repository requires that you have Connector/Python installed or install it separately. For additional information, see Section 1.1, “Prerequisites”.

The source code is also available as a .rpm package, which can be downloaded and uncompressed as follows. More specifically, we first unpack the .rpm package then unzip the resulting .zip file.

On Mac and some Unix systems, you can use these commands.

shell> tar -tzvf mysql-utilities-1.6.4-1.el7.src.rpm
shell> tar -xzvf mysql-utilities-1.6.4-1.el7.src.rpm
shell> unzip mysql-utilities-1.6.4.zip

On Linux systems without native .rpm support, you can use these commands. For example, you can install rpm2cpio then run that utility to extract the .zip file then unzip it.

shell> sudo apt-get install rpm2cpio
shell> rpm2cpio mysql-utilities-1.6.4-1.el7.src.rpm | cpio -i --make-directories
shell> unzip mysql-utilities-1.6.4.zip

If these commands do not work for your platform, check your platform documentation for ways to open and inspect .rpm files.

1.3 Oracle Linux and Red Hat Linux 6

This repository is available as an architecture-independent RPM package (.rpm file).

After you download the package, install it using the following command or similar depending on your platform configuration:

shell> sudo rpm -i mysql-utilities-1.6.4-el6.noarch.rpm

You can also use the RPM package manager that is part of your base operating system. See your operating system documentation for more details.

Note

MySQL Utilities requires Connector/Python to be installed. For additional information, see Section 1.1, “Prerequisites”.

1.4 Debian Linux

The .deb repository is built for Debian 6 and is architecture independent. Although built expressly for Debian 6, it can be installed on various ports such as amd64, i386, etc.

Note

The repository does not work for Debian 7 because MySQL Utilities requires Python 2.6 and Debian 7 currently ships with Python 2.7. For Debian 7, use the source code repository to install MySQL Utilities.

After you download the file, install it using the following command or similar depending on your specific release or version of Debian:

shell> sudo dpkg -i mysql-utilities-1.6.4-debian6.0_all.deb
Note

MySQL Utilities requires Connector/Python to be installed. For additional information, see Section 1.1, “Prerequisites”.

1.5 Microsoft Windows

Either install MySQL Utilities using the MySQL Installer for Windows (a system that manages installations and updates for all MySQL products on Windows), or download and execute the standalone file. The download links are as follows:

  • MySQL Installer: Download and execute the MySQL Installer MSI file. Select the MySQL Utilities product and then proceed with the installation. This is the recommended approach, and automatically selects and installs the required prerequisites. See the MySQL Installer manual for additional details.

  • Standalone: Download and execute the MySQL Utilities standalone MSI file.

Note

MySQL Utilities requires Connector/Python to be installed. For additional information, see Section 1.1, “Prerequisites”.

1.6 OS X

The .dmg file available for OS X is built for x84-64 bit platforms, and supports OS X version 10.7 (Lion) and newer.

After you download the .dmg file, install MySQL Utilities by opening it and double clicking the .pkg file.

Note

MySQL Utilities requires Connector/Python to be installed. For additional information, see Section 1.1, “Prerequisites”.