List:Commits« Previous MessageNext Message »
From:paul.dubois Date:September 24 2010 6:51pm
Subject:svn commit - mysqldoc@docsrva: r22848 - in trunk: . dynamic-docs/changelog refman-5.5 refman-5.6
View as plain text  
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.6paul.dubois24 Sep