> Source: https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/

# Depanare `etcd`

> **Informație**
>
> Întreaga procedură trebuie efectuată ca `root`. Pentru a vă ridica privilegiile la `root`, puteți utiliza comanda `su -`.

`etcd` este un depozit distribuit de tip cheie-valoare, utilizat ca punct de coordonare între nodurile clusterului PostgreSQL. Centralizează și partajează în mod fiabil starea clusterului, inclusiv identitatea liderului, starea membrilor și mecanismele de blocare.

`patroni` se bazează pe `etcd` pentru a coordona alegerea nodului lider și pentru a declanșa automat comutările în caz de incident. Instalat pe toate nodurile, `etcd` garantează coerența globală a clusterului, fără a participa la stocarea sau procesarea datelor PostgreSQL.

Prin urmare, `patroni` depinde de `etcd` și nu poate funcționa corect dacă `etcd` nu funcționează.

> **Informație**
>
> Configurarea `etcd` este stocată în fișierul `/etc/default/etcd` de pe fiecare nod.

## Loguri

Întreaga procedură se bazează pe logurile serviciului `etcd`, pe care le obțineți cu comanda de mai jos:

```
1
```

> **Sfat**
>
> Pentru a urmări logurile în timp real, adăugați opțiunea `-f` la comandă:
>
> ```
> 1
> ```

> **Informație**
>
> Logurile `etcd` sunt disponibile și în `/var/log/syslog`.

## Explicarea logurilor de eroare

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Dacă fluxul `TCP/2380` nu este deschis între două noduri, timpul de așteptare al conexiunii expiră, iar `etcd` scrie următoarele loguri:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Unde `<PEER_PSQL_NODE_ID>` este ID-ul atribuit de `etcd` nodului țintă, iar `<PEER_IP_PSQL_NODE>` este adresa IP a nodului țintă.
>
> > **Exemplu**
> >
> > În exemplul nostru, clusterul PostgreSQL este configurat astfel:
> >
> > | Nod | IP-ul nodului | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Executarea comenzii `journalctl -fu etcd` de pe serverul `PSQL_1` produce următoarele loguri:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Aceste loguri indică faptul că conexiunea de la serverul `PSQL_1` la serverul cu adresa IP 192.168.1.2 (`PSQL_2`) și ID-ul `etcd` 7176dd381f583d83, pe portul `TCP/2380`, nu a reușit: timpul de așteptare a expirat. Putem deduce că fluxul de la serverul `PSQL_1` către serverul `PSQL_2` este blocat (`DROP`) de un firewall.
>
> Acest flux poate fi blocat (`DROP`) de firewallul local al appliance-ului PostgreSQL: verificați [configurarea firewallului appliance-ului](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) pe nodurile implicate. Dacă această configurare este corectă, un firewall al infrastructurii blochează (`DROP`) fluxul `TCP/2380` dintre cele două noduri.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Atunci când o conexiune între două noduri este refuzată, `etcd` o semnalează prin următoarele loguri:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Unde `<PEER_PSQL_NODE_ID>` este ID-ul atribuit de `etcd` nodului țintă, iar `<PEER_IP_PSQL_NODE>` este adresa IP a nodului țintă.
>
> Refuzul poate avea mai multe cauze:
>
> - Serviciul `etcd` funcționează defectuos sau este oprit pe nodul țintă. În acest caz, verificați starea (`systemctl status etcd`) și logurile serviciului `etcd` pe acel nod.
> - Un firewall respinge (`REJECT`) fluxul `TCP/2380` dintre cele două noduri. Poate fi vorba de [firewallul local al appliance-ului](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) sau de un firewall al infrastructurii.
>
> > **Exemplu**
> >
> > În exemplul nostru, clusterul PostgreSQL este configurat astfel:
> >
> > | Nod | IP-ul nodului | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Executarea comenzii `journalctl -fu etcd` de pe serverul `PSQL_1` produce următoarele loguri:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Aceste loguri indică faptul că conexiunea de la serverul `PSQL_1` la serverul cu adresa IP 192.168.1.3 (`PSQL_3`) și ID-ul `etcd` e3d5ef565a5bb46c, pe portul `TCP/2380`, a fost refuzată.
> >
> > Pe serverul `PSQL_3`, comanda `systemctl status etcd` arată că `etcd` este oprit:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Odată ce `etcd` este pornit, problema este rezolvată.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Dacă certificatele clusterului PostgreSQL au expirat sau dacă nu au fost instalate ori reînnoite corect pe nodul de pe care citiți logurile, în logurile `etcd` apare următoarea eroare:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Unde `<PEER_IP_PSQL_NODE>` este adresa IP a unuia dintre nodurile clusterului.
>
> Acest log indică faptul că, atunci când nodul la care sunteți conectat a încercat să stabilească o conexiune cu celelalte noduri ale clusterului (`<PEER_IP_PSQL_NODE>`), acestea au refuzat-o, semnalând o eroare privind certificatul nodului curent.
>
> Prin urmare, trebuie să [verificați validitatea certificatelor clusterului](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) pe nodul la care sunteți conectat.
>
> > **Avertisment**
> >
> > Dacă autoritatea de certificare configurată pe un nod la distanță (în `/etc/etcd/ca.crt`) este incorectă, eroarea apare și pe nodul de pe care citiți logurile: ea indică atunci că nodul la distanță nu poate valida certificatul prezentat, deoarece nu dispune de CA corectă.
>
> > **Exemplu**
> >
> > În exemplul nostru, clusterul PostgreSQL este configurat astfel:
> >
> > | Nod | IP-ul nodului | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Executarea comenzii `journalctl -fu etcd` de pe serverul `PSQL_1` produce următoarele loguri:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Aceste loguri indică faptul că nodurile `PSQL_2` și `PSQL_3` au refuzat conexiunea de la nodul `PSQL_1`, deoarece certificatul lui `PSQL_1` nu este valid în acest context.
> >
> > Verificăm, prin urmare, validitatea certificatelor nodului `PSQL_1` urmând procedura de [verificare a certificatelor clusterului](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/):
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Rezultatul arată că certificatul nodului a expirat:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > În acest caz, trebuie să [reînnoiți certificatele clusterului PostgreSQL](https://docs.cyberelements.io/bastion/4.6/ro/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Dacă `etcd` nu are permisiunile corecte asupra directorului `/var/lib/etcd/cleanroom`, serviciul refuză să pornească și scrie următoarele loguri:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Pentru a rezolva această problemă, atribuiți directorului permisiunile corecte cu următoarea comandă:
>
> ```
> 1
> ```
