본문으로 건너뛰기

Linux & Unix - 기본설치 v1.0.0 ~ v3.0.14.1

위험

◈ 최신 버전의 문서가 아님

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

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

  • root 권한으로 설치
    • 일반 user 권한으로 설치 시 제약사항
      • service 등록 불가
      • process disk read/write 정보 수집 불가

▣ [exem-host-agent] 설치

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

  • 입력 문구 마지막 대괄호 안쪽이 default로 적용됨. 아무 것도 입력하지 않을 시 대괄호 내부 값 사용
    • ex) Linux : Enter RECEIVER_PORT[9009]: ➝ 입력하지 않을 시 9009 사용 (3.0.0 버전부터 9010 ➝ 9009로 변경됨)
    • ex) Unix : Enter RECEIVER_PORT[9010]: ➝ 입력하지 않을 시 9010 사용

❶ setup 파일 실행​

① [ install(patch) ] 선택

❷ 설치 옵션 설정​

  • 환경 변수 설정
NONameRequiredDefaultDescription
①EXEM_HOMEOsetup 파일 실행 위치에 exem 폴더 추가exemONE agent들을 설치할 디렉토리 설정
②RECEIVER_IPOX (기본값 없음)host agent와 연결할 receiver의 ip
③RECEIVER_PORTOLinux : 9009(gRPC) / Unix : 9010(TCP)host agent와 연결할 receiver의 port

④ 옵션을 전부 입력하면 설정 확인 후 다음 단계 진행

❸ 설치 완료​

▣ [exem-host-agent] 패치

▣ 기존 실행되고 있는 host agent가 있는 경우 종료 후 아래 단계에 따라 패치​

정보

◈ 패치 주의사항

  • 패치 진행 시 기존 설정한 ${EXEM_HOME} 디렉토리를 변경 없이 진행해야 함
  • 패치 시 ${EXEM_HOME}/host/data/host_id 파일이 유지되어야 기존과 동일한 host로 인식
    • 해당 파일이 없는 경우 새 host_id가 발급되어 패치 이전의 데이터와 연결되지 않을 수 있음
    • 수동 패치 시 해당 파일을 백업하여 ${EXEM_HOME}/host/data 폴더에 저장 후 기동해야 함
  • setup 파일의 patch 메뉴 사용 시 자동으로 기존 host_id를 유지하므로 setup 파일을 사용한 패치 권장

❶ setup 파일 실행​

① [ install(patch) ] 선택

❷ 설치 옵션 설정​

① 설정했던 EXEM_HOME 입력

  • setup 파일이 실행된 위치 기준으로 default 값이 설정됨

② 이미 설치되어 있는지 확인 후 패치 여부 선택

③ EXEM_HOME을 제외한 나머지 옵션은 기존에 설치했던 옵션대로 default 값이 설정됨

④ 설치 이후 변경된 옵션(ex. RECEIVER_IP/PORT)은 반영되지 않으니, 해당 설정 값 필수 확인 후 진행

❸ 패치 완료​

◈ 참고 사항 (v1.2.10.1+)​

  • root 권한을 가지고, service 등록 프로그램이 존재하는 경우(ex. systemctl), 설치 시 자동으로 service가 등록됨
    • 일반 user 권한인 경우 service 등록 없이 설치됨
  • 설치된 방식과 관계 없이 ${EXEM_HOME}/host 경로의 start.sh,stop.sh 를 사용하여 실행 및 종료가 가능함
    • service가 등록되었으나 사용하고 싶지 않은 경우
      • ${EXEM_HOME}/host 경로의 start.sh, stop.sh 를 대신하여
        ${EXEM_HOME}/host/script 경로의 binary_start.sh, binary_stop.sh 를 사용할 수 있음

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

❶ 실행/중지 방법​

  • ${EXEM_HOME}/host 디렉토리의 start.sh와 stop.sh 사용하여 실행/중지

❷ 정상 실행 확인 방법​

  • service 등록 시 확인 방법

▶ Linux​

  • systemctl status exem-host-agent

정보

◈ 참고사항

  • 현재 systemctl이 지원되지 않는 경우 service 등록 불가 (ex. Redhat 6 버전 이하 등)
    ➝ 추후 개선 예정
  • service 등록 없이 실행 시 확인 방법
    • ps -ef | grep exem-host-agent

❸ 버전 확인 방법​

  • [간단한 버전 확인 방법 (Linux & Unix 모두 동일)]

${EXEM_HOME}/host/pkg_version.sh

  • [자세한 버전 확인 방법 (Linux & Unix 모두 동일)]

${EXEM_HOME}/host/bin/exem-host-agent -v