에이전트 문제

Alpamon 에이전트 관련 문제 해결 가이드입니다.

에이전트 설치 실패

서버 OS 계열을 잘못 선택한 경우

에이전트 설치 시 서버의 OS 계열을 잘못 선택하면 설치가 실패할 수 있습니다.

기본 설치 스크립트는 OS 종류와 무관하게 동일한 스크립트를 사용하므로 대부분의 경우 문제없이 설치됩니다. 하지만 매뉴얼 방식으로 에이전트를 설치할 경우, OS 계열에 따라 설치 스크립트가 달라지므로 잘못된 OS를 선택하면 설치에 실패합니다.

해결 방법:

1. 서버의 실제 OS 계열 확인:

   • Debian 계열: Ubuntu, Debian 등
   • RedHat 계열: RHEL, CentOS, Fedora, Amazon/Rocky/Oracle Linux 등

2. 서버 등록 페이지에서 서버 등록 시 올바른 OS 계열 선택

3. 매뉴얼 설치 스크립트 사용 시, 선택한 OS 계열에 맞는 스크립트를 통해서 에이전트를 설치:

   • Debian 계열 선택 시: apt-get install -y alpamon 명령이 포함된 스크립트 사용
   • RedHat 계열 선택 시: yum install -y alpamon 명령이 포함된 스크립트 사용

4. 잘못된 OS 계열로 서버를 등록한 경우 서버를 삭제한 후 올바른 OS 계열로 재등록

워크스페이스를 이전한 경우

다른 워크스페이스에서 사용하던 서버를 에이전트 삭제 과정 없이 신규 워크스페이스에 등록한 경우, 에이전트는 기존 워크스페이스에 계속 연동된 상태로 동작할 수 있습니다. 이 경우 신규 워크스페이스에서는 서버 연결이 불가능합니다.

해결 방법:

1. 기존 워크스페이스에서 에이전트 자동 삭제 선택 후 서버 삭제 (기존 에이전트 서버에서 제거)

2. 기존 워크스페이스 접근 불가 시 서버 제거하기 참고하여 수동 에이전트 삭제

3. 신규 워크스페이스에서 서버 등록 및 에이전트 설치 새로 수행

에이전트 업그레이드 문제

콘텐츠 작성 필요