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

# Otklanjanje poteškoća s klasterom PostgreSQL

> **Informacije**
>
> Cijeli postupak treba provesti kao `root`. Da biste povisili svoje povlastice na razinu `root`, možete upotrijebiti naredbu `su -`.

> **Upozorenje**
>
> Da biste slijedili ovaj postupak, morate prethodno provesti [dodatne konfiguracije za `patronictl`](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Pogreške povezivanja s bazom podataka klastera PostgreSQL platforme CyberElements Bastion mogu imati različite uzroke. U ovom se poglavlju predstavlja opća metoda otklanjanja poteškoća koju trebate prilagoditi svojem slučaju.

## Provjera stanja klastera

> **Informacije**
>
> Provjerom stanja klastera brzo se pronalaze čvor ili čvorovi u kvaru.

Stanje klastera možete provjeriti sljedećom naredbom, koju treba pokrenuti na svakom čvoru klastera PostgreSQL:

```
1
```

> **Primjer izlaza na platformi koja radi**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> U gornjem izlazu sve upućuje na to da klaster PostgreSQL radi: kašnjenje je 0 MB za sve čvorove `Replica`, a svi su čvorovi na popisu, sa stanjem `running`. Taj izlaz morate dobiti na svim čvorovima da biste potvrdili da `patroni` i `etcd` rade.

> **Primjer izlaza kada postoji problem u komunikaciji između čvorova**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> U gornjem izlazu kašnjenje od 230 MB nije uobičajeno: moglo bi upućivati na problem u komunikaciji između čvora 3 i čvora 1.
> Ako problem potraje i nakon nekoliko sati, to potvrđuje tu pretpostavku.

> **Primjer izlaza kada čvor nije ispravno pokrenut ili zaustavljen**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> U gornjem izlazu stanje (stupac `State`) pokazuje da se čvor 1 pokreće. Ako se stanje `started` zadrži nekoliko minuta, pa čak i sati, možda postoji problem s uslugom `patroni` ili `etcd` na tom čvoru.
> Čvor 2 u stanju je `stopped`: zaustavljen je. Kada čvor klastera zakaže, ta se informacija prikazuje samo privremeno, prije nego što se čvor ukloni s popisa.

> **Primjer izlaza kada `etcd` zakaže na trenutačnom čvoru**
>
> ```
> 1
> 2
> 3
> ```
>
> Gornji izlaz pokazuje pogrešku povezivanja s uslugom `etcd`, zbog koje nije moguće dohvatiti stanje klastera PostgreSQL.

> **Primjer izlaza kada jedan od čvorova nije sinkroniziran**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> U gornjem izlazu čvor `PSQL_1` više nije na istoj vrijednosti `TL` kao ostali. Da bi klaster radio, svi čvorovi moraju biti na istoj vrijednosti `TL`: razlika pokazuje da jedan od čvorova nije sinkroniziran.
> Da biste riješili taj problem, slijedite postupak opisan u poglavlju [Gubitak sinkronizacije čvora](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization).

## Provjera stanja usluga

Nakon što utvrdite čvor u kvaru, morate utvrditi uslugu koja ne radi ispravno. Dvije glavne usluge koje se koriste u klasteru PostgreSQL jesu `patroni` i `etcd`.

> **Informacije**
>
> Usluga `patroni` ovisi o usluzi `etcd`: ako `etcd` ne radi, neće raditi ni `patroni`.

Da biste utvrdili uslugu u kvaru, možete pokrenuti sljedeće naredbe:

```
1
2
```

Te naredbe prikazuju stanje usluge zajedno s njezinih posljednjih 10 redaka zapisnika.

> **Upozorenje**
>
> Usluga sa stanjem `active (running)` ne radi nužno ispravno: može biti pokrenuta, a istodobno zapisivati pogreške u zapisnik. Stoga je važno pročitati zapisnike usluge kako biste razumjeli njezino stvarno stanje.

> **Primjer izlaza za `etcd` kada usluga radi**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Primjer izlaza za `etcd` kada je usluga u stanju pogreške**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> U gornjem izlazu usluga `etcd` ima stanje `failed`, a pogreška koja ju je spriječila da se pokrene nalazi se u retku 17: usluga ne može pročitati sadržaj direktorija `/var/lib/etcd/cleanroom`. U tom slučaju [prilagodite dozvole za direktorij](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Primjer izlaza za `patroni` kada usluga radi**
>
> ```
>  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
> ```

> **Primjer izlaza za `patroni` kada je usluga u stanju pogreške**
>
> ```
>  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
> ```
>
> U gornjem slučaju usluga ima stanje `active (running)`, a zapravo ne radi: zapisnici pokazuju razne pogreške povezivanja s uslugom `etcd`, koja je potrebna usluzi `patroni`.
> U ovom primjeru `patroni` nije nužno uzrok: budući da ovisi o usluzi `etcd`, najprije riješite probleme s uslugom `etcd`, a zatim ponovno provjerite stanje usluge `patroni`.

## Postupci otklanjanja poteškoća s uslugama

U nastavku se nalazi po jedan postupak otklanjanja poteškoća za svaku uslugu. Ako ispravno ne rade ni `etcd` ni `patroni`, počnite s uslugom `etcd`.

- **[Otklanjanje poteškoća s uslugom `etcd`](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Postupak koji treba slijediti kada usluga `etcd` ne radi ispravno.
- **[Otklanjanje poteškoća s uslugom `patroni`](https://docs.cyberelements.io/bastion/4.6/hr/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Postupak koji treba slijediti kada usluga `patroni` ne radi ispravno.
