Author: paul
Date: 2010-09-24 20:51:13 +0200 (Fri, 24 Sep 2010)
New Revision: 22848
Log:
r63498@frost: paul | 2010-09-24 13:50:59 -0500
Document bug fix:
Bug#56150: Conflict between "shared" and "shared-compat" RPM should be avoided
Modified:
trunk/dynamic-docs/changelog/mysqld-2.xml
trunk/refman-5.5/installing-core.xml
trunk/refman-5.6/installing-core.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/mysqldoc/trunk:35498
07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/trunk:42410
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:43968
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/trunk:44480
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:63496
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:39036
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/trunk:39546
+ 07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/mysqldoc/trunk:35498
07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/trunk:42410
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:43968
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/trunk:44480
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:63498
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:39036
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/trunk:39546
Modified: trunk/dynamic-docs/changelog/mysqld-2.xml
===================================================================
--- trunk/dynamic-docs/changelog/mysqld-2.xml 2010-09-24 17:13:36 UTC (rev 22847)
+++ trunk/dynamic-docs/changelog/mysqld-2.xml 2010-09-24 18:51:13 UTC (rev 22848)
Changed blocks: 1, Lines Added: 85, Lines Deleted: 0; 3512 bytes
@@ -27099,4 +27099,89 @@
</logentry>
+ <logentry entrytype="feature">
+
+ <tags>
+ <manual type="installation"/>
+ </tags>
+
+ <bugs>
+ <fixes bugid="56150"/>
+ </bugs>
+
+ <versions>
+ <version ver="5.5.6"/>
+ <version ver="5.6.1"/>
+ </versions>
+
+ <message>
+
+ <para>
+ Previously, <literal>MySQL-shared-compat</literal> RPMs for
+ Linux contained both the current and previous client library
+ versions for the target platform. Thus, the package contents
+ overlapped with <literal>MySQL-shared</literal> RPMs, which
+ contain only the current client library version. This can result
+ in problems in two cases:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ When the <literal>MySQL-shared</literal> RPM is installed
+ but later it is determined that the
+ <literal>MySQL-shared-compat</literal> RPM is needed (an
+ application is installed that was linked against an older
+ client library). Installing the
+ <literal>MySQL-shared-compat</literal> RPM results in a
+ conflict because both include the current library version.
+ This can be overcome by using the <option>--force</option>
+ option to RPM, or by first uninstalling the
+ <literal>MySQL-shared</literal> RPM (which breaks
+ dependencies).
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ When the <literal>MySQL-shared-compat</literal> RPM is
+ installed, but old applications that require it are removed
+ or upgraded to the current library version. In this case,
+ <literal>MySQL-shared-compat</literal> cannot be replaced
+ with <literal>MySQL-shared</literal> as long as current
+ applications are installed. This can be overcome by using
+ the <option>--force</option> option to RPM, which incurs the
+ risk of breaking dependencies.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ <para>
+ Now the <literal>MySQL-shared-compat</literal> RPMs include only
+ older client library versions and no longer include the current
+ version, so that the <literal>MySQL-shared</literal> and
+ <literal>MySQL-shared-compat</literal> RPM contents no longer
+ overlap. The <literal>MySQL-shared-compat</literal> RPM can be
+ installed even if the <literal>MySQL-shared</literal> RPM is
+ installed, without producing conflicts related to the current
+ library version. The <literal>MySQL-shared-compat</literal> RPM
+ can be uninstalled when old applications are removed or upgraded
+ to the current library version, without breaking applications
+ that already use the current library version.
+ </para>
+
+ <para>
+ If you previously installed the
+ <literal>MySQL-shared-compat</literal> RPM because you needed
+ both the current and previous libraries, you should install both
+ the <literal>MySQL-shared</literal> and
+ <literal>MySQL-shared-compat</literal> RPMs now.
+ </para>
+
+ </message>
+
+ </logentry>
+
</changelog>
Modified: trunk/refman-5.5/installing-core.xml
===================================================================
--- trunk/refman-5.5/installing-core.xml 2010-09-24 17:13:36 UTC (rev 22847)
+++ trunk/refman-5.5/installing-core.xml 2010-09-24 18:51:13 UTC (rev 22848)
Changed blocks: 3, Lines Added: 12, Lines Deleted: 23; 3087 bytes
@@ -4843,21 +4843,6 @@
</para>
<para>
- Some Linux distributions still ship with MySQL 3.23 and they
- usually link applications dynamically to save disk space. If these
- shared libraries are in a separate package (for example,
- <literal>MySQL-shared</literal>), it is sufficient to simply leave
- this package installed and just upgrade the MySQL server and
- client packages (which are statically linked and do not depend on
- the shared libraries). For distributions that include the shared
- libraries in the same package as the MySQL server (for example,
- Red Hat Linux), you could either install our 3.23
- <literal>MySQL-shared</literal> RPM, or use the
- <literal>MySQL-shared-compat</literal> package instead. (Do not
- install both.)
- </para>
-
- <para>
The RPM packages shown in the following list are available. The
names shown here use a suffix of
<filename>.glibc23.i386.rpm</filename>, but particular packages
@@ -4922,8 +4907,8 @@
This package contains the shared libraries
(<literal>libmysqlclient.so*</literal>) that certain languages
and applications need to dynamically load and use MySQL. It
- contains single-threaded and thread-safe libraries. If you
- install this package, do not install the
+ contains single-threaded and thread-safe libraries. Prior to
+ MySQL 5.5.6, if you install this package, do not install the
<literal>MySQL-shared-compat</literal> package.
</para>
</listitem>
@@ -4935,12 +4920,16 @@
<para>
This package includes the shared libraries for MySQL 3.23,
- 4.0, and so on, up to the current release. It contains
- single-threaded and thread-safe libraries. Install this
- package instead of <literal>MySQL-shared</literal> if you have
- applications installed that are dynamically linked against
- older versions of MySQL but you want to upgrade to the current
- version without breaking the library dependencies.
+ 4.0, and so on. It contains single-threaded and thread-safe
+ libraries. Install this package if you have applications
+ installed that are dynamically linked against older versions
+ of MySQL but you want to upgrade to the current version
+ without breaking the library dependencies. Before MySQL 5.5.6,
+ <literal>MySQL-shared-compat</literal> also includes the
+ libraries for the current release, so if you install it, you
+ should not also install <literal>MySQL-shared</literal>. As of
+ 5.5.6, <literal>MySQL-shared-compat</literal> does not include
+ the current library version, so there is no conflict.
</para>
</listitem>
Modified: trunk/refman-5.6/installing-core.xml
===================================================================
--- trunk/refman-5.6/installing-core.xml 2010-09-24 17:13:36 UTC (rev 22847)
+++ trunk/refman-5.6/installing-core.xml 2010-09-24 18:51:13 UTC (rev 22848)
Changed blocks: 3, Lines Added: 7, Lines Deleted: 24; 2697 bytes
@@ -4843,21 +4843,6 @@
</para>
<para>
- Some Linux distributions still ship with MySQL 3.23 and they
- usually link applications dynamically to save disk space. If these
- shared libraries are in a separate package (for example,
- <literal>MySQL-shared</literal>), it is sufficient to simply leave
- this package installed and just upgrade the MySQL server and
- client packages (which are statically linked and do not depend on
- the shared libraries). For distributions that include the shared
- libraries in the same package as the MySQL server (for example,
- Red Hat Linux), you could either install our 3.23
- <literal>MySQL-shared</literal> RPM, or use the
- <literal>MySQL-shared-compat</literal> package instead. (Do not
- install both.)
- </para>
-
- <para>
The RPM packages shown in the following list are available. The
names shown here use a suffix of
<filename>.glibc23.i386.rpm</filename>, but particular packages
@@ -4922,9 +4907,7 @@
This package contains the shared libraries
(<literal>libmysqlclient.so*</literal>) that certain languages
and applications need to dynamically load and use MySQL. It
- contains single-threaded and thread-safe libraries. If you
- install this package, do not install the
- <literal>MySQL-shared-compat</literal> package.
+ contains single-threaded and thread-safe libraries.
</para>
</listitem>
@@ -4935,12 +4918,12 @@
<para>
This package includes the shared libraries for MySQL 3.23,
- 4.0, and so on, up to the current release. It contains
- single-threaded and thread-safe libraries. Install this
- package instead of <literal>MySQL-shared</literal> if you have
- applications installed that are dynamically linked against
- older versions of MySQL but you want to upgrade to the current
- version without breaking the library dependencies.
+ 4.0, and so on, but not the libraries for the current release.
+ It contains single-threaded and thread-safe libraries. Install
+ this package if you have applications installed that are
+ dynamically linked against older versions of MySQL but you
+ want to upgrade to the current version without breaking the
+ library dependencies.
</para>
</listitem>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r22848 - in trunk: . dynamic-docs/changelog refman-5.5 refman-5.6 | paul.dubois | 24 Sep |
