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

ステップ 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 を起動し、クラスタ接続を確認する 

一旦すべてのノードをアップグレードし終わったら、各ノードで Confluence Data Center を 1 つずつ起動してください（複数のノードで同時に起動すると、深刻な障害のを引き起こすおそれがあります）。

The Cluster monitoring console ( > General Configuration > Clustering) includes information about the active cluster nodes. When the cluster is running properly, you should be able to see the details of each node.