Feature Availability During Upgrade

  • concept
While an online upgrade is in progress, the cluster runs the query engine of the Enterprise Analytics version it started on, and new Operational Insights features are not available.

Understanding Feature Availability

During an online upgrade, the cluster runs in mixed mode: some nodes run Enterprise Analytics, and others run Operational Insights.

In mixed mode, every node runs the query engine of the Enterprise Analytics version the cluster started on, including the Operational Insights nodes. The cluster behaves as that Enterprise Analytics version, and none of the features introduced in Operational Insights 3.0 can be used, on any node.

Shortly after the last Enterprise Analytics node leaves the cluster, the cluster moves to Operational Insights 3.0. The Analytics Service restarts on every node to switch to the new version, and requests that are running at that moment fail and can be retried. From then on, all Operational Insights 3.0 features are available.

To check whether the cluster has moved to Operational Insights 3.0, read the compatibility version that each node reports, which is 3.0.0 once the upgrade is complete:

curl -s -u ${USERNAME}:${PASSWORD} http://${CLUSTER_NODE}:8091/pools/default \
  | jq -r '.nodes[].prodCompatVersion'

An offline upgrade has no mixed-mode period: the cluster comes back online as Operational Insights 3.0.

Operational Insights 3.0 Features

The following features become available only when the upgrade is complete. For details of each, see Operational Insights Release Notes.

Feature Usable in Mixed Mode

Vector indexes and vector functions

No

CLUSTER BY clause

No

Python user-defined functions

No

Multi-statement requests

No

Query plan cache

No

Sampling without a full scan, for ANALYZE COLLECTION

No

Hash-based distinct count

No

Adding Nodes During and After an Upgrade

While the upgrade is in progress, you can add both Enterprise Analytics and Operational Insights nodes to the cluster.

After the cluster has moved to Operational Insights 3.0, Enterprise Analytics nodes can no longer be added to it.