Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Upgrade an Online Cluster

  • concept
You can upgrade a cluster from Enterprise Analytics to Operational Insights while it continues to serve requests.

Online Upgrade at Reduced and Full Capacity

An online upgrade replaces each Enterprise Analytics node with a freshly installed Operational Insights node, using swap rebalance. The cluster serves requests throughout.

If a spare machine is available, the cluster can stay at full capacity for the whole upgrade. If not, the cluster serves requests with one node fewer, until the last node is added back.

Each step of the upgrade includes a rebalance:

A rebalance in Operational Insights reassigns which nodes serve each storage partition. It does not move data: the data stays in object storage, so a rebalance takes no longer for a cluster that holds more data. While a rebalance runs, ingestion from the cluster’s links is suspended, and it resumes when the rebalance completes.

Each node caches data files from object storage on its local disk lazily, on first access. A node that has taken over a partition in a rebalance therefore starts with none of that partition’s data cached, and the first queries that read it fetch the data from object storage, with higher latency than usual. Latency returns to normal as the node’s cache warms. This applies to the default selective cache policy and to lazy. With the eager policy, a node caches all of its data when it starts. For more information, see Memory and Caching and Scaling.

Choose the procedure that fits your cluster:

Online upgrade is available from Enterprise Analytics 2.1.x and 2.2.x, except 2.1.0-MP3. For Enterprise Analytics 2.0.x, see Upgrade Paths.

While the Cluster Is Part-Way Through an Upgrade

Until the last Enterprise Analytics node leaves the cluster, every node, including each Operational Insights node, runs the query engine of the Enterprise Analytics version that the cluster started on. New Operational Insights 3.0 features are not available until the upgrade is complete. See Feature Availability During Upgrade.

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

After that point, an Enterprise Analytics node can no longer be added to the cluster.

Product Names in a Part-Upgraded Cluster

Each node reports the product name of the software it runs. While both products are present in the cluster, the Operational Insights Web Console and the REST API show the product name of the node you’re connected to, for every node in the cluster. For example, /pools/default can list a node whose version names Enterprise Analytics next to a prodName of Operational Insights.

Scripts and tools that need to identify the product should read the prod field, which is analytics for both products, rather than prodName.