> For the complete documentation index, see [llms.txt](https://platform9.com/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://platform9.com/kb/pmk/solutions/master-node-fails-to-converge-with-error-client-etcd-cluster-is.md).

# Master Node Fails to Converge with Error "client: etcd cluster is unavailable or misconfigured

## Problem

BareOS Platform9 Managed Kubernetes Cluster failed to converge with the following errors observed on one of the Master Node.

{% tabs %}
{% tab title="None" %}

```none
Error:  client: etcd cluster is unavailable or misconfigurederror #0: client: endpoint http://127.0.0.1:2379 exceeded header timeouterror #1: client: endpoint http://127.0.0.1:4001 exceeded header timeout
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="None" %}

```none
rafthttp: failed to dial fced1bcbbd9545a2 on stream Message (dial tcp 10.25.41.82:2380: getsockopt: no route to host)rafthttp: failed to dial fced1bcbbd9545a2 on stream MsgApp v2 (dial tcp 10.25.41.82:2380: getsockopt: no route to host)
```

{% endtab %}
{% endtabs %}

## Environment

* Platform9 Managed Kubernetes - All Versions

## Cause

Cluster had its VIP address configured to be the same as that of one of the Master Nodes which resulted in conflict for the cluster to converge.

## Resolution

1. Recreate the cluster with a VIP address separate from all the nodes within the cluster.
2. Refer to the following [article](https://support.platform9.com/hc/en-us/articles/360037736833-Creating-Multi-Master-BareMetal-Cluster-on-Platform9-Managed-OpenStack-VMs) which provides detailed steps on how to create a Multi Master BareOS Cluster on Platform9 Managed Kubernetes.

## Additional Information


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://platform9.com/kb/pmk/solutions/master-node-fails-to-converge-with-error-client-etcd-cluster-is.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
