서버 제거하기

Alpacon에서 더 이상 관리하지 않을 서버를 제거할 수 있습니다.

참고

이 문서는 워크스페이스를 유지하면서 개별 서버를 제거하는 방법을 설명합니다. 워크스페이스를 삭제하면 응답하는 연결된 서버에서 Alpacon이 제거됩니다. 다만 오프라인 서버나 지원되지 않는 호스트는 예외입니다. 자세한 내용은 서버에 미치는 영향을 참고하세요.

제거 절차

서버를 제거하는 방법은 두 가지입니다.

  • alpamon unregister(v2.3.0+): 호스트의 에이전트를 제거하고, 워크스페이스 레코드 삭제를 best-effort로 시도하는 작업을 한 번에 수행합니다.
  • 수동: (1) 서버에서 Alpamon 에이전트를 제거한 뒤, (2) Alpacon 워크스페이스에서 서버를 삭제합니다.

두 방법 모두 아래에서 설명합니다.

1. Alpamon 에이전트 제거

먼저 서버에서 에이전트를 제거해야 합니다.

가장 빠른 방법은 alpamon unregister입니다. 서비스를 중지·제거하고, 로컬 설정을 삭제하며, 워크스페이스 서버 레코드 삭제를 best-effort로 시도하는 작업을 한 번에 수행합니다. Websh가 아닌 서버에서 직접, alpamon v2.3.0 이상에서 실행하세요.

bash
 
# Linux / macOS
sudo alpamon unregister --yes
powershell
 
# Windows (elevated PowerShell, on the server)
& "$env:ProgramFiles\alpamon\alpamon.exe" unregister --yes

등록이 막힌 호스트를 복구하려면 alpamon register --force를 사용하세요. 재등록 및 복구를 참고하세요.

아래 OS별 단계는 에이전트와 파일을 수동으로 제거하며, v2.3.0 미만 에이전트에도 적용됩니다.

Debian 기반 시스템 (Ubuntu, Debian)

기본 제거:

bash
sudo apt remove alpamon -y && sudo rm -rf /etc/alpamon/alpamon.conf

완전 제거 (모든 파일 포함):

bash
sudo apt remove alpamon --purge -y

완전 제거 시 다음 파일들도 삭제됩니다:

  • /etc/alpamon/alpamon.conf
  • /usr/lib/tmpfiles.d/alpamon.conf
  • /lib/systemd/system/alpamon.service
  • /lib/systemd/system/alpamon-restart.service
  • /lib/systemd/system/alpamon-restart.timer
  • /var/log/alpamon/alpamon.log
  • /var/lib/alpamon/alpamon.db

Red Hat 기반 시스템 (RHEL, Rocky Linux)

기본 제거:

bash
sudo yum remove alpamon

완전 제거 (모든 파일 포함):

bash
sudo yum remove alpamon && \
sudo rm -f /etc/alpamon/alpamon.conf \
&& sudo rm -f /usr/lib/tmpfiles.d/alpamon.conf \
&& sudo rm -f /lib/systemd/system/alpamon.service \
&& sudo rm -f /lib/systemd/system/alpamon-restart.service \
&& sudo rm -f /lib/systemd/system/alpamon-restart.timer \
&& sudo rm -f /var/log/alpamon/alpamon.log \
&& sudo rm -f /var/lib/alpamon/alpamon.db

SUSE 기반 시스템 (openSUSE, SLES)

기본 제거:

bash
sudo zypper --non-interactive remove alpamon

완전 제거 (설정, 데이터, 로그 포함):

bash
sudo zypper --non-interactive remove alpamon
rpm -q alpamon >/dev/null || sudo rm -rf /etc/alpamon /var/lib/alpamon /var/log/alpamon  # only once the package is gone

macOS

launchd 서비스를 중지하고 plist를 삭제한 뒤 Homebrew 패키지를 제거하면 실행 파일도 삭제됩니다. 설정 파일은 /etc/alpamon/alpamon.conf에 있습니다. 설정과 데이터, 로그도 필요하지 않으면 함께 지우세요.

bash
sudo launchctl unload /Library/LaunchDaemons/com.alpacax.alpamon.plist
sudo rm -f /Library/LaunchDaemons/com.alpacax.alpamon.plist
brew uninstall alpamon
sudo rm -rf /etc/alpamon /var/lib/alpamon /var/log/alpamon

Windows

관리자 권한 PowerShell에서 실행합니다. 폴더를 지우기 전에 서비스를 먼저 중지·삭제하세요. 그러지 않으면 사용 중(sharing violation) 오류로 제거가 실패합니다.

powershell
sc.exe stop alpamon
sc.exe delete alpamon
Remove-Item -Recurse -Force "$env:ProgramFiles\alpamon"
Remove-Item -Recurse -Force "$env:ProgramData\alpamon"

Windows 서비스와 파일이 제거됐는지 확인하세요:

powershell
sc.exe query alpamon
Test-Path "C:\Program Files\alpamon"
Test-Path "$env:ProgramData\alpamon"

sc.exe query에서 1060이 나오면 서비스가 제거된 것입니다. 두 경로는 모두 False여야 합니다.

Windows 서버를 참고하세요.

2. 워크스페이스에서 서버 삭제

위의 수동 OS별 단계로 에이전트를 제거했다면(alpamon unregister가 아니라) 워크스페이스에 서버 레코드가 남아 있으므로 여기서 삭제합니다. alpamon unregister는 레코드 삭제를 자동으로 시도하지만, 워크스페이스에 접근하지 못하면(네트워크·토큰 문제) 서버가 목록에 남을 수 있으니 그럴 때 여기서 삭제하세요.

필수 조건:

  • 서버 상태가 연결되지 않음이어야 합니다
  • 권한: 할당된 그룹의 소유자(Owner) 또는 관리자(Manager), 서버의 maintainer, Staff 또는 Superuser 역할을 가진 사용자

삭제 방법:

  1. Servers 페이지로 이동합니다
  2. 삭제할 서버를 선택합니다(체크박스)
  3. 상단의 삭제(휴지통) 아이콘을 클릭합니다
  4. 확인 모달에서 연결 해제를 클릭합니다
  5. 서버가 목록에서 제거됩니다

일괄 삭제

여러 서버를 한 번에 삭제할 수 있습니다.

  1. 삭제할 여러 서버를 선택합니다
  2. 휴지통 아이콘을 클릭합니다
  3. 확인합니다
  4. 선택한 모든 서버가 삭제됩니다

주의사항

삭제 후 남는 정보와 사라지는 정보:

정보서버 삭제 후
서버 설정관리 대상 목록에서 서버가 사라지고 그룹 및 접근 규칙 할당이 해제됩니다. 다시 등록한다면 설정을 새로 구성해야 합니다.
모니터링 기록삭제한 서버의 모니터링 페이지를 열 수 없어 이전 차트도 그곳에서 볼 수 없습니다. 서버를 삭제한다고 저장된 메트릭이 모두 즉시 지워지는 것은 아닙니다.
명령어 실행 기록이전 명령어와 상세 정보, 출력은 권한이 있는 사용자가 해당 감사 조회 기간에 명령어 감사 기록에서 볼 수 있습니다.
접근 로그이전 Websh와 WebFTP 활동은 해당 감사 조회 기간에 기록으로 남습니다.
코멘트서버에 남긴 메모는 삭제됩니다. 필요한 내용은 서버를 제거하기 전에 저장하세요.

재등록해도 이전 서버는 복구되지 않습니다: 같은 호스트를 다시 등록하면 새로운 관리 대상 서버가 됩니다. 이전 설정, 모니터링 페이지, 메모는 돌아오지 않습니다. 남아 있는 감사 기록은 새 서버 등록에 연결되지 않습니다.

에이전트 먼저 제거:

  • 에이전트를 제거하지 않고 Alpacon에서만 삭제하면, 서버가 계속 연결을 시도해 불필요하게 리소스를 소모할 수 있습니다

재등록

제거한 서버를 다시 등록하려면 다음과 같이 진행합니다.

  1. 서버 등록하기 절차를 다시 따릅니다
  2. 새 설치 스크립트가 생성됩니다
  3. 새 서버의 설정을 다시 구성합니다. 이전 감사 기록은 새 등록에 연결되지 않습니다

문제 해결

서버가 Disconnected 상태로 변경되지 않는 경우:

  1. 서버에서 에이전트가 완전히 제거되었는지 확인합니다.
bash
systemctl status alpamon
  1. 에이전트가 여전히 실행 중이면 수동으로 중지합니다.
bash
sudo systemctl stop alpamon
sudo systemctl disable alpamon

Windows에서는 대신 PowerShell로 서비스를 확인하고 중지합니다.

powershell
sc.exe query alpamon
Stop-Service alpamon

삭제 버튼이 비활성화된 경우:

  • 서버 상태를 확인하세요(Connected 상태에서는 삭제할 수 없습니다)
  • 이 서버를 관리할 수 있는지 확인하세요(서버의 maintainer, 할당된 그룹의 소유자·관리자, Staff·Superuser)

관련 문서

최종 수정: