Skip to main content
Data Infrastructure Insights
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Acquisition Unitソフトウェアを手動でインストールする

共同作成者

デフォルトでは、Data Infrastructure Insightsは、更新が導入されるとAcquisition Unit(AU)ソフトウェアを自動的に更新します。ただし、安全に管理された環境では、自動更新が不可能または望まれない場合があります。このような場合は、AUソフトウェアを手動で更新するようにData Infrastructure Insightsを設定して、環境にインストールされているソフトウェアをより細かく制御できます。

AUソフトウェアを手動でダウンロードしてインストールするには、次の手順に従います。Data Infrastructure Insightsには、これらの手順の多くに役立つSwaggerのドキュメントページが用意されています。また、独自のAPIスクリプト/コマンドを使用することもできます。[Admin]>[API Access]に移動し、[API Documentation]リンクをクリックします。

このプロセスは、LinuxとWindowsで同様です。

Linuxでの新規AUインストールの実行:

  1. Data Infrastructure Insightsで、APIトークンを作成します。

    1. [Admin]>[API Access]に移動し、[+API Access Token]*を選択します。

      1. 識別しやすい* Name *と*概要*を設定します

      2. タイプ:[Acquisition Unit]および[Data Collection]を選択します。

      3. 権限:読み取り/書き込み

      4. 目的の*有効期限*および*自動更新*の値を選択します

    2. [ 保存( Save ) ] をクリックします。

    3. 生成されたAPIアクセストークンをコピーします。この手順は、ウィンドウを閉じる前に実行する必要があります。

APIトークンの作成

  1. Swagger([Admin]>[API Access]>[API Documentation])で、トークンを使用してData Infrastructure Insights APIを許可

    1. Swagger画面の右上にある[_Authorize]をクリックします

    2. 上からコピーしたトークンを[Customer apiKey]フィールドに貼り付けます

    3. [承認]*をクリックします

    4. ウィンドウを閉じます

APIトークンを承認する

  1. 次の_/au/installers/{platform}/latest_or_/au/installers/{platform}/{version}_apiを使用してAUインストーラをダウンロードします。

    1. プラットフォーム:* Linux *

    2. バージョン:<version>(最新または指定)

最新のAUバージョンを取得するAPI

メモ 最新バージョンをダウンロードしない場合は、NetAppでダウンロードするAUバージョンを確認してください。
  1. [ファイルのダウンロード]*をクリックします。AUシステム以外のシステムでこれらの手順を実行する場合は、ダウンロードしたファイルをAUシステムにコピーします。

  2. また、AUシステムでcurlコマンドを実行することもできます。

     curl -X GET "<tenant>/rest/v1/au/installers/linux/<AU version>" -H "accept: application/octet-stream" -H "X-CloudInsights-ApiKey: <token>"
    . この時点で、インストーラファイルがAUシステムに存在している必要があります。
重要 次の手順では、一時トークンを使用する必要があります。上記で作成したAPIアクセストークンは使用しないでください。
  1. Data Infrastructure Insights API Swaggerで、_/ au/oneTimeToken_APIを使用してワンタイムトークンを作成します。

    1. 結果のワンユーストークンをコピーします。

ワンタイム使用APIトークンの作成
ワンタイム使用APIトークンの応答例

  1. AUをインストールするマシンで、ダウンロードしたインストーラファイルが格納されているフォルダに移動します。次のコマンドを実行するには、ユーザにroot権限が必要です。

    1. インストーラファイルを解凍します

    2. 作成されたインストーラフォルダにディレクトリを変更します

    3. 次のコマンドを実行して、ワンタイムトークンとインストーラのバージョンを環境変数にエクスポートします。

       export TOKEN=<One-Time Token>
      .. 次のコマンドを実行して、カスタムのユーザとグループを指定してCIをインストールします。
      ./cloudinsights-install.sh <custom user> <custom group>

      注:カスタムのユーザおよびグループを使用しない場合は、デフォルトの「cisys」ユーザおよびグループを使用できます。 この場合は、上記のinstallコマンドを実行しますが、ユーザとグループは指定しません。

この時点で、AUソフトウェアがシステムにインストールされ、カスタムユーザおよびグループからアクセスできます。ただし、データコレクタを追加することはできません。これを手動で行うには、次の手順をお読みください。パッチのみをインストールする場合は、 パッチ セクションを参照してください。

データコレクタの手動インストール

/collector/patch/datasourceswar/latest APIを使用して、最新のdatasources.warをダウンロードします。

最新のdatasources.warを取得するAPI

注:最新バージョンをダウンロードしていない場合は、NetAppでダウンロードするバージョンを確認してください。

Download Fileをクリックします。AUシステム以外のシステムでこれらの手順を実行する場合は、ダウンロードしたdatasources.war zipバンドルをAUシステムにコピーします。

datasources.war zipバンドルが次のディレクトリにコピーされていることを確認します。/var/lib/netapp/cloudinsights/acq/download

datasources.warの/var/lib/netapp/cloudinsights/acq/downloadディレクトリに移動し、zipファイルを確認します。

  1. 次の手順では、カスタムユーザに切り替える(またはrootからログアウトしてからログインする)必要があります。

    su <custom user>

    注:デフォルトの「cisys」ユーザおよびグループを使用している場合は、この手順を実行する必要はありません。

    注:カスタムユーザーには、AUのインストール時にcloudinsights-install.shに提供したカスタムグループのメンバーである任意のユーザーを指定できます。また、AUのインストール時に指定したカスタムユーザーと同じユーザーまたは異なるユーザーを指定できます。

  2. 次の手順を実行します。

    chmod 770 /var/lib/netapp/cloudinsights/acq/download/datasources-war-<version>.zip
    ls -al /var/lib/netapp/cloudinsights/acq/download
    …
    drwxrwx--- 2 test-user2 test-group-1  4096 Feb 16 10:10 datasources-war-<version>.zip
    …

    注:「cisys」ユーザおよびグループを使用している場合は、上記の出力に表示されます。

    注:別のカスタムユーザーを使用してをインストールする場合は、所有者とグループの両方に対して、グループ権限が読み取りと書き込みに設定されていることを確認してください(chmod 660…)。

  3. AUを再起動します。Data Infrastructure Insightsで、[Observability]>[Collectors]に移動し、[Acquisition Units]タブを選択します。AUの右側にある「Three Dots」メニューから「Restart」を選択します。

パッチのダウンロード

/collector/patch/file/{version}APIを使用してパッチをダウンロードします。

パッチを取得するAPI

注:ダウンロードするバージョンをNetAppで確認してください。

Download Fileをクリックします。AUシステム以外のシステムでこれらの手順を実行する場合は、ダウンロードしたパッチzipバンドルをAUシステムにコピーします。

パッチzipバンドルが次のディレクトリにコピーされていることを確認します。/var/lib/netapp/cloudinsights/acq/download

パッチの/var/lib/netapp/cloudinsights/acq/downloadディレクトリに移動し、.zipファイルを確認します。

  1. 次の手順では、カスタムユーザに切り替える(またはrootからログアウトしてからログインする)必要があります。

    su <custom user>

    注:デフォルトの「cisys」ユーザおよびグループを使用している場合は、この手順を実行する必要はありません。

    注:カスタムユーザーには、AUのインストール時にcloudinsights-install.shに提供したカスタムグループのメンバーである任意のユーザーを指定できます。また、AUのインストール時に指定したカスタムユーザーと同じユーザーまたは異なるユーザーを指定できます。

  2. 次の手順を実行します。

    chmod 770 /var/lib/netapp/cloudinsights/acq/download/<patch_file_name>.zip
    ls -al /var/lib/netapp/cloudinsights/acq/download
    …
    drwxrwx--- 2 test-user2 test-group-1  4096 Feb 16 10:10 <patch_file_name>.zip
    …

    注:「cisys」ユーザおよびグループを使用している場合は、上記の出力に表示されます。

    注:別のカスタムユーザーを使用してをインストールする場合は、所有者とグループの両方に対して、グループ権限が読み取りと書き込みに設定されていることを確認してください(chmod 660…)。

  3. AUを再起動します。Data Infrastructure Insightsで、[Observability]>[Collectors]に移動し、[Acquisition Units]タブを選択します。AUの右側にある「Three Dots」メニューから「Restart」を選択します。

外部キーの取得

UNIXシェルスクリプトを指定すると、Acquisition Unitによって実行され、キー管理システムから*秘密鍵*と*公開鍵*を取得できます。

キーを取得するために、Data Infrastructure Insightsはスクリプトを実行し、_key id_と_key type_の2つのパラメータを渡します。キーID _は、キー管理システム内のキーを識別するために使用できます。_Key type _には、「public」または「private」を指定します。キータイプが「public」の場合、スクリプトは公開鍵を返す必要があります。キータイプが「private」の場合は、秘密鍵を返す必要があります。

Acquisition Unitにキーを戻すには、標準出力にキーを出力する必要があります。スクリプトは、標準出力にキーをprint_only_theで出力する必要があります。他のテキストは標準出力に出力しないでください。要求されたキーが標準出力に出力されると、スクリプトは終了コード0で終了する必要があります。その他の戻りコードはエラーと見なされます。

スクリプトはSecurityAdminツールを使用してAcquisition Unitに登録する必要があります。このツールでは、Acquisition Unitとともにスクリプトが実行されます。スクリプトには、rootおよび"cisys"ユーザに対する_read_and_execute_permissionが必要です。登録後にシェルスクリプトを変更した場合は、変更したシェルスクリプトをAcquisition Unitに再登録する必要があります。

入力パラメータ:キーID

顧客のキー管理システムでキーを識別するために使用するキー識別子。

入力パラメータ:キータイプ

パブリックまたはプライベート。

出力

要求されたキーを標準出力に出力する必要があります。現在、2048ビットRSAキーがサポートされています。キーは次の形式でエンコードおよび印刷する必要があります-

秘密鍵形式- PEM、DERエンコードPKCS8 PrivateKeyInfo RFC 5958

公開鍵形式- PEM、DERエンコードX.509 SubjectPublicKeyInfo RFC 5280

終了コード

成功のためのゼロの終了コード。他のすべての終了値は失敗と見なされます。

スクリプト権限

スクリプトには、rootおよび「cisys」ユーザに対する読み取りおよび実行権限が必要です。

ログ

スクリプトの実行が記録されます。ログは次の場所にあります。

/var/log/netapp/cloudinsights/securityadmin/securityadmin.log

/var/log/netapp/cloudinsights/acq/acq.log