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
Birincilde Firebird, veritabanı değişikliklerini segmentlere (replikasyon
günlük dosyaları) yazar.
Birincil düğüm, segmentleri güvenli bir kanal (mTLS) üzerinden replika düğümüne gönderir.
Replika düğümü segmentleri gelen segmentler klasörüne koyar. Replikanın Firebird’ü
bunları veritabanının kendi kopyasına uygular.
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.
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)
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).
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.
/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:
10 dakika içinde fbagent kümeyi HQCenter Admin’den alır (bundan sonra değişiklikleri
her 60 saniyede bir denetler).
RCM ana makinesindeki fbagent, kümenin sertifika yetkilisini (CA) oluşturur ve tüm düğümlerin
sertifikalarını imzalar.
Her fbagent, küme üyeleri için node.json veya rcm.json yazar.
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.jsonfbagent --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 hostsudo sh hqbird2027-fb50-linux-<version>.run --cluster-pairing on # other hosts
--rcm on — kümenin RCM’sinin çalışacağı tek ana makinede. Yükleyici:
bu ana makinenin kümesini oluşturur (fbagent --cluster-init), küme adı
ana makine adıdır;
RCM’yi kurar ve başlatır, RCM konsolu 7444 portunda HTTPS üzerinde çalışır;
rastgele parolalı ilk RCM yöneticisi rcmadmin oluşturur;
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-fb50sudo -u firebird ./fbagent --cluster-init <name> # RCM host; open ports 7443 and 7444 yourselfsudo -u firebird ./fbagent --cluster-pairing on # window for 24 hourssudo -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.
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.
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.
Birincil seçin (varsayılan ilk ana makine) ve Bağla düğmesine tıklayın.
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
Komut satırından aynısı:
Command
cd /opt/hqbirdrcm
exportRCM_USER=rcmadmin RCM_PASSWORD='<password>'./hqbirdrcm cluster link -hosts db1,db2,db3 -master db1
Bundan sonra ne olur:
RCM her boş ana makineye bir davet gönderir.
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.
RCM kümeyi kaydeder: birincilde <host>-master düğümü, diğer ana makinelerde <host>-replica,
port 7051, birincil → replika bağları.
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.
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:
küme CA’sını ve agent CA’sını oluşturur (fbagent klasöründe, clusterca/<name>/);
RCM klasörüne RCM sertifikasını, rcm.json ve cluster-init.json yazar;
RCM’yi kurar ve hqbirdrcm hizmetini kaydeder. Linux’ta hizmet ayrı
hqbirdrcm kullanıcısı olarak çalışır;
fbagent’ı RCM’ye geçirir (cluster.source = rcm) ve yeniden başlatır;
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
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
exportRCM_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.
Düğüm ana makinesinde bu komutu fbagent kullanıcısı olarak çalıştırın:
--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.
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:
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).
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:
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
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:
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.
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.
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
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:
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ı
Ü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
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>").
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.
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
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
exportRCM_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)
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
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.
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
Bir Yeni küme kimliği girin (küçük Latin harfleri, rakamlar ve -) ve
Oluştur düğmesine tıklayın.
Ü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.
Birincilden replikaya bağ ekleyin (Replikasyon bağları).
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
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.
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.
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.
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 autofbagent --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:
Agent’lar tablosunda fbagent satırında Üye ekle düğmesine tıklayın.
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.
Bağlar bölümünde birincilden replikaya Bağ ekle düğmesine tıklayın.
Doğrula düğmesine tıklayın: RCM hataları ve uyarıları gösterir.
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
exportRCM_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 apply409 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.
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.
Replika düğümü için yineleyin: onun eşi birincildir.
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.
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:
Bu örneğin her düğümünün node.json dosyasındaki firebird.password değerini düzeltin
(birincil ve replika).
fbagent yapılandırmasındaki parolayı düzeltin ve yeniden yükleyin (fbagent
belgelerine bakın).
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.
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
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ışı
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:
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:
veritabanının kendi listesi;
düğümün ortak sync_tables listesi;
veritabanı yayınındaki tablolar;
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.
Genel bakış → birincil düğüm kartı → Veritabanlarını kaydet.
Bir replika düğümünün bu sayfası yoktur.
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ı.
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).
Önizleme düğmesine tıklayın. Düğüm dahil etme maskesine uyan tüm dosyaları gösterir.
Hiçbir şeyi değiştirmez.
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.
Gerekli veritabanlarını işaretleyin ve Seçilenleri
kaydet düğmesine tıklayın. RCM onay ister ve dosya sayısını gösterir.
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ı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.
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
Düğüm kuralları node.json dosyasına yazar.
Düğüm klasörü tarar (scansync).
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.
Değişiklikten önce düğüm dosyanın bir kopyasını saklar:
replication_YYYYMMDD_hhmmss_NNN.conf.
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.
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ı
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:
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.
fbagent’tan Firebird’ü yeniden başlatmasını ister.
Firebird’ün kendi portunda yanıt vermesini bekler.
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.loglog_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).
Yanıtta taken_over, taşınacak veritabanlarını listeler. Gerekçesiyle atlanan
veritabanları görmek için -verbose ekleyin.
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.
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ı
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:
dosyaları düğümün dışlama listesine ekler;
klasörü bir kez tarar: veritabanı blokları replication.conf dosyasından çıkarılır;
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:
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.
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;
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:
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.
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:
tüm replikaların uyguladığı, retention_days değerinden eski segmentler;
daha yeni uygulanmış segmentler (alan kısaysa);
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.
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
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ı
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:
Birincil: veritabanlarını detect_existing ile kaydedin (bölüm 3.6).
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.
Satırları onaylayın. Düğüm blokları kendi replication.conf alanına taşır.
Taşınan blokları okuması için replikanın Firebird’ünü yeniden başlatın.
Yalnızcaneeds_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
Veritabanları sayfasını açın.
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.
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).
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ı
Her RCM komutu (ilklendirme, Firebird yeniden başlatması, yayın
eşitlemesi) sonucuyla birlikte Komutlar sayfasına kaydedilir.
„Komutlar“ sayfası
Komut satırından aynısı
Command
# one databasehqbirdrcm reinit -node node-a -db <db_id> -to node-b
# all master databaseshqbirdrcm 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.
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
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ı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).
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:
İ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ı
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
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
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
Veritabanları: birincil — replika çifti grupta Tamam, durum
IN_SYNC.
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.
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ı
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
Düğümün yaptığı (tek bir işlem):
Yayını açar. İşleten kendisi kapattıysa (6.4) açmaz.
Yayına henüz olmayan tüm anahtarlı tabloları ekler.
Yayından anahtarsız tabloları ve işletenin dışladığı tabloları çıkarır (6.3).
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
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 databasehqbirdrcm 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ı
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:
Tabloları işaretleyin.
Yayından çıkar veya Yayına geri al düğmesine tıklayın.
Düğüm listeyi kaydeder ve yayını hemen eşitler.
„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:
Tabloda bir birincil anahtar veya benzersiz dizin oluşturun.
Yayını eşitle düğmesine tıklayın.
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
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
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:
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
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
Firebird yeniden başladıktan sonra Etkinleştirildi alanı „evet: motor
düğümün dosyasını okuyor“ gösterir.
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 sayfası, seçilen veritabanları veya düğümün bütünü için
replication.conf içindeki anahtarları değiştirir.
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.
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
Nereye uygulanacağını seçin: Seçili veritabanlarına veya Düğümleri için
varsayılan olarak.
Önizleme — düğümler hiçbir şey değiştirmeden değerleri denetler.
Değişikliklerin önizlemesi
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.
Tüm replikaların uyguladığı ve retention_days değerinden eski segmentler.
Boş alan free_space_floor_gb değerinden azsa — saklama süresinden genç
uygulanmış segmentler. Uyarı disk_serious_cleanup.
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“
Arşivi elle temizleyin:
Command
hqbirdrcm cleanuparchive -node node-a # stages for all databases on the nodehqbirdrcm 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 -orphanedhiçbir zaman çalıştırmayın (bölüm 8.5).
Birim mebibayttır (MiB), ad „mbps“ dese de. Patlama hızdan
küçük olamaz.
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“
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ı
7.6. Uyarılar
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.
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.
Gönderimi duraklatma onayı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’ı).
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ı
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ı
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:
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 yapreclaim_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.
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)
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ı:
gfix -shut single -force 0 — veritabanına olan tüm bağlantılar kesilir;
nbackup -L, sonra -SEQUENCE olmadan nbackup -F;
<database>.delta dosyasını siler;
başlığı denetler: yeni GUID, REPLICATION_SEQUENCE = 0;
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»
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 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
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:
Ö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.
Uygulamaların eski birincilin veritabanına yazmasını durdurun.
Replika her şeyi alıp uygulayana kadar bekleyin: Veritabanları → IN_SYNC, kuyruk yok.
Denetleyin: veritabanı eşlikçinin birincil listesinde, yayın açık.
Uygulamaları yeni birincile geçirin.
Yeni veritabanının düzey 0 nbackup kopyasını yapın (8.4).
Verici satırı için hayalet kaydı temizleyin (8.5).
Replikayı yeni birincile bağlayın ve ilklendirin (bölüm 5).
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
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.
Bu site, deneyiminizi iyileştirmek ve tercihlerinizi hatırlamak için çerezler kullanır.