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

# `etcd`-palvelun vianmääritys

> **Tietoa**
>
> Koko toimenpide on suoritettava `root`-käyttäjänä. Voit korottaa oikeutesi `root`-tasolle komennolla `su -`.

`etcd` on hajautettu avain-arvo-säilö (*distributed key-value store*), jota käytetään PostgreSQL-klusterin solmujen välisenä koordinointipisteenä. Se keskittää ja jakaa luotettavasti klusterin tilan, mukaan lukien johtajan identiteetin, jäsenten tilan ja lukitusmekanismit.

`patroni` tukeutuu `etcd`-palveluun johtajasolmun valinnan ohjaamisessa ja vikasietosiirtojen automaattisessa käynnistämisessä häiriön sattuessa. Kaikille solmuille asennettuna `etcd` takaa klusterin yleisen johdonmukaisuuden osallistumatta PostgreSQL-tietojen tallennukseen tai käsittelyyn.

`patroni` on siis riippuvainen `etcd`-palvelusta eikä voi toimia oikein, jos `etcd` ei toimi.

> **Tietoa**
>
> `etcd`-palvelun määritys tallennetaan kunkin solmun tiedostoon `/etc/default/etcd`.

## Lokit

Koko toimenpide perustuu `etcd`-palvelun lokeihin, jotka saat alla olevalla komennolla:

```
1
```

> **Vihje**
>
> Jos haluat seurata lokeja reaaliajassa, lisää komentoon valitsin `-f`:
>
> ```
> 1
> ```

> **Tietoa**
>
> `etcd`-palvelun lokit ovat saatavilla myös tiedostossa `/var/log/syslog`.

## Virhelokien selitykset

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Jos `TCP/2380`-liikenne ei ole avoinna kahden solmun välillä, yhteys aikakatkaistaan ja `etcd` kirjoittaa seuraavat lokimerkinnät:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Tässä `<PEER_PSQL_NODE_ID>` on ID, jonka `etcd` on antanut kohdesolmulle, ja `<PEER_IP_PSQL_NODE>` on kohdesolmun IP-osoite.
>
> > **Esimerkki**
> >
> > Esimerkissämme PostgreSQL-klusteri on määritetty seuraavasti:
> >
> > | Solmu | Solmun IP | `etcd`-ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Komennon `journalctl -fu etcd` suorittaminen palvelimella `PSQL_1` tuottaa seuraavat lokimerkinnät:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Nämä lokimerkinnät osoittavat, että yhteys palvelimelta `PSQL_1` palvelimeen, jonka IP-osoite on 192.168.1.2 (`PSQL_2`) ja `etcd`-ID 7176dd381f583d83, portissa `TCP/2380` ei onnistunut: se aikakatkaistiin. Voimme päätellä, että palomuuri pudottaa (`DROP`) liikenteen palvelimelta `PSQL_1` palvelimeen `PSQL_2`.
>
> PostgreSQL-appliancen paikallinen palomuuri voi pudottaa (`DROP`) tämän liikenteen: tarkista [appliancen palomuurin määritys](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) kyseisillä solmuilla. Jos tämä määritys on oikein, infrastruktuurin palomuuri pudottaa (`DROP`) `TCP/2380`-liikenteen näiden kahden solmun välillä.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Kun kahden solmun välinen yhteys hylätään, `etcd` ilmoittaa siitä seuraavilla lokimerkinnöillä:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Tässä `<PEER_PSQL_NODE_ID>` on ID, jonka `etcd` on antanut kohdesolmulle, ja `<PEER_IP_PSQL_NODE>` on kohdesolmun IP-osoite.
>
> Hylkäämisellä voi olla useita syitä:
>
> - `etcd`-palvelu toimii virheellisesti tai on pysäytetty kohdesolmulla. Tarkista tällöin kyseisen solmun `etcd`-palvelun tila (`systemctl status etcd`) ja lokit.
> - Palomuuri hylkää (`REJECT`) `TCP/2380`-liikenteen kahden solmun välillä. Se voi olla [appliancen paikallinen palomuuri](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) tai infrastruktuurin palomuuri.
>
> > **Esimerkki**
> >
> > Esimerkissämme PostgreSQL-klusteri on määritetty seuraavasti:
> >
> > | Solmu | Solmun IP | `etcd`-ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Komennon `journalctl -fu etcd` suorittaminen palvelimella `PSQL_1` tuottaa seuraavat lokimerkinnät:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Nämä lokimerkinnät osoittavat, että yhteys palvelimelta `PSQL_1` palvelimeen, jonka IP-osoite on 192.168.1.3 (`PSQL_3`) ja `etcd`-ID e3d5ef565a5bb46c, portissa `TCP/2380` hylättiin.
> >
> > Palvelimella `PSQL_3` komento `systemctl status etcd` näyttää, että `etcd` on pysäytetty:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Kun `etcd` on käynnistetty, ongelma on ratkaistu.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Jos PostgreSQL-klusterin sertifikaatit ovat vanhentuneet tai niitä ei ole asennettu tai uusittu oikein sillä solmulla, jolta luet lokeja, `etcd`-palvelun lokeihin ilmestyy seuraava virhe:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Tässä `<PEER_IP_PSQL_NODE>` on jonkin klusterin solmun IP-osoite.
>
> Tämä lokimerkintä osoittaa, että kun solmu, johon olet yhteydessä, yritti muodostaa yhteyden klusterin muihin solmuihin (`<PEER_IP_PSQL_NODE>`), ne hylkäsivät sen ja ilmoittivat virheestä nykyisen solmun sertifikaatissa.
>
> Sinun kannattaa siis [tarkistaa klusterin sertifikaattien voimassaolo](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) solmulla, johon olet yhteydessä.
>
> > **Varoitus**
> >
> > Jos etäsolmulle määritetty varmentaja (tiedostossa `/etc/etcd/ca.crt`) on virheellinen, virhe näkyy myös sillä solmulla, jolta luet lokeja: se osoittaa silloin, että etäsolmu ei pysty vahvistamaan esitettyä sertifikaattia, koska sillä ei ole oikeaa varmentajaa (CA).
>
> > **Esimerkki**
> >
> > Esimerkissämme PostgreSQL-klusteri on määritetty seuraavasti:
> >
> > | Solmu | Solmun IP | `etcd`-ID |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Komennon `journalctl -fu etcd` suorittaminen palvelimella `PSQL_1` tuottaa seuraavat lokimerkinnät:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Nämä lokimerkinnät osoittavat, että solmut `PSQL_2` ja `PSQL_3` hylkäsivät solmun `PSQL_1` yhteyden, koska solmun `PSQL_1` sertifikaatti ei ole kelvollinen tässä yhteydessä.
> >
> > Tarkistamme siksi solmun `PSQL_1` sertifikaattien voimassaolon noudattamalla [klusterin sertifikaattien tarkistuksen](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) ohjeita:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Tuloste osoittaa, että solmun sertifikaatti on vanhentunut:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Tässä tapauksessa sinun on [uusittava PostgreSQL-klusterin sertifikaatit](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Jos `etcd`-palvelulla ei ole oikeita käyttöoikeuksia hakemistoon `/var/lib/etcd/cleanroom`, palvelu ei suostu käynnistymään ja kirjoittaa seuraavat lokimerkinnät:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Ratkaise ongelma antamalla hakemistolle oikeat käyttöoikeudet seuraavalla komennolla:
>
> ```
> 1
> ```
