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

# Felsökning av `etcd`

> **Information**
>
> Hela proceduren ska utföras som `root`. För att höja dina privilegier till `root` kan du använda kommandot `su -`.

`etcd` är ett distribuerat nyckel-värde-lager som används som samordningspunkt mellan noderna i PostgreSQL-clustret. Det centraliserar och delar på ett tillförlitligt sätt clustrets tillstånd, bland annat ledarens identitet, medlemmarnas tillstånd och låsmekanismerna.

`patroni` förlitar sig på `etcd` för att styra valet av ledarnod och för att automatiskt utlösa redundansväxlingar när en incident inträffar. `etcd` är installerat på alla noder och garanterar clustrets övergripande konsekvens, utan att delta i lagringen eller behandlingen av PostgreSQL-data.

`patroni` är därför beroende av `etcd` och kan inte fungera korrekt om `etcd` inte fungerar.

> **Information**
>
> Konfigurationen för `etcd` lagras i filen `/etc/default/etcd` på varje nod.

## Loggar

Hela proceduren bygger på loggarna för tjänsten `etcd`, som du hämtar med kommandot nedan:

```
1
```

> **Tips**
>
> Lägg till alternativet `-f` i kommandot för att följa loggarna i realtid:
>
> ```
> 1
> ```

> **Information**
>
> Loggarna för `etcd` finns också i `/var/log/syslog`.

## Förklaring av felloggar

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Om flödet `TCP/2380` inte är öppet mellan två noder överskrids tidsgränsen för anslutningen och `etcd` skriver följande loggar:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Där `<PEER_PSQL_NODE_ID>` är det ID som `etcd` har tilldelat målnoden och `<PEER_IP_PSQL_NODE>` är målnodens IP-adress.
>
> > **Exempel**
> >
> > I vårt exempel är PostgreSQL-clustret konfigurerat på följande sätt:
> >
> > | Nod | Nodens IP | ID i `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Om du kör kommandot `journalctl -fu etcd` från servern `PSQL_1` får du följande loggar:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Dessa loggar visar att anslutningen från servern `PSQL_1` till servern med IP-adressen 192.168.1.2 (`PSQL_2`) och ID 7176dd381f583d83 i `etcd`, på porten `TCP/2380`, inte lyckades: tidsgränsen överskreds. Vi kan dra slutsatsen att flödet från servern `PSQL_1` till servern `PSQL_2` blockeras (`DROP`) av en brandvägg.
>
> Detta flöde kan blockeras (`DROP`) av PostgreSQL-appliancens lokala brandvägg: kontrollera [appliancens brandväggskonfiguration](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) på de berörda noderna. Om denna konfiguration är korrekt är det en brandvägg i infrastrukturen som blockerar (`DROP`) flödet `TCP/2380` mellan de två noderna.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> När en anslutning mellan två noder avvisas rapporterar `etcd` det med följande loggar:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Där `<PEER_PSQL_NODE_ID>` är det ID som `etcd` har tilldelat målnoden och `<PEER_IP_PSQL_NODE>` är målnodens IP-adress.
>
> Avvisningen kan ha flera orsaker:
>
> - Tjänsten `etcd` fungerar inte som den ska eller är stoppad på målnoden. Kontrollera i så fall statusen (`systemctl status etcd`) och loggarna för tjänsten `etcd` på den noden.
> - En brandvägg avvisar (`REJECT`) flödet `TCP/2380` mellan de två noderna. Det kan vara [appliancens lokala brandvägg](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) eller en brandvägg i infrastrukturen.
>
> > **Exempel**
> >
> > I vårt exempel är PostgreSQL-clustret konfigurerat på följande sätt:
> >
> > | Nod | Nodens IP | ID i `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Om du kör kommandot `journalctl -fu etcd` från servern `PSQL_1` får du följande loggar:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Dessa loggar visar att anslutningen från servern `PSQL_1` till servern med IP-adressen 192.168.1.3 (`PSQL_3`) och ID e3d5ef565a5bb46c i `etcd`, på porten `TCP/2380`, avvisades.
> >
> > På servern `PSQL_3` visar kommandot `systemctl status etcd` att `etcd` har stoppats:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > När `etcd` har startats är problemet löst.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Om certifikaten för PostgreSQL-clustret har gått ut, eller om de inte har installerats eller förnyats korrekt på den nod där du läser loggarna, visas följande fel i loggarna för `etcd`:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Där `<PEER_IP_PSQL_NODE>` är IP-adressen för en av noderna i clustret.
>
> Denna logg visar att när den nod som du är ansluten till försökte upprätta en anslutning till de andra noderna i clustret (`<PEER_IP_PSQL_NODE>`) avvisade de den och rapporterade ett fel i den aktuella nodens certifikat.
>
> Du bör därför [kontrollera giltigheten för clustrets certifikat](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) på den nod som du är ansluten till.
>
> > **Varning**
> >
> > Om den certifikatutfärdare som är konfigurerad på en fjärrnod (i `/etc/etcd/ca.crt`) är felaktig visas felet också på den nod där du läser loggarna: det betyder då att fjärrnoden inte kan validera det certifikat som visas upp, eftersom den inte har rätt CA.
>
> > **Exempel**
> >
> > I vårt exempel är PostgreSQL-clustret konfigurerat på följande sätt:
> >
> > | Nod | Nodens IP | ID i `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Om du kör kommandot `journalctl -fu etcd` från servern `PSQL_1` får du följande loggar:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Dessa loggar visar att noderna `PSQL_2` och `PSQL_3` avvisade anslutningen från noden `PSQL_1`, eftersom certifikatet för `PSQL_1` inte är giltigt i detta sammanhang.
> >
> > Vi kontrollerar därför giltigheten för certifikaten på noden `PSQL_1` genom att följa proceduren för [kontroll av clustrets certifikat](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/):
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Resultatet visar att nodens certifikat har gått ut:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > I så fall måste du [förnya certifikaten för PostgreSQL-clustret](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Om `etcd` inte har rätt behörigheter för katalogen `/var/lib/etcd/cleanroom` vägrar tjänsten att starta och skriver följande loggar:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Lös problemet genom att tilldela katalogen rätt behörigheter med följande kommando:
>
> ```
> 1
> ```
