If the **primary** and **secondary** nodes have a checksum verification mismatch, the cause may not be apparent. To find the cause of a checksum mismatch:
If the **primary** and **secondary** nodes have a checksum verification mismatch, the cause may not be apparent. To find the cause of a checksum mismatch:
1. On the **primary** node:
1. On the **primary** node:
1. On the top bar, select **Menu >****{admin}****Admin**.
1. On the top bar, select **Menu >Admin**.
1. On the left sidebar, select **Overview > Projects**.
1. On the left sidebar, select **Overview > Projects**.
1. Find the project that you want to check the checksum differences and
1. Find the project that you want to check the checksum differences and
GitLab does not allow requests to localhost or the local network by default. When running Jenkins on your local machine, you need to enable local access.
GitLab does not allow requests to localhost or the local network by default. When running Jenkins on your local machine, you need to enable local access.
1. Log into your GitLab instance as an administrator.
1. Log into your GitLab instance as an administrator.
1. On the top bar, select **Menu >****{admin}****Admin**.
1. On the top bar, select **Menu >Admin**.
1. In the left sidebar, select **Settings > Network**.
1. In the left sidebar, select **Settings > Network**.
1. Expand **Outbound requests** and check the following checkboxes:
1. Expand **Outbound requests** and check the following checkboxes:
To enable Advanced Search, you need to have admin access to GitLab:
To enable Advanced Search, you need to have admin access to GitLab:
1. On the top bar, select **Menu >****{admin}****Admin**.
1. On the top bar, select **Menu >Admin**.
1. On the left sidebar, select **Settings > Advanced Search**.
1. On the left sidebar, select **Settings > Advanced Search**.
NOTE:
NOTE:
...
@@ -286,7 +286,7 @@ You can improve the language support for Chinese and Japanese languages by utili
...
@@ -286,7 +286,7 @@ 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. On the top bar, select **Menu >****{admin}****Admin**.
1. On the top bar, select **Menu >Admin**.
1. On the left sidebar, select **Settings > Advanced Search**.
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**.
...
@@ -307,7 +307,7 @@ For guidance on what to install, see the following Elasticsearch language plugin
...
@@ -307,7 +307,7 @@ For guidance on what to install, see the following Elasticsearch language plugin
To disable the Elasticsearch integration:
To disable the Elasticsearch integration:
1. On the top bar, select **Menu >****{admin}****Admin**.
1. On the top bar, select **Menu >Admin**.
1. On the left sidebar, select **Settings > Advanced Search**.
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.
...
@@ -339,7 +339,7 @@ index alias to it which becomes the new `primary` index. At the end, we resume t
...
@@ -339,7 +339,7 @@ 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. On the top bar, select **Menu >****{admin}****Admin**.
1. On the top bar, select **Menu >Admin**.
1. On the left sidebar, select **Settings > Advanced Search**.
1. On the left sidebar, select **Settings > Advanced Search**.
1. Clear the **Pause Elasticsearch indexing** checkbox.
1. Clear the **Pause Elasticsearch indexing** checkbox.
...
@@ -558,7 +558,7 @@ For basic guidance on choosing a cluster configuration you may refer to [Elastic
...
@@ -558,7 +558,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 **Menu >****{admin}****Admin > 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 > 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