Confluence Data Center をアップグレードする
このページでは既存の Confluence クラスタのアップグレードについて説明します。
Confluence の既存のクラスタ化インスタンスをまだ実行していない場合は、Confluence Data Center への移行を参照してください。
このガイドでは以下の用語について説明します：
- インストール ディレクトリ - 各ノードに Confluence をインストールしたディレクトリ。
- ローカルのホームディレクトリ - 各ノードのホームディレクトリまたはデータディレクトリ（クラスタ化されていないディレクトリ。 Confluence では、単にホームディレクトリと呼ばれます） 。
- 共有ホームディレクトリ - クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリ。Confluence 5.4 またはそれ以前バージョンからのアップグレードの場合は、アップグレードの一環としてこのディレクトリを作成します。
On this page:
ステップ 1 バックアップ
アップグレードを実行する前に、Confluence ホームディレクトリ、インストール ディレクトリ、およびデータベースのバックアップを取っておくことを強く推奨します。
バックアップを取るべき具体的なファイルとディレクトリについては、Confluence のアップグレードを参照してください。
ステップ 2 クラスタを停止する
アップグレードを開始する前に、クラスタ内のすべてのノードを停止する必要があります。
アップグレードがすべてのノードで完了するまでは、ロードバランサーの設定を Confluence からトラフィックをリダイレクトするようにしておくことをお勧めします。
ステップ 3 共有ホームディレクトリを作成する
既存の Confluence Data Centerインスタンス（Confluence 5.6 以降）をアップグレードする場合は、すでに共有ホームディレクトリが存在しているため、このステップはスキップし てください。
共有ホーム ディレクトリをセットアップするには：
- クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリを作成します。これが共有ホームディレクトリになります。
Edit
confluence.cfg.xmlin the home directory on the first node and add a new property calledconfluence.cluster.homewith the path of the shared home directory as the value. Example:<property name="confluence.cluster.home">/mnt/confluence-shared-home</property>以下を除いて、1 つ目のノードのローカル ホーム ディレクトリからすべてのファイルとディレクトリを新しい共有ホームディレクトリに移動します：
- config
- confluence.cfg.xml
- index
- temp
- bundled-plugins
- plugin-cache-*
- plugins-cache
- plugins-osgi-cache
- plugins-temp
その他のすべてのノードでは、ローカル ホーム ディレクトリから移動したファイルとディレクトリを削除します。
ステップ 4 1 つ目のノードをアップグレードする
1 つ目のノードをアップグレードするには：
- ディレクトリ（新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります）にファイルを抽出（解凍）する
<Installation-Directory>\confluence\WEB-INF\classes\confluence-init.propertiesファイルで次の行を更新し、対象のノードの既存のローカル ホーム ディレクトリを指すようにします。- 既存の Confluence インストール ディレクトリから新しいインストール ディレクトリの
confluence/WEB-INF/libに、jdbc ドライバの jar ファイルをコピーします。
jdbc ドライバは<Install-Directory>/common/libまたは<Installation-Directory>/confluence/WEB-INF/libディレクトリにあります。 - Copy any other immediately required customisations from the old version to the new one (for example if you are not running Confluence on the default ports or if you manage users externally, you'll need to update / copy the relevant files - find out more in Upgrading Confluence Manually)
- Confluence を起動し、次のステップに進む前に、ログインできるか、ページを閲覧できるか、確認してください。
残りのノードをアップグレードする前に、この時点で旧バージョンから新バージョンへ追加のカスタマイズも再適用してください。
ステップ 5 残りのノードをアップグレードする
クラスタ内で次のノードをアップグレードするには：
- Confluence を 1 つ目のノードで停止します。
- 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 theconfluence-init.propertiesto point to the correct location. - 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.