Redmineアップグレード¶

稼働中のRedmine3.xまたは4.xをアップグレードする。

公式資料は下記。これを参考にする。
http://guide.redmine.jp/RedmineUpgrade/

想定¶

かなり更新間隔があいた状態を想定し、コンテンツは上書きせずファイル移行を行う。
redmineは「/usr/local/redmine」で稼働中とする。異なる場合は適宜読み替える。
WebServerはhttpdとする
svn、gemを利用できるものとする
gcc等コンパイルを行える環境とする
プラグインは失敗の原因になりやすいので、可能であれば削除しておく

バックアップ¶

新データを上書きせず旧データをそのまま残すので、Webサーバを落として
コンテンツをリネームする。

Webサーバをダウン
```
# systemctl stop httpd
```

旧コンテンツをリネーム

# mv /usr/local/redmine /usr/local/redmine_old

データベースをバックアップする。

MySQLのバックアップ

# mysqldump -u root -p redmine > /var/tmp/redmine_dump.sql

新環境の構築¶

Rubyを更新する

# wget https://cache.ruby-lang.org/pub/ruby/2.5/ruby-2.5.1.tar.gz
# tar xzf ruby-2.5.1.tar.gz 
# ./configure --disable-install-doc
# make
# make install
# ruby -v

上記でインストールしたバージョンが表示されること

SVNから最新の安定版をチェックアウトして配置する

# svn checkout http://svn.redmine.org/redmine/branches/3.4-stable redmine
# mv redmine /usr/local/redmine
# cd /usr/local/redmine

旧環境から移行する必要があるファイルをコピーする

# cp -p /usr/local/redmine_old/config/configuration.yml /usr/local/redmine/config/
# cp -p /usr/local/redmine_old/config/database.yml /usr/local/redmine/config/
# cp -Rp /usr/local/redmine_old/files /usr/local/redmine/

bundlerを更新する

# gem update bundler
# bundle install --without development test
# bundle exec rake generate_secret_token
# bundle update

bundler環境のマイグレートを実行する

# bundle exec rake db:migrate RAILS_ENV=production
# bundle exec rake redmine:plugins:migrate RAILS_ENV=production
# bundle exec rake tmp:cache:clear RAILS_ENV=production

マイグレートが失敗する場合
古いバージョンからの移行で「/usr/local/redmine/config/master.key」が無い？

# EDITOR=vi rails credentials:edit
--------------------
表示される『secret_key_base』と文字列をコピーする
保存してconfig/master.keyが作成されることを確認する

表示された『secret_key_base』を以下に追加する

# vi /usr/local/redmine/config/configuration.yml
--------------------
production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "localhost" 
      port: 25
      domain: "example.com" 

  rmagick_font_path: /usr/share/fonts/ipa-pgothic/ipagp.ttf
  secret_key_base: キー文字列

再度マイグレートを実行する

Passengerを更新する
6.x系はメモリリークが起きてうまく動作しなかったので5.x系の最新を指定する
```
# gem uninstall passenger
  一度古いpassengerをアンインストールする

# gem query -ra -n  "^passenger$" 
　利用可能なバージョンを調べる
# gem install passenger -N -v=5.3.7
　5.xの最新のバージョンを指定する

# passenger-install-apache2-module
PassengerのApache用モジュールをインストールする
```
- 注意
  メモリを比較的多く使うので、メモリ不足で失敗していないか注意する。
```
…
…
virtual memory exhausted: メモリを確保できません
rake aborted!
```
  と表示された場合メモリ確保に失敗しているので、メモリを増やすか稼働中の
  デーモンなどを一時的に終了して空きメモリを増やし再度インストールを試みる。

コンパイル成功時に下記のような出力があるのでコピーする。
バージョンは適宜異なるので、本記載ではなく出力結果をコピーすること。

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /usr/local/lib/ruby/gems/2.5.0/gems/passenger-4.0.60/buildout/apache2/mod_passenger.so
   <IfModule mod_passenger.c>
     PassengerRoot /usr/local/lib/ruby/gems/2.5.0/gems/passenger-4.0.60
     PassengerDefaultRuby /usr/local/bin/ruby
   </IfModule>

コンパイル結果をもとに、Apacheの設定ファイルを書き換える

# vi /etc/httpd/conf.d/redmine.conf
-----------------------------
RackBaseURI /redmine

<Directory "/usr/local/redmine/public">
  #Require all granted
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>

#### ここから、コンパイル結果を上書きする
   LoadModule passenger_module /usr/local/lib/ruby/gems/2.5.0/gems/passenger-4.0.60/buildout/apache2/mod_passenger.so
   <IfModule mod_passenger.c>
     PassengerRoot /usr/local/lib/ruby/gems/2.5.0/gems/passenger-4.0.60
     PassengerDefaultRuby /usr/local/bin/ruby
   </IfModule>
#### ここまで

Header always unset "X-Powered-By" 
Header always unset "X-Runtime" 

PassengerMaxPoolSize 20
PassengerMaxInstancesPerApp 4
PassengerPoolIdleTime 864000
PassengerHighPerformance on
PassengerStatThrottleRate 10
PassengerSpawnMethod smart
PassengerFriendlyErrorPages off

RackBaseURI /redmine

公開ディレクトリにあるシンボリックリンクを張り替える
```
# ln -s /usr/local/redmine/public /var/www/redmine
```

所有者権限を変更する

# chown -R apache.apache /usr/local/redmine

Webサーバを起動する
```
# systemctl start httpd 
```

passengerの動作を確認する

# passenger-status

Version : 4.0.60
Date    : 2018-04-23 12:49:25 +0900
Instance: 1372
----------- General information -----------
Max pool size : 20
Processes     : 0
Requests in top-level queue : 0

----------- Application groups -----------

何もインスタンスが起動していない状態が確認できること。

ブラウザでRedmineにアクセスする。
動作に問題がなければデータベースのダンプや旧ファイルは削除していい
メニューや検索フィールドの表示が崩れた場合、Shift+F5などでキャッシュを
破棄するフルリロードを行えば正しく表示される。

以上¶

ファイル (0)

プロジェクト

全般

プロフィール

ナレッジベース

Wiki

Redmineアップグレード¶

想定¶

バックアップ¶

新環境の構築¶

以上¶