[Docs] Include MaxMind license key configuration requirement for GeoIP database for 9.x versions

Open
#3,302 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
55/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
elasticsearch
Domain
documentation

Research direction

Open the current GeoIP database API documentation and compare it with the linked 8.15 page. Add the missing MaxMind license-key secure-setting, cluster-wide, validation, and restart guidance, then verify that the configuration requirements are clear in the rendered documentation.

Written by the indexing model from the issue text.

Description

Please update the GeoIP database API documentation to include the same guidance that existed in earlier documentation versions regarding MaxMind commercial license keys.

The following information appears in the 8.15 docs but is missing or unclear in newer versions:

The MaxMind account ID requires a license key. Because the license key is sensitive information, it must be stored as a secure setting in Elasticsearch named `ingest.geoip.downloader.maxmind.license_key`. Only one MaxMind license key is allowed per Elasticsearch cluster. A valid license key must be present in the secure settings to download databases from MaxMind. The license key setting does not take effect until all nodes are restarted.

Previous documentation (8.15): https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-geoip-database-api.html

Dominant language
Ruby
Stars
265
Forks
347
Avg merge
3d 15h
Merged PRs (30d)
2

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from elastic/docs

All issues in elastic/docs

Similar issues

More Ruby issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.