handle upgrade path

elastic · Feb 28, 2025 · f061396 · f061396
1 parent 545f770
commit f061396
Show file tree

Hide file tree

Showing 5 changed files with 15 additions and 2 deletions.
diff --git a/packages/entityanalytics_okta/_dev/build/docs/README.md b/packages/entityanalytics_okta/_dev/build/docs/README.md
@@ -6,6 +6,12 @@ This [Okta Entity Analytics](https://www.okta.com/) integration allows users to
 
 This module has been tested against the Core Okta API version **v1**.
 
+## Upgrading to v2 from v1
+
+In v2 of the integration the user and device data was split into separate data streams. The data ingested into your index will be the same but you may need to update device searches if you were using them.
+
+**NOTE**: When you upgrade from v1 you will need to reconfigure the integration and enable it due to internal changes in the package.
+
 ## Data streams
 
 The Okta Entity Analytics integration collects two types of data: user and device.

diff --git a/packages/entityanalytics_okta/changelog.yml b/packages/entityanalytics_okta/changelog.yml
@@ -1,5 +1,5 @@
 # newer versions go on top
-- version: "1.9.0"
+- version: "2.0.0"
   changes:
     - description: Split user and device data into their own data streams.
       type: enhancement

diff --git a/packages/entityanalytics_okta/data_stream/entity/manifest.yml b/packages/entityanalytics_okta/data_stream/entity/manifest.yml
@@ -4,6 +4,7 @@ type: logs
 streams:
   - input: entity-analytics
     title: User Identities logs
+    enabled: false
     description: Collect User Identities logs from Okta.
     template_path: entity-analytics.yml.hbs
     vars:

diff --git a/packages/entityanalytics_okta/docs/README.md b/packages/entityanalytics_okta/docs/README.md
@@ -6,6 +6,12 @@ This [Okta Entity Analytics](https://www.okta.com/) integration allows users to
 
 This module has been tested against the Core Okta API version **v1**.
 
+## Upgrading to v2 from v1
+
+In v2 of the integration the user and device data was split into separate data streams. The data ingested into your index will be the same but you may need to update device searches if you were using them.
+
+**NOTE**: When you upgrade from v1 you will need to reconfigure the integration and enable it due to internal changes in the package.
+
 ## Data streams
 
 The Okta Entity Analytics integration collects two types of data: user and device.

diff --git a/packages/entityanalytics_okta/manifest.yml b/packages/entityanalytics_okta/manifest.yml
@@ -1,7 +1,7 @@
 format_version: "3.0.2"
 name: entityanalytics_okta
 title: Okta Entity Analytics
-version: "1.9.0"
+version: "2.0.0"
 description: "Collect Identities from Okta with Elastic Agent."
 type: integration
 categories: