Pāriet uz saturu

Instalēšana

Piezīme

Atgādinām, ka Debian datoros pārslēgšanās uz root jāveic ar tālāk norādīto komandu:

1
su -

Šajā lapā sniegtie norādījumi ir jāievēro, instalējot visus PostgreSQL klastera mezglus.

Sistēmas iestatījumi

Savienojums ar datoru

Pēc noklusējuma virtuālajās ierīcēs ir divi konti: lietotāja konts un superlietotāja konts.

  • Lietotāja konts
    • Pieteikšanās vārds: systancia
    • Parole: systnci
  • Superlietotāja konts
    • Pieteikšanās vārds: root
    • Parole: systnci

Izveidojiet savienojumu ar datoru konsoles režīmā.

Piezīme

Noklusējuma tastatūras izkārtojums ir QWERTY.

Tastatūras izkārtojuma maiņa

Tastatūras izkārtojumu var mainīt ar šādu komandrindu:

1
dpkg-reconfigure keyboard-configuration

Tiek parādīta izvēlne, kurā varat izvēlēties citu tastatūras izkārtojumu.

Pēc tam izmantojiet šo komandrindu, lai lietotu un saglabātu iestatījumus:

1
setupcon -k --save

Iestatījumi stāsies spēkā uzreiz pēc šīs komandas izpildes.

Tīkla konfigurācija

Virtuālā ierīce startēšanas laikā var nesaņemt tīkla konfigurāciju šādu iemeslu dēļ:

  • Tīkla saskarnes nosaukums nav ens192: appliance izmanto DHCP tikai saskarnē ens192
  • Nav pieejams neviens DHCP serveris

Lai pārbaudītu tīkla saskarnes nosaukumu, tās statusu un piešķirtās IP adreses, izpildiet šādu komandu kā root:

1
ip -br a | grep -ve "^lo"
Piemērs

Pēc komandas izpildes tiek parādīta šāda atbilde:

1
ens192      UP      10.100.0.51/24

Piemērā tīkla saskarnes nosaukums ir ens192, saskarne ir aktīva, un tai ir IP adrese 10.100.0.51/24.

Ja nosaukums atšķiras no ens192 vai ja komanda neatgriež tīkla iestatījumus, tīkls būs jākonfigurē manuāli, izmantojot šādas komandas:

1
2
ip address add IP_ADDRESS/SUBNET dev DEV_NAME
ip route add default via GATEWAY

Aizstājiet:

  • IP_ADDRESS ar datora IP adresi
  • SUBNET ar apakštīklu
  • DEV_NAME — iepriekš izgūtās tīkla saskarnes nosaukums
  • GATEWAY ar tīkla vārteju
Piemērs

Lai konfigurētu PostgreSQL mezglu ar šādu informāciju:

  • IP adrese: 10.100.0.51
  • Apakštīkls: /24 vai 255.255.255.0
  • Tīkla saskarnes nosaukums: eth0
  • Tīkla vārteja: 10.100.0.254

Komandas ir šādas:

1
2
ip address add 10.100.0.51/24 dev eth0
ip route add default via 10.100.0.254

Piezīme

Šī tīkla konfigurācija ir īslaicīga, tāpēc jebkura servera restartēšana atiestatīs manuālos iestatījumus, kas veikti ar komandām ip address un ip route.
Pastāvīgo konfigurāciju veiks PostgreSQL klastera konfigurācijas utilīta.

Tomēr, pateicoties šai tīkla konfigurācijai, tagad varat piekļūt PostgreSQL mezglam, izmantojot SSH.

Laika joslas maiņa

Pēc noklusējuma virtuālajai ierīcei ir iestatīta laika josla Europe/Paris.

Lai mainītu šo laika joslu, vispirms ar šo komandu iegūstiet pieejamo laika joslu sintaksi:

1
timedatectl list-timezones

Pēc tam izmantojiet šo komandrindu:

1
timedatectl set-timezone your_time_zone
Piemērs

Lai iestatītu Londonas laika joslu, ir jāizpilda šāda komanda:

1
timedatectl set-timezone Europe/London

Pārbaudiet servera laika joslu, izmantojot šo komandrindu:

1
timedatectl

NTP laika servera konfigurēšana

Bīstami

Ir ļoti ieteicams konfigurēt laika serveri, lai sistēmas pulkstenis vienmēr būtu aktuāls: jebkura laika atšķirība starp PostgreSQL mezgliem var izraisīt nestabilitāti vai pat klastera darbības apturēšanu.

Nepieciešamās darbības ir aprakstītas NTP konfigurācijas lapā (konfigurācija ir līdzvērtīga CyberElements Bastion Mediation Controller serveru konfigurācijai).

PKI izveide PostgreSQL mezglu sertifikātu ģenerēšanai

Informācija

Šī nodaļa nav obligāta, ja jums jau ir PKI, ar kuru varat ģenerēt priekšnosacījumos norādītos sertifikātus.
Šajā nodaļā ir aprakstītas dažādas darbības PKI un PostgreSQL klasterim nepieciešamo sertifikātu izveidei. Ņemiet vērā, ka nav norādīts, kā tos atjaunot, jo sertifikāta atjaunošana nozīmē tā atkārtotu izveidi.

Izlaist šo darbību

Uzmanību!

Aprakstītā procedūra ir validēta Debian 12 datorā ar pakotni openssl. Tomēr procedūru var veikt jebkurā datorā ar jaunu OpenSSL versiju (validētā versija ir 3.0.17). Izņēmums ir Windows vai MacOS, kur sistēmas komandas būs jāpielāgo.

Mainīgo un pielāgojumu definēšana

Šajā nodaļā ir sniegtas dažādas komandas un konfigurācijas faili, kuros tiek izmantoti maināmi mainīgie.
Tālāk esošajā tabulā ir apkopotas visas vērtības, un tā ļauj tās definēt, lai tās varētu modificēt tieši šajā lapā parādītajās komandās.

Vērtība Mainīgais Definīcija
PSQL_IP PostgreSQL klastera virtuālā IP adrese.
PSQL_NAME Īsais nosaukums (nevis FQDN), kas saistīts ar PostgreSQL klastera virtuālo IP adresi.
PSQL_1_IP PostgreSQL klastera mezgla Nr. 1 IP adrese.
PSQL_1_NAME PostgreSQL klastera mezgla Nr. 1 īsais nosaukums (nevis FQDN).
PSQL_2_IP PostgreSQL klastera mezgla Nr. 2 IP adrese.
PSQL_2_NAME PostgreSQL klastera mezgla Nr. 2 īsais nosaukums (nevis FQDN).
PSQL_3_IP PostgreSQL klastera mezgla Nr. 3 IP adrese.
PSQL_3_NAME PostgreSQL klastera mezgla Nr. 3 īsais nosaukums (nevis FQDN).
CA_ROOT_NAME Nosaukums, kas piešķirts PKI saknes sertifikācijas iestādei (CA).

Sagatavošana

Tālāk minētās darbības tiks veiktas jaunā direktorijā, lai visus jaunos failus apkopotu vienā direktorijā. Var izmantot jebkuru direktoriju, taču piekļuvei tam jābūt pēc iespējas ierobežotai. Piesakieties PostgreSQL mezglā Nr. 1 kā root un izpildiet šādas komandas:

1
2
3
mkdir /root/psql-certificates/
chmod 600 /root/psql-certificates/
cd /root/psql-certificates/

Saknes sertifikācijas iestādes izveide

Izpildiet šo komandu, lai izveidotu jaunu saknes CA. Jums tiks lūgts ievadīt paroli CA aizsardzībai:

1
openssl req -x509 -newkey rsa:4096 -days 3650 -sha512 -keyout CA_ROOT_NAME.key -out CA_ROOT_NAME.crt -subj "/CN=CA_ROOT_NAME" -extensions v3_ca -addext "subjectKeyIdentifier=hash" -addext "authorityKeyIdentifier=keyid:always,issuer:always" -addext "basicConstraints=critical,CA:true" -addext "keyUsage=critical,digitalSignature,cRLSign,keyCertSign"

Aizstājiet CA_ROOT_NAME ar saknes CA nosaukumu, ja tas nav pielāgots šeit.

Sertifikātu izveide

Komandas, kas nepieciešamas PostgreSQL mezglu sertifikātu ģenerēšanai, ir šādas:

1
2
3
openssl genrsa -out PSQL_1_NAME.key 4096
openssl req -new -key PSQL_1_NAME.key -out PSQL_1_NAME.csr -subj "/CN=PSQL_1_NAME"
openssl x509 -req -in PSQL_1_NAME.csr -CA CA_ROOT_NAME.crt -CAkey CA_ROOT_NAME.key -CAcreateserial -out PSQL_1_NAME.crt -days 1825 -sha512 -extfile <(printf "subjectKeyIdentifier=hash\nauthorityKeyIdentifier=keyid,issuer\nbasicConstraints=critical,CA:FALSE\nkeyUsage=critical,digitalSignature\nextendedKeyUsage=serverAuth,clientAuth\nsubjectAltName=DNS:PSQL_NAME,DNS:PSQL_1_NAME,IP:PSQL_IP,IP:PSQL_1_IP")

Aizstājiet CA_ROOT_NAME, PSQL_IP, PSQL_NAME, PSQL_1_IP un PSQL_1_NAME, ja tie nav pielāgoti šeit.

1
2
3
openssl genrsa -out PSQL_2_NAME.key 4096
openssl req -new -key PSQL_2_NAME.key -out PSQL_2_NAME.csr -subj "/CN=PSQL_2_NAME"
openssl x509 -req -in PSQL_2_NAME.csr -CA CA_ROOT_NAME.crt -CAkey CA_ROOT_NAME.key -CAcreateserial -out PSQL_2_NAME.crt -days 1825 -sha512 -extfile <(printf "subjectKeyIdentifier=hash\nauthorityKeyIdentifier=keyid,issuer\nbasicConstraints=critical,CA:FALSE\nkeyUsage=critical,digitalSignature\nextendedKeyUsage=serverAuth,clientAuth\nsubjectAltName=DNS:PSQL_NAME,DNS:PSQL_2_NAME,IP:PSQL_IP,IP:PSQL_2_IP")

Aizstājiet CA_ROOT_NAME, PSQL_IP, PSQL_NAME, PSQL_2_IP un PSQL_2_NAME, ja tie nav pielāgoti šeit.

1
2
3
openssl genrsa -out PSQL_3_NAME.key 4096
openssl req -new -key PSQL_3_NAME.key -out PSQL_3_NAME.csr -subj "/CN=PSQL_3_NAME"
openssl x509 -req -in PSQL_3_NAME.csr -CA CA_ROOT_NAME.crt -CAkey CA_ROOT_NAME.key -CAcreateserial -out PSQL_3_NAME.crt -days 1825 -sha512 -extfile <(printf "subjectKeyIdentifier=hash\nauthorityKeyIdentifier=keyid,issuer\nbasicConstraints=critical,CA:FALSE\nkeyUsage=critical,digitalSignature\nextendedKeyUsage=serverAuth,clientAuth\nsubjectAltName=DNS:PSQL_NAME,DNS:PSQL_3_NAME,IP:PSQL_IP,IP:PSQL_3_IP")

Aizstājiet CA_ROOT_NAME, PSQL_IP, PSQL_NAME, PSQL_3_IP un PSQL_3_NAME, ja tie nav pielāgoti šeit.

Pirmā komanda izveido jaunu atslēgu, otrā ģenerē sertifikāta parakstīšanas pieprasījuma failu CSR, bet trešā izveido pašu sertifikātu.

Sertifikāts vēl ir jāpārveido formātā P12, un šim nolūkam jums būs jāiestata parole:

1
openssl pkcs12 -chain -CAfile CA_ROOT_NAME.crt -export -inkey PSQL_1_NAME.key -in PSQL_1_NAME.crt -out PSQL_1_NAME.p12
1
openssl pkcs12 -chain -CAfile CA_ROOT_NAME.crt -export -inkey PSQL_2_NAME.key -in PSQL_2_NAME.crt -out PSQL_2_NAME.p12
1
openssl pkcs12 -chain -CAfile CA_ROOT_NAME.crt -export -inkey PSQL_3_NAME.key -in PSQL_3_NAME.crt -out PSQL_3_NAME.p12

Failus, kas nepieciešami PostgreSQL klastera instalēšanai, varat atrast šeit (aizstājiet mainīgos CA_ROOT_NAME, PSQL_1_NAME, PSQL_2_NAME un PSQL_3_NAME ar iepriekš atlasītajām vērtībām):

  • /root/psql-certificates/CA_ROOT_NAME.crt: saknes CA sertifikāts
  • /root/psql-certificates/PSQL_1_NAME.p12: PostgreSQL mezgla Nr. 1 sertifikāts
  • /root/psql-certificates/PSQL_2_NAME.p12: PostgreSQL mezgla Nr. 2 sertifikāts
  • /root/psql-certificates/PSQL_3_NAME.p12: PostgreSQL mezgla Nr. 3 sertifikāts

PostgreSQL klastera instalēšana

Informācija

Tālāk norādītās darbības ir jāveic visos trīs PostgreSQL mezglos.

Sagatavošanās PostgreSQL klastera konfigurēšanai

Ir jāizveido SFTP vai SCP savienojums, lai uz appliance nosūtītu:

  • Tās sertifikācijas iestādes sertifikātu, kura parakstīja PostgreSQL mezglu sertifikātus
  • PostgreSQL mezgla sertifikātu formātā P12

Ņemiet vērā, ka SFTP vai SCP savienojumus nevar inicializēt, izmantojot kontu root. Turklāt failus var vienkārši ievietot direktorijā /home/systancia/.

Šie faili ir jāpārvieto uz jaunu direktoriju:

1
2
3
mkdir /etc/ssl/certs/cleanroom/
mv /home/systancia/PSQL_?_NAME.p12 /etc/ssl/certs/cleanroom/
mv /home/systancia/ROOT_CA_NAME.crt /etc/ssl/certs/cleanroom/

Aizstājiet:

  • PSQL_?_NAME ar tā sertifikāta nosaukumu, kas paredzēts instalējamajam PostgreSQL mezglam
  • ROOT_CA_NAME ar saknes sertifikācijas iestādes sertifikāta nosaukumu
1
2
3
mkdir /etc/ssl/certs/cleanroom/
cp /root/psql-certificates/PSQL_1_NAME.p12 /etc/ssl/certs/cleanroom/
cp /root/psql-certificates/CA_ROOT_NAME.crt /etc/ssl/certs/cleanroom/

Iepriekš minētajām komandām ir jābūt pielāgotām atbilstoši pielāgošanas iestatījumiem.

1
2
3
mkdir /etc/ssl/certs/cleanroom/
mv /home/systancia/PSQL_2_NAME.p12 /etc/ssl/certs/cleanroom/
mv /home/systancia/CA_ROOT_NAME.crt /etc/ssl/certs/cleanroom/

Iepriekš minētajām komandām ir jābūt pielāgotām atbilstoši pielāgošanas iestatījumiem.

1
2
3
mkdir /etc/ssl/certs/cleanroom/
mv /home/systancia/PSQL_3_NAME.p12 /etc/ssl/certs/cleanroom/
mv /home/systancia/CA_ROOT_NAME.crt /etc/ssl/certs/cleanroom/

Iepriekš minētajām komandām ir jābūt pielāgotām atbilstoši pielāgošanas iestatījumiem.

PostgreSQL mezgla konfigurēšana

Lai sāktu mezgla konfigurācijas inicializēšanu, ir jāizpilda šādas komandas:

1
2
cd /etc/ssl/certs/cleanroom/
ConfigureSystanciaVault.py

Otrā komanda palaidīs utilītu, kas pieprasīs šādu informāciju:

  1. Jaunas paroles lokālajiem lietotājiem root un systancia
  2. PostgreSQL mezgla nosaukums (nevis FQDN)
  3. PostgreSQL mezgla IP adrese, tā tīkla saskarnes nosaukums, izmantojamā noklusējuma tīkla vārteja, kā arī DNS serveri un DNS sufikss
  4. PostgreSQL versija; ieteicams izmantot versiju 15
  5. Piekļuves ports PostgreSQL klasterim; ieteicams izmantot portu 5432
  6. Parole PostgreSQL kontam, kas tiek izmantots replicēšanai un pg_rewind
  7. Otrā PostgreSQL mezgla nosaukums un IP adrese
  8. Pēdējā PostgreSQL mezgla nosaukums un IP adrese
  9. PostgreSQL klastera virtuālā IP adrese
  10. IP adreses (atdalītas ar komatiem) CyberElements Bastion Edge Gateway vai jebkuriem citiem datoriem, kuriem jāizveido savienojums ar klasteri
  11. PostgreSQL lietotāja konta nosaukums un parole
  12. IP adreses vai tīkli (atdalīti ar komatiem), kuriem ir atļauts izveidot SSH savienojumu ar PostgreSQL mezgliem
  13. PostgreSQL mezgla sertifikāta informācija (mezgla sertifikāts formātā P12 + saknes CA sertifikāts)

Pēc šīs informācijas ievadīšanas pirms apstiprināšanas tiks parādīts visu jūsu ievadīto datu kopsavilkums.
Pēc sniegtās informācijas apstiprināšanas tiks parādīts ziņojums par faila /etc/ssh/sshd_config izmaiņām. Atlasiet noklusējuma opciju keep the local version currently installed.

Lai lietotu konfigurāciju, ir nepieciešama restartēšana:

1
reboot
Padoms PostgreSQL mezglu Nr. 2 un Nr. 3 instalēšanas paātrināšanai

Pēc PostgreSQL mezgla Nr. 1 instalēšanas tā iestatīšanai izmantotos konfigurācijas iestatījumus varat izgūt no faila /etc/cleanroom-vault.ini.

Faila /etc/cleanroom-vault.ini piemērs

 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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
[local]
name = PSQL-1
ip = 172.16.10.51

[cluster]
server1 = PSQL-2,172.16.10.52
server2 = PSQL-3,172.16.10.53

[ssl]
ca = MY-ROOT-CA.crt
client_cert = /etc/cleanroomvault.crt
client_key = /etc/cleanroomvault.key
peer_cert = /etc/cleanroomvault.crt
peer_key = /etc/cleanroomvault.key

[postgresql]
port = 5432
cluster = cleanroomvault5
version = 15

[patroni]
api_port = 8008
replication_password = R3pl1cationP@SSw0rd
rewind_password = Rew1ndP@SSw0rd

[vip]
interface = ens192
ip = 172.16.10.50

[cleanroom]
gw_ips = 172.16.10.10, 172.16.10.11
db_user = DbUser
db_password = DbP@SSw0rd

[networking]
interface = ens192
ip = 172.16.10.51/24
gateway = 172.16.10.254
dns = 172.16.10.100
dnssuffix = domain.local

[ssh]
allow = 10.0.20.0/24

Vienkārši modificējiet izceltās rindas ar instalējamā PostgreSQL mezgla vērtībām, pamatojoties uz failu, ko izguvāt no PostgreSQL mezgla Nr. 1.

Bīstami

Ja atkārtoti izmantojat piemēra failu, visas tālāk izceltās vērtības būs jāmodificē atbilstoši jūsu videi:

 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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
[local]
name = PSQL-1
ip = 172.16.10.51

[cluster]
server1 = PSQL-2,172.16.10.52
server2 = PSQL-3,172.16.10.53

[ssl]
ca = MY-ROOT-CA.crt
client_cert = /etc/cleanroomvault.crt
client_key = /etc/cleanroomvault.key
peer_cert = /etc/cleanroomvault.crt
peer_key = /etc/cleanroomvault.key

[postgresql]
port = 5432
cluster = cleanroomvault5
version = 15

[patroni]
api_port = 8008
replication_password = R3pl1cationP@SSw0rd
rewind_password = Rew1ndP@SSw0rd

[vip]
interface = ens192
ip = 172.16.10.50

[cleanroom]
gw_ips = 172.16.10.10, 172.16.10.11
db_user = DbUser
db_password = DbP@SSw0rd

[networking]
interface = ens192
ip = 172.16.10.51/24
gateway = 172.16.10.254
dns = 172.16.10.100
dnssuffix = domain.local

[ssh]
allow = 10.0.20.0/24

Kad visi PostgreSQL mezgli ir instalēti, izdzēsiet failu /etc/cleanroom-vault.ini no katra mezgla, jo tajā atklāta teksta veidā ir saglabātas konfigurēšanas laikā ievadītās paroles:

1
rm /etc/cleanroom-vault.ini

patronictl papildu konfigurācijas

Lai iespējotu PostgreSQL klastera pārvaldības komandu izmantošanu ar patronictl, PostgreSQL mezglā kā root vēl ir jāizpilda dažas komandas:

1
2
3
4
sed -i "s/2380/2380, 8008/g" /etc/nftables.conf
systemctl reload nftables
cp /etc/patroni/ca.crt /usr/local/share/ca-certificates/PSQL-CA.crt
update-ca-certificates

etcd papildu konfigurācijas

Lai iespējotu etcd datu bāzes automātisku kompaktēšanu un defragmentēšanu, PostgreSQL mezglā kā root izpildiet šādas komandas:

1
2
3
4
5
6
7
apt update
apt install etcd-client
echo -e 'ETCD_AUTO_COMPACTION_MODE="periodic"\nETCD_AUTO_COMPACTION_RETENTION="1"' >> /etc/default/etcd
systemctl restart etcd
echo -e '#!/bin/bash\n\nsource /etc/default/etcd\netcdctl --endpoints=${ETCD_ADVERTISE_CLIENT_URLS}  --cert=${ETCD_CERT_FILE} --key=${ETCD_KEY_FILE} "$@"' > /usr/bin/clr_etcdctl
chmod a+x /usr/bin/clr_etcdctl
echo '0 3 * * * root clr_etcdctl defrag' > /etc/cron.d/systancia-db

CyberElements Bastion instalēšanai nepieciešamās datu bāzes default izveide

Instalējot CyberElements Bastion, vispirms ir jāizveido datu bāze ar nosaukumu default.
Lai to paveiktu, aizpildiet tālāk redzamo tabulu, lai pielāgotu komandu, kas jums būs jāizpilda no tāda PostgreSQL klastera mezgla, kas nav mezgls LEADER:

Vērtība Mainīgais Definīcija
PSQL_VIP PostgreSQL klastera virtuālā IP adrese.
DB_USER Datu bāzes lietotājvārds, kas norādīts PostgreSQL mezgla konfigurēšanas laikā

Komanda, kas jāizpilda no tāda PostgreSQL klastera mezgla, kas nav mezgls LEADER (skatiet, kā noteikt klastera mezglu LEADER):

1
createdb -h PSQL_VIP -U DB_USER default