{{TOC}}

## 概要

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

## プラグイン名

- Additionals
-

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

### 前提

新バージョンはRedmine 5.xから対応しているため、Redmine4.2で動かすためには少し作業が必要です。 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 https://github.com/AlphaNodes/additionals/archive/refs/tags/3.0.5.2.zip
```

# リリースノートで、Redmine 4.2に対応したバージョンがこれでした

- ファイル解凍

```bash
unzip 3.0.5.2.zip
```

- 解凍されたディレクトリの所有権変更

```bash
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
# 自分の環境に合わせます。また、ディレクトリ名からバージョン名を外すのを忘れないようにしてください
```

自分の環境に合わせます。また、ディレクトリ名からバージョン名を外すのを忘れないようにしてください。

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

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

自分の環境に合わせます。

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

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

sudo -u www-data bundle install
```

#### 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」の名前は伊達ではなく、有用なマクロが加わっているという印象です。どういう使い方ができるかは要検証です。