| 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. |