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

Linux & Unix - 基本インストール v1.0.0 ~ v3.0.14.1

危険

◈ 最新バージョンのドキュメントではありません

  • タイトルに表示されたバージョンより新しいパッケージの場合は最新のドキュメントを参照してください

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

  • root権限でインストール
    • 一般ユーザー権限でインストールする場合の制約事項
      • serviceの登録不可
      • process disk read/write情報の収集不可

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

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

  • 入力文言の最後の角括弧内がdefaultとして適用されます。何も入力しない場合は角括弧内の値を使用
    • ex) Linux : Enter RECEIVER_PORT[9009]: ➝ 入力しない場合は9009を使用 (3.0.0バージョンから9010 ➝ 9009に変更)
    • ex) Unix : Enter RECEIVER_PORT[9010]: ➝ 入力しない場合は9010を使用

❶ 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] パッチ

▣ 既存に実行中の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)は反映されないため、該当の設定値を必ず確認してから進めてください

❸ パッチ完了​

◈ 参考事項 (v1.2.10.1+)​

  • root権限を持ち、service登録プログラムが存在する場合(ex. systemctl)、インストール時に自動的にserviceが登録されます
    • 一般ユーザー権限の場合はservice登録なしでインストールされます
  • インストール方式に関係なく、${EXEM_HOME}/hostパスのstart.sh、stop.shを使用して実行および終了が可能です
    • serviceが登録されたが使用したくない場合
      • ${EXEM_HOME}/hostパスのstart.sh、stop.shの代わりに
        ${EXEM_HOME}/host/scriptパスのbinary_start.sh、binary_stop.shを使用できます

◈ [exem-host-agent] 実行に関する参考事項

❶ 実行/停止方法​

  • ${EXEM_HOME}/hostディレクトリのstart.shとstop.shを使用して実行/停止

❷ 正常実行の確認方法​

  • service登録時の確認方法

▶ Linux​

  • systemctl status exem-host-agent

備考

◈ 参考事項

  • 現在systemctlがサポートされていない場合はservice登録不可 (ex. Redhat 6バージョン以下など)
    ➝ 今後改善予定
  • 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