ElasticSearch migration instructions for release 2021-02-16¶
Release 2021-02-16
of wire-server
requires an update of the ElasticSearch index of brig
. During the update the team member search in TeamSettings will be defunct.
The update is triggered automatically on upgrade by the elasticsearch-index-create
and brig-index-migrate-data
jobs. If these jobs finish sucessfully the update is complete.
Troubleshooting¶
In case the elasticsearch-index-create
job fails this document describes how to create a new index.
The index that brig is using is defined at brig.config.elasticsearch.index
of the wire-server
chart. We will refer to its current setting as <OLD_INDEX>
.
- Choose a new index name that is different from
<OLD_INDEX>
. We will refer to this name as<NEW_INDEX>
. - Upgrade the release with these config changes:
- Set
brig.config.elasticsearch.additionalWriteIndex
to<NEW_INDEX>
- Set
elasticsearch-index.elasticsearch.additionalWriteIndex
to<NEW_INDEX>
and wait for completion. - Upgrade the release again with these config changes:
- Unset
brig.config.elasticsearch.additionalWriteIndex
- Unset
elasticsearch-index.elasticsearch.additionalWriteIndex
- Set
brig.config.elasticsearch.index
to<NEW_INDEX>
- Set
elasticsearch-index.elasticsearch.index
to<NEW_INDEX>