HQbird 2027 cho Linux: hướng dẫn cài đặt
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. Trình cài đặt cài những gì
- 2. Tổng quan về quá trình cài đặt
- 3. Cài đặt mới
- 4. Sau khi cài đặt
- 5. Cập nhật một HQbird cũ hơn (2024 và trước đó)
- 6. Cập nhật HQbird 2027 lên phiên bản mới
- 7. Các lệnh bảo trì
- 8. Gắn vào HQCenter của bạn
- 9. Cài đặt không giám sát và các script
- 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-debugbỏ qua chúng. - HQbird agent (
fbagent): unit systemdhqbirdfbagent-fb50, chạy dưới người dùngfirebird, 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/hqbirdrcmvà chạy dưới unithqbirdrcm; phần tóm tắt in địa chỉ của nó trong dòngRCM:. 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ó unithqbirdrcmvà không có dòngRCM:.
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
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ó
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.sha256Cá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)
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
sudo sh hqbird2027-fb50-linux-2027.2.9.runCá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.
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: quitCá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ếnHQBIRD_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; TERMlàdumbhoặc không được đặt;- cửa sổ nhỏ hơn 80 cột x 24 dòng (bên trong
tmuxvớ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:
[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 --uninstallVí 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à:
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.--yesvà 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ỉrootvà 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:
- tùy chọn
--lang en|ru|pt-BR|de; - biến
HQBIRD_LANG; - locale của console (
LC_ALL, sau đóLC_MESSAGES, sau đóLANG), khi nó là một locale UTF-8; - 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:
[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 đó.--langvẫ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-8hoặcen_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ã:
[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 IDcung 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ả
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.fdbDù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).
/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--jsoncho 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:
Những gì bạn thấy trên terminal:
[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-rootvà--portkhô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ó).--yestrả lời tất cả câu hỏi bằng Yes; không có terminal và không có--yestrình cài đặt dừng với mã thoát 4 và không thay đổi gì. --disable-hqbirdtắ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 chofirebirdvớ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ặcaliases.confcho 2.5) dưới dạng các dòngname = 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ịincludekhô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/outcomingvàmon/outtracecủ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:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. 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.
sudo sh hqbird2027-fb50-linux-2027.2.9.runTrong 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:
[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
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056Firebird 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:
# 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-dataKhô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:
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:
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 $B8. 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.
- 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ưuattach.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ị khiadmin_panel.install_script_urlđược đặt. - Sao chép
attach.jsontới máy chủ. - Gắn theo một trong hai cách:
# 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.jsonVớ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:
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:
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.txtCài đặt mới với email dùng thử, một tệp giấy phép và tệp đính kèm:
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.jsonCập nhật một HQbird cũ, tắt tất cả các unit của HQbird cũ:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdCậ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):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesMột phiên bản Firebird 5.0 thứ hai trên cổng 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Gỡ bỏ:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataMột script dừng lại khi cài đặt thất bại:
#!/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:
[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 ./*.debTrê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ì |