Bugzilla 2.16 日本語版について

日本語版 Bugzilla は もじら組 の Bugzilla-jp で配付されています。しかし 2003-08-22 現在配付されている bugzilla-2.16.1-ja-20021116 は

• バージョンが最新の 2.16.3 ではない
  
  (単に 英語版の 2.16.1 to 2.16.3 patch を当てただけでは英語テンプレートとちがうディレクトリにある日本語テンプレートにパッチが当たらないので、手作業で日本語テンプレートを修正する必要あり)
• 2002-11-16 以降のパッチが適用されていない

という問題がありますので、上記の問題を修正したバージョンへアップデートするためのパッチをここに置いておきます。

bugzilla-2.16.3-to-2.16.3-ja-20030822.diff.gz (2003-08-22, 175kb)

bugzilla-2.16.1-ja-20021116 からの変更点 (テキスト)

パッチの当て方

OS

Linux や FreeBSD 等、UNIX 系なら可。Windows は Bugzilla 2.16 では不可ですが、将来の Bugzilla で使用できるようにする予定はあるようです。

Perl

Bugzilla は Perl で書かれた CGI スクリプトなので、Perl が必要です。バージョン 5.005 以降であれば動作します。

Apache

Bugzilla は Web ブラウザから使用する Web アプリケーションなので、Web サーバが必要です。

MySQL

Bugzilla はデータベースシステムを使用します。そのおかげで、 20数万件のバグを扱うことができています。バージョン 3.22.5 以降で動作します。

sendmail

Bugzilla はバグレポートの状態が変更されたときのお知らせなどでメールを送ります。そのために sendmail (バージョン 8.7 以上) かその互換ソフトウェアが必要です。qmail も使えるそうです。
Bugzilla は /usr/lib/sendmail というファイルを使用してメールを送信しますが、このファイルがない OS もあります (私が確認したものだと FreeBSD 5.1 もそうです)。その場合、
# ln -s /usr/sbin/sendmail /usr/lib/sendmail
としてください。

Perl モジュール

Bugzilla は多くの Perl モジュールを使用します。

• Red Hat Linux 7.3 への rpm パッケージからのインストール
  Red Hat Linux 7.3 に Perl 5.6.1, MySQL 3.23, Apache 1.3 という少し前のバージョンの環境を作ります。
• ソースコードからのインストール
  FreeBSD 5.1 に Perl 5.8.0, MySQL 4.0.14, Apache 2.0.47 という執筆時点での最新安定版の環境をインストールします。

1. まず、bugzilla-2.16 のアーカイブを展開して日本語版へのパッチなどを当てます。
   ディレクトリ名を bugzilla でアクセスできるようにします (これは必須ではありませんが説明のためにこうします)。

   $ cd /var/www/
   $ tar zxvf bugzilla-2.16.3.tar.gz
      (日本語版へのパッチを適用)
   $ ln -s bugzilla-2.16.3 bugzilla
   

2. 次に、各CGIファイルの perlの PATH を書き換えます。これをしないと CGI ファイルは正常に実行されません。FHS にしたがった Red Hat Linux などであれば perl は /usr/bin/perl にあるはずです。
   

   $ cd /var/www/bugzilla
   $ perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb

   または、/usr/bonsaitools/bin/perl というファイル(シンボリックリンク)を実際に用意する方法もあります。

   # mkdir -p /usr/bonsaitools/bin
   # ln -s /usr/bin/perl /usr/bonsaitools/bin/perl

3. 各 CGI ファイルを Web サーバを実行するユーザでしか実行できないようにしておきます。これはセキュリティのため。
   そのためまず各ファイルの所有ユーザを、Web サーバを実行するユーザ (ここでは apache) と同じにします。

   # cd /var/www/bugzilla
   # chown -R apache:apache .

   そして各ファイルの実行権を所有ユーザだけに与えます (つまりファイル所有ユーザ以外からファイル読み込み・書き込み・実行権限を剥奪します)。

   # cd /var/www/bugzilla
   # chmod -R go-rwx .

4. それでは checksetup.pl を実行します。このとき、MySQL サーバ (mysqld) を起動しておきます。

   $ ./checksetup.pl

5. checksetup.pl には複数の役割がありますが、まず Perl モジュールが正常にインストールされているかチェックします。Perl モジュールのバージョンが低かったりインストールされていないものがあると、警告文を表示してストップします。そのときは 表示された Perl モジュールをインストールして また checksetup.pl を実行します。
6. 必要な Perl モジュールが揃っていれば localconfig というファイルが作成されます。このファイルをテキストエディタで開いて編集します。以下では
   • MySQL の 実行バイナリがあるディレクトリ (ソースコードからインストールしたなら /usr/local/mysql/bin 等になります)
   • Apache Web サーバを動作させるユーザ名
   • MySQL の bugsユーザのパスワード (MySQL インストールで bugs ユーザを作ったとき決めたパスワードです)
   を書き換えています。ほかにも書き換えることがあれば変更しておきます。

   --- localconfig.org     Wed Sep  3 16:01:49 2003
   +++ localconfig Wed Sep  3 16:05:17 2003
   @@ -18,7 +18,7 @@
    # Because it's possible that these files aren't in your path, you can specify
    # their location here.
    # Please specify only the directory name, with no trailing slash.
   -$mysqlpath = "";
   +$mysqlpath = "/usr/bin";
   
   
    #
   @@ -48,7 +48,7 @@
    # and you cannot set this up any other way. YOU HAVE BEEN WARNED.
    # If you set this to anything besides "", you will need to run checksetup.pl
    # as root, or as a user who is a member of the specified group.
   -$webservergroup = "nobody";
   +$webservergroup = "apache";
   
   
   
   @@ -68,7 +68,7 @@
    # If you use apostrophe (') or a backslash (\) in your password, you'll
    # need to escape it by preceding it with a \ character. (\') or (\\)
    #
   -$db_pass = '';
   +$db_pass = 'bugspass';
   
   
   
   

7. checksetup.pl をまた実行します。 このとき Unix の root ユーザで実行したほうがいいようです。そうしないと webservergroup がどうのこうのという警告がでます。

   # ./checksetup.pl

   localconfig が存在する場合、そのファイルの記述にしたがって MySQL サーバと接続します。そして localconfig に書かれている bugs データベース が無ければ作成して、データベースの中の テーブル や カラム も作成します。
   もしたとえば Bugzilla 2.12 で作ったデータベースが既に存在していた場合、ここで自動的に Bugzilla 2.16 のデータベース構造に更新してくれます。
   
   このときメールアドレスをきかれますが、これは Bugzilla 管理者のメールアドレスになります。

   Looks like we don't have an administrator set up yet.  Either this is your
   first time using Bugzilla, or your administrator's privs might have accidently
   gotten deleted at some point.
   Enter the e-mail address of the administrator: admin@foo.or.jp
   You entered 'admin@foo.or.jp'.  Is this correct? [Y/n] Y
   Enter the real name of the administrator: Admin User
   Enter a password for the administrator account: パスワードを入力します
   Please retype the password to verify: パスワードを入力します

   
   Web ブラウザから Bugzilla にログインするとき上記のメールアドレスとパスワードを使うと、Bugzilla 管理者としてプロダクト追加や ユーザの編集などがおこなえます。
8. それでは Web ブラウザで Bugzilla を見てみましょう。ブラウザの URL 欄にその PC のホスト名あるいは IPアドレスを入力して正常にトップページが表示されれば OK です。
   
   Bugzilla 管理者としてログインして、画面下の「パラメータ」を押下し運用パラメータを設定します。最低限、maintainer と urlbase を設定してください。
   
   画面下の「プロダクト」を押下しプロダクト・バージョン・コンポーネントを登録します。

以上で Bugzilla のインストールは完了です。

バグレポートに関するデータはすべて MySQL のデータベースに保存されます。このデータベースをバックアップする方法について説明します。

MySQL サーバを停止してバックアップ

$ cd /var/lib/mysql
$ tar zcvf /home/mysql/bz-20030903.tar.gz bugs/ mysql/

MySQL サーバを停止しないでバックアップ

$ mysql -u root -p
Enter password:
mysql> use mysql;
mysql> update user set reload_priv='Y' where user='bugs';
             ( bugs のところは Bugzilla が使用するユーザを指定します)
mysql> grant select on mysql.* to bugs@localhost;
mysql> flush privileges;
mysql> exit;

$ mysqlhotcopy -u bugs -p <bugsユーザのパスワード> <バックアップするデータベース> <コピー先のディレクトリ>

#!/bin/sh
BACKUP_DIR=/home/mysql/`date +%Y%m%d-%H%M`
mkdir -p $BACKUP_DIR
mysqlhotcopy -u bugs -p passbugs bugs $BACKUP_DIR
mysqlhotcopy -u bugs -p passbugs mysql $BACKUP_DIR

バグレポート以外の Bugzilla 動作設定ファイルなど一部のファイルは、MySQL データベースではない場所に保存されています。以下のファイルもバックアップしておくことをすすめます。

<bugzilla>/localconfig

MySQL サーバと接続する ユーザ名・パスワードなど重大な内容が保存されています。

<bugzilla>/data/params

Web ブラウザから Bugzilla 管理者としてログインし「パラメータ」ページで設定した内容はここに保存されています。

<bugzilla>/data/mining/<プロダクト名>

Bugzilla トップページあるいは画面下にあるフッタから行ける「統計」ページで「出力形式 : グラフ」を選択したときの画像を作るために cron で日々記録されている統計データファイルです (cron の設定をしていないときは作られません)。
ここのファイルはプロダクト名に空白があればファイル名に空白を含むファイル名になりますし、プロダクト名が日本語であれば文字コード EUC-JP の日本語ファイル名になります。この仕様は問題かもしれません。

日本語版 Bugzilla は Webブラウザに出力する HTML も、データベースに格納する文字列も EUC-JP という文字コードを使用しています。これは過去の 日本語版 Bugzilla (バージョン 2.12 など) が使っていた文字コードをそのまま使用しているだけです。

ですが本家 英語版 Bugzilla 開発者は Unicode (UTF-8) の使用を推奨しています。以前はこんなページありませんでしたが。

UTF-8 化すると以下のような問題点がでてきます。

• 以下のそれぞれが UTF-8 対応する必要がある。
  • HTML を処理する Web ブラウザ
  • CGI スクリプトを処理する Perl
  • データベース MySQL
  • Eメールを受け取るメールソフト
• 「正規表現」検索が日本語でもできるようになる ?

Mozilla.org の英語ドキュメントを日本語に翻訳するもじら組 - 和訳プロジェクト から
Bugzilla 関連のドキュメント:

• バグ
• バグ報告ガイドライン
  このドキュメントとほぼ同じものを私も訳したな..。
• Bugzilla エチケット
• Bugzilla とは何ですか?

バグのリスト画面をみやすくする方法

Bugzilla のバグのリストを変更時刻の順に並べる方法を説明します。

1. 検索結果のバグのリストが出ている画面で、画面下にある「表示項目の変更」をクリックして「更新日」を表示するようにします。
2. そしてまた検索して結果のバグのリスト画面で、画面上の「更新日」をクリックすると、更新日でソートされます。