HQbird 2027 removal
Hướng dẫn này dành cho quản trị viên gỡ cài đặt HQbird 2027 khỏi máy chủ.
Nó bao gồm bộ cài Windows hqbird2027-fbNN-setup-<version>.exe và
bộ cài Linux hqbird2027-fbNN-linux-<version>.run.
Các ví dụ sử dụng Firebird 5.0 (fb50). Đối với Firebird 2.5, 3.0 và 4.0, hãy dùng
fb25, fb30, fb40 trong tên tệp, thư mục và dịch vụ. Việc
cài đặt được mô tả trong
Cài đặt trên Windows và
Thiết lập Linux.
HQbird 2024 được gỡ cài đặt theo hướng dẫn trước.
1. Trước khi bắt đầu
- Sao lưu mọi cơ sở dữ liệu (
gbakhoặcnbackup) và sao chép sang ổ đĩa hoặc máy chủ khác. Việc gỡ cài đặt không xóa các tệp cơ sở dữ liệu, nhưng bản sao lưu sẽ bảo vệ bạn khỏi sai sót. - Dừng các ứng dụng đang sử dụng cơ sở dữ liệu. Trên Windows, việc gỡ cài đặt sẽ dừng Firebird mà bộ cài đã cài đặt.
- Máy chủ cụm: nếu máy chủ này chạy bảng điều khiển cụm RCM, hãy xóa cụm trong RCM và hủy liên kết các agent của nó trước (mục 4).
- HQCenter: việc gỡ cài đặt không xóa bản ghi máy chủ trong HQCenter của bạn. Hãy xóa agent ở đó sau khi gỡ cài đặt, nếu bạn không có kế hoạch cài đặt lại HQbird.
- Giấy phép: việc gỡ cài đặt kèm dữ liệu sẽ xóa trạng thái giấy phép của agent. Hãy giữ tệp giấy phép nếu bạn có kế hoạch cài đặt lại HQbird.
2. Những gì bị xóa và những gì được giữ lại
| Mục | Windows | Linux |
|---|---|---|
| Agent HQbird (dịch vụ hoặc unit, chương trình) | bị xóa | bị xóa |
| HQbird Monitor (dịch vụ hoặc unit, quy tắc tường lửa) | bị xóa | bị xóa |
| Firebird mà HQbird 2027 đã cài mới | bị xóa (dịch vụ, tệp chương trình, quy tắc tường lửa) | được giữ lại |
| Firebird đã tồn tại trước đó và chỉ được cập nhật | được giữ lại | được giữ lại |
Tệp cơ sở dữ liệu (*.fdb, *.gdb, *.fbk, *.nbk) |
luôn được giữ lại | luôn được giữ lại |
| Cấu hình agent, nhật ký, trạng thái giấy phép, dữ liệu HQbird Monitor | được giữ lại; bị xóa với tùy chọn dữ liệu | được giữ lại; bị xóa với --remove-data |
Cơ sở dữ liệu bảo mật và các tệp *.conf của Firebird |
được giữ lại; bị xóa với tùy chọn dữ liệu | được giữ lại |
| Dịch vụ của HQbird cũ hơn (2024 và trước đó) mà bản cập nhật đã tắt | vẫn tắt | vẫn tắt |
Tùy chọn dữ liệu trên Windows chỉ xóa những gì bộ cài HQbird 2027 đã tạo. Dữ liệu của một agent đã tồn tại trước lần cài đặt HQbird 2027 đầu tiên sẽ được giữ lại.
3. Windows
Một mục trong Ứng dụng & tính năng = một dòng Firebird. Trình gỡ cài đặt của một dòng sẽ xóa tất cả các instance của dòng đó. Hãy chạy nó với quyền quản trị viên.
3.1. Xóa toàn bộ một dòng
- Mở Cài đặt → Ứng dụng → Ứng dụng & tính năng (hoặc Chương trình và Tính năng).
- Chọn HQbird 2027 (Firebird 5.0) và nhấp Gỡ cài đặt.
- Xác nhận việc gỡ cài đặt.
- Trả lời câu hỏi về dữ liệu: Không sẽ giữ lại cấu hình và cơ sở dữ liệu bảo mật, Có sẽ xóa chúng luôn.
- Chờ thông báo rằng HQbird đã được gỡ cài đặt.
Lặp lại các bước này cho mọi dòng Firebird trên máy chủ (một mục cho mỗi dòng).
3.2. Xóa một instance
Sử dụng cách này khi một dòng có nhiều instance và bạn chỉ xóa một instance.
- Mở Start → Bảo trì HQbird 2027 (Firebird 5.0).
- Chọn Xóa một instance và chọn instance.
- Xác nhận, sau đó trả lời câu hỏi về dữ liệu.
Khi bạn xóa instance cuối cùng, HQbird 2027 của dòng này sẽ được gỡ cài đặt.
3.3. Gỡ cài đặt im lặng
# programs and services; databases, configs and the security database stay
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT
# the same, and the agent data, HQbird Monitor data, the security database and *.conf too
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /REMOVEDATA
# remove also an instance that runs the RCM of a cluster (section 4)
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /FORCEThư mục trình gỡ cài đặt là <HQbird folder>\setup\fb50. Các dòng được cài đặt bởi
các bộ cài trước 2027.2.8 có nó trong
C:\Program Files\IBSurgeon\HQbird 2027\fb50. Thư mục chính xác là
giá trị InstallLocation của mục trong Ứng dụng:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Kiểm tra kết quả
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueKết quả mong đợi: không có dịch vụ HQbird nào của dòng này, và False cho khóa registry.
Trình gỡ cài đặt chỉ xóa khóa registry sau khi gỡ cài đặt hoàn toàn. Nếu
khóa vẫn còn, hãy chạy lại trình gỡ cài đặt.
3.5. Những gì còn lại trên đĩa
| Thư mục | Nội dung | Xóa thủ công? |
|---|---|---|
C:\HQbird\Firebird50\ |
Tệp cơ sở dữ liệu, và nếu không có tùy chọn dữ liệu thì cả cơ sở dữ liệu bảo mật và *.conf |
Sau khi bạn đã di chuyển các cơ sở dữ liệu |
C:\HQbird\fbagent-fb50\ |
Cấu hình và nhật ký agent, khi bạn giữ lại dữ liệu | Có, nếu bạn không cần chúng |
C:\HQbirdData\ |
Dữ liệu làm việc của agent, dữ liệu HQbird Monitor và tệp đăng nhập, khi bạn giữ lại dữ liệu | Có, nếu bạn không cần chúng |
C:\HQbird\hqbirdrcm\ |
Dữ liệu RCM (chỉ bị xóa với tùy chọn dữ liệu) | Có, sau khi cụm đã được xóa |
C:\ProgramData\fbagent\ |
install.log, kết quả của lần chạy bộ cài gần nhất |
Có |
C:\ProgramData\HQbird\fbagent\ |
Tệp mật khẩu SYSDBA của bản cài đặt im lặng | Có |
<Firebird folder>.old_<time> |
Bản sao thư mục chương trình Firebird cũ từ một lần cập nhật | Có, khi bản cập nhật đã được xác nhận |
Dịch vụ fbmcp được dùng chung bởi tất cả các dòng trên máy chủ. Nó vẫn tồn tại khi một dòng khác còn sử dụng, và nó bị xóa cùng với dòng cuối cùng.
4. Máy chủ trong một cụm
Agent chạy RCM giữ CA của cụm. Khi các agent khác sử dụng RCM đó, việc gỡ cài đặt sẽ bị từ chối và không có gì bị thay đổi.
Thứ tự khuyến nghị:
- Xóa cụm trong bảng điều khiển RCM và hủy liên kết các agent của nó.
- Gỡ cài đặt HQbird khỏi các máy chủ thành viên.
- Gỡ cài đặt HQbird khỏi máy chủ chạy RCM.
Để vẫn xóa chủ sở hữu RCM:
- Windows, hộp thoại: trình gỡ cài đặt hỏi “Vẫn xóa instance này? Cụm sẽ mất CA của RCM.” Trả lời Có.
- Windows, im lặng: thêm
/FORCE. Nếu không có nó, instance chạy RCM sẽ được giữ lại, và nhật ký sẽ ghi rõ lý do. - Linux: bộ cài sẽ dừng với mã thoát 5. Chạy lại với
--force.
Sau khi gỡ cài đặt cưỡng bức, cụm không còn CA: không có chứng chỉ mới và không có
thành viên mới. Để biến một agent khác thành chủ sở hữu của một RCM mới, hãy chạy
fbagent --cluster-init <id> --rcm-takeover tại đó và liên kết lại các thành viên.
5. Linux
Chạy cùng tệp .run đã cài đặt HQbird (hoặc một tệp mới hơn cùng
dòng) với quyền root. Các ví dụ sử dụng phiên bản 2027.2.33.
5.1. Xóa agent và HQbird Monitor
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall# the same, and the agent folder (configuration, logs, license state) and HQbird Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --remove-dataLệnh này dừng và xóa các unit hqbirdfbagent-fb50 và
hqbirdmonitor-fb50, các chương trình fbagent và hqmonitor, và
các quy tắc sudoers của agent. Nó đóng cổng HQbird Monitor mà
bộ cài đã mở trong firewalld hoặc ufw.
5.2. Nhiều instance trên một máy chủ
Nếu không có --agent-dir, bộ cài sẽ xóa agent duy nhất trong
/opt/hqbird. Với nhiều agent, nó sẽ dừng với mã thoát 1 và liệt kê
các thư mục của chúng. Hãy chỉ định thư mục:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Chạy lệnh một lần cho mỗi agent. Tệp đăng nhập HQbird Monitor dùng chung sẽ tồn tại cho đến khi agent cuối cùng bị xóa.
5.3. Xóa Firebird (tùy chọn, thủ công)
Bộ cài không bao giờ xóa Firebird trên Linux. Chỉ làm việc này thủ công sau khi bạn đã sao lưu và di chuyển các cơ sở dữ liệu ra khỏi thư mục Firebird.
Tên unit của Firebird:
| Thư mục Firebird | Dòng | Unit |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
thư mục khác, ví dụ /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
thư mục khác, ví dụ /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
Ví dụ cho 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 $BCảnh báo: rm -rf xóa mọi thứ trong thư mục, kể cả các cơ sở dữ liệu
và cơ sở dữ liệu bảo mật nằm bên trong. Hãy kiểm tra thư mục trước.
5.4. Kiểm tra kết quả
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullKết quả mong đợi: không có unit hqbirdfbagent-fb50 và hqbirdmonitor-fb50. Unit
Firebird vẫn còn trừ khi bạn đã xóa Firebird thủ công.
5.5. Những gì còn lại trên đĩa
| Đường dẫn | Nội dung | Xóa thủ công? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
Cấu hình và nhật ký agent (không có --remove-data) |
Có, nếu bạn không cần chúng |
/var/lib/hqmonitor/ |
Dữ liệu HQbird Monitor (không có --remove-data) |
Có, nếu bạn không cần chúng |
/opt/hqbirdrcm/ |
RCM, khi các agent khác của máy chủ còn sử dụng | Sau khi cụm đã được xóa |
/opt/fbagent-update-backup/ |
Tệp chương trình Firebird mà các bản cập nhật đã thay thế | Có, khi các bản cập nhật đã được xác nhận |
/opt/hqbird/fbagent-hqbird-takeover.json |
Trạng thái của các unit HQbird cũ trước bản cập nhật | Giữ lại nếu bạn có kế hoạch quay lại HQbird cũ |
/opt/firebird (hoặc thư mục Firebird của bạn) |
Firebird và các cơ sở dữ liệu của nó | Mục 5.3 |
5.6. Mã thoát của --uninstall
| Mã | Ý nghĩa | Việc cần làm |
|---|---|---|
| 0 | Đã xóa | — |
| 1 | Bị từ chối: có nhiều agent trên máy chủ, hoặc tùy chọn sai | Thêm --agent-dir với một thư mục từ danh sách |
| 5 | Bị từ chối: agent này chạy RCM của máy chủ và các agent khác đang sử dụng nó | Mục 4 |
6. HQbird cũ hơn sau khi gỡ cài đặt
Khi HQbird 2027 thay thế một HQbird cũ hơn (2024 và trước đó), bản cập nhật đã tắt các dịch vụ HQbird cũ. Việc gỡ cài đặt HQbird 2027 không bật lại chúng. Trạng thái của chúng trước bản cập nhật được lưu trong:
- Windows:
<HQbird folder>\fbagent-hqbird-takeover.json - Linux:
/opt/hqbird/fbagent-hqbird-takeover.json
Sử dụng tệp này để xem những dịch vụ nào đã hoạt động, và khởi động chúng thủ công nếu bạn quay lại HQbird cũ.
7. Khắc phục sự cố
| Vấn đề | Việc cần làm |
|---|---|
| Windows: mục trong Ứng dụng & tính năng vẫn còn sau khi gỡ cài đặt | Một instance chưa được xóa (thường là instance chạy RCM). Chạy lại trình gỡ cài đặt; đối với chủ sở hữu RCM, xem mục 4 |
| Windows: lỗi chung và một lệnh từ trình gỡ cài đặt cũ | Agent đã tự cập nhật lên 3.1.0 hoặc mới hơn và từ chối xóa chủ sở hữu RCM. Thêm --force vào lệnh được hiển thị, hoặc chạy trình gỡ cài đặt của bộ cài mới hơn |
| Windows: bản dựng thử nghiệm 2027.0.1 và 2027.0.2 | Chúng dùng một mục cho tất cả các dòng. Hãy gỡ chúng bằng trình gỡ cài đặt riêng của chúng |
Linux: --uninstall bị từ chối, mã thoát 1 |
Có nhiều agent trên máy chủ: thêm --agent-dir (mục 5.2) |
Linux: --uninstall bị từ chối, mã thoát 5 |
Agent chạy RCM của máy chủ: mục 4 |
Linux: run as root (sudo sh ...) |
Chạy bộ cài với sudo hoặc với quyền root |
Linux: tệp .run bị mất |
Tải lại bộ cài của cùng dòng; một phiên bản mới hơn của cùng dòng cũng dùng được |