OpenSearch might fail to upgrade to version 3.3.2 properly when you upgrade SAS® Viya® to stable 2026.02 or later


OpenSearch was upgraded to version 3.3.2 in SAS Viya stable 2026.02. When you upgrade your existing SAS Viya environment from an earlier version to stable 2026.02 or later, the platform upgrade might succeed, but the underlying OpenSearch version upgrade to 3.3.2 might fail. This issue typically occurs in long-running OpenSearch clusters (potentially starting with OpenSearch version 1.x on a SAS Viya version earlier than LTS 2023.03) that have to be upgraded to 3.3.2 on top of the platform upgrade to stable 2026.02 or later. 

When the underlying OpenSearch upgrade to version 3.3.2 fails, your sas-opendistro-* pod(s) might display 1/1 "Ready", but the logs contain an error similar to the following:

org.opensearch.bootstrap.StartupException: java.lang.IllegalStateException: The index [[.opendistro_security/...]] was created with version [1.3.6] but the minimum compatible version is [2.0.0]. It should be re-indexed in OpenSearch 2.x before upgrading to 3.3.2

When you try to use solutions or web applications such as SAS® Visual Investigator and SAS® Information Catalog that use OpenSearch for search and indexing operations, errors might occur because the solutions or web applications cannot talk to OpenSearch. Here are two example scenarios: 

This issue occurs due to some known issues and bugs in the third-party open-source OpenSearch software.

Workaround

To circumvent this issue, remove and redeploy the OpenSearch cluster and its Persistent Volume Claim (PVC), which should re-create the entire OpenSearch cluster from scratch at version 3.3.2. Note that this workaround results in the loss of existing indices, but you can recover those indices later via a full reindex of everything after the cluster successfully redeploys.

Complete the following steps:

  1. IMPORTANT: Take a full-system backup of the entire environment, including the existing OpenSearch PVs/PVCs before proceeding. See SAS® Viya® Platform: Backup and Restore for more information.
  2. Remove the OpenSearch cluster by following the Remove an OpenSearch Cluster Resource section of OpenSearch. Ensure that you also delete the OpenSearch PVC. 
  3. Redeploy using the same method that you originally used to deploy the environment. See General Process for more information. Completing this step should redeploy the OpenSearch cluster.
  4. Restart pods that depend on or communicate with OpenSearch so that their connection to OpenSearch refreshes after the redeploy of the OpenSearch cluster. Here is an example: For SAS Visual Investigator, restart the sas-svi-sand, sas-svi-indexer, and sas-svi-datahub pods. For SAS Information Catalog, restart the sas-catalog-services pod.  
  5. Run a full re-index of everything via solutions or web applications that use OpenSearch so that you can recover the OpenSearch indices that you lost due to the deletion of the cluster in Step 2. For example, run a full-reindex of everything from SAS Visual Investigator, and run the rebuild index jobs for all the indices from SAS Information Catalog.