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

• Window 설치 파일
  • setup_exem-manager-agent_[버전].exe

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

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

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

◈ exem-manager-agent와 다른 agent들의 PORT가 겹치지 않게 주의합니다.

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

① [ 다음 > ] 선택

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

• [ 예(Y) ] 를 선택하는 경우 마지막 설치 과정에서 기존 에이전트를 제거하고 새 버전을 설치함
  • 설치 파일을 중도에 취소하는 경우 기존 에이전트가 유지됨

• [ 아니오(N) ] 를 선택하는 경우 설치 파일이 종료됨

❷ 설치 경로 설정​

① [ 설치 폴더 ] 설정

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

② [ 다음 > ] 선택

❸ Receiver IP & Port 설정​

① [ MGR_RECEIVER_ADDR ] 입력

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

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

② [ 다음 ] 선택

❹ Receiver IP & Port 체크​

① [ 예(Y) ] 선택

➝ 설치를 시작합니다.

② [ 아니요(N) ] 선택

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

❺ 서비스 등록 여부 선택​

① [ ⓥ ] 선택

➝ 서비스 등록을 합니다.

[ ○ ] 선택 해제

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

• ② [ 설치 ] 선택

❻ 설치 완료​

① [ 닫음 ] 선택

➝ 위 ❺ 서비스 등록 여부 선택 에서 서비스를 등록한 경우에만 설치가 완료되면 자동으로 exem-manager-agent가 실행되어 동작합니다.

(서비스 등록 하지 않은 경우 수동으로 실행해야 합니다.)

❼ exem-manager-agent가 관리하는 agent 연결 key 파일 내용 작성​

• exem-manager-agent (ver 3.0.9 ~)

  • agent_config.json을 사용하며 상세한 설정은 agent_config.json (ver 3.0.9 ~)를 참고하여 작성

• exem-manager-agent (ver 3.0.1 ~3.0.8)

  • agent_key_info.json을 사용하며 상세한 설정은 agent_key_info.json (ver 3.0.1 ~ 3.0.8)를 참고하여 작성

▶ [exem-manager-agent] 삭제

▣ 삭제 참고사항​

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

▣ 삭제 방법

• [방법 1] $MGR_EXEM_MANAGER_HOME 경로의 Uninstall.exe 실행한다.
• [방법 2] 제어판 ➝ 프로그램 제거 ➝ exem-manager-agent 선택 ➝ 마우스 우클릭 ➝ 제거/변경(U) 선택한다.

❶ Uninstall.exe 실행​

① [ 다음 > ] 선택

❷ 제거 대상 확인​

① [ 제거 대상 ] 확인

➝ 기존 설치한 경로\mananger 자동 설정됩니다.

② [ 제거 ] 선택

❸ 삭제 완료​

• ① [ 닫음 ] 선택

◈ [exem-manager-agent] 실행 참고 사항

❶ 정상 실행 확인 방법​

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

❷ 버전 확인 방법​

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

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

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

❸ 서비스 등록 확인​

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

❹ 실행 시작/중지​

• $MGR_MANAGER_HOME/manager 경로의 start.bat와 stop.bat을 관리자 권한으로 실행해야 시작/중지 가능합니다.
  • 일반 권한으로 실행 시 .bat 파일이 수행되지 않습니다.