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.
MySQL GUI Tools run on recent 32-bit Windows NT based operating systems, including Windows 2000, XP, 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
.
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.
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
,
MySQLQueryBrowser.exe
, and
MySQLWorkbench.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.
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
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. On FC5 you may install this toolkit from the
command line in the following way:
shell> yum -install gtkmm24
For installation on SuSE Linux:
shell> yast2 -i gtkmm24
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 -iv mysql-*.rpm
If you are upgrading to a newer version of MySQL GUI Tools type:
shell> rpm -Uv mysql-*.rpm
If you install the RPM files individually, you must install the
mysql-gui-tools-
file first in order to satisfy dependencies.
version
.rpm
When upgrading, packages cannot be installed separately because version conflicts will arise.
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 -iv 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 Administrator 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.