Request Trackerのソースを表示

[[Category:バグ管理システム]]
[[en:Request Tracker]]
[https://bestpractical.com/ RT] はエンタープライズグレードのバグ管理システムです。このガイドでは [[MySQL]], [[Apache]], mod_perl を使用して http://localhost/rt からアクセスできる RT (Request Tracker) サーバーを作成します。RT は他のデータベースやウェブサーバー (デーモンとして動作させることもできます), Perl エンジンをサポートしていますが、このページでは触れません ([https://github.com/bestpractical/rt/blob/stable/docs/web_deployment.pod 適切な RT のドキュメント] を見てください)。

== インストール ==

=== パッケージのインストール ===

{{AUR|rt}} パッケージをビルド・インストールしてください。Perl の依存パッケージを大量にインストールする必要があります。[[AUR ヘルパー]]が役に立つでしょう。[[Apache]] もインストールしてください。

=== Apache の設定 ===

{{ic|/etc/httpd/conf/httpd.conf}} の LoadModule セクションに以下の行を追加してください:

 LoadModule perl_module modules/mod_perl.so

そして {{ic|httpd.conf}} の一番下に以下を追加:

 AddDefaultCharset UTF-8
 DocumentRoot "/opt/rt4/share/html"
 
 <Location "/rt">
   Order allow,deny
   Allow from all
 
   SetHandler modperl
   PerlResponseHandler Plack::Handler::Apache2
   PerlSetVar psgi_app /opt/rt4/sbin/rt-server
 </Location>
 
 <Directory "/opt/rt4/share/html">
   Order allow,deny
   Allow from all
 </Directory>
 
 <Perl>
   use Plack::Handler::Apache2;
   Plack::Handler::Apache2->preload("/opt/rt4/sbin/rt-server");
 </Perl>

=== MySQL データベースの作成 ===

[[MySQL]] サーバーをインストール・セットアップしてください。以下のコマンドを root で実行することで RT のデータベースを作成できます ({{ic|/opt/rt4/etc/schema.mysql}} に書き込まれます):

 # /opt/rt4/sbin/rt-setup-database --action init

=== RT の設定 ===

{{ic|/opt/rt4/etc/RT_SiteConfig.pm}} ({{ic|RT_Config.pm}} ではありません) を編集して RT のシステム設定を行います。{{ic|RT_Config.pm}} は {{ic|RT_SiteConfig.pm}} のリファレンスとして使うことができるデフォルトの設定ファイルです。以下のように Perl の構文を使います:

 Set($''variable'', ''''''setting'''''');

最低でも2つの項目の設定が必要です。''WebPath'' は RT の DocumentRoot を指定します (このページの例では http://''ip_address''/rt)。CSS や画像を正しくロードするために必須です。''DatabasePassword'' は RT が使用する [[MySQL]] データベースのパスワードを指定し、内部ユーザーを使って接続されます (デフォルトは ''rt_user'')。{{ic|RT_SiteConfig.pm}} に以下のように追加してください:

 Set($WebPath, '/rt');
 Set($DatabasePassword, ''''''your_password'''''');

データベースのパスワードを設定したら、データベースに接続 ([http://dev.mysql.com/tech-resources/articles/mysql_intro.html#SECTION0003000000]) して [[MySQL]] ユーザーを更新してください:

 USE mysql;
 UPDATE user SET password=PASSWORD(''''''your_password'''''') WHERE user='rt_user';
 FLUSH PRIVILEGES;

{{Tip|内部ユーザーを使って [[MySQL]] サーバーに手動でログインすることはないため、パスワードは長く強固なものを設定してください。''pwgen'' というプログラムで生成できます。ハッキングされないようにランダムな50文字程度のパスワードを設定すると良いでしょう。}}

== RT を使う ==

上記のセクションが完了したら、{{ic|httpd}} を再起動して http://localhost/rt に接続してみてください。デフォルトの管理者アカウントは {{ic|root:password}} です。

=== RT_SiteConfig.pm の設定 ===

{{ic|/var/log/httpd/error_log}} に {{ic|RT_SiteConfig.pm}} ファイルの設定を変更するように提案されることもあります。RT のページをロードしたときに何もエラーが出力されないように設定することを推奨します。

=== ドキュメント ===

RT を立ち上げることができたら後は使用するだけです。RT の設定方法は [http://bestpractical.com/rt/docs.html Best Practical のオンラインドキュメント] を見てください。