メイン コンテンツをスキップする 補完的コンテンツへスキップ
Qlik リソース

トラブルシューティング Direct Access gateway

このセクションでは、Direct Access gateway のトラブルシューティングで実行できるさまざまなアクションについて説明します。

ログ ファイルの表示とダウンロード

ログ ファイルは、Direct Access gateway 操作の情報を提供します。Qlik サポートは、トラブルシューティングの目的でログ ファイルの提供を依頼する場合があります。ログ ビューアでログ ファイルを表示したり、ダウンロードしたりできます。通常の状況下では、ログ ファイルを確認する必要はありませんが、失敗が繰り返されたり、その他の問題が発生したりした場合に、ログ ファイルは原因を特定する助けになります

情報メモログの表示とダウンロードには、[データ消費可能] の役割が必要です。

ログ ビューアを開くには、

  1. 管理コンソール で、[データ ゲートウェイ] に移動し、Direct Access gateway を検索します。

  2. 行の最後で をクリックし、[ログを表示] を選択します。

    [ログ ビューア] ウィンドウが開きます。

  3. 左上のドロップダウン リストから、Qlik サポートが表示またはダウンロードするように依頼したログのタイプを選択します。

    次のログを使用できます。

    • Direct Access gateway のログ (DirectAccessAgent)
    • DCaaS のログ (dcaas_logs)
    • ODBC ベースのコネクタのログ (odbc-connector_logs)
    • SAP BW コネクタのログ (QvSAPBwConnector-<date + timestamp>)
    • SAP SQL コネクタのログ (QvSqlBwConnector-<date + timestamp>)
    • コネクタ エージェントのログ (connector-agent_logs_<date>)

  4. 隣接するドロップダウン リストから、表示またはダウンロードするログを選択します。ログ ファイルは、最新のファイル (現在アクティブのログ ファイル) から降順に並べ替えられます。ログ ファイルを選択した後、 と ボタンを使用してログ ファイルの最初または終わりに移動します。

    ヒント メモログ ファイルのビューは、最新のメッセージで自動的に更新されません。ビューを更新するには、 をクリックして、最新のメッセージで更新されたログ ファイルの最後まで移動します。

  5. ログ ファイルをダウンロードするには、[ダウンロード] をクリックします。

    ブラウザの設定により、ファイルがコンピュータにダウンロードされるか、保存するように促すメッセージが表示されます。

Direct Access gateway マシンで Direct Access gateway ログを開く

Direct Access gateway (DirectAccessAgent) のログは 管理コンソール からダウンロードできるだけでなく、Direct Access gateway マシンから直接開くこともできます。既定のインストールでは、これらのログの場所は次の通りです。

C:\Program Files\Qlik\ConnectorAgent\data\logs

ログ詳細レベルの変更

必要に応じて、Direct Access gateway (DirectAccessAgent) ログのログ詳細レベルを表示および変更できます。実行するには、ConnectorAgent サブフォルダー (既定のインストールの場合は C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) から次のコマンドを実行します。

  • 現在のログ レベルを表示するには、次を実行します。

    connectoragent configuration getloggers

  • ログ レベルを Trace に設定するには、次を実行します。

    connectoragent configuration setloggers -l Root -v DEBUG

  • ログ レベルを Verbose に設定するには、次を実行します。

    connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

登録キーの更新

まれですが、登録キーが破損した場合や、データゲートウェイサーバーが不正にアクセスされたと思われる場合は、登録キーの変更が必要な場合があります。

登録キーを更新するには:

  1. Direct Access ゲートウェイ サーバーで、コマンド プロンプトを開いて、ConnectorAgent サブフォルダーの作業ディレクトリ (デフォルト インストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) を変更します。

  2. 次のコマンドを実行します。

    • 新規キーを生成します。

      connectoragent qcs generate_keys

    • キーを表示します。

      connectoragent qcs get_registration

      キーが表示されます。

  3. 上の例のように、キー全体をコピーします。

  4. 管理コンソール で、関連する行の終わりにある [] ボタンをクリックして、[編集] を選択することにより、データ ゲートウェイ設定を開きます。

  5. キーを [キー] フィールドに貼り付けて (現在のキーを置換する)、設定を保存します。

  6. Direct Access ゲートウェイ サーバーに戻り、「Qlik Data Gateway - 直接アクセス サービスの管理」の説明に従って Qlik Data Gateway - 直接アクセス サービスを再起動します。

リロード中のコネクタのクラッシュを軽減する

プロセス分離により、ゲートウェイ サーバー オペレーティング システムに直接アクセスできる管理者は、コネクタ タイプごとにリロードに使用できるプロセスの数を制御できます。リロードを複数のコネクタ プロセスに分散すると、各コネクタ プロセスで同時に実行されるリロードの数が減り、分離レベルが高まります。これにより、コネクタのクラッシュが発生した場合の Direct Access gateway 全体の安定性が向上します。

情報メモ

Direct Access gateway 1.6.1 以降が必要です。

プロセス分離をオンにするには:

  1. C:\ProgramData\Qlik\Gateway\configuration.properties ファイルを開きます。Windows エクスプローラーで実行する場合は、 [非表示のファイル、フォルダー、ドライブを表示する] が選択されていることを確認してください。

    このファイルには、さまざまなコネクタ タイプに対応する 3 つのプレフィックス (ODBC_<property-name>、SAPBW_<property-name>、SAPSQL_<property-name>) が含まれています。

  2. ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE を [ロード] に設定し、ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT を [N] に設定します。

    条件:

    N = 1 つのコマンド プロセス + 割り当てる同時リロード プロセスの数。例として、10 という値は、最大 9 回の同時リロードを意味します。

    情報メモ

    既定のポート番号と範囲設定では、[ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT 値を 10 より大きく設定することはできません。

  3. configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセス サービスを再起動します。

プロセス分離をオフにするには:

  1. C:\ProgramData\Qlik\Gateway\configuration.properties ファイルを開きます。Windows エクスプローラーで実行する場合は、 [非表示のファイル、フォルダー、ドライブを表示する] が選択されていることを確認してください。

  2. ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE を [None] (なし) に設定します。

  3. configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセス サービスを再起動します。

ODBC コネクタのプロセス分離の例

次の configuration.properties ファイルの抜粋は、最大 9 回のリロードに対して ODBC コネクタのプロセス分離を有効にする方法を示しています。

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

既定のポート設定を変更すると、MAX_PROCESS_COUNT 値が 10 を超える可能性があります。ただし、このケースでは次のようになります。

  • ODBC_PORT または ODBC_DATA_PORT_RANGE_START と SAPBW_PORT または SAPBW_DATA_PORT_RANGE_START の間のポートの数は ODBC_MAX_PROCESS_COUNT 以上である必要があります

  • SAPBW_PORT または SAPBW_DATA_PORT_RANGE_START と SAPSQL_PORT または SAPSQL_DATA_PORT_RANGE_START の間のポートの数は SAPBW_MAX_PROCESS_COUNT 以上である必要があります

例として、ODBC_MAX_PROCESS_COUNT=30 を設定する場合、ポート パラメーターは次のようになります。

# ODBC Connector

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=30

ODBC_DATA_PORT_RANGE_START=50260

ODBC_PORT=3005

# SAP BW Connector

SAPBW_PROCESS_ISOLATION_MODE=None

SAPBW_MAX_PROCESS_COUNT=0

SAPBW_DATA_PORT_RANGE_START=50290

SAPBW_PORT=3035

# SAP SQL Connector

SAPSQL_PROCESS_ISOLATION_MODE=None

SAPSQL_MAX_PROCESS_COUNT=0

SAPSQL_DATA_PORT_RANGE_START=50300

SAPSQL_PORT=3045

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください