Skip to content

Commit

Permalink
Bug 1785943: Update the MySQL, Linux and Quick Start in the Installat…
Browse files Browse the repository at this point in the history 
…ion documentation 5.0 (#113)

* Update the Linux and Quick Start in the Installation documentation
* Update the notes to mention MySQL 8 incompatibility and MariaDB as a replacement
* Default to MariaDB and mention how it relates to MySQL
* Switch to mention how to install optional modules outside of dnf
  • Loading branch information
@hellcp
hellcp committed Sep 3, 2022
1 parent e36e9f9 commit 1f50516
Show file tree
Hide file tree
Showing 3 changed files with 201 additions and 115 deletions.
149 changes: 99 additions & 50 deletions docs/en/rst/installing/linux.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Install Packages
================

Use your distribution's package manager to install Perl, your preferred
database engine (MySQL if in doubt), and a webserver (Apache if in doubt).
database engine (MySQL or MariaDB if in doubt), and a webserver (Apache if in doubt).
Some distributions even have a Bugzilla package, although that will vary
in age.

Expand All @@ -28,64 +28,102 @@ is not found, just remove it from the list and reissue the command. If you
want to use a different database or webserver, substitute the package
names as appropriate.

Fedora and Red Hat
Fedora, CentOS Stream and RHEL
------------------

The following command will install Red Hat's packaged version of Bugzilla:
The following command will install Fedora's packaged version of Bugzilla:

:command:`yum install bugzilla httpd mysql-server`
:command:`dnf install bugzilla httpd mariadb-server`

Then, you can skip to :ref:`configuring your database <linux-config-database>`.
It may be useful to know that Fedora stores the Bugzilla files in
:file:`/usr/share/bugzilla`, so that's where you'll run :file:`checksetup.pl`.

If you want to install a version of Bugzilla from the Bugzilla project, you
will instead need:

:command:`yum install httpd mysql-server mod_perl mod_perl-devel httpd-devel
gd-devel mysql-devel
graphviz patchutils gcc 'perl(Apache2::SizeLimit)' 'perl(Authen::Radius)'
'perl(Authen::SASL)' 'perl(Cache::Memcached)' 'perl(CGI)' 'perl(Chart::Lines)'
'perl(Daemon::Generic)' 'perl(Date::Format)' 'perl(DateTime)'
'perl(DateTime::TimeZone)' 'perl(DBI)' 'perl(Digest::SHA)' 'perl(Email::MIME)'
'perl(Email::Reply)' 'perl(Email::Sender)' 'perl(Encode)' 'perl(Encode::Detect)'
'perl(File::MimeInfo::Magic)' 'perl(GD)' 'perl(GD::Graph)'
'perl(GD::Text)' 'perl(HTML::FormatText::WithLinks)' 'perl(HTML::Parser)'
'perl(HTML::Scrubber)' 'perl(IO::Scalar)' 'perl(JSON::RPC)' 'perl(JSON::XS)'
'perl(List::MoreUtils)' 'perl(LWP::UserAgent)' 'perl(Math::Random::ISAAC)'
'perl(MIME::Parser)' 'perl(mod_perl2)' 'perl(Net::LDAP)' 'perl(Net::SMTP::SSL)'
'perl(PatchReader)' 'perl(SOAP::Lite)' 'perl(Template)'
'perl(Template::Plugin::GD::Image)' 'perl(Test::Taint)' 'perl(TheSchwartz)'
'perl(URI)' 'perl(XMLRPC::Lite)' 'perl(XML::Twig)'`

If you are running RHEL6, you will have to enable the "RHEL Server Optional"
channel in RHN to get some of those packages.

If you plan to use a database other than MySQL, you will need to also install
If you want to install a version of Bugzilla from the Bugzilla project
or have it on RHEL or CentOS, you will need to do the following instead:

On CentOS Stream and RHEl, add the Fedora EPEL repo, in the way described
in the `installation instructions <https://docs.fedoraproject.org/en-US/epel/>`_.

Run the following to install the base Bugzilla dependencies:

:command:`dnf install git httpd httpd-devel mariadb-devel gcc
mariadb-server mod_perl mod_perl-devel 'perl(autodie)' 'perl(CGI)'
'perl(Date::Format)' 'perl(DateTime)' 'perl(DateTime::TimeZone)'
'perl(DBI)' 'perl(DBD::mysql)' 'perl(Digest::SHA)' 'perl(Email::MIME)'
'perl(Email::Sender)' 'perl(fields)' 'perl(JSON::XS)'
'perl(List::MoreUtils)' 'perl(Math::Random::ISAAC)' 'perl(Memoize)'
'perl(Safe)' 'perl(Template)' 'perl(URI)'`

On Fedora, all the optional dependencies are available:

:command:`dnf install gd-devel graphviz patchutils
'perl(Apache2::SizeLimit)' 'perl(Authen::Radius)' 'perl(Authen::SASL)'
'perl(Cache::Memcached)' 'perl(Chart::Lines)' 'perl(Daemon::Generic)'
'perl(Email::Reply)' 'perl(Encode)' 'perl(Encode::Detect)'
'perl(File::Copy::Recursive)' 'perl(File::MimeInfo::Magic)'
'perl(File::Which)' 'perl(GD)' 'perl(GD::Graph)' 'perl(GD::Text)' 'perl(HTML::FormatText::WithLinks)' 'perl(HTML::Parser)'
'perl(HTML::Scrubber)' 'perl(IO::Scalar)' 'perl(JSON::RPC)'
'perl(LWP::UserAgent)' 'perl(MIME::Parser)' 'perl(mod_perl2)'
'perl(Net::LDAP)' 'perl(Net::SMTP::SSL)' 'perl(PatchReader)'
'perl(SOAP::Lite)' 'perl(Template::Plugin::GD::Image)'
'perl(Test::Taint)' 'perl(TheSchwartz)' 'perl(XMLRPC::Lite)'
'perl(XML::Twig)'`

On CentOS Stream and RHEL with EPEL, some modules are missing in the
repositories, so use the following instead:

:command:`dnf install gd-devel graphviz patchutils
'perl(Apache2::SizeLimit)' 'perl(Authen::Radius)' 'perl(Authen::SASL)'
'perl(Cache::Memcached)' 'perl(Encode)' 'perl(Encode::Detect)'
'perl(File::Copy::Recursive)' 'perl(File::MimeInfo::Magic)'
'perl(File::Which)' 'perl(GD)' 'perl(GD::Graph)' 'perl(GD::Text)'
'perl(HTML::Parser)' 'perl(HTML::Scrubber)' 'perl(IO::Scalar)'
'perl(JSON::RPC)' 'perl(LWP::UserAgent)' 'perl(MIME::Parser)'
'perl(mod_perl2)' 'perl(Net::LDAP)' 'perl(Net::SMTP::SSL)'
'perl(SOAP::Lite)' 'perl(Test::Taint)' 'perl(XMLRPC::Lite)'
'perl(XML::Twig)'`

and install the missing optional modules with:

:command:`cd /var/www/html/bugzilla/ && ./install-module.pl Chart::Lines
Daemon::Generic Email::Reply HTML::FormatText::WithLinks PatchReader
Template::Plugin::GD::Image TheSchwartz`

If you plan to use a database other than MariaDB, you will need to also install
the appropriate packages for that.

Ubuntu and Debian
-----------------

:command:`apt-get install git nano`

:command:`apt-get install apache2 mysql-server libappconfig-perl
libdate-calc-perl libtemplate-perl libmime-perl build-essential
libdatetime-timezone-perl libdatetime-perl libemail-sender-perl
libemail-mime-perl libemail-mime-modifier-perl libdbi-perl libdbd-mysql-perl
libcgi-pm-perl libmath-random-isaac-perl libmath-random-isaac-xs-perl
apache2-mpm-prefork libapache2-mod-perl2 libapache2-mod-perl2-dev
libchart-perl libxml-perl libxml-twig-perl perlmagick libgd-graph-perl
libtemplate-plugin-gd-perl libsoap-lite-perl libhtml-scrubber-perl
libjson-rpc-perl libdaemon-generic-perl libtheschwartz-perl
libtest-taint-perl libauthen-radius-perl libfile-slurp-perl
libencode-detect-perl libmodule-build-perl libnet-ldap-perl
libauthen-sasl-perl libtemplate-perl-doc libfile-mimeinfo-perl
libhtml-formattext-withlinks-perl libgd-dev libmysqlclient-dev lynx-cur
graphviz python-sphinx`

If you plan to use a database other than MySQL, you will need to also install
the appropriate packages for that.
You can install required packages with:
:command:`apt install apache2 build-essential git
libcgi-pm-perl libdatetime-perl libdatetime-timezone-perl
libdbi-perl libdigest-sha-perl libemail-address-perl
libemail-mime-perl libemail-sender-perl libjson-xs-perl
liblist-moreutils-perl libmath-random-isaac-perl libtemplate-perl
libtimedate-perl liburi-perl libmariadb-dev-compat libdbd-mysql-perl
mariadb-server`

If you plan to use a database other than MariaDB, you will need to also install
the appropriate packages for that (in the command above, the packages required
for MariaDB are ``libdbd-mysql-perl``, ``libmariadb-dev-compat`` and ``mariadb-server``).

You can install optional packages with:
:command:`apt install graphviz libapache2-mod-perl2
libapache2-mod-perl2-dev libauthen-radius-perl libauthen-sasl-perl
libcache-memcached-perl libchart-perl libdaemon-generic-perl
libemail-reply-perl libencode-detect-perl libencode-perl
libfile-copy-recursive-perl libfile-mimeinfo-perl libfile-which-perl
libgd-dev libgd-graph-perl libgd-perl libgd-text-perl
libhtml-formattext-withlinks-perl libhtml-parser-perl
libhtml-scrubber-perl libio-stringy-perl libjson-rpc-perl
libmime-tools-perl libnet-ldap-perl libnet-smtp-ssl-perl
libsoap-lite-perl libtemplate-plugin-gd-perl libtest-taint-perl
libtheschwartz-perl libwww-perl libxmlrpc-lite-perl libxml-twig-perl`

There is no Ubuntu package for ``PatchReader`` and so you will have to install that module
outside the package manager if you want it.

Gentoo
------
Expand All @@ -98,6 +136,16 @@ USE flag enabled, Bugzilla will end up in :file:`/var/www/localhost/bugzilla`.
Then, you can skip to :ref:`configuring your database
<linux-config-database>`.

openSUSE
--------

:command:`zypper in bugzilla`

has been available in the openSUSE Leap repositories since 15.2 and is
in the openSUSE Tumbleweed repositories, also comes with an optional
``bugzilla-apache`` package, that allows you to skip to
:ref:`configuring your database <linux-config-database>`

.. _linux-install-perl:

Perl
Expand Down Expand Up @@ -185,10 +233,11 @@ We have specific configuration instructions for the following:
Database Engine
===============

Bugzilla supports MySQL, PostgreSQL, Oracle and SQLite as database servers.
You only require one of these systems to make use of Bugzilla. MySQL is
most commonly used. SQLite is good for trial installations as it requires no
setup. Configure your server according to the instructions below:
Bugzilla supports MySQL (or MariaDB, its compatible counterpart), PostgreSQL,
Oracle and SQLite as database servers. You only require one of these systems
to make use of Bugzilla. MySQL or MariaDB are most commonly used. SQLite is
good for trial installations as it requires no setup. Configure your server
according to the instructions below:

* :ref:`mysql`
* :ref:`postgresql`
Expand Down
18 changes: 12 additions & 6 deletions docs/en/rst/installing/mysql.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,13 @@
MySQL
#####

You need MySQL version 5.0.15 or higher.
It is strongly advised to use MariaDB which is a drop-in replacement for
MySQL and is fully compatible with Bugzilla. If MySQL must be used, be
aware that the minimum required version is MySQL 5.0.15 and that MySQL 8
or higher cannot be used at this time.

All commands in this document work regardless of whether MySQL or
MariaDB are used.

It's possible to test which version of MySQL you have installed with:

Expand All @@ -15,12 +21,12 @@ Installing
Windows
-------

Download the MySQL 32-bit or 64-bit MSI installer from the
`MySQL website <http://www.mysql.com/downloads/mysql/>`_ (~28 MB).
Download the MariaDB 32-bit or 64-bit MSI installer from the
`MariaDB website <https://mariadb.org/download/?t=mariadb&os=windows>`_ (~66 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 :file:`C:\\mysql`. Adjust paths appropriately if not.
MariaDB has a standard Windows installer. It's ok to select a the
default install options. The rest of this documentation assumes assume you
have installed MariaDB into :file:`C:\\mysql`. Adjust paths appropriately if not.

Linux/Mac OS X
--------------
Expand Down

0 comments on commit 1f50516

Please sign in to comment.