Cài đặt và cập nhật
Cài đặt không bất ngờ
Một bộ cài cho mỗi dòng Firebird. Nó tìm Firebird, HQbird cũ và các agent trên máy chủ, hiển thị kế hoạch và không thay đổi gì cho đến khi bạn nói "Có". Sau đó, agent tự cập nhật, console và Firebird tự cập nhật, có kiểm tra và khôi phục.
- 4 bộ cài: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 thay đổi trước khi bạn xác nhận kế hoạch
- không cần internet mọi thứ trong một tệp
- Windows và Linux wizard, chế độ im lặng, .run
- khôi phục nếu cài đặt hoặc cập nhật thất bại
setup.exe · .run
Bộ cài có gì
Bộ cài là một tệp: hqbird2027-fb50-setup-<version>.exe cho Windows hoặc hqbird2027-fb50-linux-<version>.run cho Linux. Nó chứa mọi thứ máy chủ cần. Không tải xuống gì cả.
Mỗi bộ cài cài một dòng Firebird. Chọn dòng mà cơ sở dữ liệu của bạn đang chạy. Việc cài đặt được thực hiện bởi agent bên trong bộ cài: nó kiểm tra máy chủ, lập kế hoạch và thực thi.
| Thành phần | Chức năng | Windows | Linux |
|---|---|---|---|
| Firebird, bản dựng HQbird | Máy chủ mới hoặc cập nhật tại chỗ. Với máy chủ đã cài đặt, một dòng được thêm vào firebird.conf: MonitoringPlugin = fblwmon. Với máy chủ mới, bộ cài cũng đặt cổng. databases.conf, cơ sở dữ liệu bảo mật và mật khẩu SYSDBA không thay đổi. | dịch vụ FirebirdServer… | /opt/firebird |
| Agent fbagent | Sao lưu, giám sát, bảo trì, cập nhật. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, người dùng firebird |
| HQbird Monitor | Console web cho máy chủ này. Cổng = 20000 + cổng Firebird: với 3050 là 23050. Cổng được chọn khi cài đặt và không thay đổi sau đó, ngay cả khi bạn đổi cổng Firebird. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Thành phần cluster | Các chương trình cluster được đặt trên máy chủ nhưng không được bật: RCM và cửa sổ ghép cặp tắt theo mặc định. RCM biến máy chủ thành trung tâm của một cluster mới và mở cổng 7443 và 7444. Cửa sổ ghép cặp mở cổng 7450–7459 trong 24 giờ: qua đó, RCM của máy chủ khác có thể mời máy chủ này. Bạn cũng có thể bật cả hai sau khi cài đặt. | trang wizard "Replication and cluster setup"; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| Máy chủ MCP fbmcp | Truy cập cho các ứng dụng AI vào Firebird. Theo mặc định, chỉ từ máy chủ này. | hộp kiểm trong wizard hoặc /NOFBMCP | --no-fbmcp |
| Tệp gỡ lỗi Firebird | Ký hiệu để phân tích sự cố Firebird. | — | có, --no-debug tắt nó |
- WindowsHỗ trợ: Windows 10 và 11, Windows Server 2016 trở lên, 64-bit. Quyền quản trị viên. Bộ cài được ký bởi IBSurgeon Software: Windows hiển thị nhà phát hành trong lời nhắc quyền.
- Wizard hoặc chế độ im lặngMỗi trang wizard cũng có sẵn dưới dạng công tắc:
/VERYSILENT /YES /LOG=…. Tốt cho script và cho hàng trăm máy chủ. - Wizard bằng 8 ngôn ngữTiếng Anh, Bồ Đào Nha (Brazil), Đức, Nga, Tây Ban Nha, Ba Lan, Thổ Nhĩ Kỳ, Trung Quốc giản thể. Mặc định là ngôn ngữ Windows. Công tắc:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Tên máy chủWizard hỏi tên của agent mới; HQCenter hiển thị máy chủ dưới tên này. Mặc định là tên máy tính. Chế độ im lặng:
/AGENTID=, trên Linux--agent-id. Agent đã cài đặt giữ nguyên tên của nó.
- Linuxx86_64, kernel 3.2 trở lên, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS và các hệ thống khác có apt, dnf, yum hoặc zypper.
- Máy chủ không có internetBộ cài lấy một vài thư viện OS (libtommath, ICU) từ kho. Nếu không có kho, nó in các lệnh chính xác và không thay đổi gì.
Bộ cài được kiểm tra hai lần. Trước khi giải nén: sha256 của toàn bộ bộ cài. Trước khi cài Firebird và agent: chữ ký của từng tệp. Bản tải xuống bị hỏng sẽ dừng cài đặt trước khi có bất kỳ thay đổi nào đối với Firebird, agent hoặc console.
fbagent --install-plan
Lập kế hoạch trước, thay đổi sau
Đầu tiên, bộ cài chỉ đọc: dịch vụ, registry, thư mục Firebird và HQbird. Sau đó nó hiển thị những gì tìm thấy và những gì sẽ làm. Thay đổi bắt đầu sau khi bạn nói "Có".
Chọn những gì có trên máy chủ và xem kế hoạch. Các văn bản được rút gọn và dịch; thứ tự và các quyết định giống như trong bộ cài Firebird 5.0.
- 1Kiểm tra máy chủquyền, độ bit; trên Linux cả systemd và kernel
- 2Kiểm tra bộ càisha256 trước khi giải nén; chữ ký tệp trước khi cài đặt
- 3Kế hoạchnhững gì tìm thấy và những gì sẽ làm
- 4Câu hỏitên máy chủ cho HQCenter; dừng Firebird? phiên bản khác?
- 5Cài đặtFirebird, agent, console, dịch vụ
- 6✓ Kết quảdịch vụ, địa chỉ console, đăng nhập
Nếu có sự cố
Từ chối ở giai đoạn kế hoạch (cổng đang dùng, thư mục không trống) không thay đổi gì: bộ cài nêu lý do. Trong wizard, bạn không thể rời trang khi giá trị sai.
Lỗi trong quá trình cài đặt, trước khi dịch vụ agent khởi động: các dịch vụ trở về trạng thái trước đó. HQbird cũ, nếu đã bị dừng, sẽ khởi động lại.
| Mã | Ý nghĩa (Linux .run) |
|---|---|
| 0 | Hoàn tất |
| 1 | Từ chối: máy chủ, công tắc hoặc kế hoạch. Không thay đổi gì |
| 2 | Cài đặt thất bại, thay đổi đã khôi phục |
| 3 | Khôi phục chưa hoàn tất: kết quả nêu những gì cần kiểm tra |
| 4 | Cần câu trả lời: không có terminal và không có --yes |
| 5 | Bộ cài không qua kiểm tra: tải lại |
| 6 | Không có thư viện OS và không có kho |
| 7 | Firebird từ các gói phân phối |
| Mã | Ý nghĩa (Windows setup.exe) |
|---|---|
| 0 | Đã cài đặt |
| 1 | Từ chối trước khi cài đặt: công tắc hoặc tệp sai, phiên bản mới hơn đã được cài, không có quyền quản trị viên |
| 4 | Bộ cài có câu hỏi, nhưng không có công tắc /YES |
| 7 | Kiểm tra máy chủ hoặc cài đặt thất bại. Lý do có trong log và trong tệp kết quả |
| 10 | Đã cài đặt, nhưng kết nối đến HQCenter thất bại |
-p3050); các bản cài mới nhận -fb50.FBDataGuard → fbagent
Chuyển từ HQbird 2024
Trình cài đặt tìm thấy HQbird cũ và Firebird mà nó phục vụ. Firebird này được cập nhật tại chỗ, các tác vụ FBDataGuard chuyển sang agent, các dịch vụ cũ được dừng lại. Cơ sở dữ liệu, cấu hình và mật khẩu được giữ nguyên.
- Những gì không thay đổi
databases.confhoặcaliases.conf, cơ sở dữ liệu bảo mật, mật khẩu SYSDBA, cơ sở dữ liệu, bản sao lưu và các tệp HQbird cũ. Trongfirebird.conf, chỉ dòngMonitoringPlugin = fblwmonđược thêm vào, nếu nó còn thiếu. - Bản sao của Firebird cũThư mục chương trình của Firebird cũ được giữ lại bên cạnh với tên
<folder>.old_<time>. - Tác vụSao lưu gbak và nbackup, sweep, thống kê chỉ mục. Việc nhập chạy một lần và đi qua bước kiểm tra cấu hình mới; cấu hình cũ được giữ lại.
- Bản sao lưu cũAgent lấy các bản sao lưu từ nhật ký FBDataGuard vào hồ sơ của chính nó. Các quy tắc lưu giữ và khôi phục nhìn thấy chúng giống như các bản mới. Tên của các cấp nbackup được giữ nguyên.
- Tên tác vụTên tác vụ kết thúc bằng tên cơ sở dữ liệu từ FBDataGuard, ví dụ "Verified backup - MANUAL". Các tác vụ nhóm lặp lại cây thư mục nguồn.
- Dịch vụ cũ: ba tùy chọnTự động (khuyến nghị): vô hiệu hóa chúng khi mọi Firebird được FBDataGuard phục vụ đều có agent. Vô hiệu hóa tất cả:
/DISABLEHQBIRD. Giữ nguyên:/NOHQBIRD. - Bạn có thể quay lạiTrạng thái của từng dịch vụ trước khi bị vô hiệu hóa được lưu trong
fbagent-hqbird-takeover.json. Với tệp này, HQbird cũ có thể được bật lại. - Giấy phépGiấy phép HQbird cũ không được chuyển sang. Thời gian dùng thử chạy cho đến khi bạn nhận được giấy phép mới hoặc kết nối với HQCenter.
- Đường dẫn không rõ ràngNếu việc nhập không thể mở rộng một phép thay thế trong đường dẫn FBDataGuard, nó giữ nguyên như vậy và để tác vụ bị vô hiệu hóa. Hãy sửa đường dẫn và bật tác vụ.
Nếu các tác vụ được nhập nhưng các dịch vụ cũ vẫn chạy (ví dụ, máy chủ có hai máy chủ Firebird dưới FBDataGuard), các tác vụ sẽ đến ở trạng thái bị vô hiệu hóa. Bằng cách này, một tác vụ không chạy hai lần.
Cổng · thư mục · dịch vụ
Nhiều máy chủ Firebird trên một máy
Một agent cho mỗi Firebird. Một phiên bản mới được cài đặt bên cạnh các phiên bản khác, trên cổng riêng, với agent riêng và bảng điều khiển riêng. Các phiên bản đã cài đặt không thay đổi.
Thêm máy chủ Firebird và xem trình cài đặt chọn tên và cổng nào.
- Cổng theo dòngFirebird đầu tiên trên máy chủ nhận 3050. Cái tiếp theo: 3052 cho 2.5, 3053 cho 3.0, 3054 cho 4.0, 3055 cho 5.0. Trình cài đặt không lấy cổng đang được sử dụng.
- Phiên bản thứ hai của cùng một dòngSố
-2trong tên thư mục và dịch vụ. Trên Windows, đây là tùy chọn của trình hướng dẫn "Install another instance"; cổng là cổng trống đầu tiên trong dải của dòng đó.
- Chỉ cập nhật trong cùng một dòng5.0.x → 5.0.y. Chuyển từ 3.0 sang 5.0 nghĩa là một phiên bản thứ hai bên cạnh phiên bản đầu tiên; người dùng di chuyển cơ sở dữ liệu bằng sao lưu và khôi phục.
- XNET trên WindowsMột Firebird không ở cổng 3050 nhận tên riêng
IpcName = FIREBIRD_<port>. Các kết nối XNET cục bộ đến máy chủ thứ hai hoạt động. - Một bảng điều khiển cho mỗi agentHQbird Monitor trên 20000 + cổng Firebird: 23050, 23055. Một tệp đăng nhập cho tất cả các phiên bản trên máy chủ.
- Cổng được cố địnhCác cổng của bảng điều khiển và của API cục bộ của agent được ghi tại thời điểm cài đặt. Nếu bạn thay đổi cổng Firebird sau đó, chúng vẫn giữ nguyên. Agent không chấp nhận các cổng trùng nhau.
- Cluster: một slot cho mỗi agentMỗi agent trên máy chủ nhận một slot riêng từ 0 đến 9: cổng ghép nối 7450 + slot, cổng node 7051 + slot và 7061 + slot. Vì vậy hai agent của một máy chủ có thể tham gia một cluster. Công tắc
--pairing-portđặt slot một cách tường minh.
Image · compose · cổng
HQbird trong Docker
Có một image sẵn sàng cho mỗi dòng Firebird. Firebird, agent và HQbird Monitor chạy trong container. Agent cài đặt node cluster bên trong chính container khi máy chủ tham gia một cluster. Nó chỉ cài đặt RCM khi máy chủ này được chỉ định làm RCM của cluster.
| Image | Firebird | Cổng Firebird | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Khởi động lần đầuSao chép
compose.yamltừ bộ công cụ, đặt mật khẩu SYSDBA vào một tệp bí mật, xóa#khỏi các dòngsecrets:và chạydocker compose up -d. Máy chủ sẵn sàng khidocker compose pshiển thịhealthy. - Cổng FirebirdBiến
HQBIRD_FB_PORT, mặc định là 3050. HQbird Monitor lắng nghe trên 20000 + cổng này. - Chữ ký imageCác image được ký bằng công cụ cosign. Khóa công khai để kiểm tra chưa được công bố.
- Nhiều phiên bản trên một máy chủFirebird trên 3050 + N, HQbird Monitor trên 20000 + cổng Firebird, node cluster trên 7051 + N. Chỉ một phiên bản trên máy chủ có thể có RCM.
- Cùng số cổng bên ngoài và bên trongXuất bản
3051:3051, không phải3051:3050. Agent và cluster báo cáo cổng mà chúng thấy bên trong container. - ClusterĐịa chỉ thành viên là địa chỉ của máy chủ Docker. Xuất bản cổng node và, đối với RCM, các cổng 7443 và 7444.
Docker xuất bản cổng vượt qua ufw. Một quy tắc ufw "chỉ cổng 22" không đóng các cổng của container. Hãy xuất bản cổng trên một địa chỉ máy chủ hoặc đóng nó bằng tường lửa bên ngoài.
Cloud và Docker: cài đặt, volume, cổng, cập nhậtAgent · bảng điều khiển · cluster · Firebird
Cập nhật sau khi cài đặt
Sau khi kết nối với HQCenter, agent tự cập nhật chính nó, HQbird Monitor, các thành phần cluster, fbmcp và Firebird. Một máy chủ không có HQCenter cũng tự cập nhật: agent lấy phiên bản mới từ máy chủ cập nhật của IBSurgeon.
Agent nhìn thấy phiên bản mới của chính nó trong HQCenter trong vòng một phút. Phiên bản mới của HQbird Monitor, fbmcp và Firebird: trong vòng một giờ. Mọi bản cập nhật đều theo một mẫu: kiểm tra, lưu điểm khôi phục, thay thế, đảm bảo nó hoạt động. Nếu không hoạt động, khôi phục bản cũ.
Cập nhật không có HQCenter
- Những gì tự cập nhậtAgent, HQbird Monitor và máy chủ MCP. Việc kiểm tra chạy 6 giờ một lần.
- Firebird chờ một lệnhGói Firebird được tải xuống và chờ. Quản trị viên áp dụng nó: bằng nút trên trang Updates hoặc bằng lệnh
fbagent --firebird-update --apply. - Bạn chọn chế độCông tắc cài đặt
--auto-update all|agent|off, trên Windows/AUTOUPDATE=all|agent|off.agentlà mặc định.allcũng cài đặt Firebird, trong cửa sổ cập nhật.offkhông kiểm tra gì cả.
- Trang Updates trong HQbird MonitorHiển thị nơi agent lấy phiên bản từ đó, chế độ và câu trả lời cuối cùng của máy chủ, trạng thái của các bản cập nhật Firebird, bảng điều khiển và máy chủ MCP. Quản trị viên thay đổi chế độ và áp dụng gói Firebird.
- Kiểm tra nguồnMáy chủ cập nhật được kiểm tra dựa trên một khóa được ghim. Chữ ký của nhà cung cấp luôn được yêu cầu.
- Cluster đi qua trung tâmMột node cluster và RCM không cập nhật theo cách này: HQCenter hoặc RCM cập nhật chúng.
Agent tự cập nhật
- Chỉ tiến về phía trướcAgent không cài đặt phiên bản cũ hơn phiên bản của chính nó, kể cả phiên bản bắt buộc. Việc kiểm tra chạy trước khi byte đầu tiên được tải xuống. Nhờ vậy, một máy chủ giả mạo không thể khôi phục một bản dựng cũ có lỗ hổng. Ngoại lệ là một phiên bản cũ được cho phép trong cấu hình của chính agent (
allow_downgrade_to). - Chữ kýCác bản phát hành được ký bằng khóa Ed25519; khóa công khai được tích hợp sẵn trong agent. Chữ ký sai luôn bị từ chối. Chế độ "chỉ chấp nhận bản đã ký" được bật trong cấu hình của chính agent, không phải từ máy chủ.
- Khôi phục thủ côngBên cạnh agent có một script
rollback_to_version_NNN: nó khôi phục agent và cấu hình trước đó và chặn phiên bản bị lỗi. Hai điểm khôi phục mới nhất được giữ lại; các điểm cũ hơn bị xóa tự động. - Linux: root chỉ chạy bản sao của chính nóAgent chạy dưới người dùng
firebird. Việc thay thế được thực hiện bởi một bản sao đã được xác minh trong một thư mục mà chỉ root mới có quyền ghi.
Cập nhật Firebird
Firebird chỉ được cập nhật trong cùng dòng của nó và chỉ lên bản dựng mới hơn. Agent có thể tải xuống và chuẩn bị gói bất cứ lúc nào, nhưng nó chỉ dừng Firebird trong khung thời gian cập nhật.
- 1Chuẩn bịtải xuống, chữ ký, bản dựng không cũ hơn engine
- 2Khung thời giankhung thời gian hàng ngày; bản phát hành bắt buộc cũng chờ khung thời gian
- 3Tác vụgbak, nbackup hoặc một script SQL đang chạy: lần thử bị hoãn lại
- 4Thay thếcác tệp engine cũ được đặt sang một bên, cấu hình được giữ nguyên
- 5Kiểm traFirebird khởi động và phản hồi trên cổng của nó
- 6✓ hoặc khôi phụccác tệp cũ quay trở lại, bản dựng bị chặn
| Thành phần được cập nhật | Bảo vệ | Nếu thất bại |
|---|---|---|
| agent fbagent | Chữ ký, chỉ bản mới hơn, sẵn sàng trong 180 giây và chạy trong 45 giây | Khôi phục, tạm dừng 30 phút; lần thất bại thứ hai sẽ chặn phiên bản |
| HQbird Monitor, cluster, fbmcp | Chữ ký, chỉ bản mới hơn bản đã cài | Phiên bản trước được giữ lại; 2 bản sao mới nhất được giữ |
| Firebird | Khung thời gian, chờ sao lưu, kiểm tra sau khi khởi động | Engine cũ quay trở lại, bản dựng được đưa vào danh sách chặn |
Một phiên bản bị chặn sẽ không được cài đặt lại, nhưng phiên bản tiếp theo vẫn được cài đặt như bình thường. Nhờ vậy, máy chủ không lặp lại vòng "cập nhật → khôi phục → cập nhật".
Thư mục · nhật ký · gỡ cài đặt
Các tệp nằm ở đâu và cách gỡ cài đặt
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, cấu hình, CSDL bảo mật fbagent-fb50\ agent và HQbird Monitor agent_config.json cấu hình agent logs\ bak\ update\ nhật ký, bản sao, bộ nhớ đệm cập nhật C:\HQbirdData\ dữ liệu làm việc của agent và console config\access.properties đăng nhập console C:\ProgramData\fbagent\ kết quả và nhật ký cài đặt
Linux
/opt/firebird/ Firebird 5.0 (dòng thứ hai: /opt/fb50) /opt/hqbird/ conf/access.properties đăng nhập console, 0600 fbagent-fb50/ agent và HQ Monitor agent_config.json cấu hình agent logs/ bak/ update/ nhật ký, bản sao, bộ nhớ đệm cập nhật /var/lib/hqmonitor/ dữ liệu console /var/log/fbagent/install.log nhật ký cài đặt, không có mật khẩu
- Gỡ cài đặt không động đến cơ sở dữ liệu của bạnCơ sở dữ liệu và bản sao lưu của bạn (
*.fdb,*.gdb,*.fbk,*.nbk) luôn được giữ lại. Việc xóa dữ liệu chỉ xóa CSDL bảo mật và các mẫu từ gói Firebird. - Windows"Apps": gỡ bỏ agent, console, RCM của agent này, các quy tắc tường lửa và Firebird mà trình cài đặt này đã cài mới. Nếu các agent khác sử dụng RCM của agent này, trình hướng dẫn sẽ hỏi "Vẫn xóa phiên bản này chứ?"; gỡ cài đặt im lặng cần
/FORCE. Firebird đã được cập nhật sẽ được giữ lại. Cấu hình và CSDL bảo mật chỉ bị xóa nếu bạn chọn "xóa dữ liệu".
- Linux
--uninstallgỡ bỏ các dịch vụ agent và console, RCM của agent này, các quy tắc sudoers và các cổng mà trình cài đặt đã mở trong firewalld hoặc ufw. Agent trước tiên rời khỏi cluster. Nếu các agent khác sử dụng RCM của nó, bạn cần công tắc--force. Firebird được giữ lại.--remove-datacũng xóa cấu hình, nhật ký và dữ liệu console. - HQbird cũGỡ cài đặt HQbird 2027 không bật lại các dịch vụ cũ: quản trị viên quyết định điều này bằng tệp trạng thái.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2