mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-08 12:37:37 +00:00
264 lines
8.5 KiB
Plaintext
264 lines
8.5 KiB
Plaintext
This is Bugzilla. See <http://www.mozilla.org/bugs/>.
|
||
|
||
|
||
==========
|
||
DISCLAIMER
|
||
==========
|
||
|
||
This is not very well packaged code. It's not packaged at all. Don't
|
||
come here expecting something you plop in a directory, twiddle a few
|
||
things, and you're off and using it. Work has to be done to get
|
||
there. We'd like to get there, but it wasn't clear when that would
|
||
be, and so we decided to let people see it first.
|
||
|
||
|
||
|
||
============
|
||
INSTALLATION
|
||
============
|
||
|
||
(This section stolen heavily from the Bonsai INSTALL document. It's
|
||
also probably incomplete. "We're accepting patches", especially to
|
||
this document!)
|
||
|
||
First, you need some other things:
|
||
|
||
1) MySQL database server.
|
||
2) Tcl 7.6
|
||
3) TclX 7.6
|
||
4) mysqltcl program (hmm.. This was tricky.. Read on)
|
||
5) Some kind of HTTP server so you could use CGI scripts
|
||
|
||
1.1 Getting and setting up MySQL database
|
||
|
||
Visit MySQL homepage at http://www.tcx.se and grab the latest
|
||
stable binary release of the server. Sure, you can get sources and
|
||
compile them yourself, but binaries are the easiest and the fastest
|
||
way to get it up and running. Follow instructions found in
|
||
manual. There is a section about installing binary-only
|
||
distributions.
|
||
|
||
You should create database "bugs". It may be a good idea to make it
|
||
writable by all users on your machine and change access level
|
||
later. This would save you a lot of time trying to guess whether it's
|
||
permissions or a mistake in the script that make things fail.
|
||
|
||
1.2-3 Getting and building Tcl & TclX 7.6
|
||
|
||
Tcl homepage is at http://www.scriptics.com. You may get sources
|
||
for UNIX from ftp://ftp.scriptics.com/pub/tcl/tcl7_6/tcl7.6p2.tar.gz.
|
||
TclX is an extension for Tcl that adds a lot of useful functions that
|
||
are heavily used in the Bugzilla tool.
|
||
TclX page is http://www.neosoft.com/tclx. Download sources from
|
||
ftp://ftp.neosoft.com/pub/tcl/TclX/tclX7.6.0.tar.gz. Watch out for the
|
||
case of the letters in URL. These guys are going to bring some fun
|
||
into your life by spelling their program name in various ways.
|
||
|
||
Now you've probably got both Tcl and TclX 7.6. You may try to use
|
||
version 8.X but I'm not sure about results. Unfortunately I'm not an
|
||
expert in "Tcl&Co.".
|
||
|
||
Build and install Tcl first. Then build and install TclX. This
|
||
should go without serious problems
|
||
|
||
1.4 mysqltcl - the tricky part
|
||
|
||
Grab msqltcl 1.50 (yes, "msqltcl" without 'y'. That's not a typo) from
|
||
MySQL site's contributed software area (http://www.tcx.se/Contrib/) or
|
||
from mSQL site (www.hughes.com.au). I've used version 1.50 and it
|
||
works for me, though you may try more recent version at your own
|
||
risk. You're risking anyway.
|
||
|
||
Then grab mysqltcl.c-patch from MySQL's contrib area and apply this
|
||
patch to msqltcl.c file from msqltcl-1.50 distribution.
|
||
|
||
Try to make msqltcl binary which is in fact mYsqltcl already. Very
|
||
likely that you will not be able to compile it without modifications.
|
||
|
||
You can use the patch in APPENDIX 1 to see what changes I had to make
|
||
to compile mysqltcl. Your mileage may vary.
|
||
|
||
|
||
1.5 HTTP server
|
||
|
||
You have a freedom of choice here - Apache, Netscape or any other
|
||
server on UNIX would do. The only thing - to make configuration easier
|
||
you'd better run HTTP daemon on the same machine that you run MySQL
|
||
server on. Make sure that you can access 'bugs' database with user
|
||
id you're running the daemon with.
|
||
|
||
|
||
2. TWEAKING THE TOOLS
|
||
|
||
Now you should have all necessary tools to be able to run Bugzilla
|
||
and see why the wouldn't work for you right now.
|
||
|
||
First of all you have to change "#!/usr/bonsaitools" to wherever
|
||
you've installed your binaries in all executable scripts in Bugzilla
|
||
directories.
|
||
|
||
Make sure the directory containing the binaries is writable by the
|
||
web server. Bugzilla keeps some temporary files here.
|
||
|
||
Create an empty file in that directory named "comments"; make sure
|
||
it is writable by the web server.
|
||
|
||
3. Setting up database
|
||
|
||
First, run mysql, and tell it "create database bugs;".
|
||
|
||
Now, you should be run all six scripts named make*.sh. This creates the
|
||
database tables and populates them a teeny bit.
|
||
|
||
|
||
4. Setting the parameters
|
||
|
||
At this point, you ought to be able to go and browse some pages. But you'd
|
||
like to customize some things.
|
||
|
||
Create yourself an account. (Try to enter a new bug, and it will
|
||
prompt you for your login. Give it your email address, and have it
|
||
mail you your password.) Go visit the query page; that ought to force
|
||
the creation of the "params" file in your installation dir. Edit the
|
||
params file, and change the line that says "set param(maintainer)" to
|
||
have your email address as the maintainer. Go visit the query page
|
||
again; there should now be a link at the bottom that invites you to
|
||
edit the parameters. (If you have cookies turned off, you'll have to
|
||
go to editparams.cgi manually.)
|
||
|
||
Tweak the parameters to taste. Be careful.
|
||
|
||
|
||
5. Set up the whining cron job.
|
||
|
||
It's a good idea to set up a daily cronjob that does
|
||
|
||
cd <your-installation-dir> ; ./whineatnews.tcl
|
||
|
||
This causes email that gets sent to anyone who has a NEW bug that
|
||
hasn't been touched for several days. For more info, see the
|
||
whinedays and whinemail parameters.
|
||
|
||
|
||
|
||
*******************************************************
|
||
APPENDIXES
|
||
*******************************************************
|
||
|
||
|
||
APPENDIX 1. Patch to build mysqltcl.
|
||
--------------------------------------
|
||
|
||
diff -u -r msqltcl-1.50/Makefile mysqltcl-1.50/Makefile
|
||
--- msqltcl-1.50/Makefile Tue Jun 6 07:25:39 1995
|
||
+++ mysqltcl-1.50/Makefile Tue Jun 23 18:20:07 1998
|
||
@@ -38,11 +38,11 @@
|
||
#
|
||
#----- Tcl/Tk libraries & such
|
||
# Path for Tcl include files.
|
||
-TCLINCL = -I/usr/local/include
|
||
+TCLINCL = -I../include
|
||
# Path for Tk include files, if different from the above.
|
||
TKINCL =
|
||
# Libraries required to link plain Tcl.
|
||
-TCLLIBS = -L/usr/local/lib -ltcl -lm
|
||
+TCLLIBS = -L../lib -ltclx7.6.0 -ltcl7.6 -lm -lnsl -lsocket
|
||
# Libraries required to link plain Tk.
|
||
TKLIBS = -L/usr/local/lib -ltk -ltcl -lX11 -lm
|
||
|
||
@@ -66,11 +66,11 @@
|
||
#
|
||
#----- Tcl/Tk libraries & such
|
||
# Path for Tcl include files.
|
||
-NEWTCLINCL = -I/usr/local/new/include
|
||
+NEWTCLINCL = -I../include
|
||
# Path for Tk include files, if different from the above.
|
||
NEWTKINCL =
|
||
# Libraries required to link plain Tcl.
|
||
-NEWTCLLIBS = -L/usr/local/new/lib -ltcl -lm
|
||
+NEWTCLLIBS = -L../lib -ltclx7.6.0 -ltcl7.6 -lm -lnsl -lsocket
|
||
# Libraries required to link plain Tk.
|
||
NEWTKLIBS = -L/usr/local/new/lib -ltk -ltcl -lX11 -lm
|
||
|
||
@@ -82,7 +82,7 @@
|
||
# Path for TclX/TkX include files, if different from plain Tcl.
|
||
NEWTCLXINCL =
|
||
# Extra libraries required to link TclX.
|
||
-NEWTCLXLIBS = -L/usr/local/new/lib -ltclx
|
||
+NEWTCLXLIBS = -L../mysql/lib -ltclx
|
||
# Extra libraries required to link TkX.
|
||
NEWTKXLIBS = -L/usr/local/new/lib -ltkx -ltclx
|
||
# TclX/TkX 'AppInit' files (base names).
|
||
@@ -94,16 +94,16 @@
|
||
#
|
||
#----- mSQL libraries & such
|
||
# Path for mSQL include files.
|
||
-MSQLINCL = -I/usr/local2/src/Minerva/include
|
||
+MSQLINCL = -I../mysql/include
|
||
# Libraries required to link an mSQL application.
|
||
-MSQLLIB = -L/usr/local2/src/Minerva/lib -lmsql
|
||
+MSQLLIB = -L../mysql/lib -lmysqlclient
|
||
|
||
#===== END OF CONFIGURATION DEFINITIONS =====
|
||
|
||
INCL = -I. ${MSQLINCL} ${TCLINCL} ${TKINCL}
|
||
CFLAGS = ${OPTIM} -c
|
||
LDFLAGS = ${OPTIM}
|
||
-PROGS = msqltcl msqlwish
|
||
+PROGS = msqltcl # msqlwish
|
||
TCLLINK = ${MSQLLIB} ${TCLLIBS}
|
||
TKLINK = ${MSQLLIB} ${TKLIBS}
|
||
|
||
diff -u -r msqltcl-1.50/new-tclAppInit.c mysqltcl-1.50/new-tclAppInit.c
|
||
--- msqltcl-1.50/new-tclAppInit.c Tue Jun 6 07:25:38 1995
|
||
+++ mysqltcl-1.50/new-tclAppInit.c Tue Jun 23 18:28:14 1998
|
||
@@ -14,7 +14,7 @@
|
||
static char sccsid[] = "@(#) tclAppInit.c 1.11 94/12/17 16:14:03";
|
||
#endif /* not lint */
|
||
|
||
-#include "tcl.h"
|
||
+#include "tclExtend.h"
|
||
|
||
/*
|
||
* The following variable is a special hack that is needed in order for
|
||
@@ -48,7 +48,7 @@
|
||
int argc; /* Number of command-line arguments. */
|
||
char **argv; /* Values of command-line arguments. */
|
||
{
|
||
- Tcl_Main(argc, argv);
|
||
+ TclX_Main(argc, argv, Tcl_AppInit);
|
||
return 0; /* Needed only to prevent compiler warning. */
|
||
}
|
||
|
||
@@ -79,6 +79,10 @@
|
||
return TCL_ERROR;
|
||
}
|
||
|
||
+ if (Tclx_Init(interp) == TCL_ERROR) {
|
||
+ return TCL_ERROR;
|
||
+ }
|
||
+
|
||
/*
|
||
* Call the init procedures for included packages. Each call should
|
||
* look like this:
|
||
@@ -90,7 +94,7 @@
|
||
* where "Mod" is the name of the module.
|
||
*/
|
||
|
||
- if (Msqltcl_Init(interp) == TCL_ERROR) {
|
||
+ if (Mysqltcl_Init(interp) == TCL_ERROR) {
|
||
return TCL_ERROR;
|
||
}
|
||
|
||
@@ -106,6 +110,6 @@
|
||
* then no user-specific startup file will be run under any conditions.
|
||
*/
|
||
|
||
- tcl_RcFileName = "~/.tclshrc";
|
||
+/* tcl_RcFileName = "~/.tclshrc"; */
|
||
return TCL_OK;
|
||
}
|
||
|
||
|
||
|