> Source: https://docs.cyberelements.io/bastion/4.6/mt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PsqlDebug/

# Soluzzjoni tal-problemi tal-cluster PostgreSQL

> **Informazzjoni**
>
> Il-proċedura kollha għandha titwettaq bħala `root`. Biex tgħolli l-privileġġi tiegħek għal `root`, tista’ tuża l-kmand `su -`.

> **Twissija**
>
> Biex issegwi din il-proċedura, trid tkun wettaqt [il-konfigurazzjonijiet addizzjonali għal `patronictl`](https://docs.cyberelements.io/bastion/4.6/mt/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

L-iżbalji tal-konnessjoni mad-database tal-cluster PostgreSQL ta’ CyberElements Bastion jista’ jkollhom diversi kawżi. Dan il-kapitolu jippreżenta metodu ġenerali għas-soluzzjoni tal-problemi, li għandu jiġi adattat għall-każ tiegħek.

## Verifika tal-istatus tal-cluster

> **Informazzjoni**
>
> Il-verifika tal-istatus tal-cluster tgħin biex jinstabu malajr in-nodu jew in-nodi li qed ifallu.

Tista’ tivverifika l-istatus tal-cluster bil-kmand li ġej, li għandu jitħaddem fuq kull nodu tal-cluster PostgreSQL:

```
1
```

> **Eżempju ta’ riżultat fuq pjattaforma li taħdem**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Fir-riżultat ta’ hawn fuq, kollox jindika li l-cluster PostgreSQL qed jaħdem: id-dewmien (lag) huwa ta’ 0 MB għan-nodi `Replica` kollha, u n-nodi kollha jinsabu fil-lista, bl-istatus `running`. Trid tikseb dan ir-riżultat fuq in-nodi kollha biex tikkonferma li `patroni` u `etcd` qed jaħdmu.

> **Eżempju ta’ riżultat meta jkun hemm problema ta’ komunikazzjoni bejn in-nodi**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Fir-riżultat ta’ hawn fuq, id-dewmien ta’ 230 MB mhuwiex normali: jista’ jindika problema ta’ komunikazzjoni bejn in-nodu 3 u n-nodu 1.
> Jekk il-problema tippersisti wara diversi sigħat, dan jikkonfermaha.

> **Eżempju ta’ riżultat meta nodu ma jkunx inbeda jew twaqqaf sew**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Fir-riżultat ta’ hawn fuq, l-istat (kolonna `State`) jindika li n-nodu 1 qed jibda. Jekk l-istatus `started` jippersisti għal diversi minuti, jew saħansitra sigħat, jista’ jkun hemm problema fis-servizz `patroni` jew `etcd` fuq dak in-nodu.
> In-nodu 2 jinsab fl-istat `stopped`: huwa mwaqqaf. Meta nodu tal-cluster ifalli, din l-informazzjoni tintwera biss b’mod temporanju, qabel ma n-nodu jitneħħa mil-lista.

> **Eżempju ta’ riżultat meta `etcd` ifalli fuq in-nodu attwali**
>
> ```
> 1
> 2
> 3
> ```
>
> Ir-riżultat ta’ hawn fuq jindika żball fil-konnessjoni ma’ `etcd`, li ma jħallix jinkiseb l-istatus tal-cluster PostgreSQL.

> **Eżempju ta’ riżultat meta wieħed min-nodi mhuwiex sinkronizzat**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Fir-riżultat ta’ hawn fuq, in-nodu `PSQL_1` m’għadux fuq l-istess `TL` bħall-oħrajn. Biex il-cluster jaħdem, in-nodi kollha għandhom ikunu fuq l-istess `TL`: differenza tindika li wieħed min-nodi mhuwiex sinkronizzat.
> Biex issolvi din il-problema, segwi l-proċedura ta’ [diżinkronizzazzjoni ta’ nodu](https://docs.cyberelements.io/bastion/4.6/mt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Verifika tal-istatus tas-servizzi

Ladarba jiġi identifikat in-nodu li qed ifalli, trid tidentifika s-servizz li mhux qed jaħdem sew. Iż-żewġ servizzi ewlenin użati fuq il-cluster PostgreSQL huma `patroni` u `etcd`.

> **Informazzjoni**
>
> Is-servizz `patroni` jiddependi fuq is-servizz `etcd`: jekk `etcd` ma jkunx qed jaħdem, lanqas `patroni` ma jaħdem.

Biex tidentifika s-servizz li qed ifalli, tista’ tħaddem il-kmandi li ġejjin:

```
1
2
```

Dawn il-kmandi jagħtu l-istatus tas-servizz, flimkien mal-aħħar 10 linji tar-reġistru tiegħu.

> **Twissija**
>
> Servizz bl-istatus `active (running)` mhux neċessarjament qed jaħdem: jista’ jkun qed jitħaddem filwaqt li jikteb reġistri ta’ żbalji. Għalhekk huwa importanti li taqra r-reġistri tas-servizz biex tifhem l-istat reali tiegħu.

> **Eżempju ta’ riżultat għal `etcd` meta s-servizz ikun qed jaħdem**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Eżempju ta’ riżultat għal `etcd` meta s-servizz ikun fi żball**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Fir-riżultat ta’ hawn fuq, is-servizz `etcd` għandu l-istatus `failed`, u l-iżball li ma ħallihx jibda huwa dak fil-linja 17: is-servizz ma jistax jaqra l-kontenut tad-direttorju `/var/lib/etcd/cleanroom`. F’dan il-każ, [irranġa l-permessi fuq id-direttorju](https://docs.cyberelements.io/bastion/4.6/mt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Eżempju ta’ riżultat għal `patroni` meta s-servizz ikun qed jaħdem**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```

> **Eżempju ta’ riżultat għal `patroni` meta s-servizz ikun fi żball**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```
>
> Fil-każ ta’ hawn fuq, is-servizz għandu l-istatus `active (running)` mingħajr ma fil-fatt qed jaħdem: ir-reġistri juru diversi żbalji tal-konnessjoni ma’ `etcd`, li `patroni` għandu bżonnu.
> F’dan l-eżempju, `patroni` mhux neċessarjament il-ħati: peress li jiddependi fuq `etcd`, l-ewwel irranġa l-problemi ta’ `etcd`, imbagħad ivverifika mill-ġdid l-istatus ta’ `patroni`.

## Proċeduri għas-soluzzjoni tal-problemi tas-servizzi

Hawn taħt hemm proċedura waħda ta’ soluzzjoni tal-problemi għal kull servizz. Jekk kemm `etcd` kif ukoll `patroni` mhumiex qed jaħdmu sew, ibda minn `etcd`.

- **[Soluzzjoni tal-problemi ta’ `etcd`](https://docs.cyberelements.io/bastion/4.6/mt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Proċedura li għandha tiġi segwita meta s-servizz `etcd` ma jaħdimx sew.
- **[Soluzzjoni tal-problemi ta’ `patroni`](https://docs.cyberelements.io/bastion/4.6/mt/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Proċedura li għandha tiġi segwita meta s-servizz `patroni` ma jaħdimx sew.
