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

# `etcd` problēmu novēršana

> **Informācija**
>
> Visa procedūra jāveic kā `root`. Lai paaugstinātu savas privilēģijas līdz `root`, varat izmantot komandu `su -`.

`etcd` ir izkliedēta atslēgu un vērtību glabātuve, ko izmanto kā koordinācijas punktu starp PostgreSQL klastera mezgliem. Tā droši centralizē un koplieto klastera stāvokli, tostarp līdera identitāti, dalībnieku stāvokli un bloķēšanas mehānismus.

`patroni` izmanto `etcd`, lai vadītu līdera mezgla ievēlēšanu un incidenta gadījumā automātiski aktivizētu kļūmjpārlēci. `etcd` ir instalēts visos mezglos un garantē klastera vispārējo konsekvenci, nepiedaloties PostgreSQL datu glabāšanā vai apstrādē.

Tāpēc `patroni` ir atkarīgs no `etcd` un nevar pareizi darboties, ja `etcd` nedarbojas.

> **Informācija**
>
> `etcd` konfigurācija katrā mezglā tiek glabāta failā `/etc/default/etcd`.

## Logs

Visa procedūra balstās uz pakalpojuma `etcd` žurnāliem, kurus iegūstat ar tālāk norādīto komandu:

```
1
```

> **Padoms**
>
> Lai sekotu žurnāliem reāllaikā, pievienojiet komandai opciju `-f`:
>
> ```
> 1
> ```

> **Informācija**
>
> `etcd` žurnāli ir pieejami arī failā `/var/log/syslog`.

## Kļūdu žurnālu skaidrojumi

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Ja plūsma `TCP/2380` starp diviem mezgliem nav atvērta, savienojumam iestājas noildze un `etcd` ieraksta šādus žurnāla ierakstus:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Kur `<PEER_PSQL_NODE_ID>` ir ID, ko `etcd` piešķīris mērķa mezglam, un `<PEER_IP_PSQL_NODE>` ir mērķa mezgla IP adrese.
>
> > **Piemērs**
> >
> > Mūsu piemērā PostgreSQL klasteris ir konfigurēts šādi:
> >
> > | Mezgls | Mezgla IP adrese | `etcd` ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Izpildot komandu `journalctl -fu etcd` serverī `PSQL_1`, tiek iegūti šādi žurnāla ieraksti:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Šie žurnāla ieraksti norāda, ka savienojums no servera `PSQL_1` uz serveri ar IP adresi 192.168.1.2 (`PSQL_2`) un `etcd` ID 7176dd381f583d83 portā `TCP/2380` neizdevās: iestājās noildze. No tā varam secināt, ka plūsmu no servera `PSQL_1` uz serveri `PSQL_2` atmet (`DROP`) ugunsmūris.
>
> Šo plūsmu var atmest (`DROP`) PostgreSQL appliance lokālais ugunsmūris: pārbaudiet [appliance ugunsmūra konfigurāciju](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) attiecīgajos mezglos. Ja šī konfigurācija ir pareiza, plūsmu `TCP/2380` starp abiem mezgliem atmet (`DROP`) kāds infrastruktūras ugunsmūris.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Ja savienojums starp diviem mezgliem tiek noraidīts, `etcd` par to ziņo ar šādiem žurnāla ierakstiem:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Kur `<PEER_PSQL_NODE_ID>` ir ID, ko `etcd` piešķīris mērķa mezglam, un `<PEER_IP_PSQL_NODE>` ir mērķa mezgla IP adrese.
>
> Noraidījumam var būt vairāki iemesli:
>
> - Pakalpojums `etcd` mērķa mezglā darbojas nepareizi vai ir apturēts. Šādā gadījumā pārbaudiet pakalpojuma `etcd` statusu (`systemctl status etcd`) un žurnālus šajā mezglā.
> - Ugunsmūris noraida (`REJECT`) plūsmu `TCP/2380` starp abiem mezgliem. Tas var būt [appliance lokālais ugunsmūris](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) vai kāds infrastruktūras ugunsmūris.
>
> > **Piemērs**
> >
> > Mūsu piemērā PostgreSQL klasteris ir konfigurēts šādi:
> >
> > | Mezgls | Mezgla IP adrese | `etcd` ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Izpildot komandu `journalctl -fu etcd` serverī `PSQL_1`, tiek iegūti šādi žurnāla ieraksti:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Šie žurnāla ieraksti norāda, ka savienojums no servera `PSQL_1` uz serveri ar IP adresi 192.168.1.3 (`PSQL_3`) un `etcd` ID e3d5ef565a5bb46c portā `TCP/2380` tika noraidīts.
> >
> > Serverī `PSQL_3` komanda `systemctl status etcd` parāda, ka `etcd` ir apturēts:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Tiklīdz `etcd` ir startēts, problēma ir novērsta.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Ja PostgreSQL klastera sertifikātu derīgums ir beidzies vai tie nav pareizi instalēti vai atjaunoti mezglā, kurā lasāt žurnālus, `etcd` žurnālos parādās šāda kļūda:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Kur `<PEER_IP_PSQL_NODE>` ir viena klastera mezgla IP adrese.
>
> Šis žurnāla ieraksts norāda, ka tad, kad mezgls, ar kuru pašlaik ir izveidots savienojums, mēģināja izveidot savienojumu ar citiem klastera mezgliem (`<PEER_IP_PSQL_NODE>`), tie to noraidīja, ziņojot par kļūdu pašreizējā mezgla sertifikātā.
>
> Tāpēc [pārbaudiet klastera sertifikātu derīgumu](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) mezglā, ar kuru pašlaik ir izveidots savienojums.
>
> > **Brīdinājums**
> >
> > Ja attālajā mezglā konfigurētā sertificēšanas iestāde (failā `/etc/etcd/ca.crt`) ir nepareiza, kļūda parādās arī mezglā, kurā lasāt žurnālus: tad tā norāda, ka attālais mezgls nevar validēt uzrādīto sertifikātu, jo tam nav pareizās CA.
>
> > **Piemērs**
> >
> > Mūsu piemērā PostgreSQL klasteris ir konfigurēts šādi:
> >
> > | Mezgls | Mezgla IP adrese | `etcd` ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Izpildot komandu `journalctl -fu etcd` serverī `PSQL_1`, tiek iegūti šādi žurnāla ieraksti:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Šie žurnāla ieraksti norāda, ka mezgli `PSQL_2` un `PSQL_3` noraidīja savienojumu no mezgla `PSQL_1`, jo `PSQL_1` sertifikāts šajā kontekstā nav derīgs.
> >
> > Tāpēc pārbaudām mezgla `PSQL_1` sertifikātu derīgumu, izpildot [klastera sertifikātu pārbaudes](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) procedūru:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Izvade parāda, ka mezgla sertifikāta derīgums ir beidzies:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Šādā gadījumā ir [jāatjauno PostgreSQL klastera sertifikāti](https://docs.cyberelements.io/bastion/4.6/lv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Ja `etcd` nav pareizo atļauju direktorijam `/var/lib/etcd/cleanroom`, pakalpojums atsakās startēt un ieraksta šādus žurnāla ierakstus:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Lai novērstu šo problēmu, piešķiriet direktorijam pareizās atļaujas ar šo komandu:
>
> ```
> 1
> ```
