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

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ầnChức năngWindowsLinux
Firebird, bản dựng HQbirdMá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 fbagentSao lưu, giám sát, bảo trì, cập nhật.HQbirdFBAgent-fb50hqbirdfbagent-fb50, người dùng firebird
HQbird MonitorConsole 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-fb50hqbirdmonitor-fb50
Thành phần clusterCá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 fbmcpTruy 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 FirebirdKý 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.

Trên máy chủ

        


          


          

  1. 1Kiểm tra máy chủquyền, độ bit; trên Linux cả systemd và kernel
  2. 2Kiểm tra bộ càisha256 trước khi giải nén; chữ ký tệp trước khi cài đặt
  3. 3Kế hoạchnhững gì tìm thấy và những gì sẽ làm
  4. 4Câu hỏitên máy chủ cho HQCenter; dừng Firebird? phiên bản khác?
  5. 5Cài đặtFirebird, agent, console, dịch vụ
  6. 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)
0Hoàn tất
1Từ chối: máy chủ, công tắc hoặc kế hoạch. Không thay đổi gì
2Cài đặt thất bại, thay đổi đã khôi phục
3Khôi phục chưa hoàn tất: kết quả nêu những gì cần kiểm tra
4Cần câu trả lời: không có terminal và không có --yes
5Bộ cài không qua kiểm tra: tải lại
6Không có thư viện OS và không có kho
7Firebird từ các gói phân phối
MãÝ nghĩa (Windows setup.exe)
0Đã cài đặt
1Từ 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
4Bộ cài có câu hỏi, nhưng không có công tắc /YES
7Kiể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
Kế hoạch trong wizard. "Found on this computer" và "Setup will do the following". Ở dưới cùng: không thay đổi gì cho đến khi bạn nhấp Cài đặt.
Kết quả. Những gì đã cài, địa chỉ console từ máy tính này và từ máy khác, nơi có mật khẩu đăng nhập. Lấy từ một bản dựng đầu: ở đó, tên dịch vụ agent và thư mục dùng cổng (-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.

Chuyển từ HQbird 2024: các tác vụ FBDataGuard chuyển sang agent của HQbird 2027, Firebird được cập nhật tại chỗ, các dịch vụ HQbird cũ bị vô hiệu hóa
  • Những gì không thay đổidatabases.conf hoặc aliases.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ũ. Trong firebird.conf, chỉ dòng MonitoringPlugin = 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.

Thêm
  • 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ố -2 trong 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.
Hai phiên bản của cùng một dòng. Kế hoạch nhìn thấy cả hai máy chủ Firebird và cả hai agent và chỉ thay đổi phiên bản được chọn.

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.

ImageFirebirdCổng FirebirdHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Khởi động lần đầuSao chép compose.yaml từ 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òng secrets: và chạy docker compose up -d. Máy chủ sẵn sàng khi docker compose ps hiể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ải 3051: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ật

Agent · 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. agent là mặc định. all cũng cài đặt Firebird, trong cửa sổ cập nhật. off khô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

Tự cập nhật của agent: kiểm tra, điểm khôi phục, thay thế, sẵn sàng trong 180 giây, chạy trong 45 giây; khi thất bại: khôi phục, tạm dừng 30 phút, phiên bản bị chặn sau lần thất bại thứ 2
  • 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.

  1. 1Chuẩn bịtải xuống, chữ ký, bản dựng không cũ hơn engine
  2. 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
  3. 3Tác vụgbak, nbackup hoặc một script SQL đang chạy: lần thử bị hoãn lại
  4. 4Thay thếcác tệp engine cũ được đặt sang một bên, cấu hình được giữ nguyên
  5. 5Kiểm traFirebird khởi động và phản hồi trên cổng của nó
  6. 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ậtBảo vệNếu thất bại
agent fbagentChữ ký, chỉ bản mới hơn, sẵn sàng trong 180 giây và chạy trong 45 giâyKhô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, fbmcpChữ ký, chỉ bản mới hơn bản đã càiPhiên bản trước được giữ lại; 2 bản sao mới nhất được giữ
FirebirdKhung thời gian, chờ sao lưu, kiểm tra sau khi khởi độngEngine 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--uninstall gỡ 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-data cũ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.
Linux, gỡ cài đặt một phiên bản (Firebird và cơ sở dữ liệu được giữ lại):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Quay lại tổng quan HQbird 2027 · Tình trạng máy chủ →