From 6ae24c02d57a75638e51c10e2dfdac6229e7c0ee Mon Sep 17 00:00:00 2001 From: ash9146 <52308288+ash9146@users.noreply.github.com> Date: Fri, 31 Jul 2026 16:06:23 +0900 Subject: [PATCH] Clarify Upgrade Assistant works in air-gapped environments The Upgrade Assistant's deprecation detection relies entirely on local Elasticsearch and Kibana APIs (the ES deprecation info API, ES deprecation logs, and the Kibana deprecations API - see the Deprecations section on this page), with no external service dependency. This wasn't stated anywhere on this page, plan-upgrade.md, prepare-to-upgrade.md, or troubleshooting-upgrade-assistant.md, even though the repo already has established air-gapped documentation elsewhere (e.g. prebuilt-rules-airgapped.md) using this exact terminology. Added a note near the top of the page so readers evaluating whether this tool fits an air-gapped/restricted-network environment see this upfront, rather than having to infer it from the API sources listed further down. --- deploy-manage/upgrade/prepare-to-upgrade/upgrade-assistant.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/deploy-manage/upgrade/prepare-to-upgrade/upgrade-assistant.md b/deploy-manage/upgrade/prepare-to-upgrade/upgrade-assistant.md index 8056848d24..905d202725 100644 --- a/deploy-manage/upgrade/prepare-to-upgrade/upgrade-assistant.md +++ b/deploy-manage/upgrade/prepare-to-upgrade/upgrade-assistant.md @@ -17,6 +17,10 @@ The Upgrade Assistant helps you [prepare to upgrade](/deploy-manage/upgrade/prep To access the assistant, go to the **Upgrade Assistant** management page in the navigation menu or use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md). +::::{note} +The Upgrade Assistant relies only on local {{es}} and {{kib}} APIs (see [Deprecations](#_deprecations) below) to detect deprecations and prepare your cluster for upgrade — it doesn't depend on any external service. This means you can use it even in air-gapped environments without internet access. +:::: + ::::{tip} Upgrade assistant should be run from the latest minor release before a major upgrade. When upgrading to 9.x, ensure you run 8.19.latest, and run the assistant there. Running the latest patched version of 8.19 will apply latest version of the upgrade assistant logic.