Jira Data Center でクラスター キャッシュ レプリケーションのヘルス チェックに失敗する
プラットフォームについて: Data Center のみ。 - This article only applies to Atlassian apps on the Data Center プラットフォーム。
この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。 Server* 製品のサポートは 2024 年 2 月 15 日に終了しました。Server 製品を実行している場合は、 アトラシアン Server サポート終了 のお知らせにアクセスして、移行オプションを確認してください。
*Fisheye および Crucible は除く
要約
Jira Data Center のクラスター レプリケーションは、データベースに記録されているノードと、更新の送受信を行っているノードに依存します。ヘルス チェックでは、レプリケーションがクラスター全体で動作していることを確認します。1 つのアクティブ ノードが応答しない場合、他のノードが警告を送信することになり、エラーが発生しているノードではクリティカルな結果が記録されます。
ソリューション
結果の確認
結果 | 意味 |
|---|---|
ヘルス チェックは正常に完了しました。 | クラスター内のノード レプリケーションが動作しています。 |
The node <node> is not in the database. | The node does not appear to be in the database however does exist within the replication cache, or the node is unresponsive. |
The node <node> is not replicating. | ノードで情報がクラスターに複製されていません。データベースに存在するがレプリケーション キャッシュに存在しません。 |
クラスターを横断する不一致
Jira keeps some data in memory local to the node especially data that are used often such as permissions. The cache synchronization is asynchronous (7.9 and later) but expected to be fast and consistent across nodes. It is communicated and replicated over the network.
症状は次のとおりです。
ユーザーが一部のノードにのみ存在する。
ユーザーが一部のノードでのみ権限を持つ。
ユーザー フィールドのドロップダウンの結果が一部のノードでのみ表示される。
権限の更新後、フィルターやガジェットが 1 つのノードでのみ表示される。
トラブルシューティング
問題 | 提案 |
|---|---|
ノードがデータベースに存在しない。 | Restart the affected node. Prior to doing so, it is recommended to collect some thread dumps as per Generating a Thread Dump as these can be sent to support with the data below. |
ネットワーク状態の影響により、ノードが複製されない。 | Each server needs to be able to resolve its own hostname correctly. Specify the hostname value for the ehcache.listener.hostName parameter in the cluster.properties, following the instructions in the Install Guide. ファイアウォールまたはネットワーク状況によってノード間のコミュニケーションがブロックされている可能性があります。各ノードのログで、ネットワーク接続に関連する例外が記録されているかどうかを確認します。 JIRA Data Center can be configured to use TCP multicast to communicate between the nodes. Check the configuration in the cluster.properties file and review the Install Guide for more information. マルチキャストを利用している場合に現在利用中のマルチキャスト アドレスを確認するには、各ノードで次のコマンドを実行します。 LINUX: netstat -g WINDOWS: netsh interface ip show joins Jira Data Center のノード間でファイアウォールを利用する運用は想定されていません。 A request has been raised to have these configuration options documented. |
ノードがオフラインなために複製されない。 | 他の各ノードのステータスを確認します (特にオンラインで応答している場合)。 |
You can monitor cache replication by reviewing statistics that are written in the log file. They’ll show you the size of the local queues, and whether cache modifications are successfully replicated or persisted in the queues for too long. In most cases, monitoring just a few parameters will tell you if the replication is working properly. For more info, see Monitoring the cache replication.
サポートに情報を提供する
In case you are unable to troubleshoot and fix the problem by yourself, please create a support ticket at support.atlassian.com and attach the following information to the ticket:
ヘルス チェック結果のスクリーンショット
Collect a Support ZIP from each of the Data Centre nodes.
このドキュメントでの提案事項を受けて収集した任意の情報
この内容はお役に立ちましたか?