Redmine.JP Blog

Redmine 2.0をCentOS 6にインストールする手順

2012-05-15T07:30:00Z

インストール直後のCentOS 6にRedmine 2.0をインストールする手順です。

本手順で作成される環境

本手順で作成される環境は以下のとおりです。

Redmine	Redmine 2.0
OS	CentOS 6
データベース	MySQL 5.1.61
webサーバ	Apache 2.2.15(Railsの実行にはPassengerを使用)
Ruby	1.9.3
Ruby Gems	1.8.23(Ruby 1.9.3に同梱のもの)
Ruby on Rails	3.2.3

CentOSの設定

SELinuxを無効にする

エディタで /etc/sysconfig/selinux を開き、 SELINUX の値を disabled に編集してください。

SELINUX=enforcing
↓
SELINUX=disabled

編集後、CentOSを再起動して下さい。

# reboot

再起動後、 getenforce コマンドを実行してSELinuxが無効になったことを確認してください。 Disabled と表示されればSELinuxは無効になっています。

# getenforce
Disabled

iptablesでHTTPを許可

CentOS 6の初期状態ではiptables(ファイアウォール)が有効になっており、外部からサーバ上の80/tcpポート(HTTP)に接続することができません。このままではwebサーバを立ち上げてもクライアントから接続することができませんので、iptablesの設定を変更します。

エディタで /etc/sysconfig/iptables を開き、80/tcpへの接続を許可するための以下の記述を追加してください。追加位置は、22/tcpへの許可している記述の直後としてください。

# Firewall configuration written by system-config-firewall
# Manual customization of this file is not recommended.
*filter
:INPUT ACCEPT [0:0]
:FORWARD ACCEPT [0:0]
:OUTPUT ACCEPT [0:0]
-A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
-A INPUT -p icmp -j ACCEPT
-A INPUT -i lo -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 22 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
-A INPUT -j REJECT --reject-with icmp-host-prohibited
-A FORWARD -j REJECT --reject-with icmp-host-prohibited
COMMIT

設定が終わったらiptablesを再起動してください。

# /etc/init.d/iptables restart

必要なパッケージのインストール

Redmineを使用するにあたり、必要なパッケージのインストールを行います。

EPELリポジトリの登録

Rubyのビルド時に必要なパッケージがEPEL(エンタープライズ Linux 用の拡張パッケージ)にありますのでEPELリポジトリを追加します。

下記のページから最新の epel-release をインストールしてください。

http://ftp.riken.jp/Linux/fedora/epel/6/i386/repoview/epel-release.html

例

# rpm -Uvh http://ftp.riken.jp/Linux/fedora/epel/6/i386/epel-release-6-6.noarch.rpm

開発ツール(Cコンパイラ等)

# yum groupinstall "Development Tools"

RubyとPassengerのビルドに必要なヘッダファイルなど

# yum install openssl-devel readline-devel zlib-devel curl-devel libyaml-devel

MySQLとヘッダファイル

# yum install mysql-server mysql-devel

Apacheとヘッダファイル

# yum install httpd httpd-devel

ImageMagickとヘッダファイル

# yum install ImageMagick ImageMagick-devel

Rubyのインストール

これまで当サイトのRedmineインストール記事ではRuby Enterprice Editionを使用してきましたが、Redmine 1.4からRuby 1.9に対応しましたので公式のインタプリタをビルドしてを使用します。

ソースコードのダウンロード

下記のページからRuby 1.9.3のソースコードをダウンロードしてください。

http://www.ruby-lang.org/ja/downloads/

Rubyのビルド

ダウンロードしたRubyのtarballを展開して、configureを実行してください。

# tar zxvf ruby-1.9.3-p194.tar.gz 
# cd ruby-1.9.3-p194
# ./configure

Rubyのビルドとインストールをします。

# make
# make install
# make clean

インストール後、rubyコマンドを実行して正しくインストールされたことを確認してください。

# ruby -v
ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-linux]

bundlerのインストール

Redmineが使用するGemを一括インストールするためのツール、bundlerをインストールします。

# gem install bundler --no-rdoc --no-ri

MySQLの設定

デフォルトキャラクタセットをutf8に設定

エディタで /etc/my.cnf を開き、 [mysqld] セクションに character-set-server=utf8 を、 [mysql] セクションに default-character-set=utf8 を追加してください。

[mysqld]
datadir=/var/lib/mysql
socket=/var/lib/mysql/mysql.sock
user=mysql
# Disabling symbolic-links is recommended to prevent assorted security risks
symbolic-links=0

innodb_file_per_table
query-cache-size=16M
character-set-server=utf8

[mysqld_safe]
log-error=/var/log/mysqld.log
pid-file=/var/run/mysqld/mysqld.pid

[mysql]
default-character-set=utf8

MySQLの起動および自動起動の設定

# /etc/init.d/mysqld start
# chkconfig mysqld on

`/etc/my.cnf` への設定が反映されていることの確認

MySQLのシステム変数に設定されている値が

character_set_filesystem
character_sets_dir

以外すべてutf8になっていることを確認してください。

latin1 になっている項目があれば、 /etc/my.cnf の設定が正しいか確かめてください。

# mysql -uroot
mysql> show variables like 'character_set%';
+--------------------------+----------------------------+
| Variable_name            | Value                      |
+--------------------------+----------------------------+
| character_set_client     | utf8                       | 
| character_set_connection | utf8                       | 
| character_set_database   | utf8                       | 
| character_set_filesystem | binary                     | 
| character_set_results    | utf8                       | 
| character_set_server     | utf8                       | 
| character_set_system     | utf8                       | 
| character_sets_dir       | /usr/share/mysql/charsets/ | 
+--------------------------+----------------------------+

rootユーザーのパスワード変更・匿名ユーザー削除

# mysql -uroot
mysql> use mysql;
mysql> update user set password=password('********') where user = 'root';
mysql> delete from user where user = '';
mysql> flush privileges;
mysql> exit;

※ ******** の部分は任意のパスワードを設定してください。

Redmine用データベースとユーザーの作成

# mysql -uroot -p
mysql> create database db_redmine default character set utf8;
mysql> grant all on db_redmine.* to user_redmine identified by '********';
mysql> flush privileges;
mysql> exit;

※ ******** の部分は任意のパスワードを設定してください。このパスワードは後述のdatabase.ymlの設定で使用します。

Redmineのインストール

Redmineのダウンロード

下記のページからRedmine 2.0のtarball(.tar.gz)をダウンロードしてください。

http://rubyforge.org/frs/?group_id=1850

Redmineの展開と配置

ダウンロードしたRedmineのtarballを展開してください。 redmine-1.4.0 というディレクトリが作成され、その下にRedmineを構成するファイル群が作成されます。

# tar zxvf redmine-2.0.0.tar.gz

Redmineの配置先のディレクトリを決定し、そこへ展開したファイルを移動してください。例えば、 /var/lib/redmine を配置先とする場合、以下のようにします。

# mv redmine-2.0.0 /var/lib/redmine

データベースへの接続設定

Redmineからデータベースへ接続するための設定を記述したファイルを作成します。

以下の内容で REDMINE_ROOT/config/ に database.yml を作成してください。

production:
  adapter: mysql2
  database: db_redmine
  host: localhost
  username: user_redmine
  password: ********
  encoding: utf8

※ ******** 部分は、MySQL上に作成したRedmineユーザーのパスワードです。
※ config/database.yml.example に設定例がありますので参考にしてください。

メールサーバへの接続設定

Redmineからメールサーバへ接続するための設定を記述したファイルを作成します。

以下の内容で REDMINE_ROOT/config/ に configuration.yml ファイルを作成してください。

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "localhost"
      port: 25
      domain: 'example.com'

※ example.com の部分は、Redmineを実行するサーバのFQDNとしてください。
※ config/configuration.yml.example に設定例がありますので参考にしてください。

configuration.yml ではメールサーバへの接続設定のほかにもアップロードされたファイルの保管場所や、データベースの暗号化などが設定できます。詳しくは configuration.yml によるRedmineの設定をご覧ください。

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

アプリケーションが必要とするGemを一括してインストールできるツール、bunderを使用してRedmineで使用するGemをインストールします。

# bundle install --without development test postgresql sqlite

※ 本手順ではデータベースに MySQL を使用するため、 PostgreSQL,SQLite 使用時に必要となるGemのインストールを行わないようにしています。

Redmineの初期設定とデータベースのテーブル作成

セッションデータ暗号化用鍵の生成とテーブル作成を行います。

# rake generate_secret_token
# RAILS_ENV=production rake db:migrate

Passengerのインストール

Apache上でRedmineなどのRailsアプリケーションの実行に必要なPhusion Passengerをインストールします。

# gem install passenger --no-rdoc --no-ri

PassengerのApache用モジュールのインストール

インストーラを実行し画面の指示に従って操作してください。

# passenger-install-apache2-module

インストールが完了すると以下の様に表示されます。太字の部分はApacheに設定すべき内容なので控えておきます。表示される設定情報は passenger-install-apache2-module --snippet を実行して後で参照することもできます。

The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.12/ext/apache2/mod_passenger.so
   PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.12
   PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.

Apacheの設定

Passengerの設定を追加

Passengerの設定をApacheに追加します。 /etc/httpd/conf/httpd.conf に直接追加してもよいですが、管理しやすいようPassenger関係の設定は別ファイルにまとめます。

以下の内容で /etc/httpd/conf.d/passenger.conf を作成してください。

# Passengerの基本設定。
# passenger-install-apache2-module --snippet を実行して表示される設定を使用。
# 環境によって設定値が異なりますので以下の3行はそのまま転記しないでください。
#
LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.12/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.12
PassengerRuby /usr/local/bin/ruby

# Passengerが追加するHTTPヘッダを削除するための設定（任意）。
#
Header always unset "X-Powered-By"
Header always unset "X-Rack-Cache"
Header always unset "X-Content-Digest"
Header always unset "X-Runtime"

# 必要に応じてPassengerのチューニングのための設定を追加（任意）。
#
PassengerMaxPoolSize 20
PassengerMaxInstancesPerApp 4
PassengerPoolIdleTime 3600
PassengerUseGlobalQueue on
PassengerHighPerformance on
PassengerStatThrottleRate 10
RailsSpawnMethod smart
RailsAppSpawnerIdleTime 86400
RailsFrameworkSpawnerIdleTime 0

Apacheの起動および自動起動の設定

# /etc/init.d/httpd start
# chkconfig httpd on

Apache上のPassengerでRedmineを実行するための設定

Redmineを配置したディレクトリ以下のファイルを、Apacheを実行するユーザー・グループ(CentOSの場合はいずれも"apache")で読み書きできるよう、オーナーを変更します。

# chown -R apache:apache /var/lib/redmine

どのような形態(URL)でRedmineを利用するかによって設定が異なります。三つのパターンを例に挙げます。

パターン1: webサーバをRedmine専用として使用

webサーバのルートディレクトリでRedmineを実行するための設定です。「http://サーバIPアドレスまたはホスト名/」でRedmineにアクセスできます。

エディタで /etc/httpd/conf/httpd.conf を開き DocumentRoot をRedmineのpublicディレクトリ(例: /var/lib/redmine/public )に変更してください。

DocumentRoot "/var/www/html"
↓
DocumentRoot "/var/lib/redmine/public"

設定変更後、Apacheを再起動してください。

# /etc/init.d/httpd configtest
# /etc/init.d/httpd graceful

パターン2: サブディレクトリでRedmineを実行

URLのサブディレクトリでURLにアクセスできるように設定します。同じサーバでRedmine以外のアプリケーションを実行する場合や、複数のRedmineを実行する場合に便利な設定です。

シンボリックリンクの作成

Apacheの DocumentRoot に指定されているディレクトリ(通常は /var/www/html )に、Redmineのpublicディレクトリ(例: /var/lib/redmine/public)に対するシンボリックリンクを作成します。シンボリックリンクの名称は、URLのディレクトリ名部分で使いたい名前(例:redmine)にしてください。

# ln -s /var/lib/redmine/public /var/www/html/redmine

Apacheへの設定追加

Apacheの設定ファイル(/etc/httpd/conf/httpd.conf)もしくは前述の手順で作成したPassengerの設定ファイル(/etc/httpd/conf.d/passenger.conf)などに以下の設定を追加します。

RailsBaseURI /redmine

設定後、Apacheを再起動してください。

# /etc/init.d/httpd configtest
# /etc/init.d/httpd graceful

パターン3: バーチャルホストでRedmineを実行

特定のバーチャルホストでRedmineを実行する設定です。Apacheに以下の設定を追加します。

NameVirtualHosts *:80

...

<VirtualHost *:80>
    ServerName www.example.jp
    DocumentRoot /var/lib/redmine/public
</VirtualHost>

設定後、Apacheを再起動してください。

# /etc/init.d/httpd configtest
# /etc/init.d/httpd graceful

インストール完了後の初期設定

インストールが完了しwebブラウザ経由でRedmineにアクセスできる状態になったら、日本語環境で使うための設定変更やユーザーの追加・プロジェクトの追加などを行います。

インストール後の初期設定手順については以下をご覧ください。

Redmineを使い始めるための初期設定 (Redmine.JP)

Redmine 2.0.0 リリース

2012-05-15T07:25:00Z

2012年5月15日、Redmine 2.0.0がリースされました。

直近のメジャーバージョンアップは4月にリリースされた1.4であり、わずか1ヶ月でのメジャーバージョンアップとなります。1.4からの主な変更点は、Redmineで使われているwebアプリケーションフレームワーク Ruby on Rails のバージョンが 2.3.14 から 3.2.3 に更新されたことです。目立った新機能の追加はありません。

Redmine 1.4でRuby 1.9に対応し、今回の2.0でRuby on Rails 3.2に対応したことで、Redmineの開発・実行環境が最近の環境に追いつきました。

Redmine 2.0インストール手順

インストール・アップグレード時の注意

依存するgemの管理にはBundlerが使われています。Bundlerのインストール(gem install bundler)が必要です。
Railsをはじめ、Redmineを実行するのに必要なライブラリはBundlerで一括インストールできます(bundle install)
プラグインのインストールディレクトリが vendor/plugins/ から plugins/ に変更されました。インストール済みのプラグインを移動してください。
Railsのバージョンが変わったことで既存のプラグインが動作しなくなることがあります。
1.4以前からアップグレードした環境では config/initializers/session_store.rb を削除した上で rake generate_secret_token を実行してください。

新規インストール

以下の記事を参考にしてください。

Redmineのインストール手順 (Redmine Guide日本語訳)
Redmine 2.0をCentOS 6にインストールする手順 (Redmine.JP Blog)

旧バージョンからのアップグレード

旧バージョンからのアップグレード手順 (Redmine Guide日本語訳)

Redmine 1.4.2 リリース

2012-05-14T11:00:00Z

2012年5月14日、Redmine 1.4.2がリースされました。

Ruby 1.9.3との互換性の問題など8件の修正のほか、各国語の翻訳の更新等が行われています。

1.4.2の変更点一覧 (www.redmine.org)

Redmine 1.4インストール手順

新規インストール

以下の記事を参考にしてください。

Redmine 1.4をCentOS 6にインストールする手順 (Redmine.JP Blog)

旧バージョンからのアップデート

アップグレード (Redmine Guide日本語訳)

Redmine 1.4よりRedmineが依存するgemの管理のためにBundlerが使われるようになりました。1.3以前からアップグレードを行った場合、Redmineのインストールディレクトリで bundle install を実行してください。

Redmine 1.4新機能紹介: Wikiの全ページを一括してPDFに出力

2012-04-23T04:30:00Z

WikiページをPDFにエクスポートする機能はRedmine 1.3から利用できるようになりましたが、Redmine 1.4ではプロジェクトのWikiの全ページを一括してPDFにエクスポートできるようもなり、より利便性が高まりました。

一括エクスポートの手順

「Wikiページを他の形式にエクスポート」権限の付与

WikiページをPDFにエクスポートするには「Wikiページを他の形式にエクスポート」権限が必要です。管理者権限を持つユーザーで「管理」→「ロールと権限」→「権限レポート」画面で、エクスポート機能を利用させたいロールに権限を付与してください。

この権限は、Redmine 0.9以降を新規インストールした場合は「管理者」ロールに付与されています。それより古いバージョンからアップデートを繰り返したRedmineではどのロールにも権限が付与されていません。

一括エクスポートの操作

Wikiの索引でPDFへのエクスポートを行うと、すべてのページの内容が含まれるPDFが取得できます。

Wikiの索引はのサイドバー内の「索引(名前順)」または「索引(日付順)」をクリックすると表示されます。この状態で画面右下の「他の形式にエクスポート」内の「PDF」をクリックしてください。

ダウンロードしたPDF内のページの順番は索引の画面で表示されている通りの順番です。

Redmine 1.4.1 リリース

2012-04-21T03:00:00Z

2012年4月20日、Redmine 1.4.1がリースされました。

チケットの連続作成ボタンが正しく動作しない不具合(#10675)など6件の不具合修正とユーザーが自分自身のアカウントを削除できる機能(#10664)の追加が行われています。

1.4.1の変更点一覧 (www.redmine.org)

Redmine 1.4インストール手順

新規インストール

以下の記事を参考にしてください。

Redmine 1.4をCentOS 6にインストールする手順 (Redmine.JP Blog)

旧バージョンからのアップデート

アップグレード (Redmine Guide日本語訳)

Redmine.JP Blog

Redmine 2.0をCentOS 6にインストールする手順

本手順で作成される環境

CentOSの設定

SELinuxを無効にする

iptablesでHTTPを許可

必要なパッケージのインストール

EPELリポジトリの登録

例

開発ツール(Cコンパイラ等)

RubyとPassengerのビルドに必要なヘッダファイルなど

MySQLとヘッダファイル

Apacheとヘッダファイル

ImageMagickとヘッダファイル

Rubyのインストール

ソースコードのダウンロード

Rubyのビルド

bundlerのインストール

MySQLの設定

デフォルトキャラクタセットをutf8に設定

MySQLの起動および自動起動の設定

/etc/my.cnf への設定が反映されていることの確認

rootユーザーのパスワード変更・匿名ユーザー削除

Redmine用データベースとユーザーの作成

Redmineのインストール

Redmineのダウンロード

Redmineの展開と配置

データベースへの接続設定

メールサーバへの接続設定

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

Redmineの初期設定とデータベースのテーブル作成

Passengerのインストール

PassengerのApache用モジュールのインストール

Apacheの設定

Passengerの設定を追加

Apacheの起動および自動起動の設定

Apache上のPassengerでRedmineを実行するための設定

パターン1: webサーバをRedmine専用として使用

パターン2: サブディレクトリでRedmineを実行

シンボリックリンクの作成

Apacheへの設定追加

パターン3: バーチャルホストでRedmineを実行

インストール完了後の初期設定

Redmine 2.0.0 リリース

Redmine 2.0インストール手順

インストール・アップグレード時の注意

新規インストール

旧バージョンからのアップグレード

関連情報

Redmineオフィシャルサイト

Redmine.JP

Redmine 1.4.2 リリース

Redmine 1.4インストール手順

新規インストール

旧バージョンからのアップデート

関連情報

Redmineオフィシャルサイト

Redmine.JP

インストール・アップデート

Redmine 1.4について

Redmine 1.4新機能紹介: Wikiの全ページを一括してPDFに出力

一括エクスポートの手順

「Wikiページを他の形式にエクスポート」権限の付与

一括エクスポートの操作

Redmine 1.4.1 リリース

Redmine 1.4インストール手順

新規インストール

旧バージョンからのアップデート

関連情報

Redmineオフィシャルサイト

Redmine.JP

インストール・アップデート

Redmine 1.4について

`/etc/my.cnf` への設定が反映されていることの確認