Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh. English

Các ngôn ngữ khác: Русский, Português.

Hướng dẫn này đi từ hai máy chủ sạch đến một bản sao Firebird 5.0 đang hoạt động. Bạn làm mọi thứ trong trình duyệt, trong bảng điều khiển RCM, ngoại trừ việc cài đặt và một thư mục. Các ảnh chụp màn hình đến từ lần chạy 2026-11-17: bộ cài 2027.2.33, RCM và các node 2027.5.12, Ubuntu 24.04, giao diện tiếng Anh. Báo cáo của lần chạy trước đó ngày 2026-11-08: hqbird2027-rcm-cluster-check-report.ru.md (tiếng Nga, mục “Прогон 2”). Chỉ lệnh, không có ảnh chụp màn hình: hqbird2027-linux-cluster-runbook.md. Chi tiết từng trang RCM: hướng dẫn người dùng RCM (kho lưu trữ hqcluster-node, docs/user-guide/).

Hướng dẫn này dành cho bộ cài 2027.2.24 trở lên. Đối với bộ cài 2027.2.22, xem phiên bản của tệp này từ 2026-11-07 trong lịch sử git.

Bộ cài cần tải là 2027.2.33 (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM và các node 2027.5.12, Firebird 5.0.5.1917. Hướng dẫn này đã được kiểm tra với nó vào 2026-11-17 (hai máy chủ, Ubuntu 24.04, cơ sở dữ liệu 3 MB và 167 MB): tất cả các bước đều đạt. Văn bản gọi kết quả của lần chạy đó là “lần chạy 2026-11-17”. Các ảnh chụp màn hình đến từ một lượt chạy thứ hai trong ngày hôm đó với cùng bộ cài (cơ sở dữ liệu 3 MB và 2.88 GB). Các con số khác vẫn đến từ lần chạy 2026-11-08. Những gì các bộ cài sau 2027.2.27 đã thay đổi cho một cluster:

Bộ cài Thay đổi
2027.2.29 (agent 3.1.0, RCM 2027.5.9) Không có cluster theo mặc định (xem bên dưới). Nhiều agent của một máy chủ có thể tham gia một cluster: mỗi agent có cổng ghép nối riêng (7450–7459) và cổng node. fbagent --cluster-leave. Trang Clusters của HQ Monitor
2027.2.30 (RCM 2027.5.10) Chuyển đổi và chuyển đổi dự phòng của một dịch vụ, bộ định tuyến
2027.2.31 (agent 3.3.0, RCM 2027.5.11) Trình cài đặt mở giao diện văn bản trong một terminal (bước 1). Các trang Services của RCM. Một máy chủ không được gắn vào HQCenter nào sẽ tự cập nhật agent, HQ Monitor và fbmcp
2027.2.33 (agent 3.4.0, RCM 2027.5.12) RCM gửi cảnh báo của nó đến Telegram, một webhook hoặc e-mail (“What to watch next”). Một cluster gồm hai container Docker: hướng dẫn Docker

Tất cả thay đổi: What’s New.

Các bộ cài có agent (fbagent) 3.1.0 trở lên (từ 2027.2.29) không tạo cluster theo mặc định: không có RCM, không có cửa sổ ghép nối, và các cổng cluster vẫn đóng trong tường lửa. Trong bước 1, bạn bật RCM trên master và chế độ khám phá trên replica.

Thời gian: ≈30 phút cộng với việc sao chép cơ sở dữ liệu (≈1 phút cho mỗi 3 GB trên mạng 1 Gbit/s).

Những gì bạn nhận được

Máy chủ 1 Máy chủ 2
Vai trò master + bảng điều khiển RCM replica
Cơ sở dữ liệu /databases/master/*.fdb /databases/replica/<replica node>/<master node>/*.fdb
Dịch vụ firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 tương tự, nhưng hqclusternode-replica-p3050 và không có hqbirdrcm (một bộ cài cũ để lại RCM riêng của nó ở đó, đã dừng)

Những gì bạn cần

  • Hai máy chủ Linux x86-64 (đã kiểm tra trên Ubuntu 24.04), 2 lõi, 4 GB bộ nhớ.
  • Dung lượng đĩa. Master: trống ≥ 105 % kích thước cơ sở dữ liệu (tệp .delta phát triển trong quá trình khóa). Replica: trống ≥ 105 % kích thước cơ sở dữ liệu cộng với mức sàn limits.free_space_floor_gb (mặc định 1 GB). Một lần khởi tạo lại trên một replica hiện có giữ tệp cũ cho đến khi kết thúc, vì vậy ổ đĩa replica cần khoảng 2 × kích thước cơ sở dữ liệu. Với hộp Remove the old replica if space is short (bước 8), 105 % cộng với mức sàn là đủ.
  • Mạng giữa các máy chủ: cổng 3050, 7051, 7443, 7444, 7450. Đây là các cổng của phiên bản đầu tiên của một máy chủ (slot 0). Một phiên bản thứ hai của một máy chủ sử dụng cổng ghép nối 7451 và cổng node 7052.
  • PC của bạn có thể truy cập cổng 7444 của master (bảng điều khiển RCM), trực tiếp hoặc qua một đường hầm SSH.
  • Một người dùng có sudo.

Tường lửa. Trình cài đặt mở các cổng trong firewalld hoặc ufw đang bật (với bất kỳ ngôn ngữ hệ thống nào): 3050 và 23050 luôn luôn, các cổng cluster chỉ cho các tùy chọn của bước 1. Master: 7443, 7444, 7051. Replica: 7450, 7051. Agent đóng lại 7450 khi cửa sổ ghép nối kết thúc hoặc máy chủ được liên kết. Trên Ubuntu, ufw thường bị tắt. Khi đó trình cài đặt ghi một dòng, ví dụ trên master: 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. Trong đám mây, hãy đóng các cổng bằng tường lửa đám mây: từ bên ngoài, chỉ địa chỉ của bạn; giữa các máy chủ, mạng nội bộ.

Dưới đây là các địa chỉ của lần chạy: master 10.114.0.5, replica 10.114.0.6 (mạng riêng). Hãy dùng địa chỉ của riêng bạn.

Bước 1. Cài đặt trên cả hai máy chủ

Trên mỗi máy chủ:

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

Trong một terminal, trình cài đặt mở giao diện văn bản của nó (các bộ cài từ 2027.2.31). Trang đầu tiên có dòng Cluster RCM off, discovery mode off. Mở Cluster và thay đổi một dòng:

Dòng của trang Cluster Master Replica
Cluster manager (RCM) on off
Discovery mode (24 h) off (agent này chạy RCM) on

Các dòng Cluster id (mặc định: tên máy chủ), RCM admin password (mặc định: được tạo) và Pairing port (mặc định: cổng trống đầu tiên, 7450) có thể giữ nguyên. Quay lại (Esc) và chọn Install. Trình cài đặt hiển thị kế hoạch: nhấn Enter. Sau đó nó hỏi Nothing on this host was changed yet. Start the install now?. Con trỏ ở No: di chuyển nó đến Yes và nhấn Enter. Trình cài đặt tự thêm các thư viện còn thiếu (ví dụ, libtommath1). Giao diện văn bản đầy đủ: hqbird2027-linux-setup-guide.md.

Với --no-tui, và trong các bộ cài 2027.2.29–2027.2.30, trình cài đặt hỏi các câu hỏi. Câu đầu tiên là Install as planned? Yes/No: trả lời y. Sau đó nó hỏi hai câu hỏi về cluster. Câu trả lời mặc định là No (Enter):

Câu hỏi Master Replica
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] không được hỏi: agent này chạy RCM y

Hoặc đưa ra các câu trả lời dưới dạng tùy chọn: trong một terminal, chúng đặt các giá trị của trang Cluster trước khi nó mở ra. Dùng chúng cả cho một lần chạy không có terminal: --yes một mình có nghĩa là No cho cả hai.

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

Việc cài đặt mất khoảng một phút (lần chạy 2026-11-17: 61 giây trên master, 43 giây trên replica). Phần cuối của đầu ra trên master với bộ cài 2027.2.33 (mã băm được rút gọn ở đây; cluster id của các ví dụ bên dưới là hq27d-m, từ lần chạy 2026-11-08):

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)

Trên replica:

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

Một bộ cài cũ in Pairing: not opened (this agent runs the RCM) trên master.

Hãy ghi lại các dòng RCM: và CA hash: của master và dòng Pairing: của replica. Bạn cần fingerprint trong bước 3.

Các bộ cài cũ (agent trước 3.1.0, ví dụ bộ cài 2027.2.27) không hỏi câu hỏi nào về cluster. Chúng cài RCM trên mọi máy chủ và mở cửa sổ ghép nối ở mọi nơi. Hãy dùng RCM của master; RCM của máy chủ thứ hai tự dừng sau khi liên kết.

Sau này, không dùng trình cài đặt. Trong HQ Monitor của máy chủ, mở Clusters, mục Cluster on this server. Trên master: Enable the cluster console (RCM); HQ Monitor mở 7443 và 7444 trong tường lửa. Trên replica: Open the pairing window for 24 hours. Thực hiện tương tự bằng lệnh, với tư cách người dùng của agent:

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

Trong khi cửa sổ ghép nối mở, agent mở cổng ghép nối của nó trong tường lửa. Nó đóng cổng khi cửa sổ kết thúc hoặc máy chủ được liên kết.

Đầu ra không có mật khẩu. Mật khẩu RCM nằm trong tệp từ dòng Password:, mật khẩu SYSDBA nằm trong /root/fbagent-install-sysdba.txt, và mật khẩu HQ Monitor nằm trong /opt/hqbird/conf/access.properties.

Bạn không cần cài đặt giấy phép: một agent mới tự khởi động bản dùng thử 7 ngày, và các node cluster hoạt động.

Bước 2. Đăng nhập vào RCM

Mở địa chỉ từ dòng RCM: của master. Nếu cổng 7444 bị đóng đối với PC của bạn, hãy dùng một đường hầm SSH và https://localhost:7444:

Command
ssh -L 7444:127.0.0.1:7444 <user>@<master>

Nếu cổng 7444 bận trên PC của bạn, hãy dùng một cổng cục bộ khác, ví dụ -L 17444:127.0.0.1:7444 và https://localhost:17444.

Trình duyệt cảnh báo về chứng chỉ: CA của cluster đã ký chứng chỉ RCM. Trang đăng nhập hiển thị Cluster CA hash: so sánh nó với dòng CA hash: của đầu ra trình cài đặt. Nếu chúng khớp, hãy cài chứng chỉ CA (liên kết Download the CA certificate (hqcluster-ca.crt) trên cùng trang) dưới dạng tin cậy, hoặc chấp nhận cảnh báo. Nếu chúng không khớp, đừng đăng nhập, và kiểm tra địa chỉ.

RCM sign-in
RCM sign-in

Tên người dùng là rcmadmin. Mật khẩu nằm trong tệp từ dòng Password: :

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

RCM yêu cầu một mật khẩu mới ngay lập tức (ít nhất 12 ký tự):

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

Một RCM trước 2027.5.12 có thể tải trang này lặp đi lặp lại. RCM 2027.5.12 (bộ cài 2027.2.33) có bản sửa lỗi.

Sau khi đổi mật khẩu, agent của master tự xóa tệp rcm-initial-password trong vòng một phút. Với một bộ cài cũ hơn, máy chủ thứ hai cũng có RCM riêng của nó. Sau khi liên kết, agent di chuyển cluster trước đó đó đến thư mục cluster/left/. Agent 3.1.0 xóa rcm-initial-password của nó ở đó; một agent cũ hơn thì không. Sau đó hãy tự xóa tệp:

Command
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>

Đừng xóa tệp /opt/hqbirdrcm/initial-admin.json: nó chỉ chứa mã băm của mật khẩu cũ, và nếu không có nó, một RCM đã mất tệp người dùng của nó sẽ khởi động với mật khẩu mặc định.

Sau khi đổi mật khẩu, RCM mở Settings → Link hosts ngay lập tức: cluster chưa có node nào. Danh sách Releases in the mirror hiển thị các bản phát hành hqbirdrcm và hqclusternode mà từ đó các agent cài đặt các node.

Liên kết các máy chủ sau khi đăng nhập
Liên kết các máy chủ sau khi đăng nhập

Bước 3. Liên kết các máy chủ

Hàng đầu tiên của danh sách đã được điền sẵn (máy chủ RCM). Thêm hàng thứ hai: địa chỉ bản sao mà máy chủ chính có thể truy cập. Nhập một IP nếu các máy chủ không có DNS chung: RCM giữ nguyên chuỗi đó, và các nút tìm thấy nhau qua địa chỉ này.

Danh sách máy chủ
Danh sách máy chủ

Nhấn Check hosts. Với một máy chủ không có cổng, RCM đọc các cổng ghép cặp 7450–7459 và hiển thị một hàng cho mỗi agent phản hồi, dưới dạng host:port (ở đây là 10.114.0.6:7450). Ghi host:port để chỉ đọc một cổng duy nhất. Máy chủ RCM không cần cửa sổ ghép cặp: RCM tìm agent của nó trong registry riêng của mình. So sánh Certificate fingerprint với kết quả của trình cài đặt (dòng Pairing: của bản sao): chúng phải khớp nhau. Trạng thái của máy chủ thứ hai là Ready to link. Cột Member ID hiển thị tên mà máy chủ nhận được trong cluster: <host name>-<role>, ví dụ hq27d-m-master. Hậu tố instance (-fb50) chỉ được thêm khi máy chủ có nhiều agent.

Kiểm tra các máy chủ
Kiểm tra các máy chủ

Mỗi hàng có một hộp kiểm, cổng, instance và cổng nút. Link chỉ lấy các hàng được đánh dấu. Một hàng bị lỗi không thể được đánh dấu và không chặn các hàng khác. Bên dưới bảng, RCM 2027.5.12 ghi các dòng như 10.114.0.6, no agent: closed or no answer: 7451-7459: chúng nêu tên các cổng ghép cặp của máy chủ nơi không có agent nào khác phản hồi. Chúng không phải là lỗi.

Master là máy chủ nơi các cơ sở dữ liệu sản xuất sẽ nằm. Nhấn Link và xác nhận:

Xác nhận
Xác nhận

Tiến trình: “Joining → Joined → The node starts → Running”. Trong lần chạy, việc liên kết mất 56 giây (lần chạy ngày 2026-11-17: 47 giây).

Tiến trình liên kết
Tiến trình liên kết
Hoàn tất
Hoàn tất

Overview giờ hiển thị hai nút: máy chủ chính và bản sao. Ngay sau khi liên kết, bản sao có thể ở trạng thái “stale” trong một phút; sau đó nó “online”.

Overview: hai nút
Overview: hai nút

Nếu bạn nhấn Check hosts lần nữa cho một máy chủ đã được liên kết, nó hiển thị rằng không có agent nào phản hồi trên các cổng ghép cặp, hoặc máy chủ không thể truy cập: cửa sổ ghép cặp trên máy chủ đó đã đóng, và cổng ghép cặp của nó trong tường lửa cũng vậy. Đây không phải là lỗi.

Một máy chủ vào một cluster đã có master. Việc liên kết một hàng bị từ chối với lone_master: hãy nói rõ hàng đó trở thành gì. Thêm -replica-of <master member> cho một bản sao của master đó, hoặc -new-master (hộp kiểm trên trang Link hosts) cho một master riêng của nó.

Bước 4. Thư mục cơ sở dữ liệu trên master

Trên master, cơ sở dữ liệu phải nằm trong một thư mục mà người dùng firebird có thể truy cập:

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

Bạn không cần chuẩn bị gì trên bản sao: nút Create folder trong hộp thoại Initialize sẽ tạo thư mục cho các bản sao (bước 6).

Bước 5. Đăng ký các cơ sở dữ liệu trên master

Databases → trong bảng Nodes, ở hàng của master → Enroll.

  • Folder path on that server: /databases/master, recursive.
  • Include file mask: *.fdb.
  • Sync tracking tables: các bảng mà nút Verify so sánh số hàng. Bạn đặt danh sách cho từng cơ sở dữ liệu mà bạn đăng ký. Để trống trường này: khi đó cơ sở dữ liệu sẽ đếm các bảng publication của nó. Với một cơ sở dữ liệu đã được quản lý, hãy thay đổi danh sách trên trang của cơ sở dữ liệu master.
Biểu mẫu đăng ký
Biểu mẫu đăng ký

Preview → chọn các cơ sở dữ liệu → Enroll selected và xác nhận.

Xác nhận đăng ký
Xác nhận đăng ký

Kết quả là “Enrolled: 2.” và một gợi ý: Firebird của master phải khởi động lại. Dòng chữ “No new databases matched.” bên dưới không phải là lỗi: các cơ sở dữ liệu đã được đăng ký rồi.

Kết quả đăng ký
Kết quả đăng ký

Các cơ sở dữ liệu chờ khởi động lại:

Chờ khởi động lại
Chờ khởi động lại

Nhấn Restart Firebird of the master ở hàng của bất kỳ cơ sở dữ liệu nào của master (một lần khởi động lại là đủ cho tất cả) và xác nhận. Tất cả các kết nối tới Firebird của master sẽ bị ngắt trong vài giây (4 giây trong lần chạy): hãy chọn thời điểm thích hợp.

Khởi động lại Firebird của master
Khởi động lại Firebird của master

Sau khi khởi động lại, nút master là CONFIGURED. Mỗi cơ sở dữ liệu có nhãn publication OFF, và bản sao hiển thị “not paired”.

Sau khi khởi động lại
Sau khi khởi động lại

Bước 6. Khởi tạo bản sao

Trong hàng cơ sở dữ liệu, ở cột bản sao → Initialize. Hộp thoại có tiêu đề “Initialize database?”.

Hộp thoại Initialize
Hộp thoại Initialize
  • Publication. Khi publication của cơ sở dữ liệu đang tắt, Firebird không ghi các thay đổi vào journal, và bản sao không nhận được gì. Hộp thoại cho biết điều này và hiển thị nút Sync publication and initialize. Nhấn nút đó: RCM thêm tất cả các bảng có khóa chính hoặc khóa duy nhất vào publication và bắt đầu khởi tạo ngay lập tức. Nút Initialize không có tác dụng khi publication đang tắt: nút master từ chối (publication_off).
  • Replica folder: hộp thoại đề xuất /databases/replica/<replica node>, trong lần chạy là /databases/replica/hq27d-r-replica. Mỗi nút bản sao của một máy chủ cần thư mục riêng của nó. Hãy giữ nguyên. Nếu trường hiển thị “✗ The folder does not exist”, nhấn Create folder; sau đó bạn thấy “✓ The folder was created.” Bản sao chép đi tới /databases/replica/hq27d-r-replica/hq27d-m-master/. Với các cơ sở dữ liệu tiếp theo, thư mục đã được đặt sẵn, và hộp thoại không thay đổi nó.
  • Method: Smooth (mặc định). Nó kiểm tra các giao dịch ghi trước khi khóa. Standard khóa cơ sở dữ liệu ngay lập tức.
  • Bạn không cần các hộp “Let … stop its Firebird for this reinit” và “Remove the old replica if space is short” cho một bản sao mới.

Kết nối lại các ứng dụng sau lần đồng bộ publication đầu tiên. Một kết nối tới cơ sở dữ liệu master được mở trước khi publication được bật sẽ không được ghi journal cho đến khi nó kết nối lại. Trong lần chạy ngày 2026-11-17, một kết nối được mở trước Sync publication and initialize đã ghi khoảng 9.500 hàng sau khi sao chép, và bản sao không nhận được hàng nào trong số đó. RCM hiển thị “Ok” cho cả hai bên; chỉ Verify (bước 9) hiển thị “Not ok (desynced)”. Các hàng của một kết nối mới được sao chép ngay lập tức. Vì vậy, sau lần Sync publication đầu tiên của một cơ sở dữ liệu: hãy kết nối lại các ứng dụng (hoặc khởi động lại Firebird của master), sau đó chạy Verify mà không ghi. Nếu bản sao thiếu hàng, hãy chạy reinit (bước 7).

Lần khởi tạo đầu tiên dưới tải. Khi archive của master chưa có phân đoạn journal nào, Smooth có thể từ chối nếu cơ sở dữ liệu đang được ghi vào. Hàng cơ sở dữ liệu hiển thị long_transactions: … the archive holds no segment yet và một gợi ý bằng ngôn ngữ giao diện:

Từ chối phương thức smooth
Từ chối phương thức smooth

Trong lần chạy, điều này cũng xảy ra sau Sync publication and initialize (phát hiện G-04 trong báo cáo). Publication đã bật tại thời điểm này. Hãy đợi cho đến khi cơ sở dữ liệu master hiển thị “archive: 1 seg” hoặc hơn (15 giây trong lần chạy), và nhấn Initialize lần nữa với phương thức Smooth. Hoặc chọn Standard. Trong lần chạy ngày 2026-11-17 (≈49 giao dịch/s từ một kết nối), Smooth không bị từ chối.

Tiến trình hiển thị trong hàng cơ sở dữ liệu: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. Tiến trình cũng hiển thị sau khi tải lại trang. Nút Initialize không hoạt động trong thời gian này.

Tiến trình khởi tạo
Tiến trình khởi tạo

Sau khi sao chép, nút bản sao tự khởi động lại Firebird của bản sao vào phút đã định. Hàng hiển thị thời điểm; nút Restart Firebird of the replica thực hiện ngay lập tức. Tất cả các kết nối tới Firebird của bản sao bị ngắt tại thời điểm này.

Chờ khởi động lại Firebird của bản sao
Chờ khởi động lại Firebird của bản sao

Một cơ sở dữ liệu lớn hoạt động theo cùng cách. Trong lần chạy, bulk.fdb (3,13 GB) được khởi tạo bằng nút Sync publication and initialize, không có tải trên nó:

Sao chép cơ sở dữ liệu lớn
Sao chép cơ sở dữ liệu lớn

Nó hoàn tất khi master và bản sao hiển thị “Ok”, và “last applied seg” của bản sao đạt tới “last seg” của master. Một cơ sở dữ liệu không có ghi mới (ở đây là bulk.fdb) hiển thị “Pending” với phân đoạn 0 cho bản sao: điều này là bình thường.

Cả hai cơ sở dữ liệu sẵn sàng
Cả hai cơ sở dữ liệu sẵn sàng

Các phép đo của lần chạy (employee.fdb dưới tải ≈55 giao dịch/s):

Cơ sở dữ liệu Kích thước Master: từ đầu đến cuối Khóa trên master Cặp “Ok”
employee.fdb 4 MB 0,7 s 0,35 s sau ≈1 phút (chờ bản sao khởi động lại)
bulk.fdb 3,13 GB 64 s (≈55 MB/s) 59 s sau ≈2 phút

Lần chạy ngày 2026-11-17 (kit 2027.2.33): employee.fdb (3 MB) mất 3 giây

Trên master, bulk.fdb (167 MB) mất 15 giây. Phía replica được ghép nối ≈40 giây sau khi bắt đầu (nó chờ Firebird của replica khởi động lại).

Trong thời gian khóa, cơ sở dữ liệu master vẫn hoạt động: các thay đổi được ghi vào tệp .delta.

Xuất bản sau. Bạn cần nút Sync publication của cơ sở dữ liệu master khi có bảng mới xuất hiện trong cơ sở dữ liệu. Nó làm cho publication khớp với các bảng trong một giao dịch; Firebird không khởi động lại.

Sync publication
Sync publication

Publication tables hiển thị những bảng nào được sao chép. Bạn không thể xuất bản một bảng không có khóa: hãy gán cho nó một khóa chính.

Publication tables
Publication tables

Bước 7. Khởi tạo lại

Bạn cần nó khi replica khác với master, hoặc khi node yêu cầu (NEEDS_REINIT). Trong dòng của replica → Reinit, phương thức Smooth. Đã có sẵn một kho lưu trữ segment, và phương thức smooth hoạt động dưới tải. Nó chờ các giao dịch ghi cũ hơn lịch sử journal, và hiển thị chúng.

Reinit, smooth method
Reinit, smooth method

Tiến trình giống như khi khởi tạo. Một lần reinit thường không cần khởi động lại Firebird của replica. Trong lần chạy ngày 2026-11-17, reinit của employee.fdb đã khởi động lại Firebird của replica: hãy dự phòng cho việc ngắt kết nối tới replica. Lần reinit đó mất 4 giây trên master dưới ≈49 giao dịch/giây; sau khi việc ghi dừng lại, số hàng khớp nhau (14.418 hàng trong bảng tải ở cả hai phía).

Copy at the reinit
Copy at the reinit

Các phép đo của lần chạy:

Cơ sở dữ liệu Tải Thời gian Khóa Khác
employee.fdb ≈55 giao dịch/giây 1,7 giây 0,32 giây 417 giao dịch được phát lại từ các segment
bulk.fdb không 61 giây 55 giây không khởi động lại Firebird của replica

Sau một lần reinit smooth dưới tải, replica có thể hiển thị cảnh báo info replication_conflict_resolved (“Record being inserted … already exists, updating instead”): replica đã phát lại các giao dịch vốn đã có trong bản sao. Dữ liệu khớp nhau: trong lần chạy, số hàng của tất cả các bảng đều khớp. Bạn có thể xác nhận cảnh báo (phát hiện G-07 trong báo cáo).

Bước 8. Dung lượng đĩa thấp trên replica

Volume của replica cần dung lượng trống ≥ 105 % kích thước cơ sở dữ liệu cộng thêm 1 GB ngoài bản sao cũ: bản sao cũ vẫn tồn tại cho đến khi kết thúc, và tệp mới chiếm toàn bộ kích thước của nó ngay lập tức. Nếu không đủ dung lượng, hộp thoại hiển thị cần bao nhiêu dung lượng, còn trống bao nhiêu, và bản sao cũ chiếm bao nhiêu (một ước tính của RCM; node replica quyết định). Nếu đủ dung lượng mà không cần bản sao cũ, hộp thoại gợi ý hộp Remove the old replica if space is short.

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

Với hộp này, node replica, sau khi khóa trên master, dừng Firebird của replica, xóa bản sao cũ, và khởi động lại Firebird. Trong lần chạy (2,97 GB trống, bản sao mới cần 3,29 GB, bản sao cũ là 3,13 GB), lần reinit của bulk.fdb với hộp này mất 65 giây. Không có hộp này, node từ chối với insufficient disk space on replica.

Hộp thoại có thể không hiển thị con số nào khi chỉ thiếu mức sàn 1 GB. Trong lần chạy ngày 2026-11-17 (1,1 GB trống, cơ sở dữ liệu là 167 MB), hộp thoại hiển thị không có ước tính, và lần reinit không có hộp này thất bại trong 3 giây. Dòng cơ sở dữ liệu và trang Commands hiển thị lý do: 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. Cùng lần reinit đó với hộp này mất 9 giây.

Rủi ro của hộp này. Trong khi bản sao đang chạy, không có replica nào của cơ sở dữ liệu này. Nếu reinit thất bại, cặp ở trạng thái NEEDS_REINIT, replica có cảnh báo replica_removed_for_reinit (warn), và thử lại là một lần reinit đầy đủ mới. Một lần reinit tự động chỉ xóa bản sao cũ nếu khóa RCM auto_reinit.remove_old_replica_when_short được bật (mặc định tắt).

Bước 9. Xác minh

Verify trong dòng của replica so sánh COUNT(*) của các bảng theo dõi trên master và trên replica. Nó không so sánh chính các hàng. Dòng “Table list source” nêu tên danh sách: danh sách riêng của cơ sở dữ liệu, danh sách của node, các bảng publication, hoặc RDB$FIELDS. Số hàng có các nhóm chữ số.

Dưới tải, replica chậm vài giây, và Verify cho kết quả “Not ok” đối với các bảng đang được ghi:

Verify under load
Verify under load

Không có ghi, các số đếm khớp nhau:

Verify without load
Verify without load

Một bảng không có trong cả hai cơ sở dữ liệu là “not in the database”: đây không phải là sự không khớp. Một bảng chỉ có ở một phía là “no table”: đây là sự không khớp.

Một cách kiểm tra an toàn hơn là số hàng của tất cả các bảng ở cả hai phía sau khi việc ghi dừng lại (script nằm trong hqbird2027-linux-cluster-runbook.md). Trong lần chạy, tất cả 11 bảng đều khớp (employee.fdb: 10, bulk.fdb: 1, với 2.800.000 hàng).

Việc kiểm tra định kỳ (Data check) mặc định tắt. Nhấp Turn on for all nodes và xác nhận: mỗi node đếm số hàng của nó, và master so sánh các số đếm. Bạn không cần khởi động lại: RCM hiển thị “Saved and in force now: the node needs no restart.” Lần kiểm tra đầu tiên chạy sau một khoảng thời gian (mặc định 2 giờ).

Periodic check
Periodic check

Những gì cần theo dõi tiếp theo

  • Overview: các node, trạng thái của chúng, thư mục gốc của cơ sở dữ liệu, và dung lượng đĩa.

    Overview
    Overview
  • Alerts: các vấn đề của node và cơ sở dữ liệu. Lần chạy có hai cảnh báo, và bạn có thể xác nhận cả hai: replication_conflict_resolved sau lần reinit smooth (bước 7), và parse_no_observations trên master (“no events parsed from /opt/firebird/replication.log”). Firebird của master chỉ ghi lỗi vào replication.log, nên một log trống là bình thường (phát hiện G-06 trong báo cáo).

    Alerts
    Alerts

    RCM 2027.5.12 và mới hơn (kit 2027.2.33) có thể gửi các cảnh báo có mức độ warn và cao hơn tới một bot Telegram của riêng bạn, một webhook hoặc e-mail. Bạn đặt các kênh trong tệp /opt/hqbirdrcm/rcm.json, khóa notify.channels, và khởi động lại RCM (sudo systemctl restart hqbirdrcm). Khối Notification channels của trang này sau đó liệt kê các kênh, mỗi kênh có một nút Send test. Khi không có kênh nào, nó hiển thị “No channel is configured: RCM sends its alerts nowhere.” Một kênh Telegram:

    json
    "notify": { "channels": [ { "name": "ops", "type": "telegram",
        "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }

    Lần chạy ngày 2026-11-17 đã kiểm tra khối này mà không có kênh nào; không có tin nhắn nào được gửi.

  • Services (RCM 2027.5.11 và mới hơn, các kit từ 2027.2.31): master, các replica và các router của một service, và các thao tác switchover, failover và rejoin. Hướng dẫn này không đề cập đến chúng: xem hướng dẫn sử dụng RCM. Cập nhật RCM và các node lên cùng phiên bản trước khi bạn sử dụng chúng.

  • Commands: mỗi thao tác RCM cùng kết quả của nó. Thời gian là giờ địa phương của trình duyệt với múi giờ của nó (ví dụ, 17:59:45 UTC+1); chú thích hiển thị thời gian theo UTC. Các log của node dùng UTC.

    Commands
    Commands
  • HQ Monitor: http://<server>:23050/, tên người dùng admin, mật khẩu nằm trong /opt/hqbird/conf/access.properties. Nó hiển thị máy chủ và các cơ sở dữ liệu. Trong các kit có agent 3.1.0 và mới hơn, HQ Monitor có trang Clusters. Trên master (máy chủ RCM) nó hiển thị cluster thông qua agent, không có cài đặt RCM nào trong HQ Monitor. Trên replica nó nêu tên máy chủ của RCM và liên kết tới bảng điều khiển của nó. HQ Monitor 1.49.0 không có trạng thái replication và không có liên kết tới RCM. Từ kit 2027.2.33 (agent 3.4.0) agent cũng gửi các vấn đề của máy chủ của nó tới các kênh của bạn: Servers → Notifications.

Cập nhật cluster

Cập nhật HQbird RCM trước, sau đó đến các node. Từ kit 2027.2.31, một máy chủ không gắn với HQCenter nào sẽ tự cập nhật agent, HQ Monitor và fbmcp (“Updates without HQCenter” trong hqbird2027-linux-setup-guide.md); một máy chủ gắn với một HQCenter nhận các bản cập nhật từ HQCenter đó.

Đưa một máy chủ ra khỏi cluster

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

Agent dừng và hủy đăng ký các dịch vụ node của nó, đóng các cổng node của chúng, xóa các chứng chỉ cluster của nó và đặt cluster.source thành none. Thư mục node vẫn còn (--remove-data xóa nó). Agent đang chạy RCM bị từ chối. Agent cũng tự rời đi khi RCM thu hồi nó hoặc lấy đi thành viên cuối cùng của nó. Một lần gỡ cài đặt luôn rời khỏi cluster: một lần cài đặt lại trong cùng thư mục sẽ bắt đầu sạch. Trong lần chạy ngày 2026-11-17, lệnh in ra Cluster: left <cluster id>, các cơ sở dữ liệu replica vẫn ở trong thư mục của chúng, và RCM vẫn hiển thị node của máy chủ đó một phút sau đó. Việc gỡ bỏ HQbird khỏi một máy chủ cluster, cũng như khỏi máy chủ đang chạy RCM: hqbird2027-removal-guide.md, mục 4.

Các lỗi thường gặp

Những gì bạn thấy Nguyên nhân Việc cần làm
publication_off khi khởi tạo publication bị tắt, hoặc nó không có bảng nào mặc dù cơ sở dữ liệu có các bảng có khóa nút Sync publication and initialize (bước 6)
long_transactions … the archive holds no segment yet lần khởi tạo đầu tiên với phương thức smooth trong khi cơ sở dữ liệu đang được ghi, và kho lưu trữ của master trống chờ “archive: 1 seg” và thử lại Smooth, hoặc chọn Standard
reinit_pre_publication_transactions một giao dịch ghi bắt đầu trước khi publication được bật và đang mở lâu hơn một phút hoàn tất nó (COMMIT hoặc ROLLBACK) và thử lại
“✗ The folder does not exist on …” trong hộp thoại không ai tạo thư mục replica nút Create folder trong hộp thoại, hoặc install -d -o firebird -g firebird -m 0770 <folder> trên replica
“Not ok (desynced)” trong Verify cơ sở dữ liệu đang được ghi, và replica chậm vài giây thử lại không có tải; xem cột Match
“Not ok (desynced)” trong Verify không có ghi; cả hai phía hiển thị “Ok” một kết nối ứng dụng được mở trước khi publication được bật: nó không được ghi vào journal kết nối lại ứng dụng, sau đó Reinit (bước 6, ghi chú về lần đồng bộ publication đầu tiên)

| Máy chủ “không thể truy cập” hoặc “không có agent” trong Link hosts | cửa sổ ghép nối của máy chủ đã đóng (mặc định tắt, hoặc đã hết 24 giờ), hoặc tường lửa giữa các máy chủ chặn cổng 7450–7459 | mở cửa sổ trên máy chủ: HQ Monitor → Clusters → Open the pairing window for 24 hours, hoặc fbagent --cluster-pairing on; mở cổng trong tường lửa đám mây | | insufficient disk space on replica khi reinit | bản sao cũ vẫn tồn tại đến cuối, và tệp mới chiếm toàn bộ kích thước của nó | giải phóng ≥ 105 % kích thước cơ sở dữ liệu + 1 GB vượt quá tệp cũ trên ổ đĩa của bản sao, hoặc hộp Remove the old replica if space is short (bước 8) | | Nút không xuất hiện sau Link hosts | bản sao RCM không có bản phát hành hqclusternode đã ký | Releases in the mirror trên trang Link hosts (bước 2) |