Skip to content

Commit 94db0e4

Browse files
Add a note to purge the ingest-geoip plugin (#39553)
The ingest-geoip module in 6.7.0 will check for any leftover database files from the old plugin and will prevent node startup if they are present. With this commit we add a note to the breaking changes docs for 6.7.0 that instructs users to use the `--purge` option when removing the `ingest-geoip` plugin prior to upgrading to avoid this situation. Closes #39495
1 parent 8acf59b commit 94db0e4

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/reference/migration/migrate_6_7.asciidoc

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,24 @@ will result in an error. Additionally, there are two minor breaking changes here
4343
- `plugin.mandatory` is no longer compatible with `ingest-geoip` nor
4444
`ingest-user-agent`
4545

46+
Elasticsearch 6.7.0 checks that there are no leftover geoip database files in
47+
the plugin configuration directory because the new module does not use them.
48+
Therefore, remove the `ingest-geoip` plugin prior to upgrading to 6.7.0 with
49+
the `--purge` option to also delete the old database files:
50+
51+
[source,sh]
52+
------------------------------------------------------
53+
./bin/elasticsearch-plugin remove --purge ingest-geoip
54+
------------------------------------------------------
55+
56+
Otherwise you will see the following error message upon startup (assuming
57+
`/etc/elasticsearch/ingest-geoip` as the plugin configuration directory):
58+
59+
[source,text]
60+
---------------------------------------------------------------------------------------
61+
expected database [GeoLite2-ASN.mmdb] to not exist in [/etc/elasticsearch/ingest-geoip]
62+
---------------------------------------------------------------------------------------
63+
4664

4765
[float]
4866
[[breaking_67_settings_changes]]

0 commit comments

Comments
 (0)