From ca0ead9895f201998abefb1e9910b0d1766ae792 Mon Sep 17 00:00:00 2001
From: Abdon Pijpelink <abdon.pijpelink@elastic.co>
Date: Wed, 19 Jul 2023 18:08:35 +0200
Subject: [PATCH] Add air-gapped install instructions for Elasticsearch and
 Machine Learning (#2488)

* Add air-gapped install instructions for Elasticsearch and Machine Learning

* Add ToC entry for ML section

---------

Co-authored-by: David Kilfoyle <david.kilfoyle@elastic.co>
(cherry picked from commit fe1df9e7ca76f2726a0c57fd20497528bdf28759)
---
 .../install-upgrade/air-gapped-install.asciidoc | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/docs/en/install-upgrade/air-gapped-install.asciidoc b/docs/en/install-upgrade/air-gapped-install.asciidoc
index 3137da29d..f109bd850 100644
--- a/docs/en/install-upgrade/air-gapped-install.asciidoc
+++ b/docs/en/install-upgrade/air-gapped-install.asciidoc
@@ -17,6 +17,7 @@ Some components of the {stack} require additional configuration and local depend
 ** <<air-gapped-elastic-package-registry>>
 ** <<air-gapped-elastic-artifact-registry>>
 ** <<air-gapped-elastic-endpoint-artifact-repository>>
+** <<air-gapped-machine-learning>>
 
 // Kubernetes and Open Shift
 * <<air-gapped-kubernetes-and-openshift>>
@@ -49,7 +50,12 @@ Refer to the section for each Elastic component for air-gapped installation conf
 [[air-gapped-elasticsearch]]
 ==== 1.1. {es}
 
-Air-gapped install of {es} is fairly straightforward, as this component does not have any default dependencies on other services. Detailed install and configuration instructions are available in the {ref}/install-elasticsearch.html[{es} install documentation].
+Air-gapped install of {es} may require additional steps in order to access some of the features. General install and configuration guides are available in the {ref}/install-elasticsearch.html[{es} install documentation].
+
+Specifically:
+
+* To be able to use the GeoIP processor, refer to {ref}/geoip-processor.html#manually-update-geoip-databases[the GeoIP processor documentation] for instructions on downloading and deploying the required databases.
+* Refer to <<air-gapped-machine-learning,{ml-cap}>> for instructions on deploying the Elastic Learned Sparse EncodeR (ELSER) natural language processing (NLP) model and other trained {ml} models.
 
 [discrete]
 [[air-gapped-kibana]]
@@ -145,6 +151,15 @@ NOTE: When setting up own web server, such as NGINX, to function as the {artifac
 
 Air-gapped setup of this component is, essentially, identical to the setup of the <<air-gapped-elastic-artifact-registry,{artifact-registry}>> except that different artifacts are served. To learn more, refer to {security-guide}/offline-endpoint.html[Configure offline endpoints and air-gapped environments] in the Elastic Security guide.
 
+[discrete]
+[[air-gapped-machine-learning]]
+==== 1.13 {ml-cap}
+
+Some {ml} features, like natural language processing (NLP), require you to deploy trained models. To learn about deploying {ml} models in an air-gapped environment, refer to:
+
+* {ml-docs}/ml-nlp-elser.html#air-gapped-install[Deploy ELSER in an air-gapped environment].
+* {eland-docs}/machine-learning.html#ml-nlp-pytorch-air-gapped[Install trained models in an air-gapped environment with Eland].
+
 [discrete]
 [[air-gapped-kubernetes-and-openshift]]
 === 2. Kubernetes & OpenShift Install