SQL DIのインストール、設定、起動

SQL Data Insights ( SQL DI ) のインストールと構成には、一連のガイド付きタスクが含まれます。 まず、 SMP/E プログラムを使用して、SQL DI ベース製品をインストールし、最新のメンテナンス(APARs/PTFs)を適用します。 次に、シェルスクリプトを実行して、SQL DIアプリケーションを対話型またはサイレントで構成します。 アプリケーションを起動した後、 SQL DI ウェブユーザーインターフェース (UI)、REST API、またはシェルコマンドラインインターフェース(CLI)を使用して、インストールと設定を確認するための簡単なタスクを実行できます。

始める前に

プロシージャー

  1. SQL DI プログラムディレクトリと関数コードパッケージを Z システムに転送します。
  2. プログラムディレクトリ内の指示に従って、 SQL DI をインストールし、修正を適用します。

    SMP/E プログラムは、 $SQLDI_INSTALL_DIR ディレクトリに SQL DIをインストールします。 デフォルトの$SQLDI_INSTALL_DIRディレクトリーは/usr/lpp/IBM/db2sqldi/です。

  3. すべてのファンクションコードパッケージに対して、 SMP/E が正常に実行されたことを確認してください。
  4. SQL DI の設定ファイルとログファイルを保存するために、 SQLDI_HOME ディレクトリを別途作成し、最低 100 GB の空きディスク容量を確保してください。
  5. SQL DIアプリケーションを対話型またはサイレントで構成します。
    インタラクティブモードでは、 SQL DI を設定するためのシェルスクリプトを起動し、画面上の指示に従って、ガイド付き設定が完了するまで、要求された入力を1つずつ入力します。 一方、サイレントモードでは、構成テンプレートファイルにすべての事前定義済みパラメータの情報を入力し、提供されたシェルスクリプトを実行し、カスタマイズされた構成ファイルを入力として指定します。
    SQL DI をインタラクティブモードで設定するには:
    1. bashセッションで、 $SQLDI_INSTALL_DIR/sql-data-insights/bin ディレクトリに変更します。
    2. 次のコマンドを発行して、SQL DI 構成スクリプトを実行します。
      ./sqldi.sh create
    3. 各プロンプトに対して、要求された情報を入力するか、デフォルト値を受け入れることで応答します。
      • SQLDI_HOME ディレクトリに、 SQL DI 構成ファイルとログファイルが保存されるようにします。
      • SQL DI アプリケーションの IP アドレスまたはホスト名を入力します。
      • SQL DI アプリケーションのポート番号を入力するか、デフォルトポートの 15001 を使用するには、Enterキーを押します
      • SQL DI ログイングループの名前を入力するか、デフォルトのグループ名 SQLDIGRP を使用するには、Enter キーを押します
      • SQL DI 認証トークンの最大有効時間(時間)を入力するか、 Enter キーを押してデフォルト値 168 を使用します。
      • 鍵ストア情報を入力します。
        SQL DI には、以下のいずれかのキーストアが必要です。
        1. JCERACFKS ( RACF® 証明書と鍵の管理用)
        2. JCECCARACFKS ( RACF 証明書と鍵の管理とハードウェア暗号化の利用)

        鍵ストア・タイプを選択してから、鍵リング名、鍵リング所有者、および SSL 証明書のラベルを入力します。

      • Spark マスターのIPアドレスまたはホスト名を入力してください。
      • Spark マスターのポート番号を入力するか、 7077 のデフォルトポートを使用するには Enter キーを押します
      • Spark マスターREST APIのポート番号を入力するか、 6066 のデフォルトポートを使用するにはEnterキーを押します
      • Spark マスターウェブ UI のポート番号を入力するか、 Enter キーを押してデフォルトのポート 8080 を使用します。

        Apache Spark は、 Spark クラスタのステータスとリソース消費を監視するための、マスタ Web UI とワーカ Web UI を含む一連の Web UI を提供します。 必要に応じて、これらのUIの設定と使用方法については、 Spark Webインタフェースを参照してください。

      • Spark ワーカーのポート番号を入力するか、Enterキーを押してシステム割り当てのポートを使用します。
      • Spark ワーカーのウェブ UI のポート番号を入力するか、 8081 のデフォルトポートを使用するには Enter キーを押します
      • Spark ドライバーのポート番号を入力するか、Enterキーを押してシステム割り当てのポートを使用します。
      • Spark ブロックマネージャのポート番号を入力するか、Enterキーを押してシステム割り当てのポートを使用します。
      • Spark ブロックマネージャがリスンするドライバ固有のポートを入力するか、デフォルトとしてシステム割り当てのポートを使用するにはEnterキーを押します
      • ポートにバインドするときの再試行の最大回数を入力するか、Enter を押してデフォルトの回数16を使用します。

        インストール・プロセスは続行されます。 完了すると、以下の例のようなメッセージが表示されます。

        Congratulations! You have successfully configured SQL Data Insights.
      • SQL DI を自動的に開始するかどうかを確認または拒否します。 確認すると、現在のコマンドプロセスは SQL DIを自動的に開始します。 拒否する場合は、 ステップ6で手動で SQL DI を開始します。
    サイレントモードで SQL DI を設定するには:
    1. bashセッションで、 $SQLDI_INSTALL_DIR/templates ディレクトリに変更します。
    2. install_file.template ファイルをコピーしてカスタマイズし、必要なコマンド入力ファイルを作成します。
      手順については、 SQL DIシェルコマンドの入力ファイルの作成および SQL Data Insights設定、管理、オブジェクトモデル管理のシェルコマンドを参照してください。

      対話型モードの場合と同様に、 SQL DIは、設定が完了すると自動的にサイレントモードでアプリケーションを起動します。 SQL DI を自動的に開始したい場合は、 START_SERVICE プロパティを Y に設定します。 それ以外の場合は、デフォルトの START_SERVICE=N 設定を維持し、 ステップ6でアプリケーションを手動で起動できるようにします。

    3. $SQLDI_INSTALL_DIR/sql-data-insights/bin ディレクトリに変更します。
    4. sqldi.sh スクリプトを create コマンドで呼び出すことで、サイレントモードで SQL DI構成を有効にします。

      入力ファイル sqldi_silent_cfg_input を作成し、 START_SERVICE=N を指定したと仮定します。 create コマンドを、 -s オプション付きで、以下のように発行します

      ./sqldi.sh create -s sqldi_silent_cfg_input

      設定プロセスは静かに実行されます。 完了すると、以下の例のようなメッセージが表示されます。

      Congratulations! You have successfully configured SQL Data Insights.
  6. 次のコマンドを発行して、SQL DIアプリケーションを起動します。
    ./sqldi.sh start

    次の例のようなメッセージが表示された場合、SQL DI は正常に開始されました

    SQL Data Insights will use SQLDI_HOME to store configuration files and logs.
    Bash version is 5.2.15
    Starting SQL Data Insights ...
    Reading configurations ...
    Generating required configuration files ...
    Launching SQL Data Insights ...
    
    .............
    
    SQL Data Insights is successfully started.
    
    You can access it at https://<SQLDI-IPAddress>:<SQLDI-PortNumber>

    説明:

    • SQLDI-IPAddress は、設定時に入力したIPアドレス、または SQL DIサーバーのデフォルトとして承認したIPアドレスです。 この URL をメモして、ユーザーに配布します。
    • SQLDI-PortNumber は、構成時に入力したポート番号、または SQL DIサーバーのデフォルトとして承認したものです。
  7. SQL DIアプリケーションが起動して稼働していることを確認します。

    アプリケーションにログインするか、ウェブ UI、REST API、またはシェル CLI を使用して簡単なタスクを実行することで、SQL DI が動作しているかどうかを確認できます。 Web UI を使用してインストールと構成を確認する方法の例については、「Web UI を使用して SQL DI のインストールと構成を確認する」を参照してください。