HQbird 2027 Linux üzerinde küme: RCM ile master ve replica
Diğer diller: Русский, Português.
Bu kılavuz iki temiz sunucudan çalışan bir Firebird 5.0 replikasına giden yolu anlatır.
Kurulum ve bir klasör dışında her şeyi tarayıcıda, RCM konsolunda yaparsınız. Ekran görüntüleri
2026-11-17 tarihli çalıştırmadan gelir: kit 2027.2.33, RCM ve düğümler 2027.5.12, Ubuntu 24.04,
İngilizce arayüz. Daha önceki 2026-11-08 çalıştırmasının raporu:
hqbird2027-rcm-cluster-check-report.ru.md
(Rusça, “Прогон 2” bölümü). Yalnızca komutlar, ekran görüntüsü olmadan:
hqbird2027-linux-cluster-runbook.md. Her RCM sayfası ayrıntılı olarak:
RCM kullanıcı kılavuzu (hqcluster-node deposu, docs/user-guide/).
Bu kılavuz 2027.2.24 ve sonraki kitler içindir. Kit 2027.2.22 için bu dosyanın git geçmişindeki 2026-11-07 tarihli sürümüne bakın.
İndirilecek kit 2027.2.33’tür (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM ve düğümler 2027.5.12, Firebird 5.0.5.1917. Bu kılavuz onunla 2026-11-17’de kontrol edildi (iki sunucu, Ubuntu 24.04, 3 MB ve 167 MB’lık veritabanları): tüm adımlar geçti. Metin, o çalıştırmanın sonuçlarını “2026-11-17 çalıştırması” olarak adlandırır. Ekran görüntüleri aynı gün aynı kitle yapılan ikinci bir geçişten gelir (3 MB ve 2.88 GB’lık veritabanları). Diğer sayılar hâlâ 2026-11-08 çalıştırmasından gelir. 2027.2.27 sonrası kitlerin bir küme için değiştirdikleri:
| Kit | Değişiklik |
|---|---|
| 2027.2.29 (agent 3.1.0, RCM 2027.5.9) | Varsayılan olarak küme yok (aşağıya bakın). Bir ana makinenin birkaç agent’ı bir kümeye katılabilir: her birinin kendi eşleştirme portu (7450–7459) ve düğüm portu vardır. fbagent --cluster-leave. HQ Monitor’ün Clusters sayfası |
| 2027.2.30 (RCM 2027.5.10) | Bir hizmetin switchover ve failover’ı, yönlendiriciler |
| 2027.2.31 (agent 3.3.0, RCM 2027.5.11) | Yükleyici bir terminalde metin arayüzü açar (adım 1). RCM’nin Services sayfaları. Hiçbir HQCenter’a bağlı olmayan bir sunucu agent’ı, HQ Monitor’ü ve fbmcp’yi kendisi günceller |
| 2027.2.33 (agent 3.4.0, RCM 2027.5.12) | RCM uyarılarını Telegram’a, bir webhook’a veya e-postaya gönderir (“What to watch next”). İki Docker konteynerinden oluşan bir küme: Docker kılavuzu |
Tüm değişiklikler: What’s New.
Agent (fbagent) 3.1.0 ve sonrası olan kitler (2027.2.29’dan itibaren) varsayılan olarak küme oluşturmaz: RCM yok, eşleştirme penceresi yok ve küme portları güvenlik duvarında kapalı kalır. Adım 1’de master’da RCM’yi ve replikada keşif modunu açarsınız.
Süre: ≈30 dakika artı veritabanlarının kopyalanması (1 Gbit/s ağda 3 GB başına ≈1 dakika).
Ne elde edersiniz
| Sunucu 1 | Sunucu 2 | |
|---|---|---|
| Rol | master + RCM konsolu | replika |
| Veritabanları | /databases/master/*.fdb |
/databases/replica/<replica node>/<master node>/*.fdb |
| Hizmetler | firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 |
aynıları, ancak hqclusternode-replica-p3050 ve hqbirdrcm yok (daha eski bir kit kendi RCM’sini orada bırakır, durdurulmuş) |
Neye ihtiyacınız var
- İki Linux x86-64 sunucu (Ubuntu 24.04’te kontrol edildi), 2 çekirdek, 4 GB bellek.
- Disk alanı. Master: boş alan ≥ veritabanı boyutunun %105’i (
.deltadosyası kilit sırasında büyür). Replika: boş alan ≥ veritabanı boyutunun %105’i artı tabanlimits.free_space_floor_gb(varsayılan 1 GB). Mevcut bir replika üzerinde yeniden başlatma eski dosyayı sonuna kadar tutar, bu yüzden replika biriminin yaklaşık 2 × veritabanı boyutuna ihtiyacı vardır. Remove the old replica if space is short kutusuyla (adım 8), %105 artı taban yeterlidir. - Sunucular arası ağ: 3050, 7051, 7443, 7444, 7450 portları. Bunlar bir sunucunun ilk örneğinin (slot 0) portlarıdır. Bir sunucunun ikinci örneği 7451 eşleştirme portunu ve 7052 düğüm portunu kullanır.
- Bilgisayarınız master’ın 7444 portuna (RCM konsolu) doğrudan veya bir SSH tüneli üzerinden erişebilmelidir.
sudoyetkisi olan bir kullanıcı.
Güvenlik duvarı. Yükleyici, etkin bir firewalld veya ufw’de (herhangi bir sistem diliyle) portları açar: 3050 ve 23050 her zaman, küme portları yalnızca adım 1’in seçenekleri için. Master: 7443, 7444, 7051. Replika: 7450, 7051. Agent, eşleştirme penceresi sona erdiğinde veya ana makine bağlandığında 7450’yi tekrar kapatır. Ubuntu’da ufw genellikle devre dışıdır. O zaman yükleyici bir satır yazar, örneğin master’da:
no active firewall (firewalld or ufw): ports 3050, 23050, 7443, 7444, 7051/tcp are not opened by this install; they are reachable from every network; close them or enable a firewall. Bir bulutta, portları bulut güvenlik duvarıyla kapatın: dışarıdan yalnızca sizin adresiniz; sunucular arasında iç ağ.
Aşağıda çalıştırmanın adresleri verilmiştir: master 10.114.0.5, replika
10.114.0.6 (özel ağ). Kendi adreslerinizi kullanın.
Adım 1. Her iki sunucuya kurulum
Her sunucuda:
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.runBir terminalde yükleyici metin arayüzünü açar (2027.2.31’den itibaren kitler). İlk sayfada
Cluster RCM off, discovery mode off satırı bulunur. Cluster‘ı açın ve bir satırı değiştirin:
| Cluster sayfasının satırı | Master | Replika |
|---|---|---|
| Cluster manager (RCM) | on |
off |
| Discovery mode (24 h) | off (bu agent RCM’yi çalıştırır) |
on |
Cluster id (varsayılan: ana makine adı), RCM admin password
(varsayılan: oluşturulmuş) ve Pairing port (varsayılan: ilk boş olan,
7450) satırları olduğu gibi kalabilir. Geri dönün (Esc) ve Install‘ı seçin.
Yükleyici planı gösterir: Enter’a basın. Ardından Nothing on this host was changed yet. Start the install now? diye sorar. İmleç No üzerindedir: Yes’e
taşıyın ve Enter’a basın. Yükleyici eksik kütüphaneleri (örneğin
libtommath1) kendisi ekler. Metin arayüzünün tamamı:
hqbird2027-linux-setup-guide.md.
--no-tui ile ve 2027.2.29–2027.2.30 kitlerinde yükleyici
sorular sorar. İlki Install as planned? Yes/No: y yanıtlayın. Ardından
iki küme sorusu sorar. Yanıt varsayılan olarak No’dur (Enter):
| Soru | Master | Replika |
|---|---|---|
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] |
y |
Enter (No) |
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] |
sorulmaz: bu agent RCM’yi çalıştırır | y |
Ya da yanıtları seçenek olarak verin: bir terminalde bunlar Cluster sayfası açılmadan önce
değerlerini ayarlar. Terminal olmadan bir çalıştırma için de bunları kullanın:
--yes tek başına her ikisi için No anlamına gelir.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # replicaKurulum yaklaşık bir dakika sürer (2026-11-17 çalıştırması: master’da 61 saniye,
replikada 43 saniye). Kit 2027.2.33 ile master’daki çıktının sonu (hash burada kısaltılmıştır; aşağıdaki
örneklerin küme kimliği hq27d-m‘dir, 2026-11-08 çalıştırmasından):
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM: https://10.114.0.5:7444 (cluster hq27d-m)
CA hash: sha256:9754e0be…087cb195
Login: rcmadmin
Password: in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/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
fbmcp: 2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)Replikada:
RCM: off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing: port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this hostDaha eski bir kit master’da Pairing: not opened (this agent runs the RCM) yazar.
Master’ın RCM: ve CA hash: satırlarını ve replikanın
Pairing: satırını not edin. fingerprint‘e adım 3’te ihtiyacınız olacak.
Daha eski kitler (3.1.0 öncesi agent, örneğin kit 2027.2.27) hiçbir küme sorusu sormaz. Her sunucuya RCM kurar ve eşleştirme penceresini her yerde açar. Master‘ın RCM’sini kullanın; ikinci sunucunun RCM’si bağlantıdan sonra kendiliğinden durur.
Daha sonra, yükleyici olmadan. Sunucunun HQ Monitor’ünde Clusters‘ı, Cluster on this server bölümünü açın. Master’da: Enable the cluster console (RCM); HQ Monitor güvenlik duvarında 7443 ve 7444’ü açar. Replikada: Open the pairing window for 24 hours. Komutlarla da aynısı, agent’ın kullanıcısı olarak:
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on # replicaEşleştirme penceresi açıkken agent, eşleştirme portunu güvenlik duvarında açar. Pencere sona erdiğinde veya ana makine bağlandığında portu kapatır.
Çıktıda parola yoktur. RCM parolası Password: satırındaki dosyadadır, SYSDBA parolası
/root/fbagent-install-sysdba.txt dosyasındadır ve HQ Monitor parolası
/opt/hqbird/conf/access.properties dosyasındadır.
Lisans kurmanıza gerek yoktur: yeni bir agent 7 günlük deneme süresini kendisi başlatır ve küme düğümleri çalışır.
Adım 2. RCM’ye giriş yapın
Master’ın RCM: satırındaki adresi açın. 7444 portu
bilgisayarınız için kapalıysa bir SSH tüneli ve https://localhost:7444 kullanın:
ssh -L 7444:127.0.0.1:7444 <user>@<master>7444 portu bilgisayarınızda meşgulse başka bir yerel port kullanın, örneğin
-L 17444:127.0.0.1:7444 ve https://localhost:17444.
Tarayıcı sertifika konusunda uyarır: RCM sertifikasını küme CA’sı imzalamıştır. Giriş
sayfası Cluster CA hash‘i gösterir: bunu yükleyici çıktısındaki CA hash: satırıyla karşılaştırın. Eşleşiyorlarsa CA
sertifikasını (aynı sayfadaki Download the CA certificate (hqcluster-ca.crt) bağlantısı)
güvenilir olarak yükleyin veya uyarıyı kabul edin. Eşleşmiyorlarsa
giriş yapmayın ve adresi kontrol edin.
Kullanıcı adı rcmadmin‘dir. Parola Password:
satırındaki dosyadadır:
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM hemen yeni bir parola ister (en az 12 karakter):
2027.5.12 öncesi bir RCM bu sayfayı tekrar tekrar yükleyebiliyordu. RCM 2027.5.12 (kit 2027.2.33) düzeltmeye sahiptir.
Parola değişikliğinden sonra master’ın agent’ı
rcm-initial-password dosyasını bir dakika içinde kendisi siler. Daha eski bir kitle, ikinci sunucunun da kendi RCM’si vardır. Bağlantıdan sonra agent
o önceki kümeyi cluster/left/ klasörüne taşır. Agent 3.1.0
orada kendi rcm-initial-password dosyasını siler; daha eski bir agent silmez. O zaman dosyayı
kendiniz silin:
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>/opt/hqbirdrcm/initial-admin.json dosyasını silmeyin: yalnızca eski parolanın hash’ini tutar ve o olmadan kullanıcı dosyasını kaybetmiş bir RCM varsayılan parolayla başlar.
Parola değişikliğinden sonra RCM hemen Settings → Link hosts‘u açar: kümenin henüz düğümü yoktur. Releases in the mirror listesi,
agent’ların düğümleri kurduğu hqbirdrcm ve hqclusternode sürümlerini gösterir.
Adım 3. Ana makineleri bağlayın
Listenin ilk satırı zaten doldurulmuştur (RCM ana makinesi). İkinci bir satır ekleyin: master’ın erişebildiği replika adresi. Sunucuların ortak bir DNS’i yoksa bir IP girin: RCM dizeyi olduğu gibi saklar ve düğümler birbirini bu dizeyle bulur.
Check hosts düğmesine tıklayın. Bağlantı noktası olmayan bir ana makine
için RCM, eşleştirme bağlantı noktalarını 7450–7459 aralığında okur ve
yanıt veren her aracı için host:port biçiminde bir satır gösterir (burada
10.114.0.6:7450). Yalnızca tek bir bağlantı noktasını okumak için
host:port yazın. RCM ana makinesinin bir eşleştirme penceresine ihtiyacı
yoktur: RCM aracısını kendi kayıt defterinde bulur. Certificate
fingerprint değerini yükleyici çıktısıyla (replikanın Pairing: satırı)
karşılaştırın: eşleşmelidir. İkinci ana makinenin durumu Ready to link
şeklindedir.
Member ID sütunu, ana makinenin kümede aldığı adı gösterir:
<host name>-<role>, örneğin hq27d-m-master. Örnek son eki (-fb50)
yalnızca ana makinede birden fazla aracı olduğunda eklenir.
Her satırda bir onay kutusu, bağlantı noktası, örnek ve düğüm bağlantı
noktası bulunur. Link yalnızca işaretli satırları alır. Hata durumundaki
bir satır işaretlenemez ve diğerlerini durdurmaz. Tablonun altında RCM
2027.5.12, 10.114.0.6, no agent: closed or no answer: 7451-7459 gibi
satırlar yazar: bunlar, başka hiçbir aracının yanıt vermediği ana makinenin
eşleştirme bağlantı noktalarını adlandırır. Bunlar hata değildir.
master, üretim veritabanlarının bulunacağı ana makinedir. Link düğmesine tıklayın ve onaylayın:
İlerleme: “Joining → Joined → The node starts → Running”. Çalıştırmada bağlama 56 saniye sürdü (2026-11-17 tarihli çalıştırma: 47 saniye).
Overview artık iki düğüm gösterir: master ve replika. Bağlamadan hemen sonra replika bir dakika boyunca “stale” olabilir; ardından “online” olur.
Zaten bağlı olan bir ana makine için yeniden Check hosts düğmesine tıklarsanız, eşleştirme bağlantı noktalarında hiçbir aracının yanıt vermediğini veya ana makineye ulaşılamadığını gösterir: o ana makinedeki eşleştirme penceresi ve güvenlik duvarındaki eşleştirme bağlantı noktası kapalıdır. Bu bir hata değildir.
Master’ı olan bir kümeye tek ana makine. Tek satırlık bir bağlama
lone_master ile reddedilir: satırın ne olacağını belirtin. O master’ın bir
replikası için -replica-of <master member> veya kendine ait bir master
için -new-master (Link hosts sayfasındaki onay kutusu) ekleyin.
Adım 4. Master’da veritabanı klasörü
master üzerinde veritabanı, firebird kullanıcısının erişebildiği bir
klasörde olmalıdır:
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdbReplika üzerinde hiçbir şey hazırlamanız gerekmez: Initialize iletişim kutusundaki Create folder düğmesi kopyalar için klasörü oluşturur (adım 6).
Adım 5. Veritabanlarını master’da kaydedin
Databases → Nodes tablosunda, master’ın satırında → Enroll.
- Folder path on that server:
/databases/master, recursive. - Include file mask:
*.fdb. - Sync tracking tables: Verify düğmesinin satır sayılarını karşılaştırdığı tablolar. Listeyi kaydettiğiniz her veritabanı için ayrı ayrı ayarlarsınız. Alanı boş bırakın: o zaman veritabanı kendi yayın tablolarını sayar. Zaten yönetilen bir veritabanı için listeyi master veritabanının sayfasında değiştirin.
Preview → veritabanlarını seçin → Enroll selected ve onaylayın.
Sonuç “Enrolled: 2.” ve bir ipucudur: master’ın Firebird’ü yeniden başlatılmalıdır. Altındaki “No new databases matched.” metni bir hata değildir: veritabanları zaten kaydedilmiştir.
Veritabanları yeniden başlatmayı bekler:
Master’ın herhangi bir veritabanının satırında Restart Firebird of the master düğmesine tıklayın (hepsi için tek bir yeniden başlatma yeterlidir) ve onaylayın. Master’ın Firebird’üne olan tüm bağlantılar birkaç saniye kopar (çalıştırmada 4 saniye): uygun bir zaman seçin.
Yeniden başlatmadan sonra master düğümü CONFIGURED olur. Her veritabanında
publication OFF rozeti bulunur ve replika “not paired” gösterir.
Adım 6. Replikayı başlatın
Veritabanı satırında, replika sütununda → Initialize. İletişim kutusunun başlığı “Initialize database?” şeklindedir.
- Publication. Veritabanının yayını kapalıyken Firebird değişiklikleri
günlüğe yazmaz ve replika hiçbir şey almaz. İletişim kutusu bunu söyler ve
bir Sync publication and initialize düğmesi gösterir. Buna tıklayın:
RCM, birincil veya benzersiz anahtarı olan tüm tabloları yayına ekler ve
başlatmayı hemen başlatır. Yayın kapalıyken Initialize düğmesi işe
yaramaz: master düğümü reddeder (
publication_off). - Replica folder: iletişim kutusu
/databases/replica/<replica node>önerir, çalıştırmada/databases/replica/hq27d-r-replica. Bir ana makinenin her replika düğümünün kendi klasörüne ihtiyacı vardır. Bunu koruyun. Alan “✗ The folder does not exist” gösteriyorsa Create folder düğmesine tıklayın; ardından “✓ The folder was created.” görürsünüz. Kopya/databases/replica/hq27d-r-replica/hq27d-m-master/konumuna gider. Sonraki veritabanları için klasör zaten ayarlanmıştır ve iletişim kutusu bunu değiştirmez. - Method: Smooth (varsayılan). Kilitten önce yazma işlemlerini kontrol eder. Standard veritabanını hemen kilitler.
- Yeni bir replika için “Let … stop its Firebird for this reinit” ve “Remove the old replica if space is short” kutularına ihtiyacınız yoktur.
İlk yayın eşitlemesinden sonra uygulamaları yeniden bağlayın. Yayın açılmadan önce açılmış olan master veritabanına bir bağlantı, yeniden bağlanana kadar günlüğe yazılmaz. 2026-11-17 tarihli çalıştırmada, Sync publication and initialize öncesinde açılmış bir bağlantı kopyadan sonra yaklaşık 9.500 satır yazdı ve replika bunların hiçbirini almadı. RCM her iki taraf için de “Ok” gösterdi; yalnızca Verify (adım 9) “Not ok (desynced)” gösterdi. Yeni bir bağlantının satırları hemen replike edildi. Bu nedenle, bir veritabanının ilk Sync publication işleminden sonra: uygulamaları yeniden bağlayın (veya master’ın Firebird’ünü yeniden başlatın), ardından yazma olmadan Verify çalıştırın. Replika satırları kaçırıyorsa bir yeniden başlatma çalıştırın (adım 7).
Yük altında ilk başlatma. Master’ın arşivinde henüz bir günlük segmenti
yokken, veritabanına yazılıyorsa Smooth reddedebilir. Veritabanı satırı
long_transactions: … the archive holds no segment yet ve arayüz dilinde
bir ipucu gösterir:
Çalıştırmada bu, Sync publication and initialize sonrasında da meydana geldi (rapordaki G-04 bulgusu). Bu noktada yayın zaten açıktır. Master veritabanı “archive: 1 seg” veya daha fazlasını gösterene kadar bekleyin (çalıştırmada 15 saniye) ve Smooth yöntemiyle yeniden Initialize düğmesine tıklayın. Veya Standard seçin. 2026-11-17 tarihli çalıştırmada (tek bir bağlantıdan ≈49 işlem/s), Smooth reddedilmedi.
İlerleme veritabanı satırında gösterilir: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. İlerleme, sayfa yeniden yüklendikten sonra da görünür. Bu süre boyunca Initialize düğmesi etkin değildir.
Kopyadan sonra replika düğümü, replikanın Firebird’ünü planlanan dakikada kendisi yeniden başlatır. Satır bunun ne zaman olacağını söyler; Restart Firebird of the replica düğmesi bunu hemen yapar. Bu anda replikanın Firebird’üne olan tüm bağlantılar kopar.
Büyük bir veritabanı da aynı şekilde çalışır. Çalıştırmada bulk.fdb
(3.13 GB), üzerinde yük olmadan Sync publication and initialize
düğmesiyle başlatıldı:
Master ve replika “Ok” gösterdiğinde ve replikanın “last applied seg”
değeri master’ın “last seg” değerine ulaştığında tamamlanır. Yeni yazma
olmayan bir veritabanı (burada bulk.fdb) replika için segment 0 ile
“Pending” gösterir: bu normaldir.
Çalıştırmanın ölçümleri (employee.fdb, ≈55 işlem/s yük altında):
| Veritabanı | Boyut | Master: başlangıçtan bitişe | Master’daki kilit | Çift “Ok” |
|---|---|---|---|---|
employee.fdb |
4 MB | 0.7 s | 0.35 s | ≈1 dk sonra (replika yeniden başlatmasını bekledi) |
bulk.fdb |
3.13 GB | 64 s (≈55 MB/s) | 59 s | ≈2 dk sonra |
2026-11-17 tarihli çalıştırma (kit 2027.2.33): employee.fdb (3 MB) 3 saniye sürdü
master üzerinde bulk.fdb (167 MB) 15 saniye. Replika tarafı başlangıçtan ≈40 saniye sonra eşleştirildi (replika Firebird’ünün yeniden başlatılmasını bekledi).
Kilit sırasında master veritabanı çalışır: değişiklikler .delta dosyasına gider.
Daha sonra yayınlama. Veritabanında yeni tablolar göründüğünde master veritabanının Sync publication düğmesine ihtiyacınız vardır. Yayını tek bir işlemde tablolarla eşleştirir; Firebird yeniden başlatılmaz.
Publication tables hangi tabloların çoğaltıldığını gösterir. Anahtarı olmayan bir tabloyu yayınlayamazsınız: ona bir birincil anahtar verin.
Adım 7. Yeniden başlatma
Replika master’dan farklı olduğunda veya düğüm bunu istediğinde (NEEDS_REINIT) buna ihtiyacınız vardır. Replika satırında → Reinit, yöntem Smooth. Zaten bir segment arşivi vardır ve smooth yöntemi yük altında çalışır. Günlük geçmişinden daha eski olan yazma işlemlerini bekler ve onları gösterir.
İlerleme, başlatmadakiyle aynıdır. Bir reinit genellikle replika Firebird’ünün yeniden başlatılmasını gerektirmez. 2026-11-17 çalışmasında employee.fdb reinit’i replika Firebird’ünü yeniden başlattı: replikaya olan bağlantılarda bir kesinti olacağını hesaba katın. Bu reinit master üzerinde ≈49 işlem/s altında 4 saniye sürdü; yazmalar durduktan sonra satır sayıları eşleşti (yük tablosunda her iki tarafta da 14.418 satır).
Çalışmanın ölçümleri:
| Veritabanı | Yük | Süre | Kilit | Diğer |
|---|---|---|---|---|
employee.fdb |
≈55 işlem/s | 1,7 sn | 0,32 sn | segmentlerden 417 işlem yeniden oynatıldı |
bulk.fdb |
yok | 61 sn | 55 sn | replika Firebird’ünün yeniden başlatılması yok |
Yük altında bir smooth reinit’ten sonra replika info uyarısını gösterebilir: replication_conflict_resolved (“Eklenen kayıt … zaten var, bunun yerine güncelleniyor”): replika kopyada zaten bulunan işlemleri yeniden oynattı. Veriler eşleşir: çalışmada tüm tabloların satır sayıları eşleşti. Uyarıyı onaylayabilirsiniz (raporda G-07 bulgusu).
Adım 8. Replikada düşük disk alanı
Replika biriminde veritabanı boyutunun ≥ %105’i artı eski kopyanın üzerinde 1 GB boş alan gerekir: eski kopya sona kadar kalır ve yeni dosya tam boyutunu bir anda alır. Alan yetersizse iletişim kutusu ne kadar alan gerektiğini, ne kadarının boş olduğunu ve eski kopyanın ne kadar yer kapladığını gösterir (bir RCM tahmini; karar replika düğümüne aittir). Alan eski kopya olmadan yeterliyse iletişim kutusu Remove the old replica if space is short kutusunu önerir.
Kutu ile replika düğümü, master üzerindeki kilitten sonra replika Firebird’ünü durdurur, eski kopyayı siler ve Firebird’ü yeniden başlatır. Çalışmada (2,97 GB boş, yeni kopya 3,29 GB gerektiriyor, eski kopya 3,13 GB), kutu ile bulk.fdb reinit’i 65 saniye sürdü. Kutu olmadan düğüm insufficient disk space on replica ile reddeder.
İletişim kutusu, yalnızca 1 GB’lık taban eksik olduğunda hiçbir sayı göstermeyebilir. 2026-11-17 çalışmasında (1,1 GB boş, veritabanı 167 MB) iletişim kutusu hiçbir tahmin göstermedi ve kutu olmadan reinit 3 saniyede başarısız oldu. Veritabanı satırı ve Commands sayfası nedeni gösterdi: insufficient disk space on replica: need 184125850 bytes (105% of the database) + 1073741824 bytes free_space_floor_gb; free 1152950272 … Removing the old replica copy would free 175357952 bytes: ask again with remove_old_replica. Kutu ile aynı reinit 9 saniye sürdü.
Kutunun riski. Kopya çalışırken bu veritabanının replikası yoktur. Reinit başarısız olursa çift
NEEDS_REINITolur, replikadareplica_removed_for_reinituyarısı (warn) bulunur ve yeniden deneme yeni bir tam reinit’tir. Otomatik bir reinit eski kopyayı yalnızca RCM anahtarıauto_reinit.remove_old_replica_when_shortaçıksa siler (varsayılan olarak kapalı).
Adım 9. Doğrulama
Replika satırındaki Verify, izleme tablolarının COUNT(*) değerini master üzerinde ve replika üzerinde karşılaştırır. Satırların kendisini karşılaştırmaz. “Table list source” satırı listeyi adlandırır: veritabanının kendi listesi, düğümün listesi, yayın tabloları veya RDB$FIELDS. Satır sayılarında rakam grupları vardır.
Yük altında replika birkaç saniye geridedir ve Verify, yazılmakta olan tablolar için “Not ok” verir:
Yazma olmadan sayılar eşleşir:
Her iki veritabanında da olmayan bir tablo “not in the database” olur: bu bir uyuşmazlık değildir. Yalnızca bir tarafta olan bir tablo “no table” olur: bu bir uyuşmazlıktır.
Daha güvenli bir kontrol, yazmalar durduktan sonra her iki taraftaki tüm tabloların satır sayısıdır (betik hqbird2027-linux-cluster-runbook.md içindedir). Çalışmada 11 tablonun tamamı eşleşti (employee.fdb: 10, bulk.fdb: 1, 2.800.000 satırla).
Periyodik kontrol (Data check) varsayılan olarak kapalıdır. Turn on for all nodes düğmesine tıklayın ve onaylayın: her düğüm kendi satırlarını sayar ve master sayıları karşılaştırır. Yeniden başlatmaya gerek yoktur: RCM “Saved and in force now: the node needs no restart.” gösterir. İlk kontrol bir aralık sonra çalışır (varsayılan olarak 2 saat).
Bundan sonra nelere dikkat etmeli
-
Overview: düğümler, durumları, veritabanı kökü ve disk alanı.
Overview -
Alerts: düğümlerin ve veritabanlarının sorunları. Çalışmada iki uyarı vardı ve ikisini de onaylayabilirsiniz: smooth reinit’ten sonra
replication_conflict_resolved(adım 7) ve master üzerindeparse_no_observations(“no events parsed from /opt/firebird/replication.log”). Master’ın Firebird’üreplication.logdosyasına yalnızca hataları yazar, bu yüzden boş bir günlük normaldir (raporda G-06 bulgusu).
Alerts RCM 2027.5.12 ve sonrası (kit 2027.2.33)
warnve daha yüksek önem dereceli uyarıları kendi Telegram botunuza, bir webhook’a veya e-postaya gönderebilir. Kanalları/opt/hqbirdrcm/rcm.jsondosyasında,notify.channelsanahtarında ayarlarsınız ve RCM’i yeniden başlatırsınız (sudo systemctl restart hqbirdrcm). Bu sayfanın Notification channels bloğu ardından kanalları listeler, her biri bir Send test düğmesiyle. Kanal yoksa “No channel is configured: RCM sends its alerts nowhere.” yazar. Bir Telegram kanalı:"notify": { "channels": [ { "name": "ops", "type": "telegram", "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }2026-11-17 çalışması bloğu kanal olmadan kontrol etti; hiçbir mesaj gönderilmedi.
-
Services (RCM 2027.5.11 ve sonrası, 2027.2.31’den itibaren kitler): bir servisin master’ı, replikaları ve yönlendiricileri ile switchover, failover ve rejoin işlemleri. Bu kılavuz bunları kapsamaz: RCM kullanıcı kılavuzuna bakın. Kullanmadan önce RCM’i ve düğümleri aynı sürüme güncelleyin.
-
Commands: sonucuyla birlikte her RCM işlemi. Saat, tarayıcının yerel saati ve dilimidir (örneğin,
17:59:45 UTC+1); ipucu saati UTC olarak gösterir. Düğüm günlükleri UTC kullanır.
Commands -
HQ Monitor:
http://<server>:23050/, kullanıcı adıadmin, parola/opt/hqbird/conf/access.propertiesiçindedir. Sunucuyu ve veritabanlarını gösterir. Agent 3.1.0 ve sonrasını içeren kitlerde HQ Monitor’ün Clusters sayfası vardır. Master üzerinde (RCM ana makinesi) kümeyi agent aracılığıyla gösterir, HQ Monitor’de hiçbir RCM ayarı olmadan. Replika üzerinde RCM’in ana makinesini adlandırır ve konsoluna bağlantı verir. HQ Monitor 1.49.0’da çoğaltma durumu ve RCM’e bağlantı yoktur. Kit 2027.2.33’ten (agent 3.4.0) itibaren agent, sunucusunun sorunlarını kanallarınıza da gönderir: Servers → Notifications.
Kümeyi güncelleme
Önce HQbird RCM’i, sonra düğümleri güncelleyin. Kit 2027.2.31’den itibaren hiçbir HQCenter’a bağlı olmayan bir sunucu agent’ı, HQ Monitor’ü ve fbmcp’yi kendisi günceller (hqbird2027-linux-setup-guide.md içinde “Updates without HQCenter”); bir HQCenter’a bağlı sunucu güncellemelerini o HQCenter’dan alır.
Bir ana makineyi kümeden çıkarma
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leaveAgent durur ve düğüm servislerinin kaydını siler, düğüm bağlantı noktalarını kapatır, küme sertifikalarını siler ve cluster.source değerini none olarak ayarlar. Düğüm klasörü kalır (--remove-data onu siler). RCM’i çalıştıran agent reddedilir. Agent, RCM onu iptal ettiğinde veya son üyesini aldığında da kendiliğinden ayrılır. Bir kaldırma her zaman kümeden ayrılır: aynı klasörde yeniden kurulum boş başlar. 2026-11-17 çalışmasında komut Cluster: left <cluster id> yazdırdı, replika veritabanları klasörlerinde kaldı ve RCM bir dakika sonra hâlâ o ana makinenin düğümünü gösteriyordu. Bir küme sunucusundan, RCM’i çalıştıran sunucudan da HQbird’in kaldırılması: hqbird2027-removal-guide.md, bölüm 4.
Yaygın hatalar
| Gördüğünüz | Neden | Ne yapmalı |
|---|---|---|
Başlatmada publication_off |
yayın kapalı veya veritabanında anahtarlı tablolar olmasına rağmen hiç tablosu yok | Sync publication and initialize düğmesi (adım 6) |
long_transactions … the archive holds no segment yet |
veritabanına yazılırken smooth yöntemiyle ilk başlatma ve master’ın arşivi boş | “archive: 1 seg” bekleyin ve Smooth ile yeniden deneyin veya Standard seçin |
reinit_pre_publication_transactions |
yayın açılmadan önce başlamış ve bir dakikadan uzun süredir açık olan bir yazma işlemi | bitirin (COMMIT veya ROLLBACK) ve yeniden deneyin |
| İletişim kutusunda “✗ The folder does not exist on …” | replika klasörünü kimse oluşturmadı | İletişim kutusundaki Create folder düğmesi veya replika üzerinde install -d -o firebird -g firebird -m 0770 <folder> |
| Verify içinde “Not ok (desynced)” | veritabanına yazılıyor ve replika saniyelerce geride | yük olmadan yeniden deneyin; Match sütununa bakın |
| Yazma olmadan Verify içinde “Not ok (desynced)”; her iki taraf da “Ok” gösteriyor | yayın açılmadan önce açılmış bir uygulama bağlantısı: günlüğe kaydedilmiyor | uygulamayı yeniden bağlayın, ardından Reinit (adım 6, ilk yayın eşitlemesiyle ilgili not) |
| Link hosts içinde ana makine “ulaşılamaz” veya “aracı yok” | ana makinenin eşleştirme penceresi kapalı (varsayılan olarak kapalı veya 24 saat sona erdi) ya da sunucular arasındaki güvenlik duvarı 7450–7459 aralığını kapatıyor | ana makinede pencereyi açın: HQ Monitor → Clusters → Open the pairing window for 24 hours veya fbagent --cluster-pairing on; bulut güvenlik duvarında bağlantı noktasını açın |
| Yeniden başlatma sırasında insufficient disk space on replica | eski replika sona kadar kalır ve yeni dosya tam boyutunu alır | replika biriminde eski dosyanın üzerine veritabanı boyutunun ≥ %105’i + 1 GB boş alan bırakın veya Remove the old replica if space is short kutusunu işaretleyin (8. adım) |
| Link hosts sonrasında düğüm görünmüyor | RCM yansısında imzalı bir hqclusternode sürümü yok | Link hosts sayfasındaki Releases in the mirror (2. adım) |