1. After the indexing has completed, enable **Search with Elasticsearch enabled** in
1. After the indexing has completed, enable **Search with Elasticsearch enabled** and select **Save changes**.
**Admin Area > Settings > Advanced Search** and click **Save
changes**.
NOTE:
NOTE:
When your Elasticsearch cluster is down while Elasticsearch is enabled,
When your Elasticsearch cluster is down while Elasticsearch is enabled,
...
@@ -283,7 +281,8 @@ You can improve the language support for Chinese and Japanese languages by utili
...
@@ -283,7 +281,8 @@ You can improve the language support for Chinese and Japanese languages by utili
To enable language(s) support:
To enable language(s) support:
1. Install the desired plugin(s), please refer to [Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/plugins/7.9/installation.html) for plugins installation instructions. The plugin(s) must be installed on every node in the cluster, and each node must be restarted after installation. For a list of plugins, see the table later in this section.
1. Install the desired plugin(s), please refer to [Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/plugins/7.9/installation.html) for plugins installation instructions. The plugin(s) must be installed on every node in the cluster, and each node must be restarted after installation. For a list of plugins, see the table later in this section.
1. Navigate to the **Admin Area**, then **Settings > Advanced Search**..
1. On the top bar, select **Menu >****{admin}****Admin**.
1. On the left sidebar, select **Settings > Advanced Search**.
1. Locate **Custom analyzers: language support**.
1. Locate **Custom analyzers: language support**.
1. Enable plugin(s) support for **Indexing**.
1. Enable plugin(s) support for **Indexing**.
1. Click **Save changes** for the changes to take effect.
1. Click **Save changes** for the changes to take effect.
...
@@ -303,7 +302,8 @@ For guidance on what to install, see the following Elasticsearch language plugin
...
@@ -303,7 +302,8 @@ For guidance on what to install, see the following Elasticsearch language plugin
To disable the Elasticsearch integration:
To disable the Elasticsearch integration:
1. Navigate to the **Admin Area**, then **Settings > Advanced Search**.
1. On the top bar, select **Menu >****{admin}****Admin**.
1. On the left sidebar, select **Settings > Advanced Search**.
1. Uncheck **Elasticsearch indexing** and **Search with Elasticsearch enabled**.
1. Uncheck **Elasticsearch indexing** and **Search with Elasticsearch enabled**.
1. Click **Save changes** for the changes to take effect.
1. Click **Save changes** for the changes to take effect.
1. (Optional) Delete the existing indexes:
1. (Optional) Delete the existing indexes:
...
@@ -334,7 +334,9 @@ index alias to it which becomes the new `primary` index. At the end, we resume t
...
@@ -334,7 +334,9 @@ index alias to it which becomes the new `primary` index. At the end, we resume t
To trigger the reindexing process:
To trigger the reindexing process:
1. Sign in to your GitLab instance as an administrator.
1. Sign in to your GitLab instance as an administrator.
1. Go to **Admin Area > Settings > Advanced Search > Elasticsearch zero-downtime reindexing**.
1. On the top bar, select **Menu >****{admin}****Admin**.
1. On the left sidebar, select **Settings > Advanced Search**.
1. Clear the **Pause Elasticsearch indexing** checkbox.
## Advanced Search migrations
## Advanced Search migrations
...
@@ -545,7 +553,7 @@ For basic guidance on choosing a cluster configuration you may refer to [Elastic
...
@@ -545,7 +553,7 @@ For basic guidance on choosing a cluster configuration you may refer to [Elastic
- A good guideline is to ensure you keep the number of shards per node below 20 per GB heap it has configured. A node with a 30GB heap should therefore have a maximum of 600 shards, but the further below this limit you can keep it the better. This will generally help the cluster stay in good health.
- A good guideline is to ensure you keep the number of shards per node below 20 per GB heap it has configured. A node with a 30GB heap should therefore have a maximum of 600 shards, but the further below this limit you can keep it the better. This will generally help the cluster stay in good health.
- Number of Elasticsearch shards:
- Number of Elasticsearch shards:
- Small shards result in small segments, which increases overhead. Aim to keep the average shard size between at least a few GB and a few tens of GB.
- Small shards result in small segments, which increases overhead. Aim to keep the average shard size between at least a few GB and a few tens of GB.
- Another consideration is the number of documents. To determine the number of shards to use, sum the numbers in the **Admin Area > Dashboard > Statistics** pane (the number of documents to be indexed), divide by 5 million, and add 5. For example:
- Another consideration is the number of documents. To determine the number of shards to use, sum the numbers in the **Menu >****{admin}****Admin > Dashboard > Statistics** pane (the number of documents to be indexed), divide by 5 million, and add 5. For example:
- If you have fewer than about 2,000,000 documents, use the default of 5 shards
- If you have fewer than about 2,000,000 documents, use the default of 5 shards