Skip to content
This repository has been archived by the owner on Dec 13, 2023. It is now read-only.

Improve Elasticsearch-related problems description #3417

Merged
merged 1 commit into from
Feb 24, 2023
+10 −9
Merged

Improve Elasticsearch-related problems description #3417

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 10 additions & 9 deletions docs/docs/gettingstarted/docker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -134,21 +134,21 @@ docker build -t conductor:serverAndUI -f serverAndUI/Dockerfile ../

1. As of writing this article, Conductor relies on 6.8.x version of Elasticsearch. This version doesn't have an
arm64 based Docker image. You will need to use Elasticsearch 7.x which requires a bit of customization to get up
and running
and running

#### Elasticsearch remains in Yellow health

1. When you run Elasticsearch, sometimes the health remains in Yellow state. Conductor server by default requires
Green state to run when indexing is enabled. To work around this, you can use the following property:
`conductor.elasticsearch.clusterHealthColor=yellow` Reference: [Issue 2262](https://github.com/Netflix/conductor/issues/2262)
#### Elasticsearch remains in yellow health state

When you run Elasticsearch, sometimes the health remains in the *yellow* state. Conductor server by default requires
*green* state to run when indexing is enabled. To work around this, you can use the following property: `conductor.elasticsearch.clusterHealthColor=yellow`.

Reference: [Issue 2262][issue2262]

#### Elasticsearch timeout
Standalone(single node) elasticsearch has a yellow status which will cause timeout for conductor server (Required: Green).
Spin up a cluster (more than one) to prevent timeout or use config option `conductor.elasticsearch.clusterHealthColor=yellow`.

See issue: https://github.com/Netflix/conductor/issues/2262
By default, a standalone (single node) Elasticsearch has a *yellow* status which will cause timeout (`java.net.SocketTimeoutException`) for Conductor server (required status is *green*).
Spin up a cluster (more than one node) to prevent the timeout or use config option `conductor.elasticsearch.clusterHealthColor=yellow`.

Reference: [Issue 2262][issue2262]

#### Changes in config-*.properties do not take effect
Config is copy into image during docker build. You have to rebuild the image or better, link a volume to it to reflect new changes.
Expand All @@ -172,3 +172,4 @@ Elasticsearch is optional, please be aware that disable it will make most of the
* Comment out all the config related to elasticsearch
E.g.: `conductor.elasticsearch.url=http://es:9200`

[issue2262]: https://github.com/Netflix/conductor/issues/2262