|
| 1 | +--- |
| 2 | +title: Managing search indices for your instance |
| 3 | +shortTitle: Manage search indices |
| 4 | +intro: '{% data variables.product.product_name %} uses Elasticsearch to power search features, and provides tools for managing search and index behavior.' |
| 5 | +permissions: Enterprise owners can manage search indices for a {% data variables.product.prodname_ghe_server %} instance. |
| 6 | +versions: |
| 7 | + ghes: '*' |
| 8 | +type: reference |
| 9 | +topics: |
| 10 | + - Enterprise |
| 11 | + - Fundamentals |
| 12 | +--- |
| 13 | + |
| 14 | +## About search for {% data variables.product.prodname_ghe_server %} |
| 15 | + |
| 16 | +Users can search your instance to find, navigate, and understand issues, pull requests, code, and other content on {% data variables.product.product_name %}. Elasticsearch powers the search functionality on your instance. You can view the current status of Elasticsearch, and you can control search and index behavior. |
| 17 | + |
| 18 | +For more information about search for {% data variables.product.product_name %}, see "[AUTOTITLE](/search-github)." For more information about Elasticsearch, see the [Elasticsearch website](https://elastic.co). |
| 19 | + |
| 20 | +## About index management |
| 21 | + |
| 22 | +{% data variables.product.product_name %} reconciles the state of the search index with data on the instance automatically and regularly, including: |
| 23 | + |
| 24 | +- Issues, pull requests, repositories, and users in the database |
| 25 | +- Git repositories (source code) on disk |
| 26 | + |
| 27 | +In normal use, enterprise owners do not need to create new indices or schedule repair jobs. For troubleshooting or other support purposes, {% data variables.contact.github_support %} may instruct you to run a repair job. |
| 28 | + |
| 29 | +## Viewing search indices |
| 30 | + |
| 31 | +1. In the upper-right corner of any page, click {% octicon "rocket" aria-label="Site admin" %}. |
| 32 | +1. In the left sidebar, click **Search indexes**. |
| 33 | +1. Under "Index management", click the search index you want to view. |
| 34 | + |
| 35 | +## Creating a new search index |
| 36 | + |
| 37 | +1. In the upper-right corner of any page, click {% octicon "rocket" aria-label="Site admin" %}. |
| 38 | +1. In the left sidebar, click **Search indexes**. |
| 39 | +1. Next to "Index management", click **Create new index**. |
| 40 | +1. Select the **Select the index to create** dropdown, then click the search index you want to create. |
| 41 | +1. If you want the index to be searchable, select the **Make this index searchable** checkbox. |
| 42 | +1. If you want the index to be writable, select the **Make this index writable** checkbox. |
| 43 | +1. Click **Create index**. |
| 44 | + |
| 45 | +## Managing search indices |
| 46 | + |
| 47 | +When you view an existing search index in the site admin dashboard, you can perform the following actions: |
| 48 | + |
| 49 | +- Make the index searchable. |
| 50 | +- Make the index writable. |
| 51 | +- Update the index. |
| 52 | +- Delete the index. |
| 53 | +- Reset the index repair state. |
| 54 | +- Start a new index repair job. |
| 55 | +- Enable or disable index repair jobs. |
| 56 | + |
| 57 | +## Managing code search |
| 58 | + |
| 59 | +You can enable or disable both search and index operations for source code. For more information about code search, see "[AUTOTITLE](/search-github/searching-on-github/searching-code)." |
| 60 | + |
| 61 | +1. In the upper-right corner of any page, click {% octicon "rocket" aria-label="Site admin" %}. |
| 62 | +1. In the left sidebar, click **Search indexes**. |
| 63 | +1. In the "Code search" section, next to "Searching" or "Indexing", click **Enable** or **Disable**. |
| 64 | + |
| 65 | +## Repairing search indices |
| 66 | + |
| 67 | +Your instance uses repair jobs to reconcile the data, and schedules a repair job in the background when the following events occur: |
| 68 | + |
| 69 | +- A new search index is created. |
| 70 | +- Missing data needs to be backfilled. |
| 71 | +- Old search data needs to be updated. |
| 72 | + |
| 73 | +In the "Repair" section of the search index, a progress bar shows the current status of a repair job across background workers. You can ignore the value shown in the progress bar after a repair job has completed. The progress bar shows the difference between the repair offset and the highest record ID in the database, and will decrease as more repositories are added to {% data variables.location.product_location %} even though those repositories are actually indexed. |
| 74 | + |
| 75 | +To minimize the effects on I/O performance and reduce the chances of operations timing out, run the repair job during off-peak hours. As the job reconciles the search index with database and Git repository data, one CPU will be used. Monitor your system's load averages and CPU usage with a utility like `top`. If you don't notice any significant increase in resource consumption, it should also be safe to run an index repair job during peak hours. |
| 76 | + |
| 77 | +Repair jobs use a "repair offset" for parallelization. This is an offset into the database table for the record being reconciled. Multiple background jobs can synchronize work based on this offset. |
0 commit comments