Documentation patch for bug 314385: fine-tune the MySQL configuration instructions...

diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index 40c9e585c2835515971ab1ddfc8a0f2369c04c46..65219539866a3d90eee9ca7f764205a1e0f031ed 100644 (file)
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.72.2.30 2006/03/01 10:34:11 jocuri%softhome.net Exp $ -->
+<!-- $Id: installation.xml,v 1.72.2.31 2006/06/07 23:21:45 vladd%bugzilla.org Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -647,33 +647,7 @@
           </para>
         </note>
       </section>
-
-      <section>
-        <title>Permit attachments table to grow beyond 4GB</title>
-
-        <para>
-          By default, MySQL will limit the size of a table to 4GB.
-          This limit is present even if the underlying filesystem
-          has no such limit.  To set a higher limit, follow these
-          instructions.
-        </para>
-
-        <para>
-          Run the <filename>MySQL</filename> command-line client and
-          enter:
-        </para>
-
-        <screen>  <prompt>mysql&gt;</prompt> ALTER TABLE attachments 
-          AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
-        </screen>
-
-        <para>
-          The above command will change the limit to 20GB. Mysql will have 
-          to make a temporary copy of your entire table to do this. Ideally, 
-          you should do this when your attachments table is still small.
-        </para>
-      </section>
-            
+      
       <section id="install-setupdatabase-adduser">
         <title>Add a user to MySQL</title>
 
@@ -727,6 +701,36 @@
          '<replaceable>$db_pass</replaceable>';
   <prompt>mysql&gt;</prompt> FLUSH PRIVILEGES;</screen>
       </section>      
+      
+      <section>
+        <title>Permit attachments table to grow beyond 4GB</title>
+
+        <para>
+          By default, MySQL will limit the size of a table to 4GB.
+          This limit is present even if the underlying filesystem
+          has no such limit.  To set a higher limit, follow these
+          instructions.
+        </para>
+
+        <para>
+          After you have completed the rest of the installation (or at least the
+          database setup parts), you should run the <filename>MySQL</filename>
+          command-line client and enter the following, replacing <literal>$bugs_db</literal>
+          with your Bugzilla database name (<emphasis>bugs</emphasis> by default):
+        </para>
+
+        <screen>
+          <prompt>mysql&gt;</prompt> use <replaceable>$bugs_db</replaceable>
+          <prompt>mysql&gt;</prompt> ALTER TABLE attachments 
+          AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
+        </screen>
+
+        <para>
+          The above command will change the limit to 20GB. Mysql will have 
+          to make a temporary copy of your entire table to do this. Ideally, 
+          you should do this when your attachments table is still small. 
+        </para>
+      </section>
     </section>
 
     <section>