Windows10環境へRedmineをインストール

# Windows10環境へRedmineをインストールした作業メモ
どうやってインストールしたか忘れているだろう3年後の自分へ向けて、備忘録としてRedmineをインストールする手順をここに残しておく。
（※1年後も覚えているか怪しいが）

## そもそも「Redmine」とは
Redmineは、プロジェクト管理に使用されるオープンソースのWebアプリケーションで、Ruby on Railsフレームワークを使用して作成されている。



公式サイト[^1]はこちら ↓

https://redmine.jp/

作業内容はインストールガイド[^2]や他の方がQiita[^3]に投稿した記事を参考にした ↓

https://www.redmine.org/projects/redmine/wiki/RedmineInstall#fn2

https://qiita.com/Phinloda/items/58afa1e42a36503bf076


## 導入環境・ソフトウェア
|OS・ソフトウェア|バージョン等|
|---|---|
|Windows|Windows 10 Pro 64bit|
|Redmine|Redmine 5.0|
|Ruby|Ruby 3.0|
|PostgreSQL|PostgreSQL 15|

:::note warn 
[インストールガイド](https://www.redmine.org/projects/redmine/wiki/RedmineInstall#fn2)で導入するソフトウェアに必要なバージョンが違っていると、後続の手順でうまくいかないので必ず確認すること（経験に基づく注意喚起）
:::

## 事前準備
インストールガイドには記載はないが、事前にインストールしておかないといけないものをインストールしておく。

1. Rubyのインストール

    [公式サイト](https://rubyinstaller.org/downloads/)からインストーラーをダウンロードする。
    今回インストールするRedmineはRuby on railsを使用するのでDevkitがついているインストーラーをダウンロードする。
![Downloads - Google Chrome 2023_04_17 12_29_11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/87343/a353997e-da4a-8f95-869f-98c8a82b9fb2.png)

2. PostgreSQLのインストール

    [ここ](https://qiita.com/RottenOrange/items/2edd0becf4253716a49f)を参照。（PostgreSQLのインストールについては別出しで記載）

3. webrickのインストール（※Rubyインストール後に実行）
    実行コマンド
    ```
    gem install webrick
    ```

4. ImageMagickのインストール（※Rubyインストール後に実行）
+ [ImageMagickのダウンロードサイト](https://imagemagick.org/script/download.php)から「ImageMagick-7.1.1-7-Q16-HDRI-x64-dll.exe」をダウンロードする
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/87343/f1d4e6b1-7687-4535-8146-f4163e76cddf.png)

+ ダウンロードしたファイルを実行する。基本的にはデフォルトのまま設定するが、下の画面の時は、「Install development headers and libraries for C and C++」のチェックを忘れないようにする。
![Setup 2023_04_16 17_38_52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/87343/e34bd059-a534-9452-82d4-cb52a1425c40.png)

+ 環境変数の設定

|変数名|変数値|補足|
|---|---|---|
|Path|C:\Program Files\ImageMagick|インストールしたときに設定したディレクトリを設定する

+ 下記コマンドの実行
```
gem install rmagick
```
 


## Redmineのインストール
Redmineのインストールは公式のインストールガイドに従って実施する。
### 1. Redmineインストール
下記サイトから「redmine-5.0.5.zip」をダウンロードし、解凍する。解凍したフォルダは、Cドライブ直下（C:\redmine-5.0.5）に配置する。

https://www.redmine.org/projects/redmine/wiki/Download

### 2. 空のデータベースとユーザを作成
今回はPostgreSQLにデータベースをユーザを作成する。
+ psqlを起動
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/87343/3040d89f-6e6f-8772-9c35-597c5d7c8082.png)

+ 下記コマンドを実行
```sql
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
```
※パスワードの箇所（PASSWORD 'my_password'）は、適宜書き換えて実行

### 3. データベース接続のための設定
+ config配下にある「database.yml.example」をコピーし、「database.yml」を作成する。
+ 「database.yml」に下記内容を設定
```
production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: "my_password" ※適宜書き換え
  encoding: utf8
```

### 4. 依存関係にあるソフトウェアのインストール
実行コマンド：
```
bundle config set --local without 'development test' 
bundle install --without development test
bundle add webrick rmagick
```

### 5. セッションストア秘密鍵の生成
実行コマンド：
```
bundle exec rake generate_secret_token
```

### 6. データベーススキーマ等の作成
+ 環境変数の設定

|変数名|変数値|補足|
|---|---|---|
|RUBY_DLL_PATH|C:\Program Files\PostgreSQL\15\bin|PostgreSQLをインストールしたディレクトリのパスを設定|

+ 下記コマンドを実行
```
set RAILS_ENV=production
bundle exec rake db:migrate
```

※環境変数の設定を行っておかないとエラーになるので注意。[このページ](https://qiita.com/inatsuhiko/items/34f8e3acacbedb724014)[^4]を参照して解決

### 7. デフォルトデータセット
+ 下記コマンドを実行
```
set RAILS_ENV=production
set REDMINE_LANG=ja
bundle exec rake redmine:load_default_data
```

### 8. ファイルシステムのアクセス権の設定
Windows版ではこの作業はスキップ


### 9. インストールの確認
+ 公式のコマンドではうまく実行できなかったので、[参考にしたページ](https://qiita.com/Phinloda/items/58afa1e42a36503bf076)[^3]のコマンドを実行
```
bundle exec rails s -e production
```

### 10. アプリケーションにログイン
下記URLにアクセスし、ログイン画面を開く
[http://localhost:3000/](http://localhost:3000/)

【ログイン画面】
![Redmine - Google Chrome 2023_04_17 8_07_19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/87343/d97977ea-e815-e69f-e78f-c37876532a79.png)

|項目|設定値|
|---|---|
|ユーザID|admin|
|パスワード|admin|

上表のユーザでログインする。その後、パスワード変更を求められるので、適宜、設定する。

![Redmine - Google Chrome 2023_04_17 8_07_37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/87343/f2648dc8-93d4-27da-4b96-4d3b9da50001.png)

パスワード変更後、個人設定画面に遷移する。
![個人設定 - Redmine - Google Chrome 2023_04_17 8_08_51.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/87343/d0e9d459-05db-34e4-dc51-37284a7e7aad.png)

ここまでRedmineのインストールは完了。




[^1]:[Redmine.JP - プロジェクト管理のオープンソースのソフトウェア「Redmine」の日本語情報サイト](https://redmine.jp/)
[^2]:[Redmine - Installing Redmine](https://www.redmine.org/projects/redmine/wiki/RedmineInstall#fn2)
[^3]:[Windows10にRedmineをインストールした](https://qiita.com/Phinloda/items/58afa1e42a36503bf076)
[^4]:[Windows10 で Ruby3 + pg gem を利用して postgreSQL にアクセスするとエラー `AddDllDirectory failed for x64-mingw32` になる](https://qiita.com/inatsuhiko/items/34f8e3acacbedb724014)