サーチのインデクシング
次のすべての手順を行うには、 Jira 管理者 グローバル権限 を持つユーザーとしてログインする必要があります。
Jira のインデックスを再作成
To re-index Jira:
- 画面右上で [管理] > [システム] の順に選択します。
- 詳細 > インデックス作成を選択してインデックス作成ページを開きます。
このページでは、次の2つのインデックス再作成オプションのいずれかを選択できます。
- バックグラウンドでインデックス再作成する: すべての課題のインデックス再作成をバックグラウンドで実行します。
- 全インデックスを再作成: コメントおよび変更履歴のインデックスを含むインデックス全体を削除して再作成します。
- オプション: バックグラウンドまたは全インデックス再作成。どちらを選択すべきかが不明な場合、「インデックス再作成オプション」を参照してください。
- Current node: A node on which the re-index will be performed. Available only in Jira Data Center.
- Index path: A directory where the index is stored.
インデックス再作成のオプション
選択すべきインデックス再作成オプションが不明な場合、次の情報をご確認ください。
If you have a multi-node environment, opt for a full re-index.
全インデックスの再作成 | バックグラウンドでインデックス再作成する |
---|---|
Multi-threaded, faster to complete | Single-threaded, slower to complete (especially in large enterprise instances) |
Can't be canceled once started | Can be canceled at any time |
Rebuilds the index, optimizes it, and deletes the old one | Rebuilds the index, optimizes it, and deletes the old one |
Eliminates disk fragmentation | Causes disk fragmentation |
Doesn’t affect the local node performance | Affects the local node performance |
Ensures consistency and re-indexes issues, comments, worklogs, and the history | Doesn’t guarantee consistency, since it only re-indexes issues, but not comments, worklogs, and the history |
全インデックスの再作成
Use this option when the indexes are corrupted, which may be caused by a system or disk failure. The full re-index deletes all indexes and rebuilds them.
Overall, the full re-index provides greater benefits. The only downside for this option is that it'll lock a single-node instance, making it unavailable to users during the re-index.
On a multi-node Jira Data Center, you can perform the full re-index without locking the instance. Therefore, if your Data Center instance has multiple nodes, you shouldn’t choose the background re-index. For instructions, navigate to Re-indexing Jira Data Center with no downtime.
Over time, your instance's disk becomes fragmented from normal use, which slows down your instance. Only the full re-index can address this. This means that, regardless of whether you're running a single- or multi-node instance, you should run the full re-index to address fragmentation periodically (for example, weekly or monthly).
You can also speed up a full re-index by increasing the number of threads it uses. Check Tune number of index threads to make it go faster for details.
Instances with lower data complexity also perform full re-indexes faster. Check Managing custom fields in Jira effectively for related information.
If you want to know if you need to re-index Jira after any configurations in your instance, check Reindexing in Jira after configuring an instance for tips.
バックグラウンドでインデックス再作成する
このオプションを使用すると、インデックスの再作成時に Jira インスタンスを引き続き使用可能にすることができますが、インスタンスの速度は遅くなります。このオプションを実行する必要がある場合、使用率が低い時間帯に実行してください。
In addition, your disk fragmentation increases each time you perform a Background re-index. Whenever possible, perform a project re-index instead, especially if you just performed configuration changes that only affect one project. See Re-indexing a single project for instructions.
カスタムインデックス パスの選択
インデックス パスを変更するには、Jira システム管理者グローバル権限を持つユーザーとしてログインする必要があります。
- Jira 4.2 よりも前のバージョンから XML バックアップを使用して Jira をアップグレードし、インデックス パスにカスタム ディレクトリを使用した場合、インデックス パスの場所としてこのカスタム ディレクトリを使用する (編集不可) か、既定のディレクトリを使用するかを選択できます。ただし、既定のディレクトリの使用に切り替えた後は、カスタムディレクトリ オプションを選択できなくなります。
- 既定ディレクトリの場所は、Jira アプリケーション ホーム ディレクトリの
caches/indexesV2
サブディレクトリです。
Jira インデックス用 NFS ストレージはサポートされていません。詳細は、「サポート対象プラットフォーム」を参照してください。
ダウンタイムなしで Jira Data Center のインデックスを再作成する
インデックスの整合性の維持は、Jira を常にユーザーに公開するのと同じくらい重要です。これらの手順では、ダウンタイムなしですべてのインデックスを削除および再作成する全インデックスの再作成オプションを実行できるようサポートします。
始める前に
ノードを選択し、ロード バランサから削除します。これを使用して、インデックスの再作成を実行します。
ダウンタイムなしで Jira Data Center のインデックスを再作成するには:
- 選択したノードの Jira にアクセスし、[管理] ( ) > [システム] を選択します。
- [詳細] > [インデックス作成] を選択してインデックス作成ページを開きます。[全インデックスの再作成]を実行します。
- インデックスの再作成が完了したら、Jira インスタンスにアクセスし、問題がないかどうかを確認します。
- ノードをロード バランサに追加します。
インデックスの再作成後、再作成されたインデックスはクラスター内の別のノードへ自動的に分散されます (この間、一部パフォーマンスの低下が発生する場合があります)。その間にインデックスに変更が加えられた場合は、整合性を維持するため、それらも適用されます。
インデックスのバックアップと復元
Index recovery is enabled by default and set to create index snapshots everyday at 2 am. This allows you to recover your index quickly, rather than rebuilding the index, if there is a failure. This is particularly useful if you have a large Jira installation and you cannot afford for it to be offline for long. If you have a small Jira instance, it may not be worth enabling index recovery, as rebuilding the index won't take much time.
全インデックス再作成のほうがスナップショットから復元するよりも速いかどうかは、復元されるスナップショットがどのくらい前に撮られたかなど、ファクターの数に依存します。大規模で複雑なインストール環境では、本番環境で信頼して使用できるように事前に開発/テストサーバーでこのプロセスをテストしておくべきです。
インデックス復元を有効化するには:
- [インデックス] ページに移動します (上記を参照)。
- [設定の編集] をクリックしてインデックス復元を有効化し、スナップショットの頻度を選択します。
- スナップショットは
<yourJirahome>/caches/indexesV2/snapshots
ディレクトリに保存されます。
- スナップショットは
インデックスを復元するには:
- [インデックス] ページに移動します (上記を参照)。
- 過去に保存したインデックスの名前を [ファイル名] に入力し、[復元] をクリックします。
- インデックスの復元中は Jira を利用できません。
- スナップショット撮影後にインデックス再作成に必要な設定が変更された場合、復元後にバックグラウンドでインデックス再作成を実行する必要があります。復元後は Jira が使用可能になります。
追加情報
- Jira は常に最新の 3 つのスナップショットを保持します (場所:
<yourJirahome>/caches/indexesV2/snapshots
)。古いスナップショットは自動的に削除されます。スナップショットは相当なディスク スペースを占有することがあるため、オフライン ストレージに移動するか、必要に応じて削除する必要が生じる場合があります。 - スナップショット プロセスは比較的軽量なプロセスで、システムにそれほど負荷を与えません。
- スナップショット撮影プロセスでは、インデックスサイズと同等のディスクスペースが一時的に必要になります。撮影されたスナップショットのサイズは、それぞれインデックスのサイズの約 25% です。
- すべての課題は復元中に適宜インデックスの再作成が行われます。これには、スナップショットの撮影後に追加、更新、または削除が行われた課題も含まれます。
Jira データベースを復元する必要がある場合、インデックス復元プロセスを利用して、インデックスを最新の状態にすることができます。インデックスのスナップショットは復元されるデータベース バックアップよりも前の日付でなければなりません。
単一プロジェクトのインデックス再作成
単一のプロジェクトに影響を及ぼす設定変更を行った場合、そのプロジェクトのみのインデックス再作成が可能です。インデックス再作成が必要な場合について詳細は、「主要な設定変更後のインデックス再作成」を参照してください。
Jira システム管理者権限を持っている場合は、次のように 1 つのプロジェクトのインデックスを再作成できます。
- 画面右上で [管理] () > [プロジェクト] の順に選択します。
- インデックスを再作成するプロジェクトに進みます。
- [プロジェクト設定] (左側のパネル) で [プロジェクトを再インデックス化] を選択します。
- [プロジェクトの再インデックス化を開始] を選択します。
Jira プロジェクト管理者権限を持っている場合は、次のように 1 つのプロジェクトのインデックスを再作成できます。
- 画面右下で [プロジェクト設定] () を選択します。
- [プロジェクト設定] (左側のパネル) で [プロジェクトを再インデックス化] を選択します。
- [プロジェクトの再インデックス化を開始] を選択します。
Jira でセットアップできる権限の種類の詳細については「権限の概要」をご参照ください。