본문으로 건너뛰기

NDM Agent 설치

1. 모듈 설명​

네트워크 디바이스 수집을 위한 exem-ndm-agent 설치 방법입니다. 모니터링 화면은 네트워크 디바이스, 디바이스 등록은 네트워크 디바이스 설정하기 문서를 참고하세요.

2. 지원 환경​

항목내용
OSLinux
Arch64bit
PlatformDocker (alpine:3.21 기반)
(v3.0.25+ — 전용 Docker 설치 패키지 제공: setup_exem-ndm-agent_<version>_docker.bin)
On-premise (binary)
ProtocolTCP 9010 → Receiver
Prereqroot 권한 필수 (ICMP)
LimitationWindows 미지원
Unix (AIX / HP-UX / Solaris) 미지원
OtherSNMP v1 / v2c / v3
SNMP Monitoring (Device / Interface Perf·Stat)
Syslog 수신
SNMP Trap 수신
Topology
Device Discovery

3. 사전 설정​

  1. exemONE 웹페이지의 Setting > Agent에서 Network Device Agent를 사전 등록합니다.

  2. NDM Agent 설치 파일을 준비합니다.

    setup_exem_ndm_1.0.13.bin

  3. 다운로드한 파일에 실행 권한을 부여합니다.

    chmod 500 setup_exem_ndm_1.0.13.bin

4. 기본 설치 방법​

1단계. 설치 파일을 실행합니다.

./setup_exem_ndm_1.0.13.bin

2단계. 설치 메뉴에서 1을 선택해 기본 설치를 진행합니다.

=====================================================
EXEM NDM Agent Setup
=====================================================
choise work
1. install(default)
2. patch
3. unpack
:1

3단계. 설치 완료 후 임시 디렉터리 삭제 여부를 선택합니다.

Delete directory after work?[y(default)/n]:

4단계. 설치 위치를 입력합니다. (엔터 입력 시 기본 경로 /root/exemone/exem에 설치)

Install Directory (/root/exemone/exem):

5단계. Receiver IP 및 Port 정보를 입력합니다. (Port 미입력 시 기본값 9010)

6단계. 에이전트를 시작합니다.

{NDM Agent Home}/bin/start.sh

7단계. 로그를 확인합니다.

{NDM Agent Home}/log/ndm-agent.log

5. Linux Service 등록 방법​

1단계. NDM home 경로에 service 폴더를 생성합니다.

mkdir service

2단계. service 폴더에 exem-ndm-agent.service 파일을 넣습니다.

[Unit]
Description=exem-ndm-agent
Wants=network-online.target
After=network-online.target

[Service]
Type=forking
WorkingDirectory=/root/exem/ndm/bin
PIDFile=/root/exem/ndm/data/ndm-agent.pid
ExecStart=/root/exem/ndm/bin/start.sh
ExecStop=/root/exem/ndm/bin/stop.sh
ExecStartPost=/bin/sleep 1
Restart=on-failure
RestartSec=10

[Install]
WantedBy=default.target
노트

WorkingDirectory, PIDFile, ExecStart, ExecStop 경로를 실제 NDM Home 경로로 수정해야 합니다.

3단계. service_start.sh, service_stop.sh 파일을 service 폴더에 넣습니다. (경로 수정 필요)

4단계. /etc/systemd/system/ 경로에 exem-ndm-agent.service를 복사하고 서비스를 등록합니다.

sudo cp service/exem-ndm-agent.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl start exem-ndm-agent
systemctl status exem-ndm-agent

6. Agent 메뉴 없이 수동 등록하기​

NDM-Agent를 Agent 메뉴 없이 수동으로 등록·연결하는 방법입니다.

1단계. PostgreSQL DB에 쿼리로 에이전트를 수동 등록합니다.

insert into xm_network_device_agent(name, enable, agent_id, access_token)
values('에이전트 이름', true, 'e8300b97-test-test-test-ec0af0432dbc', 'uuid 토큰 값');

2단계. NDM-Agent 설치 시 위 등록 정보(Agent ID, Access Token, Agent Name)와 일치하는 값을 입력합니다.

3단계. 에이전트 실행 후 로그를 확인합니다.

{NDM Agent Home}/bin/start.sh

# 로그 확인
{NDM Agent Home}/log/ndm-agent.log