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

# Odpravljanje težav z `etcd`

> **Informacije**
>
> Celoten postopek je treba izvesti kot `root`. Za dvig privilegijev na raven `root` lahko uporabite ukaz `su -`.

`etcd` je porazdeljena shramba ključev in vrednosti, ki se uporablja kot točka usklajevanja med vozlišči gruče PostgreSQL. Zanesljivo centralizira in deli stanje gruče, vključno z identiteto vodje, stanjem članov in mehanizmi zaklepanja.

`patroni` se zanaša na `etcd` pri vodenju izbire vodilnega vozlišča in samodejnem sprožanju preklopov ob napaki, ko pride do incidenta. `etcd`, nameščen na vseh vozliščih, zagotavlja splošno skladnost gruče, ne da bi sodeloval pri shranjevanju ali obdelavi podatkov PostgreSQL.

`patroni` je torej odvisen od `etcd` in ne more pravilno delovati, če `etcd` ne deluje.

> **Informacije**
>
> Konfiguracija `etcd` je shranjena v datoteki `/etc/default/etcd` na vsakem vozlišču.

## Logs

Celoten postopek temelji na dnevnikih storitve `etcd`, ki jih dobite s spodnjim ukazom:

```
1
```

> **Nasvet**
>
> Če želite dnevnike spremljati sproti, ukazu dodajte možnost `-f`:
>
> ```
> 1
> ```

> **Informacije**
>
> Dnevniki `etcd` so na voljo tudi v `/var/log/syslog`.

## Razlaga dnevnikov napak

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Če tok `TCP/2380` med dvema vozliščema ni odprt, za povezavo poteče časovna omejitev in `etcd` zapiše naslednje dnevniške zapise:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Pri tem je `<PEER_PSQL_NODE_ID>` ID, ki ga `etcd` dodeli ciljnemu vozlišču, `<PEER_IP_PSQL_NODE>` pa naslov IP ciljnega vozlišča.
>
> > **Primer**
> >
> > V našem primeru je gruča PostgreSQL konfigurirana takole:
> >
> > | Vozlišče | IP vozlišča | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Zagon ukaza `journalctl -fu etcd` na strežniku `PSQL_1` da naslednje dnevniške zapise:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Ti dnevniški zapisi kažejo, da povezava s strežnika `PSQL_1` do strežnika z naslovom IP 192.168.1.2 (`PSQL_2`) in ID-jem `etcd` 7176dd381f583d83 na vratih `TCP/2380` ni uspela: potekla je časovna omejitev. Iz tega lahko sklepamo, da tok s strežnika `PSQL_1` do strežnika `PSQL_2` zavrže (`DROP`) požarni zid.
>
> Ta tok lahko zavrže (`DROP`) lokalni požarni zid appliance PostgreSQL: preverite [konfiguracijo požarnega zidu appliance](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) na zadevnih vozliščih. Če je ta konfiguracija pravilna, tok `TCP/2380` med obema vozliščema zavrže (`DROP`) požarni zid infrastrukture.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Ko je povezava med dvema vozliščema zavrnjena, `etcd` to sporoči z naslednjimi dnevniškimi zapisi:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Pri tem je `<PEER_PSQL_NODE_ID>` ID, ki ga `etcd` dodeli ciljnemu vozlišču, `<PEER_IP_PSQL_NODE>` pa naslov IP ciljnega vozlišča.
>
> Zavrnitev ima lahko več vzrokov:
>
> - Storitev `etcd` na ciljnem vozlišču ne deluje pravilno ali je ustavljena. V tem primeru preverite stanje (`systemctl status etcd`) in dnevnike storitve `etcd` na tem vozlišču.
> - Požarni zid zavrne (`REJECT`) tok `TCP/2380` med obema vozliščema. To je lahko [lokalni požarni zid appliance](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) ali požarni zid infrastrukture.
>
> > **Primer**
> >
> > V našem primeru je gruča PostgreSQL konfigurirana takole:
> >
> > | Vozlišče | IP vozlišča | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Zagon ukaza `journalctl -fu etcd` na strežniku `PSQL_1` da naslednje dnevniške zapise:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Ti dnevniški zapisi kažejo, da je bila povezava s strežnika `PSQL_1` do strežnika z naslovom IP 192.168.1.3 (`PSQL_3`) in ID-jem `etcd` e3d5ef565a5bb46c na vratih `TCP/2380` zavrnjena.
> >
> > Na strežniku `PSQL_3` ukaz `systemctl status etcd` pokaže, da je `etcd` ustavljen:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Ko se `etcd` zažene, je težava odpravljena.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Če so potrdila gruče PostgreSQL potekla ali če niso bila pravilno nameščena ali obnovljena na vozlišču, s katerega berete dnevnike, se v dnevnikih `etcd` prikaže naslednja napaka:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Pri tem je `<PEER_IP_PSQL_NODE>` naslov IP enega od vozlišč gruče.
>
> Ta dnevniški zapis kaže, da so druga vozlišča gruče (`<PEER_IP_PSQL_NODE>`) zavrnila povezavo, ko jo je vozlišče, s katerim ste povezani, poskušalo vzpostaviti, in pri tem sporočila napako potrdila trenutnega vozlišča.
>
> Zato [preverite veljavnost potrdil gruče](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) na vozlišču, s katerim ste povezani.
>
> > **Opozorilo**
> >
> > Če je overitelj potrdil, konfiguriran na oddaljenem vozlišču (v `/etc/etcd/ca.crt`), napačen, se napaka prav tako prikaže na vozlišču, s katerega berete dnevnike: takrat pomeni, da oddaljeno vozlišče ne more preveriti predloženega potrdila, ker nima pravega overitelja potrdil (CA).
>
> > **Primer**
> >
> > V našem primeru je gruča PostgreSQL konfigurirana takole:
> >
> > | Vozlišče | IP vozlišča | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Zagon ukaza `journalctl -fu etcd` na strežniku `PSQL_1` da naslednje dnevniške zapise:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Ti dnevniški zapisi kažejo, da sta vozlišči `PSQL_2` in `PSQL_3` zavrnili povezavo z vozlišča `PSQL_1`, ker potrdilo vozlišča `PSQL_1` v tem kontekstu ni veljavno.
> >
> > Zato preverimo veljavnost potrdil vozlišča `PSQL_1` po postopku [preverjanja potrdil gruče](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/):
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Izpis pokaže, da je potrdilo vozlišča poteklo:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > V tem primeru morate [obnoviti potrdila gruče PostgreSQL](https://docs.cyberelements.io/bastion/4.6/sl/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Če `etcd` nima ustreznih dovoljenj za mapo `/var/lib/etcd/cleanroom`, se storitev noče zagnati in zapiše naslednje dnevniške zapise:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Težavo odpravite tako, da mapi z naslednjim ukazom dodelite ustrezna dovoljenja:
>
> ```
> 1
> ```
