diff options
| author | lpsolit%gmail.com <> | 2008-04-04 13:48:10 +0200 |
|---|---|---|
| committer | lpsolit%gmail.com <> | 2008-04-04 13:48:10 +0200 |
| commit | 2e0c05485e62673ef877e9882cae526f04b75c18 (patch) | |
| tree | f09b2eb18575bc2e41ebd411c1ed69498727be01 | |
| parent | daaf97abd74b1c4ab7b507e371550a2f34b59db7 (diff) | |
| download | bugzilla-2e0c05485e62673ef877e9882cae526f04b75c18.tar.gz bugzilla-2e0c05485e62673ef877e9882cae526f04b75c18.tar.xz | |
Documentation for bug 45207: Automated sanity check that can send an e-mail if there are problems - Patch by Sam Folk-Williams <sam.folkwilliams@gmail.com> r=LpSolit
| -rw-r--r-- | docs/en/xml/administration.xml | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml index f8c62913f..83f88630e 100644 --- a/docs/en/xml/administration.xml +++ b/docs/en/xml/administration.xml @@ -1845,6 +1845,44 @@ Support: ENTRY, DEFAULT/MANDATORY, CANEDIT </section> </section> + <section id="sanitycheck"> + <title>Checking and Maintaining Database Integrity</title> + + <para> + Over time it is possible for the Bugzilla database to become corrupt + or to have anomalies. + This could happen through normal usage of Bugzilla, manual database + administration outside of the Bugzilla user interface, or from some + other unexpected event. Bugzilla includes a "Sanity Check" script that + can perform several basic database checks, and repair certain problems or + inconsistencies. + </para> + <para> + To run the "Sanity Check" script, log in as an Administrator and click the + "Sanity Check" link in the admin page. Any problems that are found will be + displayed in red letters. If the script is capable of fixing a problem, + it will present a link to initiate the fix. If the script can not + fix the problem it will require manual database administration or recovery. + </para> + <para> + The "Sanity Check" script can also be run from the command line via the perl + script <filename>sanitycheck.pl</filename>. The script can also be run as + a <command>cron</command> job. Results will be delivered by email. + </para> + <para> + The "Sanity Check" script should be run on a regular basis as a matter of + best practice. + </para> + <warning> + <para> + The "Sanity Check" script is no substitute for a competent database + administrator. It is only designed to check and repair basic database + problems. + </para> + </warning> + + </section> + <section id="upgrading"> <title>Upgrading to New Releases</title> |