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

Hướng dẫn này dành cho quản trị viên cài đặt HQbird 2027 trên một máy chủ Linux bằng trình cài đặt ngoại tuyến hqbird2027-fbNN-linux-<version>.run. Tài liệu bao gồm cài đặt mới, cập nhật một HQbird cũ hơn và một HQbird 2027 trước đó, các lệnh bảo trì, kết nối tới HQCenter của bạn, cài đặt không giám sát (bằng script), và vị trí các tệp sau khi cài đặt.

Các ví dụ hiển thị trình cài đặt cho Firebird 5.0 trên Ubuntu 24.04. Các trình cài đặt cho Firebird 2.5, 3.0 và 4.0 hoạt động theo cùng một cách; chỉ khác phiên bản, cổng mặc định và tên thư mục. Bộ cài trên Windows được mô tả trong Cài đặt trên Windows.

Mục lục

  1. 1. Trình cài đặt cài những gì
  2. 2. Tổng quan về quá trình cài đặt
  3. 3. Cài đặt mới
  4. 4. Sau khi cài đặt
  5. 5. Cập nhật một HQbird cũ hơn (2024 và trước đó)
  6. 6. Cập nhật HQbird 2027 lên phiên bản mới
  7. 7. Các lệnh bảo trì
  8. 8. Gắn vào HQCenter của bạn
  9. 9. Cài đặt không giám sát và các script
  10. 10. Khắc phục sự cố

1. Trình cài đặt cài những gì

Một tệp .run = một dòng Firebird. Hãy chọn trình cài đặt của phiên bản Firebird mà cơ sở dữ liệu của bạn sử dụng:

Trình cài đặt Firebird mà nó cài đặt hoặc cập nhật Firebird đầu tiên trên máy chủ Kích thước
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (bản dựng HQbird) /opt/firebird, cổng 3050 khoảng 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (bản dựng HQbird) /opt/firebird, cổng 3050 khoảng 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (bản dựng HQbird) /opt/firebird, cổng 3050 khoảng 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (bản dựng HQbird) /opt/firebird, cổng 3050 khoảng 80 MB

Mỗi trình cài đặt đều chứa và cài đặt mà không cần Internet:

  • Firebird (bản dựng HQbird của dòng đó): một máy chủ mới, hoặc cập nhật tại chỗ Firebird của dòng đó đã có trên máy chủ. Các tệp firebird.conf, databases.conf (aliases.conf đối với 2.5), cơ sở dữ liệu bảo mật và mật khẩu SYSDBA của bạn được giữ nguyên.
  • Các tệp gỡ lỗi Firebird (ký hiệu để phân tích sự cố), được cài vào thư mục Firebird. --no-debug bỏ qua chúng.
  • HQbird agent (fbagent): unit systemd hqbirdfbagent-fb50, chạy dưới người dùng firebird, thực hiện sao lưu, giám sát, các tác vụ bảo trì và cập nhật. Tên kết thúc bằng dòng Firebird (-fb25 … -fb50); một phiên bản thứ hai của dòng đó có -fb50-2.
  • HQ Monitor: bảng điều khiển web của phiên bản HQbird này, unit hqbirdmonitor-fb50, địa chỉ http://<server>:<20000 + Firebird port>/ (đối với Firebird trên cổng 3050: http://localhost:23050/).
  • Các thành phần cluster: bảng điều khiển cluster RCM (hqbirdrcm) và nút cluster (hqclusternode) được sao chép vào bộ nhớ đệm của agent. Các bộ cài có agent (fbagent) 3.1.0 trở lên không tạo cluster theo mặc định: không có RCM, không có cửa sổ ghép nối, không có cổng cluster trong tường lửa. Hai câu hỏi (hoặc --rcm on, --cluster-pairing on) sẽ bật chúng (“Tiếp theo: cluster” trong mục 3). Với RCM, nó được cài vào /opt/hqbirdrcm và chạy dưới unit hqbirdrcm; phần tóm tắt in địa chỉ của nó trong dòng RCM:. Nút nhận unit của nó (ví dụ hqclusternode-master-p3050) khi bạn liên kết máy chủ trong RCM. Các bộ cài từ 2027.2.19 với agent cũ hơn sẽ cài RCM trên mỗi máy chủ (--rcm off để nó trong bộ nhớ đệm) và mở cửa sổ ghép nối. Các bộ cài trước 2027.2.19 chỉ sao chép cả hai thành phần vào bộ nhớ đệm của agent: không có unit hqbirdrcm và không có dòng RCM:.

Các phiên bản được cài trước 2027.2.9 có cổng Firebird trong tên agent: thư mục /opt/hqbird/fbagent-p3050, các unit hqbirdfbagent-p3050 và hqbirdmonitor-p3050. Việc cập nhật không thay đổi các tên này. Chỉ các phiên bản mới nhận tên -fb<NN>, vì vậy một máy chủ có thể có cả hai dạng.

Yêu cầu: x86_64, kernel 3.2 trở lên, systemd; một Linux có apt, dnf/yum hoặc zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS và các hệ khác); root. Khoảng 300 MB trống trong /var/tmp trong quá trình cài đặt (một thư mục nơi các chương trình có thể chạy; xem --tmpdir). Một vài thư viện hệ điều hành (libtommath, ICU) được lấy từ kho của bản phân phối; một máy chủ không có Internet sẽ nhận được các lệnh chính xác để chuẩn bị chúng (mục 9).

Không được hỗ trợ: một Firebird được cài từ các gói của bản phân phối (firebird3.0-server, gói rpm firebird). Trình cài đặt dừng lại trước khi thay đổi bất cứ thứ gì (mã thoát 7); hãy gỡ các gói trước (giữ một bản sao lưu gbak của cơ sở dữ liệu của bạn) hoặc sử dụng trình cài đặt trực tuyến với --import-firebird.

Nhiều dòng Firebird trên một máy chủ: mỗi dòng có trình cài đặt riêng. Firebird đầu tiên trên máy chủ được đặt vào /opt/firebird; dòng thứ hai được đặt vào /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) trên cổng của dòng đó: 3053 cho 3.0, 3054 cho 4.0, 3055 cho 5.0. Khi cổng đó đang được sử dụng, trình cài đặt dừng lại và yêu cầu --port N. Nhiều phiên bản của một dòng (một Firebird 5.0 thứ hai trên một cổng khác) được cài đặt với --fb-root <new folder> --port <port> (mục 7). Firebird 2.5 chỉ có một phiên bản, trong /opt/firebird; để có một máy chủ thứ hai bên cạnh nó, hãy sử dụng một dòng khác (ví dụ Firebird 5.0 trong /opt/fb50).

Một runbook từng bước cho hai phiên bản trên cổng 3050 và 3051, cho mọi dòng, với các lệnh sao chép-dán, nằm trong hqbird2027-linux-two-instances-runbook.ru.md (tiếng Nga) và hqbird2027-linux-two-instances-runbook.pt.md (tiếng Bồ Đào Nha).

Dùng thử: không có giấy phép, agent chạy bản dùng thử 7 ngày. Email dùng thử (--email) kéo dài nó lên 30 ngày. Một tệp giấy phép (--license) hoặc kết nối tới HQCenter của bạn (mục 8) thay thế bản dùng thử.

Cập nhật: từ bộ cài 2027.2.31 (agent 3.3.0), một máy chủ không được kết nối với HQCenter nào sẽ kiểm tra máy chủ cập nhật của nhà cung cấp. Theo mặc định, agent, HQ Monitor và fbmcp tự cập nhật, và một gói Firebird mới được tải xuống và chờ bạn. --auto-update all|agent|off hoặc dòng Updates của giao diện văn bản thay đổi điều này (“Cập nhật không có HQCenter” trong mục 4). Một máy chủ được kết nối với một HQCenter sẽ nhận cập nhật từ HQCenter đó.

2. Tổng quan về quá trình cài đặt

Diagram

Việc kiểm tra máy chủ và bản thân quá trình cài đặt được thực hiện bởi HQbird agent mà trình cài đặt mang theo (fbagent --install-plan, fbagent --setup-install). Không có gì được tải xuống ngoại trừ các gói hệ điều hành còn thiếu. Không có gì bị thay đổi trước khi kế hoạch được xác nhận: các gói hệ điều hành được cài đặt sau khi xác nhận. Trong một terminal, các bộ cài sau 2027.2.30 mở giao diện văn bản (bước 3 của mục 3); --no-tui chạy trình cài đặt thuần, hỏi các câu hỏi dưới dạng các dòng văn bản. Không có terminal và không có --yes, trình cài đặt dừng lại ở bước xác nhận với mã thoát 4. Nếu quá trình cài đặt thất bại trước khi unit agent khởi động, agent sẽ khôi phục các unit về trạng thái chúng có trước đó (mã thoát 2; mã 3 khi việc khôi phục không hoàn tất, phần tóm tắt cho biết cần kiểm tra gì).

3. Cài đặt mới

Bước 1: Tải xuống trình cài đặt và kiểm tra nó

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

Các dòng khác có cùng tên với fb40, fb30, fb25. Kết quả mong đợi: hqbird2027-fb50-linux-2027.2.9.run: OK. Một máy chủ không có Internet: tải hai tệp trên một PC với cùng các liên kết và sao chép chúng sang máy chủ (scp, một ổ USB, một thư mục chia sẻ).

Trình cài đặt cũng kiểm tra tải trọng của chính nó trước khi giải nén bất cứ thứ gì: một bản tải xuống bị cắt hoặc hỏng sẽ dừng lại với mã thoát 5 (“hãy tải lại”).

Bước 2: Kiểm tra máy chủ mà không thay đổi nó (tùy chọn)

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check

--check chạy kiểm tra máy chủ, báo cáo các thư viện hệ điều hành còn thiếu (và các lệnh để lấy chúng trên một máy chủ không có Internet), hiển thị những gì agent tìm thấy và những gì nó sẽ làm, rồi thoát. Không có gì được cài đặt.

Bước 3: Chạy trình cài đặt

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Các bộ cài sau 2027.2.30 mở giao diện văn bản khi bạn khởi chạy chúng trong một terminal: các trang toàn màn hình với kế hoạch và các cài đặt. Các bộ cài đến 2027.2.30, và các trường hợp trong “Trình cài đặt thuần” bên dưới, hỏi các câu hỏi dưới dạng các dòng văn bản. Cả hai đều thực hiện cùng một quá trình cài đặt với cùng các tùy chọn.

Giao diện văn bản

Trình cài đặt kiểm tra máy chủ, tự giải nén, đọc kế hoạch và hiển thị trang đầu tiên. Không có gì trên máy chủ bị thay đổi cho đến khi bạn bắt đầu cài đặt trên trang Install.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

Các dòng trên cùng là kế hoạch cho các cài đặt hiện tại: mã của nó và những gì trình cài đặt sẽ làm với Firebird và agent. Một kế hoạch không khả thi được hiển thị màu đỏ, kèm lý do, và con trỏ đứng trên cài đặt cần sửa. Sau mỗi thay đổi, trình cài đặt đọc lại kế hoạch.

Phím Chức năng
Lên, Xuống Di chuyển con trỏ (cũng có thể dùng k, j)
Enter Mở cài đặt dưới con trỏ, chọn một mục, chấp nhận một giá trị đã nhập
Space Bật hoặc tắt một thành phần (trang Components)
Esc Quay lại trang trước; ở trang đầu tiên: rời khỏi trình cài đặt (nó sẽ hỏi trước)
Ctrl+C Dừng trình cài đặt ngay lập tức (mã thoát 2). Không có gì bị thay đổi trước trang Install

Trên một trang nơi bạn nhập một giá trị (một thư mục, một cổng, một địa chỉ), Enter chấp nhận nó và một giá trị trống có nghĩa là “tự động”. Esc không rời khỏi một trang như vậy.

Cài đặt Bạn chọn gì Tương đương với tùy chọn
Language Tiếng Anh, tiếng Nga, tiếng Bồ Đào Nha Brazil, tiếng Đức; các trang thay đổi ngay lập tức --lang
Firebird folder Thư mục của một Firebird mới, hoặc của Firebird cần cập nhật. Firebird 2.5 chỉ có một thư mục, vì vậy trình cài đặt của nó không có dòng này --fb-root
Firebird port Cổng TCP của Firebird --port
Agent id Tự động, tên máy chủ, tên máy chủ và phiên bản, hoặc giá trị của riêng bạn. Chỉ dành cho agent mới: một agent đã cài đặt giữ id của nó, và dòng này không được hiển thị --agent-id
SYSDBA password Đối với một Firebird mới: được tạo tự động, hoặc của riêng bạn --sysdba-pass-file
HQ Monitor Cổng và thông tin đăng nhập của bảng điều khiển web --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License Không phải bây giờ, bản dùng thử 30 ngày qua email (địa chỉ, thông báo quyền riêng tư, khu vực), hoặc một tệp giấy phép --email --accept-privacy --trial-zone, --license
HQCenter Tệp attach.json của HQCenter của bạn --attach
Cluster Trình quản lý cluster RCM (id cluster, mật khẩu quản trị), chế độ khám phá, cổng ghép nối --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Các tệp gỡ lỗi Firebird; fbmcp và các địa chỉ của chế độ từ xa của nó --no-debug, --no-fbmcp, --fbmcp-allow-from

| Cập nhật | Chỉ HQbird (agent, HQ Monitor và fbmcp tự cập nhật, Firebird mới sẽ chờ bạn), HQbird và Firebird (Firebird cũng tự cập nhật, vào ban đêm từ 03:30 đến 04:00, kèm khởi động lại Firebird), hoặc Tắt. Bộ cài từ 2027.2.31; chỉ dành cho agent mới không có tệp attach.json: một HQCenter điều khiển việc cập nhật của một agent được gắn kết | --auto-update |

Các tùy chọn trên dòng lệnh là những giá trị mà các trang bắt đầu với: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 mở trang đầu tiên với RCM bật và cổng 3055.

Bốn dòng dưới phần cài đặt:

  • Install hiển thị toàn bộ kế hoạch, sau đó hỏi Start the install now? với con trỏ ở No. Các câu hỏi của kế hoạch (một HQbird cũ hơn, một Firebird đang chạy cần dừng) nằm trên cùng trang: Yes trả lời tất cả. Sau khi chọn Yes các trang đóng lại, và quá trình cài đặt in nhật ký và bản tóm tắt trên màn hình thông thường, như trong trình cài đặt đơn giản bên dưới.
  • Plan details hiển thị ý nghĩa của mã kế hoạch, những gì trình cài đặt tìm thấy trên máy chủ, các cảnh báo và các gói OS mà nó sẽ cài đặt.
  • About plans liệt kê tất cả các mã (M1 … M17). Nhấn Enter trên một mã sẽ giải thích mã đó. Dấu * đánh dấu mã của kế hoạch hiện tại.
  • Quit thoát khỏi trình cài đặt (mã thoát 1). Không có gì bị thay đổi.

Trình cài đặt đơn giản

Trình cài đặt đơn giản chạy khi một trong các điều kiện sau đúng:

  • tùy chọn --no-tui, hoặc biến HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin hoặc stdout không phải là terminal: một script, ssh host 'command' không có terminal, hoặc một pipe như ... 2>&1 | tee install.log;
  • TERM là dumb hoặc không được đặt;
  • cửa sổ nhỏ hơn 80 cột x 24 dòng (bên trong tmux với dòng trạng thái của nó, một terminal 80x24 có 23 dòng: hãy làm cửa sổ lớn hơn, hoặc dùng --no-tui);
  • bash trên máy chủ cũ hơn 4.4 (RHEL 7, CentOS 7);
  • bộ cài là 2027.2.30 hoặc cũ hơn.

Đối với cửa sổ và đối với bash, dòng đầu tiên của đầu ra cho biết lý do tại sao các trang không mở.

Một lần chạy điển hình của trình cài đặt đơn giản trên một máy chủ không có Firebird:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Ví dụ này là từ bộ cài 2027.2.9. Từ bộ cài 2027.2.19 bản tóm tắt cũng có các dòng RCM: và Pairing: của bảng điều khiển cluster (“Next: cluster” bên dưới). Với agent 3.1.0 và mới hơn và không có cluster nào được chọn, chúng là:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

Ý nghĩa của các dòng:

  • host: bản phân phối và kernel; trình cài đặt từ chối một máy chủ không phải x86_64, không có systemd, hoặc chạy kernel cũ hơn 3.2.
  • OS libraries: những gì Firebird của dòng này cần từ OS (mục 9). Kế hoạch liệt kê các gói còn thiếu (OS packages to install); sau khi xác nhận trình cài đặt lấy chúng từ kho của bản phân phối. Không có kho, nó dừng với mã thoát 6 và in các lệnh.
  • plan: những gì agent tìm thấy (các dòng found Firebird ..., HQbird: ...) và những gì nó sẽ làm: Firebird new (một máy chủ mới), update (Firebird của dòng này được cập nhật tại chỗ), hoặc từ chối kèm lý do (mã thoát 1, không có gì thay đổi).
  • Install as planned? Yes/No: câu hỏi cuối cùng trước khi bất cứ điều gì bị thay đổi. Trả lời y. Khi kế hoạch có các câu hỏi riêng (một HQbird cũ hơn, một phiên bản khác), chúng xuất hiện thay thế (mục 5). Không có terminal, truyền --yes; nếu không trình cài đặt dừng với mã thoát 4.
  • Cluster questions (agent 3.1.0 và mới hơn): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] và Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. Mặc định là No. Câu đầu tiên được hỏi chỉ khi máy chủ không có RCM và agent không thuộc cluster nào; câu thứ hai không được hỏi khi agent thuộc một cluster hoặc chạy RCM. --yes và một lần chạy không có terminal trả lời No (không có mã thoát 4).
  • HQ Monitor: địa chỉ và thông tin đăng nhập. Một bản cài đặt mới nhận đăng nhập admin; mật khẩu được tạo của nó nằm trong /opt/hqbird/conf/access.properties (quyền 0600, chỉ root và agent đọc được). Tất cả các phiên bản HQbird 2027 của máy chủ dùng chung tệp này. Thay đổi mật khẩu trong HQ Monitor.

Mật khẩu SYSDBA của một Firebird mới được tạo và lưu trong /root/fbagent-install-sysdba.txt (quyền 0600): một dòng chú thích, sau đó là dòng SYSDBA_PASS=<password>. Một Firebird khác được cài đặt trên cùng máy chủ sau này nhận cùng mật khẩu từ tệp này. Để đặt mật khẩu riêng, truyền --sysdba-pass-file <file> (dòng đầu tiên của tệp) hoặc --sysdba-pass <password>.

Ngôn ngữ của trình cài đặt

Các bộ cài sau 2027.2.30 nói bốn ngôn ngữ: tiếng Anh, tiếng Nga (ru), tiếng Bồ Đào Nha Brazil (pt-BR) và tiếng Đức (de). Trình cài đặt chọn ngôn ngữ theo thứ tự này:

  1. tùy chọn --lang en|ru|pt-BR|de;
  2. biến HQBIRD_LANG;
  3. locale của console (LC_ALL, sau đó LC_MESSAGES, sau đó LANG), khi nó là một locale UTF-8;
  4. tiếng Anh.

Dòng thứ hai của đầu ra cho biết đó là ngôn ngữ nào và cách thay đổi nó. Dòng này luôn bằng tiếng Anh:

text
[install] Language: Русский (auto). Use --lang en to change.

Ghi chú:

  • PuTTY không gửi LANG đến máy chủ. Locale của chính máy chủ được tính, nên ngôn ngữ thường là tiếng Anh. Dùng --lang.
  • Với --yes, và không có terminal, ngôn ngữ tự động là tiếng Anh: các script đọc đầu ra đó. --lang vẫn hoạt động ở đó.
  • Trình cài đặt cần một locale UTF-8 trên máy chủ cho các ngôn ngữ khác (C.UTF-8 hoặc en_US.UTF-8). Nó tự đặt một locale cho chính nó. Không có locale đó nó nói tiếng Anh.
  • Trong giao diện văn bản, dòng Language của trang đầu tiên thay đổi ngôn ngữ ngay lập tức. Terminal phải hiển thị UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, đây là mặc định của nó).
  • Tiếng Anh vẫn giữ: các dòng tiến trình của chính quá trình cài đặt, bản tóm tắt Done:, /var/log/fbagent/install.log, và các cảnh báo của quá trình quét máy chủ.

Mã của kế hoạch

Kế hoạch có một mã: M1, M2, … Nó đặt tên cho trường hợp mà trình cài đặt tìm thấy trên máy chủ. Trình cài đặt in ý nghĩa của mã:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help in tất cả các mã và thoát. Nó không thay đổi gì. Trong giao diện văn bản trang đầu tiên hiển thị mã và tiêu đề của nó, “Plan details” hiển thị văn bản, và “About plans” liệt kê tất cả các mã.

Mã Những gì trình cài đặt tìm thấy Firebird Agent HQbird cũ hơn
M1 không có gì mới mới —
M2 Firebird của dòng này, không có HQbird cũ hơn cập nhật mới —
M3 Firebird của dòng khác, không có HQbird cũ hơn mới, cổng 305N mới —
M4 HQbird cũ hơn phục vụ Firebird của dòng này cập nhật mới bị tắt, các job của nó được nhập dưới dạng bật
M5 HQbird cũ hơn của dòng khác; có một Firebird của dòng này cập nhật, sau một câu hỏi mới tiếp tục hoạt động
M6 HQbird cũ hơn của dòng khác; không có Firebird của dòng này mới, sau một câu hỏi mới tiếp tục hoạt động
M7 HQbird cũ hơn không có Firebird cục bộ của một phiên bản đã biết cập nhật hoặc mới mới tiếp tục hoạt động, một cảnh báo
M8 một agent HQbird 2027 cho một Firebird khác cập nhật hoặc mới mới, bên cạnh cái đầu tiên không thay đổi
M9 như M8, và một HQbird cũ hơn phục vụ dòng này cập nhật mới, bên cạnh cái đầu tiên bị tắt, các job của nó được nhập dưới dạng bật
M10 một agent đã phục vụ Firebird này (một lần chạy lặp lại) cập nhật tại chỗ bị tắt khi nó chạy
M11 --fb-root là một Firebird của dòng này cập nhật mới hoặc tại chỗ như trên
M13 --fb-root là một thư mục trống hoặc mới mới trong thư mục đó mới như trên

Các mã từ chối (mã thoát 1, không có gì thay đổi): M12 thư mục có một Firebird mà trình cài đặt không thể cập nhật (dòng khác, một phiên bản nó không thể đọc, một dịch vụ bị tắt); M14 thư mục không trống và không có Firebird; M16 nhiều máy chủ Firebird của dòng này, hãy cung cấp --fb-root; M17 Firebird 2.5 chỉ hoạt động trong /opt/firebird. M15 là bộ cài chỉ có agent: Firebird không được cài đặt và không được cập nhật.

Id của agent

Id của agent đặt tên cho agent trong HQCenter, trong giấy phép và trong cluster. Nó chỉ được đặt ở lần cài đặt đầu tiên:

  • Mặc định: tên máy chủ + ngày + instance, ví dụ srv1261114-fb50.
  • --agent-id ID cung cấp id của riêng bạn (1-128 chữ cái, chữ số, ., _ hoặc -; ký tự đầu tiên là chữ cái hoặc chữ số).
  • Trình cài đặt từ chối một id mà một agent khác của máy chủ đã có.
  • Trong giao diện văn bản trang Agent id cung cấp id tự động, tên máy chủ, tên máy chủ kèm instance, và giá trị của riêng bạn, và liệt kê các id mà máy chủ đã có.
  • Một agent đã cài đặt giữ id của nó. Một lần chạy lặp lại hiển thị nó trong kế hoạch (id srv1 (kept)), giao diện văn bản khi đó không có dòng Agent id, và --agent-id ở đó chỉ đưa ra một cảnh báo. Một agent mới trong một thư mục mà một lần cài đặt trước đó để lại với cấu hình của nó cũng giữ id của cấu hình đó.

Bước 4: Kiểm tra kết quả

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

Dùng đường dẫn đầy đủ của cơ sở dữ liệu mẫu: nó hoạt động cho mọi dòng và cả sau khi cập nhật, trong khi databases.conf được giữ lại của một bản cài đặt cũ có thể không có alias employee (một bản cài đặt mới của 2027.2.3 có nó).

Mở http://<server>:23050/ trong trình duyệt và đăng nhập với tư cách admin bằng mật khẩu từ /opt/hqbird/conf/access.properties. Cổng Firebird và cổng HQ Monitor được mở trong firewalld (zone public) khi nó chạy, nếu không thì trong ufw khi nó đang hoạt động; với một tường lửa khác hãy tự mở chúng. Các cổng cluster chỉ được mở cho một tùy chọn cluster: 7443, 7444 và cổng node với --rcm on; cổng node và cổng pairing với --cluster-pairing on. Không có tường lửa đang hoạt động, trình cài đặt in một dòng với các cổng mà nó không mở. Một cổng đã mở trước khi cài đặt được giữ nguyên.

Tiếp theo: cluster

Để sao chép cơ sở dữ liệu của bạn từ một máy chủ master sang một máy chủ replica, hãy liên kết hai máy chủ trong bảng điều khiển cluster RCM. Với agent 3.1.0 và mới hơn, chỉ cài đặt RCM trên master (--rcm on, hoặc trả lời y) và bật chế độ discovery trên replica (--cluster-pairing on). Chế độ discovery mở cửa sổ pairing trong 24 giờ: cổng pairing của slot của agent (7450 cho instance đầu tiên, 7451 cho instance thứ hai, cho đến 7459) được mở trong tường lửa, và RCM có thể mời agent. Một máy chủ có một RCM (cổng 7443 và 7444); agent đã tạo ra nó sẽ chạy nó và không mở cửa sổ pairing nào.

Sau đó, không cần trình cài đặt: HQ Monitor → Clusters → Cluster on this server, hoặc fbagent --cluster-init <id> và fbagent --cluster-pairing on. Các bộ cài từ 2027.2.19 với agent cũ hơn sẽ khởi động RCM trên mỗi máy chủ và in địa chỉ của nó trong dòng RCM: của phần tóm tắt; một bản cài đặt trước 2027.2.19 sẽ có RCM khi bạn cập nhật nó bằng bộ cài mới hơn (mục 6). Hướng dẫn cluster (cho bộ cài 2027.2.33) đi từng bước từ hai máy chủ mới đến một bản sao hoạt động, kèm ảnh chụp màn hình: Hướng dẫn cluster Linux (cũng có bằng tiếng Nga và tiếng Bồ Đào Nha). Các bước tương tự chỉ dưới dạng lệnh: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Sau khi cài đặt

Các unit

Unit Cái gì Chạy dưới
firebird (2.5, 4.0, 5.0 trong /opt/firebird); firebird-superserver (3.0 trong /opt/firebird); với thư mục khác thì tên thư mục với / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 trong /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 trong /opt/fb30) Máy chủ Firebird firebird
hqbirdfbagent-fb50 (instance thứ hai hqbirdfbagent-fb50-2; trước 2027.2.9 là hqbirdfbagent-p<cổng Firebird>) Agent HQbird firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; trước 2027.2.9 là hqbirdmonitor-p<cổng Firebird>) HQ Monitor firebird

Cả ba đều được bật và khởi động cùng hệ thống. journalctl -u hqbirdfbagent-fb50 hiển thị nhật ký unit của agent. Firebird 3.0 cũng có các unit firebird-classic.socket và [email protected] (firebird.opt_fb30-classic.* trong thư mục khác), và Firebird 2.5 có firebird.socket: chúng vẫn ở trạng thái inactive, đây là bình thường. Tiến trình Firebird 2.5 là fb_smp_server (SuperClassic).

Các tệp nằm ở đâu

Ví dụ là instance Firebird 5.0 đầu tiên trong /opt/firebird trên cổng 3050. Instance thứ hai của dòng có -2 trong tên agent (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Các instance được cài trước 2027.2.9 có cổng trong các tên này (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

Trình cài đặt không giữ gì trong /var/tmp: thư mục làm việc của nó /var/tmp/hqbird2027.XXXXXX được xóa khi kết thúc, kể cả sau lỗi.

Nhật ký

Nhật ký Ở đâu
Trình cài đặt terminal; /var/log/fbagent/install.log
Agent /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; nhật ký kiểm toán /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Cập nhật không có HQCenter

Từ bộ cài 2027.2.31 (agent 3.3.0), một agent không gắn với HQCenter nào sẽ lấy phiên bản mới từ máy chủ cập nhật của nhà cung cấp. Chế độ cập nhật là khóa update.mode của agent_config.json:

Chế độ Cái gì tự cập nhật
agent (mặc định) Agent, HQ Monitor và fbmcp. Gói Firebird mới được tải xuống và chờ quản trị viên
all Như trên, và cả Firebird, trong cửa sổ áp dụng của nó (ban đêm từ 03:30 đến 04:00; cập nhật khởi động lại Firebird)
off Không gì cả: agent không kiểm tra cập nhật. Để cập nhật, chạy trình cài đặt của phiên bản mới (mục 6)
  • Khi cài đặt: dòng Updates của giao diện văn bản, hoặc --auto-update all|agent|off. Không có chúng, trình cài đặt không thay đổi chế độ.
  • Sau đó: trang Updates của HQ Monitor, hoặc trình cài đặt lại với --auto-update <mode>.
  • Trạng thái: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (thêm --json cho script). Nó in nguồn phát hành, vùng và câu trả lời cuối cùng của máy chủ cập nhật.

Agent chỉ mở các kết nối HTTPS đi ra tới các địa chỉ này. Không cần cổng vào.

Mục đích Địa chỉ
Cập nhật, vùng EU liceu.ibsurgeon.com:9443
Cập nhật, vùng BR licbr.ibsurgeon.com:9443
Cập nhật, vùng RU licru.ibsurgeon.com:20943
Giấy phép dùng thử trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Một máy chủ gắn với HQCenter không dùng các địa chỉ cập nhật: nó lấy cập nhật từ HQCenter đó (mục 8).

Thông báo

Từ bộ cài 2027.2.33 (agent 3.4.0), agent gửi tin nhắn về các vấn đề của máy chủ tới một bot Telegram của riêng bạn, một webhook hoặc e-mail (SMTP). Trình cài đặt không đặt kênh nào, và không có gì được gửi cho đến khi bạn thêm một kênh: HQ Monitor → Servers → Notifications. Để kiểm tra một kênh từ dòng lệnh: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history in các lần gửi gần nhất.

5. Cập nhật một HQbird cũ hơn (2024 và trước đó)

Trình cài đặt tìm thấy một HQbird (FBDataGuard) đã cài trong /opt/hqbird và các unit của nó, cùng các máy chủ Firebird mà nó quản lý. Sau đó nó tuân theo các quy tắc giống như các script cài đặt HQbird:

Diagram

Những gì bạn thấy trên terminal:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • Kế hoạch nêu tên Firebird được cập nhật; --fb-root và --port không thể di chuyển nó (unit của nó đã được lấy).
  • Câu hỏi Confirm to stop running Firebird? được hỏi khi engine phải dừng; dòng trước nó hiển thị các kết nối đang mở. Another version được hỏi khi HQbird cũ hơn quản lý một Firebird của phiên bản khác (cập nhật cái đó, hoặc một cái mới bên cạnh nó). --yes trả lời tất cả câu hỏi bằng Yes; không có terminal và không có --yes trình cài đặt dừng với mã thoát 4 và không thay đổi gì.
  • --disable-hqbird tắt các unit HQbird cũ trong mọi trường hợp; --no-hqbird để yên HQbird cũ (nó tiếp tục chạy bên cạnh HQbird 2027).
  • Mật khẩu SYSDBA không được hỏi: agent lấy nó từ HQbird cũ.
  • HQ Monitor dùng thông tin đăng nhập của HQbird cũ: tệp của nó /opt/hqbird/conf/access.properties được giữ lại, vì vậy hãy đăng nhập bằng login và mật khẩu bạn đã dùng trước đó. Trình cài đặt giao tệp cho firebird với quyền 0600 (HQbird cũ để nó cho mọi người dùng đọc được). Đăng nhập khách của HQbird cũ (access.guest-login) không được HQ Monitor sử dụng.

Những gì được giữ: firebird.conf, databases.conf / aliases.conf, cơ sở dữ liệu bảo mật, mật khẩu SYSDBA, các cơ sở dữ liệu, các bản sao lưu và các tệp của HQbird cũ. Cập nhật thay thế các tệp chương trình Firebird tại chỗ; các tệp nó đã thay thế được giữ trong /opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/ (hai bản cập nhật mới nhất được giữ). Các job của HQbird (sao lưu, sweep, giám sát) được nhập vào agent mới. Giấy phép HQbird của HQbird cũ không được chuyển giao: agent mới chạy bản dùng thử cho đến khi một giấy phép được cài đặt hoặc máy chủ được gắn vào HQCenter của bạn.

Từ bộ cài 2027.2.33 (agent 3.4.0), việc nhập cấu hình của HQbird cũ làm thêm hai việc:

  • Nó đăng ký các cơ sở dữ liệu của HQbird cũ trong tệp alias của Firebird (databases.conf, hoặc aliases.conf cho 2.5) dưới dạng các dòng name = path. Tệp cũ được sao chép trước. Một cơ sở dữ liệu bị bỏ qua khi đường dẫn của nó đã có trong tệp, hoặc khi tệp của nó không tồn tại. Một tệp có chỉ thị include không bị thay đổi.
  • Nó xóa các nhật ký giám sát cũ của HQbird cũ: nội dung của các thư mục mon/outcoming và mon/outtrace của thư mục đầu ra của nó (các thư mục vẫn còn). Không có gì bị xóa khi một dịch vụ của HQbird cũ đang chạy. Việc xóa không thể hoàn tác: nếu bạn cần các nhật ký này, hãy sao chép chúng trước khi cài đặt.

Cả hai đều được bật theo mặc định. Các khóa hqbird_import.register_databases và hqbird_import.clean_mon_logs của agent_config.json (cả hai đều có trong trình chỉnh sửa cấu hình của HQ Monitor) tắt chúng cho một lần nhập sau; trình cài đặt không có tùy chọn cho chúng.

Trạng thái của các unit HQbird cũ trước khi tiếp quản được lưu trong /opt/hqbird/fbagent-hqbird-takeover.json. --uninstall không bật lại chúng.

Dạng không giám sát:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. Cập nhật HQbird 2027 lên phiên bản mới

Một trình cài đặt mới hơn của cùng dòng, chạy trên một máy chủ có HQbird 2027, sẽ cập nhật instance đã cài tại chỗ: Firebird, các tệp debug, agent và HQ Monitor. Cấu hình, các cơ sở dữ liệu, trạng thái dùng thử hoặc giấy phép, cổng HQ Monitor và thông tin đăng nhập được giữ lại.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Trong giao diện văn bản, trang đầu tiên hiển thị Plan M10: Update of an installed HQbird 2027, agent với id của nó (kept), và không có dòng Agent id; Install bắt đầu cập nhật. Trình cài đặt dạng văn bản in:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

Một bản cập nhật không thay đổi tên của thư mục agent và các unit: instance trong ví dụ này được cài đặt trước 2027.2.9 và giữ nguyên fbagent-p3050.

Khi bản dựng Firebird của bộ cài là bản đã được cài đặt (ví dụ Firebird 2.5.9.27194 trong mọi HQbird 2027 dành cho 2.5), chỉ agent và HQ Monitor được cập nhật: Firebird không bị dừng và không có câu hỏi Confirm to stop.

databases.conf được giữ lại của một instance được cài bởi HQbird 2027 cũ hơn có thể không có alias employee; hãy kết nối tới cơ sở dữ liệu mẫu bằng đường dẫn đầy đủ (mục 3, bước 4). Trên Firebird 3.0, một bản cập nhật từ 2027.2.0 để lại /opt/firebird/examples/empbuild/employee.fdb với quyền 0444, và Firebird không thể mở nó (no permission for read-write access); nếu bạn cần cơ sở dữ liệu mẫu: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Các cơ sở dữ liệu của riêng bạn không bị động đến.

  • Với nhiều instance của cùng dòng, hãy nêu tên instance cần cập nhật: --fb-root /opt/fb50-2 --port 3056.
  • Chạy lại cùng bộ cài trên phiên bản đã cài là một thao tác sửa chữa: các tệp chương trình và unit được ghi lại, dữ liệu vẫn giữ nguyên.
  • Sau khi kết nối tới một HQCenter (mục 8), agent, HQ Monitor, Firebird và các thành phần cluster được cập nhật từ danh mục HQCenter; khi đó không cần bộ cài mới.
  • Một máy chủ không gắn với HQCenter nào với agent 3.3.0 trở lên (các bộ cài từ 2027.2.31) tự cập nhật agent, HQ Monitor và fbmcp, trừ khi chế độ cập nhật là off (“Cập nhật không cần HQCenter” trong mục 4). Một bản cài đặt được thực hiện trước 2027.2.31 sẽ có được điều này sau một lần cập nhật bằng bộ cài mới hơn. Cập nhật bằng bộ cài giữ nguyên chế độ cập nhật; --auto-update <mode> thay đổi chế độ đó.

7. Các lệnh bảo trì

Mọi thao tác bảo trì là một lần chạy bộ cài với các tùy chọn, hoặc một lệnh agent trong thư mục agent. Trong terminal, một lần chạy không có --yes sẽ mở giao diện văn bản với các tùy chọn này đã được đặt sẵn (các bộ cài sau 2027.2.30): kiểm tra kế hoạch ở trang đầu tiên, sau đó chọn Install.

Thao tác Lệnh
Một instance khác của cùng dòng sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Sửa chữa / cập nhật sudo sh hqbird2027-fb50-linux-<ver>.run (với nhiều instance: --fb-root <folder> --port <port>)
Gắn vào HQCenter sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json trong quá trình cài đặt, hoặc sau đó cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Gửi email dùng thử cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
Xác nhận mã dùng thử từ email cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (hoặc trong HQ Monitor)
Cài đặt tệp giấy phép --license <file> trong quá trình cài đặt, hoặc cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Trạng thái cài đặt sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Trạng thái cập nhật (không có HQCenter) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Thay đổi chế độ cập nhật (không có HQCenter) HQ Monitor, trang Updates; hoặc sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Gỡ bỏ sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Một instance khác

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

Firebird mới được đặt vào /opt/fb50-2 (một thư mục mới hoặc trống), unit firebird.opt_fb50-2, với agent riêng (/opt/hqbird/fbagent-fb50-2, unit hqbirdfbagent-fb50-2) và HQ Monitor riêng (http://localhost:23056/, unit hqbirdmonitor-fb50-2). Agent nhận số trống thấp nhất của dòng: fb50-2 cho instance thứ hai, kể cả khi có một agent được cài trước 2027.2.9 (fbagent-p3050). Tệp đăng nhập HQ Monitor /opt/hqbird/conf/access.properties được chia sẻ bởi các instance trên máy chủ: một instance mới không có --hqmonitor-login giữ nguyên thông tin đăng nhập hiện có, và --hqmonitor-login/--hqmonitor-password-file trên bất kỳ instance nào sẽ thay đổi thông tin đăng nhập của tất cả các instance (tệp cũ được giữ lại dưới tên access.properties.bak-<time>). Firebird 2.5 không hỗ trợ instance thứ hai: bộ cài dừng với refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (mã thoát 1, không có gì thay đổi). Hãy cài một Firebird của dòng khác bên cạnh nó, ví dụ sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Gỡ bỏ

Việc gỡ bỏ trên Windows và Linux, các máy chủ trong một cluster và những gì còn lại trên đĩa được mô tả đầy đủ trong hướng dẫn gỡ bỏ. Tóm tắt:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Không có --agent-dir, bộ cài sẽ gỡ agent duy nhất trong /opt/hqbird. Với nhiều agent trên máy chủ, nó sẽ dừng (mã thoát 1), liệt kê các thư mục của chúng và yêu cầu --agent-dir:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

--uninstall dừng và gỡ các unit của agent và HQ Monitor của nó (hqbirdfbagent-fb50, hqbirdmonitor-fb50), các quy tắc sudoers của agent và các chương trình của nó (fbagent, hqmonitor), và đóng cổng HQ Monitor mà bản cài đặt đã mở trong firewalld hoặc ufw. Thư mục agent vẫn giữ lại cùng cấu hình và log; --remove-data gỡ cả thư mục và dữ liệu HQ Monitor trong /var/lib/hqmonitor/. Firebird vẫn được cài đặt (unit, thư mục chương trình, cơ sở dữ liệu); các unit HQbird cũ đã bị tắt vẫn giữ trạng thái tắt. Với nhiều agent trên máy chủ, tệp đăng nhập HQ Monitor dùng chung vẫn còn cho đến khi agent cuối cùng bị gỡ.

Nếu agent đang chạy RCM của máy chủ và các agent khác sử dụng RCM đó, --uninstall sẽ từ chối với mã thoát 5 và không thay đổi gì: this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force vẫn gỡ agent; khi đó cluster mất CA của nó (không có chứng chỉ mới, không có thành viên mới). Unit RCM vẫn còn khi các agent khác của máy chủ sử dụng nó. Để biến một agent khác thành chủ sở hữu của một RCM mới khi chủ sở hữu cũ không còn: fbagent --cluster-init <id> --rcm-takeover (một CA mới: liên kết lại các thành viên).

Gợi ý ở cuối quá trình cài đặt (Uninstall: sudo sh ... --uninstall) không có --agent-dir: với nhiều instance, hãy thêm nó như được hiển thị ở trên.

Để gỡ cả Firebird của một instance (bộ cài không làm việc này; hãy tạo bản sao lưu gbak cho các cơ sở dữ liệu của nó trước), ví dụ Firebird trong /opt/fb50-2:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

8. Gắn vào HQCenter của bạn

HQCenter là máy chủ trung tâm của công ty bạn, quản lý các agent HQbird: giấy phép, cấu hình, cập nhật, tổng quan sao lưu. Không có HQCenter, agent hoạt động độc lập với các phiên bản của bộ cài và tệp dùng thử hoặc giấy phép.

Diagram
  1. Trong bảng quản trị HQCenter, mở Tokens (https://<hqcenter>:8443/admin/tokens). Trong biểu mẫu Install script, chọn giấy phép (hoặc không chọn), chế độ, số lượng máy chủ và thời hạn hiệu lực (1 đến 365 ngày); các trường nền tảng và Firebird không được dùng. Nhấn Download connection file và lưu attach.json. Tệp chứa một token bí mật: hãy giữ nó an toàn (chmod 600), xóa nó sau khi dùng và thu hồi token trong danh sách trên cùng trang đó. Biểu mẫu chỉ được hiển thị khi admin_panel.install_script_url được đặt.
  2. Sao chép attach.json tới máy chủ.
  3. Gắn theo một trong hai cách:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

Với một token thông thường, lệnh sẽ chờ cho đến khi quản trị viên HQCenter phê duyệt yêu cầu (tối đa 30 phút). Với một token giấy phép, agent được gắn ngay lập tức và nhận giấy phép. Sau khi gắn, bản dùng thử kết thúc khi HQCenter cấp giấy phép cho agent; agent, HQ Monitor, Firebird và các thành phần cluster sau đó được cập nhật từ danh mục HQCenter. Một lần gắn thất bại trong quá trình cài đặt không hoàn tác bản cài đặt: phần tóm tắt nói rõ điều đó, và lệnh ở trên sẽ lặp lại thao tác đó.

Yêu cầu: HQCenter (goafts) 1.15.0 trở lên (các phiên bản cũ hơn không có nút tệp kết nối); máy chủ tiếp cận cổng bootstrap của HQCenter một lần để gắn và sau đó là cổng của các agent (mặc định là 443). HQCenter có thể không có Internet. Lần gắn thứ hai của cùng một máy chủ vào cùng một HQCenter cần sự phê duyệt của quản trị viên ngay cả khi có token giấy phép.

9. Cài đặt không giám sát và các script

Mọi tùy chọn đều hoạt động trên terminal. Một lần chạy không giám sát cần --yes (trả lời các câu hỏi của kế hoạch; không có terminal và không có --yes bộ cài sẽ dừng với mã thoát 4). --yes không bao giờ mở giao diện văn bản. Một script khởi chạy bộ cài trong terminal và tự trả lời các câu hỏi của nó (ví dụ với expect) phải thêm --no-tui hoặc đặt HQBIRD_NO_TUI=1: các bộ cài sau 2027.2.30 sẽ mở các trang ở đó. Mã thoát cho biết kết quả; các chi tiết có trên terminal và trong /var/log/fbagent/install.log.

Các tùy chọn

Tùy chọn Ý nghĩa Mặc định
--fb-root DIR Thư mục của Firebird mới (mới hoặc trống); hoặc thư mục của Firebird cần cập nhật /opt/firebird, sau đó /opt/fb<NN>
--port N Cổng Firebird 3050 cho Firebird đầu tiên; với dòng khác là cổng của dòng đó (3053 cho 3.0, 3054 cho 4.0, 3055 cho 5.0)
--sysdba-pass-file F, --sysdba-pass P Mật khẩu SYSDBA của một Firebird mới (dòng đầu tiên của F; P được ghi vào một tệp 0600) được tạo, lưu trong /root/fbagent-install-sysdba.txt; một Firebird khác trên máy chủ lấy mật khẩu từ tệp đó
--agent-id ID agent.id của agent mới; chỉ ở lần cài đặt đầu tiên, một agent đã cài đặt giữ nguyên id của nó (“The agent id” trong mục 3) tên máy chủ + ngày + instance
--hqmonitor-port N Cổng HQ Monitor 20000 + cổng Firebird
--hqmonitor-login L --hqmonitor-password-file F Thông tin đăng nhập HQ Monitor, được chia sẻ bởi tất cả các instance trên máy chủ: nếu đặt trên một instance, nó sẽ thay đổi thông tin đăng nhập của tất cả admin + mật khẩu được tạo; một bản cập nhật hoặc một instance khác giữ nguyên thông tin đăng nhập hiện có
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Email dùng thử (30 ngày); địa chỉ được gửi tới máy chủ dùng thử của nhà cung cấp không có
--auto-update all|agent|off Cập nhật của một máy chủ không gắn với HQCenter nào (các bộ cài từ 2027.2.31): agent = agent, HQ Monitor và fbmcp tự cập nhật, một gói Firebird chờ bạn; all = cả Firebird, trong khung thời gian của nó; off = không kiểm tra cập nhật (“Cập nhật không cần HQCenter” trong mục 4) chế độ không bị thay đổi; một agent mới có agent

| --license F | Tệp giấy phép cần cài đặt | không có | | --attach F | Đính kèm vào HQCenter của bạn (attach.json) | không có | | --no-hqbird, --disable-hqbird | Để yên HQbird cũ / tắt tất cả các unit của nó | tự động | | --no-debug | Không cài đặt các tệp gỡ lỗi của Firebird | được cài đặt | | --no-fbmcp | Không cài đặt fbmcp (máy chủ MCP cho các ứng dụng AI) và không thay đổi fbmcp của máy chủ này | được cài đặt | | --fbmcp-allow-from A,B | Bật chế độ từ xa của fbmcp cho các địa chỉ quản trị này (IP hoặc CIDR) | chỉ cục bộ | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | Cổng từ xa của fbmcp; các tên bổ sung cho chứng chỉ của nó; địa chỉ cho chứng chỉ và trình lắng nghe | cổng 8650 | | --rcm on\|off | Cài đặt bảng điều khiển cụm RCM trên máy chủ này và tạo một cụm mới (agent 3.1.0 trở lên) | được hỏi; Không | | --rcm-password-file F | Mật khẩu quản trị RCM với --rcm on (dòng đầu tiên của F) | được tạo, hiển thị ở cuối | | --cluster-id ID | Id cụm với --rcm on | tên máy chủ | | --cluster-pairing on\|off | Chế độ khám phá: cửa sổ ghép nối trong 24 giờ, một RCM có thể mời agent này | được hỏi; Không | | --rcm-allow A,B,... | Chỉ các RCM này có thể mời máy chủ này trong chế độ khám phá (IP, CIDR hoặc tên máy chủ) | bất kỳ RCM nào | | --pairing-port N | Cổng ghép nối 7450–7459 của một agent mới; nó chọn khe (cổng nút 7051+k, 7061+k). Thiết lập sau đó giữ nguyên khe | khe trống đầu tiên | | --cluster-node on\|off | Đưa dịch vụ nút cụm vào bộ nhớ đệm của agent | bật | | --yes | Trả lời Có cho các câu hỏi của kế hoạch (Không cho các câu hỏi về cụm) | hỏi | | --check | Chỉ kiểm tra, các thư viện và kế hoạch; không có gì bị thay đổi | — | | --plan-help | In ra ý nghĩa của các mã trong kế hoạch (M1, M2, …) và thoát | — | | --no-tui | Trình cài đặt đơn giản, không có giao diện văn bản; cũng là biến HQBIRD_NO_TUI=1 (“Trình cài đặt đơn giản” trong phần 3) | giao diện văn bản trong một terminal | | --lang en\|ru\|pt-BR\|de | Ngôn ngữ của trình cài đặt; cũng là biến HQBIRD_LANG (“Ngôn ngữ của trình cài đặt” trong phần 3) | locale UTF-8 của bảng điều khiển, nếu không thì tiếng Anh | | --tmpdir DIR | Giải nén tại đây (một thư mục nơi các chương trình có thể chạy) | /var/tmp | | --extract DIR | Chỉ giải nén payload vào DIR/payload và thoát | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Xóa agent và HQ Monitor (Firebird vẫn còn); --force cũng xóa agent đang chạy RCM của máy chủ trong khi các agent khác sử dụng nó | — |

Các tùy chọn có thể được viết là --port 3055 hoặc --port=3055. Đường dẫn tương đối được tính từ thư mục hiện tại.

Ví dụ

Cài đặt mới với các giá trị mặc định:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

Cài đặt mới vào một thư mục và cổng đã chọn, với mật khẩu SYSDBA từ một tệp và đăng nhập HQ Monitor:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Cài đặt mới với email dùng thử, một tệp giấy phép và tệp đính kèm:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Cập nhật một HQbird cũ, tắt tất cả các unit của HQbird cũ:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

Cập nhật HQbird 2027 lên phiên bản mới (một phiên bản; với nhiều phiên bản, thêm --fb-root và --port):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

Một phiên bản Firebird 5.0 thứ hai trên cổng 3056:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

Gỡ bỏ:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Một script dừng lại khi cài đặt thất bại:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

Máy chủ không có Internet: thư viện hệ điều hành

Firebird của một dòng cần các thư viện này từ hệ điều hành (ngoài glibc):

Dòng Gói (Debian/Ubuntu) Gói (họ RHEL)
5.0 libtommath1, libicu<NN>, libgssapi-krb5-2 libtommath (EPEL), libicu, krb5-libs
4.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
3.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
2.5 thường không có gì (libstdc++6 có trong hệ thống cơ sở) thường không có gì

Các bộ cài sau 2027.2.30 của các dòng 3.0, 4.0 và 5.0 cũng cần chương trình colrm, mà script cài đặt Firebird sử dụng: gói bsdextrautils (bsdmainutils trên Debian và Ubuntu cũ hơn). Một Debian tối giản không có gói nào; họ RHEL có nó trong util-linux, luôn có sẵn.

Khi một gói bị thiếu và kho lưu trữ không thể truy cập, trình cài đặt dừng với mã thoát 6 và không có gì bị thay đổi:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

Trên họ RHEL, libtommath nằm trong EPEL: với một kho lưu trữ có thể truy cập, trình cài đặt tự thêm epel-release. Không có kho lưu trữ, các lệnh là dnf install -y epel-release, dnf download --resolve <packages> và dnf install -y ./*.rpm. --check in ra danh sách tương tự trước, để các gói có thể được chuẩn bị trước cửa sổ cài đặt.

Mã thoát

Mã Ý nghĩa Thay đổi trên máy chủ
0 Hoàn tất (các cảnh báo về email dùng thử, tệp đính kèm hoặc giấy phép có trong bản tóm tắt) có
1 Từ chối: máy chủ, một tùy chọn, một tệp hoặc kế hoạch (lý do được in ra). Cũng: Thoát trong giao diện văn bản không có
2 Cài đặt thất bại và đã được hoàn tác. Cũng: trình cài đặt bị dừng bởi một tín hiệu (Ctrl+C) đã hoàn tác; không có gì khi bị dừng trước khi cài đặt
3 Cài đặt thất bại và việc hoàn tác không hoàn tất (bản tóm tắt cho biết cần kiểm tra gì) một phần
4 Một câu hỏi của kế hoạch không được xác nhận (không có terminal, không có --yes). không có
5 Payload không vượt qua kiểm tra (sha256, chữ ký): tải lại tệp. Với --uninstall: bị từ chối, agent chạy RCM của máy chủ và các agent khác sử dụng nó (phần 7) không có
6 Thiếu thư viện hệ điều hành và kho lưu trữ gói không thể truy cập không có
7 Một Firebird từ các gói của bản phân phối đã được cài đặt không có

10. Khắc phục sự cố

Vấn đề Việc cần làm
run as root (sudo sh ...) Chạy trình cài đặt với sudo hoặc với tư cách root
Các trang của giao diện văn bản không mở Dòng đầu tiên cho biết lý do: needs a window of 80x24 or larger (làm cho cửa sổ lớn hơn; tmux với một dòng trạng thái chiếm một hàng) hoặc needs bash 4.4 or newer. Trình cài đặt đơn giản chạy sau đó thực hiện cùng một cài đặt
Ký tự sai hoặc dòng bị hỏng trên các trang Đặt terminal thành UTF-8, hoặc chạy với --lang en; --no-tui chạy trình cài đặt đơn giản
/var/tmp is mounted noexec Chạy lại với --tmpdir /root (bất kỳ thư mục nào nơi các chương trình có thể chạy)
is damaged or cut (mã thoát 5) Sao chép lại tệp .run và so sánh sha256sum của nó với giá trị đã công bố
Mã thoát 6, thiếu thư viện Chuẩn bị các gói như được in ra (phần 9), sau đó chạy lại trình cài đặt
Mã thoát 7, Firebird từ các gói của bản phân phối Xóa các gói (apt-get remove firebird3.0-server, giữ một bản sao lưu gbak) hoặc sử dụng trình cài đặt trực tuyến với --import-firebird
refused (M17): Firebird 2.5 works only in /opt/firebird Không thể có một Firebird 2.5 thứ hai; cài đặt một dòng khác bên cạnh nó (phần 7)
--uninstall bị từ chối (mã thoát 1) với nhiều agent Thêm --agent-dir với một thư mục từ danh sách, ví dụ --agent-dir /opt/hqbird/fbagent-fb50-2
--uninstall bị từ chối (mã thoát 5): this agent runs the RCM of the host Xóa cụm trong bảng điều khiển RCM trước, hoặc chạy lại với --force (phần 7)
no permission for read-write access tới employee.fdb sau khi cập nhật (3.0) sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (phần 6)
refused (M14): the folder is not empty Chọn một thư mục trống hoặc mới với --fb-root, hoặc đặt tên cho Firebird cần cập nhật
Mã thoát 2 hoặc 3 Đọc /var/log/fbagent/install.log; các unit đã trở về trạng thái trước khi chạy (mã 2) hoặc cần kiểm tra (mã 3)
HQ Monitor không mở systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> trước 2027.2.9); kiểm tra rằng không có gì khác lắng nghe trên cổng; mở cổng trong tường lửa; --hqmonitor-port cho một cổng khác
Mất mật khẩu HQ Monitor Chạy lại trình cài đặt (sửa chữa) với --hqmonitor-login admin --hqmonitor-password-file <file>; tệp /opt/hqbird/conf/access.properties cũ được giữ là access.properties.bak-<time>. Đăng nhập mới có hiệu lực cho tất cả các phiên bản của máy chủ
Email dùng thử không được gửi (không có mạng) Gửi sau: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy
SELinux (AlmaLinux, RHEL) Được hỗ trợ ở chế độ enforcing: trình cài đặt khôi phục các ngữ cảnh của các tệp nó ghi; không cần làm gì