Cụm HQbird 2027 trên Linux: master và replica với RCM
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
.deltaphá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ànlimits.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ủ:
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.runTrong 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.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # replicaViệ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):
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:
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 hostMộ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:
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 # replicaTrong 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:
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ỉ.
Tên người dùng là rcmadmin. Mật khẩu nằm trong tệp từ dòng Password:
:
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM yêu cầu một mật khẩu mới ngay lập tức (ít nhất 12 ký tự):
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:
# 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.
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.
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.
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:
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).
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”.
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:
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.fdbBạ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.
Preview → chọn các cơ sở dữ liệu → Enroll selected và xác nhận.
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.
Các cơ sở dữ liệu 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.
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”.
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?”.
- 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:
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.
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.
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ó:
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á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.
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.
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.
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).
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.
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áoreplica_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 RCMauto_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:
Không có ghi, các số đếm khớp nhau:
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ờ).
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 -
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_resolvedsau lần reinit smooth (bước 7), vàparse_no_observationstrên master (“no events parsed from /opt/firebird/replication.log”). Firebird của master chỉ ghi lỗi vàoreplication.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 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 độ
warnvà 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óanotify.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:"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 -
HQ Monitor:
http://<server>:23050/, tên người dùngadmin, 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
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leaveAgent 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) |