From 9b4338e00de9c87aea5ccc802bff4fdc21595af3 Mon Sep 17 00:00:00 2001 From: Jorge Sanz Date: Tue, 30 Jan 2024 18:34:26 +0100 Subject: [PATCH] [Docs][EMS] Adding more details about connectivity and link to the stack docs (#175551) Related to #174716 * Adds an intro paragraph mentioning the three options regarding EMS and limited connectivity: set up a firewall, disable it fully, or install Elastic Maps Server. * Adds a reference to the Elastic Stack air-gapped guide. Co-authored-by: Brandon Morelli --- docs/maps/connect-to-ems.asciidoc | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/docs/maps/connect-to-ems.asciidoc b/docs/maps/connect-to-ems.asciidoc index 8fac6a6d95c15..879d4846ef3f1 100644 --- a/docs/maps/connect-to-ems.asciidoc +++ b/docs/maps/connect-to-ems.asciidoc @@ -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 <> or <>. + [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 <> file. [float] [id=elastic-maps-server] -=== Host Elastic Maps Service locally +=== Host {ems} locally + +NOTE: Find more details about installing Elastic components in an air-gapped environment in the {stack-ref}/air-gapped-install.html[Elastic Stack documentation]. -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. +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 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. +{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.