summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorkiko%async.com.br <>2003-10-10 11:22:39 +0200
committerkiko%async.com.br <>2003-10-10 11:22:39 +0200
commitc3f14a48bbb05be597c485d4d2d88f24400b2b5c (patch)
tree0e1947d33c605612ee37c8079f326bafe0b57ecb
parentcf7b7c13c57d048a6501afcfb492f6d1bca6cac9 (diff)
downloadbugzilla-c3f14a48bbb05be597c485d4d2d88f24400b2b5c.tar.gz
bugzilla-c3f14a48bbb05be597c485d4d2d88f24400b2b5c.tar.xz
Fix for bug 221391: Bugzilla Quickstart guide could exist. Provide a
QUICKSTART file, and alter README slightly to point to it. r=gerv, justdave, a=justdave.
-rw-r--r--QUICKSTART85
-rw-r--r--README11
2 files changed, 92 insertions, 4 deletions
diff --git a/QUICKSTART b/QUICKSTART
new file mode 100644
index 000000000..9a9a387bd
--- /dev/null
+++ b/QUICKSTART
@@ -0,0 +1,85 @@
+Bugzilla Quick Start Guide
+==========================
+(or, how to get Bugzilla up and running in 10 steps)
+Christian Reis <kiko@async.com.br>
+
+This express installation guide is for "normal" Bugzilla installations,
+which means a Linux or Unix system on which Apache, Perl, MySQL and
+Sendmail are available. For other configurations, please see Section 4
+of the Bugzilla Guide in the docs/ directory.
+
+1. Decide from which URL and directory under your webserver root you
+ will be serving the Bugzilla webpages from.
+
+2. Unpack distribution into the chosen directory (there is no copy or
+ installation involved).
+
+3. Run ./checksetup.pl, look for unsolved requirements, install them.
+ You can run checksetup as many times as necessary to check if
+ everything required is installed.
+
+ This will usually include assorted Perl modules, MySQL and sendmail.
+
+ After a successful dependency check, checksetup should complain that
+ localconfig needs to be edited.
+
+4. Edit the localconfig file, in particular the $webservergroup and
+ $db_* variables. In particular, $db_name and $db_user will define
+ your database setup in step 5.
+
+ If you want to change platforms, operating systems, severities and
+ priorities, this can also be done in localconfig at this time.
+
+5. Using the name you provided as $db_name above, create a MySQL database
+ for Bugzilla. You should also create a user permission for the name
+ supplied as $db_user with read/write access to that database.
+
+ If you are not familiar with MySQL permissions, it's a good idea to
+ use the mysql_setpermission script that is installed with the MySQL
+ distribution, and be sure to read section 4.1.6 in the Bugzilla Guide.
+
+6. Run checksetup.pl once more; if all goes well, it should set up the
+ Bugzilla database for you. If not, move back to step 5.
+
+ checksetup.pl should ask you, this time, for the administrator's
+ email address and password. These will be used for the initial
+ Bugzilla administrator account.
+
+7. Configure Apache (or install and configure, if you don't have one up
+ yet) to point to the Bugzilla directory. You should enable and
+ activate mod_cgi, and add the configuration entries
+
+ Options +ExecCGI
+ AllowOverride Limit
+ DirectoryIndex index.cgi
+
+ to your Bugzilla <Directory> block. You may also need
+
+ AddHandler cgi-script .cgi
+
+ if you don't have that in your Apache configuration file yet.
+
+8. Visit the URL you chose for Bugzilla. You should log in as the
+ administrator by following the "Log in" link and supplying the
+ account information you provided in step 6.
+
+9. Scroll to the bottom of the page after logging in, and select
+ "parameters". Set up the relevant parameters for your local setup.
+
+ See section 4.2 of the Bugzilla Guide for a in-depth description of
+ some of the configuration parameters available.
+
+10. That's it. If anything unexpected comes up:
+
+ - read the error message carefully,
+ - backtrack through the steps above,
+ - check the official installation guide, which is section 4 in the
+ Bugzilla Guide, included in the docs/ directory in various
+ formats.
+
+Support and installation questions should be directed to the
+mozilla-webtools@mozilla.org mailing list -- don't write to the
+developer mailing list: your post *will* be ignored if you do.
+
+Further support information is at http://www.bugzilla.org/discussion.html
+
diff --git a/README b/README
index d5c4c0b93..d29229ca4 100644
--- a/README
+++ b/README
@@ -1,10 +1,13 @@
* This README is no longer used to house installation instructions. Instead,
it contains pointers to where you may find the information you need.
-* Installation instructions are now found in docs/, with a variety of document
-types available. Please refer to these documents when installing, configuring,
-and maintaining your Bugzilla installation. A helpful starting point is
-docs/txt/Bugzilla-Guide.txt, or with a web browser at docs/html/index.html.
+* A quick installation guide is provided in the QUICKSTART file.
+
+* Complete installation instructions are found in docs/, with a
+variety of document types available. Please refer to these documents
+when installing, configuring, and maintaining your Bugzilla
+installation. A helpful starting point is docs/txt/Bugzilla-Guide.txt,
+or with a web browser at docs/html/index.html.
* Release notes for people upgrading to a new version of Bugzilla are
available at docs/rel_notes.txt.