Author: plavin
Date: 2006-09-12 21:40:56 +0200 (Tue, 12 Sep 2006)
New Revision: 3333
Log:
Changes to Linux installation instructions
Modified:
trunk/guibook/guibook.xml
Modified: trunk/guibook/guibook.xml
===================================================================
--- trunk/guibook/guibook.xml 2006-09-12 17:22:55 UTC (rev 3332)
+++ trunk/guibook/guibook.xml 2006-09-12 19:40:56 UTC (rev 3333)
Changed blocks: 5, Lines Added: 115, Lines Deleted: 13; 6634 bytes
@@ -132,7 +132,7 @@
</para>
<para>
- &gui_tools; may be installed on all Windows
+ &gui_tools; can be installed on all Windows
operating systems using the Windows
Installer (<literal>.msi</literal>) installation package.
The MSI package is contained within a ZIP
@@ -153,17 +153,16 @@
<para>
To install &gui_tools;, right-click on the MSI file and select
<guimenu>Install</guimenu>. After prompting you for your
- preferences, installation will begin
- automatically.
+ preferences, installation will begin.
</para>
<para>
If you are having problems running the installer, as an
- alternative you can download a ZIP file without an installer. That
+ alternative, you can download a ZIP file without an installer. That
file is called
<literal>mysql-gui-tools-noinstall-<replaceable>version</replaceable>-win32.zip</literal>.
Using a ZIP program, unpack it to the directory of your choice. You
- may want to create shortcuts to
+ may also want to create shortcuts to
<literal>MySQLAdministrator.exe</literal>, <literal>MySQLMigrationTool.exe</literal>,
<literal>MySQLQueryBrowser.exe</literal>, and <literal>MySQLWorkbench.exe</literal> for your desktop or
the quick launch bar.
@@ -173,8 +172,8 @@
Unless you choose otherwise, &gui_tools; are installed in
<literal>C:\<replaceable>%PROGRAMFILES%</replaceable>\MySQL\MySQL Tools for <replaceable>version</replaceable>\</literal>,
where <replaceable>%PROGRAMFILES%</replaceable> is the default directory
- for programs on your machine. For example, this directory might be
- <literal>C:\Program Files</literal> or
+ for programs on your machine and <literal>version</literal> is the version number of &gui_tools;. The
+ <literal>%PROGRAMFILES%</literal>directory might be <literal>C:\Program Files</literal> or
<literal>C:\programme</literal>.
</para>
@@ -194,9 +193,13 @@
Unix-like operating systems.
</para>
+ <section>
+ <title>Installing a Generic Tarball</title>
+
<para>
- To install &gui_tools;, first download the installation
- tarball. The tarball file is called
+ The generic tar archive allows you to install &gui_tools;
+ on most Linux distributions.
+ The tarball file is called
<literal>mysql-gui-tools-<replaceable>version</replaceable>.tar.gz</literal>,
where <replaceable>version</replaceable> indicates the
&gui_tools; version (for example, 5.0r3).
@@ -230,16 +233,115 @@
<programlisting>
shell> ./mysql-administrator
-</programlisting>
+ </programlisting>
+
+ <para>
+ However, adding
+ <filename>/opt/mysql-gui-tools-<replaceable>version</replaceable></filename>
+ to the <literal>PATH</literal> makes it much simpler to run &gui_tools;.
+ </para>
+
+ </section>
+ <section>
+ <title>RPM Installation</title>
<para>
In addition to a generic tarball, some distribution-specific RPMs
- are available. See the <ulink url="http://dev.mysql.com/downloads/gui-tools/5.0.html">&gui_tools;
- Downloads</ulink> page for the most up-to-date listing.
+ 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 <literal>gtkmm24</literal> toolkit is a requirement for installing
+ the RPM version of &gui_tools;. On FC5 you may install this toolkit from the command line in the following way:
</para>
+
+ <programlisting>
+shell> yum -install gtkmm24
+ </programlisting>
+
+ <para>
+ For installation on SuSE Linux:
+ </para>
+
+ <programlisting>
+shell> yast2 -i gtkmm24
+ </programlisting>
+
+ <note>
+ <para>
+ You may need root privileges to run the
+ <literal>yast2</literal> command.
+ </para>
+ </note>
+
+ <para>
+ The Red Hat RPMs are self contained so no additional
+ packages need to be installed.
+ </para>
+
+ <para>
+ 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:
+ </para>
+
+ <programlisting>
+shell> tar -zxf mysql-gui-tools-<replaceable>version</replaceable>.tar.gz
+ </programlisting>
+
+ <para>
+ Install all the RPM files by typing:
+ </para>
+
+ <programlisting>
+shell> rpm -iv mysql-*.rpm
+ </programlisting>
+
+ <para>
+ If you install the RPM files individually, so that dependencies are satisfied, you
+ must install the <filename>mysql-gui-tools-<replaceable>version</replaceable>.rpm</filename>
+ file first.
+ </para>
+
+ <para>
+ When installed from RPM files the &gui_tools; are found in the
+ <filename>/usr/bin</filename> directory. This directory is
+ invariably included in the <literal>PATH</literal>
+ variable, so running any one of the &gui_tools; simply requires
+ typing the executable file name. For example:
+ </para>
+
+ <programlisting>
+shell> mysql-administrator
+ </programlisting>
+
+ <para>
+ The other executable file names are:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>mysql-query-browser</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>mysql-workbench</literal>
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <note>
+ <para>
+ The Mysql
+ </para>
+ </note>
+ <para>
+ See the <ulink url="http://dev.mysql.com/downloads/gui-tools/5.0.html">&gui_tools;
+ Downloads</ulink> page for the most up-to-date listing of the various RPM packages available.
+ </para>
</section>
-
+ </section>
<!-- END LINUX INSTALLATION -->
<section id="gui-tools-installation-osx">
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r3333 - trunk/guibook | plavin | 12 Sep |
