mirror of https://github.com/apache/druid.git
46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
|
---
|
||
|
|
layout: doc_page
|
||
|
|
---
|
||
|
|
|
||
|
|
|
||
|
|
Rolling Updates
|
||
|
|
===============
|
||
|
|
|
||
|
|
For rolling Druid cluster updates with no downtime, we recommend updating Druid nodes in the following order:
|
||
|
|
|
||
|
|
1. Historical Nodes
|
||
|
|
2. Indexing Service/Real-time Nodes
|
||
|
|
3. Broker Nodes
|
||
|
|
4. Coordinator Nodes
|
||
|
|
|
||
|
|
## Historical Nodes
|
||
|
|
|
||
|
|
Historical nodes can be updated one at a time. Each historical node has a startup time to memory map all the segments it was serving before the update. The startup time typically takes a few seconds to a few minutes, depending on the hardware of the node. As long as each historical node is updated with a sufficient delay (greater than the time required to start a single node), you can rolling update the entire historical cluster.
|
||
|
|
|
||
|
|
## Standalone Real-time nodes
|
||
|
|
|
||
|
|
Standalone real-time nodes can be updated one at a time in a rolling fashion.
|
||
|
|
|
||
|
|
## Indexing Service
|
||
|
|
|
||
|
|
### With Autoscaling
|
||
|
|
|
||
|
|
Overlord nodes will try to launch new middle manager nodes and terminate old ones without dropping data. This process is based on the configuration `druid.indexer.runner.minWorkerVersion=#{VERSION}`. Each time you update your overlord node, the `VERSION` value should be increased.
|
||
|
|
|
||
|
|
The config `druid.indexer.autoscale.workerVersion=#{VERSION}` also needs to be set.
|
||
|
|
|
||
|
|
### Without Autoscaling
|
||
|
|
|
||
|
|
Middle managers can be updated in a rolling fashion based on API.
|
||
|
|
|
||
|
|
To prepare a middle manager for update, send a POST request to `<MiddleManager_IP:PORT>/druid/worker/v1/disable`. The overlord will now no longer send tasks to this middle manager.
|
||
|
|
|
||
|
|
Current tasks will still try to complete. To view all existing tasks, send a GET request to `<MiddleManager_IP:PORT>/druid/worker/v1/tasks`. When this list is empty, the middle manager can be updated. After the middle manager is updated, it is automatically enabled again. You can also manually enable middle managers POSTing to `<MiddleManager_IP:PORT>/druid/worker/v1/enable`.
|
||
|
|
|
||
|
|
## Broker Nodes
|
||
|
|
|
||
|
|
Broker nodes can be updated one at a time in a rolling fashion. There needs to be some delay between updating each node as brokers must load the entire state of the cluster before they return valid results.
|
||
|
|
|
||
|
|
## Coordinator Nodes
|
||
|
|
|
||
|
|
Coordinator nodes can be updated in a rolling fashion.
|