On-Primise설치및구동-v3.0.25이상

목차​

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

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

• Linux 설치 파일
  • setup_exem-ndm-agent_[버전].bin
• root 권한
  위험

  NDM Agent는 root 권한으로 실행되어야 합니다. 따라서 설치 시 root 권한으로 진행이 필요합니다.

▶ [exem-ndm-agent] 설치

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

• 입력 문구 마지막 대괄호 안쪽이 default로 적용됨. 아무 것도 입력하지 않을 시 대괄호 내부 값 사용
  • ex) Enter EXEM_HOME[/root/exem]: ➝ 입력하지 않을 시 기본 값을 사용

❶ setup 파일 실행​

① [ install(patch) ] 선택

❷ [ exemONE ] 에이전트 추가​

• NDM Agent 서비스 등록을 위한 API Token 발급
  • ① : 네트워크 디바이스 선택
  • ② : 에이전트 이름 등록
  • ③ : 갱신을 통해 에이전트 ID 및 엑세스 토큰 발급
  • ④⑤ : 에이전트 ID 및 엑세스 토큰을 별도 저장 후 NDM Agent 설치 시 입력 필수
  • ⑥ : 활성화 후 저장
    • 활성화를 하지 않으면 수집하지 않습니다.

❸ 설치 옵션 설정​

• 옵션 설정

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

❹ 설치 완료​

▶ [exem-ndm-agent] 실행

❶ 실행/중지 방법​

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

❷ 정상 실행 확인 방법​

• ps -ef | grep ndm

❸ 버전 확인 방법​

• [간단한 버전 확인 방법] ${EXEM_HOME}/ndm/pkg_version.sh

• [자세한 버전 확인 방법] ${EXEM_HOME}/ndm/bin/exem-ndm-agent -v

▶ [exem-ndm-agent] 패치

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

◈ 패치 주의사항

• 패치 진행 시 기존 설정한 ${EXEM_HOME} 디렉토리를 변경 없이 진행해야 함
  • 패치 시 ${EXEM_HOME}/ndm/data/ndm_id파일이 유지되어야 기존과 동일한 ndm로 인식
    • 해당 파일이 없는 경우 신규 설치를 진행 신규 에이전트_ID 엑세스토큰의 입력 필요
    • 수동 패치 시 해당 파일을 백업하여 ${EXEM_HOME}/ndm/data 폴더에 저장 후 기동해야 함
• setup 파일의 patch 메뉴 사용 시 자동으로 기존 ndm_id를 유지하므로 setup 파일을 사용한 패치 권장

❶ setup 파일 실행​

① [ install(patch) ] 선택

❷ 설치 옵션 설정​

① 설정했던 EXEM_HOME 입력

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

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

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

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

❸ 패치 완료​

▶ [exem-ndm-agent] Silent 설치

▣ 설치 시 입력 할 설정들을 미리 정의해 놓고 설치를 빠르게 진행 가능​

❶ setup_exem_ndm.silent 설정 파일 생성​

• 설치에 필요한 설정을 아래 표를 참고하여 setup_exem_ndm.silent 파일 안에 미리 작성

• setup_exem_ndm.silent 예시

root ~# cat setup_exem_ndm.silent
INSTALL_PATH=/root/exem/ndm
APP_NAME=ndm-agent
RECEIVER_IP=10.20.30.40
RECEIVER_PORT=9010
AGENT_ID=c596977d-6613-test-test-35977daad870
ACCESS_TOKEN=7977d214-f7bf-test-test-d1e541977dba

❷ setup 파일 및 설정 파일로 설치 실행​

• setup 파일의 파라미터로 ❶ setup_exem_ndm.silent 설정 파일에서 생성한 파일을 입력

./setup_exem-ndm-agent_3.0.25.bin ./setup_exem_ndm.silent

❸ 설치 결과​

=====================================================
EXEM NDM Agent Installer
=====================================================
=====================================================
Package extracted to: /root/temp_ndm_setup
Package version: 3.0.25
exemOne NDM Agent Installer
=====================================================
Already installed in [/root/exem/ndm]. Patching?[Y]: Y
INSTALL_PATH[/root/exem/ndm]

=====================================================
Existing version: 3.0.25
New version: 3.0.25
=====================================================
exem-ndm-agent stop --- 
exem-ndm-agent Service terminate.
Waiting for exem-ndm-agent process(2930265) exit..| by pid file

exem-ndm-agent process terminated.
=====================================================
Patch completed
=====================================================
VERSION=3.0.25
NDM_HOME=/root/exem/ndm
RECEIVER_ADDR=10.20.30.40:9010
AGENT_ID=c523428f-6613-test-test-355aaaaad870
START_SCRIPT_PATH=/root/exem/ndm/start.sh
STOP_SCRIPT_PATH=/root/exem/ndm/stop.sh
NDM_AGENT_ID_FILE_PATH=/root/exem/ndm/data/ndm_id
=====================================================
xmSuccess(0): patch completed