본문으로 건너뛰기

Windows - v3.0.15 이상

목차​

  • [exem-host-agent] 설치 준비
  • [exem-host-agent] 설치 및 패치
  • [exem-host-agent] 삭제
  • [exem-host-agent] 실행 참고 사항

▶ [exem-host-agent] 설치 준비

  • 설치 및 실행은 관리자 권한으로 진행해야 함

▶ [exem-host-agent] 설치 및 패치

❶ setup_exem-host-agent_[버전].exe 파일 실행​

① [ 다음 > ] 선택

▶ 해당 서버에 이미 설치되어 있는 경우 자동으로 감지하여 아래 팝업 발생 (패치)​

  • [ 예(Y) ] 를 선택하는 경우 마지막 설치 과정에서 기존 에이전트를 제거하고 새 버전을 설치합니다.
    • 설치 파일을 중도에 취소하는 경우 기존 에이전트가 유지됩니다.
  • [ 아니오(N) ] 를 선택하는 경우 설치 파일이 종료됩니다.

❷ 설치 경로 설정​

① [ 설치 폴더 ] 설정

➝ 기본 경로는 C:\Program Files (x86)\exem 입니다.

② [ 다음 > ] 선택

❸ Receiver IP & Port 설정​

① [ RECEIVER_ADDR ] 입력

➝ {IP}:{port} 형식으로 입력합니다. ex) 10.10.10.10:9009

➝ 기본값 설정이 없으므로 반드시 설정해야 합니다.

➝ Windows host agent는 gRPC port (default 9009)를 사용해야 합니다.

② [ 다음 ] 선택

❹ Receiver IP & Port 체크​

① [ 예(Y) ] 선택

➝ 설치를 시작합니다.

② [ 아니요(N) ] 선택

➝ 다시 Receiver IP & Port를 입력할 수 있습니다.

❺ 서비스 등록 여부 선택​

① [ ⓥ ] 선택

➝ 서비스 등록을 합니다.

[ ○ ] 선택 해제

➝ 서비스 등록을 하지 않습니다.

② [ 설치 ] 선택

📢 참고사항

  • 설치시 서비스 등록한 경우 exem-host-agent가 비정상 종료시 자동 재기동 됩니다.

❻ 설치 완료​

① [ 닫음 ] 선택
➝ 위 ❺ 서비스 등록 여부 선택 에서 서비스를 등록한 경우에만 설치가 완료되면 자동으로 exem-host-agent가 실행되어 동작합니다.
(서비스 등록 하지 않은 경우 수동으로 실행해야 합니다.)

▶ [exem-host-agent] 삭제

▣ 삭제 참고사항​

  • 삭제 시 기존 실행되고 있는 host agent는 자동 종료 후 삭제 과정이 진행됩니다.
  • 기존 host id를 유지하기 위해 C:\Users[사용자]\AppData\Local\exem\host\data 경로에 $EXEM_HOME\host\data\host_id 파일이 자동 백업 됩니다.
  • host_id 이외 파일의 경우 삭제시 백업되지 않습니다. 로그 등 중요한 데이터는 삭제 전 백업이 필요합니다.

▣ 삭제 방법​

  • [방법 1] $EXEM_HOST_HOME 경로의 Uninstall.exe 실행한다.

  • [방법 2] 제어판 ➝ 프로그램 제거 ➝ exem-host-agent 선택 ➝ 마우스 우클릭 ➝ 제거/변경(U) 선택한다.

❶ Uninstall.exe 실행​

① [ 다음 > ] 선택

❷ 제거 대상 확인​

① [ 제거 대상 ] 확인
➝ 기존 설치한 경로\host 자동 설정됩니다.

② [ 제거 ] 선택

❸ 삭제 완료​

  • ① [ 닫음 ] 선택

◈ 참고사항​

  • 삭제가 완료되면 설치시 등록된 서비스 및 exem-host-agent 폴더, 로그가 모두 삭제 됩니다.
  • 로그 등 중요한 데이터는 삭제 전 백업이 필요합니다.

▶ [exem-host-agent] 실행 참고 사항

❶ 정상 실행 확인 방법​

  • 작업관리자 ➝ 프로세스에서 "exem-host-agent"가 있는지 확인합니다.

❷ 버전 확인 방법​

  • [간단한 버전 확인 방법] 윈도우 PowerShell을 실행하여 $EXEM_HOST_HOME 폴더로 이동합니다. .\pkg_version.bat 명령어로 exem-host-agent의 버전 정보를 확인 할 수 있습니다.

  • [자세한 버전 확인 방법] 윈도우 PowerShell을 실행하여 $EXEM_HOST_HOME/bin 폴더로 이동합니다. .\exem-host-agent_win_64.exe -v 명령어로 exem-host-agent의 버전 정보를 확인 할 수 있습니다.

  • 작업관리자 ➝ 프로세스 에서 실행 프로세스명 으로 exem-host-agent의 버전 정보를 확인 할 수 있습니다.

❸ 서비스 등록 확인​

  • 서비스에 EXEM HOST AGENT로 아래와 같이 설정됩니다.