最近のプロジェクト管理ツールの中で人気が高いRedmineの最新版0.9.2をCentOS5.4へインストールしてみたいと思います。
Redmine0.9系ではプロジェクトの階層化やユーザー管理、通知等が改善され、さらに使いやすくなっています。
Redmine 0.9の変更点 – Redmine.JP Blog


※ここではRedmineで利用するデータベースサーバ（MySQL、SQLite等）とメールサーバが構築済みという前提で進めていきます。

1. 既存Rubyのアンインストール

Redmineが使用するRubyライブラリはRuby1.8.6以上のバージョンが必要になります。
yumインストールされているRubyのバージョンが古い場合は、一旦アンインストールします。

# rubyがインストールされているか確認します。
[user@centos ~]$ yum list installed | grep ruby
ruby.i386                1.8.5-5.el5_4.8                installed
ruby-libs.i386           1.8.5-5.el5_4.8                installed

# yum removeコマンドは依存ファイルも全て削除されてしまう為
# rpm -e --nodepsコマンドでRubyのみをアンインストールします。
[user@centos ~]$ rpm -e --nodeps ruby ruby-libs

# rubyがアンインストールされているか確認します。
[user@centos ~]$ yum list installed | grep ruby

# 完了

2. Rubyのインストール

Rubyの最新版1.9系だとRedmineでテンプレートエラーが発生してしまうため、1.8系の最終バージョンをRPMビルドしてインストールします。
現時点ではruby-1.8.7-p249です。
※最新版はダウンロードサイトで確認してください。

[user@centos ~]$ cd /usr/local/src

# ソースコードをダウンロードします。
[user@centos src]$ wget ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.7-p249.tar.gz

# tarボールを解凍します。
[user@centos src]$ tar zxvf ruby-1.8.7-p249.tar.gz

# Makeして実行ファイルを生成します。
[user@centos src]$ cd ruby-1.8.7-p249
[user@centos ruby-1.8.7-p249]$ ./configure --prefix=/usr
[user@centos ruby-1.8.7-p249]$ make

# RPMパッケージングします。
# checkinstallは別途yum install checkinstall でインストールしてください。
[user@centos ruby-1.8.7-p249]$ checkinstall --fstrans=no
...
いくつか質問されますが、全て[Enter]で進めます。

以下のメッセージが表示されたら「R」を回答します。
Slackware [S], RPM [R] or Debian [D]? R　←　RPMを回答
...

**********************************************************************

 Done. The new package has been saved to

 /usr/src/redhat/RPMS/i386/ruby-1.8.7-p249-1.i386.rpm
 You can install it in your system anytime using:

      rpm -i ruby-1.8.7-p249-1.i386.rpm

**********************************************************************

# RPMパッケージをインストールします。
[user@centos ~]$ rpm -ivh /usr/src/redhat/RPMS/i386/ruby-1.8.7-p249-1.i386.rpm

# インストールされたRubyを確認します。
[user@centos ~]$ ruby -v
ruby 1.8.7 (patchlevel 249) [i686-linux]

# 完了

3. RubyGemsのインストール

Rubyのパッケージ管理システムであるRubyGemsをインストールします。
※最新版はダウンロードサイトで確認してください。

[user@centos ~]$ cd /usr/local/src

# ソースコードをダウンロードします。
[user@centos src]$ wget http://rubyforge.org/frs/download.php/60718/rubygems-1.3.5.tgz

# tarボールを解凍します。
[user@centos src]$ tar zxvf rubygems-1.3.5.tgz

# セットアップを実行します。
[user@centos src]$ ruby rubygems-1.3.5/setup.rb

# インストールされたRubyGemsを確認します。
[user@centos ~]$ gem -v
1.3.5

# 念のため最新版にアップデートします。
# 以降はこのコマンドで最新版にアップデートできます。
[user@centos ~]$ gem update --system
Updating RubyGems
Nothing to update

# 完了

4. Rubyライブラリのインストール

Redmineが使用するフレームワークやその他のパッケージをインストールします。

Railsフレームワーク

[user@centos ~]$ gem install rails --include-dependencies
...
# しばらく時間がかかりますが、そのままにしておきます。
# 完了

MySQL用のライブラリ
RedmineのデータベースにMySQLを使用します。
SQLiteを使用する場合は「sqlite3-ruby」をインストールします。
※テスト用途の場合はSQLite、運用ではMySQLを利用する方が良いです。

[user@centos ~]$ gem install mysql --include-dependencies
...
# 完了

5. データベース作成

MySQLを利用する場合は、Redmine用のデータベースを作成します。
ここでは、データベース（redmine）を作成し、専用ユーザー（redmine_user）にredmineデータベースの全ての操作権限を付与しておきます。

[user@centos ~]$ mysql -u root -p
*******　←　パスワード

# redmineデータベースを作成します。
mysql> CREATE DATABASE `redmine` CHARACTER SET utf8;
Query OK, 1 row affected (0.00 sec)

# 作成したデータベースを確認します。
# ※データベース名は任意の値に変更してください。
mysql> SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| redmine            |　←　作成したデータベース
+--------------------+
3 rows in set (0.01 sec)

# redmineデータベースを操作するユーザーを作成します。
# ユーザー名：redmine_user、パスワード：redmine_password
# ※ユーザー名、パスワードは任意の値に変更してください。
mysql> GRANT ALL PRIVILEGES ON `redmine`.`*` TO 'redmine_user'@'localhost' IDENTIFIED BY 'redmine_password';
Query OK, 1 row affected (0.00 sec)

mysql> \q

# 完了

6. Redmineのインストール

Redmineは最新版の0.9.2をインストールします。
※最新版はダウンロードサイトで確認してください。

[user@centos ~]$ cd /usr/local/src

# ソースコードをダウンロードします。
[user@centos src]$ wget http://rubyforge.org/frs/download.php/69052/redmine-0.9.2.tar.gz

# tarボールを解凍します。
[user@centos src]$ tar zxvf redmine-0.9.2.tar.gz

# ソースコードを配置します。※場所は任意
# ここでは、/usr/local/redmine-0.9.2 にソースを配置し、
# /usr/local/redmine でアクセスできるようにシンボリックリンクを作成しておきます。
[user@centos src]$ mv redmine-0.9.2 /usr/local/
[user@centos src]$ ln -s /usr/local/redmine-0.9.2 /usr/local/redmine

# 完了

7. Redmineの設定

データベースの環境設定

# 設定ファイルを作成します。
[user@centos ~]$ mv /usr/local/redmine/config/database.yml.example \
/usr/local/redmine/config/database.yml

# データベース設定を編集します。
# 環境に応じて項目を変更します。
[user@centos ~]$ vi /usr/local/redmine/config/database.yml
# MySQLを使用する場合
production:
  adapter: mysql
  database: redmine　←　作成したデータベース名
  host: localhost
  username: redmine_user　←　作成したユーザー名
  password: redmine_password　←　作成したパスワード
  encoding: utf8

# SQLiteを使用する場合
production:
  adapter: sqlite3
  database: db/redmine.db

# 保存して完了

メールの環境設定

# 設定ファイルを作成します。
[user@centos ~]$ mv /usr/local/redmine/config/email.yml.example \
/usr/local/redmine/config/email.yml

# メール設定を編集します。
# 環境に応じて項目を変更します。
[user@centos ~]$ vi /usr/local/redmine/config/email.yml
production:
  delivery_method: :smtp
  smtp_settings:
    address: localhost　←　自サーバ内にメールサーバがある場合
    port: 25
    domain: example.net　←　ドメイン名
    #authentication: :login　　　　　　←認証が必要無い場合はコメントアウト
    #user_name: "redmine@example.net"　←認証が必要無い場合はコメントアウト
    #password: "redmine"　　　　　　　 ←認証が必要無い場合はコメントアウト

# 保存して完了

環境設定

# 30文字以上のランダム文字列を生成します。
# mkpasswdはexpectパッケージがインストールされている必要があります。
[user@centos ~]$ mkpasswd -l 30 -C 0 -s 0
hokmgzmqglnjes2pvkkxtdmpb2ynwr

# 設定ファイルを作成します。
[user@centos ~]$ mv /usr/local/redmine/config/additional_environment.rb.example \
config/additional_environment.rb

# 環境設定ファイルを編集します。
[user@centos ~]$ vi /usr/local/redmine/config/additional_environment.rb
# 以下を追加します。
# :secret の部分は生成したランダム文字列を記述します。
config.action_controller.session = { :key => "_myapp_session", :secret => "hokmgzmqglnjes2pvkkxtdmpb2ynwr" }

# 保存して完了

8. Redmineの初期化

データベースの初期化を行います。

[user@centos ~]$ (cd /usr/local/redmine; rake db:migrate RAILS_ENV=production)
(in /usr/local/redmine-0.9.2)
==  Setup: migrating ========================================================
...

# 完了

9. Redmineの起動

# サーバを起動します。
[user@centos ~]$ /usr/local/redmine/script/server -e production
=> Booting WEBrick
=> Rails 2.3.5 application starting on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
...

# サーバを終了する場合は Ctrl-C でシャットダウンします。

デフォルトではポート番号3000番を使用してアクセスする事が出来ます。
例：http://example.net:3000/

初めてログインする場合は、以下でログインします。
ログイン：admin
パスワード：admin


ログイン後、右上の「My account」で言語を「Japanese（日本語）」に変更すると日本語のインターフェースになります。


とりあえずログイン後の設定として「管理」→「設定」で全体的な設定を行います。

• 「既定の言語」を「日本語」に。
• 「送信元メールアドレス」を適宜変更。
• 「認証が必要」を有効に。
• 「ユーザは自分で登録できる」を無効に。

参考：Redmineのインストール – Redmine.JP



以上で、基本的なインストールが完了しました。
次はApacheとの連携、運用などの設定をやりたいと思います。
Redmine0.9.2の設定と運用

このエントリーのトラックバックURL:
http://labs.qui-no.com/140/trackback