Hướng dẫn quản trị cụm sao chép HQbird: hqclusternode và hqbirdrcm (RCM). Bộ cài: Tải HQbird 2027.

Mục lục


0. Giới thiệu

Hướng dẫn này mô tả cách cài đặt và dùng cụm sao chép HQbird: các nút hqclusternode và trình quản lý cụm hqbirdrcm (RCM).

Đây là hướng dẫn cho quản trị viên Firebird. Chúng tôi giả định bạn biết Firebird, gfix và nbackup. Bạn không cần biết cách một nút hoạt động bên trong.

Cụm gồm những gì

Thành phần Bao nhiêu Chạy ở đâu Làm gì
Firebird (HQbird) một hoặc nhiều phiên bản trên mỗi máy chủ cơ sở dữ liệu lưu cơ sở dữ liệu, ghi các phân đoạn sao chép
fbagent một cho mỗi phiên bản Firebird cạnh Firebird dừng và khởi động Firebird theo yêu cầu của một nút
hqclusternode (nút) một cho mỗi phiên bản và vai trò cạnh Firebird cấu hình sao chép, chuyển phân đoạn, thực hiện khởi tạo bản sao
hqbirdrcm (RCM) một cho mỗi cụm trên bất kỳ máy chủ nào nhìn thấy mọi nút giao diện web, lệnh, cảnh báo, thống kê

Một nút có một vai trò: master (chính) hoặc replica (bản sao). Trên một phiên bản Firebird có thể chạy hai nút: nút chính và nút bản sao. Khi đó một số cơ sở dữ liệu của Firebird này là chính, số khác là bản sao.

Cách hoạt động

  1. Ở phía chính, Firebird ghi các thay đổi của cơ sở dữ liệu vào phân đoạn (tệp nhật ký sao chép).
  2. Nút chính gửi các phân đoạn tới nút bản sao qua một kênh được bảo vệ (mTLS).
  3. Nút bản sao đặt các phân đoạn vào thư mục phân đoạn đến. Firebird của bản sao áp dụng chúng vào bản sao cơ sở dữ liệu của mình.
  4. Chính nút chính chuyển bản sao đầu tiên của cơ sở dữ liệu sang bản sao. Việc này gọi là khởi tạo (reinit). Nó đi qua nbackup, và phía chính vẫn chạy trong lúc đó.
  5. Các nút gửi thống kê tới RCM. RCM cho thấy trạng thái của cụm và gửi lệnh của người vận hành tới các nút.
Cụm hoạt động thế nào: phân đoạn, khởi tạo, thống kê và lệnh của người vận hành
Cụm hoạt động thế nào: phân đoạn, khởi tạo, thống kê và lệnh của người vận hành

Các phiên bản được hỗ trợ

  • Firebird / HQbird 5.0 và 4.0 — mọi tính năng.
  • HQbird 3.0 và 2.5 — sao chép qua plugin replconf. Không có công bố; tập bảng do các bộ lọc xác định. Các khác biệt được mô tả trong các khung „HQbird 2.5/3.0“.

Phiên bản chính của Firebird ở phía chính và ở bản sao phải khớp nhau. Nếu không, nút bản sao sẽ từ chối khởi tạo.

Cổng

Cổng Ai lắng nghe Ai kết nối Để làm gì
7051 nút các nút khác và RCM API của nút, chuyển phân đoạn và bản sao cơ sở dữ liệu
7443 RCM mọi nút nhận thống kê từ các nút
7444 RCM người vận hành giao diện web và API người vận hành. Cài qua RCM (chương 1.3): HTTPS trên mọi địa chỉ. Cài qua HQCenter Admin hoặc thủ công: HTTP, chỉ 127.0.0.1
7450–7459 fbagent, khi cửa sổ liên kết đang mở RCM liên kết máy chủ (chương 1.3)
13050 fbagent, chỉ 127.0.0.1 nút trên cùng máy chủ quản lý Firebird
3050 Firebird các ứng dụng vận hành cơ sở dữ liệu bình thường

Nếu có hai nút trên một máy chủ (chính và bản sao), nút thứ hai có cổng khác. Khi cài qua RCM, nút thứ hai nhận cổng 7061. Trong các trường hợp khác bạn tự đặt cổng, ví dụ 7052.

Cổng 13050 không được mở ra mạng. Cổng 7444 với HTTP (cài qua HQCenter Admin hoặc thủ công) cũng vậy: hãy kết nối tới giao diện web RCM qua một đường hầm SSH (chương 1). Khi cài qua RCM, cổng 7444 chạy trên HTTPS, và bộ cài mở nó trong tường lửa.

Quy tắc chính: không có fbagent thì không có thay đổi

Một nút chỉ đổi cấu hình sao chép qua fbagent: nó cần khởi động lại Firebird. Nếu fbagent không sẵn sàng, nút từ chối mọi hành động làm đổi cấu hình. Nó không làm việc „một phần“.

Thuật ngữ

Thuật ngữ Nghĩa
Phân đoạn một tệp nhật ký sao chép chứa các thay đổi của cơ sở dữ liệu
Công bố danh sách các bảng phía chính mà thay đổi của chúng đi vào phân đoạn (Firebird 4/5)
Khởi tạo (reinit) chuyển một bản sao cơ sở dữ liệu từ phía chính sang bản sao qua nbackup
GUID cơ sở dữ liệu định danh cơ sở dữ liệu Firebird; RCM dùng nó để nối phía chính và bản sao
Đối tác nút đối tác: với phía chính, đó là các bản sao của nó
Đồng hành nút thứ hai trên cùng phiên bản Firebird (chính và bản sao trên một máy chủ)
Đăng ký ghi các cơ sở dữ liệu phía chính vào nút

Cách đọc hướng dẫn

Chương Chủ đề
1. Cài đặt cài các nút và RCM qua HQCenter Admin, qua RCM không có HQCenter Admin và thủ công, Linux và Windows
2. Cấu hình cụm các liên kết chính → bản sao, cài đặt nút, người dùng RCM
3. Thêm cơ sở dữ liệu vào phía chính đăng ký, khởi động lại Firebird, kiểm tra
4. Cách biến một cơ sở dữ liệu thành bản sao các giai đoạn, chuẩn bị bản sao, chỗ trên đĩa
5. Khởi tạo các bước reinit, ảnh hưởng tới vận hành, giao dịch dài, tốc độ, lỗi
6. Cấu hình công bố công bố Firebird 4/5, bảng, bảng mới, HQbird 2.5/3.0
7. Các tùy chọn sao chép khác tham số replication.conf, kho lưu, truyền, cảnh báo, tạm dừng, nhật ký
8. Chuyển bản sao thành cơ sở dữ liệu thường Đặt thành thường, Thăng cấp thành chính, GUID mới, dịch vụ (chuyển đổi, chuyển dự phòng), danh sách kiểm tra chuyển đổi

Mọi chương dùng một ví dụ:

Cái gì Giá trị
node-a nút chính, cơ sở dữ liệu trong /databases/master
node-b nút bản sao, cơ sở dữ liệu trong /databases/replica
RCM một máy chủ riêng (cũng có thể là một trong các máy chủ cơ sở dữ liệu)
cơ sở dữ liệu employee.fdb

1. Cài đặt các nút và hqbirdrcm

Có ba cách cài:

Cách Khi nào chọn Bạn tự làm gì
Qua HQCenter Admin (1.2) đường thông thường: máy chủ cập nhật HQCenter Admin truy cập được, cần cập nhật tự động bạn chạy tập lệnh cài fbagent, duyệt yêu cầu, mô tả cụm
Qua RCM, không có HQCenter Admin (1.3) không có HQCenter Admin, nhưng cần chứng chỉ, cấu hình và cập nhật mà không làm tay; tối đa 3 máy chủ cơ sở dữ liệu bạn cài HQbird trên mỗi máy chủ, đăng nhập RCM, và trong Cài đặt → Liên kết máy chủ ghi địa chỉ các máy chủ
Thủ công (1.4) không truy cập HQCenter Admin, mạng kín, yêu cầu đặc biệt bạn cài các tệp, tạo chứng chỉ, viết node.json và rcm.json, đăng ký dịch vụ

Qua HQCenter Admin và qua RCM bạn không tự cài các nút và RCM. fbagent cài chúng khi bạn thêm nó vào cụm (chương 2). Chứng chỉ và cấu hình cũng được tạo tự động.

Linux và Windows được mô tả trong một chương. Các khác biệt của Windows nằm trong các khung „Trên Windows“.

1.1. Yêu cầu

Trên mỗi máy chủ cơ sở dữ liệu:

  • Firebird / HQbird 5.0, 4.0, 3.0 hoặc 2.5 (2.5 — chỉ Linux).
  • fbagent cạnh mỗi phiên bản Firebird. Không có fbagent thì nút không chạy.
  • Đồng bộ giờ (NTP, chrony, w32time) trên mọi máy chủ và trên máy chủ RCM. Cửa sổ khởi động lại và truyền, ước lượng độ trễ và kiểm tra „nút không phản hồi“ phụ thuộc vào đồng hồ.
  • Chỗ trống cho kho phân đoạn và cho khởi tạo bản sao (chương 4).
  • Mạng theo bảng cổng (chương 0).

Linux: quyền root, x86_64, systemd, curl. Được hỗ trợ: Ubuntu 20–26, Debian 11–13, Astra, CentOS 7–10, AlmaLinux, Rocky, Oracle Linux 8–10, RED OS, openSUSE 15.6, Fedora 44+.

Windows: quyền quản trị, x64, Windows 10 / Server 2016 hoặc mới hơn, Windows PowerShell 5.1 64 bit. Trên Windows 10 và Server 2016–2022 cần 7-Zip.

RCM sẽ chạy ở đâu. Mỗi cụm cần một RCM. Có thể cài trên bất kỳ máy chủ nào nhìn thấy mọi nút, kể cả trên một máy chủ cơ sở dữ liệu.

1.2. Cài qua HQCenter Admin

Bước 1. Chạy tập lệnh cài fbagent

Tập lệnh cài Firebird (bản dựng HQbird), fbagent, và đăng ký fbagent trên máy chủ HQCenter Admin. Chọn tập lệnh khớp phiên bản Firebird: fb25, fb30, fb40, fb50.

Linux (với tư cách root):

Command
sudo sh fbagent-fb50_known.sh --goafts <HQCenter-Admin-server> --enroll --cluster

Trên Windows (PowerShell với tư cách quản trị viên):

Command
powershell -NoProfile -ExecutionPolicy Bypass -File .\fbagent-fb50_known.ps1 -Enroll

Trên Windows không có tham số -Cluster: fbagent chạy với tư cách LocalSystem và tự tạo các thư mục cụm.

Các tham số chính:

Linux Windows Nghĩa
--goafts <name> -Goafts máy chủ HQCenter Admin để tải về; tên do nhà cung cấp đưa
--enroll -Enroll đăng ký fbagent trong HQCenter Admin (yêu cầu chứng chỉ)
--cluster — tạo các thư mục /opt/hqclusternode và /opt/hqbirdrcm (chỉ cần cho fbagent 2.55.2 và cũ hơn; vô hại với phiên bản mới hơn)
--channel -Channel kênh cập nhật fbagent, mặc định stable
--token -Token mã giấy phép: HQCenter Admin sẽ duyệt yêu cầu tự động
--port -Port cổng Firebird
--yes -Yes không hỏi (cần khi không có thiết bị đầu cuối)

Danh sách đầy đủ tham số nằm trong README của tập lệnh cài fbagent.

Bước 2. Duyệt yêu cầu fbagent

Với tham số --enroll, fbagent gửi một yêu cầu chứng chỉ (CSR) tới HQCenter Admin và chờ duyệt tối đa 30 phút. Bạn có thể duyệt như sau:

  • tự động — nếu cài được chạy với mã giấy phép (--token) và giấy phép còn chỗ trống;
  • trong bảng HQCenter Admin — mục yêu cầu CSR, yêu cầu của máy chủ này, nút duyệt và ký;
  • qua API HQCenter Admin — POST /v1/admin/csr-requests/{id}/approve.

Nếu đăng ký không thành (ví dụ hết thời gian chờ), fbagent vẫn chạy, nhưng tập lệnh thoát với mã 2. Chạy lại tập lệnh với cùng tham số: chỉ phần đăng ký được lặp lại.

Vài phút sau khi đăng ký, fbagent tự cài HQ Monitor.

Bước 3. Mô tả cụm

Các nút và RCM xuất hiện khi bạn thêm fbagent vào cụm HQCenter Admin. Cách mô tả cụm nằm ở chương 2.

Sau khi lưu cụm:

  1. Trong 10 phút fbagent nhận cụm từ HQCenter Admin (sau đó nó kiểm tra thay đổi mỗi 60 giây).
  2. fbagent trên máy chủ RCM tạo cơ quan chứng chỉ của cụm (CA) và ký chứng chỉ của mọi nút.
  3. Mỗi fbagent viết node.json hoặc rcm.json cho các thành viên cụm của nó.
  4. Ở lần kiểm tra sản phẩm tiếp theo (mỗi 3 phút) fbagent cài và khởi động các dịch vụ.

Cài cái gì và ở đâu:

Cái gì Linux Windows
Nút chính /opt/hqclusternode/master/, dịch vụ hqclusternode-master-p<port> <HQbird>\hqclusternode\master\, dịch vụ HQClusterNode-master-p<port>
Nút bản sao /opt/hqclusternode/replica/, dịch vụ hqclusternode-replica-p<port> <HQbird>\hqclusternode\replica\, dịch vụ HQClusterNode-replica-p<port>
RCM /opt/hqbirdrcm/, dịch vụ hqbirdrcm <HQbird>\hqbirdrcm\, dịch vụ hqbirdrcm

<port> là cổng Firebird, ví dụ 3050. Một fbagent chứa không quá một nút chính, một nút bản sao, một RCM và một bộ định tuyến (hqclusternode router, từ HQbird 2027.2.30, chương 8.7).

Trên Windows. Các phiên bản fbagent trước 2.83.0 cài các nút trong C:\hqclusternode và RCM trong C:\hqbirdrcm. Nếu các thư mục này tồn tại, fbagent tiếp tục dùng chúng.

Cập nhật

  • fbagent kiểm tra phiên bản mới của nút và RCM mỗi 3 phút; kênh mặc định là stable. Nút bản sao được cập nhật trước, rồi tới nút chính.
  • Nếu sau cập nhật dịch vụ không khởi động được hoặc báo sai phiên bản, fbagent quay về phiên bản trước và chặn phiên bản mới. Danh sách chặn: <fbagent folder>/update/<product>/blocked-versions.json. Để thử phiên bản lần nữa, xóa dòng của nó khỏi tệp này.
  • Trạng thái sản phẩm: fbagent --product-status hqclusternode (hoặc hqbirdrcm).

1.3. Cài qua RCM (không có HQCenter Admin)

Cụm do RCM quản lý. fbagent của mỗi máy chủ nhận mô tả cụm từ RCM, fbagent trên máy chủ RCM ký chứng chỉ, còn nút và RCM được cập nhật từ các bản phát hành do RCM lưu.

Giới hạn:

  • Một cụm cho mỗi RCM.
  • Không quá 3 chỗ. Một chỗ là máy chủ chạy nút chính hoặc nút bản sao. Chính và bản sao trên cùng máy chủ tính là một chỗ. Máy chủ chỉ chạy RCM không chiếm chỗ. Máy chủ thứ tư sinh lỗi seats_exceeded.
  • RCM không cập nhật fbagent hay Firebird. fbagent tự cập nhật chúng và không đụng replication.conf, node.json, rcm.json hay chứng chỉ.

Có hai cách:

  • Liên kết máy chủ trong RCM — cách thông thường. Ba việc: bộ cài trên mỗi máy chủ (RCM trên một máy chủ, chế độ khám phá trên các máy còn lại), đăng nhập RCM, biểu mẫu Liên kết máy chủ.
  • Thủ công từ dòng lệnh — mã tham gia và fbagent --cluster-join. Cần khi cổng 7450 đóng giữa các máy chủ hoặc cửa sổ ghép cặp đã đóng.

Giấy phép. Giấy phép dùng thử gồm tính năng cluster. Sau thời gian dùng thử, fbagent không cài nút hoặc RCM nếu giấy phép thiếu cluster. Nó không bao giờ chặn cập nhật của nút và RCM đã cài. Không có HQCenter Admin, giấy phép nổi ngừng hoạt động sau online_check_days cộng các ngày gia hạn. Vì vậy hãy cài giấy phép gắn trên mỗi fbagent:

Command
fbagent --license-request --out license_request.json
# send the file to the vendor and receive license.json
fbagent --license-install license.json

Không có giấy phép, phía chính ngừng gửi phân đoạn (chương 2.8).

Cổng:

Cổng Ở đâu Ai kết nối
7443 máy chủ RCM fbagent và các nút của mọi máy chủ cụm
7444 máy chủ RCM trình duyệt của người vận hành (bảng điều khiển RCM, HTTPS)
7450 (trên máy chủ fbagent thứ hai và tiếp theo — 7451…7459) máy chủ ở chế độ khám phá, khi cửa sổ ghép cặp đang mở RCM trên máy chủ RCM
7051 (nút thứ hai của cùng fbagent — 7061) các máy chủ nút các nút khác và RCM (1.4, bước 7)

Liên kết máy chủ trong RCM

Ví dụ từ đầu. Hai máy chủ Linux, bộ cài .run, liên kết, đăng ký, công bố, khởi tạo và khởi tạo lại dưới tải — với ảnh chụp màn hình và số đo: hướng dẫn hqbird2027-linux-cluster-guide.ru.md và sổ thao tác hqbird2027-linux-cluster-runbook.ru.md (kho goafts, thư mục tài liệu).

Bước 1. Cài HQbird trên mỗi máy chủ

Cài HQbird bằng bộ cài đầy đủ trên mỗi máy chủ cơ sở dữ liệu. Đừng đăng ký với HQCenter Admin (--enroll).

Mặc định bộ cài không cấu hình cụm. Nó đặt các chương trình nút và RCM vào thư mục fbagent (update/<product>/staged/), nhưng không cài RCM, không mở cửa sổ ghép cặp và không mở các cổng cụm trong tường lửa. Cụm được bật bằng hai tham số:

Command
sudo sh hqbird2027-fb50-linux-<version>.run --rcm on               # RCM host
sudo sh hqbird2027-fb50-linux-<version>.run --cluster-pairing on   # other hosts

--rcm on — trên một máy chủ, nơi RCM của cụm sẽ chạy. Bộ cài:

  1. tạo cụm của máy chủ này (fbagent --cluster-init), tên cụm là tên máy chủ;
  2. cài và khởi động RCM, bảng điều khiển RCM chạy trên HTTPS ở cổng 7444;
  3. tạo quản trị viên RCM đầu tiên rcmadmin với mật khẩu ngẫu nhiên;
  4. mở các cổng 7443, 7444 và cổng nút 7051 trong tường lửa.

--cluster-pairing on (chế độ khám phá) — trên mỗi máy chủ còn lại. Bộ cài mở cửa sổ ghép cặp của fbagent trong 24 giờ: cổng 7450 và cổng nút 7051. Khi cửa sổ mở, một RCM từ mạng có thể mời máy chủ này vào cụm của nó. fbagent bắt đầu lắng nghe cổng 7450 trong vòng một phút.

Không có các tham số này, bộ cài tự hỏi: trong giao diện văn bản đó là trang Cụm, với --no-tui — hai câu hỏi. Câu trả lời mặc định là „không“. --yes không có tham số cụm cũng trả lời „không“ cho cả hai câu hỏi.

Cuối cùng bộ cài in các dòng RCM: và Pairing:. Trên máy chủ RCM:

text
RCM:        https://10.0.0.7:7444 (cluster db1)
CA hash:    sha256:7cfc1d4b…032d2582
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/db1/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

Trên máy chủ khác:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-17T17:49:18Z (fingerprint sha256:0439e44a…91a2f9b9); an RCM may invite this host

Đầu ra không có mật khẩu: nó nằm trong tệp từ dòng Password:. Ghi lại fingerprint của mỗi máy chủ ở chế độ khám phá.

Tham số cụm trong bộ cài Linux:

Tham số Nó làm gì
--rcm on|off cài RCM và tạo cụm trên máy chủ này; mặc định off
--cluster-pairing on|off chế độ khám phá: mở cửa sổ ghép cặp 24 giờ; mặc định off
--pairing-port N cổng ghép cặp của fbagent mới, 7450–7459; mặc định cổng trống đầu tiên
--rcm-password-file F mật khẩu quản trị RCM từ dòng đầu của tệp F, thay cho ngẫu nhiên
--cluster-id ID tên cụm ID thay cho tên máy chủ (với --rcm on)
--cluster-node on|off cài chương trình nút; mặc định on
--rcm-allow A,B chỉ các RCM này được mời máy chủ này: địa chỉ, mạng CIDR hoặc tên

fbagent đầu tiên trên một máy chủ nhận cổng ghép cặp 7450 và các cổng nút 7051 và 7061. Phiên bản thứ hai trên cùng máy chủ — 7451, 7052 và 7062.

RCM và cửa sổ ghép cặp có thể bật sau, không cần bộ cài: trong HQ Monitor, trang Các cụm, hoặc bằng lệnh với tư cách người dùng fbagent:

Command
cd <fbagent folder>                                    # /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init <name>      # RCM host; open ports 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on      # window for 24 hours
sudo -u firebird ./fbagent --cluster-pairing off
sudo -u firebird ./fbagent --cluster-pairing status

Bộ cài cũ (fbagent trước 3.1.0) không hỏi về cụm: chúng cài RCM trên mọi máy chủ và mở cửa sổ ghép cặp khắp nơi. Bạn cần RCM của một máy chủ; RCM của các máy chủ khác tự dừng sau khi liên kết.

Trên Windows. Bộ cài Windows có cùng hai lựa chọn: các tham số /RCM và /DISCOVERY.

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

Mở địa chỉ từ dòng RCM: của máy chủ RCM (https://<host>:7444). Đăng nhập bằng tên rcmadmin và mật khẩu từ tệp ở dòng Password:. RCM lập tức yêu cầu mật khẩu mới (1.5).

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

Trong RCM mở Cài đặt → Liên kết máy chủ.

  1. Trong trường Máy chủ nhập địa chỉ hoặc tên các máy chủ, mỗi dòng một cái. Dòng đầu là máy chủ RCM, nó đã ở trong cụm.
  2. Bấm Kiểm tra máy chủ. RCM dò các cổng ghép cặp 7450–7459 của mỗi máy chủ và hiện nền tảng, phiên bản Firebird, dấu vân tay và trạng thái. Máy chủ RCM không cần cửa sổ ghép cặp. So dấu vân tay với đầu ra bộ cài (dòng Pairing:).
  3. Chọn Chính (mặc định máy chủ đầu tiên) và bấm Liên kết.
Liên kết máy chủ: kết quả kiểm tra
Liên kết máy chủ: kết quả kiểm tra

RCM xin xác nhận và hiện tiến độ trong mục Tiến trình. Khi mọi nút đang chạy, nó nói „Xong“ và hiện số sửa đổi của cụm:

Liên kết máy chủ: mọi nút đang chạy
Liên kết máy chủ: mọi nút đang chạy

Tương tự từ dòng lệnh:

Command
cd /opt/hqbirdrcm
export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
./hqbirdrcm cluster link -hosts db1,db2,db3 -master db1

Chuyện gì xảy ra tiếp:

  1. RCM gửi lời mời tới mỗi máy chủ còn trống.
  2. fbagent của máy chủ tham gia cụm và đóng cổng ghép cặp. Nếu máy chủ có RCM riêng không có nút, fbagent dừng và tắt nó, rồi chuyển cụm rỗng của nó vào cluster/left/ trong thư mục fbagent.
  3. RCM lưu cụm: nút <host>-master trên phía chính, <host>-replica trên các máy chủ còn lại, cổng 7051, các liên kết chính → bản sao.
  4. fbagent của mỗi máy chủ cài và khởi động nút. RCM chờ đến khi mọi nút đang chạy và hiện Đang chạy cho mỗi máy chủ.

Trạng thái máy chủ sau Kiểm tra máy chủ:

Trạng thái Việc cần làm
Sẵn sàng liên kết không có gì. Nếu bên dưới nói „RCM riêng của máy chủ này sẽ dừng sau khi liên kết“ — đó là bình thường
Trong cụm máy chủ đã ở trong cụm này
Lỗi unreachable cổng 7450 đóng: cửa sổ ghép cặp tắt (như mặc định) hoặc đã qua 24 giờ. Ngay sau khi cài hãy đợi một phút rồi bấm lại Kiểm tra máy chủ. Nếu không, hãy mở cửa sổ (--cluster-pairing on) và kiểm tra tường lửa
Lỗi in_other_cluster máy chủ đang ở cụm khác
Lỗi claimed một RCM khác đang liên kết máy chủ này ngay lúc này
Lỗi seats_exceeded hơn 3 chỗ

Bản phát hành. fbagent chỉ cài nút từ RCM. RCM lấy các bản phát hành đã ký từ thư mục import/ của nó (cạnh rcm.json) lúc khởi động và mỗi 5 phút. Bộ cài đặt các bản phát hành của máy chủ RCM vào đó, và fbagent của các máy chủ khác tự tải bản phát hành cho nền tảng của chúng. Danh sách bản phát hành ở cuối trang Liên kết máy chủ. Một bản phát hành cũng có thể nhập thủ công (bước 5 bên dưới).

Thủ công từ dòng lệnh

Thứ tự: bước 1–3 trên máy chủ RCM, bước 4 trên mỗi máy chủ khác, bước 5–6 trong RCM.

Bước 1. Cài HQbird cùng fbagent

Cài HQbird trên mỗi máy chủ cơ sở dữ liệu và trên máy chủ RCM bằng bộ cài đầy đủ. Trên máy chủ RCM bạn có thể ghi --rcm on ngay (khi đó không cần bước 3). Trên các máy chủ khác đừng ghi tham số cụm: mặc định không có RCM và không có cửa sổ ghép cặp. Đừng đăng ký với HQCenter Admin (--enroll).

Trên máy chủ RCM, bộ cài để chương trình RCM trong thư mục fbagent (update/hqbirdrcm/staged/). Không có nó, bước 3 thất bại với lỗi no hqbirdrcm to install.

Bước 2. Cài giấy phép gắn

Như đầu mục, „Giấy phép“.

Bước 3. Tạo cụm trên máy chủ RCM

Nếu bộ cài đã tạo cụm (--rcm on: một dòng RCM: có địa chỉ trong đầu ra), bỏ qua bước này.

Chạy lệnh với tư cách người dùng fbagent (trên Linux — firebird), không phải root: nếu không, các tệp CA và rcm.json sẽ thuộc về root.

Command
cd <fbagent folder>
sudo -u firebird ./fbagent --cluster-init shop-prod --address 10.0.0.7

Trên Windows (PowerShell với tư cách quản trị viên): .\fbagent.exe --cluster-init shop-prod --address 10.0.0.7

  • shop-prod — tên cụm: chữ Latin thường, chữ số và -.
  • --address — địa chỉ của máy chủ RCM mà các máy chủ khác dùng để kết nối tới nó. Có thể lặp nhiều lần. Không có tham số thì dùng địa chỉ và tên của máy chủ.

Lệnh:

  1. tạo CA của cụm và CA của agent (trong thư mục fbagent, clusterca/<name>/);
  2. viết chứng chỉ RCM, rcm.json và cluster-init.json vào thư mục RCM;
  3. cài RCM và đăng ký dịch vụ hqbirdrcm. Trên Linux dịch vụ chạy với người dùng riêng hqbirdrcm;
  4. chuyển fbagent sang RCM (cluster.source = rcm) và khởi động lại nó;
  5. in địa chỉ RCM và dấu vân tay CA:
Code
Cluster:    shop-prod
RCM URL:    https://10.0.0.7:7443
CA hash:    sha256:9f86d0...

Ghi lại RCM URL và CA hash: chúng cần trên các máy chủ khác. Chạy lại cho cùng cụm là an toàn: CA và các khóa giữ nguyên.

Đăng nhập RCM ngay và đổi mật khẩu rcmadmin (1.5).

Trên Linux. Người dùng hqbirdrcm nằm trong nhóm fbagent. RCM đọc rcm.json qua nhóm này, nhưng không ghi được. Vì vậy Cài đặt → RCM không lưu thay đổi (lỗi rcm_config_read_only). Sửa rcm.json trên máy chủ với tư cách người dùng fbagent và khởi động lại RCM.

Bước 4. Nối fbagent của các máy chủ khác

  1. Trên máy chủ RCM tạo một mã tham gia cho mỗi fbagent: trong RCM Cài đặt → Cụm, nút Tạo mã tham gia. Hoặc từ dòng lệnh:

    Command
    cd /opt/hqbirdrcm
    export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
    ./hqbirdrcm cluster join-token -note db2

    Mã có hiệu lực 24 giờ, chỉ cho một fbagent và chỉ một lần. RCM hiện nó một lần, cùng với một lệnh làm sẵn.

  2. Trên máy chủ nút chạy lệnh này với tư cách người dùng fbagent:

    Command
    cd <fbagent folder>
    sudo -u firebird ./fbagent --cluster-join https://10.0.0.7:7443 \
      --ca-hash sha256:9f86d0... --token-file token.txt

    Thay cho --token-file bạn có thể dùng --token <token>. Trên Windows — tương tự với .\fbagent.exe trong PowerShell với tư cách quản trị viên.

fbagent kiểm tra CA của RCM theo dấu vân tay. Nếu dấu vân tay không khớp, nó dừng và không ghi gì. Sau đó fbagent nhận chứng chỉ của mình (90 ngày, gia hạn tự động) và khởi động lại. Một fbagent đã nối hiện trong RCM ở bảng Các agent. Khi chưa có thành viên, không có gì được cài trên máy chủ.

Bước 5. Nhập các bản phát hành vào RCM

fbagent lấy nút và RCM chỉ từ RCM. Nếu bản phát hành cần thiết không có trong danh sách Bản phát hành trong gương (Cài đặt → Liên kết máy chủ), hãy nhập mỗi sản phẩm (hqclusternode, hqbirdrcm) cho mỗi nền tảng của các máy chủ (linux-amd64, windows-amd64). Tệp bản phát hành và chữ ký .sig do nhà cung cấp đưa.

Command
cd /opt/hqbirdrcm
sudo -u hqbirdrcm ./hqbirdrcm release import -config rcm.json \
  -file hqclusternode-linux-amd64 -product hqclusternode \
  -platform linux-amd64 -version 2027.5.12
sudo -u hqbirdrcm ./hqbirdrcm release list -config rcm.json
  • RCM tìm chữ ký trong <file>.sig, hoặc chỉ định bằng -sig. Không có chữ ký nhà cung cấp hợp lệ, RCM không nhận tệp.
  • Bản phát hành mới thay bản trước. Không cần khởi động lại RCM.
  • fbagent kiểm tra phiên bản mới mỗi 3 phút. Thứ tự cập nhật và khóa giống như qua HQCenter Admin (1.2, „Cập nhật“).

Bước 6. Mô tả cụm

Đặt thành viên và liên kết trong RCM, Cài đặt → Cụm (chương 2.3). Sau khi lưu, fbagent cài các nút giống như qua HQCenter Admin (1.2, bước 3): nó viết chứng chỉ, node.json và rcm.json, cài và khởi động các dịch vụ.

Cổng — ở đầu mục.

1.4. Cài thủ công

Bước 1. Cài HQbird cùng fbagent

Cài HQbird trên mỗi máy chủ cơ sở dữ liệu (cùng tập lệnh, nhưng không có --enroll, hoặc bằng bộ cài HQbird đầy đủ). Xác nhận fbagent đang chạy.

Ghi ba giá trị từ agent_config.json của fbagent. Chúng cần cho node.json:

Trường fbagent Trường node.json Ví dụ
local_api.listen firebird.fbagent_url http://127.0.0.1:13050
local_api.token firebird.fbagent_token —
local_api.instance_id firebird.instance_id —

Kiểm tra fbagent (phản hồi là JSON của phiên bản Firebird):

Command
curl -s -H "Authorization: Bearer <token>" http://127.0.0.1:13050/v1/instances/<instance_id>

Nếu máy chủ có vài phiên bản HQbird, trong firebird.update.services của cấu hình fbagent chỉ để lại dịch vụ của phiên bản của bạn (xem 3.5).

Bước 2. Bố trí các tệp

Linux:

Code
/opt/hqclusternode/
  hqclusternode        # program
  node.json            # node configuration (permissions 0600)
  certs/               # ca.crt, <node_id>.crt, <node_id>.key
  work/                # working folder
/opt/hqbirdrcm/
  hqbirdrcm            # program
  rcm.json             # cluster configuration
  certs/               # ca.crt, rcm.crt, rcm.key
  rcm-data/            # state, users, audit log
Command
sudo mkdir -p /opt/hqclusternode/certs /opt/hqclusternode/work
sudo install -m 0755 hqclusternode-linux-amd64 /opt/hqclusternode/hqclusternode
# on the RCM host:
sudo mkdir -p /opt/hqbirdrcm/certs /opt/hqbirdrcm/rcm-data
sudo install -m 0755 hqbirdrcm-linux-amd64 /opt/hqbirdrcm/hqbirdrcm

Trên Windows. Thư mục mặc định là C:\hqclusternode với cùng bố cục. Đường dẫn có dấu cách được phép.

Nếu một máy chủ có hai nút (chính và bản sao), hãy cho mỗi nút thư mục riêng, ví dụ /opt/hqclusternode/master và /opt/hqclusternode/replica.

Bước 3. Tạo chứng chỉ

Các nút và RCM chỉ trao đổi qua mTLS. Cần một CA và một chứng chỉ cho mỗi bên tham gia. Chạy việc này một lần trên bất kỳ máy nào:

Command
./hqclusternode gencerts -out certs \
  -nodes 'node-a:master,node-b:replica' \
  -hosts 'localhost,127.0.0.1,<ip-node-a>,<ip-node-b>,<ip-rcm>'

Lệnh tạo ca.crt và ca.key, node-a.crt/.key, node-b.crt/.key và rcm.crt/.key. Trong -hosts, liệt kê mọi tên và địa chỉ mà các bên sẽ được kết nối tới.

gencerts và các tệp nó đã tạo
gencerts và các tệp nó đã tạo

ca.key là khóa CA. Đừng sao chép nó lên các máy chủ; hãy cất riêng.

Một nút mới được thêm sau bằng -add: nó ký cặp bằng cùng CA, và các tệp khác giữ nguyên:

Command
./hqclusternode gencerts -out certs -add -nodes 'node-c:replica' -hosts '<ip-node-c>'

Chứng chỉ có hiệu lực 90 ngày. gencerts -out certs -list hiện ngày hết hạn, và gencerts -out certs -renew gia hạn chúng bằng cùng khóa. Sao chép .crt mới tới máy chủ của nó: nút sẽ nhận mà không cần khởi động lại.

Sao chép ca.crt và chỉ chứng chỉ cùng khóa của chính nó tới mỗi máy chủ.

Bước 4. Viết node.json

Một tệp cho mỗi nút. Ví dụ cho phía chính (node-a):

json
{
  "node_id": "node-a",
  "role": "master",
  "listen_addr": ":7051",
  "rcm": { "url": "https://<ip-rcm>:7443", "ca_cert": "certs/ca.crt",
           "client_cert": "certs/node-a.crt", "client_key": "certs/node-a.key" },
  "firebird": {
    "root": "/opt/firebird",
    "user": "SYSDBA",
    "password": "<SYSDBA password>",
    "port": 3050,
    "replication_conf": "/opt/firebird/replication.conf",
    "replication_log": "/opt/firebird/replication.log",
    "firebird_log": "/opt/firebird/firebird.log",
    "fbagent_url": "http://127.0.0.1:13050",
    "fbagent_token": "<local_api.token>",
    "instance_id": "<local_api.instance_id>",
    "service_name": "<Firebird service name>"
  },
  "windows": { "restart_window": "22:00-05:00", "transfer_window": "23:00-05:00" },
  "peers": [ { "node_id": "node-b", "url": "https://<ip-node-b>:7051", "compress": "zstd" } ]
}

Nút bản sao (node-b) có cùng tệp, nhưng với "role": "replica", chứng chỉ riêng, và phía chính node-a trong peers.

Các trường chính:

Trường Giá trị
node_id tên nút; giống nhau trong chứng chỉ, rcm.json và peers của các nút khác
role master hoặc replica
listen_addr địa chỉ API của nút; nút thứ hai trên cùng máy chủ dùng cổng khác (:7052)
rcm.url địa chỉ để nhận thống kê RCM; none — không có RCM
firebird.* Firebird và fbagent của phiên bản này; các giá trị fbagent phải khớp đúng
firebird.auto_restart nút bản sao có được tự khởi động lại Firebird không: auto (mặc định), never, always
windows.restart_window cửa sổ khởi động lại Firebird; với phía chính mặc định là 22:00-05:00, với bản sao thì luôn
windows.transfer_window cửa sổ mà khởi tạo chạy hết tốc độ
peers với phía chính — các bản sao của nó, với bản sao — phía chính của nó
databases thư mục cơ sở dữ liệu; tốt hơn đừng viết tay mà đặt qua RCM (chương 3)

Các trường còn lại có giá trị mặc định. Nút sẽ không khởi động nếu các trường fbagent chưa được đặt.

Bảo vệ tệp: nó chứa mật khẩu và mã.

Command
chmod 600 /opt/hqclusternode/node.json

Trên Windows. Viết đường dẫn theo định dạng JSON: "C:\\HQbird\\replication.conf". service_name là tên dịch vụ Windows của Firebird.

Bước 5. Viết rcm.json

json
{
  "ingest_addr": "0.0.0.0:7443",
  "operator_addr": "127.0.0.1:7444",
  "users_file": "rcm-data/users.json",
  "data_dir": "./rcm-data",
  "tls": { "ca_cert": "certs/ca.crt", "cert": "certs/rcm.crt", "key": "certs/rcm.key" },
  "nodes": [
    { "node_id": "node-a", "url": "https://<ip-node-a>:7051", "role": "master",  "host": "A" },
    { "node_id": "node-b", "url": "https://<ip-node-b>:7051", "role": "replica", "host": "B" }
  ]
}
  • url — địa chỉ nút như máy chủ RCM nhìn thấy. Chỉ https.
  • host — nhãn phiên bản Firebird. Một nút chính và một nút bản sao cùng nhãn chạy trên cùng Firebird (đồng hành, cần để thăng cấp bản sao thành chính, chương 8). Một nhãn — không quá một phía chính và một bản sao.
  • Đường dẫn tương đối được giải từ thư mục rcm.json.

Bước 6. Đăng ký các dịch vụ

Thứ tự khởi động: RCM trước, rồi các bản sao, rồi phía chính.

RCM (Linux):

Command
cd /opt/hqbirdrcm
sudo ./hqbirdrcm svc install -config /opt/hqbirdrcm/rcm.json
sudo ./hqbirdrcm svc start

Nút (Linux):

Command
cd /opt/hqclusternode
sudo ./hqclusternode svc install -config /opt/hqclusternode/node.json -certs /opt/hqclusternode/certs
sudo ./hqclusternode svc start -config /opt/hqclusternode/node.json
systemctl status hqclusternode-master-p3050

svc install tạo dịch vụ hqclusternode-<role>-p<port> chạy với tư cách người dùng firebird. Nếu thư mục Firebird thuộc root, lệnh cấp cho nhóm firebird quyền ghi (với bit dính) và in mọi thay đổi: nút cần thay replication.conf.

Với svc start, svc stop và svc uninstall, hãy chỉ cùng node.json: tên dịch vụ được suy từ vai trò và cổng Firebird.

Trên Windows (PowerShell với tư cách quản trị viên):

Command
cd C:\hqclusternode
.\hqclusternode.exe svc install -config C:\hqclusternode\node.json -certs C:\hqclusternode\certs

Dịch vụ HQClusterNode-<role>-p<port> chạy với tư cách LocalSystem, tự khởi động và khởi động lại sau lỗi. Dịch vụ nút không phụ thuộc vào dịch vụ Firebird. Nếu nút được cài bằng phiên bản 2027.1.2–2027.1.9, hãy gỡ phụ thuộc một lần: .\hqclusternode.exe svc fix-deps -config C:\hqclusternode\node.json.

svc install và svc start trên Windows
svc install và svc start trên Windows

Bước 7. Mở các cổng

Trên máy chủ nút, cho phép kết nối đến trên 7051 (cổng listen_addr) từ các nút khác và từ RCM. Trên máy chủ RCM, cho phép kết nối đến trên 7443 từ mọi nút. Đừng mở các cổng 7444 và 13050 ra ngoài.

Ví dụ ufw trên máy chủ nút:

Command
sudo ufw allow from <ip-rcm> to any port 7051 proto tcp
sudo ufw allow from <ip-partner-node> to any port 7051 proto tcp

Cập nhật thủ công

Dừng dịch vụ, thay chương trình, khởi động dịch vụ:

Command
sudo systemctl stop hqclusternode-master-p3050
sudo install -m 0755 hqclusternode-linux-amd64 /opt/hqclusternode/hqclusternode
sudo systemctl start hqclusternode-master-p3050

Cấu hình và chứng chỉ không bị việc này đổi.

1.5. Lần đăng nhập đầu vào RCM

Địa chỉ và mật khẩu tùy cách RCM được cài.

RCM được cài thế nào Địa chỉ Tên đăng nhập và mật khẩu
Bằng bộ cài HQbird hoặc fbagent --cluster-init (1.3) https://<RCM host>:7444 từ bất kỳ máy tính nào rcmadmin và mật khẩu bộ cài đã in (hoặc của bạn từ --rcm-password-file)
Qua HQCenter Admin (1.2) hoặc thủ công (1.4) http://127.0.0.1:7444, chỉ trên máy chủ RCM rcmadmin, mật khẩu strong password (có dấu cách)

HTTPS (1.3). Chứng chỉ RCM do CA của cụm ký, trình duyệt không biết CA đó nên cảnh báo. Trên trang đăng nhập RCM hiện dấu vân tay CA. So nó với CA hash mà bộ cài đã in, và nhập CA vào trình duyệt hoặc vào hệ thống như gốc tin cậy: liên kết Tải chứng chỉ CA trên trang đăng nhập (https://<RCM host>:7444/ca.crt, tệp hqcluster-ca.crt). Để RCM chỉ lắng nghe localhost, đặt "operator_addr": "127.0.0.1:7444" trong rcm.json và khởi động lại RCM.

HTTP (1.2, 1.4). Từ máy tính khác, kết nối qua đường hầm SSH:

Command
ssh -L 7444:127.0.0.1:7444 <rcm-host>

Rồi mở http://127.0.0.1:7444 trong trình duyệt.

Trang đăng nhập RCM
Trang đăng nhập RCM

Mật khẩu được sinh. RCM yêu cầu đổi nó ở lần đăng nhập đầu: cho đến khi bạn đổi, các trang khác sẽ không mở. Hãy đổi strong password ngay (liên kết Mật khẩu ở đầu trang).

Đổi mật khẩu ở lần đăng nhập đầu
Đổi mật khẩu ở lần đăng nhập đầu

Ngôn ngữ. Trong danh sách ngôn ngữ ở đầu trang hãy chọn Tiếng Nga (nó cũng có trên trang đăng nhập). Nếu bạn không chọn, ngôn ngữ được lấy từ trình duyệt.

Đổi mật khẩu và người dùng mới

Mỗi người dùng đổi mật khẩu của mình: liên kết Mật khẩu ở đầu trang. Cần mật khẩu hiện tại và mật khẩu mới ít nhất 12 ký tự. Sau khi đổi, các phiên khác của người dùng đó bị đóng.

Nếu bộ cài đã sinh mật khẩu, nó được ghi vào tệp clusterca/<name>/rcm-initial-password trong thư mục fbagent. Sau khi mật khẩu đổi, fbagent tự xóa tệp này. Đừng xóa tệp initial-admin.json trong thư mục RCM: nó chỉ chứa một hàm băm. Nếu tệp người dùng mất và tệp này không có, RCM sẽ tạo người dùng với mật khẩu mặc định.

Người dùng mới. Giao diện không có trang người dùng. Người dùng nằm trong tệp rcm-data/users.json. Mật khẩu được lưu dạng hàm băm HA1: MD5("<name>:hqbirdrcm:<password>").

  1. Tính hàm băm:

    Command
    printf '%s' 'rcmadmin:hqbirdrcm:<new password>' | md5sum
  2. Ghi nó vào trường ha1 của người dùng trong users.json. Để thêm người dùng, thêm một phần tử nữa vào users:

    json
    { "username": "ivanov", "ha1": "<hash>", "algo": "MD5", "created_at": "2026-11-03T00:00:00Z" }
  3. Khởi động lại RCM ngay: nó chỉ đọc tệp lúc khởi động. Khi mật khẩu được đổi trong giao diện, RCM viết lại tệp từ bộ nhớ, và mọi sửa mà nó chưa đọc sẽ mất.

Command
chmod 600 /opt/hqbirdrcm/rcm-data/users.json
sudo systemctl restart hqbirdrcm

Không có trường role, người dùng có mọi quyền. Từ HQbird 2027.2.31 có vai trò "role": "viewer": chỉ xem, mọi yêu cầu sửa nhận 403.

1.6. Cách kiểm tra cài đặt

  • Các dịch vụ nút và RCM đang chạy và không khởi động lại theo vòng lặp: systemctl status hqclusternode-master-p3050, systemctl status hqbirdrcm.

    systemctl status của nút
    systemctl status của nút
systemctl status của RCM
systemctl status của RCM
  • RCM phản hồi (không cần mật khẩu): curl http://127.0.0.1:7444/healthz. Khi cài qua RCM (1.3), bảng điều khiển chạy trên HTTPS: curl -k https://127.0.0.1:7444/healthz.

  • Trong RCM, trang Tổng quan hiện mọi nút, không có dấu „không phản hồi“.

  • Từ dòng lệnh trên máy chủ RCM:

    Command
    export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
    ./hqbirdrcm nodes
    ./hqbirdrcm status
  • Cụm qua RCM: Cài đặt → Cụm, mục Trạng thái — mỗi thành viên đã áp dụng bản sửa mới nhất và không báo lỗi. Từ dòng lệnh: ./hqbirdrcm cluster status.

1.7. Nhật ký

Cái gì Ở đâu
Nhật ký nút <node.json folder>/logs/node-YYYYMMDD.jsonl
Đầu ra dịch vụ nút (Linux) journalctl -u hqclusternode-<role>-p<port>
Đầu ra dịch vụ RCM (Linux) journalctl -u hqbirdrcm
Nhật ký sao chép Firebird firebird.replication_log từ node.json
Nhật ký từ bất kỳ nút nào không cần SSH RCM, trang Nhật ký

1.8. Lỗi thường gặp

Bạn thấy gì Nguyên nhân Việc cần làm
Nút không khởi động: lỗi về fbagent_url, fbagent_token hoặc instance_id fbagent không chạy hoặc các giá trị không khớp agent_config.json kiểm tra fbagent bằng lệnh curl ở 1.4, bước 1
Tập lệnh cài thoát với mã 2 yêu cầu fbagent không được duyệt kịp duyệt yêu cầu và chạy lại tập lệnh
Các nút không xuất hiện qua HQCenter Admin fbagent không ở trong cụm, hoặc cụm chưa được nhận kiểm tra cụm (chương 2), đợi tối đa 10 phút
Nút trong RCM „không phản hồi“ cổng 7051 đóng, url trong rcm.json sai, địa chỉ không có trong chứng chỉ kiểm tra các cổng và -hosts của chứng chỉ
Không đăng nhập được RCM: „Quá nhiều lần đăng nhập thất bại“ 10 lần đăng nhập thất bại trong 5 phút đợi vài phút
Phiên bản mới sẽ không cài phiên bản nằm trong blocked-versions.json xóa dòng phiên bản khỏi tệp
--cluster-init: no hqbirdrcm to install bộ cài không để lại chương trình RCM cài HQbird bằng bộ cài đầy đủ (1.3, „Thủ công“, bước 1)
--cluster-join: token_used, token_expired, token_revoked mã đã được dùng, cũ hơn 24 giờ, hoặc đã bị thu hồi tạo mã mới (1.3, „Thủ công“, bước 4)
--cluster-join: hostname_conflict cụm có một fbagent cùng tên máy chủ và địa chỉ khác đặt tên khác cho các máy chủ
--cluster-join: this agent is in cluster … from goafts fbagent đã ở trong cụm HQCenter Admin gỡ nó khỏi cụm HQCenter Admin
Nút sẽ không cài qua RCM RCM không có bản phát hành cho nền tảng này hqbirdrcm release list, nhập bản phát hành (1.3, „Thủ công“, bước 5)

2. Cấu hình cụm

Trong chương này bạn xác định nút nào ở trong cụm và phía chính nào gửi phân đoạn tới bản sao nào. Rồi bạn cấu hình các nút RCM và người dùng.

Quan hệ được xác định theo một trong ba cách:

Nút được cài Quan hệ được xác định ở đâu Mục
qua HQCenter Admin trong HQCenter Admin: trang Các cụm của HQ Monitor hoặc API HQCenter Admin 2.2
qua RCM, không có HQCenter Admin trong RCM: Cài đặt → Cụm, hqbirdrcm cluster hoặc trang Các cụm của HQ Monitor 2.3
thủ công trong RCM: Cài đặt → RCM và Cài đặt → Các nút 2.3

Trên các nút cài qua HQCenter Admin hoặc qua RCM, hãy đổi quan hệ chỉ trong mô tả cụm. fbagent ghi đè node.json và rcm.json theo mô tả cụm. Sửa quan hệ trong Cài đặt → RCM hoặc Cài đặt → Các nút của RCM bị từ chối (409 cluster_managed). Các phiên bản RCM trước chấp nhận, nhưng nó bị mất.

2.1. Vai trò và sơ đồ

Mỗi nút có một vai trò: chính hoặc bản sao. Hai nút — một phía chính và một bản sao — có thể chạy trên một phiên bản Firebird.

Các sơ đồ được hỗ trợ:

Code
1 → 1        node-a (master) ──▶ node-b (replica)

1 → N        node-a ──▶ node-b
                    └─▶ node-c

N → 1        node-a ──┐
                      ├─▶ node-b    (one replica for several masters)
             node-x ──┘

Both nodes   host-1: node-1m (master) + node-1r (replica)  ← one Firebird
on a host    host-2: node-2m (master) + node-2r (replica)  ← one Firebird
             node-1m ──▶ node-2r,  node-2m ──▶ node-1r

Liên kết luôn đi từ phía chính tới bản sao. RCM nối cơ sở dữ liệu phía chính với bản sao của nó theo GUID cơ sở dữ liệu, không theo tên nút.

Đồng hành. Một nút chính và một nút bản sao trên cùng phiên bản Firebird là đồng hành. Việc thăng cấp bản sao thành chính (chương 8) chỉ hoạt động với cặp như vậy. Trong rcm.json cặp được đánh dấu bằng cùng giá trị host.

2.2. Liên kết qua HQCenter Admin

Mô tả cụm ở đâu

  • HQ Monitor, trang Các cụm (chỉ quản trị viên; việc giao cấu hình phải được bật). Cách thông thường.
  • API HQCenter Admin: POST /v1/admin/clusters và PUT /v1/admin/clusters/{id}. Bảng HQCenter Admin không có trang cụm.

``

Các bước trên trang Các cụm

  1. Nhập một Mã cụm mới (chữ Latin thường, chữ số và -) và bấm Tạo.
  2. Thêm thành viên (Thành viên). Với mỗi thành viên hãy chỉ:
    • fbagent của máy chủ;
    • vai trò: master, replica hoặc rcm;
    • các địa chỉ máy chủ;
    • cổng: với nút — 7051 (nút thứ hai trên cùng máy chủ — ví dụ 7052), với RCM — cổng nhận thống kê 7443.
  3. Thêm liên kết (Liên kết sao chép) từ phía chính tới bản sao.
  4. Bấm Kiểm tra hợp lệ, rồi Lưu.

Nếu quản trị viên khác đổi cụm cùng lúc, trang sẽ yêu cầu tải lại cụm và làm lại thay đổi.

Quy tắc

  • Một fbagent chỉ thuộc một cụm.
  • Trên một fbagent — không quá một phía chính, một bản sao, một RCM và một bộ định tuyến. Bộ định tuyến (vai trò router, từ HQbird 2027.2.30) không có liên kết và không chiếm chỗ giấy phép (chương 8.7).
  • Một cụm có đúng một RCM. fbagent trên máy chủ RCM điều hành cơ quan chứng chỉ (CA) của cụm.
  • Tên thành viên (member_id) — chữ Latin, chữ số, -. Tên, fbagent và vai trò của thành viên không đổi được. Để chuyển thành viên sang máy chủ khác, hãy tạo thành viên mới với tên mới. Đừng dùng lại tên cũ.
  • Mỗi bản sao phải có liên kết tới phía chính.
  • HQCenter Admin tự dựng địa chỉ nút: https://<first address>:<port>.
  • HQbird 2.5/3.0: đặt ngày replconf_valid_till của cụm (YYYY-MM-DD) — cấu hình plugin replconf có hiệu lực đến ngày đó.

Ví dụ qua API

json
{"contract":1,"cluster_id":"shop-prod","name":"Shop","pki":"managed",
 "cert_validity_days":90,"renew_before_days":30,
 "members":[
  {"member_id":"db1-m","agent_id":"<fbagent of host 1>","role":"master","addresses":["db1.lan"],"listen_port":7051},
  {"member_id":"db1-rcm","agent_id":"<fbagent of host 1>","role":"rcm","addresses":["db1.lan"],"listen_port":7443},
  {"member_id":"db2-r","agent_id":"<fbagent of host 2>","role":"replica","addresses":["db2.lan"],"listen_port":7052}],
 "links":[{"from":"db1-m","to":"db2-r"}]}
  • Tạo: POST /v1/admin/clusters (tài liệu có thể gửi cùng thành viên). Thay toàn bộ tài liệu: PUT /v1/admin/clusters/{id}.
  • PUT cần tiêu đề If-Match: <revision> (bản sửa do GET và ETag cung cấp). Không có tiêu đề — 428, với bản sửa cũ — 409, với lỗi trong tài liệu — 422 kèm danh sách lỗi.
  • POST /v1/admin/clusters/{id}/validate kiểm tra hợp lệ tài liệu mà không lưu.
  • GET /v1/admin/clusters/{id}/status hiện trạng thái thành viên và ngày hết hạn chứng chỉ.

Chuyện gì xảy ra sau khi lưu

  1. fbagent của mỗi thành viên nhận cụm. Trong cụm — kiểm tra mỗi 60 giây (fbagent trên máy chủ RCM — mỗi 30 giây). Ngoài cụm, fbagent biết về cụm ở lần hỏi cấu hình tiếp theo. Nếu lần hỏi đó không tới máy chủ, việc kiểm tra chạy mỗi 10 phút.
  2. Mỗi fbagent tạo một khóa và gửi yêu cầu chứng chỉ. fbagent trên máy chủ RCM ký nó. RCM ký chứng chỉ của chính mình mà không cần yêu cầu.
  3. fbagent ghi vào node.json: tên, vai trò, địa chỉ, peers (từ các liên kết), địa chỉ RCM, đường dẫn chứng chỉ, dữ liệu Firebird và fbagent. Vào rcm.json: danh sách nút (nodes), danh sách bộ định tuyến (routers), địa chỉ nhận thống kê và đường dẫn chứng chỉ. fbagent không đụng các trường khác của tệp.
  4. fbagent cài và khởi động các dịch vụ (chương 1).

Đổi một cụm:

Cái gì đổi fbagent làm gì
chỉ peers của một nút đang chạy chuyển chúng cho nút mà không khởi động lại
các trường khác của một nút dừng nút, ghi tệp, khởi động nút — trong windows.transfer_window của nút (chưa đặt — ngay lập tức)
rcm.json khởi động lại RCM ngay
chứng chỉ hoặc CA khởi động lại dịch vụ
một thành viên bị gỡ dừng và gỡ dịch vụ; cluster-managed.json → cluster-removed.json, chương trình → *.removed; cấu hình, chứng chỉ và dữ liệu còn lại

Sau khi một nút bị gỡ, mục của nó # BEGIN managed-by:<name> … # END … vẫn nằm trong replication.conf dùng chung. Hãy xóa thủ công và khởi động lại Firebird qua RCM.

Duyệt chứng chỉ cụm

Mặc định fbagent trên máy chủ RCM tự ký các yêu cầu (auto). Duyệt thủ công có thể bật. Các lệnh trên máy chủ RCM:

Command
fbagent --cluster-ca-approval manual     # or auto
fbagent --cluster-status                 # this fbagent's membership in the cluster (JSON)
fbagent --cluster-ca-approve <request_id>

Ở chế độ manual, thành viên mới hoặc khóa mới chờ duyệt. Gia hạn chứng chỉ với khóa đã biết được ký tự động.

2.3. Liên kết qua RCM

Cụm RCM (không có HQCenter Admin)

Nếu cụm do bộ cài HQbird hoặc lệnh fbagent --cluster-init tạo (chương 1.3), mô tả cụm do RCM lưu. Cách dễ nhất để thêm máy chủ là trang Cài đặt → Liên kết máy chủ (chương 1.3, „Liên kết máy chủ trong RCM“): RCM tự tạo thành viên và liên kết. Quy tắc giống HQCenter Admin (2.2, „Quy tắc“), cộng thêm:

  • trong RCM có một cụm; thành viên rcm luôn tồn tại và không xóa được;
  • không quá 3 chỗ (máy chủ có nút chính hoặc bản sao), nếu không thì lỗi seats_exceeded;
  • thành viên chỉ thêm được trên một fbagent đã nối tới RCM (chương 1.3: „Liên kết máy chủ“ hoặc „Thủ công“, bước 4).

Các bước trên trang Cài đặt → Cụm:

  1. Trong bảng Các agent, bấm Thêm thành viên ở dòng fbagent.
  2. Chỉ vai trò (master, replica hoặc router), member_id, các địa chỉ và cổng. Trang gợi ý tên <host>-<role> và cổng: 7051 cho nút fbagent đầu tiên, 7061 cho nút thứ hai. Cổng mà thành viên khác của máy chủ đã chiếm thì RCM từ chối. Các địa chỉ fbagent là nút bấm: bấm để thêm địa chỉ.
  3. Trong mục Liên kết, bấm Thêm liên kết từ phía chính tới bản sao.
  4. Bấm Kiểm tra hợp lệ: RCM sẽ hiện lỗi và cảnh báo.
  5. Bấm Lưu. Trang sẽ hiện danh sách thay đổi và xin xác nhận. Nếu thành viên đang bị xóa, cửa sổ màu đỏ.

Trước khi lưu, các thay đổi chỉ tồn tại trên trang (nhãn „Chưa lưu“). Nếu ai đó lưu cụm cùng lúc, trang sẽ đề nghị tải lại. Nếu chỉ các trường RCM đổi (bản sửa, CA, ủy nhiệm), trang sẽ tự lưu thay đổi của bạn.

Các mục khác của trang:

Mục Có gì ở đó
đầu trang tên cụm, bản sửa, CA cụm và CA agent; nút Xuất cho CA cũ
Mã kết nối tạo mã cho fbagent mới, thu hồi mã chưa dùng
Tài liệu JSON toàn bộ tài liệu trong một trường văn bản; Kiểm tra hợp lệ và Lưu dùng nó
Khóa và CA ủy nhiệm: khóa thành viên mới (rekey), CA cụm mới (rotate_ca), CA agent mới (rotate_agent_ca); không dùng được khi còn thay đổi chưa lưu
Trạng thái bản sửa mỗi thành viên đã áp dụng, hết hạn chứng chỉ, dịch vụ, lỗi cuối

Từ dòng lệnh trên máy chủ RCM:

Command
export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
./hqbirdrcm cluster show > c.json        # document with revision
# edit c.json
./hqbirdrcm cluster validate -f c.json   # validate without saving anything
./hqbirdrcm cluster apply -f c.json      # save (If-Match = revision from the file)
./hqbirdrcm cluster agents               # connected fbagents and their members
./hqbirdrcm cluster status               # what the fbagents reported

Định dạng tài liệu như ở 2.2, „Ví dụ qua API“. apply với bản sửa cũ nhận 409: chạy lại show. RCM giữ 20 bản sửa cuối trong rcm-data/cluster/history/.

HQ Monitor. Trang Các cụm cũng làm việc với RCM. Trên máy chủ RCM, HQ Monitor truy cập RCM qua fbagent của máy chủ đó, với chứng chỉ fbagent: không cần người dùng và mật khẩu RCM. Trong nhật ký kiểm toán RCM các hành động đó được ghi là agent:<id> (<user>). Cách khác, cho các phiên bản RCM trước: trong cấu hình HQ Monitor đặt rcm_admin_url (http://127.0.0.1:7444), rcm_admin_user (người dùng RCM) và rcm_admin_password_file (tệp chứa mật khẩu của nó).

Sau khi lưu, mọi thứ diễn ra như qua HQCenter Admin (2.2, „Chuyện gì xảy ra sau khi lưu“). RCM tự đọc lại nodes trong rcm.json, không cần khởi động lại.

Gỡ một fbagent khỏi cụm: xóa các thành viên của nó và lưu, rồi bấm Thu hồi trong bảng Các agent (hoặc ./hqbirdrcm cluster revoke -agent <id>). Để đưa nó trở lại, cần mã mới. Sau khi thu hồi, fbagent (từ phiên bản 3.1.0) tự rời cụm: nó dừng các nút và xóa dữ liệu cụm. Việc tương tự trên máy chủ nút do lệnh fbagent --cluster-leave làm. Trên máy chủ RCM thì bị từ chối.

Cài thủ công: thêm nút vào RCM

  1. Cài đặt → RCM, bảng Các nút đã kết nối.
  2. Bấm Thêm nút. Điền node_id, url (https://<address>:7051), vai trò, host (nhãn phiên bản Firebird), server (chỉ để nhóm trên màn hình).
  3. Bấm Kiểm tra ở dòng nút: RCM sẽ kiểm tra kết nối và quyền.
  4. Bấm Lưu. RCM sẽ ghi rcm.json và lưu tệp cũ thành rcm.json.<UTC time>.bak (20 tệp cuối).
  5. Khởi động lại RCM. Cho đến khi khởi động lại, cấu hình cũ còn hiệu lực; trang hiện các trường đang chờ khởi động lại.
Cài đặt → RCM
Cài đặt → RCM
Command
sudo systemctl restart hqbirdrcm

Cũng có thể làm không qua giao diện: sửa rcm.json và khởi động lại RCM.

Cài thủ công: liên kết phía chính và bản sao

Liên kết phải được ghi ở cả hai phía:

  1. Cài đặt → Các nút, chọn nút chính.
  2. Trong mục Đối tác, bấm Thêm đối tác: node_id của bản sao, url của nó, nén (zstd).
  3. Bấm Lưu. RCM sẽ hiện danh sách thay đổi và xin xác nhận. Thay đổi peers có hiệu lực ngay.
  4. Lặp lại cho nút bản sao: đối tác của nó là phía chính.
Mục Đối tác của nút chính
Mục Đối tác của nút chính

Nếu đối tác không được ghi ở một trong hai phía, RCM sẽ không đề nghị nút bản sao đó khi khởi tạo cơ sở dữ liệu.

2.4. Cài đặt nút

Cài đặt → Các nút hiện các cài đặt node.json mà nút cho phép đổi từ RCM. Chỉ các trường đã đổi được lưu, sau một cửa sổ liệt kê các thay đổi.

Cài đặt → Các nút: chọn một nút
Cài đặt → Các nút: chọn một nút
Cài đặt cơ sở dữ liệu của nút với các dấu „sau khi quét“
Cài đặt cơ sở dữ liệu của nút với các dấu „sau khi quét“

Mỗi dòng được đánh dấu thời điểm thay đổi có hiệu lực:

Khi nào Cài đặt nào
Ngay lập tức channel_a_mbps, channel_a_burst_mbps, windows.restart_window, peers; từ HQbird 2027.2.24 — cài đặt kiểm tra dữ liệu (limits.data_check_*); từ HQbird 2027.2.31 — advertise_addr
Sau khi khởi động lại nút các giới hạn còn lại, windows.transfer_window; trang hiện chúng trên một dòng riêng cho đến khi nút được khởi động lại
Sau khi quét databases.*, exclude_filter; nếu replication.conf đã đổi, cần khởi động lại Firebird (chương 3.5)

Chỉ đọc (đổi trong node.json trên máy chủ nút): firebird (gồm mật khẩu và auto_restart), rcm, tls, segments, địa chỉ listen_addr.

Các cài đặt chính:

Cài đặt Mặc định Nghĩa
windows.restart_window phía chính 22:00-05:00, bản sao — luôn khi nào nút được khởi động lại Firebird; Firebird phía chính không bao giờ tự khởi động lại
windows.transfer_window 23:00-05:00 cửa sổ mà khởi tạo chạy ở tốc độ reinit_window_mbps
limits.channel_a_mbps 50 tốc độ truyền phân đoạn, MB/s (channel_a_burst_mbps — đỉnh ngắn hạn, 200)
limits.reinit_window_mbps 100 tốc độ khởi tạo trong cửa sổ truyền, MB/s
limits.reinit_day_disk_fraction 0.5 phần tốc độ đĩa đã đo cho khởi tạo ngoài cửa sổ
limits.retention_days 2 giữ phân đoạn đã gửi trong kho của phía chính bao nhiêu ngày
limits.free_space_floor_gb 1 chỗ trống tối thiểu, GB; dưới mức này bản sao không nhận phân đoạn
limits.max_concurrent_reinits 1 nút chạy bao nhiêu lần khởi tạo cùng lúc

Chi tiết về tốc độ và giữ kho nằm ở chương 5 và 7.

firebird.auto_restart (chỉ trong node.json) xác định nút bản sao có được tự khởi động lại Firebird không:

Giá trị Hành vi
auto (mặc định) được, nếu Firebird này không phục vụ cơ sở dữ liệu phía chính
never không bao giờ
always luôn, kể cả khi Firebird này chứa cơ sở dữ liệu phía chính

Qua HQCenter Admin. windows.transfer_window của nút fbagent cũng được dùng làm cửa sổ để khởi động lại chính dịch vụ nút khi cụm đổi. Nếu cửa sổ không được đặt trong node.json, fbagent khởi động lại dịch vụ ngay.

2.5. Nhiều phiên bản HQbird trên một máy chủ

fbagent khởi động lại các dịch vụ liệt kê trong firebird.update.services của cấu hình nó. Danh sách rỗng nghĩa là mọi dịch vụ HQbird trên máy chủ. Chỉ để lại dịch vụ của phiên bản của bạn trong danh sách. Nút không thấy cài đặt này và ghi cảnh báo fbagent_shared vào nhật ký nếu fbagent biết hơn một phiên bản.

2.6. Mật khẩu SYSDBA

Nút kết nối Firebird bằng người dùng và mật khẩu từ firebird.user và firebird.password trong node.json. fbagent giữ bản sao mật khẩu của riêng nó. Nếu bạn đã đổi mật khẩu SYSDBA:

  1. Sửa firebird.password trong node.json của mọi nút của phiên bản này (chính và bản sao).
  2. Sửa mật khẩu trong cấu hình fbagent và tải lại (xem tài liệu fbagent).
  3. Khởi động lại các dịch vụ nút.

Nếu không, các trang công bố và kiểm tra trong RCM sẽ hiện lỗi đăng nhập (SQLSTATE 28000).

2.7. Người dùng RCM và kiểm toán

  • Người dùng nằm trong tệp rcm-data/users.json (chương 1.5). Không có vai trò, người dùng có mọi quyền; vai trò viewer (từ HQbird 2027.2.31) — chỉ xem.
  • Một phiên kéo dài 12 giờ sau hành động cuối.
  • Sau 10 lần đăng nhập thất bại trong 5 phút, đăng nhập của người dùng và địa chỉ đó bị chặn tạm thời. Đăng nhập thành công đặt lại bộ đếm.
  • Nhật ký kiểm toán là tệp rcm-data/audit.jsonl: một dòng JSON cho mỗi thay đổi, đăng nhập và đăng xuất. Giao diện không có nhật ký kiểm toán.
  • Trang Lệnh hiện tác giả của mỗi lệnh.

2.8. Giấy phép

Mỗi phút, nút chính đọc giấy phép fbagent của máy chủ nó. Nếu không có giấy phép (hết thời gian dùng thử, giấy phép hết hạn hoặc không hợp lệ), nút ngừng gửi phân đoạn cho mọi cơ sở dữ liệu trên phía chính. Firebird và các cơ sở dữ liệu vẫn chạy, nhưng các bản sao ngừng nhận thay đổi.

Bạn thấy gì trong RCM:

  • phía chính màu đỏ (NEEDS_ATTENTION), với huy hiệu „không có giấy phép: đã dừng gửi“;
  • không có nút Tiếp tục: chỉ giấy phép gỡ tạm dừng;
  • trên bản sao: „không nhận từ …: phía chính không có giấy phép“;
  • trong bảng Các nút, huy hiệu „không có giấy phép“; trong Cài đặt → Các nút, khối giấy phép fbagent;
  • các cảnh báo license_paused và license_pause_archive_released;
  • khởi tạo bị cấm (license_paused).
Khối giấy phép fbagent trong Cài đặt → Các nút
Khối giấy phép fbagent trong Cài đặt → Các nút

Cài giấy phép vào fbagent. Nút tự gỡ tạm dừng trong vòng một phút. Phía chính giữ kho cho các bản sao trong limits.retention_days (mặc định 2 ngày) kể từ đầu tạm dừng. Nếu bạn cài giấy phép muộn hơn, các bản sao sẽ phải được khởi tạo lại.

Cụm qua RCM, không có HQCenter Admin. Giấy phép nổi không có HQCenter Admin ngừng hoạt động sau online_check_days cộng các ngày gia hạn. Mỗi fbagent trong cụm cần giấy phép gắn (fbagent --license-request, rồi fbagent --license-install, chương 1.3, „Giấy phép“). Sau thời gian dùng thử, fbagent sẽ không thêm nút mới hoặc RCM nếu giấy phép không có tính năng cluster; nó không bao giờ cấm cập nhật. Với HQbird 2.5/3.0, ngày replconf_valid_till trong RCM không được muộn hơn cuối giấy phép cộng các ngày gia hạn trên các nút fbagent (lỗi replconf_after_license).

2.9. Cách kiểm tra

  • Tổng quan: mọi nút có mặt và được nhóm theo máy chủ.

    Tổng quan cụm
    Tổng quan cụm
  • Cài đặt → Các nút: phía chính có một bản sao trong Đối tác, và bản sao có phía chính.

  • Cài đặt → RCM: nút Kiểm tra ở dòng mỗi nút đều qua.

  • Báo cáo cụm thành một tệp:

    Command
    ./hqbirdrcm report -o report.json

2.10 Lỗi thường gặp

Bạn thấy gì Nguyên nhân Việc cần làm
Sửa đối tác trong RCM bị từ chối (409 cluster_managed) hoặc mất sau khi khởi động lại nút nút được cài qua HQCenter Admin hoặc qua RCM đổi các liên kết trong mô tả cụm (2.2, 2.3)
seats_exceeded khi lưu cụm trong RCM các nút trên máy chủ thứ tư không quá 3 máy chủ có nút
Cài đặt → RCM: rcm_config_read_only cụm qua RCM trên Linux: rcm.json thuộc fbagent sửa rcm.json với tư cách người dùng fbagent và khởi động lại RCM
Thu hồi agent không chạy (agent_has_members) fbagent còn thành viên trước hết xóa thành viên và lưu
Nút bản sao không được đề nghị khi khởi tạo đối tác không được ghi ở một phía thêm đối tác ở cả hai phía (2.3)
Một thay đổi trong Cài đặt → RCM không có hiệu lực RCM chưa được khởi động lại khởi động lại RCM
422 khi lưu cụm trong HQCenter Admin lỗi trong tài liệu sửa theo danh sách errors, kiểm tra qua validate
409 khi lưu cụm người khác đã đổi cụm đọc lại cụm và thử lại
Thành viên cụm HQCenter Admin mới không nhận chứng chỉ duyệt thủ công trên máy chủ RCM fbagent --cluster-ca-approve <id>
Lỗi SQLSTATE 28000 trên các trang công bố mật khẩu SYSDBA đã đổi 2.6

3. Thêm cơ sở dữ liệu vào phía chính

Trong chương này cơ sở dữ liệu phía chính nằm dưới sự kiểm soát của nút. Nút ghi nó vào replication.conf và tạo các thư mục cho phân đoạn. Sau khi khởi động lại Firebird cơ sở dữ liệu sẵn sàng để sao chép.

Tạo bản sao là các bước tiếp theo (công bố, khởi tạo). Chúng được mô tả ở các chương 4–6.

Tên nút được đưa theo giao diện RCM tiếng Nga, với tên tiếng Anh trong ngoặc.

3.1. Nút phát hiện cơ sở dữ liệu thế nào

Nút chính tìm cơ sở dữ liệu trong một thư mục — gốc cơ sở dữ liệu (databases.root). Cái gì được quản lý do các quy tắc quyết định:

Quy tắc Trường Mặc định
Thư mục cơ sở dữ liệu root chưa đặt
Tìm thư mục con recursive có
Mặt nạ đưa vào template *.fdb
Mặt nạ loại trừ exclude_mask không
Kích thước tệp, MB min_size_mb, max_size_mb không giới hạn (0)
Bảng để so dữ liệu sync_tables với HQbird 2027.2.24 — các bảng từ công bố của cơ sở dữ liệu, nếu không có — RDB$FIELDS; trong 2027.5.7 — RDB$FIELDS
Danh sách đưa vào include_paths rỗng (chế độ mẫu)
Danh sách loại trừ exclude_paths rỗng

Đường dẫn root là đường dẫn trên máy chủ nút, không phải trên máy chủ RCM. Nút áp dụng mặt nạ đưa vào trước, rồi mặt nạ loại trừ, rồi kích thước.

Các quy tắc giống nhau cho cả nút. Danh sách sync_tables cũng dùng chung: lần kiểm tra (chương 5.10) tìm mỗi bảng trong danh sách ở mọi cơ sở dữ liệu của nút mà không có danh sách riêng.

Bảng để so, với HQbird 2027.2.24. Mỗi cơ sở dữ liệu có thể có danh sách riêng (Bảng theo dõi đồng bộ). Nút lưu nó trong databases.sync_tables_by_db. Lần kiểm tra lấy danh sách đã đặt đầu tiên:

  1. danh sách riêng của cơ sở dữ liệu;
  2. danh sách sync_tables dùng chung của nút;
  3. các bảng từ công bố của cơ sở dữ liệu;
  4. RDB$FIELDS.

Danh sách dùng chung đã lưu trước đó được ưu tiên hơn công bố: cơ sở dữ liệu không có danh sách riêng thì dùng nó. Trang cơ sở dữ liệu phía chính hiện danh sách nào đang có hiệu lực (3.3).

Một bảng vắng ở cả cơ sở dữ liệu chính và bản sao nhận trạng thái „không có trong cơ sở dữ liệu“ (absent): nó không được so, và lần kiểm tra sẽ không hiện „Không ổn“ vì nó. Một bảng chỉ thiếu ở một phía là một lệch.

RCM và nút 2027.5.7. Có một danh sách cho cả nút (sync_tables); không có danh sách thì lần kiểm tra dùng RDB$FIELDS. Một bảng thiếu là lỗi, và lần kiểm tra cơ sở dữ liệu sẽ hiện „Không ổn“.

Mọi quy tắc được lưu trong node.json của nút. Nút áp dụng chúng ở mỗi lần quét.

Chế độ mẫu và chế độ danh sách:

  • Chế độ mẫu (danh sách đưa vào rỗng): nút lấy mọi tệp khớp mặt nạ, trừ tệp bị loại. Một tệp mới trong thư mục sẽ được nút tự nhận ở lần quét tiếp theo.
  • Chế độ danh sách (danh sách đưa vào không rỗng): nút chỉ lấy các tệp trong danh sách. Một tệp mới sẽ không tự vào quản lý — phải thêm nó.

Chọn chế độ danh sách nếu thư mục chứa bản sao cơ sở dữ liệu, cơ sở dữ liệu thử, hoặc tệp khác không cần sao chép.

3.2. Trước khi bắt đầu: kiểm tra quyền

Người dùng mà Firebird và nút chạy dưới (firebird trên Linux, LocalSystem trên Windows) phải có quyền đọc và ghi trên:

  • thư mục gốc cơ sở dữ liệu và các tệp cơ sở dữ liệu;
  • replication.conf và thư mục của nó (nút thay tệp qua một tệp tạm);
  • các thư mục phân đoạn <database>.ReplLog và <database>.LogArch (nút tự tạo chúng).

RCM kiểm tra quyền trước khi đăng ký (kiểm tra trước). Nếu kiểm tra thất bại, lệnh kết thúc với lỗi preflight failed on <node> và một danh sách đường dẫn.

Kiểm tra trên máy chủ nút (Linux):

Command
sudo -u firebird /opt/hqclusternode/hqclusternode checkpermissions -config /opt/hqclusternode/node.json

3.3. Trang đăng ký cơ sở dữ liệu

Đăng ký cơ sở dữ liệu: biểu mẫu và xem trước
Đăng ký cơ sở dữ liệu: biểu mẫu và xem trước
  1. Mở trang đăng ký của nút chính. Liên kết có ở hai chỗ:

    • Cơ sở dữ liệu → bảng Các nút → cột hành động → Đăng ký;
    • Tổng quan → thẻ nút chính → Đăng ký cơ sở dữ liệu.

    Nút bản sao không có trang này.

  2. Biểu mẫu hiện các quy tắc hiện tại của nút (nút tự gửi chúng). Nếu nút không phản hồi, các nút xem trước và đăng ký bị tắt: không có quy tắc hiện tại chúng sẽ đặt lại danh sách đưa vào và loại trừ.

  3. Điền hoặc sửa các trường: Đường dẫn thư mục trên máy chủ này, đệ quy, các mặt nạ, Bộ lọc kích thước, Bảng theo dõi đồng bộ.

    Trường Bảng theo dõi đồng bộ:

    • với HQbird 2027.2.24 trở đi — danh sách là theo từng cơ sở dữ liệu mà hành động này sẽ đăng ký. Trường rỗng: cơ sở dữ liệu dùng các bảng của công bố riêng. Đăng ký không đổi danh sách dùng chung của nút (sync_tables). Nếu nó tồn tại, biểu mẫu nói vậy: cơ sở dữ liệu không có danh sách riêng thì dùng nó, chứ không phải công bố. Danh sách của cơ sở dữ liệu đã được quản lý được đặt trên trang của nó: Cơ sở dữ liệu → cơ sở dữ liệu chính → khối Bảng theo dõi đồng bộ. Khối hiện danh sách nào đang có hiệu lực. Trường rỗng gỡ danh sách riêng của cơ sở dữ liệu;
    • trong RCM và nút 2027.5.7 — một danh sách cho mọi cơ sở dữ liệu của nút (sync_tables).
  4. Bấm Xem trước. Nút sẽ hiện mọi tệp khớp mặt nạ đưa vào. Nó không đổi gì.

  5. Kiểm tra danh sách. Mỗi tệp có một hộp chọn:

    • đã chọn — tệp sẽ được quản lý;
    • đã chọn, khóa, đánh dấu đã được quản lý — cơ sở dữ liệu đã được đăng ký;
    • khóa kèm lý do — tệp bị loại bởi mặt nạ, kích thước hoặc danh sách loại trừ. Để lấy nó, hãy đổi quy tắc.
  6. Chọn các cơ sở dữ liệu cần thiết và bấm Đăng ký mục đã chọn. RCM sẽ xin xác nhận và hiện số tệp.

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

Nút này làm gì:

  • ở chế độ mẫu — tệp không có hộp chọn được thêm vào danh sách loại trừ, tệp có hộp chọn được gỡ khỏi đó;
  • ở chế độ danh sách — tệp có hộp chọn được thêm vào danh sách đưa vào.

Nút thêm cơ sở dữ liệu vào những cái đã được quản lý. Nó không đổi các dòng bị khóa. 7. Nút Đăng ký áp dụng biểu mẫu mà không đổi các danh sách. 8. Đợi thông báo hoàn tất và số cơ sở dữ liệu đã thêm. Nếu lâu không có phản hồi, hãy kiểm tra kết quả trên trang Lệnh.

Với HQbird 2027.2.24 trở đi thông báo là „Đã đăng ký: N“. Nếu Firebird phía chính cần khởi động lại, RCM nói nút nào cần bấm (thường là Khởi động lại Firebird chính ở dòng cơ sở dữ liệu) và đưa liên kết tới các cơ sở dữ liệu phía chính. RCM 2027.5.7 có thể nói „Không có cơ sở dữ liệu phù hợp mới“, dù các cơ sở dữ liệu đã được thêm: hãy kiểm tra trang Cơ sở dữ liệu.

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

Nếu sau đăng ký không tìm thấy cơ sở dữ liệu nào, nhưng nút đã có cơ sở dữ liệu, nút từ chối (409) và trả lại quy tắc cũ. Như vậy một sai sót về đường dẫn không tắt sao chép của mọi cơ sở dữ liệu.

Tương tự từ dòng lệnh

Command
hqbirdrcm enroll-databases -node node-a -root /databases/master

Lưu ý: lệnh chỉ gửi các trường từ tham số của nó. Các quy tắc còn lại (mặt nạ, kích thước, danh sách đưa vào và loại trừ, sync_tables) sẽ bị nút đặt lại. Lệnh không có tham số cho các quy tắc này. Trước khi chạy lệnh, hãy kiểm tra quy tắc hiện tại (hqbirdrcm getconfig -node node-a). Nếu chúng đã được đặt, hãy dùng trang đăng ký.

3.4. Chuyện gì xảy ra sau đăng ký

  1. Nút ghi các quy tắc vào node.json.
  2. Nút quét thư mục (scansync).
  3. Với mỗi cơ sở dữ liệu tìm thấy, nút ghi một khối vào vùng của chính nó trong replication.conf (giữa các dòng # BEGIN managed-by:node-a role:master và # END …) và tạo các thư mục <database>.ReplLog và <database>.LogArch. Nút không sửa văn bản ngoài vùng của nó.
  4. Trước khi đổi, nút lưu một bản sao tệp: replication_YYYYMMDD_hhmmss_NNN.conf.
  5. Nếu replication.conf đã đổi, các cơ sở dữ liệu vào trạng thái PENDING_RESTART: Firebird chỉ đọc tệp mới sau khi khởi động lại. Trong bảng Các nút điều này hiện ở cột Đang chờ khởi động lại.
Cột „Đang chờ khởi động lại“ trong bảng „Các nút“
Cột „Đang chờ khởi động lại“ trong bảng „Các nút“

Trạng thái của một cơ sở dữ liệu mới:

Trạng thái Nhóm trong RCM Nghĩa
UNCONFIGURED Đang chờ đã tìm thấy cơ sở dữ liệu, cấu hình chưa được ghi
PENDING_RESTART Đang chờ đã ghi cấu hình, cần khởi động lại Firebird
CONFIGURED Đang chờ Firebird đã khởi động lại, cơ sở dữ liệu sẵn sàng cho công bố và khởi tạo

3.5. Khởi động lại Firebird phía chính

Nút chính không bao giờ tự khởi động lại Firebird. RCM cũng không. Việc khởi động lại phía chính là quyết định của người vận hành: khởi động lại cắt mọi kết nối tới mọi cơ sở dữ liệu của phiên bản Firebird đó.

Chọn lúc tải thấp và bấm một trong các nút:

  • Khởi động lại Firebird chính — trên trang Cơ sở dữ liệu, ở dòng phía chính của cơ sở dữ liệu đang chờ khởi động lại;
  • cùng nút đó trong cửa sổ Khởi tạo, chương 5;
  • Khởi động lại Firebird — trên trang cơ sở dữ liệu.

RCM sẽ xin xác nhận. Nó hiện tên nút và một cảnh báo: Firebird sẽ khởi động lại ngay, không có cửa sổ khởi động lại, và mọi kết nối sẽ bị cắt.

Xác nhận khởi động lại Firebird phía chính
Xác nhận khởi động lại Firebird phía chính

Tương tự từ dòng lệnh

Command
hqbirdrcm restartfirebird -node node-a

Lệnh này cũng khởi động lại ngay, không có cửa sổ khởi động lại.

Nút khởi động lại Firebird thế nào:

  1. Kiểm tra fbagent đang phản hồi và quản lý cùng phiên bản (định danh, cổng, tên dịch vụ từ node.json). Nếu bất kỳ giá trị nào không khớp, nút từ chối.
  2. Nhờ fbagent khởi động lại Firebird.
  3. Đợi Firebird phản hồi trên cổng của nó.
  4. Chuyển các cơ sở dữ liệu từ PENDING_RESTART sang CONFIGURED.

Nhiều phiên bản HQbird trên một máy chủ. fbagent khởi động lại các dịch vụ liệt kê trong firebird.update.services của cấu hình nó. Danh sách rỗng nghĩa là mọi dịch vụ HQbird trên máy chủ. Nếu trên máy chủ có hai phiên bản HQbird, trong danh sách chỉ để dịch vụ của phiên bản của bạn. Nếu không, khởi động lại một nút cũng sẽ dừng phiên bản kia.

Trên Windows. Nếu replication.log đã lớn tới log_portion_mb hoặc hơn, việc khởi động lại diễn ra như sau: dừng Firebird → lưu nhật ký → khởi động.

3.6. Cơ sở dữ liệu đã được sao chép thủ công

Nếu sao chép đã được cấu hình thủ công cho một cơ sở dữ liệu (khối riêng trong replication.conf, công bố đã bật, phân đoạn đang chảy), nó có thể được đưa vào quản lý mà không khởi tạo lại bản sao. Để làm vậy có chế độ detect_existing (chỉ phía chính).

  1. Chạy một lần xem trước:

    Command
    hqbirdrcm enroll-databases -node node-a -root /databases/master -detect-existing -dry-run

    Trong phản hồi, taken_over liệt kê các cơ sở dữ liệu sẽ được chuyển. Thêm -verbose để thấy các cơ sở dữ liệu bị bỏ qua kèm lý do.

  2. Nếu danh sách đúng, chạy lệnh không có -dry-run.

Nút chỉ chuyển một khối nếu:

  • các thư mục phân đoạn được đặt tên đúng <database>.ReplLog và <database>.LogArch;
  • phân đoạn đã có trong kho;
  • công bố được bật trong cơ sở dữ liệu.

Nút không chuyển một khối có đường dẫn khác và báo nó là „đã tìm thấy nhưng không được hỗ trợ“.

Sau khi chuyển, các cơ sở dữ liệu nhận PENDING_RESTART, dù cài đặt sao chép không đổi: chỉ vị trí của khối trong tệp đổi. Hãy khởi động lại Firebird trong cửa sổ bảo trì.

3.7. Cách kiểm tra

  • Cơ sở dữ liệu: cơ sở dữ liệu hiện ở dòng nút chính, trạng thái CONFIGURED (sau khi khởi động lại).

  • Cạnh cơ sở dữ liệu có thể có biểu tượng công bố TẮT: công bố chưa được bật. Điều này bình thường, công bố là bước tiếp theo (chương 6).

    Cơ sở dữ liệu mới ở dòng phía chính
    Cơ sở dữ liệu mới ở dòng phía chính
  • Trên máy chủ nút: khối cơ sở dữ liệu có trong replication.conf bên trong vùng managed-by:node-a, và cạnh cơ sở dữ liệu có các thư mục .ReplLog và .LogArch.

3.8. Gỡ một cơ sở dữ liệu khỏi quản lý

Cách thông thường là nút bấm. Trên trang Cơ sở dữ liệu, đánh dấu các cơ sở dữ liệu, chọn hành động hàng loạt Gỡ khỏi quản lý và bấm Áp dụng cho mục đã chọn. RCM:

  1. thêm các tệp vào danh sách loại trừ của nút;
  2. quét thư mục một lần: các khối cơ sở dữ liệu được gỡ khỏi replication.conf;
  3. xóa các bản ghi cơ sở dữ liệu trong nút.

Các tệp cơ sở dữ liệu và thư mục phân đoạn vẫn ở trên đĩa. Firebird không được khởi động lại. Firebird tiếp tục ghi phân đoạn của cơ sở dữ liệu cho đến lần khởi động lại tiếp theo; RCM sẽ nói nếu cần khởi động lại.

RCM sẽ từ chối (has_replicas) với cơ sở dữ liệu phía chính còn bản sao sống: nếu không bản sao sẽ dừng im lặng. Trước hết hãy biến bản sao thành cơ sở dữ liệu thường hoặc gỡ nó (chương 8).

Đừng xóa khối cơ sở dữ liệu khỏi replication.conf bằng tay: ở lần quét tiếp theo nút sẽ ghi lại nó.

Nếu tệp cơ sở dữ liệu đã biến mất hoặc bị một quy tắc loại. Khi đó cơ sở dữ liệu nhận trạng thái ORPHANED (nhóm Mồ côi). Nút giữ bản ghi của nó và kho phân đoạn: một cơ sở dữ liệu mất thường là nhầm lẫn hơn là quyết định. Nếu tệp trở lại, cơ sở dữ liệu chạy lại và cảnh báo được gỡ. Để xóa vĩnh viễn cơ sở dữ liệu như vậy, hãy làm hai bước theo thứ tự này:

Command
# 1. delete the segment archive (optional)
hqbirdrcm cleanuparchive -node node-a -db <db_id> -orphaned
# 2. delete the database record
hqbirdrcm forgetdatabase -node node-a -db <db_id>

Sau forgetdatabase, lệnh cleanuparchive sẽ không còn tìm thấy cơ sở dữ liệu. Cả hai lệnh chỉ chạy với cơ sở dữ liệu ở trạng thái ORPHANED và không đụng tệp cơ sở dữ liệu.

Cẩn thận. Sau khi thăng cấp bản sao thành chính (chương 8), đừng chạy cleanuparchive -orphaned cho bản ghi cũ: phía chính mới dùng cùng thư mục .LogArch, và lệnh sẽ xóa kho đang làm việc của nó.

3.9. Đổi gốc cơ sở dữ liệu

Đăng ký với đường dẫn khác được phép. Nút:

  • thêm cơ sở dữ liệu từ thư mục mới;
  • chuyển các cơ sở dữ liệu từ thư mục cũ mà không có trong thư mục mới sang ORPHANED (thông báo orphaned_database) và giữ kho của chúng.

Nếu bạn chọn nhầm thư mục, hãy đăng ký lại thư mục đúng. Cơ sở dữ liệu có cùng đường dẫn đầy đủ sẽ tiếp tục chạy dưới cùng db_id. Cơ sở dữ liệu ở đường dẫn khác là cơ sở dữ liệu mới (db_id mới); bản sao của nó phải được khởi tạo lại.

3.10. Lỗi thường gặp

Bạn thấy gì Nguyên nhân Việc cần làm
preflight failed on node-a không có quyền trên các thư mục sửa quyền, thử lại (3.2)
409 scan_would_empty_region thư mục mới không chứa cơ sở dữ liệu, nhưng nút đã có kiểm tra đường dẫn và mặt nạ
Xem trước rỗng mặt nạ không khớp hoặc thư mục sai kiểm tra đường dẫn, mặt nạ, „đệ quy“
Các nút bị tắt, „Không đọc được cấu hình nút“ nút không phản hồi kiểm tra dịch vụ nút và mạng (chương 1)
Cơ sở dữ liệu ở PENDING_RESTART lâu phía chính không tự khởi động lại Firebird khởi động lại Firebird (3.5)
Khởi động lại bị từ chối vì fbagent fbagent không chạy hoặc dữ liệu của nó không khớp node.json chương 1, kiểm tra fbagent
Tệp mới không xuất hiện nút đang ở chế độ danh sách thêm tệp qua „Đăng ký mục đã chọn“

4. Cách biến một cơ sở dữ liệu thành bản sao: các bước và chỗ trên đĩa

Chương này bao phủ toàn bộ hành trình của một cơ sở dữ liệu từ phía chính tới một bản sao đang chạy, cùng cách tính chỗ trên đĩa. Bản thân việc khởi tạo được mô tả chi tiết ở chương 5.

4.1. Quy tắc chính

Một cơ sở dữ liệu xuất hiện trên bản sao chỉ qua khởi tạo từ phía chính (reinit): nút chính tự chuyển một bản sao qua nbackup.

Đừng tạo bản sao bằng tay:

  • gbak tạo GUID cơ sở dữ liệu mới và đặt lại số phân đoạn. Liên kết phía chính — bản sao bị đứt.
  • Bản sao tệp của cơ sở dữ liệu đang chạy không nhất quán, và RCM sẽ thấy hai cơ sở dữ liệu cùng GUID (duplicate_guid) và sẽ cấm khởi tạo.

Một bản sao đang chạy đã cấu hình thủ công có thể được đưa vào quản lý mà không cần bản sao mới — xem 4.6.

4.2. Các giai đoạn

Số Giai đoạn Ở đâu Trạng thái cơ sở dữ liệu phía chính sau giai đoạn
1 Đăng ký cơ sở dữ liệu trên phía chính chương 3.3 PENDING_RESTART
2 Khởi động lại Firebird của phía chính chương 3.5 CONFIGURED
3 Đồng bộ công bố chương 6 CONFIGURED, công bố BẬT
4 Chuẩn bị bản sao: thư mục, quyền, phiên bản Firebird 4.3 —
5 Kiểm tra chỗ trống trên phía chính và trên bản sao 4.4 —
6 Khởi tạo chương 5 SEEDING → IN_SYNC
7 Khởi động lại Firebird của bản sao (nếu cần) chương 5.6 bản sao bắt đầu áp dụng phân đoạn
8 Kiểm tra dữ liệu chương 5.10 —

Giai đoạn 3 là bắt buộc với Firebird 4/5. Không có công bố, Firebird phía chính không ghi thay đổi bảng vào phân đoạn, và bản sao lặng lẽ tụt hậu so với phía chính. Trên trang Cơ sở dữ liệu cơ sở dữ liệu như vậy được đánh dấu bằng biểu tượng công bố TẮT. Hãy bấm Đồng bộ công bố trước khi khởi tạo.

Từ HQbird 2027.2.24, cửa sổ Khởi tạo cảnh báo về điều này và đưa nút Đồng bộ công bố và khởi tạo, trong khi nút chính từ chối khởi tạo với lỗi publication_off (chương 5.1). RCM và nút 2027.5.7 không kiểm tra công bố.

HQbird 2.5/3.0. Không có công bố, nên giai đoạn 3 được bỏ qua. Tập bảng do các bộ lọc plugin replconf xác định (chương 6).

Trạng thái cơ sở dữ liệu:

Trạng thái Nhóm trong RCM Nghĩa
CONFIGURED Đang chờ Firebird đã đọc cài đặt, chưa có bản sao
PUBLISHING Đang chờ đang đồng bộ công bố
SEEDING Đang chờ đang khởi tạo
IN_SYNC Ổn bản sao đã nhận mọi phân đoạn
LAGGING Đang chờ bản sao đang trễ, phân đoạn nằm trong hàng đợi
NEEDS_REINIT Lỗi bản sao phải được khởi tạo lại
FAILED Lỗi lần khởi tạo cuối thất bại

4.3. Chuẩn bị bản sao

Thư mục cơ sở dữ liệu bản sao

Nút bản sao đặt mỗi cơ sở dữ liệu vào thư mục databases.root của nó theo đường dẫn:

Code
<databases.root>/<master node name>/<database path relative to the master root>

Ví dụ: phía chính node-a với gốc /databases/master và cơ sở dữ liệu /databases/master/sales/employee.fdb. Trên bản sao node-b với gốc /databases/replica, cơ sở dữ liệu sẽ ở đây:

Code
/databases/replica/node-a/sales/employee.fdb

Như vậy các cơ sở dữ liệu cùng tên từ các phía chính khác nhau không đụng nhau.

Không ai tự tạo thư mục gốc — không bộ cài, không HQCenter Admin, cũng không nút lúc khởi động. Hãy tạo nó theo một trong các cách sau:

  • trong cửa sổ Khởi tạo: trường Thư mục bản sao, nút Tạo thư mục. Nút chỉ hiện khi thư mục chưa tồn tại. Với HQbird 2027.2.24, nếu nút bản sao chưa có databases.root, trường đã chứa /databases/replica/<replica node id>. Với bản sao trên Windows trường để trống: hãy nhập thư mục có chữ ổ đĩa. Mỗi nút bản sao trên cùng máy chủ cần thư mục riêng. Thư mục do nút bản sao tạo: chủ sở hữu — firebird (hoặc người dùng dịch vụ nút), quyền 2770. Nếu nút không tạo được, cửa sổ sẽ hiện lệnh cho máy chủ bản sao. Nếu bạn chỉ thư mục khác, RCM sẽ ghi nó vào databases.root của nút bản sao trước khi khởi tạo;

  • thủ công trên máy chủ bản sao (Linux):

    Command
    sudo mkdir -p /databases/replica
    sudo chown firebird:firebird /databases/replica
    sudo chmod 2770 /databases/replica

    Bit setgid (2770) cần để mọi tệp bên trong nhận nhóm Firebird.

Bạn chỉ đổi được gốc bản sao khi nó chưa có cơ sở dữ liệu: nếu không các cơ sở dữ liệu cũ sẽ nằm ngoài lần quét. Để đặt một cơ sở dữ liệu ở chỗ khác, hãy dùng Di chuyển trên trang cơ sở dữ liệu.

Quyền

Nút bản sao và Firebird phải ghi được vào gốc cơ sở dữ liệu. Nút kiểm tra rằng các tệp được đặt sẽ nhận nhóm của thư mục. Nếu không — nó từ chối với ownership_unfixable và văn bản cách sửa (thường dịch vụ nút chạy với Group=root).

Với HQbird 2027.2.24, cửa sổ Khởi tạo cũng hiện một thư mục tồn tại nhưng dịch vụ nút không ghi được: văn bản của nút kèm lệnh sửa và nút Kiểm tra lại. RCM 2027.5.7 trong trường hợp này nói „Thư mục tồn tại“: hãy tự kiểm tra quyền (hqbirdrcm checkpermissions -node <replica> -root <folder>).

Phiên bản Firebird

Phiên bản chính của Firebird trên bản sao phải khớp phía chính (5.0 → 5.0, 4.0 → 4.0). Nếu không bản sao sẽ từ chối trước mọi lần chuyển dữ liệu: incompatible_engine.

Kết nối

Nút bản sao phải là đối tác của phía chính, và phía chính phải là đối tác của bản sao (chương 2). Nếu không RCM sẽ không đề nghị nút này trong cửa sổ Khởi tạo.

4.4. Cần bao nhiêu chỗ

Tóm tắt

Ở đâu Cái gì Bao nhiêu
Phía chính, ổ cơ sở dữ liệu trống trước khi khởi tạo ≥ 105 % kích thước cơ sở dữ liệu
Bản sao, ổ thư mục cơ sở dữ liệu trống trước khi khởi tạo ≥ 105 % kích thước cơ sở dữ liệu, với HQbird 2027.2.24 — cộng free_space_floor_gb (cộng tệp cũ, nếu bản sao đã tồn tại; với hộp Xóa bản sao cũ — không tính tệp đó)
Phía chính, <database>.ReplLog phân đoạn làm việc của Firebird tới 64 phân đoạn × kích thước phân đoạn (mặc định 16 MB) ≈ 1 GB mỗi cơ sở dữ liệu
Phía chính, <database>.LogArch kho phân đoạn cho các bản sao thay đổi trong retention_days (mặc định 2 ngày) + phần các bản sao chưa xác nhận
Bản sao, <database>.Incoming hàng đợi phân đoạn chờ áp dụng tới 256 phân đoạn × 16 MB ≈ 4 GB mỗi cơ sở dữ liệu trong trường hợp xấu nhất
Bản sao, cả ổ phần dự phòng ít nhất free_space_floor_gb (mặc định 1 GB)

Kiểm tra chỗ trước khi khởi tạo

Khởi tạo kiểm tra chỗ hai lần và chỉ trước khi khóa cơ sở dữ liệu:

  1. RCM — từ thống kê nút mới nhất, trước khi gửi lệnh. Nếu chỗ rõ ràng không đủ, RCM trả ngay lỗi 507.
  2. Nút chính — đo trực tiếp trên ổ của nó, rồi yêu cầu bản sao đo ổ của bản sao. Nếu ít nhất một phía không đủ, khởi tạo kết thúc ở bước SPACE CHECK với lỗi insufficient disk space on master hoặc … on replica.

Yêu cầu ở cả hai phía là 105 % kích thước cơ sở dữ liệu phía chính.

Với HQbird 2027.2.24 nút bản sao tính như sau:

  • nó cần 105 % kích thước cơ sở dữ liệu cộng free_space_floor_gb của bản sao (7.3): sau khởi tạo trên ổ còn phần dự phòng cho phân đoạn;
  • phần sót của các lần khởi tạo trước (<database>.hqcluster-part, <database>.new) được tính là chỗ trống: nút xóa chúng trước bản sao mới;
  • văn bản lỗi nêu mọi con số. Nó cũng nêu các tệp <database>.pre-reinit-*.fdb và <database>.failed-seed-*.fdb kèm kích thước. Nút không bao giờ xóa chúng: hãy tự xóa nếu không cần.

force (cưỡng bức) chỉ bỏ qua kiểm tra trong RCM. Kiểm tra của nút không thể bỏ qua: nó bảo vệ nút khỏi hết đĩa giữa chừng sao chép. Nếu chỗ chỉ thiếu vì bản sao cũ, RCM 2027.2.24 trong lỗi 507 nêu hộp Xóa bản sao cũ chứ không phải force. Để làm vậy cả hai nút phải là HQbird 2027.2.24 hoặc mới hơn. Nếu không lỗi nêu nút cần cập nhật, và force.

Vì sao nhiều vậy

Phía chính. Trong lúc sao chép cơ sở dữ liệu bị khóa bởi nbackup -L. Mọi thay đổi được ghi vào tệp <database>.delta cạnh cơ sở dữ liệu. Kích thước .delta phụ thuộc tải ghi trong lúc sao chép. Dưới tải nặng và truyền chậm nó có thể lớn đáng kể — hãy theo dõi chỗ trong lần khởi tạo đầu.

Bản sao. Bản sao được ghi thẳng vào tệp <database>.hqcluster-part cạnh vị trí cơ sở dữ liệu. Nút dành trước toàn bộ kích thước. Tệp rồi được kiểm tra, sửa (nbackup -FIXUP -SEQUENCE) và đổi tên vào chỗ. Không cần bản sao thứ hai — kích thước cơ sở dữ liệu chỉ cần một lần, trên ổ cơ sở dữ liệu.

Nếu bản sao đã tồn tại (khởi tạo lặp), tệp cũ nằm trên đĩa đến bước cuối. Nghĩa là tệp cũ và bản sao mới cần cùng lúc trên ổ. Chỗ trống được tính không kể tệp cũ — vì vậy yêu cầu vẫn là: 105 % kích thước cơ sở dữ liệu còn trống.

Xóa bản sao cũ (với HQbird 2027.2.24). Nếu trên ổ bản sao không có chỗ cho bản sao mới cạnh bản cũ, hãy đánh dấu hộp này trong cửa sổ khởi tạo (chương 5.1). Nút bản sao khi đó xóa bản cũ và các phân đoạn đến (.Incoming) trước khi truyền, và ổ đủ cho 105 % kích thước cơ sở dữ liệu cộng free_space_floor_gb. Nút chỉ xóa bản sao nếu mọi điều kiện đều đúng:

  • không xóa thì không đủ chỗ, có xóa thì đủ;
  • đó là bản sao do khởi tạo của nút này cài: phần đầu đọc được, chế độ là bản sao chỉ đọc;
  • cơ sở dữ liệu chưa được làm thành thường (không có tệp <database>.hqcluster-normal.json, chương 8);
  • overwrite_non_replica chưa được đặt (5.9).

Nếu không nút không xóa gì và từ chối với lý do trong văn bản. Để xóa, nút dừng Firebird của bản sao trong lúc xóa (5.6).

Hộp mặc định tắt. Rủi ro: trong lúc truyền, trên bản sao không có bản sao cơ sở dữ liệu. Nếu cơ sở dữ liệu chỉ có một bản sao, phía chính không được bảo vệ suốt thời gian đó. Khi chưa có bản sao mới, cơ sở dữ liệu trên bản sao ở trạng thái NEEDS_REINIT (không phải FAILED và không phải ORPHANED), và bản sao phát cảnh báo replica_removed_for_reinit (warn). Khi bản sao mới vào chỗ, cảnh báo được gỡ. Nếu khởi tạo thất bại sau khi xóa, cặp vẫn NEEDS_REINIT: hãy bắt đầu khởi tạo lại (hoặc khởi tạo lại tự động sẽ bắt đầu, 5.8). Một lần khởi tạo mới chuyển cơ sở dữ liệu từ đầu.

Kho phía chính (.LogArch). Nút giữ các phân đoạn đã gửi trong retention_days ngày để bản sao có thể yêu cầu lại. Các phân đoạn mà bản sao chưa áp dụng được giữ lâu hơn. Nếu chỗ thấp, nút dọn kho theo giai đoạn:

  1. phân đoạn mọi bản sao đã áp dụng, cũ hơn retention_days;
  2. phân đoạn đã áp dụng nhưng mới hơn (khi chỗ ngắn);
  3. phân đoạn chưa áp dụng — chỉ là cách cuối. Khi đó bản sao mất các phân đoạn nó cần và nhận NEEDS_REINIT.

Nếu một bản sao không truy cập được lâu, kho lớn lên. Dung lượng của nó = thay đổi cơ sở dữ liệu trong khoảng thời gian ngừng.

Ví dụ tính

Cơ sở dữ liệu 100 GB. Tải — 5 GB phân đoạn mỗi ngày. Khởi tạo chạy ban đêm, sao chép mất 2 giờ, trong đó khoảng 2 GB vào .delta.

Ở đâu Cách tính Tổng chỗ trống
Phía chính, ổ cơ sở dữ liệu 105 GB cho các lần kiểm tra (gồm tăng .delta) + .ReplLog 1 GB + .LogArch 2 ngày × 5 GB = 10 GB ≥ 116 GB
Bản sao, cơ sở dữ liệu mới 105 GB + .Incoming tới 4 GB + 1 GB dự phòng ≥ 110 GB
Bản sao, khởi tạo lặp tệp cũ 100 GB đã trên đĩa + 110 GB trống ổ ≥ 210 GB
Bản sao, khởi tạo lặp với hộp Xóa bản sao cũ (với HQbird 2027.2.24) tệp cũ bị xóa trước khi truyền: 105 GB + .Incoming tới 4 GB + 1 GB dự phòng ổ ≥ 110 GB

Hãy thêm phần dự phòng cho cơ sở dữ liệu lớn lên và cho thời gian bản sao ngừng (kho phía chính tăng 5 GB mỗi ngày ngừng).

Phân đoạn trên một ổ riêng

Các thư mục .ReplLog, .LogArch và .Incoming mặc định nằm cạnh cơ sở dữ liệu. Chúng có thể chuyển sang ổ khác: tham số segments.storage trong node.json (với mirror_hierarchy: true nút lặp lại cấu trúc thư mục cơ sở dữ liệu). Khi đó kho không lấy chỗ của các cơ sở dữ liệu. Kiểm tra 105 % vẫn áp dụng cho ổ cơ sở dữ liệu.

Xem chỗ ở đâu

  • Cơ sở dữ liệu → Các nút và Tổng quan: biểu tượng chỗ trống cho ổ databases.root. Vàng — dưới 20 %, đỏ — dưới 10 %.

    Trang Cơ sở dữ liệu: cột Đĩa trong bảng Các nút
    Trang Cơ sở dữ liệu: cột Đĩa trong bảng Các nút
  • Báo cáo cụm: hqbirdrcm report.

4.5. Nhiều bản sao của một cơ sở dữ liệu

Bản sao thứ hai và các bản tiếp theo được tạo cùng cách: Khởi tạo ở dòng phía chính, chọn một nút bản sao còn trống.

  • Trong lúc một bản sao mới đang được khởi tạo, phía chính cũng không truyền cơ sở dữ liệu này tới các bản sao đang chạy. Chúng sẽ đuổi kịp phía chính sau khi khởi tạo xong. Cửa sổ xác nhận nói vậy.
  • Một cơ sở dữ liệu — một lần khởi tạo tại một thời điểm, kể cả cho các bản sao khác nhau.
  • Chỗ trên phía chính được kiểm tra riêng cho mỗi lần khởi tạo.
Cơ sở dữ liệu phía chính với hai bản sao
Cơ sở dữ liệu phía chính với hai bản sao

4.6. Bản sao cấu hình thủ công

Nếu một bản sao đã chạy từ replication.conf viết tay, bạn có thể đưa nó vào quản lý và không sao chép lại cơ sở dữ liệu:

  1. Phía chính: đăng ký các cơ sở dữ liệu với detect_existing (chương 3.6).
  2. Bản sao: Cơ sở dữ liệu → nút bản sao → Tiếp quản, hoặc hqbirdrcm takeover-replica. RCM sẽ tìm các khối bản sao, khớp tệp với cơ sở dữ liệu phía chính theo GUID và hiện cho mỗi cái: in_sync, resumable hoặc needs_reinit.
  3. Xác nhận các dòng. Nút sẽ chuyển các khối vào vùng replication.conf của nó.
  4. Khởi động lại Firebird của bản sao để nó đọc các khối đã chuyển.
  5. Chỉ khởi tạo các dòng needs_reinit: kho phía chính không còn chứa các phân đoạn mà các bản sao này cần.

4.7. Lỗi thường gặp

Bạn thấy gì Nguyên nhân Việc cần làm
insufficient disk space on master / on replica không đủ chỗ (4.4). Khi khởi tạo lại bản cũ chiếm chỗ đến cuối (4.4) giải phóng chỗ, thử lại. Cách thứ hai trên bản sao (từ HQbird 2027.2.24) là hộp Xóa bản sao cũ (4.4, 5.1)
507 từ RCM ngay lập tức theo thống kê chỗ rõ ràng không đủ tương tự. Nếu có chỗ khi không tính bản cũ, RCM 2027.2.24 nêu hộp Xóa bản sao cũ
incompatible_engine khác phiên bản chính của Firebird nâng Firebird của bản sao
Thiếu thư mục trên nút bản sao gốc chưa được tạo Tạo thư mục trong cửa sổ khởi tạo (4.3)
Thư mục tồn tại, nhưng dịch vụ nút không ghi được (từ HQbird 2027.2.24) không có quyền ghi chạy lệnh từ cửa sổ, bấm Kiểm tra lại (4.3)
publication_off (từ HQbird 2027.2.24) công bố phía chính tắt hoặc không có bảng Đồng bộ công bố và khởi tạo (5.1)
ownership_unfixable dịch vụ nút có nhóm lạ sửa nhóm dịch vụ như văn bản lỗi mô tả
duplicate_guid hai cơ sở dữ liệu cùng GUID (bản sao tệp) gỡ bản sao hoặc cấp GUID mới (nbackup -F)
Nút bản sao không có trong danh sách Khởi tạo không có kết nối trong các đối tác chương 2
Bản sao IN_SYNC, nhưng dữ liệu lệch công bố đã bị tắt đồng bộ công bố, rồi lặp lại khởi tạo

5. Khởi tạo (reinit)

Khởi tạo là chuyển một bản sao cơ sở dữ liệu phía chính sang bản sao. Lần chuyển đầu gọi là khởi tạo (nút Khởi tạo), lần chuyển lặp là khởi tạo lại (nút Khởi tạo lại). Cơ chế giống nhau.

Trước khi bắt đầu, hãy hoàn thành bước 1–5 từ chương 4: cơ sở dữ liệu đã đăng ký, Firebird phía chính đã khởi động lại, công bố đã bật, thư mục bản sao tồn tại, và có đủ chỗ. Cần bao nhiêu chỗ trên phía chính và trên bản sao được mô tả ở chương 4.4.

5.1. Cách bắt đầu

Công bố trước. Đăng ký một cơ sở dữ liệu không gồm công bố. Không có công bố, bản sao không nhận thay đổi. Trước khi khởi tạo, hãy chạy Đồng bộ công bố (chương 6) hoặc hqbirdrcm setpublication -node <master>.

  • Với HQbird 2027.2.24, cửa sổ khởi tạo kiểm tra công bố. Nếu nó tắt hoặc không có bảng có khóa, cửa sổ hiện một cảnh báo và nút Đồng bộ công bố và khởi tạo. RCM đồng bộ công bố, đợi lệnh xong và bắt đầu khởi tạo với lựa chọn từ cửa sổ.
  • Nút chính 2027.2.24 tự từ chối khởi tạo như vậy (kể cả lần đầu) với lỗi publication_off và phát thông báo master_publication_off (chương 6.1). Sau khi từ chối, ô cơ sở dữ liệu lại có nút Đồng bộ công bố và khởi tạo.
  • Nếu người vận hành tắt công bố (6.4) hoặc gỡ mọi bảng có khóa khỏi nó (6.3), việc đồng bộ giữ nguyên điều đó. RCM không bắt đầu khởi tạo và đưa liên kết tới trang Bảng công bố.
  • RCM và nút 2027.5.7 không kiểm tra công bố: khởi tạo thành công, cơ sở dữ liệu hiện „Ổn“ trong RCM, nhưng bản sao không nhận thay đổi. Nếu công bố được bật sau khởi tạo — hãy khởi tạo lại cơ sở dữ liệu.
Cửa sổ „Khởi tạo lại cơ sở dữ liệu?“
Cửa sổ „Khởi tạo lại cơ sở dữ liệu?“
  1. Mở Cơ sở dữ liệu.
  2. Ở dòng cơ sở dữ liệu phía chính, trong cột nút bản sao, bấm Khởi tạo. Nút bản sao do cột xác định: nó không được chọn trong cửa sổ. Với cặp đã có — Khởi tạo lại trong thẻ phía chính đã mở rộng.
  3. Trong cửa sổ (với HQbird 2027.2.24 tiêu đề cho cặp mới là „Khởi tạo cơ sở dữ liệu?“; trong RCM 2027.5.7 — „Khởi tạo lại cơ sở dữ liệu?“ và cả ở lần khởi tạo đầu):
    • kiểm tra Thư mục bản sao. Cửa sổ hiện thư mục có tồn tại không. Nếu không, hãy bấm Tạo thư mục: nút bản sao sẽ tạo nó (4.3). Nếu nút không tạo được, cửa sổ hiện lệnh cho máy chủ bản sao. Với HQbird 2027.2.24 cửa sổ cũng hiện một thư mục mà dịch vụ nút không ghi được: lệnh sửa và nút Kiểm tra lại;
    • chọn Phương pháp khởi tạo lại: Mượt (khuyên dùng) hoặc Chuẩn (5.4). Với HQbird 2027.2.24, nếu kho phía chính chưa có phân đoạn (thường trước lần khởi tạo đầu), cửa sổ hiện gợi ý: trên cơ sở dữ liệu bận Chuẩn nhanh hơn;
    • nếu cơ sở dữ liệu phía chính vẫn chờ khởi động lại Firebird, cửa sổ sẽ nói vậy và hiện nút Khởi động lại Firebird chính. Không có lần khởi động lại thì cơ sở dữ liệu không được sao chép;
    • Xóa bản sao cũ (với HQbird 2027.2.24, mặc định tắt) chỉ cần khi khởi tạo lại mà ổ bản sao không có chỗ cho bản sao mới cạnh bản cũ (4.4). Cửa sổ hiện trước các con số: cần bao nhiêu, còn trống bao nhiêu, bản cũ chiếm bao nhiêu. Nếu có chỗ khi không tính bản cũ, cửa sổ yêu cầu đánh dấu hộp. Hộp không hoạt động nếu nút chính hoặc bản sao là phiên bản cũ: cửa sổ nêu nút nào cần cập nhật. Cho đến khi bản sao mới sẵn sàng, bản sao không có bản sao của cơ sở dữ liệu này (4.4).
  4. Xác nhận. RCM sẽ nêu rằng cơ sở dữ liệu sẽ bị khóa trên phía chính và được sao chép sang bản sao.

Tiến độ khởi tạo hiện trong thẻ phía chính đã mở rộng trên trang Cơ sở dữ liệu: các bước và phần trăm. Với HQbird 2027.2.24 tiến độ cũng hiện sau khi làm mới trang: ở lần khởi tạo đầu — trong ô nút bản sao, và cả ở dòng Tiến độ khởi tạo lại trên trang cơ sở dữ liệu phía chính. Nút Khởi tạo không hoạt động khi nút chính đang sao chép cơ sở dữ liệu. Nếu RCM không theo dõi lần khởi tạo này (ví dụ nó được bắt đầu từ dòng lệnh của nút), các bước được lấy từ trạng thái nút, không có phần trăm. Trong RCM 2027.5.7, sau khi làm mới trang tiến độ của lần khởi tạo đầu không hiện: hãy đợi đến khi cơ sở dữ liệu phía chính rời SEEDING.

Các bước khởi tạo ở dòng phía chính
Các bước khởi tạo ở dòng phía chính

Mỗi lệnh RCM (khởi tạo, khởi động lại Firebird, đồng bộ công bố) được ghi trên trang Lệnh kèm kết quả.

Trang „Lệnh“
Trang „Lệnh“

Tương tự từ dòng lệnh

Command
# one database
hqbirdrcm reinit -node node-a -db <db_id> -to node-b
# all master databases
hqbirdrcm reinit -node node-a -all -to node-b

Tham số: -mode smooth|standard (mặc định smooth), -hold=false (không giữ kho trong các giao dịch dài), -allow-restart (5.6), -force (5.9).

-remove-old-replica (với HQbird 2027.2.24) — giống hộp Xóa bản sao cũ. Chỉ cho một cơ sở dữ liệu: -db và -to là bắt buộc; với -all lệnh từ chối. Nếu nút chính hoặc bản sao là phiên bản cũ, RCM từ chối với node_too_old và không gửi gì.

Command
hqbirdrcm reinit -node node-a -db <db_id> -to node-b -remove-old-replica

-all thử mọi cơ sở dữ liệu và gom lỗi thay vì dừng ở lỗi đầu.

5.2. Các bước

Số Bước (trong RCM) Chuyện gì xảy ra
1 SPACE CHECK kiểm tra chỗ trên phía chính và trên bản sao (chương 4.4); bản sao kiểm tra trước rằng nó nhận được tệp
2 LOCKING nbackup -L: tệp cơ sở dữ liệu phía chính bị đóng băng, thay đổi đi vào <database>.delta
3 COPYING TO NODE tệp được chuyển theo phần: đọc → tổng kiểm → nén → gửi
4 UNLOCKING nbackup -N ngay sau khi truyền: thay đổi từ .delta được trả về cơ sở dữ liệu
5 SEEDING trên bản sao: kiểm tra tổng kiểm của tệp, nbackup -FIXUP -SEQUENCE, cài tệp, gfix -replica, ghi khối vào replication.conf
6 RESTARTING REPLICA khởi động lại Firebird của bản sao, nếu cần (5.6)

Sau bước 6 cơ sở dữ liệu nhận trạng thái IN_SYNC. Phía chính tiếp tục gửi phân đoạn từ điểm bản sao kết thúc.

Điều quan trọng cần biết:

  • Phía chính chạy suốt. Người dùng ghi vào cơ sở dữ liệu, thay đổi đi vào .delta. Khóa được thả ngay sau khi truyền.
  • Các giao dịch trùng lúc khóa không mất. Nút tìm các giao dịch đang mở lúc nbackup -L, và bản sao phát lại chúng từ các phân đoạn.
  • Việc truyền tiếp tục sau khi gián đoạn. Nếu kết nối hoặc nút bản sao khởi động lại, phía chính sẽ tiếp tục từ phần nhận được cuối. Một lần truyền chưa xong được giữ trên bản sao 24 giờ (reinit_partial_keep_hours).
  • Khi có lỗi nút thả khóa, xóa tệp chưa xong trên bản sao và đặt cơ sở dữ liệu thành FAILED. Lần thử tiếp theo bắt đầu từ trạng thái đã biết.
  • Với hộp „Xóa bản sao cũ“ (từ HQbird 2027.2.24) bản sao xóa bản cũ sau bước LOCKING, trước khi truyền. Bước COPYING TO NODE lúc này hiện „đang gỡ bản sao cũ của bản sao để lấy chỗ“. Lỗi sau khi xóa cho cặp NEEDS_REINIT chứ không phải FAILED (chương 4.4).
  • Chỉ nbackup. gbak không được dùng: nó đổi GUID cơ sở dữ liệu.

5.3. Ảnh hưởng tới vận hành

Cái gì Ảnh hưởng
Người dùng của phía chính vẫn làm việc; trong lúc sao chép .delta lớn lên, sau -N các thay đổi được chuyển vào cơ sở dữ liệu
Các bản sao khác của cơ sở dữ liệu này không nhận phân đoạn của cơ sở dữ liệu này khi khởi tạo đang chạy; chúng đuổi kịp sau đó
Các cơ sở dữ liệu khác của phía chính không bị ảnh hưởng
Firebird của bản sao, cơ sở dữ liệu mới không bị dừng; khởi động lại theo 5.6
Firebird của bản sao, khởi tạo lặp bị dừng trong lúc tệp được thay: mọi cơ sở dữ liệu của Firebird này không dùng được trong vài giây
Firebird của bản sao, nút xóa bản cũ (hộp „Xóa bản sao cũ“, từ HQbird 2027.2.24) bị dừng sớm hơn, trong lúc xóa, trước khi truyền. Nút cài bản mới mà không dừng lần thứ hai nếu khối cơ sở dữ liệu trong replication.conf không đổi. Nếu đủ chỗ và không cần xóa, nút không xóa gì, và mọi thứ diễn ra như khởi tạo lặp bình thường
Mạng và đĩa tải theo các giới hạn tốc độ (5.5)

Trên Windows. Tệp mà Firebird đang mở không thay được. Trong khởi tạo lặp nút dừng Firebird của bản sao qua fbagent, cài tệp và khởi động lại Firebird. Trên Linux Firebird cũng bị dừng trước khi thay: nếu không nó sẽ tiếp tục làm việc với tệp cũ đã xóa.

5.4. Phương pháp mượt và chuẩn

Mượt (mặc định). Trước khi khóa, nút tìm giao dịch dài: các giao dịch ghi của người dùng bắt đầu trước phân đoạn cũ nhất trong kho phía chính. Sau khởi tạo bản sao sẽ không phát lại được chúng và sẽ dừng ở thay đổi đầu tiên của chúng („Không tìm thấy giao dịch …“). Giao dịch không có thay đổi không được tính.

Nếu có các giao dịch như vậy, khởi tạo không bắt đầu: RCM hiện Khởi tạo lại mượt đang chờ các giao dịch dài và đưa liên kết Mở danh sách.

Trang giao dịch dài: không có giao dịch dài
Trang giao dịch dài: không có giao dịch dài

Trên trang Giao dịch dài:

  • tóm tắt: bao nhiêu giao dịch và kết nối, phân đoạn cũ nhất;
  • 5 kết nối đầu với các giao dịch cũ nhất: người dùng, máy khách, bắt đầu, tuổi, thay đổi, truy vấn hiện tại;
  • Giữ phân đoạn / Thả giữ — khi việc giữ được bật, kho phía chính không bị dọn và lịch sử không bị cắt;
  • Ngắt kết nối mục đã chọn và thử khởi tạo lại — ngắt các kết nối (giao dịch của chúng bị hoàn tác) và lập tức bắt đầu một lần khởi tạo lại mượt;
  • Thử khởi tạo lại, Kiểm tra lại.

Việc giữ được bật tự động khi một lần khởi tạo lại bị từ chối vì giao dịch dài. Nó được thả sau khởi tạo thành công, bằng tay, hoặc khi kho lớn tới reinit_hold_max_segments (mặc định 1000 phân đoạn, thông báo retention_hold_released).

Chuẩn khóa cơ sở dữ liệu ngay, không kiểm tra. Chỉ dùng nếu bạn biết không có giao dịch ghi dài.

Khởi tạo đầu dưới tải. Khi kho phía chính trống, không có phân đoạn để so.

Với nút chính HQbird 2027.2.24: nếu nút tự bật công bố và kho không đổi từ đó, lịch sử bắt đầu ở lúc công bố được bật. Giao dịch bắt đầu sau đó vào nhật ký từ thay đổi đầu tiên và không cản phương pháp mượt. Giao dịch bắt đầu sớm hơn không vào nhật ký: lần khởi tạo lại chờ nó trước khi khóa (6 lần thử mỗi 10 giây), và bước locking hiện số, kết nối và người dùng của nó. Nếu nó chưa xong, lần khởi tạo lại kết thúc với lỗi reinit_pre_publication_transactions: hãy kết thúc nó và thử lại. Trang Giao dịch dài hiện các giao dịch như vậy trong bảng Giao dịch bắt đầu trước khi công bố được bật.

Nếu công bố được bật thủ công, không qua nút, hoặc kho đã đổi, điểm bắt đầu lịch sử không biết. Khi đó phương pháp mượt từ chối nếu bất kỳ giao dịch ghi nào đang mở, và thông báo nói kho chưa chứa một phân đoạn. Trong trường hợp này RCM 2027.2.24 không mở danh sách mà ghi việc cần làm vào ô của cơ sở dữ liệu. Hãy chọn Chuẩn hoặc thử lại khi Firebird lưu phân đoạn đầu.

Với nút chính 2027.5.7, phương pháp mượt từ chối ngay ở lần khởi tạo đầu của cơ sở dữ liệu đang được ghi: long_transactions … segment 0 (0001-01-01T00:00:00Z). Với lần khởi tạo đầu của cơ sở dữ liệu như vậy, hãy chọn Chuẩn.

Với các lần khởi tạo lại sau, phương pháp mượt hoạt động như thường (kho đã tồn tại).

Tương tự từ dòng lệnh

Command
hqbirdrcm longtx -node node-a -db <db_id>                       # list
hqbirdrcm longtx -node node-a -db <db_id> -disconnect 12,34 -retry-to node-b
hqbirdrcm longtx -node node-a -db <db_id> -hold false           # release hold

Giao dịch cũ hơn công bố. Firebird không ghi vào phân đoạn một giao dịch bắt đầu trước khi công bố được bật. Nếu nút đã bật công bố, khởi tạo chờ (6 lần thử mỗi 10 giây) đến khi các giao dịch như vậy kết thúc; nếu không nó kết thúc với lỗi reinit_pre_publication_transactions liệt kê chúng. Sau khi đồng bộ một công bố đã thêm bảng, hãy nối lại các ứng dụng, rồi bắt đầu khởi tạo.

5.5. Tốc độ

Khi nào Tốc độ Cài đặt
Trong cửa sổ truyền windows.transfer_window (mặc định 23:00-05:00) cố định limits.reinit_window_mbps, mặc định 100 MB/s
Ngoài cửa sổ một phần tốc độ đĩa đã đo limits.reinit_day_disk_fraction, mặc định 0.5

Nút tính lại chế độ mỗi 30 giây: một lần khởi tạo bắt đầu ban ngày sẽ tự nhanh lên ban đêm.

Nút đo tốc độ đĩa bằng một thử nghiệm. Để lặp thử nghiệm trên máy chủ phía chính:

Command
hqclusternode benchmark -config /opt/hqclusternode/master/node.json

Thời gian khởi tạo ≈ kích thước cơ sở dữ liệu ÷ tốc độ. Ví dụ: 100 GB ở 100 MB/s — khoảng 17 phút truyền thuần; trên thực tế bị giới hạn bởi mạng hoặc đĩa.

5.6. Khởi động lại Firebird bản sao

Cơ sở dữ liệu mới trên bản sao. Tệp được đặt mà không dừng Firebird. Firebird chỉ đọc khối replication.conf mới sau khi khởi động lại. Cho đến lúc đó bản sao không áp dụng gì. Bước RESTARTING REPLICA hiện việc chờ:

Nhãn Nghĩa
đang chờ khởi động lại Firebird trên bản sao, đã xếp lịch vào … nút sẽ tự khởi động lại Firebird sau lần khởi tạo cuối (reinit_restart_delay_sec), khi các lần khởi tạo khác đã xong
… cửa sổ khởi động lại đang đóng, cửa sổ tiếp theo sẽ mở vào … đang chờ restart_window của bản sao
… lần thử cuối thất bại, lần tiếp theo vào … sẽ thử lại sau
bản sao không thể tự khởi động lại Firebird: hãy khởi động lại thủ công auto_restart: never, hoặc Firebird này cũng phục vụ các cơ sở dữ liệu phía chính

Nút khởi động lại Firebird một lần sau một loạt lần khởi tạo, không phải sau mỗi cơ sở dữ liệu.

Để khởi động lại thủ công, hãy bấm Khởi động lại Firebird bản sao. Việc chờ kết thúc sau bất kỳ lần khởi động lại Firebird thành công nào hoặc khi bản sao đã áp dụng một phân đoạn mới hơn bản sao.

Khởi tạo lại trên một Firebird cũng phục vụ các cơ sở dữ liệu phía chính. Nút không tự dừng Firebird như vậy và từ chối với restart_not_allowed. Hãy bắt đầu khởi tạo lại và đánh dấu Cho phép <nút> dừng Firebird cho lần khởi tạo lại này (-allow-restart trên dòng lệnh) — vào lúc các kết nối của Firebird này có thể bị cắt, kể cả tới các cơ sở dữ liệu phía chính của nó. Hãy chạy các lần khởi tạo như vậy từng cái một trên mỗi máy chủ.

Xóa bản cũ (hộp Xóa bản sao cũ, với HQbird 2027.2.24) cũng dừng Firebird của bản sao, theo cùng quy tắc. Nếu nút không thể tự dừng Firebird này, nó không xóa gì và từ chối với restart_not_allowed: cũng hãy đánh dấu Cho phép <nút> dừng Firebird cho lần khởi tạo lại này. Nếu lúc đó một lần khởi tạo khác đang kết thúc trên bản sao hoặc Firebird đang khởi động lại, nút không xóa gì và từ chối với engine_busy: phía chính thả khóa, hãy thử lại sau.

5.7. Hàng đợi và các lần khởi tạo đồng thời

  • Một cơ sở dữ liệu — một lần khởi tạo tại một thời điểm (kể cả cho các bản sao khác nhau). Nút Khởi tạo bị tắt khi lần khởi tạo của cơ sở dữ liệu này đang chạy.
  • Nút chính thực thi limits.max_concurrent_reinits lần khởi tạo của các cơ sở dữ liệu khác nhau cùng lúc (mặc định 1). Phần còn lại chờ trong hàng đợi; phản hồi chứa vị trí trong hàng.
  • Đừng chạy nbackup -L của riêng bạn (hoặc ALTER DATABASE BEGIN BACKUP) trên một cơ sở dữ liệu trong lúc nó đang khởi tạo, và đừng bắt đầu khởi tạo trong lúc sao lưu như vậy: một cơ sở dữ liệu chỉ có một khóa. Khởi tạo kiểm tra điều này và từ chối với nbackup backup lock already active.

Hàng đợi và các lần truyền hiện tại hiện trên trang Truyền.

Trang Truyền / hàng đợi
Trang Truyền / hàng đợi
  • Nếu một tệp <database>.delta còn lại sau lỗi, hãy chắc không có bản sao lưu đang chạy và chạy nbackup -N <database>. Đừng xóa .delta bằng tay.

5.8. Khởi tạo lại tự động

RCM có thể tự khởi tạo lại một cơ sở dữ liệu ở trạng thái NEEDS_REINIT, chỉ trong một cửa sổ đã cấu hình. Mặc định tắt.

Khi một cơ sở dữ liệu vào NEEDS_REINIT:

Nguyên nhân Hiện ở đâu
lỗi áp dụng không phục hồi được lặp lại (vi phạm PK, UNIQUE, FK) — 3 lần liên tiếp bản sao, cảnh báo replication_unrecoverable_error
GUID cơ sở dữ liệu phía chính đã đổi (khôi phục, thay tệp) bản sao, cảnh báo replication_guid_mismatch
kho phía chính không còn chứa các phân đoạn mà bản sao cần phía chính
bản sao đã xóa bản cũ để khởi tạo và chưa có bản mới (từ HQbird 2027.2.24) bản sao, cảnh báo replica_removed_for_reinit; phía chính

Để bật — Cài đặt → RCM (hoặc rcm.json, mục auto_reinit):

json
"auto_reinit": {
  "enabled": true,
  "default_window": "22:30-04:00",
  "max_concurrent": 1,
  "nodes": {
    "node-a": { "window": "23:00-05:00",
                "databases": { "sales/employee.fdb": "01:00-03:00" } }
  }
}
  • Cửa sổ: theo cơ sở dữ liệu → theo nút → toàn cục. "always" — bất kỳ lúc nào.
  • Các cửa sổ được tính theo đồng hồ của máy chủ RCM.
  • max_concurrent — bao nhiêu lần khởi tạo (thủ công và tự động) được chạy trong cụm để RCM bắt đầu thêm một lần tự động.
  • Khởi tạo tự động đi qua cùng các kiểm tra chỗ và GUID như khởi tạo thủ công. Tác giả lệnh là system:autoreinit.
  • remove_old_replica_when_short (từ HQbird 2027.2.24, dòng Xóa bản sao cũ khi thiếu chỗ) — mặc định tắt. Nếu bật, khởi tạo tự động gửi cờ Xóa bản sao cũ (4.4). RCM chỉ gửi nó nếu bản thân bản sao ở NEEDS_REINIT hoặc nguyên nhân NEEDS_REINIT của phía chính nêu tên nó. Với bản sao đang IN_SYNC hoặc LAGGING cờ không bao giờ được gửi. Nếu nút là phiên bản cũ hơn, RCM bắt đầu cùng lần khởi tạo mà không có cờ.
  • Sau khi đổi, hãy khởi động lại RCM.

Hoãn trong thẻ phía chính tắt khởi tạo tự động của một cơ sở dữ liệu trong 1 giờ, 4 giờ, 24 giờ hoặc đến khi hủy. Khởi tạo thủ công vẫn dùng được.

5.9. Lỗi

Lỗi Nguyên nhân Việc cần làm
insufficient disk space on master / on replica, 507 không đủ chỗ. Trong lúc khởi tạo lại bản cũ chiếm chỗ đến cuối chương 4.4; trên bản sao (từ HQbird 2027.2.24) — hộp Xóa bản sao cũ (5.1)
node_too_old (từ HQbird 2027.2.24) hộp Xóa bản sao cũ được đánh dấu, nhưng nút chính hoặc bản sao là phiên bản cũ nâng nút như văn bản lỗi nêu hoặc chạy không có hộp
engine_busy, reclaim_in_progress (từ HQbird 2027.2.24) bản sao không thể xóa bản cũ ngay lúc này: Firebird hoặc cơ sở dữ liệu này đang bận thử lại sau (5.6)
replica_removed_for_reinit, cặp NEEDS_REINIT (từ HQbird 2027.2.24) bản sao đã xóa bản cũ, nhưng khởi tạo chưa xong bắt đầu khởi tạo lại (4.4)
publication_off (từ HQbird 2027.2.24) công bố phía chính tắt hoặc không chứa bảng có khóa Đồng bộ công bố và khởi tạo (5.1)
long_transactions, „Khởi tạo lại mượt đang chờ các giao dịch dài“ các giao dịch ghi dài đang mở 5.4
long_transactions, „kho phía chính chưa chứa một phân đoạn nào“ khởi tạo đầu dưới tải Chuẩn (5.4)
reinit_pre_publication_transactions các giao dịch bắt đầu trước khi công bố được bật nối lại các ứng dụng, thử lại
duplicate_guid hai cơ sở dữ liệu phía chính cùng GUID gỡ bản sao; nếu bước NEW GUID bị bỏ qua khi thăng cấp thành chính — -force (chương 8.4)
license_paused fbagent của phía chính không có giấy phép chương 2.8
409 orphaned cơ sở dữ liệu nằm ngoài lần quét của phía chính chương 3.8
incompatible_engine khác phiên bản chính của Firebird chương 4.3
target_not_replica một cơ sở dữ liệu đang làm việc nằm ở chỗ bản sao (nó đã được làm thành thường) xem bên dưới
target_other_replica (từ HQbird 2027.2.24) một bản sao của cơ sở dữ liệu khác của nút này nằm ở chỗ bản sao xem bên dưới
restart_not_allowed Firebird của bản sao cũng phục vụ các cơ sở dữ liệu phía chính 5.6, hộp „Cho phép … dừng Firebird“
fbagent_required fbagent chưa được cài trên bản sao chương 1
nbackup backup lock already active một bản sao lưu nbackup đang chạy 5.7
… -L did not finish in 2m0s and was stopped nbackup -L trên phía chính không xong trong 2 phút, nên nút đã dừng nó thử lại; nếu lỗi lặp lại, hãy kiểm tra Firebird phía chính (firebird.log)
reinit already in progress for this database khởi tạo của cơ sở dữ liệu này đang chạy đợi nó xong

target_not_replica. Một cơ sở dữ liệu đang làm việc nằm ở chỗ bản sao: nó đã được làm thành thường (tệp <database>.hqcluster-normal.json tồn tại) hoặc nó không ở chế độ bản sao. Nút không ghi đè một cơ sở dữ liệu đang làm việc. Nếu cần thay, một yêu cầu tới API của nút với overwrite_non_replica: true (trong RCM không có nút cho việc này) sẽ thay tệp và giữ tệp cũ thành <database>.pre-reinit-<UTC time>.fdb.

target_other_replica (từ HQbird 2027.2.24). Bản sao đặt bản sao vào <databases.root>/<master id>/<database path>. Mã phía chính chỉ duy nhất trong cụm của chính nó, nên hai cơ sở dữ liệu có thể cùng một đường dẫn. Nút bản sao không ghi đè một bản sao thuộc về cơ sở dữ liệu khác của nó: lỗi nêu cơ sở dữ liệu đó và phía chính của nó. Nút cũng nhận ra một bản sao mà đường dẫn được ghi khác (liên kết tượng trưng hoặc điểm nối trong đường dẫn, tên thư mục Windows ngắn). overwrite_non_replica không gỡ lỗi này. Hãy chuyển một trong các bản sao sang thư mục khác hoặc gỡ cơ sở dữ liệu đó khỏi bản sao, rồi bắt đầu khởi tạo lại. Nút chỉ thấy các cơ sở dữ liệu của chính nó: hai nút bản sao trên cùng máy chủ phải có các thư mục bản sao khác nhau (databases.root).

5.10. Cách kiểm tra kết quả

  1. Cơ sở dữ liệu: cặp phía chính — bản sao trong nhóm là Ổn, trạng thái IN_SYNC.

  2. Xác minh trong thẻ phía chính: các nút đếm các dòng của bảng từ danh sách bảng của cơ sở dữ liệu (chương 3.1) trên phía chính và trên bản sao rồi so chúng. Hãy kiểm tra lúc yên: khi đang ghi tích cực các con số có thể khác.

    Với HQbird 2027.2.24 trang kết quả nêu danh sách của mỗi phía (ví dụ, „danh sách riêng của cơ sở dữ liệu này“ hoặc „bảng công bố (chưa đặt danh sách)“). RCM đếm bản sao bằng danh sách của phía chính. Một bảng vắng ở cả hai cơ sở dữ liệu được hiện là „không có trong cơ sở dữ liệu“ và không tính là lỗi. Nếu không có bảng nào được so, kết quả là „Không có bảng để so“, không phải lệch. Nếu việc so không xong trong thời gian dành cho, kết quả là „Chưa so (giới hạn thời gian)“, cũng không phải lệch.

Kết quả xác minh
Kết quả xác minh
Command
hqbirdrcm verifydata -master node-a -master-db <db_id> -replica node-b -replica-db <db_id>
  1. Kiểm tra định kỳ (tùy chọn): trang Kiểm tra dữ liệu, Bật cho mọi nút. Với HQbird 2027.2.24 nút áp dụng cài đặt ngay, không cần khởi động lại dịch vụ nút: sau Lưu RCM viết „Đã lưu và đã có hiệu lực“. Nút 2027.5.7 cần dịch vụ hqclusternode được khởi động lại, và RCM 2027.2.24 nói vậy. Các nút tự so số dòng khi phía chính và bản sao ở cùng phân đoạn. Một lệch nâng cảnh báo data_mismatch; rồi hãy chạy Xác minh.

Một bảng mà người vận hành đã gỡ khỏi công bố được hiện là „không được công bố“, không phải lệch.

6. Cấu hình công bố

Công bố cho Firebird phía chính biết thay đổi của bảng nào được ghi vào các phân đoạn. Không có công bố, bản sao không nhận gì.

6.1. Công bố là gì

Trong Firebird 4 và 5, các bảng được sao chép do công bố RDB$DEFAULT xác định:

  • Công bố được bật — trong RDB$PUBLICATIONS nó có RDB$ACTIVE_FLAG = 1 (lệnh ALTER DATABASE ENABLE PUBLICATION).
  • Các bảng đã công bố — danh sách trong RDB$PUBLICATION_TABLES.

Firebird chỉ ghi thay đổi vào các phân đoạn cho các bảng đã công bố và chỉ khi công bố được bật. Việc đăng ký cơ sở dữ liệu (chương 3) không bật công bố. Công bố được bật bằng Đồng bộ công bố (6.2).

Nút chính kiểm tra công bố mỗi giờ (limits.publication_check_interval_sec, mặc định 3600). Nếu công bố tắt, nút kiểm tra mỗi 2 phút.

Trên trang Cơ sở dữ liệu, cơ sở dữ liệu phía chính có một biểu tượng:

Biểu tượng Nghĩa
công bố BẬT công bố được bật
công bố TẮT Firebird không ghi gì vào các phân đoạn, các bản sao không nhận thay đổi
công bố không rõ nút không đọc được trạng thái

Bộ lọc Công bố tắt hiện các cơ sở dữ liệu có công bố tắt hoặc không rõ.

Nếu một cơ sở dữ liệu có công bố tắt đã có bản sao, phía chính nâng cảnh báo master_publication_off.

Với HQbird 2027.2.24, phía chính cũng nâng cảnh báo này khi nó từ chối khởi tạo một cơ sở dữ liệu với lỗi publication_off (chương 5.1): công bố tắt hoặc không chứa bảng có khóa. Mức cảnh báo:

  • warn — cơ sở dữ liệu chưa có bản sao: khởi tạo đang chờ công bố;
  • serious — cơ sở dữ liệu đã có bản sao;
  • info — người vận hành đã tắt công bố.

Cảnh báo được gỡ khi công bố được sửa hoặc một lần khởi tạo khác đã bắt đầu.

6.2. Đồng bộ công bố

Dòng phía chính: công bố tắt
Dòng phía chính: công bố tắt

Bấm ở đâu:

  • ở dòng cơ sở dữ liệu phía chính trên trang Cơ sở dữ liệu. Khi công bố tắt, nút nằm cạnh biểu tượng;
  • trên trang cơ sở dữ liệu;
  • cho nhiều cơ sở dữ liệu: đánh dấu các dòng, trong danh sách Hành động chọn Đồng bộ công bố. RCM sẽ gửi một lệnh riêng cho mỗi cơ sở dữ liệu.
Xác nhận đồng bộ công bố
Xác nhận đồng bộ công bố

Nút làm gì (một giao dịch):

  1. Bật công bố. Nếu người vận hành tự tắt nó (6.4), nút không bật lại.
  2. Thêm vào công bố mọi bảng có khóa chưa có trong đó.
  3. Gỡ khỏi công bố các bảng không có khóa và các bảng mà người vận hành đã loại (6.3).
  4. Tắt việc tự thêm bảng mới (EXCLUDE ALL FROM PUBLICATION, rồi thêm các bảng cần thiết). Chỉ nút quyết định thành phần của công bố.
Dòng phía chính sau đồng bộ: công bố được bật
Dòng phía chính sau đồng bộ: công bố được bật

Bảng có khóa — bảng người dùng thường trực có khóa chính hoặc chỉ mục duy nhất đang hoạt động. Bảng hệ thống và bảng tạm không được công bố.

Việc đồng bộ cũng gỡ khỏi công bố các bảng không có khóa mà DBA đã thêm thủ công.

Nếu thành phần đã đúng, nút không đổi gì.

Khi nút từ chối:

Mã Lý do
no_publications HQbird 2.5/3.0 (6.6)
not_master nút không phải phía chính
reinit_in_progress đang khởi tạo cơ sở dữ liệu này
orphaned, database_failed, file_missing cơ sở dữ liệu nằm ngoài lần quét, đang lỗi, hoặc không có tệp

Mọi cơ sở dữ liệu của nút cùng lúc — chỉ từ dòng lệnh. Trên trang Lệnh kết quả được hiện theo từng cơ sở dữ liệu: xong, bỏ qua hoặc lỗi. Các cơ sở dữ liệu ở trạng thái FAILED hoặc SEEDING và các cơ sở dữ liệu không có tệp bị bỏ qua.

Tương tự từ dòng lệnh

Command
hqbirdrcm setpublication -node node-a -db <db_id>   # one database
hqbirdrcm setpublication -node node-a               # all node databases

Lệnh chờ tối đa 5 phút và in một dòng cho mỗi cơ sở dữ liệu. Khi lỗi, mã thoát là 1. -nowait — không chờ kết quả.

6.3. Bảng công bố

Trang „Bảng công bố“
Trang „Bảng công bố“

Mở Bảng công bố ở dòng cơ sở dữ liệu phía chính.

Trang hiện:

  • trạng thái công bố (bật/tắt, người vận hành đã tắt) và các bộ đếm;
  • mỗi bảng: tên, khóa và trạng thái.
Trạng thái Nghĩa
đã công bố thay đổi đi vào các phân đoạn
chưa công bố bảng có khóa, sẽ được thêm khi đồng bộ
đã loại người vận hành đã gỡ nó khỏi công bố
không có khóa không thể công bố

Trong cột khóa — khóa chính, hoặc, nếu không có, chỉ mục duy nhất có số trường nhỏ nhất.

Vì sao bảng không có khóa không thể công bố. Bản sao tìm dòng cho UPDATE và DELETE theo khóa. Không có khóa thì nó không tìm được dòng. Hãy thêm khóa chính hoặc chỉ mục duy nhất, rồi đồng bộ công bố.

Loại khỏi công bố / Trả về công bố:

  1. Đánh dấu các bảng.
  2. Bấm Loại khỏi công bố hoặc Trả về công bố.
  3. Nút lưu danh sách và đồng bộ công bố ngay.
Xác nhận „Loại khỏi công bố“
Xác nhận „Loại khỏi công bố“

Danh sách các bảng đã loại được lưu trên nút chính. Việc đồng bộ không đổi danh sách đó. Khi một bản sao được thăng cấp thành chính (chương 8), danh sách chuyển sang phía chính mới.

Xác minh (chương 5.10) hiện một bảng đã loại là „không được công bố“, không phải lệch.

6.4. Bật và tắt công bố

Trên trang Bảng công bố: Tắt công bố / Bật công bố.

  • Việc tắt là lựa chọn của người vận hành. Đồng bộ không bật lại công bố.
  • Các thay đổi khi công bố tắt (hoặc khi một bảng bị loại) không được gửi tới bản sao, kể cả sau khi bật lại.
  • Sau khi bật, hãy bấm Xác minh (chương 5.10). Nếu dữ liệu lệch — hãy khởi tạo lại bản sao (chương 5).

6.5. Bảng mới

Một bảng mới không tự vào công bố: nút tắt việc thêm tự động.

Sau DDL:

  1. Tạo khóa chính hoặc chỉ mục duy nhất trên bảng.
  2. Bấm Đồng bộ công bố.
  3. Nhờ các ứng dụng kết nối lại nếu cần khởi tạo lại. Firebird không ghi vào các phân đoạn các giao dịch bắt đầu trước khi công bố được bật; COMMIT RETAINING giữ giao dịch như vậy ở trạng thái mở. Khởi tạo chờ các giao dịch đó rồi thất bại với reinit_pre_publication_transactions (chương 5.4).
Bảng mới ở trạng thái „chưa công bố“
Bảng mới ở trạng thái „chưa công bố“

Các dòng ghi vào bảng mới trước khi đồng bộ sẽ không tới bản sao. Nếu có, hãy kiểm tra dữ liệu và, khi cần, khởi tạo lại bản sao.

6.6. HQbird 2.5 và 3.0

HQbird 2.5 và 3.0 không có công bố. Firebird ghi các phân đoạn nếu tệp plugin replconf chứa một khối phía chính. Các nút công bố trên các nút như vậy bị ẩn, và API trả lời no_publications.

Tập bảng do các tham số máy xác định:

Tham số Nghĩa
include_filter bảng nào được sao chép: tên hoặc mẫu, cách nhau bằng dấu phẩy; rỗng — mọi bảng
exclude_filter bảng nào không được sao chép

Các tham số được đổi trong Cài đặt → Tham số sao chép (chương 7.1). Trang Bảng công bố hiện chúng ở chế độ chỉ đọc, kèm liên kết Đổi trong cài đặt máy. Firebird đọc các giá trị mới sau khi khởi động lại.

Bảng công bố trên HQbird 3.0: bộ lọc của máy
Bảng công bố trên HQbird 3.0: bộ lọc của máy

Plugin replconf. Nút ghi tệp replconf.hqcluster.hqbird của nó trong thư mục Firebird. Firebird chỉ đọc tệp đó khi replconf.properties trỏ tới nó. Plugin phải được kích hoạt một lần:

  1. Cài đặt → Các nút, khối Plugin sao chép (HQbird 2.5 / 3.0). Khối hiện replconf.properties trỏ tới đâu và các vấn đề mà nút tìm thấy.

Plugin chưa kích hoạt: replconf.properties trỏ tới tệp HQbird DataGuard
Plugin chưa kích hoạt: replconf.properties trỏ tới tệp HQbird DataGuard
  1. Kích hoạt… Cửa sổ liệt kê việc nút sẽ làm: cài plugin, trỏ replconf.properties tới tệp của nút, chuyển các mục của tệp cũ. Chọn lúc nào: Chỉ trong cửa sổ khởi động lại nút hoặc Ngay bây giờ, bỏ qua cửa sổ khởi động lại.

Cửa sổ kích hoạt plugin
Cửa sổ kích hoạt plugin
  1. Sau khi Firebird khởi động lại, trường Đã kích hoạt hiện „có: máy đọc tệp của nút“.

Plugin đã được kích hoạt
Plugin đã được kích hoạt

Việc kích hoạt khởi động lại Firebird và ảnh hưởng mọi cơ sở dữ liệu của Firebird này. Hãy làm vào lúc yên.

7. Các tùy chọn sao chép khác

7.1. Tham số sao chép

Cài đặt → Tham số sao chép, biểu mẫu trình hướng dẫn
Cài đặt → Tham số sao chép, biểu mẫu trình hướng dẫn

Trang Cài đặt → Tham số sao chép đổi các khóa trong replication.conf cho các cơ sở dữ liệu đã chọn hoặc cho cả nút.

  1. Thêm phía chính và các bản sao — chọn các cơ sở dữ liệu. RCM nhóm chúng theo phiên bản Firebird và vai trò: biểu mẫu riêng cho phía chính và cho bản sao.

  2. Với mỗi tham số, chọn một hành động:

    Hành động Việc nó làm
    không đổi giá trị không bị đổi
    đặt giá trị một giá trị mới
    đặt lại (lên mức trên) gỡ giá trị riêng, lấy giá trị từ mức trên
    không ghi (giá trị Firebird) khóa không được ghi, giá trị Firebird được dùng
  3. Chọn nơi áp dụng: Vào các cơ sở dữ liệu đã chọn hoặc Làm mặc định cho các nút của chúng.

  4. Xem trước — các nút kiểm tra giá trị mà không đổi gì.

Xem trước các thay đổi
Xem trước các thay đổi
  1. Áp dụng. RCM gửi lệnh tới mỗi nút.

Giá trị lấy từ đâu (cột Hiện tại):

Nguồn Giá trị
cơ sở dữ liệu này đặt cho cơ sở dữ liệu
giá trị nút đặt làm mặc định cho nút
giá trị nút dựng sẵn giá trị nút trong mã
giá trị Firebird khóa không được ghi
từ tệp (chưa đặt ở đây) giá trị trong replication.conf, RCM chưa đổi
nút đã đặt chỉ đọc (đường dẫn, tiền tố)

Một nút không phản hồi hiện các cơ sở dữ liệu của nó là không chọn được. Các thay đổi cần fbagent (nếu không thì fbagent_required).

Ai khởi động lại Firebird (Firebird chỉ đọc replication.conf lúc khởi động):

Nút Ai
phía chính bạn khởi động lại: phía chính không bao giờ tự khởi động lại Firebird
bản sao với firebird.auto_restart: never bạn
bản sao mà Firebird cũng phục vụ các cơ sở dữ liệu của phía chính bạn
các bản sao khác nút khởi động lại trong cửa sổ khởi động lại của nó

Để khởi động lại thủ công, trang có nút Khởi động lại Firebird.

7.2. Các tham số chính

Phía chính, Firebird 4/5:

Tham số Nhãn trong RCM Giá trị nút Firebird Gợi ý
journal_archive_timeout Thời gian chờ kho 10 s 60 s Firebird chờ bao nhiêu giây trước khi đóng một phân đoạn chưa xong. Thấp hơn — bản sao gần phía chính hơn. Phải nhỏ hơn limits.data_check_quiet_sec (90)
journal_segment_count Số phân đoạn 64 8 bao nhiêu phân đoạn có thể nằm trong .ReplLog. Phải lớn hơn limits.backlog_critical (48)
journal_segment_size Kích thước phân đoạn — 16 MB từ 1 MB đến 512 MB; bên nhận không chấp nhận quá 512 MB
buffer_size — 1 MB

Nút cũng ghi log_errors = true (không đổi được) và disable_on_error = true.

Bản sao, Firebird 4/5:

Tham số Nhãn trong RCM Firebird Giá trị
apply_idle_timeout Tạm dừng khi rảnh 10 s tạm dừng khi không có phân đoạn mới
apply_error_timeout Tạm dừng sau lỗi áp dụng 60 s tạm dừng trước khi thử lại sau một lỗi
verbose_logging nút: true replication.log chi tiết; không nên tắt
skip_upddel_without_pk nút: true bỏ qua UPDATE/DELETE trên các bảng không có khóa

Chỉ Firebird 5: include_filter, exclude_filter, cascade_replication.

HQbird 2.5/3.0 — các khóa log_* cùng nghĩa: log_archive_timeout, log_segment_count, log_segment_size (không nhỏ hơn 2 × buffer_size). Khóa alert_command chỉ được đặt trong node.json.

Mỗi tham số có một gợi ý trong biểu mẫu RCM.

7.3. Kho lưu trữ

Kho <database>.LogArch trên phía chính được dọn theo giai đoạn:

  1. Các phân đoạn mà mọi bản sao đã áp dụng và cũ hơn retention_days.
  2. Nếu chỗ trống nhỏ hơn free_space_floor_gb — các phân đoạn đã áp dụng trẻ hơn thời gian giữ. Cảnh báo disk_serious_cleanup.
  3. Nếu chỗ vẫn thấp — các phân đoạn chưa áp dụng, bắt đầu từ phân đoạn cũ nhất. Bản sao nhận NEEDS_REINIT, cảnh báo replication_paused_reinit_scheduled.
Tham số (Cài đặt → Các nút, Lưu trữ và tệp) Mặc định
limits.retention_days — Giữ kho, ngày 2
limits.retention_min_kept_segments — Luôn giữ các phân đoạn cuối 0 (tắt)
limits.free_space_floor_gb — Chỗ trống tối thiểu 1 GB
Cài đặt → Các nút, „Lưu trữ và tệp“
Cài đặt → Các nút, „Lưu trữ và tệp“

Dọn kho thủ công:

Command
hqbirdrcm cleanuparchive -node node-a              # stages for all databases on the node
hqbirdrcm cleanuparchive -node node-a -db <db_id>  # a single database

-orphaned (chỉ cùng với -db) xóa mọi phân đoạn của cơ sở dữ liệu ở trạng thái ORPHANED (chương 3.8). Với bất kỳ cơ sở dữ liệu nào khác, nút trả lời not_orphaned. Đừng bao giờ chạy -orphaned trên bên cho của lần thăng cấp (chương 8.5).

7.4. Truyền: nén, tốc độ, cửa sổ

Nén được đặt theo từng đối tác: Cài đặt → Các nút → Đối tác, cột compress.

Giá trị Nghĩa
rỗng hoặc none không nén (mặc định)
zstd nén zstd

Thay đổi có hiệu lực ngay. Nén hữu ích trên mạng chậm.

Tốc độ truyền phân đoạn (Cài đặt → Các nút, Truyền và khởi tạo lại):

Tham số Mặc định Khi nào có hiệu lực
limits.channel_a_mbps — Tốc độ truyền phân đoạn 50 MB/s ngay
limits.channel_a_burst_mbps — Bùng truyền phân đoạn 200 MB ngay

Đơn vị là mebibyte (MiB), dù tên nói „mbps“. Mức bùng không thể nhỏ hơn tốc độ.

Cài đặt → Các nút, „Truyền và khởi tạo lại“
Cài đặt → Các nút, „Truyền và khởi tạo lại“

Cửa sổ thời gian (Cửa sổ thời gian):

Tham số Mặc định Khi nào có hiệu lực Ảnh hưởng gì
windows.restart_window — Cửa sổ khởi động lại Firebird phía chính 22:00-05:00, bản sao always ngay khi nào nút bản sao được khởi động lại Firebird
windows.transfer_window — Cửa sổ truyền 23:00-05:00 sau khi khởi động lại nút tốc độ khởi tạo đầy đủ (chương 5.5)

Nhãn cạnh mỗi trường hiện thay đổi có hiệu lực khi nào: ngay hoặc khởi động lại nút.

Cài đặt → Các nút, „Cửa sổ thời gian“
Cài đặt → Các nút, „Cửa sổ thời gian“

7.5. Kiểm tra dữ liệu

  • Xác minh — so một lần số dòng trên phía chính và trên bản sao (chương 5.10).
  • Kiểm tra dữ liệu — so định kỳ (chương 5.10). Nút thực hiện việc so khi phía chính và bản sao ở cùng phân đoạn.
  • Với HQbird 2027.2.24, cài đặt kiểm tra có hiệu lực ngay sau Lưu; không cần khởi động lại dịch vụ nút. RCM hiện „Đã lưu và đã có hiệu lực“. Sau khi bật, lần kiểm tra đầu chạy sau một khoảng. Sau khi tắt, một lần kiểm tra đang chạy bị ngắt và không ghi gì. Khoảng mới được tính từ lúc lần kiểm tra cuối kết thúc. Giữ, ngày, Giới hạn truy vấn, Yên và Bộ sinh tiến độ có hiệu lực từ lần kiểm tra tiếp theo.
  • Nút 2027.5.7 chỉ đọc các cài đặt này lúc khởi động: sau Lưu, hãy khởi động lại dịch vụ hqclusternode trên nút đó. RCM 2027.2.24 hiện „Đã lưu, nhưng chưa có hiệu lực“ và nêu lý do.
  • Bảng nào được so do danh sách bảng của cơ sở dữ liệu xác định (chương 3.1). Với HQbird 2027.2.24, mỗi cơ sở dữ liệu có thể có danh sách riêng: trường lúc đăng ký hoặc khối Bảng theo dõi đồng bộ trên trang cơ sở dữ liệu của phía chính (chương 3.3). Trang Kiểm tra dữ liệu hiện danh sách nào được dùng, và số bảng „không có trong cơ sở dữ liệu“. Trong 2027.5.7 danh sách là theo nút (sync_tables).
  • Các bảng bị loại khỏi công bố được hiện là „không được công bố“ (chương 6.3).
Trang kiểm tra dữ liệu
Trang kiểm tra dữ liệu

7.6. Cảnh báo

Trang Cảnh báo
Trang Cảnh báo

Trang Cảnh báo. Các hành động:

  • Xác nhận — cảnh báo vẫn hiện nhưng được đánh dấu đã xác nhận;
  • Tắt tiếng 60 phút — ẩn trong một giờ;
  • Xóa / Xóa mọi cảnh báo có mã này — RCM chuyển việc xóa tới nút đã nâng cảnh báo. Nếu nguyên nhân còn, cảnh báo sẽ xuất hiện lại.
Command
hqbirdrcm clearalerts -code backlog_warn   # also -id, -acked, -all

Từ HQbird 2027.2.33, RCM gửi cảnh báo tới Telegram, tới một webhook (Slack, Teams, JSON) và qua thư điện tử. Các kênh được cấu hình trong mục notify.channels của tệp rcm.json. Khối Kênh thông báo trên trang Cảnh báo hiện các kênh và gửi một thông báo thử. RCM báo các vấn đề mức warn trở lên: một vấn đề đã xuất hiện, đã trở nên nghiêm trọng hơn, hoặc đã được gỡ. Không có kênh thì RCM không gửi gì. Các phiên bản trước không có gửi: hãy theo dõi trang Cảnh báo hoặc hỏi API của RCM.

Các mã chính:

Mã Nghĩa
backlog_warn / backlog_critical 32 / 48 phân đoạn chưa đưa vào kho trong .ReplLog
disk_serious_cleanup kho đang được dọn ở giai đoạn 2 (7.3)
replication_paused_reinit_scheduled các phân đoạn chưa áp dụng đã bị xóa, cần khởi tạo
shipping_paused việc gửi tới đối tác bị tạm dừng (7.7)
apply_error, replication_stopped, replication_unrecoverable_error bản sao không áp dụng được một phân đoạn
replication_guid_mismatch GUID cơ sở dữ liệu phía chính đã đổi
segment_missing, segment_rejected, sequence_gap vấn đề với thứ tự phân đoạn
firebird_down, firebird_log_error Firebird không chạy hoặc đang ghi lỗi
firebird_not_answering từ HQbird 2027.2.30: Firebird không trả lời một kết nối cơ sở dữ liệu trong một phút (treo). Việc này gồm cả một kết nối không thiết lập được vì hết thời gian chờ; firebird_down chỉ là từ chối kết nối
master_publication_off công bố tắt (chương 6); từ HQbird 2027.2.24 và sau một lần thất bại publication_off (chương 6.1)
replica_removed_for_reinit từ HQbird 2027.2.24: bản sao đã xóa bản cũ để khởi tạo, và chưa có bản mới (chương 4.4)
orphaned_database cơ sở dữ liệu nằm ngoài lần quét (chương 3.8)
restart_required_after_reinit Firebird của bản sao cần được khởi động lại (chương 5.6)
data_mismatch lần kiểm tra định kỳ thấy lệch
license_paused fbagent không có giấy phép (chương 2.8)

7.7. Tạm dừng gửi

Trên trang Cơ sở dữ liệu, ở dòng phía chính: Tạm dừng gửi / Tiếp tục gửi. Với nhiều cơ sở dữ liệu — qua danh sách Hành động.

Command
hqbirdrcm pauseshipping  -node node-a -db <db_id>
hqbirdrcm resumeshipping -node node-a -db <db_id>
Xác nhận tạm dừng gửi
Xác nhận tạm dừng gửi
Dòng phía chính trong lúc tạm dừng
Dòng phía chính trong lúc tạm dừng
  • Việc tạm dừng còn hiệu lực đến khi Tiếp tục gửi hoặc đến khi khởi tạo.
  • Firebird phía chính tiếp tục ghi các phân đoạn. Kho .LogArch lớn lên: khi bản sao dừng, giai đoạn 1 (7.3) không xóa các phân đoạn của nó.
  • Một lần tạm dừng dài có thể tới giai đoạn 3 và NEEDS_REINIT. Hãy theo dõi chỗ.
  • Nút không có nếu cơ sở dữ liệu không có bản sao hoặc công bố tắt. Biểu tượng Tạm dừng: không có giấy phép nghĩa là tạm dừng vì giấy phép (chương 2.8); nó chỉ được gỡ bằng một giấy phép.

7.8. Nhật ký

Nhật ký Ở đâu
Nút <thư mục cài đặt>/logs/node-YYYYMMDD.jsonl (/opt/hqclusternode hoặc C:\hqclusternode), mỗi tệp 32 MB, 20 tệp
Firebird replication.log, firebird.log các đường dẫn trong node.json: firebird.replication_log, firebird.firebird_log
RCM Linux: journalctl -u hqbirdrcm
Kiểm toán RCM rcm-data/audit.jsonl

Nhật ký nút từ xa — trang Nhật ký: chọn một nút và một nguồn (replication.log, firebird.log, agent nút).

Trang Nhật ký
Trang Nhật ký
Command
hqbirdrcm getlogs -node node-b -source replication -tail 200

8. Cách chuyển một bản sao thành cơ sở dữ liệu thường

Có hai đường:

Đường Khi nào Bạn nhận được gì
Đặt thành thường, 8.1 cần một bản làm việc riêng: báo cáo, thử nghiệm, một sự cố mà không có phía chính mới một cơ sở dữ liệu thường, ngoài việc sao chép
Thăng cấp thành chính, 8.3 bản sao phải trở thành phía chính mới một cơ sở dữ liệu do một nút đồng hành với vai trò chính quản lý

Không đường nào hoàn tác được qua giao diện.

8.1. Đặt thành thường

Danh sách „Hành động“ của bản sao: mục „Đặt thành thường“
Danh sách „Hành động“ của bản sao: mục „Đặt thành thường“
  1. Cơ sở dữ liệu, phía bản sao: đánh dấu các dòng bản sao.

  2. Trong danh sách Hành động, chọn Đặt thành thường và xác nhận. Không có nút riêng trên dòng. Cũng không có lệnh dòng lệnh.

Xác nhận „Đặt thành thường“
Xác nhận „Đặt thành thường“
3. Nút bản sao: - chạy `gfix -replica none` (HQbird 2.5/3.0: `gfix -replica {}`). Nếu cơ sở dữ liệu đang bận áp dụng các phân đoạn, nút đưa nó vào tắt `single` trong vài giây (`gfix -shut single -force 0`), xóa chế độ bản sao và trả nó về bằng `gfix -online normal`. **Mọi kết nối tới cơ sở dữ liệu này bị cắt**; - ghi tệp đánh dấu `.hqcluster-normal.json` (thời điểm, tác giả, db_id, GUID); - bắt đầu dọn hàng đợi `.Incoming` (8.2). 4. RCM hiện cơ sở dữ liệu trong nhóm **Không phải bản sao (thường)**.
Trang „Cơ sở dữ liệu“ sau „Đặt thành thường“
Trang „Cơ sở dữ liệu“ sau „Đặt thành thường“

Sau đó, cơ sở dữ liệu mở để ghi.

Gỡ khối bản sao khỏi replication.conf. Nút gỡ nó ở lần quét tiếp theo, và Firebird đọc tệp lúc khởi động:

Command
hqbirdrcm scansync -node node-b
hqbirdrcm restartfirebird -node node-b

Cho đến lúc đó, các lỗi „cơ sở dữ liệu không ở chế độ bản sao“ của cơ sở dữ liệu này không được nâng thành cảnh báo.

Tệp đánh dấu bảo vệ cơ sở dữ liệu. Khởi tạo sẽ không ghi đè cơ sở dữ liệu như vậy: nó bị từ chối với target_not_replica (chương 5.9). Chỉ xóa dấu là chưa đủ: nút cũng kiểm tra chế độ bản sao trong phần đầu cơ sở dữ liệu. Hộp Xóa bản sao cũ (chương 4.4) cũng không xóa cơ sở dữ liệu như vậy.

Với HQbird 2027.2.24, khi bản sao đang xóa bản cũ của cơ sở dữ liệu này để khởi tạo, Đặt thành thường bị từ chối với reclaim_in_progress: hãy thử lại sau.

Nếu cơ sở dữ liệu cần trở thành bản sao lần nữa — chỉ một lần khởi tạo mới có ghi đè mới làm được. Việc này qua API của nút (overwrite_non_replica: true); trong RCM không có nút như vậy. Tệp cũ được giữ thành <database>.pre-reinit-<UTC time>.fdb, và dấu bị xóa.

8.2. Chuyện gì xảy ra với các phân đoạn

  • Cho đến khi nút quét các cơ sở dữ liệu, phía chính tiếp tục gửi các phân đoạn. Mỗi 30 giây nút bản sao xóa các phân đoạn cũ và chỉ giữ 100 phân đoạn cuối (keep_segments).
  • Sau khi quét, bản ghi cơ sở dữ liệu trên bản sao nhận trạng thái ORPHANED. Nút bản sao trả lời phía chính bằng unknown_database. Phía chính ngừng gửi phân đoạn tới bản sao này, ngừng giữ kho cho nó, và kiểm tra lại mỗi 10 phút.
  • Các bản sao khác của cơ sở dữ liệu này không bị ảnh hưởng.
  • Bản ghi ORPHANED có thể bị xóa (chương 3.8): hqbirdrcm forgetdatabase. Bản thân tệp cơ sở dữ liệu không bị xóa.

8.3. Thăng cấp thành chính

Bản sao trở thành phía chính mới. Tệp của nó ở nguyên chỗ, và việc điều khiển chuyển sang nút đồng hành.

Điều kiện:

Điều kiện Từ chối
cơ sở dữ liệu là một bản sao bad_request
một nút với vai trò chính — nút đồng hành — đang chạy trên cùng máy chủ (cùng nhãn host trong rcm.json, chương 2.1) no_companion
việc thăng cấp cơ sở dữ liệu này chưa đang chạy already_running
không có lần khởi tạo vào cơ sở dữ liệu này hoặc từ phía chính của nó reinit_running

RCM không tạo nút đồng hành: hãy cài nó trước (chương 1).

Cách bắt đầu:

  • ở dòng bản sao, Thăng cấp thành chính, hoặc trong danh sách Hành động;

  • từ dòng lệnh:

    Command
    hqbirdrcm promotetomaster -node node-b -db <db_id>   # -timeout 10m

RCM sẽ xin xác nhận và nêu tên nút đồng hành.

Xác nhận „Thăng cấp thành chính?“
Xác nhận „Thăng cấp thành chính?“

Các bước (hiện ở dòng bản sao, tên bằng tiếng Anh):

Số Bước Việc nó làm
1 TURN TO NORMAL như ở 8.1; được bỏ qua nếu cơ sở dữ liệu đã là thường
2 NEW GUID một GUID cơ sở dữ liệu mới tại chỗ (8.4)
3 EXCLUDE ON DONOR nút bản sao (bên cho) loại tệp khỏi lần quét của nó (exclude_paths)
4 ENROLL ON <đồng hành> nút đồng hành đăng ký tệp như một cơ sở dữ liệu phía chính
5 PUBLICATION SYNC đồng bộ công bố; danh sách các bảng đã loại được chuyển từ phía chính cũ (chương 6.3)
6 RESTART DONOR FIREBIRD khởi động lại Firebird của bên cho, không chờ cửa sổ
7 RESTART <đồng hành> FIREBIRD khởi động lại Firebird của nút đồng hành, không chờ cửa sổ
8 FINALIZE dòng bên cho trở thành Bản sao ma; phía chính cũ có thể trở thành Phía chính suy giảm (8.5)
Các bước thăng cấp ở dòng bản sao
Các bước thăng cấp ở dòng bản sao

Trên HQbird 2.5 và 3.0 không có công bố: bước PUBLICATION SYNC kết thúc với văn bản „máy này không có công bố“.

Các bước thăng cấp trên HQbird 3.0 (Windows)
Các bước thăng cấp trên HQbird 3.0 (Windows)

Nếu bên cho và nút đồng hành dùng cùng một Firebird, Firebird đó được khởi động lại: các kết nối tới mọi cơ sở dữ liệu của nó bị cắt.

Nếu một bước thất bại, công việc nhận failed kèm văn bản lỗi. Hãy sửa nguyên nhân và bấm Thăng cấp thành chính lần nữa: các bước đã xong không được lặp. Nếu RCM khởi động lại trong lúc thăng cấp, công việc cũng trở thành failed — hãy kiểm tra trạng thái các nút và thử lại.

Giấy phép. Nếu fbagent trên máy chủ của phía chính không có giấy phép, phía chính đã tạm dừng gửi. Việc thăng cấp vẫn có thể. RCM sẽ cảnh báo bạn: các thay đổi sau khi tạm dừng bắt đầu sẽ mất.

8.4. GUID mới

Sau khi thăng cấp, cơ sở dữ liệu phải nhận GUID của riêng nó. Nếu không phía chính mới ghi các phân đoạn dưới GUID của phía chính cũ, và các bản sao của nó bị từ chối với duplicate_guid.

Bước NEW GUID trên nút:

  1. gfix -shut single -force 0 — mọi kết nối tới cơ sở dữ liệu bị cắt;
  2. nbackup -L, rồi nbackup -F không có -SEQUENCE;
  3. xóa <database>.delta;
  4. kiểm tra phần đầu: GUID mới, REPLICATION_SEQUENCE = 0;
  5. gfix -online normal.

Firebird không được khởi động lại. Cách này chạy trên mọi phiên bản (2.5, 3.0, 4.0, 5.0).

Nếu bước bị ngắt, nút phát cảnh báo newguid_interrupted. Cơ sở dữ liệu có thể còn ở tắt single. Hãy lặp Thăng cấp thành chính: bước sẽ tiếp tục.

Bước được bỏ qua (văn bản bắt đầu bằng skipped:) nếu nút bên cho là phiên bản cũ hoặc tệp đã có GUID riêng.

Sau GUID mới, chuỗi nbackup cũ không còn dùng được. Hãy làm một bản sao nbackup mức 0 mới.

Nếu cơ sở dữ liệu được tạo với ADD DIFFERENCE FILE, tệp .delta của nó nằm ở chỗ khác: hãy tự xóa.

8.5. Sau khi thăng cấp

Bản ghi bên cho. Trên nút bản sao, cơ sở dữ liệu vẫn ORPHANED, đường dẫn vẫn trong exclude_paths, và thư mục .Incoming cùng nhãn vẫn còn. Trong RCM đây là dòng Bản sao ma với các nút Mở trên phía chính mới và Dọn.

Dòng bên cho: «Bản sao ma»
Dòng bên cho: «Bản sao ma»
  • Để gỡ dòng, hãy bấm Dọn. Việc này chỉ đổi RCM.
  • Để gỡ bản ghi bên cho khỏi nút bản sao, hãy chạy forgetdatabase. Tệp và thư mục .Incoming vẫn còn. HQbird 2027.2.30 trở lên không từ chối lệnh (mailbox_active), vì đường dẫn bên cho nằm trong exclude_paths. Các nút phiên bản trước từ chối khi tệp và thư mục .Incoming còn đó.
  • Đừng bao giờ chạy cleanuparchive -orphaned trên bên cho. Bên cho và nút đồng hành dùng chung thư mục <database>.LogArch. Lệnh sẽ xóa kho đang sống của phía chính mới.

Phía chính cũ.

  • Nếu bên cho là bản sao đang chạy cuối cùng của nó, RCM đặt phía chính cũ thành Phía chính suy giảm và tạm dừng gửi tới bên cho („gửi đã tạm dừng: … (thăng cấp thành chính)“). Đừng tiếp tục gửi tới bên cho: nó đã giữ một cơ sở dữ liệu đang làm việc. Để gỡ trạng thái này, hãy khởi tạo cơ sở dữ liệu sang một bản sao khác.

    Phía chính cũ: «Phía chính suy giảm», gửi đã tạm dừng
    Phía chính cũ: «Phía chính suy giảm», gửi đã tạm dừng
  • Khởi tạo từ phía chính cũ tới nút bên cho sẽ bị từ chối (target_not_replica): nó đã giữ một cơ sở dữ liệu đang làm việc.
  • Nếu bước NEW GUID bị bỏ qua, phía chính cũ và phía chính mới có cùng GUID. Khi đó khởi tạo từ phía chính cũ cần -force (chương 5.9).
  • Sau một lần thăng cấp thủ công, RCM không biến phía chính cũ thành bản sao của phía chính mới. Hãy dừng các ứng dụng trên phía chính cũ và gỡ cơ sở dữ liệu của nó khỏi quản lý (chương 3.8). Với một cơ sở dữ liệu được mô tả là dịch vụ, việc này do Tham gia lại làm (8.7).

Phía chính mới. Hãy đặt một bản sao cho nó: nút bản sao, các đối tác (chương 2), công bố (chương 6), khởi tạo (chương 5).

Phía chính mới: cơ sở dữ liệu với GUID mới, chưa có bản sao
Phía chính mới: cơ sở dữ liệu với GUID mới, chưa có bản sao

8.6. Chuyển đổi có kế hoạch: danh sách kiểm tra

Đây là thủ tục cho một lần chuyển đổi thủ công. Với một cơ sở dữ liệu được mô tả là dịch vụ, RCM tự chuyển phía chính (8.7). Một lần thăng cấp thủ công không kiểm tra các ứng dụng có đang ghi vào phía chính cũ hay không. Thủ tục:

  1. Trước. Trên máy chủ bản sao, một nút đồng hành với vai trò chính đang chạy, và cả hai nút có cùng nhãn host (chương 2.1). Một nút cho bản sao tương lai đã sẵn sàng cho phía chính mới.
  2. Dừng việc các ứng dụng ghi vào cơ sở dữ liệu của phía chính cũ.
  3. Đợi đến khi bản sao đã nhận và áp dụng hết: Cơ sở dữ liệu → IN_SYNC, không có hàng đợi.
  4. Xác minh (chương 5.10): số dòng khớp.
  5. Thăng cấp thành chính (8.3). Đợi bước FINALIZE.
  6. Kiểm tra: cơ sở dữ liệu nằm trong danh sách phía chính của nút đồng hành, công bố bật.
  7. Chuyển các ứng dụng sang phía chính mới.
  8. Làm một bản sao nbackup mức 0 của cơ sở dữ liệu mới (8.4).
  9. Dọn bản ghi ma của dòng bên cho (8.5).
  10. Nối bản sao với phía chính mới và khởi tạo nó (chương 5).
  11. Phía chính cũ: gỡ cơ sở dữ liệu khỏi quản lý hoặc để nó làm kho lưu (8.5).

8.7. Dịch vụ: chuyển đổi và chuyển dự phòng trong RCM

Với HQbird 2027.2.30, RCM tự chuyển phía chính sang một máy chủ khác. Để làm vậy, cơ sở dữ liệu được mô tả là một dịch vụ: một cơ sở dữ liệu logic trên nhiều máy chủ. Trên mỗi máy chủ của dịch vụ có một nút chính và một nút bản sao, và đường dẫn tới tệp cơ sở dữ liệu là như nhau. Dịch vụ được tạo trên trang Dịch vụ (từ HQbird 2027.2.31) hoặc bằng lệnh hqbirdrcm services put -id <id> -file <file>.json.

Hành động Việc nó làm Lệnh
Chuyển đổi chuyển phía chính có kế hoạch, không mất dữ liệu. Sau đó phía chính cũ tự trở thành bản sao của phía chính mới hqbirdrcm switchover -service <id> -check, rồi hqbirdrcm switchover -service <id> -to <host>
Chuyển dự phòng máy chủ phía chính bị mất: RCM thăng cấp bản sao. Các thay đổi mới nhất của phía chính có thể mất hqbirdrcm failover -service <id> -check, rồi hqbirdrcm failover -service <id> -to <host> -accept-data-loss
Tham gia lại sau một lần chuyển dự phòng, đưa máy chủ cũ trở lại như bản sao của phía chính mới hqbirdrcm rejoin -service <id>
Tiếp tục đưa dịch vụ ra khỏi trạng thái failed hqbirdrcm resume -service <id> -check, rồi hqbirdrcm resume -service <id>

Các hành động đó cũng có trên trang dịch vụ: các nút Chuyển đổi…, Chuyển dự phòng…, Tham gia lại… và Tiếp tục….

  • Chuyển dự phòng tự động mặc định tắt. Nó được bật riêng cho mỗi dịch vụ: hqbirdrcm policy -service <id> -auto-failover on -max-data-loss 30. Cần các bộ định tuyến. RCM chỉ bắt đầu chuyển dự phòng khi nút chính im lặng, đa số bộ định tuyến không thấy Firebird của phía chính, và độ trễ của bản sao không quá max_data_loss_sec.
  • Một bộ định tuyến (hqclusternode router, Linux) giữ HAProxy trên phía chính hiện tại của dịch vụ. Các ứng dụng kết nối tới <router host>:<router_port> và không đổi chuỗi kết nối khi có chuyển.
  • Sau khi chuyển dự phòng, RCM cô lập phía chính cũ (vai trò fenced) khi nó phản hồi lại. Đưa nó trở lại bằng lệnh rejoin.