From ae6b153ed280067ffb4c55c366419f727b742d76 Mon Sep 17 00:00:00 2001 From: Zainab Daodu Date: Mon, 12 Jan 2026 20:01:30 +0100 Subject: [PATCH 1/2] docs(self-managed): Clarify Operate data flow in 8.8 exporter section --- .../operate/operate-configuration.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md b/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md index 6a9ad106ee1..6033c0e0db8 100644 --- a/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md +++ b/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md @@ -30,17 +30,18 @@ See the [secondary storage documentation](/self-managed/components/orchestration ## Zeebe Elasticsearch or OpenSearch exporter -:::note -**Version 8.8+:** The Importer is required only for **migration scenarios** (upgrades from 8.7). Keep it enabled until all remaining 8.7 records have been imported. After that, the [Camunda Exporter](/self-managed/components/orchestration-cluster/zeebe/exporters/camunda-exporter.md) takes over and writes directly to the Operate indices. The Importer can then be safely disabled for subsequent restarts or deployments. +In 8.8+ installations, Operate reads data from Operate indices written by the +[Camunda Exporter](/self-managed/components/orchestration-cluster/zeebe/exporters/camunda-exporter.md). -New 8.8+ installations do **not** need to enable or configure the Importer. Its only purpose is to temporarily support migrations from 8.7 data. +:::note +The Operate Importer is used only during 8.7 → 8.8 migrations. +New 8.8+ installations do not require it. ::: -For Elasticsearch, Operate imports data from indices created and filled in by the [Zeebe Elasticsearch exporter](../zeebe/exporters/elasticsearch-exporter.md). - -For OpenSearch, Operate imports data from indices created and filled in by the [Zeebe OpenSearch exporter](../zeebe/exporters/opensearch-exporter.md). +During 8.7 → 8.8 migrations, Operate imports remaining historical data from indices created by the [Zeebe Elasticsearch exporter](../zeebe/exporters/elasticsearch-exporter.md) +or the [Zeebe OpenSearch exporter](../zeebe/exporters/opensearch-exporter.md). -Therefore, settings for this Elasticsearch or OpenSearch connection must be defined and must correspond to the settings on the Zeebe side. +In both cases, the Elasticsearch or OpenSearch connection settings must match the exporter configuration used by Zeebe. ### Settings to connect and import From 62b81345f982435c44120fc3a64efc207b923101 Mon Sep 17 00:00:00 2001 From: Zainab Daodu Date: Tue, 13 Jan 2026 13:33:58 +0100 Subject: [PATCH 2/2] Apply suggestions from doc review --- .../orchestration-cluster/operate/operate-configuration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md b/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md index 6033c0e0db8..544489901f1 100644 --- a/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md +++ b/versioned_docs/version-8.8/self-managed/components/orchestration-cluster/operate/operate-configuration.md @@ -34,11 +34,11 @@ In 8.8+ installations, Operate reads data from Operate indices written by the [Camunda Exporter](/self-managed/components/orchestration-cluster/zeebe/exporters/camunda-exporter.md). :::note -The Operate Importer is used only during 8.7 → 8.8 migrations. +The Operate Importer is used only during 8.7 to 8.8 migrations. New 8.8+ installations do not require it. ::: -During 8.7 → 8.8 migrations, Operate imports remaining historical data from indices created by the [Zeebe Elasticsearch exporter](../zeebe/exporters/elasticsearch-exporter.md) +During 8.7 to 8.8 migrations, Operate imports remaining historical data from indices created by the [Zeebe Elasticsearch exporter](../zeebe/exporters/elasticsearch-exporter.md) or the [Zeebe OpenSearch exporter](../zeebe/exporters/opensearch-exporter.md). In both cases, the Elasticsearch or OpenSearch connection settings must match the exporter configuration used by Zeebe.