Docker설치및구동-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 권한

▶ [exem-ndm-agent] 설치

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

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

❶ setup 파일 실행​

① [ install(patch) ] 선택

❷ [ exemONE ] 에이전트 추가​

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

❸ 설치 옵션 설정​

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

❹ 설치 완료​

① Docker 이미지 Load 및 설치 완료

▶ [exem-ndm-agent] 실행

❶ 실행/중지 방법​

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

❷ 정상 실행 확인 방법​

• docker ps

❸ 버전 확인 방법​

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

• [자세한 버전 확인 방법] docker exec < Container_ID > /home/exemone/bin/exem-ndm-agent -v

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

❹ 패치 완료​

① 기존 버전 → 신규 버전 적용 확인

② Docker 이미지 Load 및 설치 완료

▶ [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=6fd1c0c0-test-test-test-6d42d41fe5ad
ACCESS_TOKEN=9252a5b3-test-test-test-67012383f8b5

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

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

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

❸ 설치 결과​

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

=====================================================
Existing version: 3.0.25.2
New version: 3.0.25.2
=====================================================
Loading Docker image...
Loaded image: maxgauge/exem-ndm-agent:v3.0.25.2
Docker image loaded: maxgauge/exem-ndm-agent:v3.0.25.2
=====================================================
Patch completed
=====================================================
VERSION=3.0.25.2
NDM_HOME=/root/exem/ndm
IMAGE=maxgauge/exem-ndm-agent:v3.0.25.2
RECEIVER_ADDR=10.20.30.40:9010
AGENT_ID=6fd1ad30-6b6e-test-test-6d4afd4fe5ad
START_SCRIPT_PATH=/root/exem/ndm/start.sh
STOP_SCRIPT_PATH=/root/exem/ndm/stop.sh
=====================================================
xmSuccess(0): patch completed