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.

2.2. Installing Under Windows

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.

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.

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.

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, MySQLQueryBrowser.exe, and MySQLWorkbench.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.

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.

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. 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
 

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 -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-version.rpm file first in order to satisfy dependencies.

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 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 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.