summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/sgml/database.sgml26
-rw-r--r--docs/xml/database.xml26
2 files changed, 52 insertions, 0 deletions
diff --git a/docs/sgml/database.sgml b/docs/sgml/database.sgml
index f0cda4589..ae1918207 100644
--- a/docs/sgml/database.sgml
+++ b/docs/sgml/database.sgml
@@ -8,6 +8,32 @@
tables to document dependencies. Any takers?</para>
</note>
+ <section id="dbmodify">
+ <title>Modifying Your Running System</title>
+
+ <para>Bugzilla optimizes database lookups by storing all relatively
+ static information in the
+ <filename>versioncache</filename> file, located in the
+ <filename class="directory">data/</filename>
+ subdirectory under your installation directory.</para>
+
+ <para>If you make a change to the structural data in your database (the
+ versions table for example), or to the
+ <quote>constants</quote>
+
+ encoded in <filename>defparams.pl</filename>, you will need to remove
+ the cached content from the data directory (by doing a
+ <quote>rm data/versioncache</quote>
+
+ ), or your changes won't show up.</para>
+
+ <para> <filename>versioncache</filename>
+ gets automatically regenerated whenever it's more than
+ an hour old, so Bugzilla will eventually notice your changes by itself,
+ but generally you want it to notice right away, so that you can test
+ things.</para>
+ </section>
+
<section id="dbdoc">
<title>MySQL Bugzilla Database Introduction</title>
diff --git a/docs/xml/database.xml b/docs/xml/database.xml
index f0cda4589..ae1918207 100644
--- a/docs/xml/database.xml
+++ b/docs/xml/database.xml
@@ -8,6 +8,32 @@
tables to document dependencies. Any takers?</para>
</note>
+ <section id="dbmodify">
+ <title>Modifying Your Running System</title>
+
+ <para>Bugzilla optimizes database lookups by storing all relatively
+ static information in the
+ <filename>versioncache</filename> file, located in the
+ <filename class="directory">data/</filename>
+ subdirectory under your installation directory.</para>
+
+ <para>If you make a change to the structural data in your database (the
+ versions table for example), or to the
+ <quote>constants</quote>
+
+ encoded in <filename>defparams.pl</filename>, you will need to remove
+ the cached content from the data directory (by doing a
+ <quote>rm data/versioncache</quote>
+
+ ), or your changes won't show up.</para>
+
+ <para> <filename>versioncache</filename>
+ gets automatically regenerated whenever it's more than
+ an hour old, so Bugzilla will eventually notice your changes by itself,
+ but generally you want it to notice right away, so that you can test
+ things.</para>
+ </section>
+
<section id="dbdoc">
<title>MySQL Bugzilla Database Introduction</title>