Chapter 4. Upgrading MySQL GUI Tools

Table of Contents

4.1. Upgrading – Windows
4.2. Upgrading – Linux
4.2.1. Tarball Upgrade
4.2.2. RPM Upgrade
4.3. Upgrading – Mac OS X

4.1. Upgrading – Windows

If you are upgrading using the installer file follow the instructions given in Section 2.2, “Installing Under Windows”. There are is no need to remove your current installation.

If you are not using the installer file remove the current MySQL GUI Tools directory, and extract and install the new version as described in Section 2.2, “Installing Under Windows”.

MySQL Workbench is not included in the bundled MySQL GUI Tools download so must be installed separately. To do this, find the link to MySQL Workbench at http://dev.mysql.com/downloads/. After downloading, install this file as described in Section 2.2, “Installing Under Windows”.

4.2. Upgrading – Linux

4.2.1. Tarball Upgrade

If you are upgrading using the generic tarball file, remove the current MySQL GUI Tools directory, and extract and install the new tarball as described in Section 2.3.1, “Installing the Generic Tarball”.

4.2.2. RPM Upgrade

If you installed the MySQL GUI Tools using RPM files you can upgrade by navigating to the directory that contains the RPM files and typing at the command line:

shell> rpm -Uvh mysql-*.rpm
    

You may upgrade individual tools by using the U with the name of the specific tool you wish to upgrade. You will also need to upgrade the mysql-gui-tools-version.rpm file. For instance, to upgrade only the Administrator tool type:

shell> rpm -Uvh mysql-administrator-version.rpm mysql-gui-tools-version.rpm
    

Note

The mysql-gui-tools-version.rpm file is used by all MySQL GUI Tools. You must always upgrade this file.

When upgrading, packages cannot be installed separately because version conflicts will arise.

If your previous installation of MySQL GUI Tools included Workbench, (this tool has been removed from the GUI Tools package) you may encounter the following error when upgrading:

error: Failed dependencies:
mysql-gui-tools = old-version is needed by (installed)
mysql-workbench-version

To continue with the upgrade you must remove the Workbench RPM file. To determine the name of the Workbench RPM file issue the following command:

shell> rpm -qa  | grep workbench

Remove Workbench by issuing the command:

shell> rpm -e mysql-workbench-version

You should now be able to upgrade MySQL GUI Tools as described above.

If you do not wish to remove Workbench, perform an RPM installation rather than an upgrade. For instructions on doing this see Section 2.3.2, “RPM Installation”.

4.3. Upgrading – Mac OS X

Find the directory where you installed MySQL GUI Tools, and remove the applications by moving their icons to the Trash.

Install the upgrade as described in Section 2.4, “Installing Under Mac OS X”.