Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[8.9] Add air-gapped install instructions for Elasticsearch and Machine Learning (backport #2488) #2490

Merged
merged 2 commits into from
Jul 20, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion docs/en/install-upgrade/air-gapped-install.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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>>
Expand Down Expand Up @@ -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]]
Expand Down Expand Up @@ -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
Expand Down