Skip to content
This repository was archived by the owner on Dec 14, 2022. It is now read-only.

Commit c78b910

Browse files
author
Chris Wiechmann
authored
Update UPDATE.md
1 parent 8ba2913 commit c78b910

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

UPDATE.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -125,20 +125,23 @@ The solution ships the latest available Elastic version with new releases. Howev
125125
:exclamation: Before proceeding, make sure that your Elasticsearch cluster consists of __at least 3 nodes__. Please note, that two Elasticsearch nodes on one machine is perfectly fine for this.
126126
There are 3 Elasticsearch nodes required, as there must always be a master node in the cluster. If this master is stopped, a quorum of remaining cluster nodes must remain to elect a new master. [Learn more](https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-discovery-quorums.html)
127127
If you have 2 Elasticsearch nodes, then you can bring up another node using the following command:
128+
128129
```
129130
docker-compose -f elasticsearch/docker-compose.es03.yml up -d
130131
```
131-
[Read more](README.md##general-remarks) information about adding additional cluster node.
132-
After the upgrade, you can remove the third cluster node if necessary.
132+
[Read more](README.md##general-remarks) information about adding additional cluster node. After the upgrade, you can remove the third cluster node if necessary. Before proceeding, make sure that Elasticsearch is in the Green state.
133+
134+
### Elastic stack upgrade steps
135+
136+
Please follow these steps to update the Elastic version.
133137

134-
Before proceeding, make sure that Elasticsearch is in the Green state.
138+
__1. Update .env file__
135139

136-
Please follow these steps to update the Elasticversion:
137140
- Open your `.env` file and change the parameter: `ELASTIC_VERSION` to the necessary version as specified in the release or the version you would like to use
138141
- Make sure that the `.env` file contains the correct/same version on all machines
139-
- To avoid any downtime, double check all Elasticsearch clients (API-Builder, Logstash, Filebeat) have multiple or all Elasticsearch nodes configured so that they can fail over
142+
- To avoid any downtime, double check all Elasticsearch clients (API-Builder, Logstash, Filebeat) using the `ELASTICSEARCH_HOSTS` have multiple or all Elasticsearch nodes configured so that they can fail over
140143

141-
__1. Update Elasticsearch cluster__
144+
__2. Update Elasticsearch cluster__
142145

143146
Updating the Elasticsearch cluster happens one node after next. Before updating the next node it's strongly recommended that the cluster state is green and remaining nodes have enough disk space to take over the shards from the node to be upgraded.
144147
```
@@ -151,7 +154,7 @@ docker-compose -f elasticsearch/docker-compose.es01.yml up -d
151154
```
152155
Repeat these steps on the remaining Eleasticsearch nodes, but only after the Elasticsearch cluster has returned to Green status.
153156

154-
__2. Update Kibana__
157+
__3. Update Kibana__
155158

156159
It is recommended to run the entire Elastic stack with the same version, so Kibana should/must be updated as well. To update Kibana you need to perform the following steps after adjusting the `ELASTIC_VERSION` accordingly.
157160

@@ -164,7 +167,7 @@ docker-compose -f kibana/docker-compose.kibana.yml stop
164167
docker-compose -f kibana/docker-compose.kibana.yml up -d
165168
```
166169

167-
__3. Update Logstash__
170+
__4. Update Logstash__
168171

169172
It is recommended to run the entire Elastic stack with the same version, so Logstash should/must be updated as well. Same procedure as for Kibana but repeat this on all Logstash nodes.
170173
```
@@ -176,7 +179,7 @@ docker-compose stop
176179
docker-compose up -d
177180
```
178181

179-
__4. Update Filebeat__
182+
__5. Update Filebeat__
180183

181184
It is recommended to run the entire Elastic stack with the same version, so Filebeat should/must be updated as well. Same procedure as for Kibana and Logstash but repeat this on all Filebeat nodes.
182185
```

0 commit comments

Comments
 (0)