exem-ndm-agent 설치하기

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

지원 환경​

• Linux 환경
• root 권한 필요

사전 설정​

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
   

기본 설치 방법​

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

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

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

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

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

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

insert into xm_network_device_agent(name, enable, agent_id, access_token)
values('에이전트 이름', true, 'e8300b97-19e2-4f83-8da9-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