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

# Teenuse `etcd` tõrkeotsing

> **Teave**
>
> Kogu protseduur tuleb läbi viia kasutajana `root`. Oma privileegide tõstmiseks `root`-i tasemele saate kasutada käsku `su -`.

`etcd` on hajutatud võtme-väärtuse salv, mida kasutatakse PostgreSQL-i klastri sõlmede vahelise koordineerimispunktina. See tsentraliseerib ja jagab usaldusväärselt klastri olekut, sealhulgas liidri identiteeti, liikmete olekut ja lukustusmehhanisme.

`patroni` tugineb teenusele `etcd`, et juhtida liidersõlme valimist ja algatada intsidendi korral automaatselt tõrkesiirdeid. Kõigisse sõlmedesse installitud `etcd` tagab klastri üldise järjepidevuse, osalemata PostgreSQL-i andmete salvestamises ega töötlemises.

Seega sõltub `patroni` teenusest `etcd` ega saa korralikult töötada, kui `etcd` ei tööta.

> **Teave**
>
> Teenuse `etcd` konfiguratsioon on salvestatud igas sõlmes faili `/etc/default/etcd`.

## Logs

Kogu protseduur tugineb teenuse `etcd` logidele, mille saate alloleva käsuga:

```
1
```

> **Näpunäide**
>
> Logide reaalajas jälgimiseks lisage käsule suvand `-f`:
>
> ```
> 1
> ```

> **Teave**
>
> Teenuse `etcd` logid on saadaval ka failis `/var/log/syslog`.

## Tõrkelogide selgitused

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Kui `TCP/2380`-liiklus pole kahe sõlme vahel avatud, ühendus aegub ja `etcd` kirjutab järgmised logid:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Siin on `<PEER_PSQL_NODE_ID>` ID, mille `etcd` sihtsõlmele määras, ja `<PEER_IP_PSQL_NODE>` sihtsõlme IP-aadress.
>
> > **Näide**
> >
> > Meie näites on PostgreSQL-i klaster konfigureeritud järgmiselt:
> >
> > | Sõlm | Sõlme IP | `etcd`-ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Käsu `journalctl -fu etcd` käivitamine serveris `PSQL_1` annab järgmised logid:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Need logid näitavad, et ühendus serverist `PSQL_1` serverisse IP-aadressiga 192.168.1.2 (`PSQL_2`) ja `etcd`-ID-ga 7176dd381f583d83 pordil `TCP/2380` ei õnnestunud: see aegus. Võime järeldada, et tulemüür hülgab (`DROP`) liikluse serverist `PSQL_1` serverisse `PSQL_2`.
>
> Seda liiklust võib hüljata (`DROP`) PostgreSQL-i appliance'i kohalik tulemüür: kontrollige asjaomastes sõlmedes [appliance'i tulemüüri konfiguratsiooni](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/). Kui see konfiguratsioon on õige, hülgab (`DROP`) kahe sõlme vahelise `TCP/2380`-liikluse mõni infrastruktuuri tulemüür.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Kui kahe sõlme vaheline ühendus lükatakse tagasi, teatab `etcd` sellest järgmiste logidega:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Siin on `<PEER_PSQL_NODE_ID>` ID, mille `etcd` sihtsõlmele määras, ja `<PEER_IP_PSQL_NODE>` sihtsõlme IP-aadress.
>
> Tagasilükkamisel võib olla mitu põhjust:
>
> - Teenus `etcd` töötab sihtsõlmes valesti või on peatatud. Sel juhul kontrollige selle sõlme teenuse `etcd` olekut (`systemctl status etcd`) ja logisid.
> - Tulemüür lükkab kahe sõlme vahelise `TCP/2380`-liikluse tagasi (`REJECT`). See võib olla [appliance'i kohalik tulemüür](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) või infrastruktuuri tulemüür.
>
> > **Näide**
> >
> > Meie näites on PostgreSQL-i klaster konfigureeritud järgmiselt:
> >
> > | Sõlm | Sõlme IP | `etcd`-ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Käsu `journalctl -fu etcd` käivitamine serveris `PSQL_1` annab järgmised logid:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Need logid näitavad, et ühendus serverist `PSQL_1` serverisse IP-aadressiga 192.168.1.3 (`PSQL_3`) ja `etcd`-ID-ga e3d5ef565a5bb46c pordil `TCP/2380` lükati tagasi.
> >
> > Serveris `PSQL_3` näitab käsk `systemctl status etcd`, et `etcd` on peatatud:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Kui `etcd` on käivitatud, on probleem lahendatud.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Kui PostgreSQL-i klastri sertifikaadid on aegunud või neid pole sõlmes, kust logisid loete, õigesti installitud või uuendatud, kuvatakse teenuse `etcd` logides järgmine tõrge:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Siin on `<PEER_IP_PSQL_NODE>` ühe klastri sõlme IP-aadress.
>
> See logi näitab, et kui sõlm, millega olete ühendatud, üritas luua ühendust klastri teiste sõlmedega (`<PEER_IP_PSQL_NODE>`), lükkasid need selle tagasi, teatades tõrkest praeguse sõlme sertifikaadis.
>
> Seetõttu peaksite sõlmes, millega olete ühendatud, [kontrollima klastri sertifikaatide kehtivust](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/).
>
> > **Hoiatus**
> >
> > Kui kaugsõlmes (failis `/etc/etcd/ca.crt`) konfigureeritud sertifitseerimisasutus on vale, ilmneb tõrge ka sõlmes, kust logisid loete: see näitab siis, et kaugsõlm ei saa esitatud sertifikaati valideerida, kuna sellel pole õiget CA-d.
>
> > **Näide**
> >
> > Meie näites on PostgreSQL-i klaster konfigureeritud järgmiselt:
> >
> > | Sõlm | Sõlme IP | `etcd`-ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Käsu `journalctl -fu etcd` käivitamine serveris `PSQL_1` annab järgmised logid:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Need logid näitavad, et sõlmed `PSQL_2` ja `PSQL_3` lükkasid sõlme `PSQL_1` ühenduse tagasi, kuna sõlme `PSQL_1` sertifikaat pole selles kontekstis kehtiv.
> >
> > Seetõttu kontrollime sõlme `PSQL_1` sertifikaatide kehtivust, järgides [klastri sertifikaatide kontrollimise](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) protseduuri:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Väljund näitab, et sõlme sertifikaat on aegunud:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Sel juhul peate [uuendama PostgreSQL-i klastri sertifikaadid](https://docs.cyberelements.io/bastion/4.6/et/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Kui teenusel `etcd` pole kataloogi `/var/lib/etcd/cleanroom` jaoks õigeid lubasid, keeldub teenus käivitumast ja kirjutab järgmised logid:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Selle probleemi lahendamiseks määrake kataloogile järgmise käsuga õiged load:
>
> ```
> 1
> ```
