Confluence Data Center をアップグレードする
このページでは既存の Confluence クラスタのアップグレードについて説明します。
Confluence の既存のクラスタ化インスタンスをまだ実行していない場合は、Confluence Data Center への移行を参照してください。
このガイドでは以下の用語について説明します:
- インストール ディレクトリ - 各ノードに Confluence をインストールしたディレクトリ。
- ローカルのホームディレクトリ - 各ノードのホームディレクトリまたはデータディレクトリ(クラスタ化されていないディレクトリ。 Confluence では、単にホームディレクトリと呼ばれます) 。
- 共有ホーム ディレクトリ - クラスタ内のすべてのノードから同じパスを経由してアクセス可能なディレクトリ。
現在 Confluence Server をお使いの場合は、Confluence Data Center のメリットについてご確認ください。
On this page:
1. バックアップ
アップグレードを実行する前に、Confluence ホームディレクトリ、インストール ディレクトリ、およびデータベースのバックアップを取っておくことを強く推奨します。
バックアップを取るべき具体的なファイルとディレクトリについては、Confluence のアップグレードを参照してください。
2. Confluence のダウンロード
ご使用のオペレーティング システムに適したファイルを https://www.atlassian.com/software/confluence/download からダウンロードします。
3. クラスタの停止
アップグレードを開始する前に、クラスタ内のすべてのノードを停止する必要があります。
アップグレードがすべてのノードで完了するまでは、ロードバランサーの設定を Confluence からトラフィックをリダイレクトするようにしておくことをお勧めします。
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
ディレクトリにあります。 - その他の必要なカスタマイズを旧バージョンから新バージョンに直ちにコピーします(Confluence をデフォルトのポートで実行していない場合、または外部でユーザーを管理している場合、関連ファイルをアップデートおよびコピーする必要があります - 詳細はConfluence を手動でアップグレードするを参照してください)。
- Confluence を起動し、次のステップに進む前に、ログインできるか、ページを閲覧できるか、確認してください。
残りのノードをアップグレードする前に、Confluence を停止し、旧バージョンから新バージョンに追加カスタマイズを再適用します。
5. Synchrony のアップグレード (オプション)
Confluence で Synchrony を管理している場合 (推奨)、操作は不要です。Synchrony は Confluence によって自動的にアップグレードされます。
独自の Synchrony クラスタを実行している場合は、次の操作を行う必要があります。
- アップグレードした Confluence ノードの
<local-home>
ディレクトリで、新しいsynchrony-standalone.jar
を確認します。 - 新しい
synchrony-standalone.jar
をそれぞれの Synchrony ノードにコピーして通常どおり Synchrony を起動します。
6.Confluence を残りのノードにコピーする
次は、アップグレードした Confluence ディレクトリをクラスタ内の他のノードに複製します。
- Confluence を 1 つ目のノードで停止します。
- 1 つ目のノードから次のノードに、インストール ディレクトリとローカル ホーム ディレクトリをコピーします。
ローカルのホーム ディレクトリへのパスが別のノードにある場合、confluence-init.properties
を編集して適切な場所を指すようにします。 - Confluence を起動し、このノードでログインできるか、ページを閲覧できるかを確認してください。
- 次のノードに進む前に、このノードで Confluence を停止します。
残りの各ノードに対し、同様のプロセスを繰り返します。
7.Confluence を起動し、クラスタ接続を確認する
一旦すべてのノードをアップグレードし終わったら、各ノードで Confluence Data Center を 1 つずつ起動してください(複数のノードで同時に起動すると、深刻な障害を引き起こすおそれがあります)。
クラスタ監視コンソール ( > [一般設定] > [クラスタリング]) では、アクティブなクラスタ ノードについての情報を参照できます。クラスタが正しく実行されている場合、各ノードの詳細を見ることができます。