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

# Otklanjanje poteškoća s uslugom `etcd`

> **Informacije**
>
> Cijeli postupak treba provesti kao `root`. Da biste povisili svoje povlastice na razinu `root`, možete upotrijebiti naredbu `su -`.

`etcd` je distribuirano spremište tipa ključ-vrijednost koje služi kao točka koordinacije između čvorova klastera PostgreSQL. Pouzdano centralizira i dijeli stanje klastera, uključujući identitet vodećeg čvora, stanje članova i mehanizme zaključavanja.

`patroni` se oslanja na `etcd` kako bi upravljao izborom vodećeg čvora i automatski pokretao prebacivanje u slučaju kvara kada dođe do incidenta. Instaliran na svim čvorovima, `etcd` jamči ukupnu dosljednost klastera, a da pritom ne sudjeluje u pohrani ni obradi podataka PostgreSQL.

`patroni` stoga ovisi o `etcd` i ne može ispravno raditi ako `etcd` ne radi.

> **Informacije**
>
> Konfiguracija usluge `etcd` pohranjena je u datoteci `/etc/default/etcd` na svakom čvoru.

## Logs

Cijeli se postupak oslanja na zapisnike usluge `etcd`, koje dobivate naredbom u nastavku:

```
1
```

> **Savjet**
>
> Da biste pratili zapisnike uživo, dodajte naredbi mogućnost `-f`:
>
> ```
> 1
> ```

> **Informacije**
>
> Zapisnici usluge `etcd` dostupni su i u `/var/log/syslog`.

## Objašnjenja zapisnika pogrešaka

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Ako tok `TCP/2380` nije otvoren između dvaju čvorova, vrijeme za povezivanje istječe, a `etcd` u zapisnik upisuje sljedeće:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Pri čemu je `<PEER_PSQL_NODE_ID>` identifikator koji je `etcd` dodijelio ciljnom čvoru, a `<PEER_IP_PSQL_NODE>` IP adresa ciljnog čvora.
>
> > **Primjer**
> >
> > U našem primjeru klaster PostgreSQL konfiguriran je ovako:
> >
> > | Čvor | IP adresa čvora | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Pokretanje naredbe `journalctl -fu etcd` na poslužitelju `PSQL_1` daje sljedeće unose u zapisniku:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Ti unosi pokazuju da povezivanje s poslužitelja `PSQL_1` na poslužitelj s IP adresom 192.168.1.2 (`PSQL_2`) i identifikatorom `etcd` 7176dd381f583d83, na priključku `TCP/2380`, nije uspjelo: isteklo je vrijeme čekanja. Iz toga možemo zaključiti da vatrozid odbacuje (`DROP`) tok s poslužitelja `PSQL_1` na poslužitelj `PSQL_2`.
>
> Taj tok može odbacivati (`DROP`) lokalni vatrozid za appliance PostgreSQL: provjerite [konfiguraciju vatrozida za appliance](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) na dotičnim čvorovima. Ako je ta konfiguracija ispravna, tok `TCP/2380` između dvaju čvorova odbacuje (`DROP`) vatrozid infrastrukture.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Kada se veza između dvaju čvorova odbije, `etcd` to prijavljuje sljedećim unosima u zapisniku:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Pri čemu je `<PEER_PSQL_NODE_ID>` identifikator koji je `etcd` dodijelio ciljnom čvoru, a `<PEER_IP_PSQL_NODE>` IP adresa ciljnog čvora.
>
> Odbijanje može imati nekoliko uzroka:
>
> - Usluga `etcd` ne radi ispravno ili je zaustavljena na ciljnom čvoru. U tom slučaju provjerite stanje (`systemctl status etcd`) i zapisnike usluge `etcd` na tom čvoru.
> - Vatrozid odbija (`REJECT`) tok `TCP/2380` između dvaju čvorova. To može biti [lokalni vatrozid za appliance](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) ili vatrozid infrastrukture.
>
> > **Primjer**
> >
> > U našem primjeru klaster PostgreSQL konfiguriran je ovako:
> >
> > | Čvor | IP adresa čvora | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Pokretanje naredbe `journalctl -fu etcd` na poslužitelju `PSQL_1` daje sljedeće unose u zapisniku:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Ti unosi pokazuju da je povezivanje s poslužitelja `PSQL_1` na poslužitelj s IP adresom 192.168.1.3 (`PSQL_3`) i identifikatorom `etcd` e3d5ef565a5bb46c, na priključku `TCP/2380`, odbijeno.
> >
> > Na poslužitelju `PSQL_3` naredba `systemctl status etcd` pokazuje da je `etcd` zaustavljen:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Kada se `etcd` pokrene, problem je riješen.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Ako su certifikati klastera PostgreSQL istekli ili nisu ispravno instalirani ili obnovljeni na čvoru s kojeg čitate zapisnike, u zapisnicima usluge `etcd` pojavljuje se sljedeća pogreška:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Pri čemu je `<PEER_IP_PSQL_NODE>` IP adresa jednog od čvorova klastera.
>
> Ovaj unos pokazuje da su, kada je čvor s kojim ste povezani pokušao uspostaviti vezu s ostalim čvorovima klastera (`<PEER_IP_PSQL_NODE>`), ti čvorovi odbili vezu i prijavili pogrešku u certifikatu trenutačnog čvora.
>
> Stoga [provjerite valjanost certifikata klastera](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) na čvoru s kojim ste povezani.
>
> > **Upozorenje**
> >
> > Ako je certifikacijsko tijelo konfigurirano na udaljenom čvoru (u `/etc/etcd/ca.crt`) neispravno, pogreška se pojavljuje i na čvoru s kojeg čitate zapisnike: tada znači da udaljeni čvor ne može provjeriti predočeni certifikat jer nema ispravno certifikacijsko tijelo (CA).
>
> > **Primjer**
> >
> > U našem primjeru klaster PostgreSQL konfiguriran je ovako:
> >
> > | Čvor | IP adresa čvora | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Pokretanje naredbe `journalctl -fu etcd` na poslužitelju `PSQL_1` daje sljedeće unose u zapisniku:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Ti unosi pokazuju da su čvorovi `PSQL_2` i `PSQL_3` odbili vezu s čvora `PSQL_1` jer certifikat čvora `PSQL_1` u tom kontekstu nije valjan.
> >
> > Stoga provjeravamo valjanost certifikata čvora `PSQL_1` slijedeći postupak [provjere certifikata klastera](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/):
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Rezultat pokazuje da je certifikat čvora istekao:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > U tom slučaju morate [obnoviti certifikate klastera PostgreSQL](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Ako `etcd` nema ispravne dozvole za direktorij `/var/lib/etcd/cleanroom`, usluga se odbija pokrenuti i u zapisnik upisuje sljedeće:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Da biste riješili taj problem, dodijelite direktoriju ispravne dozvole sljedećom naredbom:
>
> ```
> 1
> ```
