インストール - 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に依存するソフトウェアのインストール ====
Redmineは、RubyGemの依存関係を管理するために、Bundlerを使用している。<br>
そのため、まず、Bundlerをインストールする。<br>
 gem install bundler
 または
 sudo gem install bundler
<br>
Redmineのインストールディレクトリに移動して、Redmineの実行に必要な全てのgemをインストールする。<br>
 bundle install --without development test
 または
 sudo bundle install --without development test
<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 webrick -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>

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