タグ: redmine Page 1 of 15

カテゴリー: Linux, redmine

概要

Redmineでファイルをアップロードしようとした際、ModSecurity (WAF) によってブロックされ、エラーになる事象が発生しました。
その原因と事象解決のメモです。

環境

Ubuntu 24.04
Apache 2.4
- RedmineをApacheのMod_Passangerで稼働
Redmine 5.1
ModSecurity v2 / OWASP Core Rule Set (CRS)

事象の確認

環境をWebArenaからXServerに移行した直後。
Redmineのチケットでファイルをアップロードしようとすると、ファイルアップロードのプログレスバーが完了せず、アップロードできません。

原因の特定

こういうときの答えはたいがい、エラーログに書かれているのでそれを確認します。

見つけたログ（IPアドレスやホスト名は改変済み）:

[Wed Aug 13 12:47:21.713637 2025] [security2:error] [pid 11190] [client AAA.BBB.CCC.DDD:40404] ModSecurity: Request body no files data length is larger than the configured limit (131072). [hostname "hoge.example.com"] [uri "/uploads.js"] [unique_id "aJwKye92u8EKc4H_FxCb5QAAABQ"], referer: https://hoge.example.com/issues/123

Request body no files data length is larger than the configured limit (131072)

これは、「ファイル以外のリクエストデータ（no files data）のサイズが、設定された上限値（131072バイト = 128KB）を超えています」という意味です。

Redmineは、ファイルをアップロードする際、ファイルそのものとは別に、チケットの題名や説明といったテキスト情報も同時にサーバーへ送信します。このテキスト情報の合計サイズが、ModSecurityのデフォルトの上限値である128KBを超えてしまったため、攻撃と誤認され、ブロックされる。

というのがAI（Gemini）の回答。

既にApacheのバーチャルサイトの.confファイルには

SecRequestBodyInMemoryLimit 524288000
SecRequestBodyLimit 524288000

と記述していますが、サーバの入れ替えと同時にModSecurityのCRSをアップデートしたことで設定が足りなかったようです。

ここまで分かれば、解決まであと少し。

対処手順

設定ファイルのバックアップ

ModSecurityのメイン設定ファイルで、SecRequestBodyNoFilesLimitの上限値を設定で上書きしていきます。

エラーを起こしているバーチャルサイトの.confファイルのバックアップ

sudo cp -pi /etc/apache2/site-available/redmine.conf /path/to/backup/directory/redmine.conf.$(date +%Y%m%d)

.confの名前やバックアップディレクトリは自分の環境に合わせます。

バックアップ確認

diff -u /path/to/backup/directory/redmine.conf.$(date +%Y%m%d) /etc/apache2/site-available/redmine.conf

差分がなければ（エラーがなければ）バックアップ成功。

上限値を修正する

上述した設定ファイルを以下のように修正。

修正前（例）:

SecRequestBodyInMemoryLimit 524288000
SecRequestBodyLimit 524288000

修正後（例）:

SecRequestBodyInMemoryLimit 524288000
SecRequestBodyLimit 524288000
SecRequestBodyNoFilesLimit 524288000

両方の値を同じにしておくと、管理が分かりやすくなります。

なお、500MBとしているのは一時的に大きなファイルを置くこともあるからです。上限値は自分の運用方針やストレージ量に合わせましょう。

修正確認

ファイル修正後の差分

diff -u /path/to/backup/directory/redmine.conf.$(date +%Y%m%d) /etc/apache2/site-available/redmine.conf

差分例

SecRequestBodyInMemoryLimit 524288000
SecRequestBodyLimit 524288000
+SecRequestBodyNoFilesLimit 524288000

と、追記した行が出てくることを確認します。

設定反映&動作確認

confファイルの構文確認

sudo apache2ctl configtest

Syntax OKを確認します。

Webサービス(Apache)再起動

sudo systemctl restart apache2.service

Webサービス(Apache)再起動確認

systemctl status apache2.service

Running(active)を確認します。

動作確認

Redmineのチケット作成/編集画面でファイルが正常にアップロードできるようになれば対処完了です。

まとめ

新環境の構築時、最新のCRSを導入したため、旧環境をそのまま引き継いだというのが直接的な原因でした。
こういう罠があちこちに潜んでいるので、何かあったらログを見て事象を確かめるのが事象解消の近道です。

confファイルのチューニングでPassangerのメモリ量を節約。

By manualmaton

オン 2025年8月15日

カテゴリー: Linux, redmine

WebArenaからXServerに移行し、メモリを6GBまで増強したものの、スワップの使用量増加が止まらず。

これをチューニングによりなんとか抑えられたというメモ書きです。

経緯

スペックの負荷状況を調べるためにGrowiを導入
十分な性能が見込めたためにNextcloudやBookStackなどを入れていく
それでも稼働していったのでRedmineの移行を終える。
Redmineを入れた途端、スワップ使用率が高くなった。

環境

Ubuntu / Debian系OS
Apache 2.4
libapache2-mod-passengerがインストール済み
Redmineを複数稼働

チューニングの目的

上記環境のmod_passengerは、筆者のように複数のアプリケーションを、リソースが限られたVPSで運用する場合(いわゆる逸般的な使い方)は、メモリを過剰に消費し、サーバー全体のパフォーマンスを低下させる可能性があります。

事実、free -hコマンドで、Swapの使用量が放置しているのに高まってきたという状況でした。

そこで、リクエストがあれば都度、プロセスを増やしてしまうpassengerの機能をチューニングで抑制します。

さっくりとした手順

passengerの設定ファイルのバックアップを行います。
ファイルの修正によるチューニングを行います。
設定を反映させ、状況を確認します。

Passengerの設定ファイルをのバックアップ

※この設定は、バーチャルサイト個別設定ではなく、一括で設定を行います。

なぜなら、Passenger関連のディレクティブが、<VirtualHost>ブロックの中に書くことができないからです。

ファイルのバックアップ

sudo cp -pi /etc/apache2/mods-available/passenger.conf /path/to/backup/direcotry/passenger.conf.$(date +%Y%m%d)

バックアップディレクトリは自分の環境に合わせます。（筆者環境:/etc/conf/backup)

ファイルのバックアップ確認

diff -u -pi /path/to/backup/direcotry/passenger.conf.$(date +%Y%m%d) /etc/apache2/mods-available/passenger.conf

差分がなく、エラーがなければバックアップはできています。

メモリ管理ディレクティブを追記

上記passenger.confファイルを開き、<IfModule mod_passenger.c>...</IfModule>ブロックの中に、以下の設定を追記します。

<IfModule mod_passenger.c>
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby

  # --- ▼ここから追記▼ ---
  # Passengerが起動するRubyプロセスの最大数を4に制限
  PassengerMaxPoolSize 4
  # 各アプリケーションごとに起動する最大プロセス数を1に制限
  PassengerMaxInstancesPerApp 1
  # プロセスが300秒（5分）アイドルだったら停止させる
  PassengerPoolIdleTime 300
  # --- ▲ここまで追記▲ ---
</IfModule>

各ディレクティブの解説

ディレクティブ	説明
`PassengerMaxPoolSize`	Passengerがサーバー全体で起動するRubyプロセスの最大総数です。サーバーのメモリ上限を超えないよう、搭載メモリ量に応じて設定します。
`PassengerMaxInstancesPerApp`	各アプリケーションごとに起動できるプロセスの最大数です。例えば`1`に設定すると、一つのRedmineサイトは同時に1つのプロセスしか使えなくなります。
`PassengerPoolIdleTime`	プロセスがここで指定した秒数以上アクセスがない場合、Passengerはそのプロセスを停止させ、メモリを解放します。

設定の反映

ファイルを保存した後、Apacheを再起動して設定を反映させます。

構文確認

sudo apache2ctl configtest

Syntax Okを確認します。エラーが出たらその箇所を確認し、Syntax OKが出るまで修正します。

Apache再起動

sudo systemctl restart apache2.service

Apache再起動確認

systemctl status apache2.service

Running(Active)を確認します。

動作確認

この状態で一晩ほど様子を見ました。

free -h
               total        used        free      shared  buff/cache   available
Mem:           5.8Gi       3.3Gi       551Mi       141Mi       2.3Gi       2.4Gi
Swap:          2.0Gi       1.5Mi       2.0Gi

のまま。チューニング前はSwapを100～500MBも使用していたことから、動作は安定。設定は有効のようです。

公開用Redmineのサーバ移行。

By manualmaton

オン 2025年8月9日

カテゴリー: 未分類

一般公開しているRedmine「クーケン島観光ガイド」、新規VPS、XServerへの移行に伴いデータの移設を行いました。

の構成はそのまま。コンテンツもそのまま移植しています。

ここに至るまで盛大にハマりましたが、なんとかなりました。

この時の記事は改めて記載します。

Redmine5.1にadditionalsをインストール

By manualmaton

オン 2025年7月20日

カテゴリー: Linux, redmine

以前も書いていたadditonalsプラグインのインストール、Redmine5.1版です。

このプラグインの最新版はRedmine6.0のみ対応しています。そのため、ややバージョンの落ちるRedmine5.1で動かすには少し手間があります。

概要

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

また、このプラグインは「additonal_tags」プラグインでも必要です。

プラグイン名

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

注意

2025年にリリースされているプラグインはRedmine 5.xをサポートしていないため、動くバージョン（タグ）をダウンロードしてのインストールです。

動作を確認した環境

Ruby 3.1
Redmine 5.1
Apache 2.4

さっくりとした手順

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

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

cd /hoge

任意のディレクトリに移動します

Redmine5,1に即したバージョンをダウンロードして展開します。

ファイル入手

wget https://github.com/AlphaNodes/additionals/archive/refs/tags/3.4.0.zip

zipファイルの所有者変更

sudo chown www-data:www-data 3.4.0.zip

apache / nginxの実行ユーザに所有者を合わせます

解凍

sudo -u www-data unzip 3.4.0.zip

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

ファイル配置

sudo -u www-data mv additionals-3.4.0 /path/to/redmine/root/directory/plugins/additionals

このとき、リネームも行います。（-3.4.0を外す）

自分の環境に合わせます。(筆者環境/home/www-data/redmine/plugins/)

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

cd /path/to/redmine/root/directory && pwd

自分の環境に合わせます。(筆者環境/home/www-data/redmine)

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

sudo -u www-data bundle install

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

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

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

sudo systemctl restart apache2

動作確認

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

公開用Redmineの整備。

By manualmaton

オン 2025年7月17日

カテゴリー: redmine, デジタルゲーム

別サイトとして運営している

（上記マルチドメインのため、どちらのサイトでも同じ内容です）

こちら、『ライザのアトリエトリロジーDX』のリリースにより整備する必要が出てきました。

プロジェクトの追加とキャッチ画像の追加

プロジェクト - クーケン島観光ガイド

それぞれにBing Image Creatorで生成したアイコンを指定。

更に、今まで作っていなかったプロジェクトとして

概要 - 02_arライザのアトリエ1 - クーケン島観光ガイド

『ライザのアトリエ』を追加です。DX版に伴い、もう一度、最初からやっていき言語化していきたいなと思った次第です。

ただ、それまでの間に今止まっている

『ユミアのアトリエ』のクエストなどの整理
『ライザのアトリエ2』陽炎の島の装備の解説

など、やることは多いです。

Redmine_View_Customizeでチケットのステータスにラジオボタンを追加する

By manualmaton

オン 2025年7月13日

カテゴリー: redmine

やりたいこと

Redmineのステータス一覧のドロップダウンリストにラジオボタンを追加し、ステータスの遷移を行いやすくします。

前提

Redmine View Customize がインストールされていること。
Redmine 5.1で動作を確認しています。

手順

画面移動

Redmineに管理者権限でログインします。
管理＞表示のカスタマイズに移動します。

カスタマイズ作成：JavaScript

表示のカスタマイズに移動後、「新しい表示のカスタマイズ」をクリックします。

以下の通りに入力します。

パスのパターン
/issues/[0-9]+
プロジェクトのパターン
空白
挿入位置
全ページのヘッダ
種別
JavaScript

コード

$(function() {
  const $select = $('#issue_status_id');
  if ($select.length === 0) return;

  const currentVal = $select.val();

  // ラジオボタンを入れるコンテナ
  const $radioContainer = $('<div class="status-radio-container"></div>');

  $select.find('option').each(function() {
    const val = $(this).val();
    const label = $(this).text();

    if (!val) return; // 空value（プレースホルダなど）はスキップ

    const id = 'status_radio_' + val;

    const $radio = $('<input type="radio">').attr({
      id,
      name: 'issue_status_radio',
      value: val
    });

    if (val === currentVal) {
      $radio.prop('checked', true);
    }

    const $label = $('<label>').attr('for', id).text(label);
    const $wrapper = $('<div class="radio-wrapper"></div>').append($radio, $label);

    $radioContainer.append($wrapper);
  });

  // ドロップダウンを非表示にし、ラジオボタンを挿入
  $select.hide().after($radioContainer);

  // ラジオ選択時に元のselectを更新
  $radioContainer.on('change', 'input[type=radio]', function() {
    $select.val($(this).val());
  });
});

コメント
任意「チケットステータスにラジオボタンを追加する-JavaScript-」など
有効
チェック
プライベート
チェックを外す

設定後、保存をクリックします。

カスタマイズ作成：CSS

表示のカスタマイズに移動後、「新しい表示のカスタマイズ」をクリックします。

以下の通りに入力します。

パスのパターン
/issues/[0-9]+
プロジェクトのパターン
空白
挿入位置
全ページのヘッダ
種別
CSS

コード

.status-radio-container {
  display: flex;
  flex-wrap: wrap;
  gap: 10px 20px;
  margin-top: 5px;
}

.radio-wrapper {
  display: flex;
  align-items: center;
  width: 220px; /* カラム幅は調整可能 */
}

.radio-wrapper label {
  margin-left: 6px;
  cursor: pointer;
}

コメント
任意「チケットステータスにラジオボタンを追加する-CSS-」など
有効
チェック
プライベート
チェックを外す

設定後、保存をクリックします。

動作を確認します。

任意のチケット編集画面をクリックします。

ステータス変更画面がドロップダウンリストからラジオボタンに変わっていれば成功です。

Redmine View_Customize_Pluginによる「ヘッダに新規チケット発行のリンク」。

By manualmaton

オン 2025年7月1日

カテゴリー: Linux, redmine

やりたいこと

Redmineのヘッダに「新しいチケットの作成」のリンクを入れ、トップページから特定のプロジェクトでチケットを発行できるようにします。

前提

Redmine View Customize がインストールされていること。
Redmine 5.1で動作を確認しています。

手順

画面移動

Redmineに管理者権限でログインします。
管理＞表示のカスタマイズに移動します。

カスタマイズ作成：JavaScript

表示のカスタマイズに移動後、「新しい表示のカスタマイズ」をクリックします。

以下の通りに入力します。

パスのパターン
空白
プロジェクトのパターン
空白
挿入位置
全ページのヘッダ
種別
JavaScript

コード

$(function() {
  // ▼▼▼ ここにチケットを作成したいプロジェクトの「識別子」を記述してください ▼▼▼
  const TARGET_PROJECT_ID = 'project-id';
  // ▲▲▲ ------------------------------------------------------------ ▲▲▲

  // プロジェクト識別子が設定されていない場合は処理を中断
  if (!TARGET_PROJECT_ID || TARGET_PROJECT_ID === 'your-project-identifier') {
    return;
  }

  const newIssueUrl = '/projects/' + TARGET_PROJECT_ID + '/issues/new';

  // トップメニューにリンクを追加
  $('#top-menu ul').append(
    $('<li>').append(
      $('<a>', {
        href: newIssueUrl,
        'class': 'new-issue',
        text: '新しいチケットの作成'
      })
    )
  );
});

コメント
任意「ヘッダにチケット作成追加」など
有効
チェック
プライベート
チェックを外す

設定後、保存をクリックします。

動作を確認します。

上記設定後、以下を確認します。

ヘッダに「新しいチケットの作成」リンクが追加されていること
クリック後、チケット作成画面に遷移すること
その際、指定したプロジェクト（URLにプロジェクト識別子があること）

Redmine5.xとGmailを連携させる。

By manualmaton

オン 2025年6月19日

カテゴリー: Linux

前に書いたこちらの記事を、よりステップを追うと共に実運用に沿って記述したものです。

自室redmineサーバ上とGmailの連携。

本記事で実施すること

RedmineとGmailアカウントを紐付け、Redmineからの各種通知をメールで受け取れるようにする。

想定している読者

メール通知機能を行いたいが、SMTPサービスを用意したくない
(AWSはSMTP機能を遮断しているなど)
Redmineのconfiguration.ymlを設定していない

前提

以下が必須です。

Redmine稼働サーバのSSHアクセス権限がある
かつ管理者権限を持っている
Gmailアカウントを持っている
- ※この連携のためだけに、一つ、連携専用のアカウントを作成することを「強く、強く」推奨します。

また、Redmineのディレクトリを

/home/www-data/redmine

としていますので、自分の環境に合わせてください。

注意事項

本記事により、以下のリスクが発生します。

Gmailアプリパスワード漏洩により、用意したアカウントでメールが送信される。
その他、 Googleアカウント全体が危険にさらされる。

そのため、この作業は細心の注意を払ってください。

さっくりとした手順

Gmailの2段階認証を有効にします。
アプリパスワードを発行します。
Redmine稼働サーバでメールの設定を行います。
送信確認を行います。

Googleアカウントで設定をします。

Googleアカウント＞セキュリティに移動します。
Googleへのログインで「2段階認証プロセス」をオンにします。

どういう方法で認証をするかは運用に合わせてください。

アプリパスワードを用意します。

Googleアカウント＞セキュリティに移動します。
Googleへのログイン＞アプリパスワードに移動します。
プルダウンメニューから以下を入力し、「生成」をクリックします。
アプリを選択：メール
デバイスを選択：その他(名前を入力)
任意の名前(redmine等)を入力
生成されたパスワードを控えます。
このパスワードはGoogleアカウントへのアクセス権が付与されることに注意ください。
このパスワードはRedmineサイトのDBパスワードと同様の厳密さで運用しましょう。

メールサーバ情報を設定します。(RedmineサーバにSSH接続）

【】内は、自分の環境に合わせます。

cat <<- __EOF__ | sudo tee -a 【/home/www-data/redmine/config/configuration.yml】
production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "smtp.gmail.com"
      port: 465
      ssl: true
      authentication: :plain
      domain: "smtp.gmail.com"
      user_name: "【Gmailアドレス】"
      password: "【上述したアプリパスワード】"
__EOF__

ls -l /home/www-data/redmine/configconfiguration.yml

配置したディレクトリは自分の環境に合わせます。

設定を反映します。

sudo systemctl restart apache2.service

自分が使っているWebサービスに合わせます。

Redmineサイトに管理者アカウントでログインします。

管理＞設定に移動します。
「メール通知」がタブが有効になっているので、このタブをクリックします。

通知メールの設定を行います。

以下を設定して「保存」をクリックします。

送信元メールアドレス：自分のメールアドレス
宛先を非表示(bcc):チェックを外す
メール通知の送信対象とする操作:運用に合わせます。

通知メールの確認を行います。

Redmineの個人設定に移動します。
1.「自分自身による変更の通知は不要」のチェックを外し、保存をクリックします。
任意のチケットを発行/変更し、メールが届いていることを確認します。

以上で、設定は完了です。

トラブルシューティング：メールが届かない場合

Googleからのセキュリティ通知を確認する

新しいサーバー（VPS）からの最初のログインは、Googleによって「不審なログイン試行」と見なされ、一時的にブロックされることがあります。

その場合、Gmailアカウントの受信トレイに「セキュリティ通知」メールが届いているはずです。メールの内容に従い、「はい、心当たりがあります」などの操作を行って、アクセスを許可してください。

サーバーからGmailへの接続を確認する:

RedmineサーバーからGmailのSMTPサーバーに到達できるかを確認します。SSHで以下のコマンドを実行します。

telnet smtp.gmail.com 587

Connected to smtp.gmail.com.のように表示されれば、ネットワーク的な接続は問題ありません。（終了するには quit と入力します）

Redmine5.1.4→Redmine5.1.8へのアップデート手順。

By manualmaton

オン 2025年6月15日

カテゴリー: Linux

公開用Redmine

https://atelier.reisalin.com

のバージョンを5.1.4→5.1.8にアップデートしたときのメモです。

環境

Ubuntu 24.04
動かしていたRedmine:5.1.4
アップデートしたRedmie:5.1.8
Apache 2.4 / mod-passangerでRubyアプリを使用(Ruby 3.2系)
MySQL 8.0.3

作業に備えての前提

Webサービスを止めるため、ユーザアクセスができない状況が発生します。
利害関係者への事前周知・作業時間の確保は十分に行ってください。（慣れれば20分程度で完了しますが、1時間は取っておいた方が無難です）
また、筆者環境はfiles配下をクラウドストレージにマウントしています。手順は自身の環境に合わせてください。

さっくりとはいかない手順

(強く推奨)システム全体のバックアップ
DBのバックアップ
redmineのディレクトリを一度mvでリネームしてバックアップ。
apache停止
ディレクトリを再作成し、新しい空のRedmineを作る。
themesとpluginを再配置。filesのシンボリックリンクを貼り替える。
themesとpluginを再配置した状態でDBマイグレーション。
apache再開
バージョンアップ確認

システム全体のバックアップ（スナップショット）

AWS
仮想サーバ

などで動かしている場合は、この段階でシステム全体のバックアップ（スナップショット）を取ることを強く推奨します。

mysqlによるDBバックアップ

バックアップディレクトリに移動

cd /hoge && pwd

任意のディレクトリを指定します。

mysqldump

mysqldump -h localhost -u redmine -p --no-tablespaces --single-transaction redmine > redmine_backup.$(date +%Y%m%d).sql

DB名やDBユーザは自分の環境に合わせます。

mysqldump確認

view redmine_backup.$(date +%Y%m%d).sql

DBが平文で読めることを確認します。

データ退避

ディレクトリ移動

cd /var/lib && pwd

Redmineが格納されているディレクトリの親ディレクトリに移動します。（筆者環境は/home/www-data)

Redmine全体ディレクトリ確認

ls -ld redmine

退避対象のディレクトリがあることを確認します。ディレクトリ名は自分の環境に合わせます。

Redmine待避

sudo mv redmine redmine_$(date +%Y%m%d)

Redmine待避確認

ls -ld redmine_$(date +%Y%m%d)

ディレクトリがあることを確認します。

apache停止

念のため、apacheを停止します。

apache停止前確認

systemctl status apache2.service

active(running)を確認します。

apache停止

sudo systemctl stop apache2.service

apache停止確認

systemctl status apache2.service

inactive(dead)を確認します。

Redmineプログラムの配置

Redmineのディレクトリ作成

sudo mkdir /var/lib/redmine

Redmineディレクトリの権限変更

sudo chown -R www-data:www-data /var/lib/redmine

Redmineディレクトリの作成確認

ls -ld redmine

ディレクトリがあることと、所有者がwww-dataであることを確認します。

ソースダウンロード

sudo -u www-data svn co https://svn.redmine.org/redmine/branches/5.1-stable /var/lib/redmine

5.1系の最新安定版をダウンロードします。

退避させたディレクトリからconfigファイルコピー

database.ymlコピー

sudo -u www-data cp -pi /var/lib/redmine_$(date +%Y%m%d)/config/database.yml /var/lib/redmine/config/database.yml

database.ymlコピー確認

cat /var/lib/redmine/config/database.yml

待避したファイルの内容であることを確認します。

configuration.yml コピー

sudo -u www-data cp -pi /var/lib/redmine_$(date +%Y%m%d)/config/configuration.yml /var/lib/redmine/config/configuration.yml

configuration.ymlコピー確認

cat /var/lib/redmine/config/configuration.yml

待避したファイルの内容であることを確認します。

退避したディレクトリからデータを再配置

プラグイン一式のコピー

sudo -u www-data cp -pir  /var/lib/redmine_$(date +%Y%m%d)/plugins/* /var/lib/redmine/plugins/

移行元・移行先は自分の環境に合わせます。

テーマ一式のコピー

sudo -u www-data cp -pir /var/lib/redmine_$(date +%Y%m%d)/public/themes/* /var/lib/redmine/public/themes/

シンボリックリンク貼り替え

これは筆者の環境がlogディレクトリとfilesディレクトリを別の場所(wasabiクラウドストレージ)にリンクを張っているための措置です。
それ以外の場合は上述した /var/lib/redmine_$(date +%Y%m%d)からfilesやlogをコピーして下さい。

Redmineルートディレクトリに移動

cd /var/lib/redmine && pwd

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

filesディレクトリ削除

sudo rm -rf files

ログディレクトリ削除

sudo rm -rf log

filesディレクトリにシンボリックリンクを張る

sudo ln -sf /mnt/wasabi/redmine/files files

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

filesシンボリックリンクの所有者変更

sudo chown -h www-data:www-data files

filesシンボリックリンク確認

ls -l files

filesがシンボリックリンクになっていること
所有者がwww-dataであること

を確認します。

logディレクトリにシンボリックリンクを張る

sudo ln -sf /var/log/redmine log

logシンボリックリンクの所有者変更

sudo chown -h www-data:www-data log

logシンボリックリンク確認

ls -l log

logがシンボリックリンクになっていること
所有者がwww-dataであること

を確認します。

DBマイグレーション

Redmineルートディレクトリに移動

cd /var/lib/redmine

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

bundle インストール

sudo -u www-data bundle install --without development test --path vendor/bundle

シークレットトークン発行

sudo -u www-data bundle exec rake generate_secret_token

DBマイグレーション(本体)

sudo -u www-data RAILS_ENV=production bundle exec rake db:migrate

DBマイグレーション(プラグイン)

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

キャッシュクリア

sudo -u www-data RAILS_ENV=production bundle exec rake tmp:cache:clear

セッションクリア

sudo -u www-data RAILS_ENV=production bundle exec rake tmp:sessions:clear

apache再起動

apache再起動前確認

systemctl status apache2.service

inactive(dead)を確認します。

apache再起動

sudo systemctl start apache2.service

apache再起動確認

systemctl status apache2.service

active(running)を確認します。

動作確認

この状態でRedmineに管理者権限でログインします。手順通りなら

テーマ
添付ファイル
プラグイン
チケット一覧

などが有効に動いていて、正常に稼働します。

バージョンアップ後の作業

待避したファイルの削除/バックアップ

/var/lib/redmine_$(date +%Y%m%d)一式を削除、または任意の方法でバックアップします。

トラブルシューティング

`bundle install` が終わらない

Installing... の表示で止まっているように見えても、実際にはCPUを消費して動作していることがある（ネイティブ拡張機能のコンパイル）。topコマンドでcc1plusなどのプロセスが動いていないか確認する。

"Something went wrong" エラー

Redmineのアプリケーション起動エラー。原因はログに記録されている。

まず /var/lib/redmine/log/production.log を確認する。
上記にログがなければ、/var/log/apache2/error.log を確認する。

ログから見る主な原因の例

プラグインの非互換: Redmine本体の機能とプラグインが競合している場合がある (Overwriting existing method 警告など)。
gemのバージョン競合: Ruby本体に付属のgemと、プラグインが要求するgemのバージョンが異なると起動に失敗することがある (base64の競合など)。この場合は、Gemfileでバージョンを明示的に指定するなどの対策が必要。

Redmineにfavicon（サイトアイコン）を設定。

By manualmaton

オン 2025年6月14日

カテゴリー: Linux, PC, redmine

概要

こちらのように、サイトアイコン(favicon)をRedmineに設定するメモです。

環境

Ubuntu 24.04
Redmine 5.1
Apache 2.4
- サービス実行ユーザはデフォルトのwww-data

で実施しています。（Redmine 6.xはディレクトリ構造が異なります）

準備

ファイルfavicon.pngやfavicon.icoを用意します。
このファイルをRedmineサーバに転送します。
ファイルの所有者をRedmine実行ユーザに変更します。sudo chown www-data:www-data favicon.png など

手順

faviconファイルの配置

faviconディレクトリの作成

cd /path/to/redmine/root/directory/public/theme/theme_name && pwd

ルートディレクトリやテーマディレクトリは自分の環境に合わせます。 (筆者環境/home/www-data/redmine/public/themes/redmine_theme_kodomo)

sudo -u www-data mkdir favicon && cd favicon && pwd

faviconディレクトリにいることを確認します。

転送したファイルの配置

sudo -u cp -pi /hoge/favicon.png ./

上記、転送した際のディレクトリを指定します。

Redmineサイトの設定

Redmineのサイトに管理者権限でログインします。
管理＞設定＞表示に移動します。
3.「Gravatarのアイコンを使用する」にチェックを入れて保存します。

この後、ブラウザをリロードしてアイコンが変わっていることを確認できれば設定完了です。

2025年8月
月	火	水	木	金	土	日
				1	2	3
4	5	6	7	8	9	10
11	12	13	14	15	16	17
18	19	20	21	22	23	24
25	26	27	28	29	30	31

タグ: redmine Page 1 of 15

概要

環境

事象の確認

原因の特定

対処手順

設定ファイルのバックアップ

上限値を修正する

修正確認

設定反映&動作確認

まとめ

経緯

環境

チューニングの目的

さっくりとした手順

Passengerの設定ファイルをのバックアップ

メモリ管理ディレクティブを追記

各ディレクティブの解説

設定の反映

動作確認

概要

プラグイン名

注意

動作を確認した環境

さっくりとした手順

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

Redmine5,1に即したバージョンをダウンロードして展開します。

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

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

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

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

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

動作確認

プロジェクトの追加とキャッチ画像の追加

やりたいこと

前提

手順

画面移動

カスタマイズ作成：JavaScript

カスタマイズ作成：CSS

動作を確認します。

やりたいこと

前提

手順

画面移動

カスタマイズ作成：JavaScript

動作を確認します。

本記事で実施すること

想定している読者

前提

注意事項

さっくりとした手順

Googleアカウントで設定をします。

アプリパスワードを用意します。

メールサーバ情報を設定します。(RedmineサーバにSSH接続）

設定を反映します。

Redmineサイトに管理者アカウントでログインします。

通知メールの設定を行います。

通知メールの確認を行います。

トラブルシューティング：メールが届かない場合

Googleからのセキュリティ通知を確認する

サーバーからGmailへの接続を確認する:

環境

作業に備えての前提

さっくりとはいかない手順

システム全体のバックアップ（スナップショット）

mysqlによるDBバックアップ

データ退避

apache停止

Redmineプログラムの配置

退避させたディレクトリからconfigファイルコピー

退避したディレクトリからデータを再配置

シンボリックリンク貼り替え

DBマイグレーション

apache再起動

動作確認

バージョンアップ後の作業

トラブルシューティング

bundle install が終わらない

"Something went wrong" エラー

`bundle install` が終わらない