Redmine 1.2 のセットアップ全手順

サイトのテーマとは少し外れますが、Redmine 1.2のセットアップを行いましたので、その手順をそのまま掲載します。

ただし、標準出力に表示されたものをすべて掲載すると大変に長くなります。複数に分割掲載してもいいのですが、それよりも手順とポイントだけに整理して掲載することにしました。

Redmineとは、プロジェクト管理、特にシステム開発プロジェクトでの様々な作業や情報を管理を一元的に管理することにより、プロジェクトの生産性を向上し、効率的なプロジェクト管理を実現するためのオープンソースソフトウェアです。主に、システム開発プロジェクトに利用されることが多いようですが、一般のプロジェクトにももちろん利用できます。

詳しくは下記の各サイトをご覧ください。

Redmine.JP http://redmine.jp/

1.Rubyのインストール
[root ~]# yum groupinstall "開発ツール"
[root ~]# yum install zlib-devel
[root ~]# yum install openssl-devel
[root ~]# mkdir ruby
[root ~]# cd ruby
[root ~]# wget ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.7-p334.tar.gz
[root ~]# tar xzvf ruby-1.8.7-p334.tar.gz
[root ~]# cd ruby-1.8.7-p334
[root ~]# ./configure
[root ~]# make
・・・ここで数多くの「警告」が出ると思いますが、気にしなくて大丈夫です。
[root ~]# make install
[root ~]# make clean
[root ~]# ruby -v
ruby 1.8.7 (2011-02-18 patchlevel 334) [x86_64-linux]
2.RubyGemsのインストール
[root ~]# mkdir rubygems
[root ~]# cd rubygems
[root ~]# wget http://production.cf.rubygems.org/rubygems/rubygems-1.8.5.tgz
[root ~]# tar xzvf rubygems-1.8.5.tgz
[root ~]# cd rubygems-1.8.5
[root ~]# ruby setup.rb
[root ~]# gem --version
1.8.5
3.Rackのインストール

Rack 1.1.1をインストールします。

[root ~]# gem install rack -v=1.1.1 --no-rdoc --no-ri
Fetching: rack-1.1.1.gem (100%)
Successfully installed rack-1.1.1
1 gem installed

※2011年10月25日に実行したところ、この手順では下記のように失敗しました。

[root ~]# gem install rack -v 1.1.1 --no-rdoc --no-ri
ERROR:  Could not find a valid gem 'rack' (= 1.1.1) in any repository
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    SocketError: getaddrinfo: Name or service not known (http://rubygems.org/latest_specs.4.8.gz)

その場合、実行ディレクトリで次のようにダウンロードしてから実行してみてください。

[root ~]# wget http://rubygems.org/downloads/rack-1.1.1.gem
[root ~]# gem install rack -v=1.1.1 --no-rdoc --no-ri
Fetching: rack-1.1.1.gem (100%)
Successfully installed rack-1.1.1
1 gem installed
4.rakeのインストール

rake 0.8.7をインストールします。

[root ~]# gem install rake -v=0.8.7 --no-rdoc --no-ri
Fetching: rake-0.8.7.gem (100%)
Successfully installed rake-0.8.7
1 gem installed

※2011年10月25日に実行したところ、この手順では下記のように失敗しました。

[root ~]# gem install rake -v=0.8.7 --no-rdoc --no-ri
ERROR:  Could not find a valid gem 'rake' (= 0.8.7) in any repository
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    SocketError: getaddrinfo: Name or service not known (http://rubygems.org/latest_specs.4.8.gz)

その場合、実行ディレクトリで次のようにダウンロードしてから実行してみてください。

[root ~]# wget http://rubygems.org/downloads/rake-0.8.7.gem
[root ~]# gem install rake -v=0.8.7 --no-rdoc --no-ri
Successfully installed rake-0.8.7
1 gem installed
5.i18nのインストール

i18n 0.4.2をインストールします。

[root ~]# gem install i18n -v=0.4.2 --no-rdoc --no-ri
Successfully installed i18n-0.4.2
1 gem installed

※2011年10月25日に実行したところ、この手順では下記のように失敗しました。

[root ~]# gem install i18n -v=0.4.2 --no-rdoc --no-ri
ERROR:  Could not find a valid gem 'i18n' (= 0.4.2) in any repository
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    SocketError: getaddrinfo: Name or service not known (http://rubygems.org/latest_specs.4.8.gz)

その場合、実行ディレクトリで次のようにダウンロードしてから実行してみてください。

[root ~]# wget http://rubygems.org/downloads/i18n-0.4.2.gem
[root ~]# gem install i18n -v=0.4.2 --no-rdoc --no-ri
Successfully installed i18n-0.4.2
1 gem installed
6.Ruby on Railsのインストール
[root ~]# gem install rails -v 2.3.11 --no-rdoc --no-ri
Fetching: activesupport-2.3.11.gem (100%)
Fetching: activerecord-2.3.11.gem (100%)
Fetching: actionpack-2.3.11.gem (100%)
Fetching: actionmailer-2.3.11.gem (100%)
Fetching: activeresource-2.3.11.gem (100%)
Fetching: rails-2.3.11.gem (100%)
Successfully installed activesupport-2.3.11
Successfully installed activerecord-2.3.11
Successfully installed actionpack-2.3.11
Successfully installed actionmailer-2.3.11
Successfully installed activeresource-2.3.11
Successfully installed rails-2.3.11
6 gems installed
[root ~]# rails -v
Rails 2.3.11

※2011年10月25日に実行したところ、この手順では下記のように失敗しました。

[root ~]# gem install rails -v 2.3.11 --no-rdoc --no-ri
ERROR:  Could not find a valid gem 'rails' (= 2.3.11) in any repository
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    SocketError: getaddrinfo: Name or service not known (http://rubygems.org/latest_specs.4.8.gz)

その場合、実行ディレクトリで次のようにダウンロードしてから実行してみてください。

[root ~]# wget http://rubygems.org/downloads/rails-2.3.11.gem
[root ~]# wget http://rubygems.org/downloads/activesupport-2.3.11.gem
[root ~]# wget http://rubygems.org/downloads/activerecord-2.3.11.gem
[root ~]# wget http://rubygems.org/downloads/actionpack-2.3.11.gem
[root ~]# wget http://rubygems.org/downloads/actionmailer-2.3.11.gem
[root ~]# wget http://rubygems.org/downloads/activeresource-2.3.11.gem
[root ~]# gem install rails -v 2.3.11 --no-rdoc --no-ri
Successfully installed activesupport-2.3.11
Successfully installed activerecord-2.3.11
Successfully installed actionpack-2.3.11
Successfully installed actionmailer-2.3.11
Successfully installed activeresource-2.3.11
Successfully installed rails-2.3.11
6 gems installed
7.MySQLのインストールと起動

MySQLについては次のパッケージをインストール済みで運用していました。

  • mysql-5.5.14-1
  • mysql-server-5.5.14-1
  • mysql-libs-5.5.14-1

インストールが必要なパッケージは、mysql-devel-5.5.14-1 です。

[root ~]# wget http://rpms.famillecollet.com/enterprise/5/remi/x86_64/mysql-devel-5.5.13-1.el5.remi.x86_64.rpm
[root ~]# yum install mysql-devel-5.5.13-1.el5.remi.x86_64.rpm

次に、MySQLの設定ファイル my.cnf の設定・調整を行い、MySQL を起動します。

[root ~]# service mysqld start
8.MySQLのユーザとデータベースの作成
[root ~]# mysql -u root
mysql> create database redmine default character set utf8;
mysql> grant all privileges on redmine.* to redmine identified by 'パスワード';
mysql> quit;
9.Ruby用MySQLパッケージのインストール
[root ~]# gem install mysql -- --with-mysql-lib=/usr/lib/mysql
Building native extensions.  This could take a while...
Successfully installed mysql-2.8.1
1 gem installed
Installing ri documentation for mysql-2.8.1...
(略)
Installing RDoc documentation for mysql-2.8.1...
(略)

※2011年10月25日に実行したところ、この手順では下記のように失敗しました。

[root ~]# gem install mysql -- --with-mysql-lib=/usr/lib/mysql
ERROR:  Could not find a valid gem 'mysql' (>= 0) in any repository
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    SocketError: getaddrinfo: Name or service not known (http://rubygems.org/latest_specs.4.8.gz)

その場合、実行ディレクトリで次のようにダウンロードしてから実行してみてください。

[root ~]# wget http://rubygems.org/downloads/mysql-2.8.1.gem
10.Redmineのインストール

Redmineのインストール先は /var/lib/redmine/ とします。

[root ~]# mkdir redmine
[root ~]# cd redmine
[root ~]# wget http://rubyforge.org/frs/download.php/74944/redmine-1.2.0.tar.gz
[root ~]# tar xzvf redmine-1.2.0.tar.gz
[root ~]# mv redmine-1.2.0 /var/lib/redmine
11.Redmineのデータベース設定
[root ~]# cp -p /var/lib/redmine/config/database.yml.example /var/lib/redmine/config/database.yml
[root ~]# vim /var/lib/redmine/config/database.yml
(次の設定だけ有効にする)
production:
  adapter: mysql
  database: redmine
  host: localhost
  username: redmine
  password: パスワード
  encoding: utf8
12.Redmineのコンフィグレーション

/var/lib/redmine/config/configuration.yml.example を元に /var/lib/redmine/config/configuration.yml を作成して設定しますが、今回はメール通知などを使用しませんので、作成自体をしませんでした。

13.セッション管理用秘密鍵の作成
[root ~]# rake generate_session_store
rake aborted!
No Rakefile found (looking for: rakefile, Rakefile, rakefile.rb, Rakefile.rb)
/usr/local/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2377:in `raw_load_rakefile'
(See full trace by running task with --trace)
[root ~]# cd /var/lib/redmine/
[root ~]# rake generate_session_store
(in /var/lib/redmine)
NOTE: Gem.source_index is deprecated, use Specification. It will be removed on or after 2011-11-01.
Gem.source_index called from /var/lib/redmine/config/../vendor/rails/railties/lib/rails/gem_dependency.rb:21.
(略)

ここまで来て、このように失敗します。

14.失敗原因の解決
[root ~]# gem install -v 1.5.2 rubygems-update
Fetching: rubygems-update-1.5.2.gem (100%)
Successfully installed rubygems-update-1.5.2
1 gem installed
Installing ri documentation for rubygems-update-1.5.2...
Installing RDoc documentation for rubygems-update-1.5.2...

※2011年10月25日に実行したところ、この手順では下記のように失敗しました。

[root ~]# gem install -v 1.5.2 rubygems-update
ERROR:  Could not find a valid gem 'rubygems-update' (= 1.5.2) in any repository
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    SocketError: getaddrinfo: Name or service not known (http://rubygems.org/latest_specs.4.8.gz)

その場合、実行ディレクトリで次のようにしてみてください。

[root ~]# wget http://rubygems.org/downloads/rubygems-update-1.5.2.gem


ここまで終わったら、次に行きます。

[root ~]# update_rubygems
RubyGems 1.5.2 installed
(略)
[root ~]# gem --version
1.5.2
[root ~]# rake generate_session_store
rake aborted!
No Rakefile found (looking for: rakefile, Rakefile, rakefile.rb, Rakefile.rb)
/usr/local/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2377:in `raw_load_rakefile'
(See full trace by running task with --trace)

Rakefile が見つからないようですので、カレントディレクトリを移動します。

[root ~]# cd /var/lib/redmine
[root ~]# rake generate_session_store
(in /var/lib/redmine)

これでやっと成功したようです。
RubyGemsのバージョンが新しすぎたことが原因。

15.Redmineのデータベース初期化
[root ~]# rake db:migrate RAILS_ENV=production
(in /var/lib/redmine)
==  Setup: migrating ==========================================================
-- create_table("attachments", {:force=>true})
   -> 0.0726s
(略)
16.Apache httpdの開発パッケージのインストール
[root ~]# yum install httpd-devel
17.Passengerのインストール
[root ~]# gem install passenger

fastthread、daemon_controller が必要である旨のメッセージ「passenger requires fastthread (>= 1.0.1, runtime)」「passenger requires daemon_controller (>= 0.2.5, runtime)」でエラーとなる場合には、次のようにそれらをインストールしてから、passenger をインストールします。

[root ~]# gem install fastthread
[root ~]# gem install daemon_controller

※ここでも「ERROR: Could not find a valid gem ‘パッケージ名’ (= バージョン) in any repository」となって失敗する場合には、実行ディレクトリで次のようにしてみてください。

[root ~]# wget http://rubygems.org/downloads/passenger-3.0.7.gem
[root ~]# wget http://rubygems.org/downloads/fastthread-1.0.7.gem
[root ~]# wget http://rubygems.org/downloads/daemon_controller-0.2.6.gem


ここまで終わったら、次に行きます。

[root ~]# passenger-install-apache2-module

ここで失敗しました。
curl-devel が必要だとメッセージが表示されました。

[root ~]# yum install curl-devel
[root ~]# passenger-install-apache2-module
(略)
--------------------------------------------
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.8/gems/passenger-3.0.7/ext/apache2/mod_passenger.so
   PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.7
   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.


--------------------------------------------
Deploying a Ruby on Rails application: an example

Suppose you have a Rails application in /somewhere. Add a virtual host to your
Apache configuration file and set its DocumentRoot to /somewhere/public:

   <VirtualHost *:80>
      ServerName www.yourhost.com
      DocumentRoot /somewhere/public    # <-- be sure to point to 'public'!
      <Directory /somewhere/public>
         AllowOverride all              # <-- relax Apache security settings
         Options -MultiViews            # <-- MultiViews must be turned off
      </Directory>
   </VirtualHost>
(略)
18.httpdの設定

httpd.confに、Pssengerインストール時に表示された次の3行を追加します。

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

バーチャルサーバを、同じく表示された下記の内容を参考に構成します。

   <VirtualHost *:80>
      ServerName www.yourhost.com
      DocumentRoot /somewhere/public    # <-- be sure to point to 'public'!
      <Directory /somewhere/public>
         AllowOverride all              # <-- relax Apache security settings
         Options -MultiViews            # <-- MultiViews must be turned off
      </Directory>
   </VirtualHost>

これでも大変長くなりましたが、これで完了です。

ちなみに、デフォルトで作成される redmne の管理者は admin で、パスワードはデフォルトで admin です。

Comments are closed.