はじめに
この記事では、CentOSで運用しているRedmine(Bitnami利用)を3.1.2から3.3.2へバージョンアップする手順をざっくりまとめています。
以下が前提です
- CentOS Linux release 7.3.1611 (Core)
- Bitnami Redmine 3.1.2-0から3.3.2-2へバージョンアップ
- 別サバは立ち上げない
- 中の人はLinux初心者
バージョンアップ方法の調査
Bitnamiの説明では新しいサーバを立ち上げてデータを移行するとある。
https://docs.bitnami.com/installer/apps/redmine/\#how-to-upgrade-redmine
その他のことは特に書かれていないので、実際にやってみました。
実際のバージョンアップ手順
3.1.2-0がインストールされている状態で3.3.2-2をインストールします。
下準備
-
現行DBのダンプ取得
- /hogehoge/redmine-3.1.2-0/use_redmine
- cd /opt/redmine-3.1.2-0/mysql/bin
- mysqldump --default-character-set=utf8 -u bitnami -pXXXXXXXXXX bitnami_redmine > /hogehoge/redmine_db_vup.dump
-
現行サービス停止
- MySQL
- apache
※停止しておかないと新バージョンの使用ポート81で設定しようとする
-
新しいインストーラ(3.3.2-2)に必要なライブラリを導入
- sudo yum install -y perl-Data-Dumper
※私の環境ではこれがないとインストーラがこけました
- sudo yum install -y perl-Data-Dumper
Bitnami Redmine 3.3.2-2のインストール
- インストーラに実行権限付与
- chmod +x /hogehoge/bitnami-redmine-3.3.2-2-linux-x64-installer.run
- インストーラの実行
- sudo /hogehoge/bitnami-redmine-3.3.2-2-linux-x64-installer.run
- 言語選択ダイアログが表示される
- Japaneaseを選択してOK
- 次へ
- コンポーネントの選択
- SubversionやGitは入れておかないと後々面倒
- インストールフォルダ選択
- 任意の設定にし次へ
- 管理者アカウントの作成
- 現行サーバと同様のアカウントを作成
- データベースに保管する際の規定の言語
- 日本語を選択し次へ
- SMTP設定
- 任意の設定にし次へ
- Bitnami Cloud Hosting
- 特には必要ないのでチェック外して次へ
- インストールする準備ができました
- 次へ
- 接続確認
外部からhttp://hoge/redmine にアクセス
データの移行
- apache停止
- DBを一旦削除
- /hogehoge/redmine-3.3.2-2/use_redmine
- mysql -u root -p
- Password: xxxxxxxxxx
※パスワードはdatabase.ymlで確認 - mysql> drop database bitnami_redmine;
- mysql> create database bitnami_redmine;
- mysql> grant all privileges on bitnami_redmine.* to 'bn_redmine'@'localhost' identified by 'xxxxxxxxxx';
※ここで任意の新しいパスワードを設定することもできる - mysql> exit;
- DBのインポート
- mysql -u root -pxxxxxxxxxx bitnami_redmine < /hogehoge/redmine_db_vup.dump
- DBのマイグレーション
- cd /hogehoge/redmine-3.3.2-2/apps/redmine/htdocs
- ruby bin/rake db:migrate RAILS_ENV=production
- 各種ファイルの配置
- テーマ
以下に配置- /hogehoge/redmine-3.3.2-2/apps/redmine/htdocs/public/themes
- 添付ファイル
以下に配置- /hogehoge/redmine-3.3.2-2/apps/redmine/htdocs/files
- 添付ファイルフォルダの権限設定
- chown -hR daemon:daemon /hogehoge/redmine-3.3.2-2/apps/redmine/htdocs/files
- chmod -R 775 /hogehoge/redmine-3.3.2-2/apps/redmine/htdocs/files
- テーマ
プラグインの移行
- 旧環境のプラグインを以下へコピー
- /hogehoge/redmine-3.3.2-2/apps/redmine/htdocs/plugins
- マイグレーション
- /hogehoge/redmine-3.3.2-2/use_redmine
- cd /hogehoge/redmine-3.3.2-2/apps/redmine/htdocs
- 必要ならばプロキシの設定
- export http_proxy=http://xxx.xxx.xxx.xxx:xxxx/
- export https_proxy=http://xxx.xxx.xxx.xxx:xxxx/
- bundle config build.nokogiri --use-system-libraries
※私の環境ではnokogoriのビルドにシステムのライブラリを使うための指定が必要でした - bundle install
- bundle exec rake redmine:plugins:migrate RAILS_ENV=production
- apache再起動
動作検証
バージョンアップに伴い外観が変わってしまったり、動作しなくなったプラグインなどを修正。
所感
- データの移行自体は簡単です
- バージョンアップに伴うプラグインの修正に一番時間が掛かりました