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

Linux & Unix - 簡易インストール v3.0.15以上

✓ 参考事項 ( exem-manager-agent関連 )

  • exem-host-agent v3.0.15からexem-manager-agentの使用が可能
    • exem-manager-agentを使用する場合、manager agentが下記の簡易インストール手順を実行します
      • exem-manager-agent GUIDEドキュメントを参照
    • exem-manager-agentを使用しない場合は、下記の簡易インストール手順を参考にインストールできます

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

◈ 簡易インストールに関する注意事項​

  • この方法を使用してインストールする場合、$EXEM_HOMEパスの設定なしに該当パスへ直接インストールおよびパッチされます
      *   誤ったパスにインストールしないよう注意してください
  • パッチする場合、既に実行中のexem-host-agentを終了してから、以下の手順を進めてください
  • 顧客の状況に応じて、下記に案内されたインストール方法① ~ ③のいずれかを選択して進めてください

▶ [exem-host-agent]をインストールするための共通事項

❶ [exem-host-agent] packageの展開​

  • インストール時に提供されるtarファイルの中に、.binファイルと簡易インストールスクリプトがあります。
tar xvf setup_exem-host-agent_{pkg_version}.tar

❷ [exem-host-agent] packageに含まれるファイル一覧​

  • ファイル一覧
NONameDescription
①setup_exem-host-agent_${PKG_VER}.binexem-host-agentインストールパッケージファイル
②install_exem-host-agent.shexem-host-agent簡易インストール用スクリプトファイル
③exemone-filerepo.tar.gzインストール方法③ 収集サーバーのrepositoryを利用する方法で使用するDockerイメージファイル
④install_exemone-filerepo.shインストール方法③ 収集サーバーのrepositoryを利用する方法のrepository作成スクリプト
⑤uninstall_exemone-filerepo.shインストール方法③ 収集サーバーのrepositoryを利用する方法のrepository削除スクリプト

インストール方法① パッケージファイルがインストール対象HOSTサーバーにある場合

❶ install configファイルの準備​

  • install時に必要なオプション情報をテキストファイルとして準備

  • 該当ファイルには下記のデータのように、設定データがkey=value形式で記載されている必要があります

    EXEM_HOME=/home/exemone/exem
    RECEIVER_IP=10.20.30.40
    RECEIVER_PORT=9009
    • 設定しない場合は、下記の一覧に表示されたdefault値でインストールされます
      • defaultがない場合は必ず設定する必要があります

  • 必要なオプション一覧

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

❷ configファイルを使用してsetupファイルを実行​

  • ❶で準備したconfigファイルを、setupファイル実行時の第一引数として指定して実行

    • 該当ファイルに記載されたkey-valueを使用し、ユーザー入力なしで自動的にインストールが進行します

  • ex) ./setup_exem-host-agent_3.0.15.bin host-install-config

  • 参考事項
    • setupファイルとconfigファイルは異なるディレクトリに存在しても構いません
    • setupファイルとconfigファイルは両方とも絶対パス、相対パスのどちらも指定可能です
    • 実行可能な例
    - ./setup_exem-host-agent_3.0.15.bin  host-install-config
    - ./setup_exem-host-agent_3.0.15.bin  ../host-install-config
    - /home/exemone/setup_exem-host-agent_3.0.15.bin  /home/exemone/host-install-config

インストール方法② 顧客企業のリモートrepositoryを利用する方法 (v3.0.15.1 ~)

  • 顧客企業のリモートrepositoryにexem-host-agentインストールパッケージがアップロードされている場合、簡単に1行のコマンドでインストールが可能です。以下の順序で進めます。

❶ install_exem-host-agent.shの修正​

  • ▶ [exem-host-agent]をインストールするための共通事項に従って展開した後、install_exem-host-agent.shを修正します。

  • RECEIVER_IP : exem-host-agentが接続するRECEIVER_IPを入力 (デフォルト値: なし)
  • RECEIVER_PORT : exem-host-agentが接続するRECEIVER_PORTを入力 (デフォルト値: 9009[Linux] または 9010[UNIX])
  • AGENT_SETUP_FILE_URL : setup_exem-host-agent_(バージョン).binをアップロードする顧客企業のリモートRepository URLに変更
    • 例) AGENT_SETUP_FILE_URL=http://{download URL}/setup_exem-host-agent_3.0.15.1.bin

❷ 顧客企業のリモートrepository>に、修正したinstall_exem-host-agent.sh、setup_exem-host-agent_(バージョン).binファイルをアップロード​

❸ インストール対象HOSTサーバー>でのパッケージインストールおよび実行​

◈ (必須) 既にexem-host-agentが実行中の場合は必ず終了してからパッチ

  • 顧客企業のリモートrepositoryにアップロードされたinstall_exem-host-agent.shファイルを、curlまたはwgetコマンドでインストール対象HOSTサーバーにて実行します。
    • 該当コマンドを実行したディレクトリに自動的に${EXEM_HOME}が作成されインストールされるため、希望するディレクトリに移動してから実行してください。
      • 同一パスに既にexem-host-agentがインストールされている場合は自動的にパッチされます。
    • 環境に応じて、以下の2つのコマンドのうち使用可能なものを使用してください。
    • コマンドの<URL>を、❷でinstall_exem-host-agent.shファイルをアップロードしたリモートrepositoryのURLパスに変更してコマンドを実行します。
      • curlコマンドを使用
      curl -k -fsSL <URL> | sh && sudo ./exem/host/start.sh
      ex) curl -k -fsSL http://nexus.com/install_exem-host-agent.sh | sh && sudo ./exem/host/start.sh
      • wgetコマンドを使用
      wget --no-check-certificate -O- <URL> | sh && sudo ./exem/host/start.sh
      ex) wget --no-check-certificate -O- http://nexus.com/install_exem-host-agent.sh | sh && sudo ./exem/host/start.sh

インストール方法③ 収集サーバーのrepositoryを利用する方法 (v3.0.15.1 ~)

◈ ファイル転送用のコンテナPORT(default: 9011)を1つ新たに申請する必要があります。

  • 収集サーバーにDockerを利用してrepositoryコンテナを作成した後、該当コンテナにexem-host-agentインストールパッケージをアップロードすることで、簡単に1行のコマンドでインストールが可能です。
  • 提供されたtar圧縮ファイルには、Dockerを利用してrepositoryコンテナを作成できる簡易スクリプトが含まれています。

❶ <収集サーバー> install_exem-host-agent.shの修正​

  • ▣ [exem-host-agent]をインストールするための共通事項に従って収集サーバーでtarファイルを展開した後、install_exem-host-agent.shを修正します。

  • RECEIVER_IP : exem-host-agentが接続するRECEIVER_IPを入力 (デフォルト値: なし)
  • RECEIVER_PORT : exem-host-agentが接続するRECEIVER_PORTを入力 (デフォルト値: 9009[Linux] または 9010[UNIX])
  • FILEREPO_PORT : ファイル転送用コンテナのFILEREPO_PORTを入力 (デフォルト値: 9011)

❷ <収集サーバー> install_exemone-filerepo.shの実行​

  • 収集サーバーにアップロードしたinstall_exemone-filerepo.shを実行し、最後に出力されるcurlコマンドをコピーします。
  • install_exemone-filerepo.shスクリプト実行時に、以下の処理が行われます。
    • exemone-filerepo imageの登録
    • exemone-filerepo containerの起動
    • ❶ <収集サーバー> install_exem-host-agent.shの修正で修正したファイルで、コンテナ内部のファイルを置き換え
    • 最後に、インストール対象HOSTサーバーで簡易インストールできるコマンドを出力
    ex) curl -fsSL http://10.20.30.40:9011/install_exem-host-agent.sh | sh && sudo ./exem/host/start.sh
    • 実行例

❸ <インストール対象HOSTサーバー> パッケージインストールおよび実行

◈ (必須) 既にexem-host-agentが実行中の場合は必ず終了してからパッチ

  • ❷ <収集サーバー> install_exemone-filerepo.sh 実行の過程でコピーしたcurlコマンドを、インストール対象HOSTサーバーのインストールパスで実行します。
  • 実行例

[参考1]

  • exemone-filerepo containerの削除を希望する場合は、収集サーバーでuninstall_exemone-filerepo.shを実行してください。

[参考2]

  • インストール対象HOSTサーバーでexem-host-agentが動作中の場合は、stop.shを実行してからインストールする必要があります。
  • 実行中のexem-host-agentがある場合、以下の文言が出力されます。

  • 1つのHOSTにはexem-host-agentを1つだけインストールするのが原則ですが、開発およびテストのために複数インストールしたサーバーの場合は、以下の除外オプション(--nocheck)を追加すると正常にインストールできます。
curl -fsSL http://10.20.30.41:9011/install_exem-host-agent.sh | sh -s -- --nocheck && sudo ./exem/host/start.sh