You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Dec 14, 2022. It is now read-only.
Copy file name to clipboardExpand all lines: UPDATE.md
+12-9Lines changed: 12 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -125,20 +125,23 @@ The solution ships the latest available Elastic version with new releases. Howev
125
125
: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.
126
126
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)
127
127
If you have 2 Elasticsearch nodes, then you can bring up another node using the following command:
128
+
128
129
```
129
130
docker-compose -f elasticsearch/docker-compose.es03.yml up -d
130
131
```
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.
133
137
134
-
Before proceeding, make sure that Elasticsearch is in the Green state.
138
+
__1. Update .env file__
135
139
136
-
Please follow these steps to update the Elasticversion:
137
140
- 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
138
141
- 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
140
143
141
-
__1. Update Elasticsearch cluster__
144
+
__2. Update Elasticsearch cluster__
142
145
143
146
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.
144
147
```
@@ -151,7 +154,7 @@ docker-compose -f elasticsearch/docker-compose.es01.yml up -d
151
154
```
152
155
Repeat these steps on the remaining Eleasticsearch nodes, but only after the Elasticsearch cluster has returned to Green status.
153
156
154
-
__2. Update Kibana__
157
+
__3. Update Kibana__
155
158
156
159
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.
docker-compose -f kibana/docker-compose.kibana.yml up -d
165
168
```
166
169
167
-
__3. Update Logstash__
170
+
__4. Update Logstash__
168
171
169
172
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.
170
173
```
@@ -176,7 +179,7 @@ docker-compose stop
176
179
docker-compose up -d
177
180
```
178
181
179
-
__4. Update Filebeat__
182
+
__5. Update Filebeat__
180
183
181
184
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.
0 commit comments