Table of Contents
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.
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.
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-
,
where version
-win32.msiversion
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
.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:\
, where
%PROGRAMFILES%
\MySQL\MySQL
Tools for version
\%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
.
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”.
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-
.
Using a ZIP program, unpack it to the directory of your choice.
You may also want to create shortcuts to
version
-win32.zipMySQLAdministrator.exe
,
MySQLMigrationTool.exe
, and
MySQLQueryBrowser.exe
for your desktop or the
quick launch bar.
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.
Currently, the MySQL Migration Toolkit is not available for Linux.
The generic tar archive allows you to install MySQL GUI Tools on
most Linux distributions. The tarball file is called
mysql-gui-tools-
,
where version
.tar.gzversion
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-
directory.
version
/share/mysql-gui
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.
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
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-
file first in order to satisfy dependencies.
version
.rpm
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
, menu item. Likewise, with FC5, shortcuts are created under the 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.
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.
Currently, the MySQL Migration Toolkit is not available for Mac OS X.