Service software updates in Amazon Elasticsearch Service - Amazon Elasticsearch Service

Service software updates in Amazon Elasticsearch Service

Note

Service software updates differ from Elasticsearch version upgrades. For information about upgrading to a later version of Elasticsearch, see Upgrading Elasticsearch.

Amazon Elasticsearch Service (Amazon ES) regularly releases system software updates that add features or otherwise improve your domains. The Notifications panel in the console is the easiest way to see if an update is available or check the status of an update. For more information, see Notifications in Amazon Elasticsearch Service.

Each notification includes details about the service software update. The notification severity is Informational if the update is optional and High if it's required. Consider the following when deciding whether to update your domain:

  • If you take no action on required updates, Amazon ES still updates your domain service software automatically after a certain timeframe (typically two weeks). In this situation, Amazon ES sends notifications when it starts the update and when the update is complete.

  • If you start an update manually, Amazon ES doesn't send a notification when it starts the update, only when the update is complete.

  • Software updates use blue/green deployments to minimizes downtime. Updates can temporarily strain a cluster's dedicated master nodes, so make sure to maintain sufficient capacity to handle the associated overhead.

Manually updating your domain lets you take advantage of new features more quickly. When you choose Update, Amazon ES places the request in a queue and begins the update when it has time. Updates typically complete within minutes, but can also take several hours or even days if your system is experiencing heavy load. Consider updating your domain at a low traffic time to avoid long update periods.

Your domain is ineligible for a service software update if it's in any of the following states:

State Description
Domain in processing

The domain is in the middle of a configuration change. Check update eligibility after the operation completes.

Red cluster status

One or more indices in the cluster is red. For troubleshooting steps, see Red cluster status.

High error rate

The Elasticsearch cluster is returning a large number of 5xx errors when attempting to process requests. This problem is usually the result of too many simultaneous read or write requests. Consider reducing traffic to the cluster or scaling your domain.

Split brain

Split brain means your Elasticsearch cluster has more than one master node and has split into two clusters that never will rejoin on their own. You can avoid split brain by using the recommended number of dedicated master nodes. For help recovering from split brain, contact AWS Support.

Amazon Cognito integration issue

Your domain uses authentication for Kibana, and Amazon ES can't find one or more Amazon Cognito resources. This problem usually occurs if the Amazon Cognito user pool is missing. To correct the issue, recreate the missing resource and configure the Amazon ES domain to use it.

Other Amazon ES service issue

Issues with Amazon ES itself might cause your domain to display as ineligible for an update. If none of the previous conditions apply to your domain and the problem persists for more than a day, contact AWS Support.

To request a service software update (console)

  1. Go to https://aws.amazon.com and choose Sign In to the Console.

  2. Under Analytics, choose Elasticsearch Service.

  3. In the navigation pane, under My domains, choose the domain you want to update.

  4. For Service software release, follow the documentation link to compare your current version to the latest version. Then choose Update.

To request a service software update (AWS CLI and AWS SDKs)

You can use the following commands to see if an update is available, check upgrade eligibility, and request an update:

  • describe-elasticsearch-domain (DescribeElasticsearchDomain)

  • start-elasticsearch-service-software-update (StartElasticsearchServiceSoftwareUpdate)

For more information, see the AWS CLI Command Reference and Configuration API reference for Amazon Elasticsearch Service.

Tip

After requesting an update, you might have a narrow window of time in which you can cancel it. The duration of this PENDING_UPDATE state can vary greatly and depends on your AWS region and the number of concurrent updates Amazon ES is performing. To cancel, use the console or stop-elasticsearch-service-software-update (StopElasticsearchServiceSoftwareUpdate) command.