共同編集のトラブルシューティング
共同編集は、リアルタイムでデータを同期する Synchrony によって動作しています。通常の状態では、管理者によって手動で管理する必要はありません。
このページは、お客様のインスタンスにおける Synchrony での問題のトラブルシューティングに役立ちます。
最初のステップ
Synchrony が実行中かどうかを確認する
Synchrony が実行中かどうかを確認するには、
> [一般設定] > [共同編集] に移動します。
注: Confluence Data Center を実行中の場合は、このページで、現在の Confluence ノードがお使いの Synchrony クラスタに接続されているかどうかがわかります。Synchrony クラスタの監視をサポートするためにサードパーティ製監視ツールを使用することもできます。詳細は「Confluence Data Center での Synchrony の状況の確認方法」を参照してください。
ページを編集できることを確認する
ページの編集中にエラーが表示されるけれど Synchrony が実行中である場合、何らかの原因でブラウザーを Synchrony に接続できない可能性があります。
最も一般的な問題は、リバース プロキシの設定ミスです。このページで後述されているプロキシのトラブルシューティングのヒントを参照するか、「共同編集の管理」へ移動して、使用可能なプロキシと SSL の構成についての詳細をご覧ください。
ログの確認
Confluence のアプリケーション ログは <home-directory>/logs/atlassian-confluence.log に、Synchrony 固有のログは <home-directory>/logs/atlassian-synchrony.log にあります。
Synchrony の再起動
Synchrony が Confluence によって管理されている場合、 > [一般設定]> [共同編集] に進み、[Synchrony の再起動] を選択します。
スタンドアロンの Synchrony クラスタを実行する場合、各ノードで Synchrony を手動で再起動します。
ポート 8091 が利用可能か確認する
Synchrony は、既定でポート 8091 で実行されます。このポートがサーバー上の別のアプリケーションによってすでに使用されている場合は、synchrony.port システム プロパティを使用して、利用可能なポートを変更します。
(Confluence 6.0.3 以前を使用している場合、synchrony.port の代わりに reza.port を使用する必要があります)
これの変更方法の詳細は、「システム プロパティの設定」を参照してください。
Confluence Data Center の場合、Synchrony の実行方法は異なります。詳しくは「Synchrony を設定する」を参照してください。
リバース プロキシの問題
リバース プロキシを既に設定しているにも関わらず、ページが編集できない場合は、設定で以下を確認してください:
installation-directory>/conf/server.xmlに移動し、Connectorディレクティブを確認します。<protocol>および<proxyName>の値が正しいことを確認します。詳細については、以下のガイドの例を参照してください。- SSL を設定していたり AJP コネクタを使用していたりする場合も、
httpコネクタは常に<installation-directory>/conf/server.xmlファイル内に存在する必要があります。Synchrony ヘルス チェックは HTTP を使用し、このコネクタが存在しない場合は失敗します。http コネクタを含めたくない場合は、synchrony.proxy.healthcheck.disabledシステム プロパティを使用してヘルス チェックを無効化することができます。 - Apache を使用している場合、Apache 2.4 (WebSockets 対応) を使用しており、すべての必要なモジュールが有効化されている (
mod-proxy、mod_rewrite、proxy_wstunnel) ことを確認します。 - Apache を使用していて Synchrony に直接接続したい場合は、プロキシ構成ファイルで、
/synchronyが含まれており、Confluence および Synchrony ディレクティブと location ブロックの順序が適切であることを確認します。詳細については、上記のガイドの例を参照してください。
共同編集の管理を参照し、使用可能なプロキシや SSL 構成についての詳細を確認します。その後、Synchrony に直接接続する場合は、次のガイドで、お使いのリバース プロキシ設定に Synchrony を含める方法の詳細を確認してください。
- Apache で mod_proxy を使用する
- SSL を使用して NGINX のバックグラウンドで Confluence を実行する
- Apache HTTP Server (mod_proxy_http) でアトラシアンのサーバー アプリケーションをプロキシする
- Microsoft Internet Information Services (IIS) を使用したアトラシアン サーバー アプリケーションのプロキシ
- Confluence で Amazon Web Service Application Load Balancer を構成する方法
フォワード プロキシの問題
フォワード またはアウトバウンド プロキシを使用している場合は、Synchrony がリスンする IP を config に追加し、バイパスされるようにする必要があります。詳細は、「Confluence 用に Web プロキシサポートを設定する」を参照してください。
既定では、IP は 127.0.0.1 または synchrony.host システム プロパティの値になります (Confluence が Synchrony への接続に使用するホスト名または IP をカスタマイズした場合)。
Websocket の問題
共同編集は、 Websocket 接続で最適に動作します。 タイムアウトや、Websocket 接続を許可しないプロキシ サーバーまたはファイアウォールによって接続が確立できない場合、エディタは XML HTTP リクエスト (XHR) 経由での接続を試みます。
また、http://websocket.org/echo.html を使用して、エコー サーバーに対する簡易的な HTML 5 WebSocket テストを実行することもできます。
ブラウザーの開発ツールを使用すると、Websocket 接続を検証できます。次の例では、Chrome を使って Websocket 接続を確認します。
- Chrome 開発ツール (Shift + CTRL + J) を開きます
- [ネットワーク] タブを選択します。
- [WS] フィルターを選択し、WebSocket のトラフィックのみを表示します
- Confluence ページを編集します
- 次の Websocket 接続を選択します:
ws://<confluence-url>/synchrony-proxy/v1/bayeux-sync1 - [Frames/Messages (フレーム / メッセージ)] タブを選択して、ブラウザーと WebSocket の間のトラフィックを確認します。
SSL の課題
Synchrony では、ダイレクト HTTPS 接続を使用できません。そのため、リバース プロキシまたはロード バランサ (リバース プロキシを使用していない場合は Tomcat) で SSL を終了する必要があります。
メモリの問題
Synchrony に関連してメモリ不足エラーが発生した場合は、synchrony.memory.max システム プロパティを使用して、Synchrony に割り当てられているヒープ サイズを変更できます。
Confluence 6.0.3 以前を使用している場合は、synchrony.memory.max の代わりに reza.memory.max を使用する必要があります。
これの変更方法の詳細は、「システム プロパティの設定」を参照してください。
Confluence Data Center の場合、Synchrony の実行方法は異なります。詳しくは「Synchrony を設定する」を参照してください。
複数の Synchrony プロセス
エディターに直ちにエラーが表示されないのに、Confluence reports that Synchrony が実行中であることを報告する場合は、実行中の Synchrony プロセスが 1 つのみであることを確認してください。
複数の Synchrony プロセスを実行中の場合は、Confluence を停止し、追加 Synchrony プロセスを終了してから、Confluence を再起動してください。
Confluence の終了時に Tomcat ウィンドウを使用するのではなく stop-confluence.sh / stop-confluence.bat を使用することで、この問題を回避できます。
クラスタ内での Synchrony モードの混在
Confluence をクラスタで実行している場合、すべての Confluence ノードが同じ方法で Synchrony に接続されている必要があります。
ユーザーが 1 つの Confluence ノードで共同編集を使用でき、別の Confluence ノードでは使用できない場合は、 > [一般設定] > [クラスタリング] に移動して、各ノードで [共同編集] を選択します。
すべての Confluence ノードで同じ Synchrony モード (Confluence での管理、またはスタンドアロンの Synchrony クラスタ) が報告されていることを確認します。
この方法ですべてのノードにアクセスできます。ブラウザで特定のノードをクリックする必要はありません。
互換性がないブラウザ拡張機能
エディターと相互作用する一部のサードパーティ製ブラウザー拡張子 (Grammarly など) は、共同編集が正常に機能しない場合があります。Confluence サイトでのみ Grammarly を無効にする方法については「(アーカイブ済み) Confluence 共同編集により Grammarly 拡張子がブロックされる」をご参照ください。
ファイアウォールまたはウイルス対策の干渉
ファイアウォールまたはウイルス対策ソフトウェアによって、サーバーへの一部のリクエストがブロックされ、エディターで予期せぬ動作が発生するという報告をいくつか受けています。問題が発生した場合は、Confluence をホワイトリスト/信頼済み URL に追加する必要が出る場合があります。詳細は、Kaspersky インターネット セキュリティでの異常なページまたはエディターの動作を参照してください。
エディタを使用中のユーザーが多すぎる
最大 12 人のユーザーが同時にページを編集することができます。つまり、すでに 12 人のユーザーがページを編集している場合、新しいユーザーはエディタを開くことができず、それらのユーザーがエディタを離れるまで待つ必要があります。
管理者は confluence.collab.edit.user.limit システム プロパティを使用して、上限値を増減できます。