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

# Fabhtcheartú `etcd`

> **Faisnéis**
>
> Ní mór an nós imeachta ar fad a leanúint mar `root`. Chun do phribhléidí a ardú go `root`, is féidir leat an t-ordú `su -` a úsáid.

Is stór eochrach-luacha dáilte é `etcd` a úsáidtear mar phointe comhordaithe idir nóid na braisle PostgreSQL. Láraíonn agus comhroinneann sé staid na braisle go hiontaofa, lena n-áirítear aitheantas an cheannaire, staid na gcomhaltaí agus na meicníochtaí glasála.

Braitheann `patroni` ar `etcd` chun toghchán an nóid cheannaire a stiúradh agus chun cliseadh thar a spreagadh go huathoibríoch nuair a tharlaíonn teagmhas. Suiteáilte ar gach nód, ráthaíonn `etcd` comhsheasmhacht fhoriomlán na braisle, gan páirt a ghlacadh i stóráil ná i bpróiseáil sonraí PostgreSQL.

Braitheann `patroni` ar `etcd` dá bhrí sin, agus ní féidir leis oibriú i gceart mura bhfuil `etcd` ag obair.

> **Faisnéis**
>
> Stóráiltear cumraíocht `etcd` sa chomhad `/etc/default/etcd` ar gach nód.

## Logs

Braitheann an nós imeachta ar fad ar logaí na seirbhíse `etcd`, a fhaigheann tú leis an ordú thíos:

```
1
```

> **Leid**
>
> Chun na logaí a leanúint i bhfíor-am, cuir an rogha `-f` leis an ordú:
>
> ```
> 1
> ```

> **Faisnéis**
>
> Tá logaí `etcd` ar fáil in `/var/log/syslog` freisin.

## Mínithe ar logaí earráide

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: i/o timeout`**
>
> Mura bhfuil an sreabhadh líonra `TCP/2380` oscailte idir dhá nód, téann an ceangal thar am agus scríobhann `etcd` na logaí seo a leanas:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Is é `<PEER_PSQL_NODE_ID>` an ID a shann `etcd` don nód sprice, agus is é `<PEER_IP_PSQL_NODE>` seoladh IP an nóid sprice.
>
> > **Sampla**
> >
> > Inár sampla, tá an bhraisle PostgreSQL cumraithe mar seo a leanas:
> >
> > | Nód | IP an nóid | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Nuair a ritear an t-ordú `journalctl -fu etcd` ón bhfreastalaí `PSQL_1`, faightear na logaí seo a leanas:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Léiríonn na logaí seo nár éirigh leis an gceangal ón bhfreastalaí `PSQL_1` leis an bhfreastalaí a bhfuil an seoladh IP 192.168.1.2 (`PSQL_2`) agus an ID `etcd` 7176dd381f583d83 aige, ar an bport `TCP/2380`: chuaigh sé thar am. Is féidir linn a thátal go bhfuil an sreabhadh líonra ón bhfreastalaí `PSQL_1` chuig an bhfreastalaí `PSQL_2` á chaitheamh i leataobh (`DROP`) ag balla dóiteáin.
>
> Is féidir go gcaitheann balla dóiteáin logánta an fhearais PostgreSQL an sreabhadh seo i leataobh (`DROP`): seiceáil [cumraíocht an bhalla dóiteáin ar an bhfearas](https://docs.cyberelements.io/bastion/4.6/ga/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) ar na nóid lena mbaineann. Má tá an chumraíocht seo ceart, tá balla dóiteáin de chuid an bhonneagair ag caitheamh an tsreafa líonra `TCP/2380` i leataobh (`DROP`) idir an dá nód.

> **`health check for peer <PEER_PSQL_NODE_ID> could not connect: dial tcp <PEER_IP_PSQL_NODE>:2380: connect: connection refused`**
>
> Nuair a eitítear ceangal idir dhá nód, tuairiscíonn `etcd` é leis na logaí seo a leanas:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Is é `<PEER_PSQL_NODE_ID>` an ID a shann `etcd` don nód sprice, agus is é `<PEER_IP_PSQL_NODE>` seoladh IP an nóid sprice.
>
> D'fhéadfadh cúiseanna éagsúla a bheith leis an eiteach:
>
> - Tá mífheidhm ar an tseirbhís `etcd` nó tá sí stoptha ar an nód sprice. Sa chás seo, seiceáil stádas (`systemctl status etcd`) agus logaí na seirbhíse `etcd` ar an nód sin.
> - Eitíonn balla dóiteáin (`REJECT`) an sreabhadh líonra `TCP/2380` idir an dá nód. D'fhéadfadh gurb é [balla dóiteáin logánta an fhearais](https://docs.cyberelements.io/bastion/4.6/ga/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlFirewallUpdates/) é nó balla dóiteáin de chuid an bhonneagair.
>
> > **Sampla**
> >
> > Inár sampla, tá an bhraisle PostgreSQL cumraithe mar seo a leanas:
> >
> > | Nód | IP an nóid | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Nuair a ritear an t-ordú `journalctl -fu etcd` ón bhfreastalaí `PSQL_1`, faightear na logaí seo a leanas:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > ```
> >
> > Léiríonn na logaí seo gur eitíodh an ceangal ón bhfreastalaí `PSQL_1` leis an bhfreastalaí a bhfuil an seoladh IP 192.168.1.3 (`PSQL_3`) agus an ID `etcd` e3d5ef565a5bb46c aige, ar an bport `TCP/2380`.
> >
> > Ar an bhfreastalaí `PSQL_3`, léiríonn an t-ordú `systemctl status etcd` go bhfuil `etcd` stoptha:
> >
> > ```
> >  1
> >  2
> >  3
> >  4
> >  5
> >  6
> >  7
> >  8
> >  9
> > 10
> > 11
> > 12
> > 13
> > 14
> > 15
> > 16
> > 17
> > 18
> > 19
> > 20
> > ```
> >
> > Nuair a thosaítear `etcd`, réitítear an fhadhb.

> **`rejected connection from "<PEER_IP_PSQL_NODE>:35956" (error "remote error: tls: bad certificate", ServerName "PSQL_1")`**
>
> Má tá deimhnithe na braisle PostgreSQL imithe in éag, nó mura ndearnadh iad a shuiteáil nó a athnuachan i gceart ar an nód óna bhfuil tú ag léamh na logaí, feictear an earráid seo a leanas i logaí `etcd`:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Is é `<PEER_IP_PSQL_NODE>` seoladh IP nóid amháin de chuid na braisle.
>
> Léiríonn an loga seo, nuair a rinne an nód a bhfuil tú ceangailte leis iarracht ceangal a bhunú le nóid eile na braisle (`<PEER_IP_PSQL_NODE>`), gur eitigh siad é, agus earráid i ndeimhniú an nóid reatha á tuairisciú acu.
>
> Mar sin, ba cheart duit [bailíocht na ndeimhnithe braisle a sheiceáil](https://docs.cyberelements.io/bastion/4.6/ga/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) ar an nód a bhfuil tú ceangailte leis.
>
> > **Rabhadh**
> >
> > Má tá an t-údarás deimhniúcháin atá cumraithe ar nód cianda (in `/etc/etcd/ca.crt`) mícheart, feictear an earráid freisin ar an nód óna bhfuil tú ag léamh na logaí: léiríonn sí ansin nach féidir leis an nód cianda an deimhniú a cuireadh i láthair a bhailíochtú, toisc nach bhfuil an CA ceart aige.
>
> > **Sampla**
> >
> > Inár sampla, tá an bhraisle PostgreSQL cumraithe mar seo a leanas:
> >
> > | Nód | IP an nóid | ID `etcd` |
> > |---|---|---|
> > | PSQL_1 | 192.168.1.1 | 53d2c129945ccb8b |
> > | PSQL_2 | 192.168.1.2 | 7176dd381f583d83 |
> > | PSQL_3 | 192.168.1.3 | e3d5ef565a5bb46c |
> >
> > Nuair a ritear an t-ordú `journalctl -fu etcd` ón bhfreastalaí `PSQL_1`, faightear na logaí seo a leanas:
> >
> > ```
> > 1
> > 2
> > 3
> > 4
> > 5
> > 6
> > ```
> >
> > Léiríonn na logaí seo gur eitigh na nóid `PSQL_2` agus `PSQL_3` an ceangal ón nód `PSQL_1`, toisc nach bhfuil deimhniú `PSQL_1` bailí sa chomhthéacs seo.
> >
> > Mar sin, seiceálaimid bailíocht na ndeimhnithe ar an nód `PSQL_1` tríd an nós imeachta [seiceála deimhnithe braisle](https://docs.cyberelements.io/bastion/4.6/ga/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsVerification/) a leanúint:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Léiríonn an t-aschur go bhfuil deimhniú an nóid imithe in éag:
> >
> > ```
> > 1
> > 2
> > ```
> >
> > Sa chás seo, ní mór duit [deimhnithe na braisle PostgreSQL a athnuachan](https://docs.cyberelements.io/bastion/4.6/ga/Installation/Dependencies/PostgreSQLCluster/Operation/PsqlCertsRenew/).

> **`error listing data dir: /var/lib/etcd/cleanroom`**
>
> Mura bhfuil na ceadanna cearta ag `etcd` ar an gcomhadlann `/var/lib/etcd/cleanroom`, ní thosaíonn an tseirbhís agus scríobhann sí na logaí seo a leanas:
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> ```
>
> Chun an fhadhb seo a réiteach, sann na ceadanna cearta don chomhadlann leis an ordú seo a leanas:
>
> ```
> 1
> ```
