서버 제거하기

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

제거 절차

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

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

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

1. Alpamon 에이전트 제거

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

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

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

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

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

Debian 기반 시스템 (Ubuntu, Debian)

기본 제거:

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

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

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, CentOS, Rocky Linux)

기본 제거:

sudo yum remove alpamon

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

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

Windows

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

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

전체 제거 및 복구 세부 사항은 Windows 서버를 참고하세요.

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

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

필수 조건:

  • 서버 상태가 Disconnected여야 합니다
  • Superuser 권한이 필요합니다

삭제 방법:

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

일괄 삭제

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

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

주의사항

데이터 손실:

  • 서버를 삭제하면 다음 데이터가 영구히 삭제됩니다.
    • 서버 설정
    • 모니터링 기록
    • 명령어 실행 기록
    • 접근 로그
    • 코멘트

복구 불가:

  • 한번 삭제된 서버 데이터는 복구할 수 없습니다
  • 중요한 데이터는 삭제 전에 백업하세요

에이전트 먼저 제거:

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

재등록

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

  1. 서버 등록하기 절차를 다시 따릅니다
  2. 새 설치 스크립트가 생성됩니다
  3. 이전 데이터는 복구되지 않습니다

문제 해결

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

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

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

sc.exe query alpamon
Stop-Service alpamon

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

  • 서버 상태를 확인하세요(Connected 상태에서는 삭제할 수 없습니다)
  • Superuser 권한을 확인하세요

관련 문서

최종 수정: