67 lines
2.4 KiB
ReStructuredText
67 lines
2.4 KiB
ReStructuredText
localconfig
|
|
===========
|
|
|
|
You should now change into the Bugzilla directory and run
|
|
:file:`checksetup.pl`, without any parameters:
|
|
|
|
|checksetupcommand|
|
|
|
|
:file:`checksetup.pl` will write out a file called :file:`localconfig`.
|
|
This file contains the default settings for a number of
|
|
Bugzilla parameters, the most important of which are the group your web
|
|
server runs as, and information on how to connect to your database.
|
|
|
|
Load this file in your editor. You will need to check/change ``$db_driver``
|
|
and ``$db_pass``, which are respectively the type of the database you are
|
|
using and the password for the ``bugs`` database user you have created.
|
|
``$db_driver`` can be either ``mysql``, ``Pg`` (PostgreSQL), ``Oracle`` or
|
|
``Sqlite``. All values are case sensitive.
|
|
|
|
Set the value of ``$webservergroup`` to the group your web server runs as.
|
|
|
|
* Fedora/Red Hat: ``apache``
|
|
* Debian/Ubuntu: ``www-data``
|
|
* Mac OS X: ``_www``
|
|
* Windows: ignore this setting; it does nothing
|
|
|
|
The other options in the :file:`localconfig` file are documented by their
|
|
accompanying comments. If you have a non-standard database setup, you may
|
|
need to change one or more of the other ``$db_*`` parameters.
|
|
|
|
.. note:: If you are using Oracle, ``$db_name`` should be set to
|
|
the SID name of your database (e.g. ``XE`` if you are using Oracle XE).
|
|
|
|
checksetup.pl
|
|
=============
|
|
|
|
Next, run :file:`checksetup.pl` an additional time:
|
|
|
|
|checksetupcommand|
|
|
|
|
It reconfirms that all the modules are present, and notices the altered
|
|
localconfig file, which it assumes you have edited to your
|
|
satisfaction. It compiles the UI templates,
|
|
connects to the database using the ``bugs``
|
|
user you created and the password you defined, and creates the
|
|
``bugs`` database and the tables therein.
|
|
|
|
After that, it asks for details of an administrator account. Bugzilla
|
|
can have multiple administrators - you can create more later - but
|
|
it needs one to start off with.
|
|
Enter the email address of an administrator, his or her full name,
|
|
and a suitable Bugzilla password.
|
|
|
|
:file:`checksetup.pl` will then finish. You may rerun
|
|
:file:`checksetup.pl` at any time if you wish.
|
|
|
|
Success
|
|
=======
|
|
|
|
Your Bugzilla should now be working. Check by running:
|
|
|
|
|testservercommand|
|
|
|
|
If that passes, access ``http://<your-bugzilla-server>/`` in your browser -
|
|
you should see the Bugzilla front page. Of course, if you installed Bugzilla
|
|
in a subdirectory, make sure that's in the URL.
|