131 lines
4.1 KiB
ReStructuredText
131 lines
4.1 KiB
ReStructuredText
.. _mac-os-x:
|
|
|
|
Mac OS X
|
|
########
|
|
|
|
.. _macosx-install-packages:
|
|
|
|
.. note:: The Bugzilla team has very little Mac expertise and we've not been
|
|
able to do a successful install of the latest version. We got
|
|
close, though. If you've managed it, tell us how and we can update
|
|
these docs!
|
|
|
|
Install Packages
|
|
================
|
|
|
|
OS X 10.7 provides Perl 5.12 and Apache 2.2. Install the following additional
|
|
packages:
|
|
|
|
* git: Download an installer from
|
|
`the git website <http://www.git-scm.com/downloads>`_.
|
|
* MySQL: Download an installer from
|
|
`the MySQL website <http://dev.mysql.com/downloads/mysql/>`_.
|
|
|
|
.. _macosx-install-bzfiles:
|
|
|
|
Bugzilla
|
|
========
|
|
|
|
The best way to get Bugzilla is to check it out from git:
|
|
|
|
:command:`git clone --branch bugzilla-X.X-stable https://git.mozilla.org/bugzilla/bugzilla`
|
|
|
|
Run the above command in your home directory, replacing "X.X" with the 2-digit
|
|
version number of the stable release of Bugzilla that you want - e.g. "4.4".
|
|
This will place Bugzilla in the directory :file:`$HOME/bugzilla`.
|
|
|
|
If that's not possible, you can
|
|
`download a tarball of Bugzilla <http://www.bugzilla.org/download/>`_.
|
|
|
|
.. _macosx-libraries:
|
|
|
|
Additional System Libraries
|
|
===========================
|
|
|
|
Apple does not include the GD library with Mac OS X. Bugzilla needs this if
|
|
you want to display bug graphs, and you need to install it before you try
|
|
installing the GD Perl module.
|
|
|
|
You can use `MacPorts <http://www.macports.org/>`_, `Homebrew <http://brew.sh/>`_ or
|
|
`Fink <http://sourceforge.net/projects/fink/>`_, all of which can install common
|
|
Unix programs on Mac OS X.
|
|
|
|
If you don't have one of the above installed already, pick one and follow the
|
|
instructions for setting it up. Then, use it to install the :file:`gd2` package
|
|
(MacPorts/Fink) or the :file:`gd` package (Brew).
|
|
|
|
The package manager may prompt you to install a number of dependencies; you
|
|
will need to agree to this.
|
|
|
|
.. note:: To prevent creating conflicts with the software that Apple
|
|
installs by default, Fink creates its own directory tree at :file:`/sw`
|
|
where it installs most of
|
|
the software that it installs. This means your libraries and headers
|
|
will be at :file:`/sw/lib` and :file:`/sw/include` instead
|
|
of :file:`/usr/lib` and :file:`/usr/include`. When the
|
|
Perl module config script for the GD module asks where your :file:`libgd`
|
|
is, be sure to tell it :file:`/sw/lib`.
|
|
|
|
.. _macosx-install-perl-modules:
|
|
|
|
Perl Modules
|
|
============
|
|
|
|
Bugzilla requires a number of Perl modules. On Mac OS X, the easiest thing to
|
|
do is to install local copies (rather than system-wide copies) of any ones
|
|
that you don't already have. However, if you do want to install them
|
|
system-wide, run the below commands as root with the :command:`--global`
|
|
option.
|
|
|
|
To check whether you have all the required modules and what is still missing,
|
|
run:
|
|
|
|
:command:`perl checksetup.pl --check-modules`
|
|
|
|
You can run this command as many times as necessary.
|
|
|
|
Install all missing modules locally like this:
|
|
|
|
:command:`perl install-module.pl --all`
|
|
|
|
.. _macosx-config-webserver:
|
|
|
|
Web Server
|
|
==========
|
|
|
|
Any web server that is capable of running CGI scripts can be made to work.
|
|
We have specific configuration instructions for the following:
|
|
|
|
* :ref:`apache`
|
|
|
|
You'll need to create a symbolic link so the webserver can see Bugzilla:
|
|
|
|
:command:`cd /Library/WebServer/Documents`
|
|
|
|
:command:`sudo ln -s $HOME/bugzilla bugzilla`
|
|
|
|
In :guilabel:`System Preferences` --> :guilabel:`Sharing`, enable the
|
|
:guilabel:`Web Sharing` checkbox to start Apache.
|
|
|
|
.. _macosx-config-database:
|
|
|
|
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 on Mac OS X. (In fact, we have no reports of anyone using
|
|
anything else.) Configure your server according to the instructions below:
|
|
|
|
* :ref:`mysql`
|
|
* :ref:`postgresql`
|
|
* :ref:`oracle`
|
|
* :ref:`sqlite`
|
|
|
|
.. |checksetupcommand| replace:: :command:`perl checksetup.pl`
|
|
.. |testservercommand| replace:: :command:`perl testserver.pl http://<your-bugzilla-server>/`
|
|
|
|
.. include:: installing-end.inc.rst
|
|
|
|
Next, do the :ref:`essential-post-install-config`.
|