Bu sayfa makine çevirisidir. İngilizce orijinalini okuyun. English

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 (.delta dosyası kilit sırasında büyür). Replika: boş alan ≥ veritabanı boyutunun %105’i artı taban limits.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.
  • sudo yetkisi 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:

Command
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.run

Bir 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.

Command
sudo sh hqbird2027-fb50-linux-$V.run --rcm on               # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on   # replica

Kurulum 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):

text
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:

text
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 host

Daha 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:

Command
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       # replica

Eş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:

Command
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.

RCM sign-in
RCM sign-in

Kullanıcı adı rcmadmin‘dir. Parola Password: satırındaki dosyadadır:

Command
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password

RCM hemen yeni bir parola ister (en az 12 karakter):

New password at the first sign-in
New password at the first sign-in

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:

Command
# 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.

Oturum açtıktan sonra ana makineleri bağlayın
Oturum açtıktan sonra ana makineleri bağlayın

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.

Ana makinelerin listesi
Ana makinelerin listesi

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.

Ana makinelerin kontrolü
Ana makinelerin kontrolü

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:

Onay
Onay

İ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).

Bağlama ilerlemesi
Bağlama ilerlemesi
Tamamlandı
Tamamlandı

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.

Overview: iki düğüm
Overview: iki düğüm

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:

Command
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.fdb

Replika ü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.
Kayıt formu
Kayıt formu

Preview → veritabanlarını seçin → Enroll selected ve onaylayın.

Kaydın onayı
Kaydın onayı

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.

Kaydın sonucu
Kaydın sonucu

Veritabanları yeniden başlatmayı bekler:

Yeniden başlatmayı bekler
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.

Master'ın Firebird'ünün yeniden başlatılması
Master'ın Firebird'ünün yeniden başlatılması

Yeniden başlatmadan sonra master düğümü CONFIGURED olur. Her veritabanında publication OFF rozeti bulunur ve replika “not paired” gösterir.

Yeniden başlatmadan sonra
Yeniden başlatmadan sonra

Adım 6. Replikayı başlatın

Veritabanı satırında, replika sütununda → Initialize. İletişim kutusunun başlığı “Initialize database?” şeklindedir.

Initialize iletişim kutusu
Initialize iletişim kutusu
  • 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:

Smooth yönteminin reddi
Smooth yönteminin reddi

Ç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.

Başlatma ilerlemesi
Başlatma ilerlemesi

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.

Replikanın Firebird'ünün yeniden başlatılmasını bekler
Replikanın Firebird'ünün yeniden başlatılmasını bekler

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ı:

Büyük veritabanının kopyası
Büyük veritabanının kopyası

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.

Her iki veritabanı da hazır
Her iki veritabanı da hazır

Ç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.

Sync publication
Sync publication

Publication tables hangi tabloların çoğaltıldığını gösterir. Anahtarı olmayan bir tabloyu yayınlayamazsınız: ona bir birincil anahtar verin.

Publication tables
Publication tables

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.

Reinit, smooth method
Reinit, smooth method

İ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).

Copy at the reinit
Copy at the reinit

Ç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.

Low space: the “Remove the old replica if space is short” box
Low space: the “Remove the old replica if space is short” box

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_REINIT olur, replikada replica_removed_for_reinit uyarı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_short açı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:

Verify under load
Verify under load

Yazma olmadan sayılar eşleşir:

Verify without load
Verify without load

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).

Periodic check
Periodic check

Bundan sonra nelere dikkat etmeli

  • Overview: düğümler, durumları, veritabanı kökü ve disk alanı.

    Overview
    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 üzerinde parse_no_observations (“no events parsed from /opt/firebird/replication.log”). Master’ın Firebird’ü replication.log dosyasına yalnızca hataları yazar, bu yüzden boş bir günlük normaldir (raporda G-06 bulgusu).

    Alerts
    Alerts

    RCM 2027.5.12 ve sonrası (kit 2027.2.33) warn ve daha yüksek önem dereceli uyarıları kendi Telegram botunuza, bir webhook’a veya e-postaya gönderebilir. Kanalları /opt/hqbirdrcm/rcm.json dosyasında, notify.channels anahtarı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ı:

    json
    "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
    Commands
  • HQ Monitor: http://<server>:23050/, kullanıcı adı admin, parola /opt/hqbird/conf/access.properties iç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

Command
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leave

Agent 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) |