HQbird replikasyon kümesi yönetici kılavuzu: hqclusternode ve hqbirdrcm (RCM). Yükleyiciler: HQbird 2027 İndirme.

İçindekiler


0. Giriş

Bu kılavuz, HQbird replikasyon kümesinin nasıl kurulacağını ve kullanılacağını anlatır: hqclusternode düğümleri ve küme yöneticisi hqbirdrcm (RCM).

Bu, Firebird yöneticisi için bir kılavuzdur. Firebird’ü, gfix ve nbackup bildiğinizi varsayıyoruz. Bir düğümün iç işleyişini bilmeniz gerekmez.

Küme nelerden oluşur

Bileşen Kaç tane Nerede çalışır Ne yapar
Firebird (HQbird) bir veya daha fazla örnek her veritabanı sunucusunda veritabanlarını saklar, replikasyon segmentleri yazar
fbagent her Firebird örneği için bir Firebird’ün yanında bir düğümün isteği üzerine Firebird’ü durdurur ve başlatır
hqclusternode (düğüm) her örnek ve rol için bir Firebird’ün yanında replikasyonu yapılandırır, segmentleri aktarır, replika ilklendirmesi yapar
hqbirdrcm (RCM) her küme için bir tüm düğümleri görebilen herhangi bir ana makinede web arayüzü, komutlar, uyarılar, istatistik

Bir düğümün bir rolü vardır: master (birincil) veya replica (replika). Tek bir Firebird örneğinde iki düğüm çalışabilir: bir birincil düğüm ve bir replika düğümü. Bu durumda bu Firebird’ün bazı veritabanları birincil, diğerleri replikadır.

Nasıl çalışır

  1. Birincilde Firebird, veritabanı değişikliklerini segmentlere (replikasyon günlük dosyaları) yazar.
  2. Birincil düğüm, segmentleri güvenli bir kanal (mTLS) üzerinden replika düğümüne gönderir.
  3. Replika düğümü segmentleri gelen segmentler klasörüne koyar. Replikanın Firebird’ü bunları veritabanının kendi kopyasına uygular.
  4. Birincil düğüm, veritabanının ilk kopyasını replikaya kendisi aktarır. Buna ilklendirme (reinit) denir. nbackup üzerinden gider ve birincil bu süre boyunca çalışmaya devam eder.
  5. Düğümler istatistiği RCM’ye gönderir. RCM kümenin durumunu gösterir ve işleten komutlarını düğümlere yollar.
Küme nasıl çalışır: segmentler, ilklendirme, istatistik ve işleten komutları
Küme nasıl çalışır: segmentler, ilklendirme, istatistik ve işleten komutları

Desteklenen sürümler

  • Firebird / HQbird 5.0 ve 4.0 — tüm özellikler.
  • HQbird 3.0 ve 2.5 — replconf eklentisi üzerinden replikasyon. Yayın yoktur; tablo kümesini süzgeçler belirler. Farklar „HQbird 2.5/3.0“ kutularında anlatılır.

Birincildeki ve replikadaki Firebird ana sürümü aynı olmalıdır. Aksi halde replika düğümü ilklendirmeyi reddeder.

Portlar

Port Kim dinler Kim bağlanır Ne için
7051 düğüm diğer düğümler ve RCM düğüm API’si, segmentlerin ve veritabanı kopyalarının aktarımı
7443 RCM tüm düğümler düğümlerden istatistik alma
7444 RCM işleten web arayüzü ve işleten API’si. RCM üzerinden kurulum (bölüm 1.3): tüm adreslerde HTTPS. HQCenter Admin üzerinden veya elle kurulum: HTTP, yalnızca 127.0.0.1
7450–7459 fbagent, bağlama penceresi açıkken RCM ana makineleri bağlama (bölüm 1.3)
13050 fbagent, yalnızca 127.0.0.1 aynı ana makinedeki düğüm Firebird yönetimi
3050 Firebird uygulamalar normal veritabanı çalışması

Bir ana makinede iki düğüm varsa (birincil ve replika), ikinci düğümün portu farklıdır. RCM üzerinden kurulumda ikinci düğüm 7061 portunu alır. Diğer durumlarda portu kendiniz belirlersiniz, örneğin 7052.

13050 portu ağa açılmamalıdır. HTTP ile 7444 portu da (HQCenter Admin üzerinden veya elle kurulum) açılmamalıdır: RCM web arayüzüne bir SSH tüneli üzerinden bağlanın (bölüm 1). RCM üzerinden kurulumda 7444 portu HTTPS üzerinde çalışır ve yükleyici onu güvenlik duvarında açar.

Ana kural: fbagent yoksa değişiklik yok

Bir düğüm replikasyon yapılandırmasını yalnızca fbagent üzerinden değiştirir: Firebird’ü yeniden başlatması gerekir. fbagent kullanılamıyorsa düğüm, yapılandırmayı değiştiren her eylemi reddeder. „Kısmen“ çalışmaz.

Terimler

Terim Anlam
Segment veritabanı değişikliklerini içeren bir replikasyon günlük dosyası
Yayın değişiklikleri segmentlere giden birincil tabloların listesi (Firebird 4/5)
İlklendirme (reinit) veritabanı kopyasının birincilden replikaya nbackup ile aktarımı
Veritabanı GUID Firebird veritabanı tanımlayıcısı; RCM birincil ile replikayı bununla bağlar
Eş eş düğüm: bir birincil için onun replikaları
Eşlikçi aynı Firebird örneğindeki ikinci düğüm (bir ana makinede birincil ve replika)
Kayıt birincil veritabanlarının düğüme kaydı

Kılavuz nasıl okunur

Bölüm Konu
1. Kurulum düğümlerin ve RCM’nin HQCenter Admin üzerinden, HQCenter Admin olmadan RCM üzerinden ve elle kurulumu, Linux ve Windows
2. Küme yapılandırması birincil → replika bağları, düğüm ayarları, RCM kullanıcıları
3. Birincile veritabanı ekleme kayıt, Firebird’ü yeniden başlatma, doğrulama
4. Bir veritabanı nasıl replika yapılır aşamalar, replikayı hazırlama, disk alanı
5. İlklendirme reinit adımları, çalışmaya etkisi, uzun işlemler, hız, hatalar
6. Yayını yapılandırma Firebird 4/5 yayını, tablolar, yeni tablolar, HQbird 2.5/3.0
7. Diğer replikasyon seçenekleri replication.conf parametreleri, arşiv, aktarım, uyarılar, duraklatma, günlükler
8. Replikayı normal veritabanına çevirme Normal yap, Birincile yükselt, yeni GUID, hizmetler (planlı geçiş, yük devretme), geçiş denetim listesi

Tüm bölümler tek bir örnek kullanır:

Ne Değer
node-a birincil düğüm, veritabanları /databases/master içinde
node-b replika düğüm, veritabanları /databases/replica içinde
RCM ayrı bir ana makine (veritabanı sunucularından biri de olabilir)
veritabanı employee.fdb

1. Düğümlerin ve hqbirdrcm kurulumu

Üç kurulum yolu vardır:

Yol Ne zaman seçilir Sizin yaptığınız
HQCenter Admin üzerinden (1.2) olağan yol: HQCenter Admin güncelleme sunucusuna erişilir, otomatik güncellemeler gerekir fbagent kurulum betiğini çalıştırır, isteği onaylar, kümeyi tanımlarsınız
RCM üzerinden, HQCenter Admin olmadan (1.3) HQCenter Admin yoktur, ama sertifika, yapılandırma ve güncellemeler elle iş olmadan gerekir; en çok 3 veritabanı sunucusu her ana makineye HQbird kurar, RCM’ye giriş yapar ve Ayarlar → Ana makineleri bağla içinde ana makine adreslerini belirtirsiniz
Elle (1.4) HQCenter Admin erişimi yok, kapalı ağ, özel gereksinimler dosyaları kurar, sertifika oluşturur, node.json ve rcm.json yazar, hizmetleri kaydedersiniz

HQCenter Admin üzerinden ve RCM üzerinden düğümleri ve RCM’yi kendiniz kurmazsınız. Onları, kümeye eklediğinizde fbagent kurar (bölüm 2). Sertifikalar ve yapılandırma da kendiliğinden oluşturulur.

Linux ve Windows tek bir bölümde anlatılır. Windows farkları „Windows’ta“ kutularındadır.

1.1. Gereksinimler

Her veritabanı sunucusunda:

  • Firebird / HQbird 5.0, 4.0, 3.0 veya 2.5 (2.5 — yalnızca Linux).
  • Her Firebird örneğinin yanında fbagent. fbagent olmadan düğüm çalışmaz.
  • Tüm sunucularda ve RCM ana makinesinde saat eşitlemesi (NTP, chrony, w32time). Yeniden başlatma ve aktarım pencereleri, gecikme tahmini ve „düğüm yanıt vermiyor“ denetimi saatlere bağlıdır.
  • Segment arşivi ve replika ilklendirmesi için boş alan (bölüm 4).
  • Port tablosuna göre ağ (bölüm 0).

Linux: root yetkileri, x86_64, systemd, curl. Desteklenenler: Ubuntu 20–26, Debian 11–13, Astra, CentOS 7–10, AlmaLinux, Rocky, Oracle Linux 8–10, RED OS, openSUSE 15.6, Fedora 44+.

Windows: yönetici yetkileri, x64, Windows 10 / Server 2016 veya daha yenisi, 64 bit Windows PowerShell 5.1. Windows 10 ve Server 2016–2022 üzerinde 7-Zip gerekir.

RCM nerede çalışacak. Küme başına bir RCM gerekir. Tüm düğümleri görebilen herhangi bir sunucuya, veritabanı sunucularından biri dahil, kurulabilir.

1.2. HQCenter Admin üzerinden kurulum

Adım 1. fbagent kurulum betiğini çalıştırın

Betik Firebird’ü (HQbird derlemesi), fbagent’ı kurar ve fbagent’ı HQCenter Admin sunucusuna kaydeder. Firebird sürümünüze uyan betiği seçin: fb25, fb30, fb40, fb50.

Linux (root olarak):

Command
sudo sh fbagent-fb50_known.sh --goafts <HQCenter-Admin-server> --enroll --cluster

Windows’ta (yönetici olarak PowerShell):

Command
powershell -NoProfile -ExecutionPolicy Bypass -File .\fbagent-fb50_known.ps1 -Enroll

Windows’ta -Cluster parametresi yoktur: fbagent LocalSystem olarak çalışır ve küme klasörlerini kendisi oluşturur.

Ana parametreler:

Linux Windows Anlam
--goafts <name> -Goafts indirmenin yapılacağı HQCenter Admin sunucusu; adı tedarikçiniz verir
--enroll -Enroll fbagent’ı HQCenter Admin’e kaydet (sertifika isteği)
--cluster — /opt/hqclusternode ve /opt/hqbirdrcm klasörlerini oluştur (yalnızca fbagent 2.55.2 ve daha eskisi için gerekir; daha yeni sürümlerde zararsızdır)
--channel -Channel fbagent güncelleme kanalı, varsayılan stable
--token -Token lisans belirteci: HQCenter Admin isteği kendiliğinden onaylar
--port -Port Firebird portu
--yes -Yes soru sorma (uçbirim yokken gerekir)

Parametrenin tam listesi için fbagent kurulum betiğinin README dosyasına bakın.

Adım 2. fbagent isteğini onaylayın

--enroll parametresiyle fbagent, HQCenter Admin’e bir sertifika isteği (CSR) gönderir ve onay için 30 dakikaya kadar bekler. Şöyle onaylayabilirsiniz:

  • kendiliğinden — kurulum bir lisans belirteciyle (--token) çalıştırıldıysa ve lisansın boş yeri varsa;
  • HQCenter Admin panelinde — CSR istekleri bölümü, bu ana makinenin isteği, onayla ve imzala düğmesi;
  • HQCenter Admin API’si üzerinden — POST /v1/admin/csr-requests/{id}/approve.

Kayıt başarılı olmazsa (örneğin bekleme süresi dolarsa) fbagent yine de çalışır, ama betik 2 koduyla çıkar. Betiği aynı parametrelerle yeniden çalıştırın: yalnızca kayıt yinelenir.

Kayıttan birkaç dakika sonra fbagent HQ Monitor’ü kendisi kurar.

Adım 3. Kümeyi tanımlayın

Düğümler ve RCM, fbagent’ı HQCenter Admin kümesine eklediğinizde ortaya çıkar. Kümenin nasıl tanımlandığı bölüm 2 konusundadır.

Kümeyi kaydettikten sonra:

  1. 10 dakika içinde fbagent kümeyi HQCenter Admin’den alır (bundan sonra değişiklikleri her 60 saniyede bir denetler).
  2. RCM ana makinesindeki fbagent, kümenin sertifika yetkilisini (CA) oluşturur ve tüm düğümlerin sertifikalarını imzalar.
  3. Her fbagent, küme üyeleri için node.json veya rcm.json yazar.
  4. Sonraki ürün denetiminde (her 3 dakikada bir) fbagent hizmetleri kurar ve başlatır.

Nereye ne kurulur:

Ne Linux Windows
Birincil düğüm /opt/hqclusternode/master/, hizmet hqclusternode-master-p<port> <HQbird>\hqclusternode\master\, hizmet HQClusterNode-master-p<port>
Replika düğüm /opt/hqclusternode/replica/, hizmet hqclusternode-replica-p<port> <HQbird>\hqclusternode\replica\, hizmet HQClusterNode-replica-p<port>
RCM /opt/hqbirdrcm/, hizmet hqbirdrcm <HQbird>\hqbirdrcm\, hizmet hqbirdrcm

<port> Firebird portudur, örneğin 3050. Tek bir fbagent en çok bir birincil düğüm, bir replika düğüm, bir RCM ve bir yönlendirici barındırabilir (hqclusternode router, HQbird 2027.2.30’dan beri, bölüm 8.7).

Windows’ta. 2.83.0 öncesi fbagent sürümleri düğümleri C:\hqclusternode, RCM’yi C:\hqbirdrcm içine kurardı. Bu klasörler varsa fbagent onları kullanmaya devam eder.

Güncellemeler

  • fbagent, düğümün ve RCM’nin yeni sürümlerini her 3 dakikada bir denetler; varsayılan kanal stable dir. Önce replika düğümü, sonra birincil düğüm güncellenir.
  • Güncellemeden sonra hizmet başlamazsa veya yanlış sürüm bildirirse, fbagent önceki sürüme döner ve yenisini engeller. Engel listesi: <fbagent folder>/update/<product>/blocked-versions.json. Sürümü yeniden denemek için satırını bu dosyadan silin.
  • Ürün durumu: fbagent --product-status hqclusternode (veya hqbirdrcm).

1.3. RCM üzerinden kurulum (HQCenter Admin olmadan)

Kümeyi RCM yönetir. Her ana makinenin fbagent’ı küme tanımını RCM’den alır, RCM ana makinesindeki fbagent sertifikaları imzalar, düğüm ve RCM ise RCM’nin sakladığı sürümlerden güncellenir.

Sınırlamalar:

  • RCM başına bir küme.
  • En çok 3 yer. Yer, birincil veya replika düğüm çalıştıran bir ana makinedir. Aynı ana makinedeki birincil ve replika bir yer sayılır. Yalnızca RCM çalıştıran bir ana makine yer kaplamaz. Dördüncü ana makine seats_exceeded hatasını verir.
  • RCM, fbagent’ı veya Firebird’ü güncellemez. fbagent onları kendisi günceller ve replication.conf, node.json, rcm.json veya sertifikalara dokunmaz.

İki yol vardır:

  • RCM’de ana makineleri bağla — olağan yol. Üç eylem: her ana makinede yükleyici (birinde RCM, diğerlerinde keşif kipi), RCM’ye giriş, Ana makineleri bağla formu.
  • Komut satırından elle — katılma belirteçleri ve fbagent --cluster-join. Ana makineler arasında 7450 portu kapalıysa veya eşleştirme penceresi çoktan kapandıysa gerekir.

Lisans. Deneme lisansı cluster özelliğini içerir. Deneme süresinden sonra lisans cluster içermiyorsa fbagent bir düğüm veya RCM kurmaz. Kurulu düğümlerin ve RCM’nin güncellemelerini hiçbir zaman engellemez. HQCenter Admin olmadan kayan bir lisans, online_check_days artı hoşgörü günlerinden sonra çalışmayı bırakır. Bu yüzden her fbagent’a bağlı bir lisans kurun:

Command
fbagent --license-request --out license_request.json
# send the file to the vendor and receive license.json
fbagent --license-install license.json

Lisans olmadan birincil segment göndermeyi durdurur (bölüm 2.8).

Portlar:

Port Nerede Kim bağlanır
7443 RCM ana makinesi tüm küme ana makinelerinin fbagent’ı ve düğümleri
7444 RCM ana makinesi işletenin tarayıcısı (RCM konsolu, HTTPS)
7450 (ikinci ve sonraki fbagent ana makinesinde — 7451…7459) keşif kipindeki ana makine, eşleştirme penceresi açıkken RCM ana makinesindeki RCM
7051 (aynı fbagent’ın ikinci düğümü — 7061) düğüm ana makineleri diğer düğümler ve RCM (1.4, adım 7)

RCM’de ana makineleri bağla

Sıfırdan örnek. İki Linux sunucusu, .run yükleyicisi, bağlama, kayıt, yayın, yük altında ilklendirme ve yeniden ilklendirme — ekran görüntüleri ve ölçümlerle: hqbird2027-linux-cluster-guide.ru.md kılavuzu ve hqbird2027-linux-cluster-runbook.ru.md çalışma kitabı (goafts deposu, belgeler klasörü).

Adım 1. Her ana makineye HQbird kurun

Her veritabanı sunucusuna HQbird’ü tam yükleyici ile kurun. HQCenter Admin’e kaydolmayın (--enroll).

Varsayılan olarak yükleyici bir küme yapılandırmaz. Düğüm ve RCM programlarını fbagent klasörüne koyar (update/<product>/staged/), ama RCM kurmaz, eşleştirme penceresini açmaz ve küme portlarını güvenlik duvarında açmaz. Küme iki parametreyle açılır:

Command
sudo sh hqbird2027-fb50-linux-<version>.run --rcm on               # RCM host
sudo sh hqbird2027-fb50-linux-<version>.run --cluster-pairing on   # other hosts

--rcm on — kümenin RCM’sinin çalışacağı tek ana makinede. Yükleyici:

  1. bu ana makinenin kümesini oluşturur (fbagent --cluster-init), küme adı ana makine adıdır;
  2. RCM’yi kurar ve başlatır, RCM konsolu 7444 portunda HTTPS üzerinde çalışır;
  3. rastgele parolalı ilk RCM yöneticisi rcmadmin oluşturur;
  4. güvenlik duvarında 7443, 7444 ve düğüm portu 7051 açar.

--cluster-pairing on (keşif kipi) — diğer her ana makinede. Yükleyici, fbagent’ın eşleştirme penceresini 24 saat açar: 7450 portu ve düğüm portu 7051. Pencere açıkken ağdaki bir RCM bu ana makineyi kümesine davet edebilir. fbagent bir dakika içinde 7450 portunu dinlemeye başlar.

Bu parametreler olmadan yükleyici kendisi sorar: metin arayüzünde bu Küme sayfasıdır, --no-tui ile iki sorudur. Varsayılan yanıt „hayır“ dır. Küme parametreleri olmadan --yes de her iki soruya „hayır“ der.

Sonunda yükleyici RCM: ve Pairing: satırlarını basar. RCM ana makinesinde:

text
RCM:        https://10.0.0.7:7444 (cluster db1)
CA hash:    sha256:7cfc1d4b…032d2582
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/db1/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing:    not needed: this agent runs the RCM; other agents link through it

Başka bir ana makinede:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-17T17:49:18Z (fingerprint sha256:0439e44a…91a2f9b9); an RCM may invite this host

Çıktıda parola yoktur: Password: satırındaki dosyadadır. Keşif kipindeki her ana makinenin fingerprint değerini not edin.

Linux yükleyicisindeki küme parametreleri:

Parametre Ne yapar
--rcm on|off bu ana makinede RCM kurar ve küme oluşturur; varsayılan off
--cluster-pairing on|off keşif kipi: eşleştirme penceresini 24 saat açar; varsayılan off
--pairing-port N yeni fbagent’ın eşleştirme portu, 7450–7459; varsayılan ilk boş port
--rcm-password-file F rastgele parola yerine F dosyasının ilk satırından RCM yönetici parolası
--cluster-id ID ana makine adı yerine küme adı ID (--rcm on ile)
--cluster-node on|off düğüm programını kurar; varsayılan on
--rcm-allow A,B bu ana makineyi yalnızca bu RCM’ler davet edebilir: adres, CIDR ağı veya ad

Bir ana makinedeki ilk fbagent eşleştirme portu 7450 ile düğüm portları 7051 ve 7061 alır. Aynı ana makinedeki ikinci örnek — 7451, 7052 ve 7062.

RCM ve eşleştirme penceresi daha sonra, yükleyici olmadan da açılabilir: HQ Monitor’de Kümeler sayfasında veya fbagent kullanıcısı olarak komutlarla:

Command
cd <fbagent folder>                                    # /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init <name>      # RCM host; open ports 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on      # window for 24 hours
sudo -u firebird ./fbagent --cluster-pairing off
sudo -u firebird ./fbagent --cluster-pairing status

Eski yükleyiciler (3.1.0 öncesi fbagent) kümeyi sormaz: her ana makineye RCM kurar ve her yerde eşleştirme penceresini açar. Bir ana makinenin RCM’si gerekir; diğer ana makinelerin RCM’leri bağlamadan sonra kendilerini durdurur.

Windows’ta. Windows yükleyicisinde aynı iki seçenek vardır: /RCM ve /DISCOVERY parametreleri.

Adım 2. RCM’ye giriş yapın

RCM ana makinesinin RCM: satırındaki adresi açın (https://<host>:7444). rcmadmin oturumu ve Password: satırındaki dosyadan parola ile giriş yapın. RCM hemen yeni bir parola ister (1.5).

Adım 3. Ana makineleri bağlayın

RCM’de Ayarlar → Ana makineleri bağla açın.

  1. Ana makineler alanına ana makine adreslerini veya adlarını, satır başına bir tane girin. İlk satır RCM ana makinesidir, zaten kümededir.
  2. Ana makineleri denetle düğmesine tıklayın. RCM her ana makinenin 7450–7459 eşleştirme portlarını yoklar ve platformu, Firebird sürümünü, parmak izini ve durumu gösterir. RCM ana makinesinin eşleştirme penceresine gerek yoktur. Parmak izlerini yükleyici çıktısıyla (Pairing: satırı) karşılaştırın.
  3. Birincil seçin (varsayılan ilk ana makine) ve Bağla düğmesine tıklayın.
Ana makineleri bağla: denetim sonucu
Ana makineleri bağla: denetim sonucu

RCM onay ister ve İlerleme bölümünde ilerlemeyi gösterir. Tüm düğümler çalışınca „Bitti“ der ve küme revizyon numarasını gösterir:

Ana makineleri bağla: tüm düğümler çalışıyor
Ana makineleri bağla: tüm düğümler çalışıyor

Komut satırından aynısı:

Command
cd /opt/hqbirdrcm
export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
./hqbirdrcm cluster link -hosts db1,db2,db3 -master db1

Bundan sonra ne olur:

  1. RCM her boş ana makineye bir davet gönderir.
  2. Ana makinenin fbagent’ı kümeye katılır ve eşleştirme portunu kapatır. Ana makinenin düğümsüz kendi RCM’si varsa fbagent onu durdurup devre dışı bırakır ve boş kümesini fbagent klasöründeki cluster/left/ altına taşır.
  3. RCM kümeyi kaydeder: birincilde <host>-master düğümü, diğer ana makinelerde <host>-replica, port 7051, birincil → replika bağları.
  4. Her ana makinenin fbagent’ı düğümü kurar ve başlatır. RCM tüm düğümler çalışana kadar bekler ve her ana makine için Çalışıyor gösterir.

Ana makineleri denetle sonrası ana makine durumları:

Durum Ne yapılır
Bağlamaya hazır bir şey yok. Altında „Bu ana makinenin kendi RCM’si bağlamadan sonra duracak“ yazıyorsa bu normaldir
Kümede ana makine zaten bu kümede
Hata unreachable 7450 portu kapalı: eşleştirme penceresi kapalı (varsayılan gibi) veya 24 saat geçmiş. Kurulumdan hemen sonra bir dakika bekleyip Ana makineleri denetle düğmesine yeniden tıklayın. Aksi halde pencereyi açın (--cluster-pairing on) ve güvenlik duvarını denetleyin
Hata in_other_cluster ana makine başka bir kümede
Hata claimed başka bir RCM bu ana makineyi şu anda bağlıyor
Hata seats_exceeded 3 yerden fazla

Sürümler. fbagent düğümü yalnızca RCM’den kurar. RCM imzalı sürümleri başlangıçta ve her 5 dakikada bir import/ klasöründen (rcm.json yanında) alır. Yükleyici, RCM ana makinesinin sürümlerini oraya koyar; diğer ana makinelerin fbagent’ları kendi platformlarının sürümünü kendileri indirir. Sürüm listesi Ana makineleri bağla sayfasının altındadır. Bir sürüm elle de içe aktarılabilir (aşağıdaki adım 5).

Komut satırından elle

Sıra: RCM ana makinesinde adım 1–3, diğer her ana makinede adım 4, RCM’de adım 5–6.

Adım 1. HQbird’ü fbagent ile kurun

HQbird’ü her veritabanı sunucusuna ve RCM ana makinesine tam yükleyici ile kurun. RCM ana makinesinde hemen --rcm on belirtebilirsiniz (o zaman adım 3 gerekmez). Diğer ana makinelerde küme parametresi belirtmeyin: varsayılan olarak RCM ve eşleştirme penceresi yoktur. HQCenter Admin’e kaydolmayın (--enroll).

RCM ana makinesinde yükleyici, RCM programını fbagent klasöründe bırakır (update/hqbirdrcm/staged/). O olmadan adım 3 no hqbirdrcm to install hatasıyla başarısız olur.

Adım 2. Bağlı lisansı kurun

Bölümün başındaki „Lisans“ gibi.

Adım 3. RCM ana makinesinde kümeyi oluşturun

Yükleyici kümeyi zaten oluşturduysa (--rcm on: çıktıda adresli bir RCM: satırı), bu adımı atlayın.

Komutu fbagent kullanıcısı olarak çalıştırın (Linux’ta — firebird), root olarak değil: aksi halde CA dosyaları ve rcm.json root’a ait olur.

Command
cd <fbagent folder>
sudo -u firebird ./fbagent --cluster-init shop-prod --address 10.0.0.7

Windows’ta (yönetici olarak PowerShell): .\fbagent.exe --cluster-init shop-prod --address 10.0.0.7

  • shop-prod — küme adı: küçük Latin harfleri, rakamlar ve -.
  • --address — diğer ana makinelerin bağlandığı RCM ana makinesinin adresi. Birkaç kez yinelenebilir. Parametre yoksa ana makinenin adresleri ve adı kullanılır.

Komut:

  1. küme CA’sını ve agent CA’sını oluşturur (fbagent klasöründe, clusterca/<name>/);
  2. RCM klasörüne RCM sertifikasını, rcm.json ve cluster-init.json yazar;
  3. RCM’yi kurar ve hqbirdrcm hizmetini kaydeder. Linux’ta hizmet ayrı hqbirdrcm kullanıcısı olarak çalışır;
  4. fbagent’ı RCM’ye geçirir (cluster.source = rcm) ve yeniden başlatır;
  5. RCM adresini ve CA parmak izini basar:
Code
Cluster:    shop-prod
RCM URL:    https://10.0.0.7:7443
CA hash:    sha256:9f86d0...

RCM URL ve CA hash değerlerini not edin: diğer ana makinelerde gerekir. Aynı küme için yeniden çalıştırmak güvenlidir: CA ve anahtarlar aynı kalır.

Hemen RCM’ye giriş yapın ve rcmadmin parolasını değiştirin (1.5).

Linux’ta. hqbirdrcm kullanıcısı fbagent grubundadır. RCM rcm.json dosyasını bu grup üzerinden okur ama yazamaz. Bu yüzden Ayarlar → RCM değişiklikleri kaydetmez (hata rcm_config_read_only). rcm.json dosyasını ana makinede fbagent kullanıcısı olarak düzenleyin ve RCM’yi yeniden başlatın.

Adım 4. Diğer ana makinelerin fbagent’larını bağlayın

  1. RCM ana makinesinde her fbagent için bir katılma belirteci oluşturun: RCM’de Ayarlar → Küme, Katılma belirteci oluştur düğmesi. Veya komut satırından:

    Command
    cd /opt/hqbirdrcm
    export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
    ./hqbirdrcm cluster join-token -note db2

    Belirteç 24 saat, yalnızca bir fbagent ve yalnızca bir kez geçerlidir. RCM onu bir kez, hazır komutla birlikte gösterir.

  2. Düğüm ana makinesinde bu komutu fbagent kullanıcısı olarak çalıştırın:

    Command
    cd <fbagent folder>
    sudo -u firebird ./fbagent --cluster-join https://10.0.0.7:7443 \
      --ca-hash sha256:9f86d0... --token-file token.txt

    --token-file yerine --token <token> kullanılabilir. Windows’ta — yönetici olarak PowerShell’de .\fbagent.exe ile aynıdır.

fbagent, RCM CA’sını parmak iziyle doğrular. Parmak izi uyuşmazsa durur ve hiçbir şey yazmaz. Sonra fbagent sertifikasını alır (90 gün, kendiliğinden yenilenir) ve yeniden başlar. Bağlı bir fbagent RCM’de Agent’lar tablosunda görünür. Üyesi yokken ana makineye bir şey kurulmaz.

Adım 5. Sürümleri RCM’ye içe aktarın

fbagent düğümü ve RCM’yi yalnızca RCM’den alır. Gerekli sürüm Aynadaki sürümler listesinde yoksa (Ayarlar → Ana makineleri bağla), her ürünü (hqclusternode, hqbirdrcm) ana makinelerinizin her platformu için içe aktarın (linux-amd64, windows-amd64). Sürüm dosyasını ve .sig imzasını tedarikçi verir.

Command
cd /opt/hqbirdrcm
sudo -u hqbirdrcm ./hqbirdrcm release import -config rcm.json \
  -file hqclusternode-linux-amd64 -product hqclusternode \
  -platform linux-amd64 -version 2027.5.12
sudo -u hqbirdrcm ./hqbirdrcm release list -config rcm.json
  • RCM imzayı <file>.sig içinde arar veya -sig ile belirtirsiniz. Geçerli bir tedarikçi imzası olmadan RCM dosyayı kabul etmez.
  • Yeni bir sürüm öncekinin yerini alır. RCM’yi yeniden başlatmak gerekmez.
  • fbagent yeni sürümleri her 3 dakikada bir denetler. Güncelleme sırası ve kilitleme, HQCenter Admin üzerinden olduğu gibidir (1.2, „Güncellemeler“).

Adım 6. Kümeyi tanımlayın

Üyeleri ve bağları RCM’de Ayarlar → Küme içinde ayarlayın (bölüm 2.3). Kaydettikten sonra fbagent düğümleri HQCenter Admin üzerinden olduğu gibi kurar (1.2, adım 3): sertifikaları, node.json ve rcm.json yazar, hizmetleri kurar ve başlatır.

Portlar — bölümün başında.

1.4. Elle kurulum

Adım 1. HQbird’ü fbagent ile kurun

HQbird’ü her veritabanı sunucusuna kurun (aynı betikle ama --enroll olmadan veya tam HQbird yükleyicisiyle). fbagent’ın çalıştığını doğrulayın.

fbagent’ın agent_config.json dosyasından üç değeri not edin. node.json için gerekir:

fbagent alanı node.json alanı Örnek
local_api.listen firebird.fbagent_url http://127.0.0.1:13050
local_api.token firebird.fbagent_token —
local_api.instance_id firebird.instance_id —

fbagent denetimi (yanıt, Firebird örneğinin JSON’udur):

Command
curl -s -H "Authorization: Bearer <token>" http://127.0.0.1:13050/v1/instances/<instance_id>

Ana makinede birkaç HQbird örneği varsa, fbagent yapılandırmasının firebird.update.services alanında yalnızca kendi örneğinizin hizmetini bırakın (bkz. 3.5).

Adım 2. Dosyaları yerleştirin

Linux:

Code
/opt/hqclusternode/
  hqclusternode        # program
  node.json            # node configuration (permissions 0600)
  certs/               # ca.crt, <node_id>.crt, <node_id>.key
  work/                # working folder
/opt/hqbirdrcm/
  hqbirdrcm            # program
  rcm.json             # cluster configuration
  certs/               # ca.crt, rcm.crt, rcm.key
  rcm-data/            # state, users, audit log
Command
sudo mkdir -p /opt/hqclusternode/certs /opt/hqclusternode/work
sudo install -m 0755 hqclusternode-linux-amd64 /opt/hqclusternode/hqclusternode
# on the RCM host:
sudo mkdir -p /opt/hqbirdrcm/certs /opt/hqbirdrcm/rcm-data
sudo install -m 0755 hqbirdrcm-linux-amd64 /opt/hqbirdrcm/hqbirdrcm

Windows’ta. Varsayılan klasör aynı yerleşimle C:\hqclusternode dir. Boşluk içeren bir yol kullanılabilir.

Bir ana makinede iki düğüm varsa (birincil ve replika), her birine kendi klasörünü verin, örneğin /opt/hqclusternode/master ve /opt/hqclusternode/replica.

Adım 3. Sertifikaları oluşturun

Düğümler ve RCM yalnızca mTLS üzerinden konuşur. Bir CA ve her katılımcı için bir sertifika gerekir. Bunu herhangi bir makinede bir kez çalıştırın:

Command
./hqclusternode gencerts -out certs \
  -nodes 'node-a:master,node-b:replica' \
  -hosts 'localhost,127.0.0.1,<ip-node-a>,<ip-node-b>,<ip-rcm>'

Komut ca.crt ve ca.key, node-a.crt/.key, node-b.crt/.key ve rcm.crt/.key oluşturur. -hosts içinde katılımcıların bağlanacağı tüm adları ve adresleri sayın.

gencerts ve oluşturduğu dosyalar
gencerts ve oluşturduğu dosyalar

ca.key CA anahtarıdır. Onu ana makinelere kopyalamayın; ayrı saklayın.

Yeni bir düğüm daha sonra -add ile eklenir: çifti aynı CA ile imzalar, diğer dosyalar değişmeden kalır:

Command
./hqclusternode gencerts -out certs -add -nodes 'node-c:replica' -hosts '<ip-node-c>'

Sertifikalar 90 gün geçerlidir. gencerts -out certs -list son kullanma tarihlerini gösterir, gencerts -out certs -renew onları aynı anahtarla yeniler. Yeni .crt dosyasını kendi ana makinesine kopyalayın: düğüm onu yeniden başlatmadan alır.

Her ana makineye ca.crt ve yalnızca kendi sertifikası ile anahtarını kopyalayın.

Adım 4. node.json yazın

Düğüm başına bir dosya. Birincil için örnek (node-a):

json
{
  "node_id": "node-a",
  "role": "master",
  "listen_addr": ":7051",
  "rcm": { "url": "https://<ip-rcm>:7443", "ca_cert": "certs/ca.crt",
           "client_cert": "certs/node-a.crt", "client_key": "certs/node-a.key" },
  "firebird": {
    "root": "/opt/firebird",
    "user": "SYSDBA",
    "password": "<SYSDBA password>",
    "port": 3050,
    "replication_conf": "/opt/firebird/replication.conf",
    "replication_log": "/opt/firebird/replication.log",
    "firebird_log": "/opt/firebird/firebird.log",
    "fbagent_url": "http://127.0.0.1:13050",
    "fbagent_token": "<local_api.token>",
    "instance_id": "<local_api.instance_id>",
    "service_name": "<Firebird service name>"
  },
  "windows": { "restart_window": "22:00-05:00", "transfer_window": "23:00-05:00" },
  "peers": [ { "node_id": "node-b", "url": "https://<ip-node-b>:7051", "compress": "zstd" } ]
}

Replika düğümünün (node-b) dosyası aynıdır, ama "role": "replica", kendi sertifikaları ve peers içinde birincil node-a vardır.

Ana alanlar:

Alan Değer
node_id düğüm adı; sertifikada, rcm.json içinde ve diğer düğümlerin peers alanında aynı
role master veya replica
listen_addr düğüm API adresi; aynı ana makinedeki ikinci düğüm başka bir port kullanır (:7052)
rcm.url RCM istatistiğinin alındığı adres; none — RCM yok
firebird.* bu örneğin Firebird’ü ve fbagent’ı; fbagent değerleri aynen uymalıdır
firebird.auto_restart replika düğümünün Firebird’ü kendisinin yeniden başlatıp başlatamayacağı: auto (varsayılan), never, always
windows.restart_window Firebird yeniden başlatma penceresi; birincil için varsayılan 22:00-05:00, replika için her zaman
windows.transfer_window ilklendirmenin tam hızda yürüdüğü pencere
peers birincil için replikaları, replika için birincili
databases veritabanı klasörü; elle yazmak yerine RCM üzerinden ayarlamak daha iyidir (bölüm 3)

Kalan alanların varsayılan değerleri vardır. fbagent alanları ayarlı değilse düğüm başlamaz.

Dosyayı koruyun: parola ve belirteç içerir.

Command
chmod 600 /opt/hqclusternode/node.json

Windows’ta. Yolları JSON biçiminde yazın: "C:\\HQbird\\replication.conf". service_name, Firebird için Windows hizmet adıdır.

Adım 5. rcm.json yazın

json
{
  "ingest_addr": "0.0.0.0:7443",
  "operator_addr": "127.0.0.1:7444",
  "users_file": "rcm-data/users.json",
  "data_dir": "./rcm-data",
  "tls": { "ca_cert": "certs/ca.crt", "cert": "certs/rcm.crt", "key": "certs/rcm.key" },
  "nodes": [
    { "node_id": "node-a", "url": "https://<ip-node-a>:7051", "role": "master",  "host": "A" },
    { "node_id": "node-b", "url": "https://<ip-node-b>:7051", "role": "replica", "host": "B" }
  ]
}
  • url — RCM ana makinesinin gördüğü düğüm adresi. Yalnızca https.
  • host — Firebird örneği etiketi. Aynı etiketli bir birincil düğüm ve bir replika düğüm aynı Firebird üzerinde çalışır (eşlikçi; bir replikayı birincile yükseltmek için gerekir, bölüm 8). Bir etiket — en çok bir birincil ve bir replika.
  • Göreli yollar rcm.json klasöründen çözülür.

Adım 6. Hizmetleri kaydedin

Başlatma sırası: önce RCM, sonra replikalar, sonra birincil.

RCM (Linux):

Command
cd /opt/hqbirdrcm
sudo ./hqbirdrcm svc install -config /opt/hqbirdrcm/rcm.json
sudo ./hqbirdrcm svc start

Düğüm (Linux):

Command
cd /opt/hqclusternode
sudo ./hqclusternode svc install -config /opt/hqclusternode/node.json -certs /opt/hqclusternode/certs
sudo ./hqclusternode svc start -config /opt/hqclusternode/node.json
systemctl status hqclusternode-master-p3050

svc install, firebird kullanıcısı olarak çalışan hqclusternode-<role>-p<port> hizmetini oluşturur. Firebird klasörü root’a aitse komut firebird grubuna yazma hakkı verir (yapışkan bitle) ve her değişikliği basar: düğümün replication.conf dosyasını değiştirmesi gerekir.

svc start, svc stop ve svc uninstall için aynı node.json dosyasını belirtin: hizmet adı rolden ve Firebird portundan türetilir.

Windows’ta (yönetici olarak PowerShell):

Command
cd C:\hqclusternode
.\hqclusternode.exe svc install -config C:\hqclusternode\node.json -certs C:\hqclusternode\certs

HQClusterNode-<role>-p<port> hizmeti LocalSystem olarak çalışır, kendiliğinden başlar ve bir arızadan sonra yeniden başlar. Düğüm hizmeti Firebird hizmetine bağımlı değildir. Düğüm 2027.1.2–2027.1.9 sürümüyle kurulduysa bağımlılığı bir kez kaldırın: .\hqclusternode.exe svc fix-deps -config C:\hqclusternode\node.json.

Windows'ta svc install ve svc start
Windows'ta svc install ve svc start

Adım 7. Portları açın

Düğüm ana makinesinde diğer düğümlerden ve RCM’den 7051 (listen_addr portu) üzerinde gelen bağlantılara izin verin. RCM ana makinesinde tüm düğümlerden 7443 üzerinde gelen bağlantılara izin verin. 7444 ve 13050 portlarını dışarı açmayın.

Düğüm ana makinesinde ufw örneği:

Command
sudo ufw allow from <ip-rcm> to any port 7051 proto tcp
sudo ufw allow from <ip-partner-node> to any port 7051 proto tcp

Elle güncelleme

Hizmeti durdurun, programı değiştirin, hizmeti başlatın:

Command
sudo systemctl stop hqclusternode-master-p3050
sudo install -m 0755 hqclusternode-linux-amd64 /opt/hqclusternode/hqclusternode
sudo systemctl start hqclusternode-master-p3050

Yapılandırma ve sertifikalar bununla değişmez.

1.5. RCM’ye ilk giriş

Adres ve parola, RCM’nin nasıl kurulduğuna bağlıdır.

RCM nasıl kuruldu Adres Oturum ve parola
HQbird yükleyicisi veya fbagent --cluster-init ile (1.3) herhangi bir bilgisayardan https://<RCM host>:7444 rcmadmin ve yükleyicinin bastığı parola (veya --rcm-password-file dosyanızdaki)
HQCenter Admin üzerinden (1.2) veya elle (1.4) http://127.0.0.1:7444, yalnızca RCM ana makinesinde rcmadmin, parola strong password (aralıklı)

HTTPS (1.3). RCM sertifikasını tarayıcının bilmediği küme CA’sı imzalar, bu yüzden uyarı verir. Giriş sayfasında RCM, CA parmak izini gösterir. Yükleyicinin bastığı CA hash ile karşılaştırın ve CA’yı tarayıcıya veya sisteme güvenilir kök olarak alın: giriş sayfasındaki CA sertifikasını indir bağlantısı (https://<RCM host>:7444/ca.crt, dosya hqcluster-ca.crt). RCM’nin yalnızca localhost’u dinlemesi için rcm.json içinde "operator_addr": "127.0.0.1:7444" ayarlayın ve RCM’yi yeniden başlatın.

HTTP (1.2, 1.4). Başka bir bilgisayardan bir SSH tüneli ile bağlanın:

Command
ssh -L 7444:127.0.0.1:7444 <rcm-host>

Sonra tarayıcıda http://127.0.0.1:7444 açın.

RCM giriş sayfası
RCM giriş sayfası

Üretilmiş parola. RCM ilk girişte onu değiştirmenizi ister: değiştirene kadar diğer sayfalar açılmaz. strong password parolasını hemen değiştirin (üstbilgideki Parola bağlantısı).

İlk girişte parolayı değiştirme
İlk girişte parolayı değiştirme

Dil. Sayfa üstbilgisindeki dil listesinden Rusça seçin (giriş sayfasında da vardır). Seçmezseniz dil tarayıcıdan alınır.

Parola değiştirme ve yeni kullanıcılar

Her kullanıcı kendi parolasını değiştirir: sayfa üstbilgisindeki Parola bağlantısı. Geçerli parola ve en az 12 karakterlik yeni bir parola gerekir. Değişiklikten sonra o kullanıcının diğer oturumları kapanır.

Yükleyici bir parola ürettiyse, fbagent klasöründeki clusterca/<name>/rcm-initial-password dosyasına yazılır. Parola değişince fbagent bu dosyayı kendisi siler. RCM klasöründeki initial-admin.json dosyasını silmeyin: yalnızca bir özet içerir. Kullanıcı dosyası kaybolur ve bu dosya yoksa RCM varsayılan parolalı bir kullanıcı oluşturur.

Yeni kullanıcılar. Arayüzde kullanıcı sayfası yoktur. Kullanıcılar rcm-data/users.json dosyasındadır. Parola bir HA1 özeti olarak saklanır: MD5("<name>:hqbirdrcm:<password>").

  1. Özeti hesaplayın:

    Command
    printf '%s' 'rcmadmin:hqbirdrcm:<new password>' | md5sum
  2. Onu users.json içindeki kullanıcının ha1 alanına yazın. Kullanıcı eklemek için users dizisine başka bir öğe ekleyin:

    json
    { "username": "ivanov", "ha1": "<hash>", "algo": "MD5", "created_at": "2026-11-03T00:00:00Z" }
  3. RCM’yi hemen yeniden başlatın: dosyayı yalnızca başlangıçta okur. Arayüzde parola değişince RCM dosyayı bellekten yeniden yazar ve henüz okumadığı düzenlemeler kaybolur.

Command
chmod 600 /opt/hqbirdrcm/rcm-data/users.json
sudo systemctl restart hqbirdrcm

role alanı olmadan kullanıcının tüm yetkileri vardır. HQbird 2027.2.31’den beri "role": "viewer" rolü vardır: yalnızca görüntüleme, her değişiklik isteği 403 alır.

1.6. Kurulum nasıl doğrulanır

  • Düğüm ve RCM hizmetleri çalışıyor ve döngüde yeniden başlamıyor: systemctl status hqclusternode-master-p3050, systemctl status hqbirdrcm.

    Düğümün systemctl durumu
    Düğümün systemctl durumu
RCM'nin systemctl durumu
RCM'nin systemctl durumu
  • RCM yanıt verir (parolasız): curl http://127.0.0.1:7444/healthz. RCM üzerinden kurulduğunda (1.3) konsol HTTPS üzerinde çalışır: curl -k https://127.0.0.1:7444/healthz.

  • RCM’de Genel bakış sayfası tüm düğümleri gösterir, „yanıt vermiyor“ işareti yoktur.

  • RCM ana makinesinde komut satırından:

    Command
    export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
    ./hqbirdrcm nodes
    ./hqbirdrcm status
  • RCM üzerinden küme: Ayarlar → Küme, Durum bölümü — her üye en son revizyonu uygulamıştır ve hata bildirmez. Komut satırından: ./hqbirdrcm cluster status.

1.7. Günlükler

Ne Nerede
Düğüm günlüğü <node.json folder>/logs/node-YYYYMMDD.jsonl
Düğüm hizmeti çıktısı (Linux) journalctl -u hqclusternode-<role>-p<port>
RCM hizmeti çıktısı (Linux) journalctl -u hqbirdrcm
Firebird replikasyon günlüğü node.json içindeki firebird.replication_log
SSH olmadan herhangi bir düğümün günlükleri RCM, Günlükler sayfası

1.8. Sık hatalar

Ne görürsünüz Neden Ne yapılır
Düğüm başlamıyor: fbagent_url, fbagent_token veya instance_id hakkında hata fbagent çalışmıyor veya değerler agent_config.json ile uyuşmuyor fbagent’ı 1.4, adım 1’deki curl komutuyla denetleyin
Kurulum betiği 2 koduyla çıktı fbagent isteği zamanında onaylanmadı isteği onaylayın ve betiği yeniden çalıştırın
Düğümler HQCenter Admin üzerinden görünmüyor fbagent kümede değil veya küme henüz alınmadı kümeyi denetleyin (bölüm 2), 10 dakikaya kadar bekleyin
RCM’de düğüm „yanıt vermiyor“ 7051 portu kapalı, rcm.json içindeki url yanlış, adres sertifikada yok portları ve sertifikaların -hosts değerini denetleyin
RCM’ye giriş yok: „Çok fazla başarısız giriş denemesi“ 5 dakika içinde 10 başarısız giriş birkaç dakika bekleyin
Yeni sürüm kurulmayacak sürüm blocked-versions.json içinde sürüm satırını dosyadan kaldırın
--cluster-init: no hqbirdrcm to install yükleyici RCM programını bırakmadı HQbird’ü tam yükleyiciyle kurun (1.3, „Elle“, adım 1)
--cluster-join: token_used, token_expired, token_revoked belirteç kullanılmış, 24 saatten eski veya iptal edilmiş yeni bir belirteç oluşturun (1.3, „Elle“, adım 4)
--cluster-join: hostname_conflict kümede aynı ana makine adına ve farklı adreslere sahip bir fbagent var ana makinelere farklı adlar verin
--cluster-join: this agent is in cluster … from goafts fbagent zaten HQCenter Admin kümesinde onu HQCenter Admin kümesinden çıkarın
Düğüm RCM üzerinden kurulmayacak RCM’de bu platform için sürüm yok hqbirdrcm release list, sürümü içe aktarın (1.3, „Elle“, adım 5)

2. Küme yapılandırması

Bu bölümde kümede hangi düğümlerin olduğunu ve hangi birincilin hangi replikaya segment gönderdiğini belirlersiniz. Sonra RCM düğümlerini ve kullanıcıları yapılandırırsınız.

İlişkiler üç yoldan biriyle tanımlanır:

Düğümler nasıl kuruldu İlişkiler nerede tanımlanır Bölüm
HQCenter Admin üzerinden HQCenter Admin’de: HQ Monitor’ün Kümeler sayfası veya HQCenter Admin API’si 2.2
RCM üzerinden, HQCenter Admin olmadan RCM’de: Ayarlar → Küme, hqbirdrcm cluster veya HQ Monitor’ün Kümeler sayfası 2.3
elle RCM’de: Ayarlar → RCM ve Ayarlar → Düğümler 2.3

HQCenter Admin veya RCM üzerinden kurulan düğümlerde ilişkileri yalnızca küme tanımında değiştirin. fbagent, node.json ve rcm.json dosyalarını küme tanımına göre üzerine yazar. RCM’de Ayarlar → RCM veya Ayarlar → Düğümler içinde ilişki düzenlemek reddedilir (409 cluster_managed). RCM’nin eski sürümleri bunu kabul ederdi, ama kaybolurdu.

2.1. Roller ve şemalar

Her düğümün bir rolü vardır: birincil veya replika. İki düğüm — bir birincil ve bir replika — tek bir Firebird örneğinde çalışabilir.

Desteklenen şemalar:

Code
1 → 1        node-a (master) ──▶ node-b (replica)

1 → N        node-a ──▶ node-b
                    └─▶ node-c

N → 1        node-a ──┐
                      ├─▶ node-b    (one replica for several masters)
             node-x ──┘

Both nodes   host-1: node-1m (master) + node-1r (replica)  ← one Firebird
on a host    host-2: node-2m (master) + node-2r (replica)  ← one Firebird
             node-1m ──▶ node-2r,  node-2m ──▶ node-1r

Bağ her zaman birincilden replikaya gider. RCM, birincilin veritabanını replikasına düğüm adıyla değil veritabanı GUID ile bağlar.

Eşlikçi. Aynı Firebird örneğindeki bir birincil düğüm ve bir replika düğüm eşlikçidir. Bir replikayı birincile yükseltme (bölüm 8) yalnızca böyle bir çift için çalışır. rcm.json içinde çift, aynı host değeriyle işaretlenir.

2.2. HQCenter Admin üzerinden bağlar

Küme nerede tanımlanır

  • HQ Monitor, Kümeler sayfası (yalnızca yöneticiler; yapılandırma teslimi açık olmalıdır). Olağan yol.
  • HQCenter Admin API: POST /v1/admin/clusters ve PUT /v1/admin/clusters/{id}. HQCenter Admin panelinde küme sayfası yoktur.

``

Kümeler sayfasındaki adımlar

  1. Bir Yeni küme kimliği girin (küçük Latin harfleri, rakamlar ve -) ve Oluştur düğmesine tıklayın.
  2. Üye ekleyin (Üyeler). Her biri için belirtin:
    • ana makinenin fbagent’ı;
    • rol: master, replica veya rcm;
    • ana makine adresleri;
    • port: düğüm için — 7051 (aynı ana makinedeki ikinci düğüm — örn. 7052), RCM için — istatistik alma portu 7443.
  3. Birincilden replikaya bağ ekleyin (Replikasyon bağları).
  4. Doğrula, sonra Kaydet düğmesine tıklayın.

Başka bir yönetici kümeyi aynı anda değiştirdiyse sayfa, kümeyi yeniden yüklemenizi ve değişikliği yinelemenizi ister.

Kurallar

  • Bir fbagent yalnızca bir kümeye ait olabilir.
  • Tek bir fbagent üzerinde — en çok bir birincil, bir replika, bir RCM ve bir yönlendirici. Yönlendiricinin (rol router, HQbird 2027.2.30’dan beri) bağı yoktur ve lisans yeri kaplamaz (bölüm 8.7).
  • Bir kümenin tam olarak bir RCM‘si vardır. RCM ana makinesindeki fbagent, kümenin sertifika yetkilisini (CA) yürütür.
  • Üye adı (member_id) — Latin harfleri, rakamlar, -. Bir üyenin adı, fbagent’ı ve rolü değiştirilemez. Bir üyeyi başka bir ana makineye taşımak için yeni adla yeni bir üye oluşturun. Eski adı yeniden kullanmayın.
  • Her replikanın birincile bir bağı olmalıdır.
  • HQCenter Admin düğüm adresini kendisi kurar: https://<first address>:<port>.
  • HQbird 2.5/3.0: kümenin replconf_valid_till tarihini ayarlayın (YYYY-MM-DD) — replconf eklentisi yapılandırması o tarihe kadar geçerlidir.

API üzerinden örnek

json
{"contract":1,"cluster_id":"shop-prod","name":"Shop","pki":"managed",
 "cert_validity_days":90,"renew_before_days":30,
 "members":[
  {"member_id":"db1-m","agent_id":"<fbagent of host 1>","role":"master","addresses":["db1.lan"],"listen_port":7051},
  {"member_id":"db1-rcm","agent_id":"<fbagent of host 1>","role":"rcm","addresses":["db1.lan"],"listen_port":7443},
  {"member_id":"db2-r","agent_id":"<fbagent of host 2>","role":"replica","addresses":["db2.lan"],"listen_port":7052}],
 "links":[{"from":"db1-m","to":"db2-r"}]}
  • Oluştur: POST /v1/admin/clusters (belge üyelerle birlikte gönderilebilir). Tüm belgeyi değiştir: PUT /v1/admin/clusters/{id}.
  • PUT, If-Match: <revision> başlığını ister (revizyonu GET ve ETag verir). Başlık yoksa — 428, eski revizyonla — 409, belgede hatayla — 422 ve hata listesi.
  • POST /v1/admin/clusters/{id}/validate belgeyi kaydetmeden doğrular.
  • GET /v1/admin/clusters/{id}/status üyelerin durumunu ve sertifika son kullanma tarihlerini gösterir.

Kaydettikten sonra ne olur

  1. Her üyenin fbagent’ı kümeyi alır. Küme içinde — her 60 saniyede bir denetim (RCM ana makinesindeki fbagent — her 30 saniyede bir). Küme dışındaki bir fbagent kümeyi sonraki yapılandırma yoklamasında öğrenir. O yoklama sunucuya ulaşmazsa denetim her 10 dakikada bir çalışır.
  2. Her fbagent bir anahtar oluşturur ve sertifika isteği gönderir. RCM ana makinesindeki fbagent onu imzalar. RCM kendi sertifikasını istek olmadan imzalar.
  3. fbagent node.json dosyasına yazar: ad, rol, adres, peers (bağlardan), RCM adresi, sertifika yolları, Firebird ve fbagent verisi. rcm.json dosyasına: düğüm listesi (nodes), yönlendirici listesi (routers), istatistik alma adresi ve sertifika yolları. fbagent dosyaların diğer alanlarına dokunmaz.
  4. fbagent hizmetleri kurar ve başlatır (bölüm 1).

Küme değişince:

Ne değişti fbagent ne yapar
çalışan bir düğümün yalnızca peers alanı onları yeniden başlatmadan düğüme geçirir
bir düğümün diğer alanları düğümü durdurur, dosyayı yazar, düğümü başlatır — düğümün windows.transfer_window penceresi içinde (ayarlı değilse — hemen)
rcm.json RCM’yi hemen yeniden başlatır
sertifikalar veya CA hizmeti yeniden başlatır
bir üye kaldırılır hizmeti durdurur ve kaldırır; cluster-managed.json → cluster-removed.json, program → *.removed; yapılandırma, sertifikalar ve veri kalır

Bir düğüm kaldırıldıktan sonra onun # BEGIN managed-by:<name> … # END … bölümü paylaşılan replication.conf içinde kalır. Onu elle silin ve Firebird’ü RCM üzerinden yeniden başlatın.

Küme sertifikalarını onaylama

Varsayılan olarak RCM ana makinesindeki fbagent istekleri kendisi imzalar (auto). Elle onay açılabilir. RCM ana makinesindeki komutlar:

Command
fbagent --cluster-ca-approval manual     # or auto
fbagent --cluster-status                 # this fbagent's membership in the cluster (JSON)
fbagent --cluster-ca-approve <request_id>

manual kipinde yeni bir üye veya yeni bir anahtar onay bekler. Bilinen bir anahtarla sertifika yenilemesi kendiliğinden imzalanır.

2.3. RCM üzerinden bağlar

RCM kümesi (HQCenter Admin olmadan)

Kümeyi HQbird yükleyicisi veya fbagent --cluster-init komutu oluşturduysa (bölüm 1.3), küme tanımını RCM saklar. Ana makine eklemenin en kolay yolu Ayarlar → Ana makineleri bağla sayfasıdır (bölüm 1.3, „RCM’de ana makineleri bağla“): RCM üyeleri ve bağları kendisi oluşturur. Kurallar HQCenter Admin ile aynıdır (2.2, „Kurallar“), artı:

  • RCM’de bir küme vardır; rcm üyesi her zaman vardır ve silinemez;
  • en çok 3 yer (birincil veya replika düğümlü ana makineler), aksi halde seats_exceeded hatası oluşur;
  • bir üye yalnızca RCM’ye bağlanmış bir fbagent üzerine eklenebilir (bölüm 1.3: „Ana makineleri bağla“ veya „Elle“, adım 4).

Ayarlar → Küme sayfasındaki adımlar:

  1. Agent’lar tablosunda fbagent satırında Üye ekle düğmesine tıklayın.
  2. Rolü (master, replica veya router), member_id, adresleri ve portu belirtin. Sayfa <host>-<role> adını ve portu önerir: ilk fbagent düğümü için 7051, ikincisi için 7061. Ana makinenin başka bir üyesinin aldığı portu RCM reddeder. fbagent adresleri düğmedir: adres eklemek için tıklayın.
  3. Bağlar bölümünde birincilden replikaya Bağ ekle düğmesine tıklayın.
  4. Doğrula düğmesine tıklayın: RCM hataları ve uyarıları gösterir.
  5. Kaydet düğmesine tıklayın. Sayfa değişiklik listesini gösterir ve onay ister. Üyeler siliniyorsa pencere kırmızıdır.

Kaydetmeden önce değişiklikler yalnızca sayfadadır („Kaydedilmedi“ etiketi). Biri kümeyi aynı anda kaydettiyse sayfa onu yeniden yüklemeyi önerir. Yalnızca RCM alanları değiştiyse (revizyon, CA, komisyonlar) sayfa değişikliğinizi kendisi kaydeder.

Sayfanın diğer bölümleri:

Bölüm Orada ne var
üstbilgi küme adı, revizyon, küme CA’sı ve agent CA’sı; eski CA için Dışa aktar düğmesi
Bağlantı belirteçleri yeni bir fbagent için belirteç oluşturun, kullanılmamış olanı iptal edin
JSON belgesi tüm belge bir metin alanında; Doğrula ve Kaydet onu kullanır
Anahtarlar ve CA’lar komisyonlar: yeni üye anahtarı (rekey), yeni küme CA’sı (rotate_ca), yeni agent CA’sı (rotate_agent_ca); kaydedilmemiş değişiklik varken kullanılamaz
Durum her üyenin uyguladığı revizyon, sertifika sonu, hizmet, son hata

RCM ana makinesinde komut satırından:

Command
export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
./hqbirdrcm cluster show > c.json        # document with revision
# edit c.json
./hqbirdrcm cluster validate -f c.json   # validate without saving anything
./hqbirdrcm cluster apply -f c.json      # save (If-Match = revision from the file)
./hqbirdrcm cluster agents               # connected fbagents and their members
./hqbirdrcm cluster status               # what the fbagents reported

Belge biçimi 2.2, „API üzerinden örnek“ gibidir. Eski revizyonla apply 409 alır: show komutunu yeniden çalıştırın. RCM son 20 revizyonu rcm-data/cluster/history/ içinde tutar.

HQ Monitor. Kümeler sayfası RCM ile de çalışır. RCM ana makinesinde HQ Monitor, RCM’ye o ana makinenin fbagent’ı üzerinden, fbagent sertifikasıyla erişir: RCM kullanıcısı ve parolası gerekmez. RCM denetim günlüğünde bu eylemler agent:<id> (<user>) olarak kaydedilir. Daha eski RCM sürümleri için başka bir yol: HQ Monitor yapılandırmasında rcm_admin_url (http://127.0.0.1:7444), rcm_admin_user (RCM kullanıcısı) ve rcm_admin_password_file (parolasının olduğu dosya) ayarlayın.

Kaydettikten sonra her şey HQCenter Admin üzerinden olduğu gibi ilerler (2.2, „Kaydettikten sonra ne olur“). RCM, rcm.json içindeki nodes listesini yeniden başlatmadan kendisi yeniden okur.

Bir fbagent’ı kümeden çıkarın: üyelerini silin ve kaydedin, sonra Agent’lar tablosunda İptal et düğmesine tıklayın (veya ./hqbirdrcm cluster revoke -agent <id>). Geri getirmek için yeni bir belirteç gerekir. İptalden sonra fbagent (3.1.0 sürümünden beri) kümeyi kendisi terk eder: düğümlerini durdurur ve küme verisini siler. Aynı işi bir düğüm ana makinesinde fbagent --cluster-leave komutu yapar. RCM ana makinesinde reddedilir.

Elle kurulum: RCM’ye düğüm ekleyin

  1. Ayarlar → RCM, Bağlı düğümler tablosu.
  2. Düğüm ekle düğmesine tıklayın. node_id, url (https://<address>:7051), rol, host (Firebird örneği etiketi), server (yalnızca ekranda gruplama için) doldurun.
  3. Düğüm satırında Doğrula düğmesine tıklayın: RCM bağlantıyı ve yetkileri denetler.
  4. Kaydet düğmesine tıklayın. RCM rcm.json yazar ve eski dosyayı rcm.json.<UTC time>.bak olarak saklar (son 20).
  5. RCM’yi yeniden başlatın. Yeniden başlatmaya kadar eski yapılandırma geçerlidir; sayfa hangi alanların yeniden başlatma beklediğini gösterir.
Ayarlar → RCM
Ayarlar → RCM
Command
sudo systemctl restart hqbirdrcm

Arayüz olmadan da yapılabilir: rcm.json düzenleyin ve RCM’yi yeniden başlatın.

Elle kurulum: birincil ile replikayı bağlayın

Bağ her iki tarafta kayıtlı olmalıdır:

  1. Ayarlar → Düğümler, birincil düğümü seçin.
  2. Eşler bölümünde Eş ekle düğmesine tıklayın: replikanın node_id değeri, url değeri, sıkıştırma (zstd).
  3. Kaydet düğmesine tıklayın. RCM değişiklik listesini gösterir ve onay ister. peers değişikliği hemen yürürlüğe girer.
  4. Replika düğümü için yineleyin: onun eşi birincildir.
Birincil düğümün Eşler bölümü
Birincil düğümün Eşler bölümü

Eş taraflardan birinde kayıtlı değilse RCM, veritabanını ilklendirirken o replika düğümünü önermez.

2.4. Düğüm ayarları

Ayarlar → Düğümler, düğümün RCM’den değiştirilmesine izin verdiği node.json ayarlarını gösterir. Yalnızca değişen alanlar, değişiklikleri listeleyen bir pencereden sonra kaydedilir.

Ayarlar → Düğümler: düğüm seçme
Ayarlar → Düğümler: düğüm seçme
„taramadan sonra“ işaretli düğüm veritabanı ayarları
„taramadan sonra“ işaretli düğüm veritabanı ayarları

Her satır, değişikliğin ne zaman yürürlüğe gireceğiyle işaretlidir:

Ne zaman Hangi ayarlar
Hemen channel_a_mbps, channel_a_burst_mbps, windows.restart_window, peers; HQbird 2027.2.24’ten beri — veri denetimi ayarları (limits.data_check_*); HQbird 2027.2.31’den beri — advertise_addr
Düğüm yeniden başladıktan sonra kalan sınırlar, windows.transfer_window; sayfa düğüm yeniden başlayana kadar onları ayrı bir satırda gösterir
Taramadan sonra databases.*, exclude_filter; replication.conf değiştiyse Firebird yeniden başlatması gerekir (bölüm 3.5)

Salt okunur (düğüm ana makinesindeki node.json içinde değiştirilir): firebird (parola ve auto_restart dahil), rcm, tls, segments, listen_addr adresi.

Ana ayarlar:

Ayar Varsayılan Anlam
windows.restart_window birincil 22:00-05:00, replika — her zaman düğümün Firebird’ü ne zaman yeniden başlatabileceği; birincil Firebird kendini hiç yeniden başlatmaz
windows.transfer_window 23:00-05:00 ilklendirmenin reinit_window_mbps hızında yürüdüğü pencere
limits.channel_a_mbps 50 segment aktarım hızı, MB/s (channel_a_burst_mbps — kısa süreli tepe, 200)
limits.reinit_window_mbps 100 aktarım penceresi içinde ilklendirme hızı, MB/s
limits.reinit_day_disk_fraction 0.5 pencere dışında ilklendirme için ölçülen disk hızının payı
limits.retention_days 2 gönderilmiş segmentlerin birincil arşivinde kaç gün tutulacağı
limits.free_space_floor_gb 1 en az boş alan, GB; bunun altında replika segment kabul etmez
limits.max_concurrent_reinits 1 düğümün aynı anda kaç ilklendirme yürüttüğü

Hız ve arşiv saklama ayrıntıları için bölüm 5 ve 7’ye bakın.

firebird.auto_restart (yalnızca node.json içinde) bir replika düğümünün Firebird’ü kendisinin yeniden başlatıp başlatamayacağını belirler:

Değer Davranış
auto (varsayılan) bu Firebird birincil veritabanlarına hizmet etmiyorsa edebilir
never asla
always bu Firebird birincil veritabanları barındırsa bile her zaman

HQCenter Admin üzerinden. fbagent düğümünün windows.transfer_window değeri, küme değişince düğüm hizmetinin kendisini yeniden başlatma penceresi olarak da kullanılır. Pencere node.json içinde ayarlı değilse fbagent hizmeti hemen yeniden başlatır.

2.5. Bir ana makinede birden çok HQbird örneği

fbagent, yapılandırmasının firebird.update.services listesindeki hizmetleri yeniden başlatır. Boş liste, ana makinedeki tüm HQbird hizmetleri demektir. Listede yalnızca kendi örneğinizin hizmetini bırakın. Düğüm bu ayarı görmez ve fbagent birden çok örnek biliyorsa günlüğe fbagent_shared uyarısı yazar.

2.6. SYSDBA parolası

Düğüm Firebird’e node.json içindeki firebird.user ve firebird.password ile bağlanır. fbagent parolanın kendi kopyasını saklar. SYSDBA parolasını değiştirdiyseniz:

  1. Bu örneğin her düğümünün node.json dosyasındaki firebird.password değerini düzeltin (birincil ve replika).
  2. fbagent yapılandırmasındaki parolayı düzeltin ve yeniden yükleyin (fbagent belgelerine bakın).
  3. Düğüm hizmetlerini yeniden başlatın.

Aksi halde RCM’deki yayın ve doğrulama sayfaları bir giriş hatası gösterir (SQLSTATE 28000).

2.7. RCM kullanıcıları ve denetim

  • Kullanıcılar rcm-data/users.json dosyasındadır (bölüm 1.5). Rolsüz bir kullanıcının tüm hakları vardır; viewer rolü (HQbird 2027.2.31’den beri) — yalnızca görüntüleme.
  • Bir oturum son eylemden sonra 12 saat sürer.
  • 5 dakika içinde 10 başarısız girişten sonra o kullanıcı ve adres için giriş geçici olarak engellenir. Başarılı bir giriş sayacı sıfırlar.
  • Denetim günlüğü rcm-data/audit.jsonl dosyasıdır: her değişiklik, giriş ve çıkış için bir JSON satırı. Arayüzde denetim günlüğü yoktur.
  • Komutlar sayfası her komutun yazarını gösterir.

2.8. Lisans

Birincil düğüm dakikada bir, ana makinesinin fbagent lisansını okur. Lisans yoksa (deneme süresi bitti, lisans süresi doldu veya geçersiz), düğüm birincildeki tüm veritabanları için segment göndermeyi durdurur. Firebird ve veritabanları çalışmaya devam eder, ama replikalar değişiklik almayı keser.

RCM’de gördükleriniz:

  • birincil kırmızıdır (NEEDS_ATTENTION), „lisans yok: gönderim durdu“ rozetiyle;
  • Sürdür düğmesi yoktur: duraklatmayı yalnızca lisans kaldırır;
  • replikada: „… tarihinden beri almıyor: birincilin lisansı yok“;
  • Düğümler tablosunda „lisans yok“ rozeti; Ayarlar → Düğümler içinde fbagent lisans bloğu;
  • license_paused ve license_pause_archive_released uyarıları;
  • ilklendirme yasaktır (license_paused).
Ayarlar → Düğümler içinde fbagent lisans bloğu
Ayarlar → Düğümler içinde fbagent lisans bloğu

Lisansı fbagent’a kurun. Düğüm duraklatmayı bir dakika içinde kendisi kaldırır. Birincil, replikalar için arşivi duraklatmanın başından limits.retention_days (varsayılan 2 gün) tutar. Lisansı daha sonra kurarsanız replikaların yeniden ilklendirilmesi gerekir.

HQCenter Admin olmadan RCM üzerinden küme. HQCenter Admin olmadan kayan bir lisans, online_check_days artı hoşgörü günlerinden sonra çalışmayı bırakır. Kümedeki her fbagent’a bağlı bir lisans gerekir (fbagent --license-request, sonra fbagent --license-install, bölüm 1.3, „Lisans“). Deneme süresinden sonra fbagent, lisansta cluster özelliği olmadan yeni düğüm veya RCM eklemez; güncellemeleri hiçbir zaman yasaklamaz. HQbird 2.5/3.0 için RCM’deki replconf_valid_till tarihi, fbagent düğümlerindeki lisans sonu artı hoşgörü günlerinden sonra olamaz (hata replconf_after_license).

2.9. Nasıl denetlenir

  • Genel bakış: tüm düğümler vardır ve sunucuya göre gruplanmıştır.

    Küme genel bakışı
    Küme genel bakışı
  • Ayarlar → Düğümler: birincilin Eşler bölümünde bir replika, replikanın birincili vardır.

  • Ayarlar → RCM: her düğüm satırındaki Denetle düğmesi geçer.

  • Tek dosya olarak küme raporu:

    Command
    ./hqbirdrcm report -o report.json

2.10 Sık hatalar

Ne görürsünüz Neden Ne yapılır
RCM’de eş düzenleme reddedildi (409 cluster_managed) veya düğüm yeniden başladıktan sonra kayboldu düğüm HQCenter Admin veya RCM üzerinden kuruldu bağları küme tanımında değiştirin (2.2, 2.3)
RCM’de küme kaydederken seats_exceeded dördüncü bir ana makinede düğümler düğümlü en çok 3 ana makine
Ayarlar → RCM: rcm_config_read_only Linux’ta RCM üzerinden küme: rcm.json fbagent’a ait rcm.json dosyasını fbagent kullanıcısı olarak düzenleyin ve RCM’yi yeniden başlatın
İptal et agent çalışmıyor (agent_has_members) fbagent’ın üyeleri var önce üyeleri silin ve kaydedin
İlklendirmede replika düğümü önerilmiyor eş taraflardan birinde kayıtlı değil eşi her iki tarafa ekleyin (2.3)
Ayarlar → RCM içindeki bir değişiklik yürürlüğe girmiyor RCM yeniden başlatılmadı RCM’yi yeniden başlatın
HQCenter Admin’de küme kaydederken 422 belgede hata errors listesine göre düzeltin, validate ile denetleyin
Küme kaydederken 409 kümeyi başkası değiştirdi kümeyi yeniden okuyun ve yeniden deneyin
Yeni bir HQCenter Admin küme üyesi sertifika almıyor RCM ana makinesinde elle onay fbagent --cluster-ca-approve <id>
Yayın sayfalarında SQLSTATE 28000 hatası SYSDBA parolası değişti 2.6

3. Birincile veritabanı ekleme

Bu bölümde birincil veritabanı düğümün denetimine girer. Düğüm onu replication.conf içine kaydeder ve segment klasörlerini oluşturur. Firebird yeniden başladıktan sonra veritabanı replikasyona hazırdır.

Replikayı oluşturmak sonraki adımlardır (yayın, ilklendirme). Bölüm 4–6’da anlatılır.

Düğme adları Rusça RCM arayüzüne göre, İngilizceleri parantez içinde verilmiştir.

3.1. Düğüm veritabanlarını nasıl bulur

Birincil düğüm veritabanlarını tek bir klasörde arar — veritabanı kökü (databases.root). Yönetime neyin gireceğine kurallar karar verir:

Kural Alan Varsayılan
Veritabanı klasörü root ayarlı değil
Alt klasörleri ara recursive evet
Dahil etme maskesi template *.fdb
Dışlama maskesi exclude_mask yok
Dosya boyutu, MB min_size_mb, max_size_mb sınır yok (0)
Veri karşılaştırması için tablolar sync_tables HQbird 2027.2.24 ile — veritabanı yayınındaki tablolar, yoksa — RDB$FIELDS; 2027.5.7’de — RDB$FIELDS
Dahil etme listesi include_paths boş (şablon kipi)
Dışlama listesi exclude_paths boş

root yolu düğüm ana makinesindeki bir yoldur, RCM ana makinesinde değil. Düğüm önce dahil etme maskesini, sonra dışlama maskesini, sonra boyutu uygular.

Kurallar tüm düğüm için aynıdır. sync_tables listesi de ortaktır: denetim (bölüm 5.10) listedeki her tabloyu, kendi listesi olmayan düğümün her veritabanında arar.

Karşılaştırma tabloları, HQbird 2027.2.24 ile. Her veritabanının kendi listesi olabilir (Eşitleme izleme tabloları). Düğüm onu databases.sync_tables_by_db içinde saklar. Denetim ayarlı ilk listeyi alır:

  1. veritabanının kendi listesi;
  2. düğümün ortak sync_tables listesi;
  3. veritabanı yayınındaki tablolar;
  4. RDB$FIELDS.

Daha önce kaydedilmiş ortak bir liste yayına göre önceliklidir: kendi listesi olmayan bir veritabanı onu kullanır. Birincilin veritabanı sayfası şu anda hangi listenin geçerli olduğunu gösterir (3.3).

Hem birincil veritabanında hem replikada olmayan bir tablo „veritabanında yok“ durumunu alır (absent): karşılaştırılmaz ve denetim onun yüzünden „Tamam değil“ göstermez. Yalnızca bir tarafta eksik olan tablo bir uyuşmazlıktır.

RCM ve düğüm 2027.5.7. Tüm düğüm için tek bir liste vardır (sync_tables); liste yoksa denetim RDB$FIELDS kullanır. Eksik bir tablo hatadır ve veritabanı denetimi „Tamam değil“ gösterir.

Tüm kurallar düğümün node.json dosyasındadır. Düğüm onları her taramada uygular.

Şablon kipi ve liste kipi:

  • Şablon kipi (dahil etme listesi boş): düğüm maskeye uyan, dışlananlar hariç tüm dosyaları alır. Klasördeki yeni bir dosyayı düğüm sonraki taramada kendiliğinden alır.
  • Liste kipi (dahil etme listesi boş değil): düğüm yalnızca listedeki dosyaları alır. Yeni bir dosya kendiliğinden yönetime girmez — eklenmelidir.

Klasörde veritabanı kopyaları, deneme veritabanları veya replike edilmemesi gereken başka dosyalar varsa liste kipini seçin.

3.2. Başlamadan önce: yetkileri denetleyin

Firebird’ün ve düğümün çalıştığı kullanıcı (firebird Linux’ta, LocalSystem Windows’ta) şunlarda okuma ve yazma yetkisine sahip olmalıdır:

  • veritabanı kök klasörü ve veritabanı dosyaları;
  • replication.conf ve klasörü (düğüm dosyayı geçici bir dosya üzerinden değiştirir);
  • <database>.ReplLog ve <database>.LogArch segment klasörleri (düğüm onları kendisi oluşturur).

RCM, kayıttan önce yetkileri denetler (ön denetim). Denetim başarısız olursa komut preflight failed on <node> hatası ve yol listesiyle biter.

Düğüm ana makinesinde denetim (Linux):

Command
sudo -u firebird /opt/hqclusternode/hqclusternode checkpermissions -config /opt/hqclusternode/node.json

3.3. Veritabanı kayıt sayfası

Veritabanı kaydı: form ve önizleme
Veritabanı kaydı: form ve önizleme
  1. Birincil düğümün kayıt sayfasını açın. Bağlantı iki yerdedir:

    • Veritabanları → Düğümler tablosu → eylemler sütunu → Kaydet;
    • Genel bakış → birincil düğüm kartı → Veritabanlarını kaydet.

    Bir replika düğümünün bu sayfası yoktur.

  2. Form, düğümün geçerli kurallarını gösterir (düğüm onları kendisi gönderdi). Düğüm yanıt vermiyorsa önizleme ve kayıt düğmeleri kapalıdır: geçerli kurallar olmadan dahil etme ve dışlama listelerini sıfırlarlardı.

  3. Alanları doldurun veya düzeltin: Bu sunucudaki klasörün yolu, özyinelemeli, maskeler, Boyut süzgeci, Eşitleme izleme tabloları.

    Eşitleme izleme tabloları alanı:

    • HQbird 2027.2.24 ve sonrası — liste, bu eylemin kaydedeceği veritabanı başınadır. Boş alan: veritabanı kendi yayınının tablolarını kullanır. Kayıt, düğümün ortak listesini (sync_tables) değiştirmez. Varsa form bunu söyler: kendi listesi olmayan bir veritabanı onu kullanır, yayını değil. Yönetilen bir veritabanının listesi kendi sayfasında ayarlanır: Veritabanları → birincil veritabanı → Eşitleme izleme tabloları bloğu. Blok şu anda hangi listenin geçerli olduğunu gösterir. Boş alan, veritabanının kendi listesini kaldırır;
    • RCM ve düğüm 2027.5.7’de — düğümün tüm veritabanları için tek bir liste (sync_tables).
  4. Önizleme düğmesine tıklayın. Düğüm dahil etme maskesine uyan tüm dosyaları gösterir. Hiçbir şeyi değiştirmez.

  5. Listeyi denetleyin. Her dosyanın bir onay kutusu vardır:

    • işaretli — dosya yönetilecek;
    • işaretli, kilitli, zaten yönetiliyor işaretli — veritabanı zaten kayıtlı;
    • gerekçeyle kilitli — dosya maske, boyut veya dışlama listesiyle dışlanmış. Almak için kuralı değiştirin.
  6. Gerekli veritabanlarını işaretleyin ve Seçilenleri kaydet düğmesine tıklayın. RCM onay ister ve dosya sayısını gösterir.

Kayıt onayı
Kayıt onayı

Bu düğmenin yaptığı:

  • şablon kipinde — işaretsiz dosyalar dışlama listesine eklenir, işaretli dosyalar listeden çıkarılır;
  • liste kipinde — işaretli dosyalar dahil etme listesine eklenir.

Düğme, yönetimde olanlara veritabanı ekler. Kilitli satırları değiştirmez. 7. Kaydet düğmesi formu listeleri değiştirmeden uygular. 8. Tamamlanma iletisini ve eklenen veritabanı sayısını bekleyin. Uzun süre yanıt yoksa sonucu Komutlar sayfasında denetleyin.

HQbird 2027.2.24 ve sonrasında ileti „Kaydedildi: N“ dir. Birincilin Firebird’ü yeniden başlatılmalıysa RCM hangi düğmeye basılacağını söyler (genellikle veritabanı satırındaki Birincil Firebird’ü yeniden başlat) ve birincil veritabanlarına bir bağlantı verir. RCM 2027.5.7, veritabanları eklenmiş olsa bile „Uygun yeni veritabanı yok“ diyebilir: Veritabanları sayfasını denetleyin.

Kayıt sonucu
Kayıt sonucu

Kayıttan sonra veritabanı bulunmazsa ama düğümün zaten veritabanları varsa düğüm reddeder (409) ve eski kuralları döndürür. Böylece yoldaki bir hata tüm veritabanlarının replikasyonunu kapatmaz.

Komut satırından aynısı

Command
hqbirdrcm enroll-databases -node node-a -root /databases/master

Not: komut yalnızca parametrelerindeki alanları gönderir. Kalan kuralları (maskeler, boyutlar, dahil etme ve dışlama listeleri, sync_tables) düğüm sıfırlar. Komutun bu kurallar için parametresi yoktur. Komutu çalıştırmadan önce geçerli kuralları denetleyin (hqbirdrcm getconfig -node node-a). Ayarlıysa kayıt sayfasını kullanın.

3.4. Kayıttan sonra ne olur

  1. Düğüm kuralları node.json dosyasına yazar.
  2. Düğüm klasörü tarar (scansync).
  3. Bulunan her veritabanı için düğüm, replication.conf dosyasının kendi alanına bir blok yazar (# BEGIN managed-by:node-a role:master ile # END … satırları arasında) ve <database>.ReplLog ile <database>.LogArch klasörlerini oluşturur. Düğüm kendi alanı dışındaki metni değiştirmez.
  4. Değişiklikten önce düğüm dosyanın bir kopyasını saklar: replication_YYYYMMDD_hhmmss_NNN.conf.
  5. replication.conf değiştiyse veritabanları PENDING_RESTART durumuna girer: Firebird yeni dosyayı ancak yeniden başladıktan sonra okur. Düğümler tablosunda bu, Yeniden başlatma bekleniyor sütununda görünür.
„Düğümler“ tablosundaki „Yeniden başlatma bekleniyor“ sütunu
„Düğümler“ tablosundaki „Yeniden başlatma bekleniyor“ sütunu

Yeni bir veritabanının durumları:

Durum RCM’deki grup Anlam
UNCONFIGURED Beklemede veritabanı bulundu, yapılandırma henüz yazılmadı
PENDING_RESTART Beklemede yapılandırma yazıldı, Firebird yeniden başlatması gerekir
CONFIGURED Beklemede Firebird yeniden başladı, veritabanı yayın ve ilklendirmeye hazır

3.5. Birincil Firebird’ü yeniden başlatma

Birincil düğüm Firebird’ü hiçbir zaman kendisi yeniden başlatmaz. RCM de başlatmaz. Birincili yeniden başlatmak işletenin kararıdır: yeniden başlatma, o Firebird örneğinin tüm veritabanlarına olan bağlantıları keser.

Düşük yükte bir zaman seçin ve düğmelerden birine tıklayın:

  • Birincil Firebird’ü yeniden başlat — Veritabanları sayfasında, yeniden başlatma bekleyen veritabanının birincil satırında;
  • İlklendir penceresindeki aynı düğme, bölüm 5;
  • Firebird’ü yeniden başlat — veritabanı sayfasında.

RCM onay ister. Düğüm adını ve bir uyarı gösterir: Firebird yeniden başlatma penceresi olmadan hemen yeniden başlar ve tüm bağlantılar kesilir.

Birincil Firebird yeniden başlatma onayı
Birincil Firebird yeniden başlatma onayı

Komut satırından aynısı

Command
hqbirdrcm restartfirebird -node node-a

Bu komut da yeniden başlatma penceresi olmadan hemen yeniden başlatır.

Düğüm Firebird’ü nasıl yeniden başlatır:

  1. fbagent’ın yanıt verdiğini ve aynı örneği yönettiğini denetler (node.json dosyasından tanımlayıcı, port, hizmet adı). Herhangi bir değer uyuşmazsa düğüm reddeder.
  2. fbagent’tan Firebird’ü yeniden başlatmasını ister.
  3. Firebird’ün kendi portunda yanıt vermesini bekler.
  4. Veritabanlarını PENDING_RESTART durumundan CONFIGURED durumuna taşır.

Bir ana makinede birkaç HQbird örneği. fbagent, yapılandırmasının firebird.update.services listesindeki hizmetleri yeniden başlatır. Boş liste, ana makinedeki tüm HQbird hizmetleri demektir. Ana makinede iki HQbird örneği varsa listede yalnızca kendi örneğinizin hizmetini bırakın. Aksi halde bir düğümü yeniden başlatmak diğer örneği de durdurur.

Windows’ta. replication.log log_portion_mb veya daha fazlasına ulaştıysa yeniden başlatma şöyle gider: Firebird’ü durdur → günlüğü arşivle → başlat.

3.6. Elle replike edilen bir veritabanı

Bir veritabanı için replikasyon elle yapılandırılmışsa (replication.conf içinde kendi bloğu, yayın açık, segmentler akıyor), replika yeniden ilklendirilmeden yönetime alınabilir. Bunun için detect_existing kipi vardır (yalnızca birincil).

  1. Bir önizleme çalıştırın:

    Command
    hqbirdrcm enroll-databases -node node-a -root /databases/master -detect-existing -dry-run

    Yanıtta taken_over, taşınacak veritabanlarını listeler. Gerekçesiyle atlanan veritabanları görmek için -verbose ekleyin.

  2. Liste doğruysa komutu -dry-run olmadan çalıştırın.

Düğüm bir bloğu ancak şunlar sağlanırsa taşır:

  • segment klasörleri tam olarak <database>.ReplLog ve <database>.LogArch adındadır;
  • arşivde segmentler zaten vardır;
  • veritabanında yayın açıktır.

Düğüm farklı yollu bir bloğu taşımaz ve onu „bulundu ama desteklenmiyor“ olarak bildirir.

Taşımadan sonra veritabanlar, replikasyon ayarları değişmese de PENDING_RESTART alır: yalnızca blokun dosyadaki yeri değişir. Firebird’ü bir bakım penceresinde yeniden başlatın.

3.7. Nasıl doğrulanır

  • Veritabanları: veritabanı birincil düğüm satırında görünür, durum CONFIGURED (yeniden başlatmadan sonra).

  • Veritabanının yanında bir yayın KAPALI simgesi olabilir: yayın henüz açık değildir. Bu normaldir, yayın sonraki adımdır (bölüm 6).

    Birincil satırında yeni veritabanı
    Birincil satırında yeni veritabanı
  • Düğüm ana makinesinde: veritabanı bloğu replication.conf içinde managed-by:node-a alanındadır ve veritabanının yanında .ReplLog ile .LogArch klasörleri vardır.

3.8. Bir veritabanını yönetimden çıkarma

Olağan yol düğmedir. Veritabanları sayfasında veritabanlarını işaretleyin, toplu eylem Yönetimden çıkar seçin ve Seçilenlere uygula düğmesine tıklayın. RCM:

  1. dosyaları düğümün dışlama listesine ekler;
  2. klasörü bir kez tarar: veritabanı blokları replication.conf dosyasından çıkarılır;
  3. düğümdeki veritabanı kayıtlarını siler.

Veritabanı dosyaları ve segment klasörleri diskte kalır. Firebird yeniden başlatılmaz. Firebird, sonraki yeniden başlatmasına kadar veritabanı segmentlerini yazmaya devam eder; yeniden başlatma gerekiyorsa RCM söyler.

Canlı bir replikası olan bir birincil veritabanı için RCM reddeder (has_replicas): aksi halde replika sessizce durur. Önce replikayı normal bir veritabanına çevirin veya onu kaldırın (bölüm 8).

Veritabanı bloğunu replication.conf dosyasından elle silmeyin: sonraki taramada düğüm onu yeniden yazar.

Veritabanı dosyası kaybolduysa veya bir kuralla dışlandıysa. O zaman veritabanı ORPHANED durumunu alır (Sahipsiz grubu). Düğüm kaydını ve segment arşivini tutar: eksik bir veritabanı karardan çok hatadır. Dosya geri gelirse veritabanı yeniden çalışır ve uyarı kalkar. Böyle bir veritabanını kalıcı silmek için iki adımı bu sırayla yapın:

Command
# 1. delete the segment archive (optional)
hqbirdrcm cleanuparchive -node node-a -db <db_id> -orphaned
# 2. delete the database record
hqbirdrcm forgetdatabase -node node-a -db <db_id>

forgetdatabase sonrasında cleanuparchive komutu veritabanını artık bulamaz. Her iki komut yalnızca ORPHANED durumundaki bir veritabanı için çalışır ve veritabanı dosyasına dokunmaz.

Dikkat. Bir replikayı birincile yükselttikten sonra (bölüm 8) eski kayıt için cleanuparchive -orphaned çalıştırmayın: yeni birincil aynı .LogArch klasörünü kullanır ve komut onun çalışan arşivini siler.

3.9. Veritabanı kökünü değiştirme

Farklı bir yolla kayıt yapılabilir. Düğüm:

  • yeni klasörden veritabanları ekler;
  • eski klasörde olup yenisinde olmayan veritabanları ORPHANED durumuna taşır (bildirim orphaned_database) ve arşivlerini tutar.

Yanlış klasörü seçtiyseniz doğru klasörü yeniden kaydedin. Aynı tam yoldaki bir veritabanı aynı db_id altında çalışmaya devam eder. Farklı bir yoldaki veritabanı yeni bir veritabanıdır (yeni db_id); replikasının yeniden ilklendirilmesi gerekir.

3.10. Sık hatalar

Ne görürsünüz Neden Ne yapılır
preflight failed on node-a klasörlerde yetki yok yetkileri düzeltin, yeniden deneyin (3.2)
409 scan_would_empty_region yeni klasörde veritabanı yok ama düğümde vardı yolu ve maskeyi denetleyin
Önizleme boş maske uymuyor veya klasör yanlış yolu, maskeyi, „özyinelemeli“ değerini denetleyin
Düğmeler kapalı, „Düğüm yapılandırması okunamadı“ düğüm yanıt vermiyor düğüm hizmetini ve ağı denetleyin (bölüm 1)
Veritabanı uzun süre PENDING_RESTART durumunda kalıyor birincil Firebird’ü kendisi yeniden başlatmaz Firebird’ü yeniden başlatın (3.5)
fbagent yüzünden yeniden başlatma reddedildi fbagent çalışmıyor veya verisi node.json ile uyuşmuyor bölüm 1, fbagent denetimi
Yeni dosya görünmedi düğüm liste kipinde dosyayı „Seçilenleri kaydet“ ile ekleyin

4. Bir veritabanı nasıl replika yapılır: adımlar ve disk yeri

Bu bölüm, bir veritabanının birincilden çalışan bir replikaya kadar tüm yolunu ve disk alanı hesabını kapsar. İlklendirmenin kendisi bölüm 5 içinde ayrıntılıdır.

4.1. Ana kural

Bir veritabanı replikada yalnızca birincilden ilklendirme (reinit) ile ortaya çıkar: birincil düğüm kopyayı nbackup ile kendisi aktarır.

Kopyayı elle yapmayın:

  • gbak yeni bir veritabanı GUID oluşturur ve segment numarasını sıfırlar. Birincil — replika bağı kopar.
  • Çalışan bir veritabanının dosya kopyası tutarlı değildir ve RCM aynı GUID ile iki veritabanı görür (duplicate_guid) ve ilklendirmeyi yasaklar.

Elle yapılandırılmış, zaten çalışan bir replika yeni bir kopya olmadan yönetime alınabilir — bkz. 4.6.

4.2. Aşamalar

No. Aşama Nerede Aşamadan sonra birincil veritabanının durumu
1 Veritabanını birincile kaydetme bölüm 3.3 PENDING_RESTART
2 Birincilin Firebird’ünü yeniden başlatma bölüm 3.5 CONFIGURED
3 Yayını eşitleme bölüm 6 CONFIGURED, yayın AÇIK
4 Replikayı hazırlama: klasör, yetkiler, Firebird sürümü 4.3 —
5 Birincilde ve replikada boş alanı denetleme 4.4 —
6 İlklendirme bölüm 5 SEEDING → IN_SYNC
7 Replikanın Firebird’ünü yeniden başlatma (gerekirse) bölüm 5.6 replika segment uygulamaya başlar
8 Veriyi doğrulama bölüm 5.10 —

Aşama 3, Firebird 4/5 için zorunludur. Yayın olmadan birincilin Firebird’ü tablo değişikliklerini segmentlere yazmaz ve replika birincilin sessizce gerisinde kalır. Veritabanları sayfasında böyle bir veritabanı yayın KAPALI simgesiyle işaretlidir. İlklendirmeden önce Yayını eşitle düğmesine tıklayın.

HQbird 2027.2.24’ten beri İlklendir penceresi bunu uyarır ve Yayını eşitle ve ilklendir düğmesi sunar; birincil düğüm ilklendirmeyi publication_off hatasıyla reddeder (bölüm 5.1). RCM ve düğüm 2027.5.7 yayını denetlemez.

HQbird 2.5/3.0. Yayın yoktur, bu yüzden aşama 3 atlanır. Tablo kümesini replconf eklentisi süzgeçleri belirler (bölüm 6).

Veritabanı durumları:

Durum RCM’deki grup Anlam
CONFIGURED Beklemede Firebird ayarları okudu, henüz replika yok
PUBLISHING Beklemede yayın eşitlemesi sürüyor
SEEDING Beklemede ilklendirme sürüyor
IN_SYNC Tamam replika tüm segmentleri aldı
LAGGING Beklemede replika gecikiyor, segmentler kuyrukta
NEEDS_REINIT Hata replika yeniden ilklendirilmeli
FAILED Hata son ilklendirme başarısız oldu

4.3. Replikayı hazırlama

Replika veritabanı klasörü

Replika düğümü her veritabanını kendi databases.root klasörüne şu yola koyar:

Code
<databases.root>/<master node name>/<database path relative to the master root>

Örnek: kökü /databases/master olan birincil node-a ve veritabanı /databases/master/sales/employee.fdb. Kökü /databases/replica olan replika node-b üzerinde veritabanı burada olur:

Code
/databases/replica/node-a/sales/employee.fdb

Böylece farklı birincillerden aynı adlı veritabanları çakışmaz.

Kök klasörü kimse kendiliğinden oluşturmaz — ne yükleyici, ne HQCenter Admin, ne de başlangıçta düğüm. Onu şu yollardan biriyle oluşturun:

  • İlklendir penceresinde: Replika klasörü alanı, Klasör oluştur düğmesi. Düğme yalnızca klasör yokken görünür. HQbird 2027.2.24 ile, replika düğümünün henüz databases.root değeri yoksa alan zaten /databases/replica/<replica node id> içerir. Windows’taki bir replika için alan boştur: sürücü harfli bir klasör girin. Aynı ana makinedeki her replika düğümünün kendi klasörü olmalıdır. Klasörü replika düğümü oluşturur: sahip — firebird (veya düğüm hizmeti kullanıcısı), yetkiler 2770. Düğüm oluşturamazsa pencere replika ana makinesi için komutu gösterir. Başka bir klasör belirtirseniz RCM onu ilklendirmeden önce replika düğümünün databases.root alanına yazar;

  • replika ana makinesinde elle (Linux):

    Command
    sudo mkdir -p /databases/replica
    sudo chown firebird:firebird /databases/replica
    sudo chmod 2770 /databases/replica

    setgid biti (2770), içindeki tüm dosyaların Firebird grubunu alması için gerekir.

Replika kökü yalnızca veritabanı yokken değiştirilebilir: aksi halde eski veritabanlar taramanın dışında kalır. Tek bir veritabanını başka bir yere koymak için veritabanı sayfasındaki Taşı düğmesini kullanın.

Yetkiler

Replika düğümü ve Firebird, veritabanı köküne yazabilmelidir. Düğüm, konan dosyaların klasörün grubunu alacağını denetler. Alamazsa ownership_unfixable ile reddeder ve nasıl düzeltileceğini yazar (genellikle düğüm hizmeti Group=root ile çalışır).

HQbird 2027.2.24 ile İlklendir penceresi, var olan ama düğüm hizmetinin yazamadığı bir klasörü de gösterir: düzeltme komutuyla düğümün metni ve bir Yeniden denetle düğmesi. RCM 2027.5.7 bu durumda „Klasör var“ der: yetkileri kendiniz denetleyin (hqbirdrcm checkpermissions -node <replica> -root <folder>).

Firebird sürümü

Replikadaki Firebird ana sürümü birincille aynı olmalıdır (5.0 → 5.0, 4.0 → 4.0). Aksi halde replika herhangi bir veri aktarımından önce reddeder: incompatible_engine.

Bağlantı

Replika düğümü birincilin eşi, birincil de replikanın eşi olmalıdır (bölüm 2). Aksi halde RCM bu düğümü İlklendir penceresinde önermez.

4.4. Ne kadar alan gerekir

Kısaca

Nerede Ne Ne kadar
Birincil, veritabanı birimi ilklendirmeden önce boş veritabanı boyutunun ≥ % 105’i
Replika, veritabanı klasörü birimi ilklendirmeden önce boş veritabanı boyutunun ≥ % 105’i, HQbird 2027.2.24 ile — artı free_space_floor_gb (replika zaten vardıysa eski dosya da; Eski replikayı kaldır kutusuyla — onsuz)
Birincil, <database>.ReplLog Firebird çalışma segmentleri 64 segmente kadar × segment boyutu (varsayılan 16 MB) ≈ veritabanı başına 1 GB
Birincil, <database>.LogArch replikalar için segment arşivi retention_days boyunca değişiklikler (varsayılan 2 gün) + replikaların henüz onaylamadığı
Replika, <database>.Incoming uygulanacak segment kuyruğu en kötü durumda 256 segmente kadar × 16 MB ≈ veritabanı başına 4 GB
Replika, tüm birim pay en az free_space_floor_gb (varsayılan 1 GB)

İlklendirmeden önce alanı denetleme

İlklendirme alanı iki kez ve yalnızca veritabanını kilitlemeden önce denetler:

  1. RCM — komutu göndermeden önce düğümün en son istatistiğinden. Alan açıkça yetmiyorsa RCM hemen 507 hatasını döndürür.
  2. Birincil düğüm — kendi biriminde canlı ölçüm, sonra replikanın kendi birimini ölçmesi için istek. En az bir tarafta yetmezse ilklendirme SPACE CHECK adımında insufficient disk space on master veya … on replica hatasıyla biter.

Her iki taraftaki gereksinim, birincil veritabanı boyutunun % 105’i dir.

HQbird 2027.2.24 ile replika düğümü şöyle hesaplar:

  • veritabanı boyutunun % 105’i artı replikanın free_space_floor_gb değeri gerekir (7.3): ilklendirmeden sonra birimde segmentler için pay kalır;
  • önceki ilklendirmelerin artıkları (<database>.hqcluster-part, <database>.new) boş alan sayılır: düğüm onları yeni kopyadan önce siler;
  • hata metni tüm sayıları adlandırır. Boyutlarıyla birlikte <database>.pre-reinit-*.fdb ve <database>.failed-seed-*.fdb dosyalarını da adlandırır. Düğüm onları hiç silmez: gerekmiyorsa kendiniz silin.

force (zorunlu) yalnızca RCM’deki denetimi atlar. Düğüm denetimi atlanamaz: kopyalamanın ortasında diskin dolmasından düğümü korur. Alan yalnızca eski replika kopyası yüzünden yetmiyorsa RCM 2027.2.24, 507 hatasında force yerine Eski replikayı kaldır kutusunu adlandırır. Bunun için her iki düğüm HQbird 2027.2.24 veya daha yeni olmalıdır. Aksi halde hata, güncellenmesi gereken düğümü ve force değerini adlandırır.

Neden bu kadar

Birincil. Kopyalama sırasında veritabanı nbackup -L ile kilitlenir. Tüm değişiklikler veritabanının yanındaki <database>.delta dosyasına yazılır. .delta boyutu, kopyalama sırasındaki yazma yüküne bağlıdır. Ağır yük ve yavaş aktarımda oldukça büyüyebilir — ilk ilklendirmede alanı izleyin.

Replika. Kopya, veritabanı yerinin yanındaki <database>.hqcluster-part dosyasına doğrudan yazılır. Düğüm tam boyutu önceden ayırır. Dosya sonra denetlenir, onarılır (nbackup -FIXUP -SEQUENCE) ve yerine yeniden adlandırılır. İkinci bir kopya gerekmez — veritabanı boyutu veritabanı biriminde bir kez gerekir.

Replika zaten vardıysa (yinelenen ilklendirme), eski dosya son adıma kadar diskte durur. Bu, birimde eski dosya ile yeni kopyanın aynı anda gerektiği anlamına gelir. Boş alan eski dosya sayılmadan hesaplanır — bu yüzden gereksinim aynıdır: veritabanı boyutunun % 105’i boş.

Eski replikayı kaldır (HQbird 2027.2.24 ile). Replika biriminde eskinin yanında yeni kopya için yer yoksa ilklendirme penceresinde bu kutuyu işaretleyin (bölüm 5.1). Replika düğümü o zaman aktarımdan önce eski kopyayı ve gelen segmentlerini (.Incoming) siler ve birimde veritabanı boyutunun % 105’i artı free_space_floor_gb için yer olur. Düğüm kopyayı yalnızca tüm koşullar doğruysa siler:

  • silmeden yer yetmiyor, silince yetiyor;
  • bu düğümün ilklendirmesinin kurduğu bir kopya: başlık okunabilir, kip salt okunur replikadır;
  • veritabanı normal yapılmamıştır (<database>.hqcluster-normal.json dosyası yok, bölüm 8);
  • overwrite_non_replica ayarlı değildir (5.9).

Aksi halde düğüm hiçbir şey silmez ve gerekçeyi metinde vererek reddeder. Silmek için düğüm, silme süresince replikanın Firebird’ünü durdurur (5.6).

Kutu varsayılan olarak kapalıdır. Risk: aktarım sürerken replikada veritabanı kopyası yoktur. Veritabanının tek replikası varsa birincil tüm süre korumasızdır. Yeni kopya yokken replikadaki veritabanı NEEDS_REINIT durumundadır (FAILED ve ORPHANED değil) ve replika replica_removed_for_reinit uyarısını verir (warn). Yeni kopya yerine oturunca uyarı kalkar. Silmeden sonra ilklendirme başarısız olursa çift NEEDS_REINIT kalır: ilklendirmeyi yeniden başlatın (veya otomatik yeniden ilklendirme başlatır, 5.8). Yeni bir ilklendirme veritabanını baştan aktarır.

Birincil arşivi (.LogArch). Düğüm gönderilmiş segmentleri, replika yeniden isteyebilsin diye retention_days gün tutar. Replikanın henüz uygulamadığı segmentler daha uzun tutulur. Alan azsa düğüm arşivi aşamalı temizler:

  1. tüm replikaların uyguladığı, retention_days değerinden eski segmentler;
  2. daha yeni uygulanmış segmentler (alan kısaysa);
  3. uygulanmamış segmentler — yalnızca son çare. O zaman replika gereksindiği segmentleri yitirir ve NEEDS_REINIT alır.

Bir replika uzun süre erişilemezse arşiv büyür. Birimi = kesinti süresindeki veritabanı değişiklikleri.

Hesap örneği

Veritabanı 100 GB. Yük — günde 5 GB segment. İlklendirme gece yürür, kopyalama 2 saat sürer ve bu sırada yaklaşık 2 GB .delta içine gider.

Nerede Hesap Toplam boş
Birincil, veritabanı birimi denetimler için 105 GB (.delta büyümesi dahil) + .ReplLog 1 GB + .LogArch 2 gün × 5 GB = 10 GB ≥ 116 GB
Replika, yeni veritabanı 105 GB + .Incoming 4 GB’a kadar + 1 GB pay ≥ 110 GB
Replika, yinelenen ilklendirme diskte zaten 100 GB eski dosya + 110 GB boş birim ≥ 210 GB
Replika, Eski replikayı kaldır kutusuyla yinelenen ilklendirme (HQbird 2027.2.24 ile) eski dosya aktarımdan önce silinir: 105 GB + .Incoming 4 GB’a kadar + 1 GB pay birim ≥ 110 GB

Veritabanı büyümesi ve replika kesintisi için pay ekleyin (birincil arşivi kesinti günü başına 5 GB büyür).

Ayrı bir birimde segmentler

.ReplLog, .LogArch ve .Incoming klasörleri varsayılan olarak veritabanının yanındadır. Başka bir birime taşınabilir: node.json içindeki segments.storage parametresi (mirror_hierarchy: true ile düğüm veritabanı klasörlerinin yapısını yineler). O zaman arşiv veritabanlarından yer almaz. % 105 denetimi yine veritabanı birimine uygulanır.

Alana nereden bakılır

  • Veritabanları → Düğümler ve Genel bakış: databases.root birimi için boş alan simgesi. Sarı — % 20’den az, kırmızı — % 10’dan az.

    Veritabanları sayfası: Düğümler tablosundaki Disk sütunu
    Veritabanları sayfası: Düğümler tablosundaki Disk sütunu
  • Küme raporu: hqbirdrcm report.

4.5. Bir veritabanının birden çok replikası

İkinci ve sonraki replikalar aynı yolla oluşturulur: birincil satırında boş bir replika düğümü seçerek İlklendir.

  • Yeni bir replika ilklendirilirken birincil bu veritabanını çalışan replikalara da aktarmaz. İlklendirme bitince birincili yakalarlar. Onay penceresi bunu söyler.
  • Bir veritabanı — aynı anda bir ilklendirme, farklı replikalar için bile.
  • Birincildeki alan her ilklendirme için ayrı denetlenir.
İki replikalı birincil veritabanı
İki replikalı birincil veritabanı

4.6. Elle yapılandırılmış replika

Bir replika elle yazılmış bir replication.conf ile zaten çalışıyorsa yönetime alınabilir ve veritabanı yeniden kopyalanmaz:

  1. Birincil: veritabanlarını detect_existing ile kaydedin (bölüm 3.6).
  2. Replika: Veritabanları → replika düğümü → Devral veya hqbirdrcm takeover-replica. RCM replika bloklarını bulur, dosyaları GUID ile birincil veritabanlarına eşler ve her biri için gösterir: in_sync, resumable veya needs_reinit.
  3. Satırları onaylayın. Düğüm blokları kendi replication.conf alanına taşır.
  4. Taşınan blokları okuması için replikanın Firebird’ünü yeniden başlatın.
  5. Yalnızca needs_reinit satırlarını ilklendirin: birincil arşiv bu replikaların gereksindiği segmentleri artık içermez.

4.7. Sık hatalar

Ne görürsünüz Neden Ne yapılır
insufficient disk space on master / on replica yer yetmiyor (4.4). Yeniden ilklendirmede eski kopya sona kadar yer kaplar (4.4) yer açın, yeniden deneyin. Replikadaki ikinci çıkış (HQbird 2027.2.24’ten beri) Eski replikayı kaldır kutusudur (4.4, 5.1)
RCM’den hemen 507 alan istatistiğine göre açıkça yetmiyor aynı. Eski kopya olmadan yer varsa RCM 2027.2.24 Eski replikayı kaldır kutusunu adlandırır
incompatible_engine farklı Firebird ana sürümleri replikanın Firebird’ünü yükseltin
Replika düğümünde klasör yok kök oluşturulmadı ilklendirme penceresinde Klasör oluştur (4.3)
Klasör var ama düğüm hizmeti yazamıyor (HQbird 2027.2.24’ten beri) yazma yetkisi yok penceredeki komutu çalıştırın, Yeniden denetle düğmesine tıklayın (4.3)
publication_off (HQbird 2027.2.24’ten beri) birincilin yayını kapalı veya tablosu yok Yayını eşitle ve ilklendir (5.1)
ownership_unfixable düğüm hizmetinin yabancı bir grubu var hata metnindeki gibi hizmet grubunu düzeltin
duplicate_guid aynı GUID ile iki veritabanı (dosya kopyası) kopyayı kaldırın veya ona yeni bir GUID verin (nbackup -F)
Replika düğümü İlklendir listesinde değil eşlerde bağ yok bölüm 2
Replika IN_SYNC ama veri ayrışıyor yayın kapalıydı yayını eşitleyin, sonra ilklendirmeyi yineleyin

5. İlklendirme (reinit)

İlklendirme, birincil veritabanının bir kopyasının replikaya aktarılmasıdır. İlk aktarım ilklendirme (İlklendir düğmesi), yinelenen aktarım yeniden ilklendirme (Yeniden ilklendir düğmesi) adını alır. Düzenek aynıdır.

Başlamadan önce bölüm 4 içindeki 1–5 adımlarını tamamlayın: veritabanı kayıtlı, birincilin Firebird’ü yeniden başlatılmış, yayın açık, replika klasörü var ve yer yeterli. Birincilde ve replikada ne kadar yer gerektiği bölüm 4.4 içinde anlatılır.

5.1. Nasıl başlatılır

Önce yayın. Bir veritabanını kaydetmek yayını açmaz. Yayın olmadan replika değişiklik almaz. İlklendirmeden önce Yayını eşitle çalıştırın (bölüm 6) veya hqbirdrcm setpublication -node <master>.

  • HQbird 2027.2.24 ile ilklendirme penceresi yayını denetler. Kapalıysa veya anahtarlı tablosu yoksa pencere bir uyarı ve Yayını eşitle ve ilklendir düğmesi gösterir. RCM yayını eşitler, komutun bitmesini bekler ve penceredeki seçimle ilklendirmeyi başlatır.
  • 2027.2.24 birincil düğümü böyle bir ilklendirmeyi (ilkini de) publication_off hatasıyla kendisi reddeder ve master_publication_off bildirimini verir (bölüm 6.1). Reddedişten sonra veritabanı hücresinde yine Yayını eşitle ve ilklendir düğmesi vardır.
  • İşleten yayını kapattıysa (6.4) veya anahtarlı tüm tabloları çıkardıysa (6.3) eşitleme bunu korur. RCM ilklendirmeyi başlatmaz ve Yayın tabloları sayfasına bir bağlantı verir.
  • RCM ve düğüm 2027.5.7 yayını denetlemez: ilklendirme başarılı olur, veritabanı RCM’de „Tamam“ gösterir ama replika değişiklik almaz. Yayın ilklendirmeden sonra açıldıysa veritabanını yeniden ilklendirin.
„Veritabanı yeniden ilklendirilsin mi?“ penceresi
„Veritabanı yeniden ilklendirilsin mi?“ penceresi
  1. Veritabanları sayfasını açın.
  2. Birincil veritabanı satırında, replika düğüm sütununda İlklendir düğmesine tıklayın. Replika düğümünü sütun belirler: pencerede seçilmez. Var olan bir çift için — genişletilmiş birincil kartında Yeniden ilklendir.
  3. Pencerede (HQbird 2027.2.24 ile yeni bir çiftin başlığı „Veritabanı ilklendirilsin mi?“; RCM 2027.5.7’de — „Veritabanı yeniden ilklendirilsin mi?“ ve ilk ilklendirmede de):
    • Replika klasörü alanını denetleyin. Pencere klasörün var olup olmadığını gösterir. Yoksa Klasör oluştur düğmesine tıklayın: replika düğümü onu oluşturur (4.3). Düğüm oluşturamazsa pencere replika ana makinesi için komutu gösterir. HQbird 2027.2.24 ile pencere, düğüm hizmetinin yazamadığı bir klasörü de gösterir: düzeltme komutu ve bir Yeniden denetle düğmesi;
    • Yeniden ilklendirme yöntemi seçin: Yumuşak (önerilir) veya Standart (5.4). HQbird 2027.2.24 ile birincilin arşivinde henüz segment yoksa (genellikle ilk ilklendirmeden önce) pencere bir ipucu gösterir: yoğun bir veritabanında Standart daha hızlıdır;
    • birincil veritabanı hâlâ bir Firebird yeniden başlatması bekliyorsa pencere bunu söyler ve bir Birincil Firebird’ü yeniden başlat düğmesi gösterir. Yeniden başlatma olmadan veritabanı replike edilmez;
    • Eski replikayı kaldır (HQbird 2027.2.24 ile, varsayılan kapalı) yalnızca replika biriminde eskinin yanında yeni bir kopya için yer yokken yeniden ilklendirme için gerekir (4.4). Pencere sayıları önceden gösterir: ne kadar gerekir, ne kadar boştur, eski kopya ne kadar yer kaplar. Eski kopya olmadan yer varsa pencere kutuyu işaretlemenizi ister. Birincil veya replika düğümü eski bir sürümse kutu etkin değildir: pencere hangi düğümün güncelleneceğini belirtir. Yeni kopya hazır olana kadar replikada bu veritabanının kopyası yoktur (4.4).
  4. Onaylayın. RCM, veritabanının birincilde kilitleneceğini ve replikaya kopyalanacağını belirtir.

İlklendirme ilerlemesi Veritabanları sayfasındaki genişletilmiş birincil kartında görünür: adımlar ve yüzdeler. HQbird 2027.2.24 ile ilerleme sayfa yenilendikten sonra da görünür: ilk ilklendirmede — replika düğüm hücresinde ve birincil veritabanı sayfasındaki Yeniden ilklendirme ilerlemesi satırında. Birincil düğüm veritabanını kopyalarken İlklendir düğmesi etkin değildir. RCM bu ilklendirmeyi izlemiyorsa (örneğin düğümün komut satırından başlatıldıysa) adımlar yüzdesiz, düğüm durumundan alınır. RCM 2027.5.7’de sayfa yenilendikten sonra ilk ilklendirmenin ilerlemesi görünmez: birincil veritabanı SEEDING durumundan çıkana kadar bekleyin.

Birincil satırındaki ilklendirme adımları
Birincil satırındaki ilklendirme adımları

Her RCM komutu (ilklendirme, Firebird yeniden başlatması, yayın eşitlemesi) sonucuyla birlikte Komutlar sayfasına kaydedilir.

„Komutlar“ sayfası
„Komutlar“ sayfası

Komut satırından aynısı

Command
# one database
hqbirdrcm reinit -node node-a -db <db_id> -to node-b
# all master databases
hqbirdrcm reinit -node node-a -all -to node-b

Parametreler: -mode smooth|standard (varsayılan smooth), -hold=false (uzun işlemler sırasında arşivi tutma), -allow-restart (5.6), -force (5.9).

-remove-old-replica (HQbird 2027.2.24 ile) — Eski replikayı sil kutusuyla aynıdır. Yalnızca tek veritabanı: -db ve -to zorunludur; -all ile komut reddeder. Birincil veya replika düğümü eski bir sürümse RCM node_too_old ile reddeder ve hiçbir şey göndermez.

Command
hqbirdrcm reinit -node node-a -db <db_id> -to node-b -remove-old-replica

-all tüm veritabanlarını dener ve ilkinde durmak yerine hataları toplar.

5.2. Adımlar

No. Adım (RCM’de) Ne olur
1 SPACE CHECK birincilde ve replikada alanı denetler (bölüm 4.4); replika dosyayı kabul edebileceğini önceden denetler
2 LOCKING nbackup -L: birincilin veritabanı dosyası dondurulur, değişiklikler <database>.delta dosyasına gider
3 COPYING TO NODE dosya parçalar halinde aktarılır: oku → sağlama → sıkıştır → gönder
4 UNLOCKING aktarımdan hemen sonra nbackup -N: .delta içindeki değişiklikler veritabanına döner
5 SEEDING replikada: dosya sağlama doğrulaması, nbackup -FIXUP -SEQUENCE, dosyanın kurulması, gfix -replica, bloğun replication.conf dosyasına yazılması
6 RESTARTING REPLICA gerekiyorsa replikanın Firebird’ünün yeniden başlatılması (5.6)

Adım 6’dan sonra veritabanı IN_SYNC durumunu alır. Birincil, kopyanın bittiği noktadan segment göndermeye devam eder.

Bilmek önemli:

  • Birincil tüm süre çalışır. Kullanıcılar veritabanına yazar, değişiklikler .delta dosyasına gider. Kilit aktarımdan hemen sonra kalkar.
  • Kilitle çakışan işlemler yitmez. Düğüm, nbackup -L anında açık olan işlemleri bulur ve replika onları segmentlerden yeniden oynatır.
  • Aktarım bir kesintiden sonra sürer. Bağlantı veya replika düğümü yeniden başladıysa birincil son alınan parçadan devam eder. Bitmemiş bir aktarım replikada 24 saat tutulur (reinit_partial_keep_hours).
  • Bir hatada düğüm kilidi bırakır, replikadaki bitmemiş dosyayı siler ve veritabanını FAILED yapar. Sonraki deneme bilinen bir durumdan başlar.
  • „Eski replikayı sil“ kutusuyla (HQbird 2027.2.24’ten beri) replika, LOCKING adımından sonra, aktarımdan önce eski kopyayı siler. COPYING TO NODE adımı bu sırada „yer açmak için eski replika kopyası kaldırılıyor“ gösterir. Silmeden sonraki bir hata çifte FAILED yerine NEEDS_REINIT verir (bölüm 4.4).
  • Yalnızca nbackup. gbak kullanılmaz: veritabanı GUID değerini değiştirir.

5.3. Çalışmaya etkisi

Ne Etki
Birincilin kullanıcıları çalışmaya devam eder; kopyalama sırasında .delta büyür, -N sonrasında değişiklikler veritabanına aktarılır
Bu veritabanının diğer replikaları ilklendirme sürerken bu veritabanının segmentlerini almaz; sonra yakalar
Birincilin diğer veritabanları etkilenmez
Replikanın Firebird’ü, yeni veritabanı durdurulmaz; yeniden başlatma 5.6’ya göre
Replikanın Firebird’ü, yinelenen ilklendirme dosya değiştirilirken durdurulur: bu Firebird’ün tüm veritabanları saniyelerce kullanılamaz
Replikanın Firebird’ü, düğüm eski kopyayı siliyor („Eski replikayı sil“ kutusu, HQbird 2027.2.24’ten beri) silme sürerken, aktarımdan önce daha erken durdurulur. replication.conf içindeki veritabanı bloğu değişmediyse düğüm yeni kopyayı ikinci bir durdurma olmadan kurar. Yer yetiyorsa ve silme gerekmiyorsa düğüm hiçbir şey silmez ve her şey olağan yinelenen ilklendirme gibi gider
Ağ ve disk hız sınırlarına göre yük (5.5)

Windows’ta. Firebird’ün açtığı bir dosya değiştirilemez. Yinelenen ilklendirmede düğüm, replikanın Firebird’ünü fbagent üzerinden durdurur, dosyayı kurar ve Firebird’ü yeniden başlatır. Linux’ta da Firebird değiştirmeden önce durdurulur: aksi halde silinmiş eski dosyayla çalışmaya devam ederdi.

5.4. Yumuşak ve standart yöntem

Yumuşak (varsayılan). Kilitlemeden önce düğüm uzun işlemler arar: birincil arşivindeki en eski segmentten önce başlamış kullanıcı yazma işlemleri. İlklendirmeden sonra replika onları yeniden oynatamaz ve ilk değişikliklerinde durur („İşlem … bulunamadı“). Değişikliği olmayan işlemler sayılmaz.

Böyle işlemler varsa ilklendirme başlamaz: RCM Yumuşak yeniden ilklendirme uzun işlemleri bekliyor gösterir ve bir Listeyi aç bağlantısı verir.

Uzun işlemler sayfası: uzun işlem yok
Uzun işlemler sayfası: uzun işlem yok

Uzun işlemler sayfasında:

  • özet: kaç işlem ve bağlantı, en eski segment;
  • en eski işlemli İlk 5 bağlantı: kullanıcı, istemci, başlangıç, yaş, değişiklikler, geçerli sorgu;
  • Segmentleri tut / Tutmayı bırak — tutma açıkken birincil arşivi temizlenmez ve geçmiş kısaltılmaz;
  • Seçilenlerin bağlantısını kes ve yeniden ilklendirmeyi dene — bağlantıları keser (işlemleri geri alınır) ve hemen yumuşak bir yeniden ilklendirme başlatır;
  • Yeniden ilklendirmeyi dene, Yeniden denetle.

Tutma, uzun işlemler yüzünden bir yeniden ilklendirme reddedilince kendiliğinden açılır. Başarılı bir ilklendirmeden sonra, elle veya arşiv reinit_hold_max_segments değerine büyüyünce bırakılır (varsayılan 1000 segment, bildirim retention_hold_released).

Standart veritabanını denetlemeden hemen kilitler. Yalnızca uzun yazma işlemi olmadığını biliyorsanız kullanın.

Yük altında ilk ilklendirme. Birincilin arşivi boşken karşılaştırılacak segment yoktur.

HQbird 2027.2.24 birincil düğümüyle: düğüm yayını kendisi açtıysa ve arşiv o zamandan beri değişmediyse geçmiş, yayının açıldığı anda başlar. Daha sonra başlayan bir işlem günlüğe ilk değişikliğinden girer ve yumuşak yönteme engel olmaz. Daha önce başlayan bir işlem günlüğe girmedi: yeniden ilklendirme kilitlemeden önce onu bekler (her 10 s’de 6 deneme) ve locking adımı numarasını, bağlantısını ve kullanıcısını gösterir. Bitmediyse yeniden ilklendirme reinit_pre_publication_transactions hatasıyla biter: bitirin ve yeniden deneyin. Uzun işlemler sayfası böyle işlemleri Yayın açılmadan önce başlayan işlemler tablosunda gösterir.

Yayın düğüm üzerinden değil elle açıldıysa veya arşiv çoktan değiştiyse geçmişin başlangıcı bilinmez. O durumda herhangi bir yazma işlemi açıksa yumuşak yöntem reddeder ve ileti arşivin henüz bir segment içermediğini söyler. Bu durumda RCM 2027.2.24 listeyi açmaz, ne yapılacağını veritabanının hücresine yazar. Standart seçin veya Firebird ilk segmenti arşivleyince yeniden deneyin.

2027.5.7 birincil düğümüyle yumuşak yöntem, o anda yazılan bir veritabanının ilk ilklendirmesinde hemen reddeder: long_transactions … segment 0 (0001-01-01T00:00:00Z). Böyle bir veritabanının ilk ilklendirmesi için Standart seçin.

Sonraki yeniden ilklendirmelerde yumuşak yöntem olağan çalışır (arşiv zaten vardır).

Komut satırından aynısı

Command
hqbirdrcm longtx -node node-a -db <db_id>                       # list
hqbirdrcm longtx -node node-a -db <db_id> -disconnect 12,34 -retry-to node-b
hqbirdrcm longtx -node node-a -db <db_id> -hold false           # release hold

Yayından eski işlemler. Firebird, yayın açılmadan önce başlayan bir işlemi segmentlere yazmaz. Düğüm yayını açtıysa ilklendirme böyle işlemler bitene kadar bekler (her 10 saniyede 6 deneme); aksi halde onları listeleyen reinit_pre_publication_transactions hatasıyla biter. Tablo ekleyen bir yayını eşitledikten sonra uygulamaları yeniden bağlayın, sonra ilklendirmeyi başlatın.

5.5. Hız

Ne zaman Hız Ayar
windows.transfer_window aktarım penceresi içinde (varsayılan 23:00-05:00) sabit limits.reinit_window_mbps, varsayılan 100 MB/s
Pencere dışında ölçülen disk hızının payı limits.reinit_day_disk_fraction, varsayılan 0.5

Düğüm kipi her 30 saniyede bir yeniden hesaplar: gündüz başlayan bir ilklendirme gece kendiliğinden hızlanır.

Düğüm disk hızını bir testle ölçer. Testi birincil ana makinede yinelemek için:

Command
hqclusternode benchmark -config /opt/hqclusternode/master/node.json

İlklendirme süresi ≈ veritabanı boyutu ÷ hız. Örnek: 100 MB/s ile 100 GB — yaklaşık 17 dakika saf aktarım; pratikte ağı veya diski sınırlar.

5.6. Replika Firebird’ünü yeniden başlatma

Replikada yeni bir veritabanı. Dosya Firebird durdurulmadan konur. Firebird yeni replication.conf bloğunu ancak yeniden başladıktan sonra okur. O zamana kadar replika hiçbir şey uygulamaz. RESTARTING REPLICA adımı beklemeyi gösterir:

Etiket Anlamı
replikada bir Firebird yeniden başlatması bekleniyor, … için zamanlandı düğüm, diğer ilklendirmeler bitince son ilklendirmeden sonra Firebird’ü kendisi yeniden başlatır (reinit_restart_delay_sec)
… yeniden başlatma penceresi kapalı, sonraki … tarihinde açılacak replikanın restart_window değeri bekleniyor
… son deneme başarısız oldu, sonraki … tarihinde daha sonra yeniden deneyecek
replika Firebird’ü kendisi yeniden başlatamaz: elle yeniden başlatın auto_restart: never veya bu Firebird birincilin veritabanlarına da hizmet ediyor

Düğüm Firebird’ü her veritabanından sonra değil, bir dizi ilklendirmeden sonra bir kez yeniden başlatır.

Elle yeniden başlatmak için Replika Firebird’ünü yeniden başlat düğmesine tıklayın. Bekleme, başarılı herhangi bir Firebird yeniden başlatmasından sonra veya replika kopyadan yeni bir segment uygulayınca biter.

Birincilin veritabanlarına da hizmet eden bir Firebird üzerinde yeniden ilklendirme. Düğüm böyle bir Firebird’ü kendisi durdurmaz ve restart_not_allowed ile reddeder. İlklendirmeyi yeniden başlatın ve <düğümün> bu yeniden ilklendirme için Firebird’ü durdurmasına izin ver kutusunu işaretleyin (komut satırında -allow-restart) — bu Firebird’ün bağlantılarının, birincil veritabanlarına olanlar dahil, kesilebileceği bir zamanda. Böyle ilklendirmeleri ana makine başına birer birer yürütün.

Eski kopyayı silmek (Eski replikayı kaldır kutusu, HQbird 2027.2.24 ile) aynı kurallarla replikanın Firebird’ünü de durdurur. Düğüm bu Firebird’ü kendisi durduramazsa hiçbir şey silmez ve restart_not_allowed ile reddeder: <düğümün> bu yeniden ilklendirme için Firebird’ü durdurmasına izin ver kutusunu da işaretleyin. O sırada replikada başka bir ilklendirme bitiyorsa veya Firebird yeniden başlıyorsa düğüm hiçbir şey silmez ve engine_busy ile reddeder: birincil kilidi bırakır, daha sonra yeniden deneyin.

5.7. Kuyruk ve eşzamanlı ilklendirmeler

  • Bir veritabanı — aynı anda bir ilklendirme (farklı replikalar için bile). Bu veritabanının ilklendirmesi sürerken İlklendir düğmesi kapalıdır.
  • Birincil düğüm, farklı veritabanlarının aynı anda limits.max_concurrent_reinits ilklendirmesini zorlar (varsayılan 1). Kalanlar kuyrukta bekler; yanıt kuyruk konumunu içerir.
  • İlklendirmesi sırasında bir veritabanında kendi nbackup -L (veya ALTER DATABASE BEGIN BACKUP) komutunuzu çalıştırmayın ve böyle bir yedek sırasında ilklendirme başlatmayın: bir veritabanının tek kilidi olabilir. İlklendirme bunu denetler ve nbackup backup lock already active ile reddeder.

Kuyruk ve süren aktarımlar Aktarım sayfasında görünür.

Aktarım / kuyruklar sayfası
Aktarım / kuyruklar sayfası
  • Bir arızadan sonra <database>.delta dosyası kalırsa yedek çalışmadığından emin olun ve nbackup -N <database> çalıştırın. .delta dosyasını elle silmeyin.

5.8. Otomatik yeniden ilklendirme

RCM, NEEDS_REINIT durumundaki bir veritabanını kendisi yeniden ilklendirebilir, yalnızca yapılandırılmış bir pencere içinde. Varsayılan kapalı.

Bir veritabanı NEEDS_REINIT durumuna girince:

Neden Nerede görünür
yinelenen kurtarılamaz uygulama hatası (PK, UNIQUE, FK ihlali) — art arda 3 kez replika, replication_unrecoverable_error uyarısı
birincil veritabanı GUID değişti (geri yükleme, dosya değişimi) replika, replication_guid_mismatch uyarısı
birincilin arşivi replikanın gereksindiği segmentleri artık içermiyor birincil
replika ilklendirme için eski kopyayı sildi ve henüz yeni kopya yok (HQbird 2027.2.24’ten beri) replika, replica_removed_for_reinit uyarısı; birincil

Açmak için — Ayarlar → RCM (veya rcm.json, auto_reinit bölümü):

json
"auto_reinit": {
  "enabled": true,
  "default_window": "22:30-04:00",
  "max_concurrent": 1,
  "nodes": {
    "node-a": { "window": "23:00-05:00",
                "databases": { "sales/employee.fdb": "01:00-03:00" } }
  }
}
  • Pencere: veritabanı başına → düğüm başına → genel. "always" — her zaman.
  • Pencereler RCM ana makinesinin saatine göre hesaplanır.
  • max_concurrent — RCM’nin başka bir otomatik ilklendirme başlatması için kümede kaç ilklendirmenin (elle ve otomatik) sürebileceği.
  • Otomatik ilklendirme, elle ilklendirme ile aynı alan ve GUID denetimlerinden geçer. Komut yazarı system:autoreinit dir.
  • remove_old_replica_when_short (HQbird 2027.2.24’ten beri, Yer azken eski replikayı sil satırı) — varsayılan kapalı. Açıksa otomatik ilklendirme Eski replikayı sil bayrağını gönderir (4.4). RCM onu yalnızca replika kendisi NEEDS_REINIT durumundaysa veya birincilin NEEDS_REINIT nedeni onu adlandırıyorsa gönderir. IN_SYNC veya LAGGING bir replika için bayrak hiç gönderilmez. Düğüm daha eski bir sürümse RCM aynı ilklendirmeyi bayraksız başlatır.
  • Değiştirdikten sonra RCM’yi yeniden başlatın.

Birincilin kartındaki Ertele, tek bir veritabanının otomatik ilklendirmesini 1 saat, 4 saat, 24 saat veya iptal edilene kadar kapatır. Elle ilklendirme kullanılabilir kalır.

5.9. Hatalar

Hata Neden Ne yapılır
insufficient disk space on master / on replica, 507 yer yetmiyor. Yeniden ilklendirme sırasında eski kopya sona kadar yer kaplar bölüm 4.4; replikada (HQbird 2027.2.24’ten beri) — Eski replikayı kaldır kutusu (5.1)
node_too_old (HQbird 2027.2.24’ten beri) Eski replikayı kaldır kutusu işaretli ama birincil veya replika düğümü eski bir sürüm hata metnindeki gibi düğümü yükseltin veya kutusuz çalıştırın
engine_busy, reclaim_in_progress (HQbird 2027.2.24’ten beri) replika eski kopyayı şu anda silemiyor: Firebird veya bu veritabanı meşgul daha sonra yeniden deneyin (5.6)
replica_removed_for_reinit, NEEDS_REINIT çifti (HQbird 2027.2.24’ten beri) replika eski kopyayı sildi ama ilklendirme bitmedi ilklendirmeyi yeniden başlatın (4.4)
publication_off (HQbird 2027.2.24’ten beri) birincilin yayını kapalı veya anahtarlı tablo içermiyor Yayını eşitle ve ilklendir (5.1)
long_transactions, „Yumuşak yeniden ilklendirme uzun işlemleri bekliyor“ uzun yazma işlemleri açık 5.4
long_transactions, „birincilin arşivi henüz tek bir segment içermiyor“ yük altında ilk ilklendirme Standart (5.4)
reinit_pre_publication_transactions yayın açılmadan önce başlayan işlemler uygulamaları yeniden bağlayın, yeniden deneyin
duplicate_guid aynı GUID ile iki birincil veritabanı kopyayı kaldırın; birincile yükseltmede NEW GUID adımı atlandıysa — -force (bölüm 8.4)
license_paused birincilin fbagent’ında lisans yok bölüm 2.8
409 orphaned veritabanı birincilin taramasının dışında bölüm 3.8
incompatible_engine farklı Firebird ana sürümleri bölüm 4.3
target_not_replica replikanın yerinde çalışan bir veritabanı duruyor (normal yapılmış) aşağıya bakın
target_other_replica (HQbird 2027.2.24’ten beri) replikanın yerinde bu düğümün başka bir veritabanının kopyası duruyor aşağıya bakın
restart_not_allowed replikanın Firebird’ü birincil veritabanlarına da hizmet ediyor 5.6, „Firebird’ü durdurmaya izin ver“ kutusu
fbagent_required replikada fbagent kurulu değil bölüm 1
nbackup backup lock already active bir nbackup yedeği sürüyor 5.7
… -L did not finish in 2m0s and was stopped birincildeki nbackup -L 2 dakika içinde bitmedi, düğüm onu durdurdu yeniden deneyin; hata yinelenirse birincilin Firebird’ünü denetleyin (firebird.log)
reinit already in progress for this database bu veritabanının ilklendirmesi zaten çalışıyor bitmesini bekleyin

target_not_replica. Kopyanın yerinde çalışan bir veritabanı duruyor: normal yapılmış (<database>.hqcluster-normal.json dosyası var) veya replika kipinde değil. Düğüm çalışan bir veritabanının üzerine yazmaz. Değiştirilmesi gerekiyorsa düğüm API’sine overwrite_non_replica: true ile bir istek (RCM’de bunun düğmesi yoktur) dosyayı değiştirir ve eskisini <database>.pre-reinit-<UTC time>.fdb olarak saklar.

target_other_replica (HQbird 2027.2.24’ten beri). Replika kopyayı <databases.root>/<master id>/<database path> yoluna koyar. Birincil kimliği yalnızca kendi kümesi içinde benzersizdir, bu yüzden iki veritabanı aynı yola düşebilir. Replika düğümü, başka bir veritabanına ait bir kopyanın üzerine yazmaz: hata o veritabanını ve birincilini adlandırır. Düğüm, yolu farklı kaydedilmiş bir kopyayı da tanır (yolda sembolik bağ veya birleşim noktası, kısa Windows klasör adı). overwrite_non_replica bu hatayı kaldırmaz. Kopyalardan birini başka bir klasöre taşıyın veya o veritabanını replikadan kaldırın, sonra ilklendirmeyi yeniden başlatın. Düğüm yalnızca kendi veritabanlarını görür: aynı ana makinedeki iki replika düğümünün farklı replika klasörleri (databases.root) olmalıdır.

5.10. Sonuç nasıl denetlenir

  1. Veritabanları: birincil — replika çifti grupta Tamam, durum IN_SYNC.

  2. Birincilin kartında Doğrula: düğümler, veritabanının tablo listesindeki tabloların satırlarını (bölüm 3.1) birincilde ve replikada sayar ve karşılaştırır. Sakin zamanda denetleyin: etkin yazmada sayılar farklı olabilir.

    HQbird 2027.2.24 ile sonuç sayfası her tarafın listesini adlandırır (örneğin „bu veritabanının kendi listesi“ veya „yayın tabloları (liste ayarlı değil)“). RCM replikayı birincilin listesiyle sayar. Her iki veritabanında da olmayan bir tablo „veritabanında yok“ olarak gösterilir ve hata sayılmaz. Hiç tablo karşılaştırılmadıysa sonuç „Karşılaştırılacak tablo yok“ tur, uyuşmazlık değil. Karşılaştırma ayrılan sürede bitmezse sonuç „Karşılaştırılmadı (süre sınırı)“ dır, bu da uyuşmazlık değildir.

Doğrulama sonucu
Doğrulama sonucu
Command
hqbirdrcm verifydata -master node-a -master-db <db_id> -replica node-b -replica-db <db_id>
  1. Dönemsel denetim (isteğe bağlı): Veri denetimi sayfası, Tüm düğümler için aç. HQbird 2027.2.24 ile düğüm ayarları hemen uygular, düğüm hizmetini yeniden başlatmak gerekmez: Kaydet sonrasında RCM „Kaydedildi ve zaten yürürlükte“ yazar. Düğüm 2027.5.7’nin hqclusternode hizmetinin yeniden başlatılması gerekir ve RCM 2027.2.24 bunu söyler. Birincil ve replika aynı segmentteyken düğümler satır sayılarını kendileri karşılaştırır. Bir uyuşmazlık data_mismatch uyarısını yükseltir; sonra Doğrula çalıştırın.

İşletenin yayından çıkardığı bir tablo uyuşmazlık olarak değil, „yayınlanmadı“ olarak gösterilir.

6. Yayını yapılandırma

Yayın, Firebird birinciline hangi tabloların değişikliklerinin segmentlere yazılacağını söyler. O olmadan replika hiçbir şey almaz.

6.1. Yayın nedir

Firebird 4 ve 5’te replike edilecek tabloları RDB$DEFAULT yayını belirler:

  • Yayın açık — RDB$PUBLICATIONS içinde RDB$ACTIVE_FLAG = 1 vardır (ALTER DATABASE ENABLE PUBLICATION komutu).
  • Yayınlanan tablolar — RDB$PUBLICATION_TABLES içindeki liste.

Firebird değişiklikleri segmentlere yalnızca yayınlanan tablolar için ve yalnızca yayın açıkken yazar. Veritabanını kaydetmek (bölüm 3) yayını açmaz. Onu Yayını eşitle açar (6.2).

Birincil düğüm yayını her saat denetler (limits.publication_check_interval_sec, varsayılan 3600). Kapalıysa düğüm onu her 2 dakikada bir denetler.

Veritabanları sayfasında birincil veritabanının bir simgesi vardır:

Simge Anlam
yayın AÇIK yayın açık
yayın KAPALI Firebird segmentlere hiçbir şey yazmaz, replikalar değişiklik almaz
yayın bilinmiyor düğüm durumu okuyamadı

Yayın kapalı süzgeci, yayını kapalı veya bilinmeyen veritabanlarını gösterir.

Yayını kapalı bir veritabanının zaten bir replikası varsa birincil master_publication_off uyarısını yükseltir.

HQbird 2027.2.24 ile birincil bu uyarıyı, bir veritabanını publication_off hatasıyla ilklendirmeyi reddettiğinde de yükseltir (bölüm 5.1): yayın kapalıdır veya anahtarlı tablo içermez. Uyarı düzeyi:

  • warn — veritabanının henüz replikası yok: ilklendirme yayını bekliyor;
  • serious — veritabanının zaten bir replikası var;
  • info — yayını işleten kapattı.

Uyarı, yayın düzeltilince veya başka bir ilklendirme başlayınca kalkar.

6.2. Yayını eşitle

Birincil satırı: yayın kapalı
Birincil satırı: yayın kapalı

Nereye tıklanır:

  • Veritabanları sayfasındaki birincil veritabanı satırında. Yayın kapalıyken düğme simgenin yanındadır;
  • veritabanı sayfasında;
  • birkaç veritabanı için: satırları işaretleyin, Eylem listesinde Yayını eşitle seçin. RCM her veritabanı için ayrı bir komut gönderir.
Yayın eşitlemesini onaylama
Yayın eşitlemesini onaylama

Düğümün yaptığı (tek bir işlem):

  1. Yayını açar. İşleten kendisi kapattıysa (6.4) açmaz.
  2. Yayına henüz olmayan tüm anahtarlı tabloları ekler.
  3. Yayından anahtarsız tabloları ve işletenin dışladığı tabloları çıkarır (6.3).
  4. Yeni tabloların kendiliğinden eklenmesini kapatır (EXCLUDE ALL FROM PUBLICATION, sonra gereken tabloları ekler). Yayının bileşimini yalnızca düğüm belirler.
Eşitlemeden sonra birincil satırı: yayın açık
Eşitlemeden sonra birincil satırı: yayın açık

Anahtarlı tablo — birincil anahtarı veya etkin bir benzersiz dizini olan kalıcı bir kullanıcı tablosu. Sistem ve geçici tablolar yayınlanmaz.

Eşitleme, DBA’nın elle eklediği anahtarsız tabloları da yayından çıkarır.

Bileşim zaten doğruysa düğüm hiçbir şey değiştirmez.

Düğüm ne zaman reddeder:

Kod Gerekçe
no_publications HQbird 2.5/3.0 (6.6)
not_master düğüm birincil değil
reinit_in_progress bu veritabanının ilklendirmesi sürüyor
orphaned, database_failed, file_missing veritabanı taramanın dışında, hatada veya dosyası yok

Düğümün tüm veritabanları birden — yalnızca komut satırından. Komutlar sayfasında sonuç veritabanı başına gösterilir: bitti, atlandı veya hata. FAILED veya SEEDING durumundaki veritabanlar ve dosyasız veritabanlar atlanır.

Komut satırından aynısı

Command
hqbirdrcm setpublication -node node-a -db <db_id>   # one database
hqbirdrcm setpublication -node node-a               # all node databases

Komut 5 dakikaya kadar bekler ve her veritabanı için bir satır basar. Hatada çıkış kodu 1 dir. -nowait — sonucu bekleme.

6.3. Yayın tabloları

„Yayın tabloları“ sayfası
„Yayın tabloları“ sayfası

Birincil veritabanı satırında Yayın tabloları açın.

Sayfa şunları gösterir:

  • yayın durumu (açık/kapalı, işleten kapattı) ve sayaçlar;
  • her tablo: ad, anahtar ve durum.
Durum Anlam
yayınlandı değişiklikler segmentlere gider
henüz yayınlanmadı anahtarlı bir tablo, eşitlemede eklenecek
dışlandı işleten onu yayından çıkardı
anahtar yok yayınlanamaz

Anahtar sütununda — birincil anahtar veya yoksa en az alanlı benzersiz dizin.

Anahtarsız bir tablo neden yayınlanamaz. Replika satırı UPDATE ve DELETE için anahtarla arar. Anahtar olmadan satırı bulamaz. Bir birincil anahtar veya benzersiz dizin ekleyin, sonra yayını eşitleyin.

Yayından çıkar / Yayına geri al:

  1. Tabloları işaretleyin.
  2. Yayından çıkar veya Yayına geri al düğmesine tıklayın.
  3. Düğüm listeyi kaydeder ve yayını hemen eşitler.
„Yayından çıkar“ onayı
„Yayından çıkar“ onayı

Dışlanan tabloların listesi birincil düğümde saklanır. Eşitleme onu değiştirmez. Bir replika birincile yükseltilince (bölüm 8) liste yeni birincile geçer.

Denetim (bölüm 5.10) dışlanan bir tabloyu uyuşmazlık olarak değil, „yayınlanmadı“ olarak gösterir.

6.4. Yayını açma ve kapatma

Yayın tabloları sayfasında: Yayını kapat / Yayını aç.

  • Kapatmak işletenin seçimidir. Eşitleme yayını yeniden açmaz.
  • Yayın kapalıyken (veya bir tablo dışlanmışken) yapılan değişiklikler açıldıktan sonra bile replikaya gönderilmez.
  • Açtıktan sonra Denetle düğmesine tıklayın (bölüm 5.10). Veri ayrışıyorsa replikayı yeniden ilklendirin (bölüm 5).

6.5. Yeni bir tablo

Yeni bir tablo yayına kendiliğinden girmez: düğüm kendiliğinden eklemeyi kapatır.

DDL sonrasında:

  1. Tabloda bir birincil anahtar veya benzersiz dizin oluşturun.
  2. Yayını eşitle düğmesine tıklayın.
  3. Yeniden ilklendirme gerekiyorsa uygulamalardan yeniden bağlanmalarını isteyin. Firebird, yayın açılmadan önce başlayan işlemleri segmentlere yazmaz; COMMIT RETAINING böyle bir işlemi açık tutar. İlklendirme böyle işlemleri bekler, sonra reinit_pre_publication_transactions ile başarısız olur (bölüm 5.4).
„henüz yayınlanmadı“ durumundaki yeni bir tablo
„henüz yayınlanmadı“ durumundaki yeni bir tablo

Eşitlemeden önce yeni tabloya yazılan satırlar replikaya ulaşmaz. Varsa veriyi denetleyin ve gerekirse replikayı yeniden ilklendirin.

6.6. HQbird 2.5 ve 3.0

HQbird 2.5 ve 3.0’da yayın yoktur. Firebird, replconf eklenti dosyası bir birincil blok içeriyorsa segment yazar. Böyle düğümlerde yayın düğmeleri gizlidir ve API no_publications ile yanıt verir.

Tablo kümesini motor parametreleri belirler:

Parametre Anlam
include_filter hangi tablolar replike edilir: virgülle ayrılmış adlar veya kalıplar; boş — tümü
exclude_filter hangi tablolar replike edilmez

Parametreler Ayarlar → Replikasyon parametreleri içinde değiştirilir (bölüm 7.1). Yayın tabloları sayfası onları salt okunur gösterir, Motor ayarlarında değiştir bağlantısıyla. Firebird yeni değerleri yeniden başladıktan sonra okur.

HQbird 3.0'da yayın tabloları: motor süzgeçleri
HQbird 3.0'da yayın tabloları: motor süzgeçleri

replconf eklentisi. Düğüm, Firebird klasörüne kendi replconf.hqcluster.hqbird dosyasını yazar. Firebird onu yalnızca replconf.properties ona işaret edince okur. Eklenti bir kez etkinleştirilmelidir:

  1. Ayarlar → Düğümler, Replikasyon eklentisi (HQbird 2.5 / 3.0) bloğu. Blok, replconf.properties dosyasının nereye işaret ettiğini ve düğümün bulduğu sorunları gösterir.

Eklenti etkin değil: replconf.properties HQbird DataGuard dosyasına işaret ediyor
Eklenti etkin değil: replconf.properties HQbird DataGuard dosyasına işaret ediyor
  1. Etkinleştir… Pencere düğümün yapacaklarını listeler: eklentiyi kurmak, replconf.properties dosyasını düğümün dosyasına yöneltmek, eski dosyanın girdilerini taşımak. Ne zaman olacağını seçin: Yalnızca düğüm yeniden başlatma penceresi içinde veya Şimdi, yeniden başlatma penceresini yok sayarak.

Eklenti etkinleştirme penceresi
Eklenti etkinleştirme penceresi
  1. Firebird yeniden başladıktan sonra Etkinleştirildi alanı „evet: motor düğümün dosyasını okuyor“ gösterir.

Eklenti etkinleştirildi
Eklenti etkinleştirildi

Etkinleştirme Firebird’ü yeniden başlatır ve bu Firebird’ün tüm veritabanlarını etkiler. Onu sakin bir dönemde yapın.

7. Diğer replikasyon seçenekleri

7.1. Replikasyon parametreleri

Ayarlar → Replikasyon parametreleri, sihirbaz formu
Ayarlar → Replikasyon parametreleri, sihirbaz formu

Ayarlar → Replikasyon parametreleri sayfası, seçilen veritabanları veya düğümün bütünü için replication.conf içindeki anahtarları değiştirir.

  1. Birincil ve replikaları ekle — veritabanlarını seçin. RCM onları Firebird sürümüne ve role göre gruplar: birinciller ve replikalar için ayrı form.

  2. Her parametre için bir eylem seçin:

    Eylem Ne yapar
    değişiklik yok değer değişmez
    değer ata yeni bir değer
    sıfırla (bir üst düzeye) kendi değerini kaldır, üst düzeydeki değeri al
    yazma (Firebird değeri) anahtar yazılmaz, Firebird değeri geçer
  3. Nereye uygulanacağını seçin: Seçili veritabanlarına veya Düğümleri için varsayılan olarak.

  4. Önizleme — düğümler hiçbir şey değiştirmeden değerleri denetler.

Değişikliklerin önizlemesi
Değişikliklerin önizlemesi
  1. Uygula. RCM komutu her düğüme gönderir.

Değer nereden gelir (Geçerli sütunu):

Kaynak Değer
bu veritabanı veritabanı için ayarlı
düğüm değeri düğüm için varsayılan olarak ayarlı
yerleşik düğüm değeri koddaki düğüm değeri
Firebird değeri anahtar yazılmamış
dosyadan (burada henüz ayarlı değil) replication.conf içindeki değer, RCM henüz değiştirmedi
düğüm ayarladı salt okunur (yollar, önekler)

Yanıt vermeyen bir düğüm veritabanlarını seçilemez gösterir. Değişiklikler fbagent ister (yoksa fbagent_required).

Firebird’ü kim yeniden başlatır (Firebird replication.conf dosyasını yalnızca başlangıçta okur):

Düğüm Kim
birincil siz yeniden başlatırsınız: birincil Firebird’ü hiçbir zaman kendisi yeniden başlatmaz
firebird.auto_restart: never olan replika siz
Firebird’ü birincilin veritabanlarına da hizmet eden replika siz
diğer replikalar düğüm onu kendi yeniden başlatma penceresinde yeniden başlatır

Elle yeniden başlatma için sayfada bir Firebird’ü yeniden başlat düğmesi vardır.

7.2. Ana parametreler

Birincil, Firebird 4/5:

Parametre RCM’deki etiket Düğüm değeri Firebird İpucu
journal_archive_timeout Arşiv zaman aşımı 10 s 60 s Firebird tamamlanmamış bir segmenti kapatmadan önce kaç saniye bekler. Daha düşük — replika birincile daha yakındır. limits.data_check_quiet_sec (90) değerinden küçük olmalıdır
journal_segment_count Segment sayısı 64 8 .ReplLog içinde kaç segment durabilir. limits.backlog_critical (48) değerinden büyük olmalıdır
journal_segment_size Segment boyutu — 16 MB 1 MB ile 512 MB arası; alıcı 512 MB’den fazlasını kabul etmez
buffer_size — 1 MB

Düğüm ayrıca log_errors = true (değiştirilemez) ve disable_on_error = true yazar.

Replika, Firebird 4/5:

Parametre RCM’deki etiket Firebird Değer
apply_idle_timeout Boşta duraklama 10 s yeni segment yokken duraklama
apply_error_timeout Uygulama hatasından sonra duraklama 60 s bir hatadan sonra yeniden denemeden önceki duraklama
verbose_logging düğüm: true ayrıntılı replication.log; kapatılması önerilmez
skip_upddel_without_pk düğüm: true anahtarsız tablolarda UPDATE/DELETE atla

Yalnızca Firebird 5: include_filter, exclude_filter, cascade_replication.

HQbird 2.5/3.0 — aynı anlamlı log_* anahtarları: log_archive_timeout, log_segment_count, log_segment_size (buffer_size değerinin 2 katından az değil). alert_command anahtarı yalnızca node.json içinde ayarlanır.

Her parametre için bir ipucu RCM formunda vardır.

7.3. Arşiv deposu

Birincildeki <database>.LogArch arşivi aşamalı temizlenir:

  1. Tüm replikaların uyguladığı ve retention_days değerinden eski segmentler.
  2. Boş alan free_space_floor_gb değerinden azsa — saklama süresinden genç uygulanmış segmentler. Uyarı disk_serious_cleanup.
  3. Alan hâlâ azsa — en eskiden başlayarak uygulanmamış segmentler. Replika NEEDS_REINIT alır, uyarı replication_paused_reinit_scheduled.
Parametre (Ayarlar → Düğümler, Depolama ve dosyalar) Varsayılan
limits.retention_days — Arşiv saklama, gün 2
limits.retention_min_kept_segments — Son segmentleri her zaman tut 0 (kapalı)
limits.free_space_floor_gb — En az boş alan 1 GB
Ayarlar → Düğümler, „Depolama ve dosyalar“
Ayarlar → Düğümler, „Depolama ve dosyalar“

Arşivi elle temizleyin:

Command
hqbirdrcm cleanuparchive -node node-a              # stages for all databases on the node
hqbirdrcm cleanuparchive -node node-a -db <db_id>  # a single database

-orphaned (yalnızca -db ile birlikte) ORPHANED durumundaki veritabanının tüm segmentlerini siler (bölüm 3.8). Başka herhangi bir veritabanı için düğüm not_orphaned yanıtı verir. Yükseltme vericisinde -orphaned hiçbir zaman çalıştırmayın (bölüm 8.5).

7.4. Aktarım: sıkıştırma, hız, pencereler

Sıkıştırma eş başına ayarlanır: Ayarlar → Düğümler → Eşler, compress sütunu.

Değer Anlam
boş veya none sıkıştırma yok (varsayılan)
zstd zstd sıkıştırması

Değişiklik hemen yürürlüğe girer. Sıkıştırma yavaş bir ağda yararlıdır.

Segment aktarım hızı (Ayarlar → Düğümler, Aktarım ve yeniden ilklendirme):

Parametre Varsayılan Ne zaman yürürlüğe girer
limits.channel_a_mbps — Segment aktarım hızı 50 MB/s hemen
limits.channel_a_burst_mbps — Segment aktarım patlaması 200 MB hemen

Birim mebibayttır (MiB), ad „mbps“ dese de. Patlama hızdan küçük olamaz.

Ayarlar → Düğümler, „Aktarım ve yeniden ilklendirme“
Ayarlar → Düğümler, „Aktarım ve yeniden ilklendirme“

Zaman pencereleri (Zaman pencereleri):

Parametre Varsayılan Ne zaman yürürlüğe girer Neyi etkiler
windows.restart_window — Firebird yeniden başlatma penceresi birincil 22:00-05:00, replika always hemen replika düğümünün Firebird’ü ne zaman yeniden başlatabileceği
windows.transfer_window — Aktarım penceresi 23:00-05:00 düğüm yeniden başladıktan sonra tam ilklendirme hızı (bölüm 5.5)

Her alanın yanındaki etiket değişikliğin ne zaman yürürlüğe gireceğini gösterir: hemen veya düğüm yeniden başlatma.

Ayarlar → Düğümler, „Zaman pencereleri“
Ayarlar → Düğümler, „Zaman pencereleri“

7.5. Veri doğrulama

  • Doğrula — birincil ile replikadaki satır sayısının tek seferlik karşılaştırması (bölüm 5.10).
  • Veri doğrulama — dönemsel karşılaştırma (bölüm 5.10). Düğüm karşılaştırmayı birincil ve replika aynı segmentteyken yapar.
  • HQbird 2027.2.24 ile doğrulama ayarları Kaydet sonrasında hemen yürürlüğe girer; düğüm hizmetini yeniden başlatmak gerekmez. RCM „Kaydedildi ve zaten yürürlükte“ gösterir. Açtıktan sonra ilk doğrulama bir aralıktan sonra çalışır. Kapattıktan sonra süren bir doğrulama kesilir ve hiçbir şey yazmaz. Yeni aralık son doğrulamanın bitişinden sayılır. Sakla, gün, Sorgu sınırı, Sessiz ve İlerleme üreteci sonraki doğrulamadan yürürlüğe girer.
  • Düğüm 2027.5.7 bu ayarları yalnızca başlangıçta okur: Kaydet sonrasında o düğümde hqclusternode hizmetini yeniden başlatın. RCM 2027.2.24 „Kaydedildi, ama henüz yürürlükte değil“ gösterir ve gerekçeyi belirtir.
  • Hangi tabloların karşılaştırılacağını veritabanının tablo listesi belirler (bölüm 3.1). HQbird 2027.2.24 ile her veritabanının kendi listesi olabilir: kayıttaki alan veya birincilin veritabanı sayfasındaki Eşitleme izleme tabloları bloğu (bölüm 3.3). Veri doğrulama sayfası hangi listenin kullanıldığını ve „veritabanında yok“ tablo sayısını gösterir. 2027.5.7’de liste düğüm başınadır (sync_tables).
  • Yayından dışlanan tablolar „yayınlanmadı“ olarak gösterilir (bölüm 6.3).
Veri doğrulama sayfası
Veri doğrulama sayfası

7.6. Uyarılar

Uyarılar sayfası
Uyarılar sayfası

Uyarılar sayfası. Eylemler:

  • Onayla — uyarı görünür kalır ama onaylandı işaretlenir;
  • 60 dk sessize al — bir saat gizle;
  • Sil / Bu kodla tümünü sil — RCM silmeyi uyarıyı yükselten düğüme geçirir. Neden duruyorsa uyarı yeniden görünür.
Command
hqbirdrcm clearalerts -code backlog_warn   # also -id, -acked, -all

HQbird 2027.2.33’ten beri RCM uyarıları Telegram’a, bir webhook’a (Slack, Teams, JSON) ve e-posta ile gönderir. Kanallar rcm.json dosyasının notify.channels bölümünde yapılandırılır. Uyarılar sayfasındaki Bildirim kanalları bloğu kanalları gösterir ve bir deneme iletisi gönderir. RCM warn ve üstü düzeydeki sorunları bildirir: bir sorun ortaya çıktı, daha ciddi oldu veya kalktı. Kanal yoksa RCM hiçbir şey göndermez. Daha eski sürümlerde gönderim yoktur: Uyarılar sayfasını izleyin veya RCM API’sini sorgulayın.

Ana kodlar:

Kod Anlam
backlog_warn / backlog_critical .ReplLog içinde 32 / 48 arşivlenmemiş segment
disk_serious_cleanup arşiv 2. aşamada temizleniyor (7.3)
replication_paused_reinit_scheduled uygulanmamış segmentler silindi, ilklendirme gerekir
shipping_paused eşe gönderim askıya alındı (7.7)
apply_error, replication_stopped, replication_unrecoverable_error replika bir segmenti uygulayamıyor
replication_guid_mismatch birincil veritabanı GUID değişti
segment_missing, segment_rejected, sequence_gap segment sırasıyla sorunlar
firebird_down, firebird_log_error Firebird çalışmıyor veya hataları günlüğe yazıyor
firebird_not_answering HQbird 2027.2.30’dan beri: Firebird bir dakika boyunca bir veritabanı bağlantısına yanıt vermedi (takılma). Zaman aşımı yüzünden kurulamayan bir bağlantı da buna girer; firebird_down yalnızca bağlantı reddidir
master_publication_off yayın kapalı (bölüm 6); HQbird 2027.2.24’ten beri ve bir publication_off başarısızlığından sonra (bölüm 6.1)
replica_removed_for_reinit HQbird 2027.2.24’ten beri: replika ilklendirme için eski kopyayı sildi ve henüz yeni kopya yok (bölüm 4.4)
orphaned_database tarama dışında veritabanı (bölüm 3.8)
restart_required_after_reinit replikanın Firebird’ünün yeniden başlatılması gerekir (bölüm 5.6)
data_mismatch dönemsel denetim bir uyuşmazlık buldu
license_paused fbagent’ın lisansı yok (bölüm 2.8)

7.7. Gönderimi duraklatma

Veritabanları sayfasında, birincil satırında: Gönderimi duraklat / Gönderime devam et. Birden çok veritabanı için — Eylem listesi üzerinden.

Command
hqbirdrcm pauseshipping  -node node-a -db <db_id>
hqbirdrcm resumeshipping -node node-a -db <db_id>
Gönderimi duraklatma onayı
Gönderimi duraklatma onayı
Duraklama sırasında birincil satırı
Duraklama sırasında birincil satırı
  • Duraklama Gönderime devam et olana veya ilklendirmeye kadar yürürlükte kalır.
  • Birincil Firebird segment yazmaya devam eder. .LogArch arşivi büyür: replika durmuşken 1. aşama (7.3) onun segmentlerini silmez.
  • Uzun bir duraklama 3. aşamaya ve NEEDS_REINIT durumuna varabilir. Alanı izleyin.
  • Veritabanının replikası yoksa veya yayın kapalıysa düğme yoktur. Duraklatma: lisans yok simgesi lisansla ilgili bir duraklama demektir (bölüm 2.8); onu yalnızca bir lisans kaldırır.

7.8. Günlükler

Günlük Nerede
Düğüm <installation folder>/logs/node-YYYYMMDD.jsonl (/opt/hqclusternode veya C:\hqclusternode), her biri 32 MB, 20 dosya
Firebird replication.log, firebird.log node.json içindeki yollar: firebird.replication_log, firebird.firebird_log
RCM Linux: journalctl -u hqbirdrcm
RCM denetimi rcm-data/audit.jsonl

Uzak düğüm günlüğü — Günlükler sayfası: bir düğüm ve bir kaynak seçin (replication.log, firebird.log, düğüm agent’ı).

Günlükler sayfası
Günlükler sayfası
Command
hqbirdrcm getlogs -node node-b -source replication -tail 200

8. Bir replika nasıl normal veritabanına çevrilir

İki yol vardır:

Yol Ne zaman Ne elde edersiniz
Normale çevir, 8.1 ayrı çalışan bir kopya gerekir: raporlar, denemeler, yeni birincil olmadan bir arıza replikasyon dışında normal bir veritabanı
Birincile yükselt, 8.3 replika yeni birincil olmalıdır birincil rolündeki bir eşlikçi düğümün yönettiği bir veritabanı

Yolların hiçbiri arayüzden geri alınamaz.

8.1. Normal yap

Replika „Eylem“ listesi: „Normal yap“ öğesi
Replika „Eylem“ listesi: „Normal yap“ öğesi
  1. Veritabanları, replika tarafı: replika satırlarını işaretleyin.

  2. Eylem listesinde Normal yap seçin ve onaylayın. Satırda ayrı bir düğme yoktur. Komut satırı komutu da yoktur.

„Normal yap“ onayı
„Normal yap“ onayı
3. Replika düğümü: - `gfix -replica none` çalıştırır (HQbird 2.5/3.0: `gfix -replica {}`). Veritabanı segment uygulamakla meşgulse düğüm onu birkaç saniye `single` kapatmasına alır (`gfix -shut single -force 0`), replika kipini temizler ve `gfix -online normal` ile geri verir. **Bu veritabanına olan tüm bağlantılar kesilir**; - `.hqcluster-normal.json` işaret dosyasını yazar (zaman, yazar, db_id, GUID); - `.Incoming` kuyruğunu temizlemeye başlar (8.2). 4. RCM veritabanını **Replika değil (normal)** grubunda gösterir.
„Normal yap“ sonrasında „Veritabanları“ sayfası
„Normal yap“ sonrasında „Veritabanları“ sayfası

Bundan sonra veritabanı yazmaya açıktır.

Replika bloğunu replication.conf dosyasından kaldırın. Düğüm onu sonraki taramada kaldırır ve Firebird dosyayı başlangıçta okur:

Command
hqbirdrcm scansync -node node-b
hqbirdrcm restartfirebird -node node-b

O zamana kadar bu veritabanı için „veritabanı replika kipinde değil“ hataları uyarı olarak yükseltilmez.

İşaret dosyası veritabanını korur. İlklendirme böyle bir veritabanının üzerine yazmaz: target_not_replica ile reddedilir (bölüm 5.9). Yalnızca işareti silmek yetmez: düğüm veritabanı başlığındaki replika kipini de denetler. Eski replikayı sil kutusu (bölüm 4.4) böyle bir veritabanını da silmez.

HQbird 2027.2.24 ile, replika bu veritabanının eski kopyasını ilklendirme için silerken Normal yap reclaim_in_progress ile reddedilir: daha sonra yeniden deneyin.

Veritabanının yeniden replika olması gerekiyorsa — bunu yalnızca üzerine yazmalı yeni bir ilklendirme yapar. Düğüm API’si üzerinden yapılır (overwrite_non_replica: true); RCM’de böyle bir düğme yoktur. Eski dosya <database>.pre-reinit-<UTC time>.fdb olarak saklanır ve işaret silinir.

8.2. Segmentlere ne olur

  • Düğüm veritabanlarını tarayana kadar birincil segment göndermeye devam eder. Her 30 saniyede replika düğümü eski segmentleri siler ve yalnızca son 100 tanesini tutar (keep_segments).
  • Taramadan sonra replikadaki veritabanı kaydı ORPHANED durumunu alır. Replika düğümü birincile unknown_database ile yanıt verir. Birincil bu replikaya segment göndermeyi bırakır, onun için arşiv tutmayı bırakır ve onu her 10 dakikada bir yeniden denetler.
  • Bu veritabanının diğer replikaları etkilenmez.
  • ORPHANED kaydı silinebilir (bölüm 3.8): hqbirdrcm forgetdatabase. Veritabanı dosyasının kendisi silinmez.

8.3. Birincile yükselt

Replika yeni birincil olur. Dosyası yerinde kalır ve denetim eşlikçi düğüme geçer.

Koşullar:

Koşul Red
veritabanı bir replikadır bad_request
aynı ana makinede birincil rolünde bir düğüm — eşlikçi — çalışıyor (rcm.json içinde aynı host etiketi, bölüm 2.1) no_companion
bu veritabanının yükseltmesi zaten sürmüyor already_running
bu veritabanına veya onun birincilinden ilklendirme yok reinit_running

RCM eşlikçi düğümü oluşturmaz: onu önceden kurun (bölüm 1).

Nasıl başlatılır:

  • replika satırında Birincile yükselt veya Eylem listesinde;

  • komut satırından:

    Command
    hqbirdrcm promotetomaster -node node-b -db <db_id>   # -timeout 10m

RCM onay ister ve eşlikçi düğümü adlandırır.

Onay „Birincile yükselt?“
Onay „Birincile yükselt?“

Adımlar (replika satırında görünür, adlar İngilizcedir):

No. Adım Ne yapar
1 TURN TO NORMAL 8.1’deki gibi; veritabanı zaten normalse atlanır
2 NEW GUID yerinde yeni bir veritabanı GUID (8.4)
3 EXCLUDE ON DONOR replika düğümü (verici) dosyayı kendi taramasından dışlar (exclude_paths)
4 ENROLL ON <eşlikçi> eşlikçi düğüm dosyayı birincil veritabanı olarak kaydeder
5 PUBLICATION SYNC yayın eşitlemesi; dışlanan tablo listesi eski birincilden taşınır (bölüm 6.3)
6 RESTART DONOR FIREBIRD vericinin Firebird’ünün yeniden başlatılması, pencere beklenmeden
7 RESTART <eşlikçi> FIREBIRD eşlikçinin Firebird’ünün yeniden başlatılması, pencere beklenmeden
8 FINALIZE verici satırı Hayalet replika olur; eski birincil Düşürülmüş birincil olabilir (8.5)
Replika satırındaki yükseltme adımları
Replika satırındaki yükseltme adımları

HQbird 2.5 ve 3.0’da yayın yoktur: PUBLICATION SYNC adımı „bu motorda yayın yok“ metniyle biter.

HQbird 3.0'da yükseltme adımları (Windows)
HQbird 3.0'da yükseltme adımları (Windows)

Verici ve eşlikçi aynı Firebird’ü kullanıyorsa o Firebird yeniden başlatılır: tüm veritabanlarına olan bağlantılar kesilir.

Bir adım başarısız olursa iş, hata metniyle failed olur. Nedeni düzeltin ve Birincile yükselt düğmesine yeniden tıklayın: tamamlanan adımlar yinelenmez. Yükseltme sırasında RCM yeniden başlarsa iş de failed olur — düğümlerin durumunu denetleyin ve yeniden deneyin.

Lisans. Birincilin ana makinesindeki fbagent’ın lisansı yoksa birincil gönderimi duraklatmıştır. Yükseltme yine de olanaklıdır. RCM sizi uyarır: duraklama başladıktan sonra yapılan değişiklikler yiter.

8.4. Yeni GUID

Yükseltmeden sonra veritabanı kendi GUID değerini almalıdır. Aksi halde yeni birincil eski birincilin GUID değeri altında segment yazar ve replikaları duplicate_guid ile reddedilir.

Düğümdeki NEW GUID adımı:

  1. gfix -shut single -force 0 — veritabanına olan tüm bağlantılar kesilir;
  2. nbackup -L, sonra -SEQUENCE olmadan nbackup -F;
  3. <database>.delta dosyasını siler;
  4. başlığı denetler: yeni GUID, REPLICATION_SEQUENCE = 0;
  5. gfix -online normal.

Firebird yeniden başlatılmaz. Yöntem tüm sürümlerde çalışır (2.5, 3.0, 4.0, 5.0).

Adım kesildiyse düğüm newguid_interrupted uyarısını verir. Veritabanı single kapatmasında kalabilir. Birincile yükselt işlemini yineleyin: adım devam eder.

Verici düğüm eski bir sürümse veya dosyanın zaten kendi GUID değeri varsa adım atlanır (metin skipped: ile başlar).

Yeni bir GUID sonrasında eski nbackup zinciri artık uygun değildir. Yeni bir düzey 0 nbackup kopyası yapın.

Veritabanı ADD DIFFERENCE FILE ile oluşturulduysa .delta dosyası başka bir yerdedir: onu elle silin.

8.5. Yükseltmeden sonra

Verici kaydı. Replika düğümünde veritabanı ORPHANED kalır, yol exclude_paths içinde kalır, .Incoming klasörü ve etiket kalır. RCM’de bu, Yeni birincilde aç ve Temizle düğmeli Hayalet replika satırıdır.

Verici satırı: «Hayalet replika»
Verici satırı: «Hayalet replika»
  • Satırı kaldırmak için Temizle düğmesine tıklayın. Bu yalnızca RCM’yi değiştirir.
  • Verici kaydını replika düğümünden kaldırmak için forgetdatabase çalıştırın. Dosya ve .Incoming klasörü kalır. HQbird 2027.2.30 ve daha yenisi komutu reddetmez (mailbox_active), çünkü verici yolu exclude_paths içindedir. Daha eski sürümlerin düğümleri, dosya ve .Incoming klasörü varken reddeder.
  • Vericide cleanuparchive -orphaned hiçbir zaman çalıştırmayın. Verici ve eşlikçi aynı <database>.LogArch klasörünü paylaşır. Komut yeni birincilin canlı arşivini siler.

Eski birincil.

  • Verici onun son çalışan replikasıysa RCM eski birincili Düşürülmüş birincil yapar ve vericiye gönderimi duraklatır („gönderim duraklatıldı: … (birincile yükseltme)“). Vericiye gönderimi sürdürmeyin: o zaten çalışan bir veritabanı tutuyor. Bu durumu kaldırmak için veritabanını başka bir replikaya ilklendirin.

    Eski birincil: «Düşürülmüş birincil», gönderim duraklatıldı
    Eski birincil: «Düşürülmüş birincil», gönderim duraklatıldı
  • Eski birincilden verici düğüme ilklendirme reddedilir (target_not_replica): o zaten çalışan bir veritabanı tutuyor.
  • NEW GUID adımı atlandıysa eski ve yeni birincilin GUID değeri aynıdır. O durumda eski birincilden ilklendirme -force ister (bölüm 5.9).
  • Elle yükseltmeden sonra RCM eski birincili yeni birincilin replikasına çevirmez. Eski birincildeki uygulamaları durdurun ve veritabanını yönetimden çıkarın (bölüm 3.8). Hizmet olarak tanımlı bir veritabanı için bunu Yeniden katıl yapar (8.7).

Yeni birincil. Ona bir replika kurun: replika düğümü, eşler (bölüm 2), yayın (bölüm 6), ilklendirme (bölüm 5).

Yeni birincil: yeni GUID'li veritabanı, henüz replika yok
Yeni birincil: yeni GUID'li veritabanı, henüz replika yok

8.6. Planlı geçiş: denetim listesi

Bu, elle geçişin yordamıdır. Hizmet olarak tanımlı bir veritabanı için RCM birincili kendisi geçirir (8.7). Elle yükseltme, uygulamaların eski birincile yazıp yazmadığını denetlemez. Yordam:

  1. Önceden. Replika ana makinesinde birincil rolünde bir eşlikçi düğüm çalışıyor ve her iki düğümün host etiketi aynı (bölüm 2.1). Yeni birincil için gelecekteki replikanın düğümü hazır.
  2. Uygulamaların eski birincilin veritabanına yazmasını durdurun.
  3. Replika her şeyi alıp uygulayana kadar bekleyin: Veritabanları → IN_SYNC, kuyruk yok.
  4. Denetle (bölüm 5.10): satır sayıları uyuşuyor.
  5. Birincile yükselt (8.3). FINALIZE adımını bekleyin.
  6. Denetleyin: veritabanı eşlikçinin birincil listesinde, yayın açık.
  7. Uygulamaları yeni birincile geçirin.
  8. Yeni veritabanının düzey 0 nbackup kopyasını yapın (8.4).
  9. Verici satırı için hayalet kaydı temizleyin (8.5).
  10. Replikayı yeni birincile bağlayın ve ilklendirin (bölüm 5).
  11. Eski birincil: veritabanını yönetimden çıkarın veya arşiv olarak bırakın (8.5).

8.7. Hizmetler: RCM’de planlı geçiş ve yük devretme

HQbird 2027.2.30 ile RCM birincili başka bir ana makineye kendisi taşır. Bunun için veritabanı bir hizmet olarak tanımlanır: birkaç ana makinede bir mantıksal veritabanı. Hizmetin her ana makinesinde bir birincil düğüm ve bir replika düğüm vardır ve veritabanı dosyasının yolu aynıdır. Hizmet Hizmetler sayfasında (HQbird 2027.2.31’den beri) veya hqbirdrcm services put -id <id> -file <file>.json komutuyla oluşturulur.

Eylem Ne yapar Komutlar
Planlı geçiş veri yitmeden birincilin planlı aktarımı. Sonra eski birincil kendiliğinden yeni birincilin replikası olur hqbirdrcm switchover -service <id> -check, sonra hqbirdrcm switchover -service <id> -to <host>
Yük devretme birincil ana makine yitirildi: RCM replikayı yükseltir. Birincilin en son değişiklikleri yitebilir hqbirdrcm failover -service <id> -check, sonra hqbirdrcm failover -service <id> -to <host> -accept-data-loss
Yeniden katıl bir yük devretmeden sonra eski ana makineyi yeni birincilin replikası olarak döndürür hqbirdrcm rejoin -service <id>
Sürdür hizmeti failed durumundan çıkarır hqbirdrcm resume -service <id> -check, sonra hqbirdrcm resume -service <id>

Aynı eylemler hizmet sayfasındadır: Planlı geçiş…, Yük devretme…, Yeniden katıl… ve Sürdür… düğmeleri.

  • Otomatik yük devretme varsayılan kapalıdır. Her hizmet için ayrı açılır: hqbirdrcm policy -service <id> -auto-failover on -max-data-loss 30. Yönlendiriciler ister. RCM bir yük devretmeyi yalnızca birincil düğüm sessizken, yönlendiricilerin çoğunluğu birincilin Firebird’ünü göremiyorken ve replika gecikmesi max_data_loss_sec değerinden fazla değilken başlatır.
  • Bir yönlendirici (hqclusternode router, Linux) HAProxy’yi hizmetin geçerli birincilinde tutar. Uygulamalar <router host>:<router_port> adresine bağlanır ve bir geçiş olunca bağlantı dizgisini değiştirmez.
  • Bir yük devretmeden sonra RCM, eski birincil yeniden yanıt verince onu yalıtır (rol fenced). Onu rejoin komutuyla geri getirin.