Redmine/トラブルの履歴(No.24)

目次†

表示†

チケット表示時にエラー発生†

症状：チケット表示時にHTTPエラー500が発生する。（プレビュー時も同様）

I, [2017-03-19T19:46:23.258443 #12441]  INFO -- : Completed 500 Internal Server Error in 29ms (ActiveRecord: 3.5ms)
F, [2017-03-19T19:46:23.260961 #12441] FATAL -- : ActionView::Template::Error (invalid byte sequence in UTF-8):
   1: <% if @notes %>
   2:   <fieldset class="preview"><legend><%= l(:field_notes) %></legend>
   3:     <%= textilizable @notes, :attachments => @attachments, :object => @issue %>
   4:   </fieldset>
   5: <% end %>
   6: 
 lib/redmine/wiki_formatting/markdown/formatter.rb:62:in `gsub!'
 lib/redmine/wiki_formatting/markdown/formatter.rb:62:in `to_html'

原因：データベースにutf-8以外の不正な文字が入っている為。
対処（一時的）：上記のスタックトレースにデータのID番号が記載されているので、MySQLのコマンドで削除すれば良い。
```
"last_journal_id"=>"4983"
mysql> update journals set notes="" where id=4983;
```
参考：デフォルトの"utf8"では絵文字を入力出来ない為、データベースを"utf8mb4"に変換する必要がある。変換方法はRedmine/システム管理を参照。

↑

Redmine 4.0 - ActionView::Template::Error†

症状：下記のエラーが発生して設定画面を開けない。(2019/09/16)
```
ActionView::Template::Error (undefined method `close_duplicate_issues'
```
原因：古いバージョンの設定ファイルを流用している為。(Defect #30234: Redmine 4.0 - ActionView::Template::Error - Redmine)
```
it looks like config/settings.yml is from the old version, did you follow http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade ?
```
対処：新しいバージョンのRedmineに入っている設定ファイルを使う。

↑

起動†

↑

Nginx更新時に起動しない†

症状：NginxをHomebrewで更新した際に起動しない。(2019/09/16)
環境：macOS(Monterey, Homebrew)
原因：Passengerとの整合が取れていない為
対処：Passengerも併せて更新（再インストール）する。
参考：Nginx起動時にネットワークアクセスの許可を確認するダイアログが表示されるのが正解。表示されない場合は問題有りの可能性が高い。

↑

起動しない（プラグイン）†

症状：起動しない。直ぐに落ちてしまう。ログにも出ない。(2021/04/05)
原因：プラグインの互換性がない為
対処：まずは全てのプラグインを外して起動するか確認する。起動するなら、いずれかのプラグインの問題である可能性が高い。
参考：特に古い環境のバックアップをプラグインと共にインポートした際に起こりやすい。

↑

起動しない（gem）†

症状：起動しない。直ぐに落ちてしまう。ログには下記が出力されていた。(2022/01/22)

App 7044 output: Error: The application encountered the following error: superclass mismatch for class StringIO (TypeError)

環境：macOS(Monterey, Homebrew)
原因：不整合なバージョンのgemが含まれている為

対処：不要なgemをアンインストールした。

$ gem uninstall stringio
Gem stringio-0.1.0 cannot be uninstalled because it is a default gem
Successfully uninstalled stringio-3.0.1

結果：正常に起動することを確認した。
参考：Gem update後にRedmineが起動不可となったのでその対策 – UbuntuによるEco Linuxサーバ構築記

↑

バージョンアップ†

↑

マイグレーション時にsecret_tokenのエラー発生†

症状：下記のエラーが発生する。(2019/09/16)

Missing `secret_token` and `secret_key_base` for 'development' environment, set these values in `config/secrets.yml`

原因：Rails4.1からの変更の為
対処："config/secrets.yml" を作成して "secret_token" を記載する。
参考：
- 【Mac】開発環境にRedmineをインストールして動かす - Qiita
- production環境でsecret_tokenをセットする(rails) - Qiita

↑

移行スクリプトにてSQLエラー発生†

前提：MySQL/8.0

症状：移行スクリプト（自前）にてMySQLのユーザを作成する際にエラー発生。(2021/04/05)

ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'identified by 'password'' at line 1

原因：以前のバージョンでは問題無かったが、MySQL/8.0ではユーザ作成と権限設定を別々に行う必要がある為。

対処：SQLを下記に変更した。（ユーザ作成と権限設定を分割）

mysql> create user 'user'@'localhost' identified by 'password';
mysql> grant all privileges on db.* to 'user'@'localhost';

参考：bitnami Redmine 4.2.0移行時に発生した。（Redmine v4.2.0）

↑

マイグレーション時に実施済のエラー発生†

症状：マイグレーション実施済のエラーが発生する。(2021/04/11)
原因：プラグインフォルダに名前の異なる同じプラグインが入っている為
対処：同一プラグインを外す。（バックアップのインポート処理を行うスクリプトを修正する）

↑

v5.0.2へ更新後、起動しない（gem）†

症状：起動しない。Nginxのログには下記が出力されていた。(2022/08/15)

The application encountered the following error: You have already activated strscan 1.0.3, but your Gemfile requires strscan 3.0.4. Since strscan is a default gem, you can either remove your dependency on it or try updating to a newer version of bundler that supports strscan as a default gem. (Gem::LoadError)

環境：macOS(Monterey, Homebrew)
原因：必要なバージョンのgemがインストールされていない為。
対処：必要なバージョンのgemをインストールした。
```
$ gem install strscan -v "3.0.4"
```
結果：正常に起動することを確認した。

↑

MySQL v8.3.0に更新後、起動しない†

症状：起動しない。Nginxのログには下記が出力されていた。(2024/02/12)

 Reason: tried: '/opt/homebrew/opt/mysql/lib/libmysqlclient.22.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OS/opt/homebrew/opt/mysql/lib/libmysqlclient.22.dylib' (no such file), '/opt/homebrew/opt/mysql/lib/libmysqlclient.22.dylib' (no such file), '/opt/homebrew/Cellar/mysql/8.3.0/lib/libmysqlclient.22.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OS/opt/homebrew/Cellar/mysql/8.3.0/lib/libmysqlclient.22.dylib' (no such file), '/opt/homebrew/Cellar/mysql/8.3.0/lib/libmysqlclient.22.dylib' (no such file) - /Library/WebServer/share/redmine-5.1.1/vendor/bundle/ruby/3.1.0/gems/mysql2-0.5.5/lib/mysql2/mysql2.bundle (LoadError)

環境：macOS(Sonoma, Homebrew)
原因：既存のmysql2 (v0.5.5) がMySQL v8.3.0に対応していない為。
対処：MySQL v8.3.0に対応したmysql2 v0.5.6をインストールした。
```
Successfully installed mysql2-0.5.6
```
結果：正常に起動することを確認した。(2024/02/13)

↑

v5.1.3へ更新後、起動しない（gem）†

症状：起動しない。Nginxのログには下記が出力されていた。(2024/06/27)

[ E 2024-06-27 09:20:43.4719 84845/Ts age/Cor/App/Implementation.cpp:221 ]: Could not spawn process for application /Library/WebServer/share/redmine-5.1.3: The application encountered the following error: You have already activated strscan 3.0.6, but your Gemfile requires strscan 3.1.0. Prepending `bundle exec` to your command may solve this. (Gem::LoadError)

環境：macOS(Sonoma, Homebrew)
原因：必要なバージョンのgemがインストールされていない為。
対処：必要なバージョンのgemをインストールした。
```
$ gem install strscan -v "3.1.0"
```
結果：正常に起動することを確認した。

↑

v6.1.1への更新時のgemインストールに失敗する†

症状：bundle installにて下記のエラーが発生する。

Could not find compatible versions
Because commonmarker >= 2.0.2, < 2.6.0 depends on RubyGems ~> 3.4
 and Gemfile depends on commonmarker ~> 2.3.1,
 RubyGems ~> 3.4 is required.
So, because current RubyGems version is = 4.0.2,
  version solving has failed.

環境：macOS(Tahoe, Homebrew)
原因：commonmarkerのバージョンが不一致な為。Redmine 6.1.1リリース後にRuby/4.0がリリースされた点が原因らしい。
対処：Ruby/4.0に対応したバージョンへ変更した。
```
gem 'commonmarker', '~> 2.6.1'
```
- https://github.com/gjtorikian/commonmarker/releases/tag/v2.6.1
結果：正常に起動することを確認した。

↑

バックアップ †

↑

データベースのダンプ時にエラー発生†

環境：MySQL/5.7

症状：下記のエラーが発生する。(2020/09/13)

mysqldump: Error: 'Access denied; you need (at least one of) the PROCESS privilege(s) for this operation' when trying to dump tablespaces

原因：MySQLのバージョンアップにより、権限が必要になった為

対処：必要な権限を付与する。

GRANT PROCESS ON *.* TO "backup-user"@localhost;

参考：mysqldumpでPROCESS権限(PROCESS privilege)を要求される - いっさいがっさい

↑

データベースのインポート時にエラー発生†

環境：MySQL/9.6.0
症状：バックアップ（ダンプ）のインポートに失敗する (2026/01/25)
原因：GTIDの不整合が発生している為
対処：データベースのダンプ時に下記のオプションを追加した。
```
--set-gtid-purged=OFF
```

参考：

MySQL8.0のGTIDを確認してみた

IDとは
- Global Transaction Identifierの略
- 発生元のサーバー (ソース) でコミットされた各トランザクションに作成および関連付けられる一意の識別子

【MySQL】mysqldumpsしたファイルをリストアすると「@@GLOBAL.GTID_MODE = ON」エラーになる - 零細システムエンジニアの備忘録

GTIDで調べるとレプリケーション環境の時に使用されるらしく今回単体サーバになるので、解決方法を探したらmysqldump時に下記オプションを追加してあげればいいとのこと

↑

インストール†

↑

Windows11にてv5.0.3のインストール失敗†

対象： https://github.com/bitnami/vms/issues/644#issuecomment-1408242646

This is the last Bitnami Redmine installer for Windows we published
https://downloads.bitnami.com/files/stacks/redmine/5.0.3-0/bitnami-redmine-5.0.3-0-windows-x64-installer.exe

症状：Windows11ではgemのインストールに失敗した。（インストールは最後まで完了したように見えるが、途中でアラートが表示され、実は成功していない）
原因：不明（同梱のRuby 2.6が古い為と予想）
- 参考：Ruby 2.6.10 Released
```
After this release, Ruby 2.6 reaches EOL. 
```
対処：Ruby 3.1へ入れ替えて、Gemfile.lockを削除した後（Ruby 2.6の記載が残っている為）、gemを再インストールしたところ、今度は成功した。ただし、mysql2のインストールは下記を参照。（2023/10/05）
- Windows10にRedmineをインストールした - Qiita
```
/usr/local/mysql-connector-c++-8.0.30-win32 に展開しておき、これを --with-mysql-dir= で指定して、Ruby をインストールしたディレクトリに移動し、mysql2 をインストールする。
gem install mysql2 -- --with-mysql-dir="/usr/local/mysql-connector-c++-8.0.30-win32"
```
- なお、64bit版ではエラーが発生する為、libフォルダへシンボリックリンクを作っておくと問題を回避出来る。
```
mklink /d lib64 lib
```
- bundle installでオプションを指定するには、configオプションを利用すれば良い。
```
bundle config build.mysql2 --with-mysql-dir="/usr/local/mysql-connector-c++-8.0.30-win32"
```
- 参考：bundlerでもオプションを指定したい - tumblr
```
bundlerを使う時は以下のように行う
bundle config build.charlock_holmes --with-icu-dir=/path/to/installed/icu4c
```
参考： Bundler