HQbird 2027 klaster na Linuksie: master i replika z RCM
Inne języki: Русский, Português.
Ten przewodnik prowadzi od dwóch czystych serwerów do działającej repliki Firebird 5.0.
Wszystko robisz w przeglądarce, w konsoli RCM, z wyjątkiem
instalacji i jednego folderu. Zrzuty ekranu pochodzą z przebiegu
z 2026-11-17: kit 2027.2.33, RCM i węzły 2027.5.12, Ubuntu 24.04,
interfejs w języku angielskim. Raport z wcześniejszego przebiegu z 2026-11-08:
hqbird2027-rcm-cluster-check-report.ru.md
(rosyjski, sekcja „Прогон 2”). Same polecenia, bez zrzutów ekranu:
hqbird2027-linux-cluster-runbook.md. Każda strona RCM szczegółowo:
podręcznik użytkownika RCM (repozytorium hqcluster-node, docs/user-guide/).
Ten przewodnik dotyczy kitu 2027.2.24 i późniejszych. Dla kitu 2027.2.22 zobacz wydanie tego pliku z 2026-11-07 w historii git.
Kit do pobrania to 2027.2.33 (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM i węzły 2027.5.12, Firebird 5.0.5.1917. Ten przewodnik został sprawdzony z nim 2026-11-17 (dwa serwery, Ubuntu 24.04, bazy danych o rozmiarze 3 MB i 167 MB): wszystkie kroki przeszły. Tekst nazywa wyniki tego przebiegu „przebiegiem z 2026-11-17”. Zrzuty ekranu pochodzą z drugiego przejścia tego dnia z tym samym kitem (bazy danych o rozmiarze 3 MB i 2,88 GB). Pozostałe liczby nadal pochodzą z przebiegu z 2026-11-08. Co kity po 2027.2.27 zmieniły dla klastra:
| Kit | Zmiana |
|---|---|
| 2027.2.29 (agent 3.1.0, RCM 2027.5.9) | Domyślnie brak klastra (patrz poniżej). Kilku agentów jednego hosta może dołączyć do klastra: każdy ma własny port parowania (7450–7459) i port węzła. fbagent --cluster-leave. Strona Clusters w HQ Monitor |
| 2027.2.30 (RCM 2027.5.10) | Switchover i failover usługi, routery |
| 2027.2.31 (agent 3.3.0, RCM 2027.5.11) | Instalator otwiera interfejs tekstowy w terminalu (krok 1). Strony Services w RCM. Serwer, który nie jest podłączony do żadnego HQCenter, sam aktualizuje agenta, HQ Monitor i fbmcp |
| 2027.2.33 (agent 3.4.0, RCM 2027.5.12) | RCM wysyła swoje alerty do Telegrama, webhooka lub e-mailem („What to watch next”). Klaster dwóch kontenerów Docker: przewodnik Docker |
Wszystkie zmiany: What’s New.
Kity z agentem (fbagent) 3.1.0 i późniejsze (od 2027.2.29) domyślnie nie tworzą klastra: brak RCM, brak okna parowania, a porty klastra pozostają zamknięte w zaporze sieciowej. W kroku 1 włączasz RCM na masterze i tryb discovery na replice.
Czas: ≈30 minut plus kopiowanie baz danych (≈1 minuta na 3 GB w sieci 1 Gbit/s).
Co otrzymujesz
| Serwer 1 | Serwer 2 | |
|---|---|---|
| Rola | master + konsola RCM | replika |
| Bazy danych | /databases/master/*.fdb |
/databases/replica/<replica node>/<master node>/*.fdb |
| Usługi | firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 |
te same, ale hqclusternode-replica-p3050 i bez hqbirdrcm (starszy kit zostawia tam własny RCM, zatrzymany) |
Czego potrzebujesz
- Dwa serwery Linux x86-64 (sprawdzone na Ubuntu 24.04), 2 rdzenie, 4 GB pamięci.
- Miejsce na dysku. Master: wolne ≥ 105 % rozmiaru bazy danych (plik
.deltarośnie podczas blokady). Replika: wolne ≥ 105 % rozmiaru bazy danych plus dolny limitlimits.free_space_floor_gb(domyślnie 1 GB). Reinit na istniejącej replice zachowuje stary plik do końca, więc wolumen repliki potrzebuje około 2 × rozmiaru bazy danych. Z polem Remove the old replica if space is short (krok 8) wystarczy 105 % plus dolny limit. - Sieć między serwerami: porty 3050, 7051, 7443, 7444, 7450. Są to porty pierwszej instancji serwera (slot 0). Druga instancja serwera używa portu parowania 7451 i portu węzła 7052.
- Twój komputer może połączyć się z portem 7444 mastera (konsola RCM), bezpośrednio lub przez tunel SSH.
- Użytkownik z
sudo.
Zapora sieciowa. Instalator otwiera porty w włączonym firewalld lub ufw (z dowolnym językiem systemowym): 3050 i 23050 zawsze, porty klastra tylko dla opcji z kroku 1. Master: 7443, 7444, 7051. Replika: 7450, 7051. Agent ponownie zamyka 7450, gdy okno parowania się kończy lub host jest połączony. Na Ubuntu ufw jest zwykle wyłączony. Wtedy instalator zapisuje jedną linię, na przykład na masterze:
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. W chmurze zamknij porty zaporą chmury: z zewnątrz tylko twój adres; między serwerami sieć wewnętrzna.
Poniżej znajdują się adresy z przebiegu: master 10.114.0.5, replika
10.114.0.6 (sieć prywatna). Użyj własnych adresów.
Krok 1. Instalacja na obu serwerach
Na każdym serwerze:
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.runW terminalu instalator otwiera swój interfejs tekstowy (kity od
2027.2.31). Pierwsza strona ma linię Cluster RCM off, discovery mode off. Otwórz Cluster i zmień jedną linię:
| Linia strony Cluster | Master | Replika |
|---|---|---|
| Cluster manager (RCM) | on |
off |
| Discovery mode (24 h) | off (ten agent uruchamia RCM) |
on |
Linie Cluster id (domyślnie: nazwa hosta), RCM admin password
(domyślnie: wygenerowane) i Pairing port (domyślnie: pierwszy wolny,
7450) mogą pozostać bez zmian. Wróć (Esc) i wybierz Install. Instalator
pokazuje plan: naciśnij Enter. Następnie pyta Nothing on this host was changed yet. Start the install now?. Kursor jest na No: przenieś go
na Yes i naciśnij Enter. Instalator sam dodaje brakujące biblioteki (na
przykład libtommath1). Interfejs tekstowy w całości:
hqbird2027-linux-setup-guide.md.
Z --no-tui, a także w kitach 2027.2.29–2027.2.30, instalator zadaje
pytania. Pierwsze to Install as planned? Yes/No: odpowiedz y. Następnie
zadaje dwa pytania o klaster. Odpowiedź domyślnie to No (Enter):
| Pytanie | 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] |
nie jest zadawane: ten agent uruchamia RCM | y |
Możesz też podać odpowiedzi jako opcje: w terminalu ustawiają one wartości
strony Cluster przed jej otwarciem. Użyj ich także do przebiegu bez terminala:
samo --yes oznacza No dla obu.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # replicaInstalacja trwa około minuty (przebieg z 2026-11-17: 61 sekund
na masterze, 43 sekundy na replice). Koniec danych wyjściowych na
masterze z kitem 2027.2.33 (hash jest tu skrócony; identyfikator klastra
w poniższych przykładach to hq27d-m, z przebiegu z 2026-11-08):
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)Na replice:
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 hostStarszy kit wypisuje Pairing: not opened (this agent runs the RCM) na
masterze.
Zapisz linie RCM: i CA hash: mastera oraz
linię Pairing: repliki. Będziesz potrzebować fingerprint w kroku 3.
Starsze kity (agent przed 3.1.0, na przykład kit 2027.2.27) nie zadają pytań o klaster. Instalują RCM na każdym serwerze i otwierają okno parowania wszędzie. Użyj RCM mastera; RCM drugiego serwera zatrzymuje się sam po połączeniu.
Później, bez instalatora. W HQ Monitor serwera otwórz Clusters, sekcję Cluster on this server. Na masterze: Enable the cluster console (RCM); HQ Monitor otwiera 7443 i 7444 w zaporze sieciowej. Na replice: Open the pairing window for 24 hours. To samo za pomocą poleceń, jako użytkownik agenta:
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 # replicaGdy okno parowania jest otwarte, agent otwiera swój port parowania w zaporze sieciowej. Zamyka port, gdy okno się kończy lub host jest połączony.
Dane wyjściowe nie zawierają haseł. Hasło RCM jest w pliku z
linii Password:, hasło SYSDBA jest w
/root/fbagent-install-sysdba.txt, a hasło HQ Monitor jest w
/opt/hqbird/conf/access.properties.
Nie musisz instalować licencji: nowy agent sam rozpoczyna 7-dniowy okres próbny, a węzły klastra działają.
Krok 2. Zaloguj się do RCM
Otwórz adres z linii RCM: mastera. Jeśli port 7444 jest zamknięty
dla twojego komputera, użyj tunelu SSH i https://localhost:7444:
ssh -L 7444:127.0.0.1:7444 <user>@<master>Jeśli port 7444 jest zajęty na twoim komputerze, użyj innego portu lokalnego, na przykład
-L 17444:127.0.0.1:7444 i https://localhost:17444.
Przeglądarka ostrzega o certyfikacie: certyfikat RCM został podpisany przez CA klastra. Strona logowania pokazuje Cluster CA hash: porównaj go z
linią CA hash: z danych wyjściowych instalatora. Jeśli się zgadzają, zainstaluj certyfikat CA
(link Download the CA certificate (hqcluster-ca.crt) na
tej samej stronie) jako zaufany lub zaakceptuj ostrzeżenie. Jeśli się nie zgadzają,
nie loguj się i sprawdź adres.
Nazwa użytkownika to rcmadmin. Hasło jest w pliku z linii Password::
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM od razu prosi o nowe hasło (co najmniej 12 znaków):
RCM przed 2027.5.12 mógł ładować tę stronę w kółko. RCM 2027.5.12 (kit 2027.2.33) ma poprawkę.
Po zmianie hasła agent mastera sam usuwa plik
rcm-initial-password w ciągu jednej minuty. W starszym kicie drugi serwer ma też własny RCM. Po połączeniu agent przenosi
ten wcześniejszy klaster do folderu cluster/left/. Agent 3.1.0 usuwa
tam swój rcm-initial-password; starszy agent tego nie robi. Wtedy usuń
plik sam:
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>Nie usuwaj pliku /opt/hqbirdrcm/initial-admin.json: zawiera
tylko hash starego hasła, a bez niego RCM, który utracił plik użytkownika, startuje
z domyślnym hasłem.
Po zmianie hasła RCM od razu otwiera Settings → Link hosts: klaster
nie ma jeszcze węzłów. Lista Releases in the mirror pokazuje
wydania hqbirdrcm i hqclusternode, z których agenci instalują
węzły.
Krok 3. Połącz hosty
Pierwszy wiersz listy jest już wypełniony (host RCM). Dodaj drugi wiersz: adres repliki, który master może osiągnąć. Wpisz IP, jeśli serwery nie mają wspólnego DNS: RCM zachowuje ciąg bez zmian, a węzły odnajdują się nawzajem po nim.
Kliknij Check hosts. Dla hosta bez portu RCM odczytuje porty parowania
7450–7459 i pokazuje jeden wiersz dla każdego agenta, który odpowie, jako
host:port (tutaj 10.114.0.6:7450). Wpisz host:port, aby odczytać tylko
jeden port. Host RCM nie potrzebuje okna parowania: RCM znajduje swojego
agenta we własnym rejestrze. Porównaj Certificate fingerprint z danymi
wyjściowymi instalatora (wiersz Pairing: repliki): muszą się zgadzać. Stan
drugiego hosta to Ready to link.
Kolumna Member ID pokazuje nazwę, którą host otrzymuje w klastrze:
<host name>-<role>, na przykład hq27d-m-master. Sufiks instancji
(-fb50) jest dodawany tylko wtedy, gdy host ma kilka agentów.
Każdy wiersz ma pole wyboru, port, instancję i port węzła. Link bierze tylko
zaznaczone wiersze. Wiersz z błędem nie może zostać zaznaczony i nie blokuje
pozostałych. Pod tabelą RCM 2027.5.12 zapisuje wiersze takie jak 10.114.0.6, no agent: closed or no answer: 7451-7459: nazywają one porty parowania
hosta, na których nie odpowiada żaden inny agent. To nie są błędy.
Master to host, na którym będą bazy produkcyjne. Kliknij Link i potwierdź:
Postęp: „Joining → Joined → The node starts → Running”. W przebiegu łączenie zajęło 56 sekund (przebieg z 2026-11-17: 47 sekund).
Overview pokazuje teraz dwa węzły: master i replikę. Zaraz po połączeniu replika może być „stale” przez jedną minutę; potem jest „online”.
Jeśli klikniesz Check hosts ponownie dla hosta, który jest już połączony, pokaże, że żaden agent nie odpowiada na portach parowania lub że host jest nieosiągalny: okno parowania na tym hoście jest zamknięte, podobnie jak jego port parowania w zaporze. To nie jest błąd.
Jeden host do klastra, który ma mastera. Połączenie jednego wiersza jest odrzucane
z lone_master: określ, czym staje się wiersz. Dodaj -replica-of <master member>
dla repliki tego mastera lub -new-master (pole wyboru na stronie Link hosts)
dla własnego mastera.
Krok 4. Folder bazy danych na masterze
Na masterze baza danych musi znajdować się w folderze, do którego użytkownik
firebird ma dostęp:
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.fdbNie musisz niczego przygotowywać na replice: przycisk Create folder w oknie Initialize tworzy folder dla kopii (krok 6).
Krok 5. Zarejestruj bazy danych na masterze
Databases → w tabeli Nodes, w wierszu mastera → Enroll.
- Folder path on that server:
/databases/master, recursive. - Include file mask:
*.fdb. - Sync tracking tables: tabele, których liczby wierszy porównuje przycisk Verify. Listę ustawiasz dla każdej bazy danych, którą rejestrujesz. Pozostaw pole puste: wtedy baza danych liczy swoje tabele publikacji. Dla bazy danych, która jest już zarządzana, zmień listę na stronie bazy danych mastera.
Preview → wybierz bazy danych → Enroll selected i potwierdź.
Wynik to „Enrolled: 2.” i wskazówka: Firebird mastera musi zostać ponownie uruchomiony. Tekst „No new databases matched.” pod nim nie jest błędem: bazy danych są już zarejestrowane.
Bazy danych czekają na ponowne uruchomienie:
Kliknij Restart Firebird of the master w wierszu dowolnej bazy danych mastera (jedno ponowne uruchomienie wystarczy dla wszystkich) i potwierdź. Wszystkie połączenia z Firebirdem mastera zostaną przerwane na kilka sekund (4 sekundy w przebiegu): wybierz odpowiedni moment.
Po ponownym uruchomieniu węzeł master ma stan CONFIGURED. Każda baza danych ma
plakietkę publication OFF, a replika pokazuje „not paired”.
Krok 6. Zainicjalizuj replikę
W wierszu bazy danych, w kolumnie repliki → Initialize. Okno dialogowe ma tytuł „Initialize database?”.
- Publication. Gdy publikacja bazy danych jest wyłączona, Firebird
nie zapisuje zmian w dzienniku, a replika nic nie otrzymuje.
Okno to mówi i pokazuje przycisk Sync publication and initialize.
Kliknij go: RCM dodaje wszystkie tabele z kluczem głównym lub unikalnym do
publikacji i od razu rozpoczyna inicjalizację. Przycisk Initialize
nie pomaga, gdy publikacja jest wyłączona: węzeł master
odmawia (
publication_off). - Replica folder: okno proponuje
/databases/replica/<replica node>, w przebiegu/databases/replica/hq27d-r-replica. Każdy węzeł repliki hosta potrzebuje własnego folderu. Zachowaj go. Jeśli pole pokazuje „✗ The folder does not exist”, kliknij Create folder; wtedy zobaczysz „✓ The folder was created.” Kopia trafia do/databases/replica/hq27d-r-replica/hq27d-m-master/. Dla kolejnych baz danych folder jest już ustawiony, a okno go nie zmienia. - Method: Smooth (domyślnie). Sprawdza transakcje zapisu przed blokadą. Standard blokuje bazę danych od razu.
- Pola „Let … stop its Firebird for this reinit” i „Remove the old replica if space is short” nie są potrzebne dla nowej repliki.
Połącz ponownie aplikacje po pierwszej synchronizacji publikacji. Połączenie z bazą danych mastera, które zostało otwarte przed włączeniem publikacji, nie jest zapisywane w dzienniku, dopóki nie połączy się ponownie. W przebiegu z 2026-11-17 połączenie otwarte przed Sync publication and initialize zapisało około 9500 wierszy po kopiowaniu, a replika nie otrzymała żadnego z nich. RCM pokazał „Ok” dla obu stron; tylko Verify (krok 9) pokazał „Not ok (desynced)”. Wiersze nowego połączenia były replikowane od razu. Zatem po pierwszym Sync publication bazy danych: połącz ponownie aplikacje (lub uruchom ponownie Firebirda mastera), a następnie uruchom Verify bez zapisów. Jeśli replika pomija wiersze, uruchom ponowną inicjalizację (krok 7).
Pierwsza inicjalizacja pod obciążeniem. Dopóki archiwum mastera nie ma
jeszcze segmentu dziennika, Smooth może odmówić, jeśli baza danych jest
zapisywana. Wiersz bazy danych pokazuje
long_transactions: … the archive holds no segment yet i wskazówkę w
języku interfejsu:
W przebiegu zdarzyło się to również po Sync publication and initialize (ustalenie G-04 w raporcie). Publikacja jest już w tym momencie włączona. Poczekaj, aż baza danych mastera pokaże „archive: 1 seg” lub więcej (15 sekund w przebiegu), i kliknij Initialize ponownie z metodą Smooth. Lub wybierz Standard. W przebiegu z 2026-11-17 (≈49 transakcji/s z jednego połączenia) Smooth nie został odrzucony.
Postęp pokazuje się w wierszu bazy danych: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. Postęp jest widoczny również po przeładowaniu strony. Przycisk Initialize jest nieaktywny w tym czasie.
Po kopiowaniu węzeł repliki sam uruchamia ponownie Firebirda repliki w zaplanowanej minucie. Wiersz mówi kiedy; przycisk Restart Firebird of the replica robi to od razu. Wszystkie połączenia z Firebirdem repliki zostają w tym momencie przerwane.
Duża baza danych działa w ten sam sposób. W przebiegu bulk.fdb (3,13 GB) został
zainicjalizowany przyciskiem Sync publication and initialize, bez
obciążenia:
Jest gotowe, gdy master i replika pokazują „Ok”, a „last applied
seg” repliki osiąga „last seg” mastera. Baza danych bez nowych zapisów
(tutaj bulk.fdb) pokazuje „Pending” z segmentem 0 dla
repliki: to normalne.
Pomiary przebiegu (employee.fdb pod obciążeniem ≈55
transakcji/s):
| Baza danych | Rozmiar | Master: od początku do końca | Blokada na masterze | Para „Ok” |
|---|---|---|---|---|
employee.fdb |
4 MB | 0,7 s | 0,35 s | po ≈1 min (czekano na ponowne uruchomienie repliki) |
bulk.fdb |
3,13 GB | 64 s (≈55 MB/s) | 59 s | po ≈2 min |
Przebieg z 2026-11-17 (kit 2027.2.33): employee.fdb (3 MB) zajął 3 sekundy
na masterze bulk.fdb (167 MB) 15 sekund. Strona repliki została sparowana
≈40 sekund po starcie (czekała na restart Firebird na
replice).
Podczas blokady baza master działa: zmiany trafiają do pliku .delta.
Późniejsza publikacja. Potrzebujesz przycisku Sync publication bazy master, gdy w bazie pojawiają się nowe tabele. Dopasowuje on publikację do tabel w jednej transakcji; Firebird nie jest restartowany.
Publication tables pokazuje, które tabele są replikowane. Nie możesz publikować tabeli bez klucza: nadaj jej klucz główny.
Krok 7. Reinicjalizacja
Potrzebujesz jej, gdy replika różni się od mastera albo gdy węzeł o nią
prosi (NEEDS_REINIT). W wierszu repliki → Reinit, metoda
Smooth. Archiwum segmentów już istnieje, a metoda smooth działa
pod obciążeniem. Czeka na transakcje zapisujące starsze niż
historia dziennika i pokazuje je.
Postęp jest taki sam jak przy inicjalizacji. Reinicjalizacja zwykle
nie wymaga restartu Firebird na replice. W przebiegu z 2026-11-17
reinicjalizacja employee.fdb spowodowała restart Firebird na replice: zaplanuj
przerwę w połączeniach z repliką. Ta reinicjalizacja zajęła 4 sekundy na
masterze przy ≈49 transakcjach/s; po zatrzymaniu zapisów liczba wierszy
się zgadzała (14 418 wierszy w tabeli obciążenia po obu stronach).
Pomiary przebiegu:
| Baza danych | Obciążenie | Czas | Blokada | Inne |
|---|---|---|---|---|
employee.fdb |
≈55 transakcji/s | 1,7 s | 0,32 s | 417 transakcji odtworzonych z segmentów |
bulk.fdb |
brak | 61 s | 55 s | brak restartu Firebird na replice |
Po reinicjalizacji smooth pod obciążeniem replika może pokazać alert info
replication_conflict_resolved („Record being inserted … already exists,
updating instead”): replika odtworzyła transakcje, które już były
w kopii. Dane się zgadzają: w przebiegu liczby wierszy wszystkich tabel się zgadzały.
Możesz potwierdzić alert (ustalenie G-07 w raporcie).
Krok 8. Mało miejsca na dysku na replice
Wolumen repliki potrzebuje co najmniej 105 % rozmiaru bazy plus 1 GB ponad starą kopię: stara kopia pozostaje do końca, a nowy plik zajmuje od razu pełny rozmiar. Jeśli miejsca brakuje, okno dialogowe pokazuje, ile miejsca potrzeba, ile jest wolnego i ile zajmuje stara kopia (szacunek RCM; decyduje węzeł repliki). Jeśli miejsca wystarczy bez starej kopii, okno dialogowe proponuje pole Remove the old replica if space is short.
Z tym polem węzeł repliki po blokadzie na masterze zatrzymuje
Firebird na replice, usuwa starą kopię i ponownie uruchamia Firebird.
W przebiegu (2,97 GB wolnego, nowa kopia potrzebuje 3,29 GB, stara kopia
3,13 GB) reinicjalizacja bulk.fdb z polem zajęła 65 sekund. Bez
pola węzeł odmawia z insufficient disk space on replica.
Okno dialogowe może nie pokazywać liczb, gdy brakuje tylko dolnego progu 1 GB. W
przebiegu z 2026-11-17 (1,1 GB wolnego, baza ma 167 MB) okno dialogowe nie pokazało
szacunku, a reinicjalizacja bez pola nie powiodła się w 3 sekundy. Wiersz
bazy i strona Commands pokazały przyczynę: 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. Ta sama reinicjalizacja z polem zajęła 9 sekund.
Ryzyko związane z polem. Podczas kopiowania nie ma repliki tej bazy. Jeśli reinicjalizacja się nie powiedzie, para jest w stanie
NEEDS_REINIT, replika ma alertreplica_removed_for_reinit(warn), a ponowna próba to nowa pełna reinicjalizacja. Automatyczna reinicjalizacja usuwa starą kopię tylko wtedy, gdy klucz RCMauto_reinit.remove_old_replica_when_shortjest włączony (domyślnie wyłączony).
Krok 9. Weryfikacja
Verify w wierszu repliki porównuje COUNT(*) tabel śledzenia na
masterze i na replice. Nie porównuje samych wierszy.
Wiersz „Table list source” podaje listę: własna lista bazy, lista
węzła, tabele publikacji albo RDB$FIELDS. Liczby wierszy mają
separatory tysięcy.
Pod obciążeniem replika jest kilka sekund z tyłu, a Verify daje „Not ok” dla tabel, do których trwa zapis:
Bez zapisów liczby się zgadzają:
Tabela, której nie ma w żadnej bazie, to „not in the database”: to nie jest niezgodność. Tabela tylko po jednej stronie to „no table”: to jest niezgodność.
Bezpieczniejszym sprawdzeniem jest liczba wierszy wszystkich tabel po obu stronach po
zatrzymaniu zapisów (skrypt jest w
hqbird2027-linux-cluster-runbook.md). W
przebiegu wszystkie 11 tabel się zgadzało (employee.fdb: 10, bulk.fdb: 1, z
2 800 000 wierszy).
Okresowe sprawdzanie (Data check) jest domyślnie wyłączone. Kliknij Turn on for all nodes i potwierdź: każdy węzeł liczy swoje wiersze, a master porównuje liczby. Nie potrzebujesz restartu: RCM pokazuje „Saved and in force now: the node needs no restart.” Pierwsze sprawdzenie uruchamia się jeden interwał później (domyślnie 2 godziny).
Na co zwrócić uwagę dalej
-
Overview: węzły, ich stan, katalog główny bazy i miejsce na dysku.
Overview -
Alerts: problemy węzłów i baz. W przebiegu były dwa alerty i oba możesz potwierdzić:
replication_conflict_resolvedpo reinicjalizacji smooth (krok 7) orazparse_no_observationsna masterze („no events parsed from /opt/firebird/replication.log”). Firebird na masterze zapisuje doreplication.logtylko błędy, więc pusty dziennik jest normalny (ustalenie G-06 w raporcie).
Alerts RCM 2027.5.12 i nowsze (kit 2027.2.33) mogą wysyłać alerty o ważności
warni wyższej do własnego bota Telegram, webhooka lub e-maila. Kanały ustawiasz w pliku/opt/hqbirdrcm/rcm.json, klucznotify.channels, i restartujesz RCM (sudo systemctl restart hqbirdrcm). Blok Notification channels na tej stronie wyświetla wtedy kanały, każdy z przyciskiem Send test. Gdy nie ma kanału, pokazuje „No channel is configured: RCM sends its alerts nowhere.” Kanał Telegram:"notify": { "channels": [ { "name": "ops", "type": "telegram", "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }Przebieg z 2026-11-17 sprawdził blok bez kanału; żadna wiadomość nie została wysłana.
-
Services (RCM 2027.5.11 i nowsze, kity od 2027.2.31): master, repliki i routery usługi oraz operacje switchover, failover i rejoin. Ten przewodnik ich nie obejmuje: zobacz podręcznik użytkownika RCM. Zaktualizuj RCM i węzły do tej samej wersji, zanim ich użyjesz.
-
Commands: każda operacja RCM z wynikiem. Czas to czas lokalny przeglądarki ze strefą (na przykład
17:59:45 UTC+1); podpowiedź pokazuje czas w UTC. Dzienniki węzłów używają UTC.
Commands -
HQ Monitor:
http://<server>:23050/, nazwa użytkownikaadmin, hasło jest w/opt/hqbird/conf/access.properties. Pokazuje serwer i bazy. W kitach z agentem 3.1.0 i nowszym HQ Monitor ma stronę Clusters. Na masterze (hoście RCM) pokazuje klaster przez agenta, bez ustawień RCM w HQ Monitor. Na replice podaje host RCM i link do jego konsoli. HQ Monitor 1.49.0 nie ma stanu replikacji ani linku do RCM. Od kitu 2027.2.33 (agent 3.4.0) agent wysyła problemy swojego serwera także do twoich kanałów: Servers → Notifications.
Aktualizacja klastra
Najpierw zaktualizuj HQbird RCM, potem węzły. Od kitu 2027.2.31 serwer, który nie jest podłączony do żadnego HQCenter, sam aktualizuje agenta, HQ Monitor i fbmcp („Updates without HQCenter” w hqbird2027-linux-setup-guide.md); serwer podłączony do HQCenter pobiera aktualizacje z tego HQCenter.
Wyłączenie hosta z klastra
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leaveAgent zatrzymuje się i wyrejestrowuje swoje usługi węzła, zamyka ich porty węzła,
usuwa swoje certyfikaty klastra i ustawia cluster.source na none. Folder węzła
pozostaje (--remove-data go usuwa). Agent, który uruchamia RCM, jest
odrzucany. Agent odchodzi też sam, gdy RCM go odwoła lub zabierze jego ostatniego
członka. Odinstalowanie zawsze opuszcza klaster: ponowna instalacja w tym samym
folderze zaczyna od zera. W przebiegu z 2026-11-17 polecenie wypisało Cluster: left <cluster id>, bazy repliki pozostały w swoim folderze, a RCM
nadal pokazywał węzeł tego hosta minutę później. Usunięcie HQbird
z serwera klastra, także z
serwera, który uruchamia RCM:
hqbird2027-removal-guide.md, sekcja 4.
Częste błędy
| Co widzisz | Przyczyna | Co zrobić |
|---|---|---|
publication_off przy inicjalizacji |
publikacja jest wyłączona albo nie ma żadnej tabeli, choć baza ma tabele z kluczem | przycisk Sync publication and initialize (krok 6) |
long_transactions … the archive holds no segment yet |
pierwsza inicjalizacja metodą smooth, gdy do bazy trwa zapis, a archiwum mastera jest puste | poczekaj na „archive: 1 seg” i ponów Smooth albo wybierz Standard |
reinit_pre_publication_transactions |
transakcja zapisująca rozpoczęła się przed włączeniem publikacji i jest otwarta dłużej niż minutę | zakończ ją (COMMIT lub ROLLBACK) i ponów |
| „✗ The folder does not exist on …” w oknie dialogowym | nikt nie utworzył folderu repliki | przycisk Create folder w oknie dialogowym albo install -d -o firebird -g firebird -m 0770 <folder> na replice |
| „Not ok (desynced)” w Verify | do bazy trwa zapis, a replika jest kilka sekund z tyłu | ponów bez obciążenia; sprawdź kolumnę Match |
| „Not ok (desynced)” w Verify bez zapisów; obie strony pokazują „Ok” | połączenie aplikacji zostało otwarte przed włączeniem publikacji: nie jest rejestrowane w dzienniku | połącz aplikację ponownie, następnie Reinit (krok 6, uwaga o pierwszej synchronizacji publikacji) |
| Host „unreachable” lub „no agent” w Link hosts | okno parowania hosta jest zamknięte (domyślnie wyłączone lub minęło 24 h) albo zapora między serwerami blokuje porty 7450–7459 | otwórz okno na hoście: HQ Monitor → Clusters → Open the pairing window for 24 hours lub fbagent --cluster-pairing on; otwórz port w zaporze chmurowej |
| insufficient disk space on replica przy ponownej inicjalizacji | stara replika pozostaje do końca, a nowy plik zajmuje pełny rozmiar | zwolnij ≥ 105 % rozmiaru bazy danych + 1 GB ponad stary plik na wolumenie repliki albo zaznacz pole Remove the old replica if space is short (krok 8) |
| Węzeł nie pojawia się po Link hosts | lustro RCM nie ma podpisanej wersji hqclusternode | Releases in the mirror na stronie Link hosts (krok 2) |