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

目次†

表示†

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

症状：チケット表示時に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サーバ構築記

↑

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"
```
結果：正常に起動することを確認した。

↑

バージョンアップ†

↑

マイグレーション時に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)
原因：プラグインフォルダに名前の異なる同じプラグインが入っている為
対処：同一プラグインを外す。（バックアップのインポート処理を行うスクリプトを修正する）

↑

バックアップ †

↑

MySQLのバックアップにてエラー発生†

前提：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)を要求される - いっさいがっさい

↑

インストール†

↑

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