Confluence Data Center のインストール
このガイドでは、Windows または Linux 環境で、クラスタ化ソリューションである Confluence Data Center のインストールを実行します。
このガイドでは、既存のデータのない初回インストールについて説明しています。すでに Confluence サーバー インスタンスがある場合は、「Confluence Data Center への移行」を参照してください。
Confluence Data Center をインストールする他の方法
- AWS クイック スタート - AWS での無料のデプロイメント
- Data Center に移動 - 既存の Confluence Server サイト用
On this page:
はじめる前に
クラスタリングの要件
Confluence をクラスタで実行するには以下が必須条件になります：
- Data Center ライセンスを所有している (Data Center ライセンスを購入するか、my.atlassian.com で評価ライセンスを作成することが可能)。
- サポート対象となっているバージョンの外部データベース、OS、Javaを使用する。
- Confluence クラスタの手前で、セッション アフィニティと WebSockets をサポートするロード バランサを使用すること。
- 同じパスですべてのクラスタノードにアクセス可能な共有ディレクトリ（共有ホームディレクトリになります）が存在する
- 他のアトラシアン製品 (Jira 等) へのアプリケーション リンクがある場合、OAuth 認証を使用していること。
サポート対象プラットフォーム
使用可能なデータベース、Java、およびオペレーティング システムの詳細については、「サポートされるプラットフォーム」を参照してください。Server と Datab Center デプロイメントの要件は同じです。重要なハードウェアおよびインフラストラクチャの考慮事項については、「Confluence Data Center の技術的概要」を参照してください。
また、AWS や Azure で Confluence Data Center を実行するのに役立つ、具体的なガイドとテンプレート ガイドも用意しています。それらをチェックして何が必要かをご確認ください。
用語
このガイドでは以下の用語について説明します：
- インストール ディレクトリ - 単体ノードに Confluence をインストールしたディレクトリ。
- ローカルのホームディレクトリ - 各ノードのホームディレクトリまたはデータディレクトリ（クラスタ化されていないディレクトリ。 Confluence では、単にホームディレクトリと呼ばれます） 。
- 共有ホームディレクトリ - 作成したディレクトリで、クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリ。
- Synchrony ディレクトリ - Synchrony を設定および実行したディレクトリ (confluence ノードや独自のノード上にあります)
インストールが終了すると、各ノードにインストールディレクトリ、ローカルのホームディレクトリ、および Confluence に共有ホームディレクトリが 1 つと Synchrony のディレクトリが存在することになります (2 つのノードクラスタに合計で5 個のディレクトリ)。
Confluence のインストールとセットアップ
1. ノード 1 に Confluence をインストール
- ノード 1 に Confluence をインストールします。
詳細は、「Windows で Zip ファイルから Confluence をダウンロード」または「Linux でアーカイブファイルから Confluence をインストール」を参照してください。 - ノード 1 で Confluence を開始する。
- 以下の項目を入力して移行を完了するようにセットアップウィザードからプロンプトが出されます。
- クラスタ名
- 作成済みの共有ホームディレクトリへのパス
- 他のノードとの通信用に Confluence が使用するネットワーク インターフェイス
- マルチキャストアドレス (自動生成または手動入力) または各クラスターノードの IP アドレス
Confluence によるクラスター ノードの検出方法:
- マルチキャスト - マルチキャスト アドレスを入力または自動生成します。
- TCP/IP - 各クラスタ ノードの IP アドレスを入力します。
AWS - 自分の IAM ロールまたは秘密キーと領域を入力します。
ノード 1 で Confluence を停止する
Synchrony のセットアップ
共同編集を計画しない場合は、このセクションで手順を省略し、2 番目の Confluence ノードの追加へ移動できます。
2.Synchrony クラスタのセットアップ
- 最初の Confluence ノードから
<install-directory>/bin/synchronyディレクトリを Synchrony ノードに移動します。これを、<synchrony-home>ディレクトリと呼びます。 synchrony-standalone.jarを Confluence のローカル ホーム ディレクトリから<synchrony-home>ディレクトリにコピーします。- Confluence の
<install-directory>/confluence/web-inf/libからデータベース ドライバをコピーし、<synchrony-home>ディレクトリまたは Synchrony ノード上の適切な場所にペーストします。 - Edit the
<synchrony-home>/start-synchrony.shorstart-synchrony.batfile and enter details for the parameters listed under Configure parameters.
See Configuring Synchrony for Data Center for more information on the required parameters and some and optional properties that you can also choose to specify. - Confluence を起動し、
http://<SERVER_IP>:<SYNCHRONY_PORT>/synchrony/heartbeat
に移動して Synchrony が使用可能かどうかチェックします。 <synchrony-home>ディレクトリを各 Synchrony ノードにコピーします。各ノードが結合すると、表示はこのコンソール内のようになります。Members [2] { Member [172.22.52.12]:5701 Member [172.22.49.34]:5701 }- Synchrony 用にロード バランサを設定します。
ロード バランサは WebSockets (例: NGINX 1.3 以降、Apache httpd 2.4、IIS 8.0 以降) をサポートする必要があります。Synchrony が Web ブラウザからの XHR リクエストを承認できるよう、ロード バランサで SSL 接続をターミネートする必要があります。
3. ノード 1 で Confluence を開始する
この例では、「Data Center 用の Synchrony の設定」に示すように、Synchrony と Confluence に同じロード バランサを使用していると想定しています。
ノード 1 で Confluence を起動し、次のシステム プロパティを Confluence に渡して Synchrony クラスタの場所を Confluence に伝えます。
-Dsynchrony.service.url=http://<synchrony load balancer url>/synchrony/v1たとえば、
http://yoursite.example.com/synchrony/v1のように、URL の末尾に/v1を含める必要があります。Synchrony がロード バランサを使用しない単体のノードとして設定されている場合、代わりに以下を使用します。
-Dsynchrony.service.url=http://<synchrony ip or hostname>:<synchrony port>/synchrony/v1たとえば、
http://42.42.42.42:8091/synchrony/v1またはhttp://synchrony.example.com:8091/synchrony/v1のようになります。このシステム プロパティを
<install-directory>/bin/setenv.shまたはsetenv.batに追加すると、Confluence を起動するたびに自動的に渡されます。ご利用の環境でこれを実施する方法の詳細については、「システム プロパティの設定」を参照してください。- Head to
> General Configuration > Collaborative editing to check that this Confluence node can connect to Synchrony.
Note: to test creating content you'll need to access Confluence via your load balancer. You can't create or edit pages when accessing a node directly.
Confluence ノードを追加する
4.ノード 2 に Confluence をコピー
2 つ目のノードに Confluence をコピーするには：
- ノード 1 で Confluence をシャットダウンする。
- ノード2 でアプリケーション サーバーをシャットダウン、または自動的にウェブアプリケーションのロードを停止する。
- ノード 1 からノード 2 へインストール ディレクトリをコピーする。
- ノード 1 からノード 2 にローカルのホーム ディレクトリをコピーします。
ノード 1 と 2 でローカル ホーム ディレクトリのファイル パスが異なる場合、<installation directory>/confluence/WEB-INF/classes/confluence-init.propertiesファイルをノード 2 で更新し、正しい場所を示すようにする必要があります。
ローカルのホームディレクトリをコピーすることで、確実に Confluence 検索インデックス、データベース、クラスタ設定、その他の設定をノード 2 にコピーします。
5. ロードバランサの設定
Confluence 用にロードバランサを設定します。ロードバランサはお好みで選択できますが、セッションアフィニティと WebSocketsのサポートが必要となります。
Synchrony が Web ブラウザからの XHR リクエストを承認できるよう、ロードバランサで SSL接続を終了させる必要があります。
ご利用のロードバランサを以下の点で検証します：リクエストを送信する際、Confluence にアクセスしてロードバランサを通過し、既存の Confluence サーバーに正しく送信してページを作成し、このページがロードバランサを使用した他のマシンから閲覧・編集が可能である。
6.一度に Confluence の 1 つのノードを起動する
一度に１つの Confluence ノードのみ起動する必要があります。最初のノードを立ち上げ、利用可能になってから、次のノードを起動してください。
- ノード 1 で Confluence を開始する。
- Confluence がノード 1 で使用可能になるまで待つ。
- ノード 2 で Confluence を開始する。
- Confluence がノード 2 で使用可能になるまで待つ。
The Cluster monitoring console ( > General Configuration > Clustering) shows information about the active cluster.
クラスタが適切に実行されていると、このページにシステムの使用状況やアップタイムなどを含む各ノードの詳細情報が表示されます。クラスタの各ノードの詳細情報については、
メニューから参照してください。
7. Confluence クラスタのテスト
コンテンツをテストするには、ロードバランサ経由で Confluence にアクセスする必要があります。ノードに直接アクセスする場合、ページを作成または編集することはできません。
クラスタが正しく作動しているか確認する簡単な方法は：
- ロードバランサ経由でノードにアクセスし、このノードで新しいドキュメントを作成します。
- 異なるノードに直接アクセスして新しいドキュメントが見えているかを確認します。
- 元のノードで新しいドキュメントを検索し、表示されるか確認します。
- 別のノードで新しいドキュメントを検索し、表示されるか確認します。
作動していないクラスタの 2 つ以上のインスタンスがデータベースにアクセスしていることを Confluence が 検知すると、クラスタ パニックを起こし、Confluence はシャットダウンします。クラスタネットワーク接続性のトラブルシューティングから解決してください。
セキュリティ
権限のあるクラスターノードのみが、ファイアウォールおよびネットワークの分離を利用して Confluence Data Center インスタンスの Hazelcast ポート (デフォルトではポート 5801) または Synchrony の Hazelcast (デフォルトではポート 5701) への接続を許可されるようにします。
トラブルシューティング
上記の手順で問題が発生した場合は、クラスタ トラブルシューティング ガイドを参照してください。
クラスタを一つのマシンで作動させて Confluence データセンターのテストを行う場合は、 単体マシンで Confluence クラスタ を開始に記載された開発者向け説明書を参照してください。
クラスタのアップグレード
Confluence データセンターのアップグレードの手順にしたがってアップグレードすることが重要です。