ここでは、/var/www/bug
以下に TrackGuy の実行環境を
つくるものとします。
Perl 5.005 以降がインストールされていることを確認します。
Perl のバージョンは perl -v
を実行すると表示されます。
Perl の実行ファイルが /usr/bin/perl
にあることを確認してください。
この場所にない場合は、シンボリック・リンクを張るか、
TrackGuy を構成する Perl スクリプトの一行目にある
#!/usr/bin/perl
の記述を現状に合わせてください。
さらに、Jcode.pm をインストールします。
perl -e 'use Jcode'
を実行してみて、何のエラーやメッセージも
出ない場合は、そのシステムには正常に Jcode.pm がインストールされて
いるものと思われます。
さもなければ、
http://www.cpan.org/ などから入手してインストールしてください。
Debian GNU/Linux の場合は libjcode-pm-perl
パッケージとして
Jcode.pm が提供されていますので、
システム管理者権限にて apt-get install libjcode-pm-perl
として
インストールしてください。
お使いの Web サーバで、/var/www/bug
が http アクセスを
通して見えるようにし、拡張子 *.cgi のファイルが CGI として認識され、
動作するように設定してください。
また、ディレクトリに対してアクセスした際に、index.cgi
が
デフォルトの文書として扱われるよう設定することをお勧めします。
以下、apache 1.3 を web サーバとして使うものと仮定し、
httpd.conf
の設定例を以下に示します。お使いの環境に応じて
適宜設定してください。
AddHandler cgi-script .cgi <Directory /var/www/bug> Options ExecCGI DirectoryIndex index.cgi </Directory>
以下、www.foo.co.jp
というホストの web サーバの設定がなされ、
http://www.foo.co.jp/bug/
にアクセスすると
/var/www/bug
以下が見えるものとします。
/var/www/bug
に TrackGuy のアーカイブを展開します。
TrackGuy の各種設定は、TrackGuy を展開したディレクトリの
lib/trackguy.conf
の中身を変更することで行えます。
以下、このファイルを trackguy.conf と称します。
基本的には、trackguy.conf の中に記述してあるデフォルト値を 適宜書き換えていくだけですが、perl スクリプトとして評価される ファイルですので、perl 文法から外れないように気をつけてください。
以下の設定が終ったら、http://www.foo.co.jp/bug/
にアクセスして、
デフォルトの TrackGuy トップページ
/var/www/bug/index.cgi
が出現することを確認してください。
うまく動作しない場合は、Web サーバが出すエラーログを参照してください。
例えば、Debian GNU/Linux の apache の場合は、デフォルト設定では
/var/log/apache/error.log
にエラーログがありますので、これを
tail -f
で監視するとよいでしょう。
trackguy.conf の $top_uri
を編集します。
http://www.foo.co.jp/bug/
を TrackGuy のトップページにする場合なら、
$top_uri = 'http://www.foo.co.jp/bug'
としてください。
末尾の /
は書かないでください。
trackguy.conf のバグ報告データが収められるディレクトリを指定します。
/var/www/bug
に展開した場合なら、
/var/www/bug/data
という空ディレクトリができているはずです。
これがデータの入るディレクトリになります。
trackguy プログラムである index.cgi
が動作するユーザ権限で、
このディレクトリを読み書き可能であることを確認してください。
必要に応じて、ディレクトリの owner を CGI が動作するユーザに変更してください。
例: chown -R www-data.www-data data
TrackGuy の最後(最新)のバグ番号が記録されるファイルです。
/var/www/bug
に展開した場合なら、
/var/www/bug/data/lastbr
で結構です。
trackguy プログラムである index.cgi
が動作するユーザ権限で、
このファイルが読み書き可能であることを確認してください。
(参考: ひとつのサイトで複数の TrackGuy を使う場合、このファイル へのパスを TrackGuy 間で揃えておくと、バグ番号が unique に保たれます)