이 페이지는 기계 번역되었습니다. 영어 원본을 읽어보세요. 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 설치 및 Linux 설치에 설명되어 있습니다.

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

앱 및 기능의 항목 하나 = Firebird 라인 하나. 각 라인의 제거 프로그램은 해당 라인의 모든 인스턴스를 제거합니다. 관리자 권한으로 실행하십시오.

3.1. 라인 전체 제거

  1. 설정 → 앱 → 앱 및 기능(또는 프로그램 및 기능)을 여십시오.
  2. **HQbird 2027 (Firebird 5.0)**을 선택하고 제거를 클릭하십시오.
  3. 제거를 확인하십시오.
  4. 데이터에 관한 질문에 답하십시오. 아니요는 구성과 보안 데이터베이스를 유지하고, 예는 그것들도 제거합니다.
  5. HQbird가 제거되었다는 메시지를 기다리십시오.

서버의 모든 Firebird 라인에 대해 이 단계를 반복하십시오(라인당 항목 하나).

3.2. 인스턴스 하나 제거

라인에 여러 인스턴스가 있고 그중 하나만 제거할 때 사용하십시오.

  1. 시작 → HQbird 2027 (Firebird 5.0) 유지 관리를 여십시오.
  2. 인스턴스 제거를 선택하고 인스턴스를 선택하십시오.
  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, 대화 상자: 제거 프로그램이 “이 인스턴스를 그래도 제거하시겠습니까? 클러스터가 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. 한 호스트의 여러 인스턴스

--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 모든 라인에 하나의 항목을 사용했습니다. 자체 제거 프로그램으로 제거하십시오
Linux: --uninstall 거부됨, 종료 코드 1 호스트에 여러 에이전트: --agent-dir 추가 (섹션 5.2)
Linux: --uninstall 거부됨, 종료 코드 5 에이전트가 호스트의 RCM을 실행 중: 섹션 4
Linux: run as root (sudo sh ...) 설치 프로그램을 sudo로 또는 root로 실행하십시오
Linux: .run 파일이 손실됨 같은 라인의 설치 프로그램을 다시 다운로드하십시오. 같은 라인의 더 새로운 버전도 작동합니다