インストール - Redmineのソースを表示

== 概要 ==

<br><br>

== Rubyのインストール ==
Rubyのビルドに必要なライブラリをインストールする。<br>
 sudo zypper install gcc gcc-c++ autoconf bison gperf libopenssl-devel libopenssl-1_1-devel libyaml-devel zlib-devel \
                     readline-devel libedit-devel gmp-devel libffi-devel rust cargo ruby2.5-devel
<br>
[https://github.com/ruby/ruby RubyのGithub]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf ruby-<バージョン>.tar.gz
 cd ruby-<バージョン>
<br>
Rubyをビルドおよびインストールする。<br>
 ./autogen.sh
 
 mkdir build && cd build
 
 ../configure --prefix=<Rubyのインストールディレクトリ> --program-suffix=<サフィックス> --disable-install-doc
 make -j $(nproc)
 make install
<br><br>

== Redmineのインストール ==
一般的に、最新のRedmineをインストールする。<br>
Redmineは、6ヶ月ごとに新しいバージョンがリリースされており、実用的でかつ安定している。<br>
リポジトリのtrunkからチェックアウトした開発版は、Ruby on Railsに精通し、かつ最新の開発に追従する必要がない限りは非推奨である。<br>
<br>
また、trunkは正常に動作しないこともあるため、注意が必要である。<br>
<br>
==== Redmineのインストール ====
[http://redmine.jp/download/ Redmineの公式Webサイト]にアクセスして、Redmineをダウンロードする。<br>
ダウンロードしたファイルを展開して、任意のディレクトリに配置する。<br>
<br>
==== 空のデータベースとユーザの作成 ====
* MySQLの場合
 CREATE DATABASE redmine CHARACTER SET utf8mb4;
 CREATE USER 'redmine'@'localhost' IDENTIFIED BY '<パスワード>';
 GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
 
 ※ MySQL 5.5.2以前の場合、utf8mb4ではなくutf8を指定すること。
<br>
* PostgreSQLの場合
 CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD '<パスワード>' NOINHERIT VALID UNTIL 'infinity';
 CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
<br>
==== データベースの接続の設定 ====
Redmineのインストールディレクトリにあるconfig/database.example.ymlファイルをコピーして、config/database.ymlファイルを作成する。<br>
次に、config/database.ymlファイルを編集して、"production"環境用のデータベースの設定を行う。<br>
<br>
* MySQLの場合
 production:
   adapter: mysql2
   database: <上記で作成したデータベース名  例. redmine>
   host: <上記で指定したホスト名  例. localhost>
   port: <ポート番号  例. 3306>
   username: <上記で作成したユーザ名  例. redmine>
   password: "<MySQLにおけるredmineユーザのパスワード>"
   encoding: utf8mb4
   pool: 5
   schema_search_path: public
   socket: <MySQLのソケットファイルのフルパス>
<br>
* PostgreSQLの場合
 production:
   adapter: postgresql
   database: <上記で作成したデータベース名  例. redmine>
   host: <上記で指定したホスト名  例. localhost>
   username: <上記で作成したユーザ名  例. redmine>
   password: "<PostgreSQLにおけるredmineユーザのパスワード>"
   encoding: utf8
   schema_search_path: <データベーススキーマ (デフォルト: public)>
   socket: <PostgreSQLのソケットファイルのフルパス>
<br>
==== Redmineに依存するソフトウェアのインストール ====
<u>MySQL等を使用する場合、mysql2をインストールするために、~/.profileファイル等へMySQLへの環境変数<code>PATH</code>を追記する必要がある。</u><br>
 vi ~/.profile
<br>
 # ~/.profileファイル
 
 export PATH="/<MySQLのインストールディレクトリ>/bin"
<br>
Redmineは、RubyGemの依存関係を管理するために、Bundlerを使用している。<br>
そのため、まず、Bundlerをインストールする。<br>
 gem install bundler
 または
 sudo gem install bundler
<br>
Redmineのインストールディレクトリに移動して、Redmineの実行に必要な全てのgemをインストールする。<br>
 bundle config set --local without 'development test'
 bundle install
 または
 sudo bundle config set --local without 'development test'
 sudo bundle install
<br>

==== データベースアダプタ ====
Redmineは、データベースの設定ファイルであるconfig/database.ymlファイルを読み取り、必要なデータベースアダプタを自動的にインストールする。<br>
（例. mysql2のみを使用するように設定した場合は、mysql2 gemのみがインストールされる）<br>
もし、config/database.ymlファイルを編集してデータベースアダプタの追加や削除を行った後は、必ず、<code>bundle install --without development test ...略</code>を実行する。<br>
<br>
==== 独自の依存関係の設定 (Gemfile.local) ====
もし、Redmine本体が使用しないgem(例. puma、fcgi)もロードする場合は、Gemfile.localファイルをRedmineのインストールディレクトリに作成する。<br>
これは、<code>bundle install</code>コマンド実行時にインストールされる。<br>
 # Gemfile.localファイル
 
 gem 'puma'
<br>
==== セッションストア秘密鍵の生成 ====
Railsはセッションハイジャックを防ぐため、セッション情報を格納するcookieをエンコードしている。<br>
この処理で使用されるランダムなキーを生成する。<br>
 bundle exec rake generate_secret_token
<br>
また、秘密鍵は、config/secrets.ymlファイルに格納することもできる。<br>
<br>
==== データベースのテーブル等の作成 ====
データベースに、Redmineに必要なテーブルを作成する。<br>
<br>
<u>Redmineのインストールディレクトリに移動して</u>、以下に示すコマンドを実行する。<br>
これにより、マイグレーションが1つずつ実行およびテーブルが作成されて、更に権限のデータ一式と管理者アカウント（admin）が作成される。<br>
 RAILS_ENV=production bundle exec rake db:migrate
<br>
==== デフォルトデータ ====
デフォルトデータをデータベースに追加する。<br>
 RAILS_ENV=production bundle exec rake redmine:load_default_data
<br>
各言語のデフォルトデータにおいて、言語の選択が求められる。<br>
なお、上記のコマンドにおいて、<code>REDMINE_LANG</code>オプションを指定する場合、言語の選択を求められることなく自動的に処理が進められる。<br>
 RAILS_ENV=production REDMINE_LANG=en bundle exec rake redmine:load_default_data
<br>
==== ディレクトリおよびファイルのパーミッション ====
Redmineを実行するOSのユーザーは、以下に示すディレクトリの書き込み権限が必要である。<br>
* files (添付ファイルの保存ディレクトリ)
* log (Redmineのログファイル @production.log@)
* tmp (これらのディレクトリが無ければ作成すること)
* tmp/pdf (これらのディレクトリが無ければ作成すること)
* public/plugin_assets (プラグインが使用する画像やCSS)
<br>
 例. redmineユーザとしてソフトウェアを実行する場合
 mkdir -p tmp tmp/pdf public/plugin_assets
 chown -R redmine:redmine files log tmp public/plugin_assets
 chmod -R 755 files log tmp public/plugin_assets
 
 ※注意
 これらのディレクトリが既に存在する場合（バックアップからリストアした場合等）、ファイルに実行権限が不可されていないことを確認する。
 find files log tmp public/plugin_assets -type f -exec chmod -x {} +
<br>
==== Redmineの起動 ====
WEBrickを使用してRedmineを起動する。<br>
 bundle exec rails server -e production
<br>
WEBrickが正常に起動した後、Webブラウザから http://localhost:3000/ にアクセスする。<br>
<br>
デフォルトのシステム管理者アカウントは、以下の通りである。<br>
* ログインID
*: admin
* パスワード
*: admin
<br>
<u>※注意</u><br>
<u>WEBrickは開発時に使用すものであり、通常の運用には適していないため、動作確認以外には使用しないこと。</u><br>
<u>本番運用においては、Passenger(mod_rails)、FCGI、Rackサーバ(Unicorn, Thin, Puma,hellip等)の使用を推奨する。</u><br>
<br><br>

== Apache2との連携 ==
==== Phusion Passengerとは ====
Railsシステムを実行するためのApacheモジュールである。<br>
<br>
==== メリット ====
Redmine等のRuby on RailsシステムをPhusion Passenger([http://www.modrails.com/ mod_rails for Apache])を使用して、Apache上で稼働させる。<br>
これにより、運用の簡素化、複数インスタンスを並列稼働させることによるレスポンスの改善が期待できる。<br>
<br>
特徴<br>
* Apache2を起動するだけでRailsシステムが使用できる。<br>Apache2のモジュールとして実装されており、別途デーモンを起動する必要が無い。<br>Railsシステム用の起動スクリプトは不要である。
* TCPポートを消費しない。
* Railsシステムのデプロイが簡素化される。(PHPのように、ファイルのアップロードのみで出来る)
* サーバのメモリが節約できる。<br>Railsインスタンスは必要なタイミングで生成する。<br>また、一定時間アクセスがなければ、インスタンスを終了させる。
<br>
==== 手順 ====
インストール手順は、次の通りである。<br>
* ビルドに必要なライブラリをインストールする。
* Ruby向けにPassengerをインストールする。
* Apache2向けのPassangerモジュールをビルドする。
* httpd.confを変更する。
* 仮想ホストとして構築する場合は、仮想ホストファイルを作成する。
<br>
==== ビルドに必要なライブラリのインストール ====
 sudo zypper install libcurl-devel
<br>
==== Ruby向けPassengerのインストール ====
 gem install passenger
<br>
==== Apache2向けPassangerモジュールのビルド ====
Apache2をソースコードからビルドおよびインストールしている場合、環境変数APXS2および環境変数PATHを手動で設定する必要がある。<br>
これにより、Apache2のヘッダファイル、APRを探索してインストールすることができる。<br>
<br>
 # ~/.profileファイル
 
 export APXS2=/<Apache2のインストールディレクトリ>/bin/apxs
 export PATH=/<Apache2のインストールディレクトリ>/bin:$PATH
<br>
Apache2向けのPassangerモジュールをビルドする。<br>
 passenger-install-apache2-module
<br>
手順が表示されるので、[Enter]キーを押下して次へ進む。<br>
ビルド環境の選択では、[Ruby]を選択して、[Enter]キーを押下する。<br>
Passengerのビルドが開始する。<br>
<br>
ビルドに成功した時、Passengerを組み込むためのhttpd.confの設定が表示される。<br>
 # 出力例
 
 LoadModule passenger_module /<Rubyのインストールディレクトリ>/lib64/ruby/gems/<Rubyのバージョン>/gems/passenger-<Passengerのバージョン>/buildout/apache2/mod_passenger.so  
 <IfModule mod_passenger.c>                                                                                                                          
   PassengerRoot /<Rubyのインストールディレクトリ>/lib64/ruby/gems/<Rubyのバージョン>/gems/passenger-<Passengerのバージョン>
   PassengerDefaultRuby /<Rubyのインストールディレクトリ>/bin/ruby
 </IfModule>
<br>
==== Apache2の設定 (httpd.confファイルの変更) ====
Apache2の設定ファイル(httpd.conf)において、上記セクションに記述したPassengerを組み込むための設定を追記する。<br>
 <syntaxhighlight lang="apache">
 # httpd.confファイル (設定例)
 
 # ...略
 
  LoadModule passenger_module /<Rubyのインストールディレクトリ>/lib64/ruby/gems/<Rubyのバージョン>/gems/passenger-<Passengerのバージョン>/buildout/apache2/mod_passenger.so  
 <IfModule mod_passenger.c>                                                                                                                          
   PassengerRoot /<Rubyのインストールディレクトリ>/lib64/ruby/gems/<Rubyのバージョン>/gems/passenger-<Passengerのバージョン>
   PassengerDefaultRuby /<Rubyのインストールディレクトリ>/bin/ruby
 </IfModule>
 </syntaxhighlight>
<br>
==== 仮想ホストとして構築する場合 ====
 <syntaxhighlight lang="apache">
 # vhost-redmine.confファイル (設定例)
 
 <VirtualHost *:80>
    ServerName  redmine
 
    # DocumentRoot: The directory out of which you will serve your
    # documents. By default, all requests are taken from this directory, but
    # symbolic links and aliases may be used to point to other locations.
    DocumentRoot /<Redmineのインストールディレクトリ>/public
 
    # if not specified, the global error log is used
    ErrorLog  /<Redmineのインストールディレクトリ>/log/redmine-error_log
    CustomLog /<Redmineのインストールディレクトリ>/log/redmine-access_log combined
 
    # don't loose time with IP address lookups
    HostnameLookups Off
 
    # needed for named virtual hosts
    UseCanonicalName Off
 
    # configures the footer on server-generated documents
    ServerSignature On
 
    # Redmineの画像ファイルおよびCSSファイル等へのアクセスを許可する設定
    # Apache 2.4のデフォルトではサーバ上の全ファイルへのアクセスが禁止されている
    <Directory "/<Redmineのインストールディレクトリ>/public">
        # Possible values for the Options directive are "None", "All",
        # or any combination of:
        #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
        # Note that "MultiViews" must be named *explicitly* --- "Options All"
        # doesn't give it to you.
        #
        # The Options directive is both complicated and important.  Please see
        # http://httpd.apache.org/docs/2.4/mod/core.html#options
        # for more information.
        Options Indexes FollowSymLinks
 
        # AllowOverride controls what directives may be placed in .htaccess files.
        # It can be "All", "None", or any combination of the keywords:
        #   Options FileInfo AuthConfig Limit
        AllowOverride None
 
        # Controls who can get stuff from this server.
        Require all granted
    </Directory>
 </VirtualHost>
 </syntaxhighlight>
<br><br>

__FORCETOC__
[[カテゴリ:CentOS]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]]