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

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

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

◈ 簡易インストール注意事項​

  • 該当方法を使用してインストールする場合、$EXEM_HOMEパス設定なしに該当パスに直接インストール及びパッチ
        *   誤ったパスにインストールしないよう注意
    パッチする場合、既に実行中のexem-manager-agentを終了後 下記の段階を進行
  • 顧客企業の状況に応じて下記に案内されたインストール方法① ~ ③のうち1つの方法を選択して進行

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

❶ [exem-manager-agent] package解凍​

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

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

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

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

❶ install configファイル準備​

  • install時点に必要なオプション情報をtextファイルで準備

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

    INSTALL_PATH=/home/exemone/exem
    RECEIVER_IP=10.20.30.40
    RECEIVER_PORT=9010
  • 設定しない場合下記リストに表示されたdefault値でインストールされる

    • defaultがない場合は必須設定が必要
  • 必要なオプション一覧

NONameRequiredDefaultDescription
①INSTALL_PATHOsetupファイル実行位置にexemフォルダを追加exemONE agentをインストールするディレクトリ設定
②RECEIVER_IPOX (デフォルト値なし)manager agentと接続するreceiverのip
③RECEIVER_PORTO9010manager agentと接続するreceiverのport

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

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

    • 該当ファイルに記載されたkey-valueを使用してユーザーinputなしに自動でインストール進行される
  • ex) ./setup_exem-manager-agent_3.0.21.bin manager-install-config

  • 参考事項
    • setupファイルとconfigファイルは異なるディレクトリに存在しても問題なし
    • setupファイルとconfigファイルはいずれも絶対パス、相対パスどちらも指定可能
    • 実行可能な例
    - ./setup_exem-manager-agent_3.0.21.bin  manager-install-config
    - ./setup_exem-manager-agent_3.0.21.bin ../manager-install-config
    - /home/exemone/setup_exem-manager-agent_3.0.21.bin /home/exemone/manager-install-config

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

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

❶ install_exem-manager-agent.sh修正​

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

  • RECEIVER_IP: exem-manager-agentが接続されるRECEIVER_IPを入力 (デフォルト値: なし)
  • RECEIVER_PORT: exem-manager-agentが接続されるRECEIVER_PORTを入力 (デフォルト値: 9010)
  • AGENT_SETUP_FILE_URL: setup_exem-manager-agent_(버전).binをアップロードする顧客企業のリモートRepository URLに変更
    • 例) AGENT_SETUP_FILE_URL=http://{download URL}/setup_exem-manager-agent_3.0.21.bin

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

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

◈ (必須) 既にexem-manager-agentが実行中の場合は必ず終了後にパッチ

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

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

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

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

危険

◈ exem-manager-agent v3.0.21 では install_exem-manager-agent.sh の修正が必要だった。 ◈ exem-manager-agent v3.0.22 からは install_exemone-filerepo.sh を修正します。

  • 統合インストール機能のためにinstall_exemone-filerepo.shスクリプトにアップロードAGENTリストを更新します。

❶-❶ <収集サーバー> install_exem-manager-agent.sh修正 v3.0.21​

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

  • RECEIVER_IP: exem-manager-agentが接続されるRECEIVER_IPを入力 (デフォルト値: なし)
  • RECEIVER_PORT: exem-manager-agentが接続されるRECEIVER_PORTを入力 (デフォルト値: 9010)
  • FILEREPO_PORT: ファイル転送用コンテナのFILEREPO_PORTを入力 (デフォルト値: 9011)

❶-❷ <収集サーバー> install_exem-manager-agent.sh修正 v3.0.22​

▣ [exem-manager-agent]をインストールするための共通事項 に従って収集サーバーでtarファイル解凍後install_exemone-filerepo.shを修正します。

  • RECEIVER_IP: exem-manager-agentが接続されるRECEIVER_IPを入力 (デフォルト値: なし)
  • UPLOAD_AGENT_LIST: exem-manager-agentが統合インストールするエージェント名を入力 (デフォルト値: manager)
  • UPLOAD_INI_FILE: exem-manager-agentが統合インストールするエージェント設定を入力 (デフォルト値: なし)

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

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

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

  • 収集サーバーにアップロードしたinstall_exemone-filerepo.shを実行後、最後に出力されるcurlコマンドをコピーします。
  • install_exemone-filerepo.shスクリプト実行時、次の過程を実行します。
    • exemone-filerepo image登録
    • exemone-filerepoインストールファイルアップロード
    • exemone-filerepo container開始
    • ❷-❶ <収集サーバー> install_exemone-filerepo.sh修正 で修正されたファイルでコンテナ内部ファイルを置換
    • 最後にインストール対象HOSTサーバーで簡易インストールできるコマンドを出力
    curl -fsSL http://10.20.30.42:9011/install_exem-manager-agent.sh | sh
    -- 아래 : 통합 설치 --
    curl -fsSL http://10.20.30.42:9011/install_exem-manager-agent.sh | sh -s -- --agent=host,db
    curl -fsSL http://10.20.30.42:9011/install_exem-manager-agent.sh | sh -s -- --ini=sample.ini
    • 実行例

​

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

◈ (必須) 既にexem-manager-agentが実行中の場合は必ず終了後にパッチ

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

[参考1]

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

[参考2]

  • インストール対象HOSTサーバーにexem-manager-agentが動作中の場合、stop.shを実行させた後にインストールする必要があります。
  • 実行中のexem-manager-agentがある場合、次の文言が出力されます。

  • 1つのHOSTには1つのexem-manager-agentのみをインストールするのが原則ですが、開発及びテストのために複数インストールしたサーバーの場合、次の除外オプション(--nocheck)を追加すると正常にインストール可能です。
curl -fsSL http://ip:port/install_exem-manager-agent.sh | sh -s -- --nocheck && sudo ./exem/manager/start.sh