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

Hướng dẫn này dành cho quản trị viên 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

  1. Sao lưu mọi cơ sở dữ liệu (gbak hoặc nbackup) 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.
  2. 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.
  3. 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).
  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.
  5. 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

  1. 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).
  2. Chọn HQbird 2027 (Firebird 5.0) và nhấp Gỡ cài đặt.
  3. Xác nhận việc gỡ cài đặt.
  4. 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.
  5. 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.

  1. Mở Start → Bảo trì HQbird 2027 (Firebird 5.0).
  2. Chọn Xóa một instance và chọn instance.
  3. 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

Command
# 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 /FORCE

Thư 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:

Command
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString

3.4. Kiểm tra kết quả

Command
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinue

Kế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ị:

  1. 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ó.
  2. Gỡ cài đặt HQbird khỏi các máy chủ thành viên.
  3. 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

Command
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall
Command
# 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-data

Lệ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:

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

Chạ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:

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

Cả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ả

Command
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/null

Kế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