HQbird 2027 の削除
このガイドは、サーバーからHQbird 2027を削除する管理者向けです。
Windowsセットアップhqbird2027-fbNN-setup-<version>.exeと
Linuxインストーラーhqbird2027-fbNN-linux-<version>.runを扱います。
例ではFirebird 5.0(fb50)を使用しています。Firebird 2.5、3.0、4.0の場合は、
ファイル名、フォルダ名、サービス名でfb25、fb30、fb40を使用してください。
インストールについては、
Windows installationと
Linux setupで説明しています。
HQbird 2024は以前の手順で削除します。
1. 開始する前に
- すべてのデータベースのバックアップを作成し(
gbakまたはnbackup)、別のディスクまたはサーバーにコピーします。削除によってデータベースファイルは削除されませんが、バックアップは誤操作からあなたを守ります。 - データベースを使用しているアプリケーションを停止します。Windowsでは、削除によってセットアップがインストールしたFirebirdが停止します。
- クラスターサーバー: このサーバーがクラスターコンソールRCMを実行している場合は、まずRCMでクラスターを削除し、そのエージェントのリンクを解除してください(セクション4)。
- HQCenter: 削除によってHQCenterのサーバーレコードは削除されません。HQbirdを再度インストールする予定がない場合は、削除後にHQCenterでエージェントを削除してください。
- ライセンス: データとともに削除すると、エージェントのライセンス状態が削除されます。HQbirdを再度インストールする予定がある場合は、ライセンスファイルを保管してください。
2. 削除されるものと残るもの
| 項目 | Windows | Linux |
|---|---|---|
| HQbirdエージェント(サービスまたはユニット、プログラム) | 削除される | 削除される |
| HQbird Monitor(サービスまたはユニット、ファイアウォールルール) | 削除される | 削除される |
| HQbird 2027が新規にインストールしたFirebird | 削除される(サービス、プログラムファイル、ファイアウォールルール) | 残る |
| 以前から存在し、更新のみされたFirebird | 残る | 残る |
データベースファイル(*.fdb、*.gdb、*.fbk、*.nbk) |
常に残る | 常に残る |
| エージェント設定、ログ、ライセンス状態、HQbird Monitorデータ | 残る。データオプションで削除される | 残る。--remove-dataで削除される |
Firebirdのセキュリティデータベースと*.confファイル |
残る。データオプションで削除される | 残る |
| 更新によって停止された古いHQbird(2024以前)のサービス | 停止したまま | 停止したまま |
Windowsのデータオプションは、HQbird 2027のセットアップが作成したもののみを削除します。 最初のHQbird 2027セットアップ以前から存在していたエージェントのデータは残ります。
3. Windows
アプリと機能の1つのエントリ = 1つのFirebirdラインです。ラインのアンインストーラーは、そのラインのすべてのインスタンスを削除します。管理者として実行してください。
3.1. ライン全体を削除する
- 設定 → アプリ → アプリと機能(またはプログラムと機能)を開きます。
- **HQbird 2027 (Firebird 5.0)**を選択し、アンインストールをクリックします。
- 削除を確認します。
- データに関する質問に答えます。いいえは設定とセキュリティデータベースを保持し、はいはそれらも削除します。
- HQbirdが削除されたというメッセージを待ちます。
サーバー上の各Firebirdライン(ラインごとに1エントリ)について、これらの手順を繰り返します。
3.2. 1つのインスタンスを削除する
ラインに複数のインスタンスがあり、1つだけを削除する場合に使用します。
- スタート → HQbird 2027 (Firebird 5.0) maintenanceを開きます。
- Remove an instanceを選択し、インスタンスを選択します。
- 確認し、データに関する質問に答えます。
最後のインスタンスを削除すると、このラインのHQbird 2027が削除されます。
3.3. サイレント削除
# 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アンインストーラーのフォルダは<HQbird folder>\setup\fb50です。2027.2.8より前のセットアップでインストールされたラインでは、
C:\Program Files\IBSurgeon\HQbird 2027\fb50にあります。正確なフォルダは、
アプリエントリのInstallLocation値です:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. 結果を確認する
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期待される結果:このラインのHQbirdサービスが存在せず、レジストリキーに対してFalseが返ります。
アンインストーラーは完全な削除の後にのみレジストリキーを削除します。キーがまだ存在する場合は、
アンインストーラーを再度実行してください。
3.5. ディスクに残るもの
| フォルダ | 内容 | 手動で削除するか? |
|---|---|---|
C:\HQbird\Firebird50\ |
データベースファイル、およびデータオプションなしの場合はセキュリティデータベースと*.conf |
データベースを移動した後 |
C:\HQbird\fbagent-fb50\ |
データを保持した場合のエージェント設定とログ | 不要であれば削除可 |
C:\HQbirdData\ |
データを保持した場合のエージェント作業データ、HQbird Monitorデータ、サインインファイル | 不要であれば削除可 |
C:\HQbird\hqbirdrcm\ |
RCMデータ(データオプションでのみ削除される) | クラスターがなくなった後 |
C:\ProgramData\fbagent\ |
install.log、最後のセットアップ実行の結果 |
削除可 |
C:\ProgramData\HQbird\fbagent\ |
サイレントインストールのSYSDBAパスワードファイル | 削除可 |
<Firebird folder>.old_<time> |
更新による古いFirebirdプログラムフォルダのコピー | 更新が確認されたら削除可 |
fbmcpサービスはサーバーのすべてのラインで共有されます。別のラインが使用している間は残り、 最後のラインとともに削除されます。
4. クラスター内のサーバー
RCMを実行するエージェントはクラスターCAを保持しています。他のエージェントがそのRCMを使用している場合、 削除は拒否され、何も変更されません。
推奨される順序:
- RCMコンソールでクラスターを削除し、そのエージェントのリンクを解除します。
- メンバーサーバーからHQbirdを削除します。
- RCMを実行するサーバーからHQbirdを削除します。
それでもRCM所有者を削除するには:
- Windows、ダイアログ: アンインストーラーが「Remove this instance anyway? The cluster loses its RCM CA.」と尋ねます。はいと答えてください。
- Windows、サイレント:
/FORCEを追加します。これがない場合、RCMを実行する インスタンスは残り、ログに理由が記録されます。 - Linux: インストーラーは終了コード5で停止します。
--forceを付けて再度実行してください。
強制削除後、クラスターにはCAがありません。新しい証明書も新しいメンバーも作成できません。
別のエージェントを新しいRCMの所有者にするには、そこで
fbagent --cluster-init <id> --rcm-takeoverを実行し、メンバーを再度リンクしてください。
5. Linux
HQbirdをインストールしたのと同じ.runファイル(または同じラインの新しいもの)をrootとして実行します。例ではバージョン2027.2.33を使用しています。
5.1. エージェントと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-dataこのコマンドは、ユニットhqbirdfbagent-fb50とhqbirdmonitor-fb50、プログラムfbagentとhqmonitor、
およびエージェントのsudoersルールを停止して削除します。インストール時にfirewalldまたはufwで
開かれたHQbird Monitorポートを閉じます。
5.2. 1つのホスト上の複数のインスタンス
--agent-dirを指定しない場合、インストーラーは/opt/hqbird内の唯一のエージェントを削除します。
複数のエージェントがある場合は終了コード1で停止し、それらのフォルダを一覧表示します。フォルダを指定してください:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2各エージェントに対して一度ずつコマンドを実行します。共有のHQbird Monitorサインインファイルは、 最後のエージェントが削除されるまで残ります。
5.3. Firebirdを削除する(オプション、手動)
インストーラーはLinux上のFirebirdを決して削除しません。バックアップを作成し、データベースをFirebirdフォルダから移動した後にのみ、手動で行ってください。
Firebirdのユニット名:
| Firebird フォルダ | 行 | ユニット |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
別のフォルダ、例えば /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
別のフォルダ、例えば /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
/opt/fb50-2 にある Firebird の例:
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警告: rm -rf はフォルダ内のすべてを削除します。その中にあるデータベースやセキュリティデータベースも含まれます。まずフォルダを確認してください。
5.4. 結果を確認する
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/null期待される結果: hqbirdfbagent-fb50 と hqbirdmonitor-fb50 のユニットが存在しないこと。手動で Firebird を削除していない限り、Firebird のユニットはまだ存在します。
5.5. ディスクに残るもの
| パス | 内容 | 手動で削除するか? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
エージェントの設定とログ (--remove-data なしの場合) |
不要であれば削除してください |
/var/lib/hqmonitor/ |
HQbird Monitor のデータ (--remove-data なしの場合) |
不要であれば削除してください |
/opt/hqbirdrcm/ |
RCM。ホストの他のエージェントが使用している間 | クラスタがなくなった後 |
/opt/fbagent-update-backup/ |
更新によって置き換えられた Firebird のプログラムファイル | 更新が確認されたら削除してください |
/opt/hqbird/fbagent-hqbird-takeover.json |
更新前の古い HQbird ユニットの状態 | 古い HQbird に戻す予定がある場合は保持してください |
/opt/firebird (またはお使いの Firebird フォルダ) |
Firebird とそのデータベース | セクション 5.3 |
5.6. --uninstall の終了コード
| コード | 意味 | 対処方法 |
|---|---|---|
| 0 | 削除済み | — |
| 1 | 拒否: ホスト上に複数のエージェントがある、またはオプションが誤っている | 一覧のフォルダを指定して --agent-dir を追加してください |
| 5 | 拒否: このエージェントがホストの RCM を実行しており、他のエージェントがそれを使用している | セクション 4 |
6. 削除後の古い HQbird
HQbird 2027 が古い HQbird (2024 以前) を置き換えたとき、更新によって古い HQbird のサービスは停止されました。HQbird 2027 を削除しても、それらは再び有効化されません。更新前の状態は以下に保存されています:
- Windows:
<HQbird folder>\fbagent-hqbird-takeover.json - Linux:
/opt/hqbird/fbagent-hqbird-takeover.json
このファイルを使用して、どのサービスがアクティブだったかを確認し、古い HQbird に戻す場合は手動で起動してください。
7. トラブルシューティング
| 問題 | 対処方法 |
|---|---|
| Windows: 削除後も アプリと機能 のエントリが残る | インスタンスが削除されていません (多くの場合、RCM を実行しているもの)。アンインストーラを再度実行してください。RCM の所有者についてはセクション 4 を参照してください |
| Windows: 一般的なエラーと古いアンインストーラからのコマンド | エージェントが 3.1.0 以降に自己更新され、RCM の所有者の削除を拒否しています。表示されたコマンドに --force を追加するか、より新しいセットアップのアンインストーラを実行してください |
| Windows: テストビルド 2027.0.1 および 2027.0.2 | すべての行に 1 つのエントリを使用していました。それぞれ独自のアンインストーラで削除してください |
Linux: --uninstall が拒否され、終了コード 1 |
ホスト上に複数のエージェントがあります: --agent-dir を追加してください (セクション 5.2) |
Linux: --uninstall が拒否され、終了コード 5 |
エージェントがホストの RCM を実行しています: セクション 4 |
Linux: run as root (sudo sh ...) |
インストーラを sudo または root で実行してください |
Linux: .run ファイルが失われた |
同じ行のインストーラを再度ダウンロードしてください。同じ行のより新しいバージョンでも動作します |