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