Confluence Data Center のインストール
このガイドでは、クラスタ化されたソリューションである Confluence Data Center を初めてインストールする (既存データなし) 方法を段階的に説明します。
Confluence サーバーインスタンスが既にある場合、「Confluence Data Center への移行」を参照してください。
1.クラスタ化の要件および専門用語
Confluence をクラスタで実行するには以下が必須条件になります:
- クラスタ ライセンスがある
- サポート対象となっているバージョンの外部データベース、OS、Javaを使用する。
- クラスタの前にセッションアフィニティを使用したロードバランサを使用する
- 同じパスですべてのクラスタノードにアクセス可能な共有ディレクトリ(共有ホームディレクトリになります)が存在する
- 他のアトラシアン製品(JIRA 等)へのアプリケーション リンクがある場合、OAuth 認証を使用する。
データセンター評価ライセンスが必要な場合は、弊社までご連絡ください。
このガイドでは以下の用語について説明します:
- インストール ディレクトリ - 単体ノードに Confluence をインストールしたディレクトリ。
- ローカルのホームディレクトリ - 各ノードのホームディレクトリまたはデータディレクトリ(クラスタ化されていないディレクトリ。 Confluence では、単にホームディレクトリと呼ばれます) 。
- 共有ホームディレクトリ - 作成したディレクトリで、クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリ。
インストールが終了すると、各ノードにインストールディレクトリ、ローカルのホームディレクトリ、共有ホームディレクトリが 1 存在することになります(2 つのノードクラスタに合計で5 個のディレクトリ)
2. ノード 1 に Confluence をインストール
- ノード 1 に Confluence をインストールします。
詳細は、「Windows で Zip ファイルから Confluence をダウンロード」または「Linux でアーカイブファイルから Confluence をインストール」を参照してください。 - ノード 1 で Confluence を開始する。
- 以下を入力してセットアップウィザードを完了します。
- クラスタ ライセンス
- クラスタ名
- 作成済みの共有ホームディレクトリへのパス
- マルチキャストアドレス (自動生成または手動入力) または各クラスターノードの IP アドレス
- 他のノードとの通信用に Confluence が使用するネットワーク インターフェイス
3. 単体ノードのロードテスト
Confluence のインストールではたいていクラスタ化は必要ありませんが、増設の複合クラスタの使用を先に進める前に、単体ノードのインストールをユーザー数やロード数でテストを行うこともできます。
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.properties
file on node 2 to point to the correct location.
ローカルのホームディレクトリをコピーすることで、確実に Confluence 検索インデックス、データベース、クラスタ設定、その他の設定をノード 2 にコピーします。
5. ノード 1 で Confluence を開始、待つ、ノード 2 で Confluence を開始
一度に1つの 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. ロードバランサの設定
Install and configure your load balancer. You can use the load balancer of your choice, but it needs to support ‘session affinity’.
ご利用のロードバランサを以下の点で検証します:リクエストを送信する際、Confluence にアクセスしてロードバランサを通過し、既存の Confluence サーバーに正しく送信してページを作成し、このページがロードバランサを使用した他のマシンから閲覧・編集が可能である。
セキュリティ
権限のあるクラスターノードのみが、ファイアウォールおよびネットワークの分離 (またはこのいずれか) を利用して Confluence Data Center インスタンスの Hazelcast ポート (既定ではポート 5801) への接続を許可されるようにします。
トラブルシューティング
上記の手順で問題が発生した場合は、クラスタ トラブルシューティング ガイドを参照してください。
クラスタを一つのマシンで作動させて Confluence データセンターのテストを行う場合は、 単体マシンで Confluence クラスタ を開始に記載された開発者向け説明書を参照してください。
クラスタのアップグレード
Confluence データセンターのアップグレードの手順にしたがってアップグレードすることが重要です。