NDM Agentインストール
1. モジュール説明
ネットワークデバイス収集のためのexem-ndm-agentのインストール方法です。モニタリング画面はネットワークデバイス、デバイス登録はネットワークデバイス設定文書を参照してください。
2. 対応環境
| 項目 | 内容 |
|---|---|
| OS | Linux |
| Arch | 64bit |
| Platform | Docker (alpine:3.21ベース) (v3.0.25+ — 専用Dockerインストールパッケージ提供: setup_exem-ndm-agent_<version>_docker.bin)On-premise (binary) |
| Protocol | TCP 9010 → Receiver |
| Prereq | root権限必須 (ICMP) |
| Limitation | Windows非対応 Unix (AIX / HP-UX / Solaris)非対応 |
| Other | SNMP v1 / v2c / v3 SNMP Monitoring (Device / Interface Perf·Stat) Syslog受信 SNMP Trap受信 Topology Device Discovery |
3. 事前設定
exemONE WebページのSetting > AgentでNetwork Device Agentを事前登録します。
NDM Agentのインストールファイルを準備します。
setup_exem_ndm_1.0.13.binダウンロードしたファイルに実行権限を付与します。
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. インストール先を入力します。(Enter入力時はデフォルトパス/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サービス登録方法
手順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