Last Updated: 5/25/2004

* Upgrading Bugzilla to 2.16 to 2.16.5 (or whatever)

% setenv CVSROOT ":pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot"
% cd /usr/local/bugzilla/http
% cvs login
(login as anonymous)

% cvs update -r Bugzilla_Stable -dP
% ./checksetup.pl

% chown -R apache ./*
% chgrp -R apache ./*
% chown apache .htaccess 
(might not need this last step)

http://www.bugzilla.org/download.html

-----------------------------------------------------------------------------
Quick and Dirty Setup

BASH:
% export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot

TCSH:
% setenv CVSROOT ":pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot"

cd <bugzilla install directory>
% cvs login
(Password is anonymous)

% cvs update -rBUGZILLA-2_17_7 -dP

OR: Bugzilla_Stable
OR: Add -A flag for tip (latest)
	% cvs update -A -dP

% checksetup.pl

* Install perl modules if you need to
* Edit localconfig
* Run checksetup again

	% checksetup.pl

* Login, create super user, create user accounts

-----------------------------------------------------------------------------
Template Customizations

% cd bugzilla
% cd template/en/
% cp -rf default custom

* Make changes in the custom directory, when you upgrade bugzilla via cvs,
  this directory won't get overwritten as a result.  Feel brave and trust CVS
  merges?  Just customize directly in the en directory.

* After making any changes, or adding a new file to custom, run checksetup.pl

	% checksetup.pl

global/variables.non.tmpl

	This is where you can modify "Bugzilla" to say something else.  Instead of
	a bug say "issue" etc.

global/banner.html.tmpl

	Wanna remove the "This is [Bugzilla]"?  This is where it is.

-----------------------------------------------------------------------------

To UTF8 from latin1 (218 rc3 -> 303)
*  mysqldump --default-character-set=latin1 --complete-insert --insert-ignore --skip-set-charset bug_db > dump.sql
* replace "latin1" "utf8" -- dump.sql  (finds and replaces all "latin1" strings to "utf8")
* run in mysql then exit: create database bugdb character set utf8 collate utf8_general_ci; (drop the database if it exists already: "drop database bugdb;")
* mysql --default-character-set=utf8 newbugsdb < dump.sql
* run checksetup.pl (It should not warn you to run recode because all tables and columns should be utf8 kosher)
* restart apache webserver and check for utf8 encoding issues, should be good