Chapter 2. Installation

Table of Contents

2.1. Introduction
2.2. Installing Under Windows
2.2.1. Using the Windows Installer
2.2.2. Installing From the ZIP File
2.3. Installing Under Linux
2.3.1. Installing the Generic Tarball
2.3.2. RPM Installation
2.4. Installing Under Mac OS X

2.1. Introduction

MySQL GUI Tools run on Windows, Linux, and Mac OS X. You can find MySQL GUI Tools for the operating system of your choice on the MySQL GUI Tools Downloads page.

The MySQL Migration Toolkit requires the Java Runtime Environment (JRE). The minimum version supported is 5.0 update 8.

2.2. Installing Under Windows

MySQL GUI Tools run on recent 32-bit Windows NT based operating systems, including Windows 2000, XP, Vista, and 2003. They don't run on Windows NT 4 and below.

2.2.1. Using the Windows Installer

MySQL GUI Tools can be installed on all Windows operating systems using the Windows Installer (.msi) installation package. The MSI package is contained within a ZIP archive named mysql-gui-tools-version-win32.msi, where version indicates the MySQL GUI Tools version.

The Microsoft Windows Installer Engine was updated with the release of Windows XP; those using a previous version of Windows can reference this Microsoft Knowledge Base article for information on upgrading to the latest version of the Windows Installer Engine.

In addition, Microsoft has recently introduced the WiX (Windows Installer XML) toolkit. This is the first highly acknowledged Open Source project from Microsoft. We have switched to WiX because it is an Open Source project and it allows us to handle the complete Windows installation process in a flexible manner using scripts.

Improving the MySQL Installation Wizard depends on the support and feedback of users like you. If you find that the MySQL Installation Wizard is lacking some feature important to you, or if you discover a bug, please report it in our bugs database using the instructions given in How to Report Bugs or Problems.

To install MySQL GUI Tools, right click on the MSI file and select Install.

Note

Installing MySQL GUI Tools on Windows Vista requires administrative privileges.

At the Setup Type window you may choose a complete or custom installation. If you do not wish to install all of the MySQL GUI Tools choose the custom option. Custom installation also gives you the option of installing support for languages other than English. MySQL GUI Tools supports, German, Greek, Japanese, Polish, and Brazilian Portuguese.

Unless you choose otherwise, MySQL GUI Tools are installed in C:\%PROGRAMFILES%\MySQL\MySQL Tools for version\, where %PROGRAMFILES% is the default directory for programs on your machine and version is the version number of MySQL GUI Tools. The %PROGRAMFILES%directory might be C:\Program Files or C:\programme.

Note

Installing MySQL GUI Tools using the Windows installer automatically creates entries in the Start menu.

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 on http://dev.mysql.com/downloads/. After downloading install this file as described in Section 2.2, “Installing Under Windows”.

2.2.2. Installing From the ZIP File

If you are having problems running the installer, as an alternative, you can download a ZIP file without an installer. That file is called mysql-gui-tools-noinstall-version-win32.zip. Using a ZIP program, unpack it to the directory of your choice. You may also want to create shortcuts to MySQLAdministrator.exe, MySQLMigrationTool.exe, and MySQLQueryBrowser.exe for your desktop or the quick launch bar.

2.3. Installing Under Linux

MySQL GUI Tools runs on Linux machines that have a graphical desktop installed. It is designed to run under the Gnome desktop with GTK2 and has been tested on Linux kernel versions 2.4 and 2.6. It should also run on other versions, and even on a number of Unix-like operating systems.

Note

Currently, the MySQL Migration Toolkit is not available for Linux.

2.3.1. Installing the Generic Tarball

The generic tar archive allows you to install MySQL GUI Tools on most Linux distributions. The tarball file is called mysql-gui-tools-version.tar.gz, where version indicates the MySQL GUI Tools version (for example, 5.0r3).

To see all files in the tarball, run this command:

shell> tar -tzf  mysql-gui-tools-version.tar.gz

To install MySQL GUI Tools, run this command:

shell> tar --directory=/opt -xzvf mysql-gui-tools-version.tar.gz

This installs the various application binaries in the directory, /opt/mysql-gui-tools-version.

If you install MySQL GUI Tools to the opt directory, icons for use with desktop shortcuts or for creating menu items are found under the opt/mysql-gui-tools-version/share/mysql-gui directory.

If you install MySQL GUI Tools to a directory other than the /opt directory, you will need to update the installation directory. This done by using the --update-paths option the first time that you run any one of the MySQL GUI Tools. For example, when running Query Browser for the first time, navigate to the installation directory and enter the following command:

shell> ./mysql-query-browser --update-paths

You need only run one MySQL GUI Tools application with the --update-path option. This updates the path for all MySQL GUI Tools.

If you do not use the default installation directory and create a Desktop shortcut using the .desktop files found under the mysql-gui-tools-5.0 directory you must edit the properties of any shortcut you create. Enter the correct path for the application on your system.

2.3.2. RPM Installation

In addition to a generic tarball, some distribution-specific RPMs are available. Currently these include Red Hat Enterprise Linux (RHEL) 3 and 4, Fedora Core 5 (FC5), and SuSE Linux 10.x. For FC5 and SuSE the gtkmm24 toolkit is a requirement for installing the RPM version of MySQL GUI Tools. You may also need to install the widget for displaying HTML pages. On FC5 you may install these RPMs from the command line in the following way:

shell> yum install gtkmm24 gtkhtml2
 

For installation on SuSE Linux:

shell> yast2 -i gtkmm24 gtkhtml2

Note

You may need root privileges to run the yast2 command.

The Red Hat RPMs are self contained so no additional packages need to be installed.

The RPM downloads are made up of the individual GUI Tools components combined into a single TAR archive. Extract the individual RPMs in the following way:

shell> tar -zxf mysql-gui-tools-version.tar.gz
 

This will decompress the RPM files to the current directory.

Install all the RPM files by typing:

shell> rpm -ivh mysql-*.rpm

If you are upgrading to a newer version of MySQL GUI Tools see Section 4.2.2, “RPM Upgrade”.

If you install the RPM files individually, you must install the mysql-gui-tools-version.rpm file first in order to satisfy dependencies.

If you wish, you may install only one of the MySQL GUI Tools. For example, to install MySQL Administrator only, do the following:

shell> rpm -ivh mysql-gui-toolsversion.rpm mysql-administratorversion.rpm

If possible, the RPM installation process creates shortcuts in the start menu of your window manager. For example, SuSE Linux with the KDE window manager adds shortcuts to the MySQL GUI Tools under the Development, Other Tools menu item. Likewise, with FC5, shortcuts are created under the Development menu item.

Icons for use with desktop shortcuts or for creating menu items are found under the /usr/share/mysql-gui directory.

See the MySQL GUI Tools Downloads page for the most up-to-date listing of the various RPM packages available.

2.4. Installing Under Mac OS X

To install MySQL GUI Tools under Mac OS X, double-click the downloaded .dmg file and wait for it to be opened and attached. Once a window containing the MySQL GUI Tools icon pops up, drag it to your Applications folder — or any other location you prefer.

Once the copy is complete, you may eject the disk image.

The minimum supported version is Mac OS X 10.4.

Note

Currently, the MySQL Migration Toolkit is not available for Mac OS X.