Confluence Data Center への移行
以下では、Confluence サーバーから Confluence Data Center への移行 (クラスタ化ソリューション) プロセスを説明します。
Confluence Data Center から Confluence サーバーへの移行についても記載しています。
Confluence ライセンスは、Confluence のタイプ (サーバーまたは Data Center) を決定します。 Confluence 管理の 'ライセンス詳細' ページでライセンスキーを入力すると、Confluence がライセンスタイプを自動検出します。別のタイプのライセンスを入力した場合、移行 (Confluence サーバーから Data Center への移行など) を開始するように自動的にプロンプトが出されます。
初めて Confluence をインストールする場合 (移行する既存の Confluence データがない場合) は、「Confluence Data Center のインストール」を参照してください。
サーバーからデータセンターへの移行
クラスタ化の要件および専門用語
Confluence をクラスタで実行するには以下が必須条件になります。
On this page:
- Have a Data Center license (you can purchase a Data Center license or create an evaluation license at my.atlassian.com)
- 外部データベースを使用する
- クラスタの前にセッションアフィニティを使用したロードバランサを使用する
- 同じパスですべてのクラスタノードにアクセス可能な共有ディレクトリ (これが共有ホームディレクトリになります) が存在する
- 他のアトラシアン製品 (JIRA アプリケーションなど) へのアプリケーション リンクがある場合、OAuth 認証を使用する。
Confluence Data Center の評価版ライセンスが必要な場合は、弊社までご連絡ください。
- インストールディレクトリ – Confluence がインストールされるディレクトリ。
- ローカルのホームディレクトリ– 各ノードのホームディレクトリまたはデータディレクトリ (非クラスタ化 Confluence では、単にホームディレクトリと呼ばれます)。
- 共有ホームディレクトリ – 同一パスを経由してクラスタ内のすべてのノードにアクセス可能な、ユーザーが作成したディレクトリ。
インストールプロセスが終了したとき、各ノードにインストールディレクトリとローカルのホームディレクトリが存在し、他に共有ホームディレクトリが１つ存在することになります (たとえば、２つのノードクラスタでは、合計で 5 個のディレクトリが存在します)。
1. Confluence サーバーのアップグレード
Confluence Data Center 5.9 以降に切り替える場合、まず、Confluence のバックアップとアップグレードの通常の手順に従ってください。アップグレードと最適なアップグレードパスの選択に関する詳細は、「Confluence のアップグレード」を参照してください。
Confluence Data Center 5.8 に切り替える場合は、アップグレードプロセスが少し異なります。詳細は、以前のドキュメントを参照してください。
2. Data Center ライセンスの適用
Your home directory (configured in confluence\WEB-INF\classes\confluence-init.properties) should still be pointing to your existing (local) home directory.
- Go to
> General administration. - 管理という見出しの下のサイドバーからライセンス詳細を選択します。
- Confluence Data Center のライセンスキーを入力します。
- Confluence をシャットダウンします。
3. 共有ホームディレクトリの作成
- 同一パスを経由してクラスタのすべてのノードにアクセス可能なディレクトリを作成します。これが共有ホームディレクトリになります。
- In your existing Confluence home directory, move the contents of
<confluence home>/shared-hometo the new shared home directory you just created.
To prevent confusion, we recommend deleting the empty<confluence home>/shared-homedirectory once you've moved its contents. - 添付ファイルディレクトリを新しい共有ホームディレクトリに移行します（現在添付ファイルをデータベースに保存している場合はこの手順をスキップしてください）。
4. Confluence の起動
以下の項目を入力して移行を完了するようにセットアップウィザードからプロンプトが出されます。
- クラスタ名
- 作成済みの共有ホームディレクトリへのパス
- マルチキャストアドレス (自動生成または手動入力) または各クラスターノードの IP アドレス
- 他のノードとの通信用に Confluence が使用するネットワーク インターフェイス
1 つ目のノードがアップロードされ、実行されます。
4.ノード 2 に Confluence をコピー
2 つ目のノードに Confluence をコピーするには：
- ノード 1 で Confluence をシャットダウンする。
- ノード2 でアプリケーション サーバーをシャットダウン、または自動的にウェブアプリケーションのロードを停止する。
- ノード 1 からノード 2 へインストール ディレクトリをコピーする。
- 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.propertiesfile on node 2 to point to the correct location.
ローカルのホームディレクトリをコピーすることで、確実に Confluence 検索インデックス、データベース、クラスタ設定、その他の設定をノード 2 にコピーします。
5. ノード 1 で Confluence を開始、待つ、ノード 2 で Confluence を開始
一度に１つの Confluence サーバーのみ起動する必要があります。
- ノード 1 で Confluence を開始する。
- Confluence がノード 1 で使用可能になるまで待つ。
- ノード 2 で Confluence を開始する。
- Confluence がノード 2 で使用可能になるまで待つ。
6. クラスタ接続性のテスト
The Cluster monitoring console (
> General Configuration > Clustering) includes information about the active cluster.
クラスタが適切に実行されていると、このページにシステムの使用状況やアップタイムなどを含む各ノードの詳細情報が表示されます。クラスタの各ノードの詳細情報については、
メニューから参照してください。
スクリーンショット：クラスタ監視コンソール
クラスタが正しく作動しているか確認する簡単な方法は：
- ノード 1 で新しいドキュメントを作成する。
- ノード 2 で直接アクセスして新しいドキュメントが見えているか確認する。
- ノード 1 で新しいドキュメントを検索し、表示されるか確認する。
- ノード 2 で新しいドキュメントを検索し、表示されるか確認する。
作動していないクラスタの 2 つ以上のインスタンスがデータベースにアクセスしていることを Confluence が 検知すると、クラスタパニックを起こし、Confluence はシャットダウンします。クラスタネットワーク接続性のトラブルシューティングから解決してください。
7. ロードバランサの設定
ロードバランサをインストールして設定します。ロードバランサはお好みで選択できますが、「クッキーベースのセッションアフィニティ」のサポートが必要となります。
ご利用のロードバランサを以下の点で検証します：リクエストを送信する際、Confluence にアクセスしてロードバランサを通過し、既存の Confluence サーバーに正しく送信してページを作成し、このページがロードバランサを使用した他のマシンから閲覧・編集が可能である。
セキュリティ
権限のあるクラスターノードのみが、ファイアウォールおよびネットワークの分離 (またはこのいずれか) を利用して Confluence Data Center インスタンスの Hazelcast ポート (既定ではポート 5801) への接続を許可されるようにします。
トラブルシューティング
上記の手順で問題が発生した場合は、クラスタ トラブルシューティング ガイドを参照してください。
クラスタを一つのマシンで作動させて Confluence データセンターのテストを行う場合は、 単体マシンで Confluence クラスタ を開始に記載された開発者向け説明書を参照してください。
データセンターからサーバーへの移行
Data Center (クラスタ化) からサーバー (非クラスタ化) へ移行する必要がある場合は、以下をお読みください。ここでは、既存のクラスタノードのひとつを新しい非クラスタ化のインストールに使用するものと仮定して説明します。
サーバーに切り替えるには、 Confluence サーバーライセンスが必要になります。
このプロセスを完了する前に
万一に備えて、１つのノードを除いてすべてのノードをシャットダウンし、単一ノード上で Confluence を実行することをお勧めします。
1. Confluence サーバーライセンスの入力
ホーム ディレクトリ (confluence\WEB-INF\classes\confluence-init.properties で設定済み) は、ローカルのホーム ディレクトリに設定されていると想定しています。
- Go to > General administration
- 管理という見出し の下のサイドバーからライセンス詳細を選択します。
- Confluence サーバーのライセンスキーを入力します。
2. Confluence のシャットダウン
続行する前に、実行中のクラスタノードがあれば停止します。Confluence からトラフィックをリダイレクトするようにロードバランサーを設定しておくことをお勧めします。
3. ホームで共有されているクラスタのの項目をローカルのホームに戻す
- 1 つのノードで、
<local home>ディレクトリに/shared-homeという名のディレクトリを作成します (Data Center のインストール時にこのディレクトリを削除した場合)。 configディレクトリ全体を<shared home>ディレクトリからlocal home>/shared-homeディレクトリに移動します。<shared home>ディレクトリの残りのコンテンツを<local home>ディレクトリの root に移動します。
この時点で、クラスタの共有ホームディレクトリが空になっているはずです。
4. Confluence の起動
セットアップウィザードに従って移行プロセスを実行します。
To confirm you're now running the non-clustered edition, go to > General Configuration. The 'Cluster Configuration' page should not appear. Instead you'll see information about Confluence Data Center.