From: bugreport%peshkin.net <>
Date: Fri, 4 Apr 2008 11:46:55 +0000 (+0000)
Subject: Bug 228423: Document adjustment of MySQL 4GB default table size limit
X-Git-Tag: bugzilla-3.1.3~185
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bfb9d464efa379d927c4a70e80a6e2939762decb;p=thirdparty%2Fbugzilla.git

Bug 228423: Document adjustment of MySQL 4GB default table size limit
r=kiko, a=justdave
---

diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
index 525f51e724..b7fa153ca7 100644
--- a/docs/en/xml/installation.xml
+++ b/docs/en/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.64 2008/04/04 06:46:54 jocuri%softhome.net Exp $ -->
+<!-- $Id: installation.xml,v 1.65 2008/04/04 06:46:55 bugreport%peshkin.net Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -608,6 +608,23 @@
   # Allow packets up to 1M
   set-variable = max_allowed_packet=1M</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 or if you are using RAID.  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>