Easy Redmine へのアップグレード

このガイドは、Redmine をインストールしていて、Easy Redmine にアップグレードしたい方に適用されます。また、既存の Easy Redmine にアップデートをインストールする場合も同じ手順で行います。このガイドでは、Redmine をアップグレードするために、Redmine インストーラー gemを使用する方法を説明します。

0) 始める前に

ここに記載されているように、適切なハードウェアとソフトウェアのサーバー構成を確認してください。以下の条件を満たす必要があります：

Web サーバーは、public, files, log, tmp フォルダーへのフルアクセスを持つ必要があります => Redmine インストーラーを root では走らせないでください！
Webrick Web サーバーはサポートしていません
Easy Redmine プラグインは [redmine_root]/plugins/easyproject/easy_plugins に入ります
更新手順には、テキスト形式の移行が含まれます。 TextileまたはMarkdownテキストを編集（Redmineの標準でEasy Redmineバージョン10まで利用可能）を使用すると、テキストはCKEditor 5でサポートされているHTMLに変換されます。一部の機能（「toc」など）が削除されます。
インストールは CRON を自動的に設定しません - 手動で行う必要があります
Redmine のインストーラーを正しく動作させるために、ルートディスクに 250 MB 以上の空き容量が必要です
少なくともインストール時には、サーバーがインターネットに接続されている必要があります
Redmineはサードパーティのプラグインや修正を含むことができません。インストール説明の 2.1 を参照
既存の Easy Redmine をアップデートする前に、現在のインストールとアップデートパッケージ内のプラグインフォルダ（/plugins と /plugins/easyproject/easy_plugins）の内容を確認してください。アップデートパッケージに、現在インストールされているプラグインが含まれていない場合は、サポートに連絡して原因を調べ、正しいパッケージを入手してください。または、システムから過剰なプラグインをアンインストールしてください

また、詳細なインストールマニュアルがパッケージ内の doc/INSTALL に直接用意されています。

1) Redmine インストーラー Ruby Gem

まず、Redmine のインストーラーである Ruby Gem をインストールします。gem をインストールするには：

$ gem install redmine-installer

（または gem update redmine-installer で既存の gem を最新版に更新します）

Ruby に installer gem がインストール／アップデートされると、アップグレードを開始することができます。

インストーラーのダウンロードをリクエスト

2) 既存の Redmine インスタンスのアップグレード

Redmine インストーラーは、既存の Redmine をアーカイブや git リポジトリからアップグレードします。インストールされているプラグインは、新しいパッケージに含まれていればそのまま維持、またはアップグレードされます。

アップグレードの手順をプロファイルとして保存し、次回のアップグレードに役立てることができます。プロファイルは HOME_FOLDER/.redmine-installer-profiles.yml に保存されます。

アップグレードのコマンド：

redmine upgrade [PATH_TO_PACKAGE] [REDMINE_ROOT]

アップグレードウィザードでは、以下の手順を行います：

1) Redmine Root - Redmine がインストールされる場所を指定（コマンドに含まれていない場合）
2) Loading package - パッケージを一時フォルダに読み込む
3) 現在の Redmine の検証
4) Backup - フル / 設定+データベース / データベースのみ
5) Upgrading - アップグレードコマンドの実行
6) Moving Redmine - 現在の Redmine が新しいファイルでアップグレードされる
7) Profile saving - 今後のためにアップグレードの手順が保存される

Redmine アップグレードのコマンド - アーカイブから

redmine upgrade [PATH_TO_PACKAGE] [REDMINE_ROOT]

例：

redmine upgrade easyredmine_2016_stable_u11271_v2018_1_2__platform_04_00.zip /home/easy/current

Redmine アップグレードのコマンド - プロファイルから

redmine upgrade [PACKAGE] [REDMINE_ROOT] --profile PROFILE_ID

カスタム修正のアップグレード

easyproject プラグインを使用していて、古いインスタンスからクライアントの修正をコピーしたくない場合は、スイッチを使います

--skip-old-modifications

GEM ドキュメントに完全な情報があります