Confluence Data Center をアップグレードする

始める前に

• Check your Confluence licence is valid.
  To check go to  > General Configuration > Atlassian Support Tools > Health Check and make sure the license support period has not expired. If your support period has expired renew your licence and reapply it before proceeding with the upgrade.

• アップグレードするバージョンおよびスキップするバージョンについて、リリースノートとアップグレードノートを確認してください。

• Java のバージョン、アプリケーション サーバー、OS、データベース、ブラウザがサポート対象であるか確認してください。
  サポート対象のプラットフォームおよびConfluence サポート期間終了のお知らせで、最新の要件を確認してください。

• ご利用のデータベースにつき、最新のデータベース セットアップガイドで、データベースの設定が正しいか、確認してください。新しい設定要件が追加されている可能性があります。データベース設定を確認してください。

• Check the compatibility of any add-ons.
  Some add-ons may not yet be compatible with the latest version of Confluence. See Checking app compatibility with application updates to find out how to check this in the Universal Plugin Manager.

• インスタンスに影響するおそれのある既知の問題を確認してください。
  アップグレードするバージョンについて、既知の問題をConfluence ナレッジベースで確認します。また、サポート対象の外部データベースに関連する既知の問題についても、データベースのトラブルシューティングで確認してください。

• Make a note of any modifications to your Confluence instance (for example layouts or a custom theme).
  Any customisation you wish to maintain will need to be reapplied after upgrading. See Additional steps where customisations are present.

ステップ 1 バックアップ

アップグレードを実行する前に、Confluence ホームディレクトリ、インストール ディレクトリ、およびデータベースのバックアップを取っておくことを強く推奨します。

バックアップを取るべき具体的なファイルとディレクトリについては、Confluence のアップグレードを参照してください。

ステップ 2 クラスタを停止する

アップグレードを開始する前に、クラスタ内のすべてのノードを停止する必要があります。 

アップグレードがすべてのノードで完了するまでは、ロードバランサーの設定を Confluence からトラフィックをリダイレクトするようにしておくことをお勧めします。

ステップ 3 共有ホームディレクトリを作成する

 If you are upgrading an existing Confluence Data Center instance (Confluence 5.6 or later), you can skip this step, as you already have a Shared Home directory.

共有ホーム ディレクトリをセットアップするには：

1. クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリを作成します。これが共有ホームディレクトリになります。 

2. Edit confluence.cfg.xml in the home directory on the first node and add a new property called confluence.cluster.home with the path of the shared home directory as the value. Example:

   <property name="confluence.cluster.home">/mnt/confluence-shared-home</property>

3. 以下を除いて、1 つ目のノードのローカル ホーム ディレクトリからすべてのファイルとディレクトリを新しい共有ホームディレクトリに移動します： 

   • config
   • confluence.cfg.xml
   • index
   • temp
   • bundled-plugins
   • plugin-cache-*
   • plugins-cache
   • plugins-osgi-cache
   • plugins-temp

    その他のすべてのノードでは、ローカル ホーム ディレクトリから移動したファイルとディレクトリを削除します。

ステップ 4 1 つ目のノードをアップグレードする

1 つ目のノードをアップグレードするには：

1. ディレクトリ（新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります）にファイルを抽出（解凍）する
2. <Installation-Directory>\confluence\WEB-INF\classes\confluence-init.properties  ファイルで次の行を更新し、対象のノードの既存のローカル ホーム ディレクトリを指すようにします。
3. 既存の Confluence インストール ディレクトリから新しいインストール ディレクトリの confluence/WEB-INF/lib に、jdbc ドライバの jar ファイルをコピーします。
   jdbc ドライバは <Install-Directory>/common/lib または <Installation-Directory>/confluence/WEB-INF/lib ディレクトリにあります。 
4. その他の必要なカスタマイズを旧バージョンから新バージョンに直ちにコピーします（Confluence をデフォルトのポートで実行していない場合、または外部でユーザーを管理している場合、関連ファイルをアップデートおよびコピーする必要があります - 詳細はConfluence を手動でアップグレードするを参照してください）。
5. Confluence を起動し、次のステップに進む前に、ログインできるか、ページを閲覧できるか、確認してください。

残りのノードをアップグレードする前に、この時点で旧バージョンから新バージョンへ追加のカスタマイズも再適用してください。

ステップ 5 残りのノードをアップグレードする

クラスタ内で次のノードをアップグレードするには：

1. Confluence を 1 つ目のノードで停止します。
2. Copy the installation directory and home directory from the first node to the next node. 
   If the path to the local home directory is different on this node, edit the confluence-init.properties to point to the correct location. 
3. Confluence を起動し、次のノードのアップグレードに進む前に、ログインできるか、ページを閲覧できるか、確認してください。

残りの各ノードに対し、同様のプロセスを繰り返します。 

ステップ 6 Confluence を起動し、クラスタ接続を確認する 

一旦すべてのノードをアップグレードし終わったら、1 つずつ各ノードで Confluence データセンターを起動してください。 

The Cluster Administration page ( > General Configuration > Cluster Configuration) includes information about the active cluster. When the cluster is running properly, this page displays:

1. a correct count of the nodes in the cluster
2. a status display for each node in the cluster
3. uptime for each node.