このページは機械翻訳されています。英語の原文をお読みください。 English

このガイドは、サーバーから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. 開始する前に

  1. すべてのデータベースのバックアップを作成し(gbakまたはnbackup)、別のディスクまたはサーバーにコピーします。削除によってデータベースファイルは削除されませんが、バックアップは誤操作からあなたを守ります。
  2. データベースを使用しているアプリケーションを停止します。Windowsでは、削除によってセットアップがインストールしたFirebirdが停止します。
  3. クラスターサーバー: このサーバーがクラスターコンソールRCMを実行している場合は、まずRCMでクラスターを削除し、そのエージェントのリンクを解除してください(セクション4)。
  4. HQCenter: 削除によってHQCenterのサーバーレコードは削除されません。HQbirdを再度インストールする予定がない場合は、削除後にHQCenterでエージェントを削除してください。
  5. ライセンス: データとともに削除すると、エージェントのライセンス状態が削除されます。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. ライン全体を削除する

  1. 設定 → アプリ → アプリと機能(またはプログラムと機能)を開きます。
  2. **HQbird 2027 (Firebird 5.0)**を選択し、アンインストールをクリックします。
  3. 削除を確認します。
  4. データに関する質問に答えます。いいえは設定とセキュリティデータベースを保持し、はいはそれらも削除します。
  5. HQbirdが削除されたというメッセージを待ちます。

サーバー上の各Firebirdライン(ラインごとに1エントリ)について、これらの手順を繰り返します。

3.2. 1つのインスタンスを削除する

ラインに複数のインスタンスがあり、1つだけを削除する場合に使用します。

  1. スタート → HQbird 2027 (Firebird 5.0) maintenanceを開きます。
  2. Remove an instanceを選択し、インスタンスを選択します。
  3. 確認し、データに関する質問に答えます。

最後のインスタンスを削除すると、このラインのHQbird 2027が削除されます。

3.3. サイレント削除

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

アンインストーラーのフォルダは<HQbird folder>\setup\fb50です。2027.2.8より前のセットアップでインストールされたラインでは、 C:\Program Files\IBSurgeon\HQbird 2027\fb50にあります。正確なフォルダは、 アプリエントリのInstallLocation値です:

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

3.4. 結果を確認する

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

期待される結果:このラインの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を使用している場合、 削除は拒否され、何も変更されません。

推奨される順序:

  1. RCMコンソールでクラスターを削除し、そのエージェントのリンクを解除します。
  2. メンバーサーバーからHQbirdを削除します。
  3. 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を削除する

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

このコマンドは、ユニットhqbirdfbagent-fb50とhqbirdmonitor-fb50、プログラムfbagentとhqmonitor、 およびエージェントのsudoersルールを停止して削除します。インストール時にfirewalldまたはufwで 開かれたHQbird Monitorポートを閉じます。

5.2. 1つのホスト上の複数のインスタンス

--agent-dirを指定しない場合、インストーラーは/opt/hqbird内の唯一のエージェントを削除します。 複数のエージェントがある場合は終了コード1で停止し、それらのフォルダを一覧表示します。フォルダを指定してください:

Command
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 の例:

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

警告: rm -rf はフォルダ内のすべてを削除します。その中にあるデータベースやセキュリティデータベースも含まれます。まずフォルダを確認してください。

5.4. 結果を確認する

Command
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 ファイルが失われた 同じ行のインストーラを再度ダウンロードしてください。同じ行のより新しいバージョンでも動作します