mirror of
https://github.com/elastic/kibana.git
synced 2025-04-24 09:48:58 -04:00
[8.12] [Docs][EMS] Adding more details about connectivity and link to the stack docs (#175551) (#175918)
# Backport This will backport the following commits from `main` to `8.12`: - [[Docs][EMS] Adding more details about connectivity and link to the stack docs (#175551)](https://github.com/elastic/kibana/pull/175551) <!--- Backport version: 9.4.3 --> ### Questions ? Please refer to the [Backport tool documentation](https://github.com/sqren/backport) <!--BACKPORT [{"author":{"name":"Jorge Sanz","email":"jorge.sanz@elastic.co"},"sourceCommit":{"committedDate":"2024-01-30T17:34:26Z","message":"[Docs][EMS] Adding more details about connectivity and link to the stack docs (#175551)\n\nRelated to #174716\r\n\r\n* Adds an intro paragraph mentioning the three options regarding EMS and\r\nlimited connectivity: set up a firewall, disable it fully, or install\r\nElastic Maps Server.\r\n* Adds a reference to the Elastic Stack air-gapped guide.\r\n\r\nCo-authored-by: Brandon Morelli <brandon.morelli@elastic.co>","sha":"e69e971fb4a8f09b53ea75c61a22882c2f3ac207","branchLabelMapping":{"^v8.13.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Presentation","release_note:skip","docs","backport:all-open","Feature:Maps","v8.12.0","v8.13.0"],"title":"[Docs][EMS] Adding more details about connectivity and link to the stack docs","number":175551,"url":"https://github.com/elastic/kibana/pull/175551","mergeCommit":{"message":"[Docs][EMS] Adding more details about connectivity and link to the stack docs (#175551)\n\nRelated to #174716\r\n\r\n* Adds an intro paragraph mentioning the three options regarding EMS and\r\nlimited connectivity: set up a firewall, disable it fully, or install\r\nElastic Maps Server.\r\n* Adds a reference to the Elastic Stack air-gapped guide.\r\n\r\nCo-authored-by: Brandon Morelli <brandon.morelli@elastic.co>","sha":"e69e971fb4a8f09b53ea75c61a22882c2f3ac207"}},"sourceBranch":"main","suggestedTargetBranches":["8.12"],"targetPullRequestStates":[{"branch":"8.12","label":"v8.12.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.13.0","branchLabelMappingKey":"^v8.13.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/175551","number":175551,"mergeCommit":{"message":"[Docs][EMS] Adding more details about connectivity and link to the stack docs (#175551)\n\nRelated to #174716\r\n\r\n* Adds an intro paragraph mentioning the three options regarding EMS and\r\nlimited connectivity: set up a firewall, disable it fully, or install\r\nElastic Maps Server.\r\n* Adds a reference to the Elastic Stack air-gapped guide.\r\n\r\nCo-authored-by: Brandon Morelli <brandon.morelli@elastic.co>","sha":"e69e971fb4a8f09b53ea75c61a22882c2f3ac207"}}]}] BACKPORT--> Co-authored-by: Jorge Sanz <jorge.sanz@elastic.co>
This commit is contained in:
parent
c42dd980f0
commit
08432b25ef
1 changed files with 14 additions and 8 deletions
|
@ -1,14 +1,17 @@
|
|||
[[maps-connect-to-ems]]
|
||||
== Connect to Elastic Maps Service
|
||||
|
||||
:ems: Elastic Maps Service
|
||||
:ems-docker-repo: docker.elastic.co/elastic-maps-service/elastic-maps-server-ubi8
|
||||
:ems-docker-image: {ems-docker-repo}:{version}
|
||||
:ems-headers-url: https://deployment-host
|
||||
|
||||
https://www.elastic.co/elastic-maps-service[Elastic Maps Service (EMS)] is a service that hosts
|
||||
[[maps-connect-to-ems]]
|
||||
== Connect to {ems}
|
||||
|
||||
https://www.elastic.co/elastic-maps-service[{ems} (EMS)] is a service that hosts
|
||||
tile layers and vector shapes of administrative boundaries.
|
||||
If you are using Kibana's out-of-the-box settings, Maps is already configured to use EMS.
|
||||
|
||||
If you are on a restricted or fully air-gapped environment, you may need to configure your firewall to enable access to EMS resources. Find below details on the domains and HTTP headers used by {ems}. Alternatively, {ems} can be <<disable-ems, disabled>> or <<elastic-maps-server, installed locally>>.
|
||||
|
||||
[float]
|
||||
=== Domains
|
||||
|
||||
|
@ -57,7 +60,8 @@ include::headers/file-data.asciidoc[]
|
|||
|
||||
|
||||
[float]
|
||||
=== Disable Elastic Maps Service
|
||||
[id=disable-ems]
|
||||
=== Disable {ems}
|
||||
|
||||
You might experience EMS connection issues if your Kibana server or browser are on a private network or
|
||||
behind a firewall. If this happens, you can disable the EMS connection to avoid unnecessary EMS requests.
|
||||
|
@ -69,11 +73,13 @@ To disable EMS, change your <<settings, kibana.yml>> file.
|
|||
|
||||
[float]
|
||||
[id=elastic-maps-server]
|
||||
=== Host Elastic Maps Service locally
|
||||
=== Host {ems} locally
|
||||
|
||||
If you cannot connect to Elastic Maps Service from the {kib} server or browser clients, and your cluster has the appropriate license level, you can opt to host the service on your own infrastructure.
|
||||
NOTE: Find more details about installing Elastic components in an air-gapped environment in the {stack-ref}/air-gapped-install.html[Elastic Stack documentation].
|
||||
|
||||
{hosted-ems} is a self-managed version of Elastic Maps Service offered as a Docker image that provides both the EMS basemaps and EMS boundaries. The image is bundled with basemaps up to zoom level 8. After connecting it to your {es} cluster for license validation, you have the option to download and configure a more detailed basemaps database.
|
||||
If you cannot connect to {ems} from the {kib} server or browser clients, and your cluster has the appropriate license level, you can opt to host the service on your own infrastructure.
|
||||
|
||||
{hosted-ems} is a self-managed version of {ems} offered as a Docker image that provides both the EMS basemaps and EMS boundaries. The image is bundled with basemaps up to zoom level 8. After connecting it to your {es} cluster for license validation, you have the option to download and configure a more detailed basemaps database.
|
||||
|
||||
You can use +docker pull+ to download the {hosted-ems} image from the Elastic Docker registry.
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue