Confluence Data Center への移行

• インストール ディレクトリ - Confluence をインストールしたディレクトリ。
• ローカルのホームディレクトリ - 各ノードのホームディレクトリまたはデータディレクトリ（クラスタ化されていないディレクトリ。 Confluence では、単にホームディレクトリと呼ばれます） 。
• 共有ホームディレクトリ - 作成したディレクトリで、クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリ。

インストールが終了すると、各ノードにインストールディレクトリ、ローカルのホームディレクトリ、共有ホームディレクトリが 1 つ存在することになります（2 つのノードクラスタに合計で5 個のディレクトリ） 

1. Confluence サーバーのアップグレード 

Confluence のバージョンをアップグレードし、同時に Confluence データセンターの切り替えを行うことはできません。例えば、Confluence 5.4 を利用中で、Confluence サーバー 5.6 へのアップグレードする場合は、Confluence データセンター 5.6 へ移行する前に行います。 

Confluence 旧バージョンから Confluence データセンターへの移行の一環としてアップグレードしている場合は、最初に同じバージョンのConfluence へのアップグレードとバックアップについて、通常の手順に従うことになります。アップグレードと最適なアップグレードパスの選択については、Confluence のアップグレードを参照してください。

アップグレードの成功を確認できれば、インスタンスは正しく機能しているので、Confluence をシャットダウンします。 

2. 共有ホームディレクトリの作成 

1. クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリを作成します。これが共有ホームディレクトリになります。 
2. In your existing Confluence home directory move contents of <confluence home>/shared-home to the new shared home directory you just created.
   To prevent confusion, we recommend deleting the empty <confluence home>/shared-home directory once you've moved its contents.
3. 添付ファイルディレクトリを新しい共有ホームディレクトリに移行します（現在添付ファイルをデータベースに保存している場合はこの手順をスキップしてください）。 

3. データセンターのアップグレード 

1. Download the Clustered edition of Confluence (for the version you just upgraded to).
2. Upgrade to the Data Center version of Confluence. 
   Note: your home directory (configured in confluence\WEB-INF\classes\confluence-init.properties) should still be pointing to your existing (local) home directory.
3. Start Confluence Data Center (run start-confluence.sh or start-confluence.bat)
4. セットアップウィザードで 1 つ目のノードの設定まで行えます。以下の内容を入力するよう指示されます：
   • クラスタ ライセンス
   • クラスタ名
   • 作成済みの共有ホームディレクトリへのパス 
   • マルチキャスト アドレス（自動生成または入力して作成を選択します）。
   • 他ノードとの通信用に Confluence が使用するネットワーク インターフェイス

1 つ目のノードがアップロードされ、実行されます。  

4.ノード 2 に Confluence をコピー

2 つ目のノードに Confluence をコピーするには：

1. ノード 1 で Confluence をシャットダウンする。
2. ノード2 でアプリケーション サーバーをシャットダウン、または自動的にウェブアプリケーションのロードを停止する。
3. ノード 1 からノード 2 へインストール ディレクトリをコピーする。
4. Copy the local home directory from node 1 to node 2.
   If the file path of the local home directory is not the same on nodes 1 and 2 you'll need to update the <installation directory>/confluence/WEB-INF/classes/confluence-init.properties file on node 2 to point to the correct location.

ローカルのホームディレクトリをコピーすることで、確実に Confluence 検索インデックス、データベース、クラスタ設定、その他の設定をノード 2 にコピーします。

5. ノード 1 で Confluence を開始、待つ、ノード 2 で Confluence を開始

一度に開始する Confluence サーバーは 1 機までとすることを推奨します。

1. ノード 1 で Confluence を開始する。
2. Confluence がノード 1 で使用可能になるまで待つ。
3. ノード 2 で Confluence を開始する。
4. Confluence がノード 2 で使用可能になるまで待つ。

6. クラスタ接続性のテスト

The Cluster monitoring console ( > General Configuration > Clustering) includes information about the active cluster.

When the cluster is running properly, this page displays the details of each node, including system usage and uptime. Use the menu to see more information about each node in the cluster.

スクリーンショット：クラスタ監視コンソール

クラスタが正しく作動しているか確認する簡単な方法は：

1. ノード 1 で新しいドキュメントを作成する。
2. ノード 2 で直接アクセスして新しいドキュメントが見えているか確認する。
3. ノード 1 で新しいドキュメントを検索し、表示されるか確認する。
4. ノード 2 で新しいドキュメントを検索し、表示されるか確認する。

7. ロードバランサの設定

Install and configure your load balancer.  You can use the load balancer of your choice, but it needs to support ‘session affinity’.

ご利用のロードバランサを以下の点で検証します：リクエストを送信する際、Confluence にアクセスしてロードバランサを通過し、既存の Confluence サーバーに正しく送信してページを作成し、このページがロードバランサを使用した他のマシンから閲覧・編集が可能である。

トラブルシューティング

上記の手順で問題が発生した場合は、クラスタ トラブルシューティング ガイドを参照してください。

If you are testing Confluence Data Center by running the cluster on a single machine, please refer to our developer instructions on Starting a Confluence cluster on a single machine.

データセンターからサーバーへの移行

ここでは、データセンター（クラスタ化）からサーバー（非クラスタ）への移行を説明します。説明では、既存のクラスタノードのひとつを新しい非クラスタ化のインストールに使用するものと仮定しています。 

サーバーに切り替えるには、 Confluence サーバーライセンスが必要になります。 

1.クラスタの停止

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

ロードバランサーを Confluence からトラフィックをリダイレクトするよう設定しておくことをお勧めします。

2. ホームで共有されているクラスタのの項目をローカルのホームに戻す

1. Create a directory called /shared-home in the <local home> directory on one node (if you removed this directory when installing Data Center).
2. Move the entire config directory from your <shared home> directory to the <local home>/shared-home directory.
3. Move the remaining contents of your <shared home> directory to the root of your <local home> directory. 

この時点で、クラスタの共有ホームディレクトリが空になっているはずです。 

3. Confluence サーバーへアップグレード

1. Download the Server (non-clustered) edition of Confluence (you must use the same version as is currently installed).
2. Upgrade to the Server version of Confluence. 
   Note: your home directory (configured in confluence\WEB-INF\classes\confluence-init.properties) should point to your local home directory.
3. Start Confluence Server (run  start-confluence.sh or start-confluence.bat)
4. セットアップウィザードにしたがって、Confluence サーバー ライセンスの適用し、移行プロセスを完了させます。 

To confirm you are now running the non-clustered edition, go to  > General Configuration. The Cluster Configuration page should not appear.