본문으로 건너뛰기

Linux & Unix - 기본설치 v3.0.15 이상

목차​

  • [exem-host-agent] 설치 준비
  • [exem-host-agent] 설치
  • [exem-host-agent] 실행
  • [exem-host-agent] 패치

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

  • 설치 단계는 권한 제한 없음
    • v3.0.15 부터 가능
  • root 권한으로 실행 권장
    • 일반 user 권한으로 실행 시 제약사항
      • service 등록 불가
      • process disk read/write 정보 수집 불가

▶ [exem-host-agent] 설치

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

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

❶ 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] 실행

❶ 실행/종료 방법​

  • 기본적으로 ${EXEM_HOME}/host 디렉토리의 start.sh와 stop.sh 사용하여 실행/종료

  • case 1) root 계정인 경우

    • start/stop 시 각각 서비스 등록 및 실행, 서비스 제거 및 종료를 진행함
    - 실행: ${EXEM_HOME}/host/start.sh 
    - 종료: ${EXEM_HOME}/host/stop.sh

  • case 2) sudo 권한이 있는 일반 user 계정인 경우

    • start/stop 시 각각 서비스 등록 및 실행, 서비스 제거 및 종료를 진행함
    • 각각의 스크립트 실행 시 반드시 sudo를 붙여줘야 함
      • 해당 user가 sudo 권한 부여 시 NOPASSWD를 설정하지 않은 경우 비밀번호를 물어볼 수 있음
    - 실행: sudo ${EXEM_HOME}/host/start.sh 
    - 종료: sudo ${EXEM_HOME}/host/stop.sh

  • case 3) sudo 권한이 없는 일반 user 계정인 경우 (권장하지 않음)

    • start/stop 시 단순 에이전트 실행 및 종료를 진행함 (서비스 사용 불가)
    • 각각의 스크립트 실행 시 서비스를 등록/제거할 수 없다는 안내 문구가 출력됨
    - 실행: ${EXEM_HOME}/host/start.sh
    - 종료: ${EXEM_HOME}/host/stop.sh

❷ 정상 실행 확인 방법​

  • service 등록 시 확인 방법

    ▶ Linux (systemctl을 사용하는 경우)

    • systemctl status exem-host-agent

    ▶ Linux (service, chkconfig를 사용하는 경우)

    • chkconfig --list exem-host-agent

  • 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

▶ [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)은 반영되지 않으니, 해당 설정 값 필수 확인 후 진행

❸ 패치 완료​