Jira Disaster Recovery Fail to Recover Index on Start up
プラットフォームについて: Data Center のみ - この記事は、Data Center プラットフォームのアトラシアン製品にのみ適用されます。
この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
問題
When performing Disaster Recovery for Jira, the Disaster Recovery node did not automatically restore an existing index using available Index Snapshot on Jira Startup.
Disaster Recovery Mode
There are three modes of Disaster Recovery
- PRIMARY - the main Jira instance, which has no special DR configuration set
- SECONDARY - the recovery instance as indicated by the
disaster.recoveryproperty being true - COLD - a secondary instance on initialization. This indicates an instance that is currently doing work to recover after which it will report itself as SECONDARY.
診断
環境
Jira Data Center
Disaster Recovery enabled with
disaster.recovery=true
Diagnostic Steps
Clarify and understand if the correct steps have been performed. To copy the Index snapshot to the respective location.
- Verify that the Index snapshot file has a naming syntax of
IndexSnapshot_* - Review the Startup logs for traces of cold or secondary instance
Problem 1
atlassian-jira.log に次のメッセージが出力される。
2019-05-15 08:31:35,294 localhost-startStop-1 ERROR [c.a.j.index.ha.DisasterRecoveryLauncher] No valid index backup found in '/nfs/sharedhome/import/indexsnapshots'Problem 2
atlassian-jira.log に次のメッセージが出力される。
2019-05-16 11:37:56,297 localhost-startStop-1 INFO [c.a.j.index.ha.DisasterRecoveryLauncher] Starting secondary instance原因
The following are the list of causes based on the problems above.
原因 1
The Index snapshot files are missing from the location of /<sharedhome>/import/indexsnapshots/ directory
原因 2
The startup is not the first startup and is already in a Secondary mode. The restore of Index snapshot from /<sharedhome>/import/indexsnapshots/ only triggered on the first startup of Disaster Recovery mode, which is as a Cold instance.
ソリューション
ソリューション 1
Refer the steps of Performing the disaster recovery testing and follow the following
- 新しいデータベースの準備ができており、最新のスナップショットを持ち、レプリケーションを持たないことを確認します。
- 適切な
dbconfig.xmlコネクションが設定されたクリーンなサーバーに Jira のコピーがあることを確認します。 - スタンバイ インスタンスと同様にテスト サーバーで
Jira_HOMEがマップされていることを確認します。Jira_HOME/export/フォルダに最新のインデックス スナップショットがあることが重要です。indexsnapshots - Ensure there is no folder of
/<sharedhome>/indexarchive/exist, if yes move out of the shared directory. - メールを無効化します。
- disaster.recovery=true パラメータを指定し、Jira をディザスタ リカバリ モードで起動します。
ソリューション 2
- Ensure there is no folder of
/<sharedhome>/indexarchive/exist, if yes move out of the shared directory. - disaster.recovery=true パラメータを指定し、Jira をディザスタ リカバリ モードで起動します。