{{TOC}}

## 概要

Redmineにかなり強力なmacroを付与するプラグイン:additionalsをインストールします。

## プラグイン名

Additionals

https://www.redmine.org/plugins/additionals

### 前提

新バージョンはRedmine 5.xから対応しているため、今利用しているRedmine4.2で動かすためには少し作業が必要です。

### 動作を確認した環境

Redmine 4.2

### 導入時

Gem追加：要
DBマイグレーション：要

## 手順

### さっくりとした手順

1. SSHログイン後、作業ディレクトリに移動
1. wgetでRedmine4.2に即したパッケージをダウンロード
1. パッケージの配置
1. 新規ジェムをインストール
1. DBマイグレーション
1. Webサービス再起動

#### 作業用ディレクトリに移動します。

```bash
cd /hoge
# 任意のディレクトリに移動します
```

#### Redmine4.2に即したバージョンをダウンロードして展開します。

```bash
wget wget https://github.com/AlphaNodes/additionals/archive/refs/tags/3.0.5.2.zip
# リリースノートで、Redmine 4.2に対応したバージョンがこれでした

unzip 3.0.5.2.zip

sudo chown -R www-data:www-data additionals-3.0.5.2
# apache / nginxの実行ユーザに所有者を合わせます
```

#### Redmineディレクトリにプログラムを配置します。

```bash
sudo mv additionals-3.0.5.2 /var/lib/redmine/plugins/additionals
# 自分の環境に合わせます。また、ディレクトリ名からバージョン名を外すのを忘れないようにしてください
```

#### ディレクトリに移動します。

```bash
cd /var/lib/redmine/plugins
# 自分の環境に合わせます。
```

#### Gemをインストールします。

```bash
cd /var/lib/redmine/
# 自分の環境に合わせます。

sudo -u www-data bundle install
```

Alt: DBマイグレーションが必要な場合

#### DBのマイグレーションを行います

```bash
cd /var/lib/redmine/
# 自分の環境に合わせます。

sudo -u www-data bundle exec rake redmine:plugins:migrate RAILS_ENV=production
```

#### Webサービスを再起動します。

```bash
sudo systemctl restart apache2
```

## 動作

1. Redmineに管理者アカウントでログインします。
1. 管理に「Additionals」が加わっていればインストールされています。

「Additionals」の名前は伊達ではなく、有用なマクロが加わっているという印象です。どういう使い方ができるかは要検証です。
R