Windows - v3.0.14.1 이하

◈ 최신 버전의 문서가 아님

• 제목에 표시된 버전보다 높은 패키지의 경우 최신 문서 참고

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

• 설치 진행 시 반드시 관리자 권한으로 실행해야 함
• Window 설치 파일
  • setup_exem-host-agent_[버전].exe

▣ [exem-host-agent] 설치

▣ 설치 진행 중 데이터 입력 참고사항​

• ❸ Receiver IP & Port 설정 에서 RECEIVER_ADDR을 입력하지 않을 경우 RECEIVER_ADDR은 설정되지 않습니다.

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

① [ 다음 > ] 선택

❷ 설치 경로 설정​

① [ 설치 폴더 ] 설정

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

② [ 다음 > ] 선택

❸ Receiver IP & Port 설정​

① [ RECEIVER_ADDR ] 입력

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

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

② [ 다음 ] 선택

❹ Receiver IP & Port 체크​

① [ 예(Y) ] 선택

➝ 설치를 시작합니다.

② [ 아니요(N) ] 선택

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

❺ 서비스 등록 여부 선택 (v3.0.2+)​

① [ ⓥ ] 선택

➝ 서비스 등록을 합니다.

[ ○ ] 선택 해제

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

② [ 설치 ] 선택

❻ 설치 완료​

① [ 닫음 ] 선택

➝ 위 ❺ 서비스 등록 여부 선택 에서 서비스를 등록한 경우에만 설치가 완료되면 자동으로 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] 삭제 과정 진행 후 ▣ [exem-host-agent] 설치 과정을 진행합니다.

  • 삭제 과정에서 기존 사용하던 host_id는 백업되므로 기존 설치된 exem-host-agent를 삭제 후 재설치해도 host_id는 유지됩니다.

• 삭제 과정 없이 ▣ [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로 아래와 같이 설정됩니다.