Linux への Collector のインストール

UI インストーラを使用したインストール 

サーバ上で root または管理者権限を使用してインストーラを実行します。root または管理者としてログインしていない場合は、UI インストーラを実行する前に再認証が求められる場合があります。

1. ダウンロードしたインストーラ ファイルを開きます。
2. root または管理者のユーザ名とパスワードの入力を促されたら、入力します。
3. ウィザードを開いて [Welcome (ようこそ)] ページを表示します。[Next (次へ)] をクリックします。
4. 使用許諾契約書に同意して、[Next (次へ)] をクリックします。
5. Collector の場所を参照して選択するか、デフォルトのままにして、[Next (次へ)] をクリックし、マシンに Collector ファイルをインストールします。
6. インストーラがデフォルト設定のサマリを表示します。デフォルト設定を変更したい場合は、[Advanced UI Installer Settings (UI インストーラの詳細設定)] をクリックして指示に従ってください。[Next (次へ)] をクリックします。
7. 認証方式を選択します。

• セットアップ ウィザード トークン: セットアップ ウィザードで UI インストーラ用のトークンを入手してある場合は、[Next (次へ)] をクリックし、トークンを入力してから [Next (次へ)] をクリックします。セットアップ ウィザード トークンは、1 回限りのトークンであるため、生成後 1 時間は有効ですが、その後は期限切れになります。このトークンでユーザを認証します。1 つの Collector のみに使用できます。API では使用できず、無効化はできません。
• アクセス キー: Sumo Logic のアクセス ID とキーを持っている場合は、[Next (次へ)] をクリックし、アクセス ID とキーを入力してから [Next (次へ)] をクリックします。

8. [Finish (完了)] をクリックしてセットアップを終了します。
9. Sumo Logic で [Manage Data (データの管理)] > [Collection (コレクション)] > [Collection (コレクション)] を選択して、Collector が表示されることを確認します。この手順の確認ステップで [Collector Name (Collector 名)] として表示された名前を探します (名前は [Advanced Settings (詳細設定)] で変更できます)。すでに同じ名前の Collector が存在する場合は、新しい Collector 名に接尾辞が付加されて一意の名前になります。Collector が見つからない場合は、[Error Codes (エラー コード)] リストを確認してトラブルシューティングを行ってください。

コマンド ライン インストーラを使用したインストール

1. ダウンロードした Collector ファイル (.sh) に実行権限を追加します。

   chmod +x SumoCollector.sh

2. 設定するパラメータを指定してスクリプトを実行します。パラメータの説明については「コマンド ライン インストーラのパラメータ」を参照してください。  デフォルトでは、Collector は /opt/SumoCollector または /usr/local/SumoCollector にインストールされます。

例 

アクセス ID とアクセス キーを使用する場合:

sudo ./SumoCollector.sh -q -Vsumo.accessid=<accessId> -Vsumo.accesskey=<accessKey> -Vsources=<filepath>

プロキシ設定の追加:

sudo ./SumoCollector.sh -q -Vsumo.accessid=<accessId> -Vsumo.accesskey=<accessKey> -Vsources=<filepath> -Vproxy.host=<proxyHost> -Vproxy.port=<proxyPort>

syncSources とカスタマイズした Collector 名のインクルード:

sudo ./SumoCollector.sh -q -Vsumo.accessid=<accessId> -Vsumo.accesskey=<accessKey> -VsyncSources=<filepath> -Vcollector.name=<name>

RPM または Debian パッケージを使用したインストール

RPM または Debian パッケージを使用して、Collector を Linux 64 ビット システムにインストールできます。

1. ダウンロードしたインストール パッケージを使用して Collector をインストールします。
   RPM パッケージの場合は以下のコマンドを使用します。

   sudo rpm -i SumoCollector-19.XXX-XX.x86_64.rpm

   Debian パッケージの場合は以下のコマンドを使用します。

   sudo dpkg -i SumoCollector-19.XXX-XX.x86_64.deb

   RPM および Debian パッケージは、Collector を /opt/SumoCollector ディレクトリにインストールします。  デフォルトでは、Collector はシステム サービスとしてインストールされますが、まだ起動はしません。

2. /opt/SumoCollector/config/ ディレクトリにある Collector の user.properties ファイルを設定します。Collector は、user.properties で定義されている設定を使用して、自身を登録して起動します。アクセス ID とアクセス キーによる認証を使用した登録と起動のためのエントリは次の形式で追加します。
   
   user.properties ファイルの例:

name = [My Collector]
accessid = [accessId]
accesskey = [accessKey]

サポートされているすべてのパラメータのリストについては user.properties を参照してください。

4. (省略可能) Collector を root 以外のユーザとして実行したい場合は、実行するユーザを設定します。「Collector を実行するユーザの設定」を参照してください。
5. (Fed デプロイの Collector バージョン 19.253-3 以降では省略可能) FIPS 140-2 準拠の Java Cryptography Extension (JCE) を有効にして、US1 の Sumo Logic の Fed デプロイへのデータのみを暗号化します。これ以外のデプロイでは、FIPS モードはサポートされません。Fed デプロイを使用しているかどうかわからない場合は、デプロイを確認してください。 
   
   これを有効にするには、Collector のインストール ディレクトリの /script の下にあるスクリプト configureFipsMode.sh を探して実行します。
   
   $ sh ./script/configureFipsMode.sh
6. 次のコマンドで Collector を起動します。

   sudo service collector start

バイナリ パッケージを使用したインストール

1. 使用する JRE のバージョンを次の場所からインストールします。(Collector は Java 8 以降を必要とします。)バイナリ インストール プロセスでは、JRE はインストールされません。

   https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html

2. Java のバージョンが 8 以降であることを確認します。

   java -version

3. ダウンロードしたバイナリ ファイルを希望するインストール先ディレクトリに展開して「sumocollector」というサブディレクトリを作成します。

   tar -xvf SumoCollector_unix_XXX.tar.gz

4. プラットフォーム固有のラッパー ファイルを sumocollector ディレクトリにコピーします。

   cp tanuki/wrapper-<platform> .

5. wrapper、collector、および script ディレクトリ ファイルが実行可能であることを確認します。

   chmod ug+x wrapper-<platform>
chmod ug+x collector
chmod ug+x script/*

6. config ディレクトリに user.properties ファイルを作成し、インストール時に指定したい設定を追加します。
   
   このサンプル user.properties ファイルは、アクセス ID と鍵による認証を使用した登録と起動のための基本設定を定義しています。

   name = My Collector
accessid = [accessId]
accesskey = [accessKey]
wrapper.java.command = java

   ファイルに追加できるすべてのパラメータのリストについては user.properties を参照してください。

7. sumocollector ディレクトリのファイルに対してアクセス制御を設定します。

   sudo script/secureFiles.sh

8. (省略可能) JSON Source 情報を指定します。
   すべての Source 設定は、UTF-8 でエンコードされた JSON ファイルで渡すことができます。JSON ファイルを使用する場合は、Collector を起動する前にファイルを指定する必要があります。「JSON を使用した Source の設定」を参照してください。

   もしくは、Sumo Web アプリケーションを使用して Source をいつでも設定することができます。「Source」を参照してください。

9. (省略可能) Collector を root 以外のユーザとして実行したい場合は、実行するユーザを設定します。「Collector を実行するユーザの設定」を参照してください。
10. (Collector バージョン 19.253-3 以降では省略可能) FIPS 140-2 準拠の Java Cryptography Extension (JCE) を有効にしてデータを暗号化します。これを有効にすると、Collector を 19.253-3 より前のバージョンにダウングレードできなくなります。
    
    これを有効にするには、Collector のインストール ディレクトリの /script の下にあるスクリプト configureFipsMode.sh を探して実行します。
    
    $ sh ./script/configureFipsMode.sh
     
11. Collector をサービスとしてインストールします。
    マシンの起動時に起動するサービスとして Collector をインストールするには、次のコマンドを使用します。

    sudo ./collector install

12. Collector サービスを起動します。
    次のコマンドを使用して Collector サービスを起動します。

    sudo ./collector start

13. Collector がインストールされていることを確認するには、Sumo Web アプリケーションで [Manage Data (データの管理)] > [Collection (コレクション)] > [Collection (コレクション)] に移動して、Collector が表示されることを確認します。

UI インストーラを使用したアンインストール

1. システムの Applications フォルダで「Sumo Logic Collector」というフォルダを探します。
2. 「Sumo Logic Collector Uninstaller」というファイルをダブルクリックします。
3. 言語の選択を促されたら、言語を選択して [OK] をクリックします。
4. システムのユーザ名とパスワードを入力します。
5. Sumo Logic Collector アンインストール ウィザードが表示されたら、[Next (次へ)] をクリックして Collector を削除します。
6. 成功メッセージが表示されたら、[Finish (完了)] をクリックします。

コマンド ラインを使用したアンインストール

1. ターミナル プロンプトで、Collector のインストール ディレクトリに移動します。デフォルトでは、Collector は /opt/SumoCollector または /usr/local/SumoCollector にインストールされます。

   cd /usr/local/SumoCollector

2. uninstall バイナリを -q オプションで実行します。-q オプションは、以降の指示を表示せずにコマンドを実行します。

   sudo ./uninstall -q

RPM/Debian パッケージを使用したアンインストール

RPM パッケージの場合は以下のコマンドを使用します。

sudo rpm -e SumoCollector

Debian パッケージの場合は以下のコマンドを使用します。

sudo dpkg -r SumoCollector

バイナリ パッケージを使用したアンインストール

1. Collector サービスをアンインストールします。

   sudo <Collector Installation Directory>/collector remove

2. Collector のインストール ディレクトリを削除します。

   sudo rm -rf <Collector Installation Directory>

3. (省略可能) Ubuntu など、一部のディストリビューションでは Collector を再びインストールする前にデーモンの設定を再同期させる必要があります。

   sudo systemctl daemon-reload

Web アプリケーションからの Collector の削除 

1. Sumo Logic で [Manage Data (データの管理)] > [Collection (コレクション)] > [Collection (コレクション)] を選択します。
2. 削除したい Collector を探して、[Delete (削除)] をクリックします。
3. 確認ダイアログが表示されたら [OK] をクリックします。

成功メッセージが表示され、Collector がリストから削除されます。