メインコンテンツまでスキップ

Linux & Unix - 基本インストール v3.0.15以上

目次​

  • [exem-host-agent] インストール準備
  • [exem-host-agent] インストール
  • [exem-host-agent] 実行
  • [exem-host-agent] パッチ

▶ [exem-host-agent] インストール準備

  • インストール手順には権限の制限なし
    • v3.0.15から可能
  • root権限での実行を推奨
    • 一般ユーザー権限で実行する場合の制約事項
      • serviceの登録不可
      • process disk read/write情報の収集不可

▶ [exem-host-agent] インストール

◈ インストール進行中のデータ入力に関する参考事項​

  • 入力文言の最後の角括弧内がdefaultとして適用されます。何も入力しない場合は角括弧内の値を使用
    • ex) Linux : Enter RECEIVER_PORT[9009]: ➝ 入力しない場合は9009を使用 (gRPC port)
    • ex) Unix : Enter RECEIVER_PORT[9010]: ➝ 入力しない場合は9010を使用 (TCP port)

❶ setupファイル実行​

① [ install(patch) ] 選択

❷ インストールオプション設定​

  • 環境変数の設定
NONameRequiredDefaultDescription
①EXEM_HOMEOsetupファイル実行位置にexemフォルダを追加exemONE agentをインストールするディレクトリの設定
②RECEIVER_IPOX (デフォルト値なし)host agentと接続するreceiverのip
③RECEIVER_PORTOLinux : 9009(gRPC) / Unix : 9010(TCP)host agentと接続するreceiverのport

④ オプションをすべて入力すると、設定確認後に次のステップへ進みます

❸ インストール完了​

▶ [exem-host-agent] 実行

❶ 実行/終了方法​

  • 基本的に${EXEM_HOME}/hostディレクトリのstart.shとstop.shを使用して実行/終了

  • case 1) rootアカウントの場合

    • start/stop時にそれぞれservice登録および実行、service削除および終了を行います
    - 実行: ${EXEM_HOME}/host/start.sh 
    - 終了: ${EXEM_HOME}/host/stop.sh

  • case 2) sudo権限のある一般ユーザーアカウントの場合

    • start/stop時にそれぞれservice登録および実行、service削除および終了を行います
    • 各スクリプトの実行時に必ずsudoを付ける必要があります
      • 該当ユーザーがsudo権限付与時にNOPASSWDを設定していない場合、パスワードを尋ねられることがあります
    - 実行: sudo ${EXEM_HOME}/host/start.sh 
    - 終了: sudo ${EXEM_HOME}/host/stop.sh

  • case 3) sudo権限のない一般ユーザーアカウントの場合 (推奨しません)

    • start/stop時に単純なエージェントの実行および終了のみを行います (serviceは使用不可)
    • 各スクリプトの実行時にserviceの登録/削除ができないという案内文が出力されます
    - 実行: ${EXEM_HOME}/host/start.sh
    - 終了: ${EXEM_HOME}/host/stop.sh

❷ 正常実行の確認方法​

  • service登録時の確認方法

    ▶ Linux (systemctlを使用する場合)

    • systemctl status exem-host-agent

    ▶ Linux (service、chkconfigを使用する場合)

    • chkconfig --list exem-host-agent

  • service登録なしで実行した場合の確認方法
    • ps -ef | grep exem-host-agent

❸ バージョン確認方法​

  • [簡単なバージョン確認方法 (Linux & Unix共通)]

    • ${EXEM_HOME}/host/pkg_version.sh

  • [詳細なバージョン確認方法 (Linux & Unix共通)]

    • ${EXEM_HOME}/host/bin/exem-host-agent -v

▶ [exem-host-agent] パッチ

◈ 既存に実行されているhost agentがある場合は終了後、以下の手順に従ってパッチ​

備考

◈ パッチ時の注意事項

  • パッチ進行時は既存に設定した${EXEM_HOME}ディレクトリを変更せずに進める必要があります

  • パッチ時に${EXEM_HOME}/host/data/host_idファイルが維持されてこそ、既存と同一のhostとして認識されます

    • 該当ファイルが存在しない場合、新しいhost_idが発行され、パッチ以前のデータと連携されない可能性があります
    • 手動パッチ時は該当ファイルをバックアップし、${EXEM_HOME}/host/dataフォルダに保存してから起動する必要があります

  • setupファイルのpatchメニューを使用すると自動的に既存のhost_idが維持されるため、setupファイルを使用したパッチを推奨します

❶ setupファイル実行​

① [ install(patch) ] 選択

❷ インストールオプション設定​

① 設定していたEXEM_HOMEを入力

  • setupファイルが実行された位置を基準にdefault値が設定されます

② 既にインストールされているかを確認後、パッチの可否を選択

③ EXEM_HOMEを除く残りのオプションは、以前インストールしたオプションどおりにdefault値が設定されます

  • 注意事項
    • インストール以降に変更されたオプション(ex. RECEIVER_IP/PORT)は反映されないため、該当の設定値を必ず確認してから進めてください

❸ パッチ完了​