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

# `etcd` trikčių šalinimas

> **Informacija**
>
> Visą procedūrą reikia atlikti kaip `root`. Norėdami padidinti savo teises iki `root`, galite naudoti komandą `su -`.

`etcd` – tai paskirstytoji raktų ir reikšmių saugykla, naudojama kaip PostgreSQL klasterio mazgų koordinavimo taškas. Ji patikimai centralizuoja ir bendrina klasterio būseną, įskaitant lyderio tapatybę, narių būseną ir užrakinimo mechanizmus.

`patroni` remiasi `etcd`, kad valdytų lyderio mazgo rinkimus ir, įvykus incidentui, automatiškai inicijuotų perjungimą po gedimo. Įdiegta visuose mazguose, `etcd` užtikrina bendrą klasterio nuoseklumą, nedalyvaudama saugant ar apdorojant PostgreSQL duomenų.

Todėl `patroni` priklauso nuo `etcd` ir negali tinkamai veikti, jei `etcd` neveikia.

> **Informacija**
>
> `etcd` konfigūracija saugoma kiekvieno mazgo faile `/etc/default/etcd`.

## Logs

Visa procedūra remiasi paslaugos `etcd` žurnalais, kuriuos gaunate toliau pateikta komanda:

```
1
```

> **Patarimas**
>
> Norėdami stebėti žurnalus realiuoju laiku, pridėkite prie komandos parinktį `-f`:
>
> ```
> 1
> ```

> **Informacija**
>
> `etcd` žurnalai taip pat pasiekiami faile `/var/log/syslog`.

## Klaidų žurnalų paaiškinimai

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Jei srautas `TCP/2380` tarp dviejų mazgų neatidarytas, baigiasi ryšio skirtasis laikas ir `etcd` įrašo šiuos žurnalo įrašus:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Čia `<PEER_PSQL_NODE_ID>` – `etcd` tiksliniam mazgui priskirtas ID, o `<PEER_IP_PSQL_NODE>` – tikslinio mazgo IP adresas.
>
> > **Pavyzdys**
> >
> > Mūsų pavyzdyje PostgreSQL klasteris sukonfigūruotas taip:
> >
> > | Mazgas | Mazgo IP | `etcd` ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Paleidus komandą `journalctl -fu etcd` serveryje `PSQL_1`, gaunami šie žurnalo įrašai:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Šie žurnalo įrašai rodo, kad ryšys iš serverio `PSQL_1` su serveriu, kurio IP adresas 192.168.1.2 (`PSQL_2`), o `etcd` ID – 7176dd381f583d83, prievadu `TCP/2380` nebuvo užmegztas: baigėsi skirtasis laikas. Galima daryti išvadą, kad srautą iš serverio `PSQL_1` į serverį `PSQL_2` išmeta (`DROP`) ugniasienė.
>
> Šį srautą gali išmesti (`DROP`) vietinė PostgreSQL appliance ugniasienė: patikrinkite susijusių mazgų [appliance ugniasienės konfigūraciją](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/). Jei ši konfigūracija teisinga, srautą `TCP/2380` tarp dviejų mazgų išmeta (`DROP`) infrastruktūros ugniasienė.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Kai ryšys tarp dviejų mazgų atmetamas, `etcd` praneša apie tai šiais žurnalo įrašais:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Čia `<PEER_PSQL_NODE_ID>` – `etcd` tiksliniam mazgui priskirtas ID, o `<PEER_IP_PSQL_NODE>` – tikslinio mazgo IP adresas.
>
> Atmetimo priežasčių gali būti kelios:
>
> - Paslauga `etcd` tiksliniame mazge veikia netinkamai arba yra sustabdyta. Tokiu atveju patikrinkite to mazgo paslaugos `etcd` būseną (`systemctl status etcd`) ir žurnalus.
> - Ugniasienė atmeta (`REJECT`) srautą `TCP/2380` tarp dviejų mazgų. Tai gali būti [vietinė appliance ugniasienė](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) arba infrastruktūros ugniasienė.
>
> > **Pavyzdys**
> >
> > Mūsų pavyzdyje PostgreSQL klasteris sukonfigūruotas taip:
> >
> > | Mazgas | Mazgo IP | `etcd` ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Paleidus komandą `journalctl -fu etcd` serveryje `PSQL_1`, gaunami šie žurnalo įrašai:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Šie žurnalo įrašai rodo, kad ryšys iš serverio `PSQL_1` su serveriu, kurio IP adresas 192.168.1.3 (`PSQL_3`), o `etcd` ID – e3d5ef565a5bb46c, prievadu `TCP/2380` buvo atmestas.
> >
> > Serveryje `PSQL_3` komanda `systemctl status etcd` rodo, kad `etcd` sustabdyta:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Paleidus `etcd`, problema išsprendžiama.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Jei PostgreSQL klasterio sertifikatų galiojimas baigėsi arba jie buvo netinkamai įdiegti ar atnaujinti mazge, kurio žurnalus skaitote, `etcd` žurnaluose rodoma ši klaida:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Čia `<PEER_IP_PSQL_NODE>` – vieno iš klasterio mazgų IP adresas.
>
> Šis žurnalo įrašas rodo, kad kai mazgas, prie kurio esate prisijungę, bandė užmegzti ryšį su kitais klasterio mazgais (`<PEER_IP_PSQL_NODE>`), šie jį atmetė, pranešdami apie dabartinio mazgo sertifikato klaidą.
>
> Todėl mazge, prie kurio esate prisijungę, [patikrinkite klasterio sertifikatų galiojimą](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/).
>
> > **Perspėjimas**
> >
> > Jei nuotoliniame mazge sukonfigūruota sertifikavimo institucija (faile `/etc/etcd/ca.crt`) neteisinga, klaida taip pat rodoma mazge, kurio žurnalus skaitote: tada ji reiškia, kad nuotolinis mazgas negali patikrinti pateikto sertifikato, nes neturi tinkamos CA.
>
> > **Pavyzdys**
> >
> > Mūsų pavyzdyje PostgreSQL klasteris sukonfigūruotas taip:
> >
> > | Mazgas | Mazgo IP | `etcd` ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Paleidus komandą `journalctl -fu etcd` serveryje `PSQL_1`, gaunami šie žurnalo įrašai:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Šie žurnalo įrašai rodo, kad mazgai `PSQL_2` ir `PSQL_3` atmetė mazgo `PSQL_1` ryšį, nes `PSQL_1` sertifikatas šiame kontekste negalioja.
> >
> > Todėl patikriname mazgo `PSQL_1` sertifikatų galiojimą pagal [klasterio sertifikatų tikrinimo](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) procedūrą:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Išvestis rodo, kad mazgo sertifikato galiojimas baigėsi:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Tokiu atveju turite [atnaujinti PostgreSQL klasterio sertifikatus](https://docs.cyberelements.io/bastion/4.6/lt/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Jei `etcd` neturi tinkamų leidimų katalogui `/var/lib/etcd/cleanroom`, paslauga nepasileidžia ir įrašo šiuos žurnalo įrašus:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Norėdami išspręsti šią problemą, šia komanda suteikite katalogui tinkamus leidimus:
>
> ```
> 1
> ```
