Setup Mysql Database for Bugzilla

February 5, 2016 by S4

Filed under Database, MySQL

Last modified July 15, 2016

Setup Mysql Database for Bugzilla

You need MySQL version 5.0.15 or higher.
It’s possible to test which version of MySQL you have installed with:
mysql -V
1.1 Installing
1.1.1 Windows
Download the MySQL 32-bit or 64-bit MSI installer from the MySQL website (~28 MB).
MySQL has a standard Windows installer. It’s ok to select a Typical MySQL install (the default). The rest of this
documentation assumes assume you have installed MySQL into C:\mysql. Adjust paths appropriately if not.
1.1.2 Linux/Mac OS X
The package install instructions given previously should have installed MySQL on your machine, if it didn’t come
with it already. Run:
and follow its advice.
If you did install MySQL manually rather than from a package, make sure the server is started when the machine

1.2 Add a User
You need to add a new MySQL user for Bugzilla to use. Run the mysql command-line client and enter:
TO bugs@localhost IDENTIFIED BY ‘$DB_PASS’;

You need to replace $DB_PASS with a strong password you have chosen. Write that password down somewhere.
The above command permits an account called bugs to connect from the local machine, localhost. Modify the
command to reflect your setup if you will be connecting from another machine or as a different user.
1.3 Change Configuration
To change MySQL’s configuration, you need to edit your MySQL configuration file, which is:
• Red Hat/Fedora: /etc/my.cnf
• Debian/Ubuntu: /etc/mysql/my.cnf
• Windows: C:\mysql\bin\my.ini
• Mac OS X: /etc/my/cnf

1.3.1 Allow Large Attachments and Many Comments
By default on some systems, MySQL will only allow you to insert things into the database that are smaller than 1MB.
Bugzilla attachments may be larger than this. Also, Bugzilla combines all comments on a single bug into one field for
full-text searching, and the combination of all comments on a single bug could in some cases be larger than 1MB.
We recommend that you allow at least 16MB packets by adding or altering the max_allowed_packet parameter
in your MySQL configuration in the [mysqld] section, so that the number is at least 16M, like this (note that it’s M,
not MB):
# Allow packets up to 16M


1.3.2 Allow Small Words in Full-Text Indexes
By default, words must be at least four characters in length in order to be indexed by MySQL’s full-text indexes. This
causes a lot of Bugzilla-specific words to be missed, including “cc”, “ftp” and “uri”.
MySQL can be configured to index those words by setting the ft_min_word_len param to the minimum size of
the words to index.
# Allow small words in full-text indexes
1.4 Permit Attachments Table to Grow Beyond 4GB
This is optional configuration for Bugzillas which are expected to become very large, and needs to be done after
Bugzilla is fully installed.
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, run the mysql command-line client and enter the following, replacing $bugs_db
with your Bugzilla database name (which is bugs by default):

USE $bugs_db;
ALTER TABLE attachments AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
The above command will change the limit to 20GB. MySQL will have to make a temporary copy of your entire table
to do this, so ideally you should do this when your attachments table is still small.
Note: If you have set the setting in Bugzilla which allows large attachments to be stored on disk, the above change
does not affect that.
This documentation undoubtedly has bugs; if you find some, please file them here.

Leave a Comment