# Qlik Data Gateway - 直接アクセス サーバーの管理

このセクションでは、Qlik Data Gateway - 直接アクセス のインストール後に使用できるさまざまな接続および管理オプションについて説明します。

## プロキシ サーバー経由で Qlik Cloud に接続する

初期設定時にプロキシ接続を設定していない場合、後で以下のコマンドを実行することにより設定できます。また、同じコマンドを実行して、既存のプロキシ サーバー設定を編集することもできます。

### 制限と考慮事項

* HTTP プロキシ スキーマのみがサポートされています。

* (コンテンツ検査やその他のセキュリティ対策のため) SSL 接続を遮断するように設定されたプロキシサーバーはサポートされていません。

* HTTPS に加えて、Direct Access ゲートウェイでは WSS (WebSocket Secure) プロトコルも使用します。そのため、ファイアウォールとプロキシ サーバー (使用する場合) がアウトバウンド WSS 接続を許可するように設定されていることを確認する必要があります。

### プロキシ サーバー接続を有効にする

プロキシ サーバーは次の手順で有効化または編集できます。

1. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     管理者として、コマンド プロンプトを開いて、ConnectorAgent サブフォルダーの作業ディレクトリ (デフォルト インストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) を変更します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナ内でコンソールを開きます。

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

   * Windows サーバーのインストール:

     * 構文:connectoragent qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * 例: connectoragent qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

   * コンテナ化されたインストール:

     * 構文:dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * 例: dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

3. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     「Qlik Data Gateway - 直接アクセス」の説明に従って [Qlik Data Gateway - 直接アクセス サービスの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) サービスを再起動します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナを再起動します。

### プロキシ サーバー接続を無効にする

プロキシ サーバーは次の手順で無効化できます。

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

2. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     管理者として、コマンド プロンプトを開いて、ConnectorAgent サブフォルダーの作業ディレクトリ (デフォルト インストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) を変更します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナ内でコンソールを開きます。

3. 次のコマンドを実行します:

   connectoragent qcs set\_config --proxy\_url ""

   * Windows サーバーのインストール:

     connectoragent qcs set\_config --proxy\_url ""

   * コンテナ化されたインストール:

     dotnet ConnectorAgent.dll qcs set\_config --proxy\_url ""

4. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     「Qlik Data Gateway - 直接アクセス」の説明に従って [Qlik Data Gateway - 直接アクセス サービスの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) サービスを再起動します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナを再起動します。

## Qlik Cloud テナント URL の更新

必要に応じて、Qlik Cloud テナント URL を変更できます。

これを実行するには、次の手順に従います。

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

2. インストール ワークフローに応じて、次のいずれかのコマンドを実行します。

   * Windows サーバーのインストール:

     * 構文:connectoragent qcs set\_config --tenant\_url URL

     * 例: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

   * コンテナ化されたインストール:

     * 構文:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

     * 例: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

3. 「Qlik Data Gateway - 直接アクセス」の説明に従って [Qlik Data Gateway - 直接アクセス サービスの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) サービスを再起動します。

情報メモQlik Cloud テナント URL の更新は、[ステージ 2: Direct Access gateway のインストールまたは展開](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) の説明に従って新しい登録キーを生成する (さらに [ステージ 4：データゲートウェイの登録](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4) で説明されているように登録する) 必要もあります。

## 現在の Direct Access ゲートウェイ サーバー設定の表示

現在の Direct Access gateway サーバー設定を表示できます。

これを実行するには、次の手順に従います。

1. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

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

   * コンテナ化されたインストール:

     direct-access-agent コンテナ内でコンソールを開きます。

2. インストール ワークフローに応じて、次のいずれかのコマンドを実行します。

   * Windows サーバーのインストール:

     connectoragent qcs set\_config --tenant\_url URL

   * コンテナ化されたインストール:

     dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

   現在の設定が表示されます。

   ```
   connector-agent starting....
   --tenant_url "elastic.example"
   --proxy_url ""
   --proxy_username ""
   DirectAccessAgent Control Program completed successfully.
   ```

## Qlik Data Gateway - 直接アクセス サービスの管理

情報メモWindows サーバーのインストールにのみ適用されます。

Direct Access ゲートウェイ サーバーの設定を変更した後、Qlik Data Gateway - 直接アクセス サービスを再起動する必要があります。また、異なるアカウントでサービスを実行することもできます。

### サービスの起動、停止、または再起動

Direct Access ゲートウェイ サーバーで、次のいずれかを実行してサービスを停止、起動、または再起動します。

* 必要に応じて、Windows Services コンソールを開き、Qlik Data Gateway - 直接アクセス サービスを停止、起動、または再起動します。

* 管理者として、コマンド プロンプトを開いて、ConnectorAgent サブフォルダーの作業ディレクトリ (デフォルト インストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) を変更します。次に、下記のコマンドを実行します。

  connectoragent service stop

  サービスが正常に停止したことを伝える確認メッセージが表示されます。

  connectoragent service start

  サービスが正常に起動したことを伝える確認メッセージが表示されます。

### 異なるアカウントでサービスを実行する

既定で、Qlik Data Gateway - 直接アクセス サービスはローカル システムのアカウントで実行されます。異なるアカウントでサービスを実行するには、Windows Services コンソールで Qlik Data Gateway - 直接アクセス を右クリックし、[ログオン] タブを選択します。次に、[このアカウント] を選択してからアカウント詳細を入力します。完了したら、設定を保存してからサービスを再起動します。

## 利用可能なコマンド カテゴリ

利用可能なコマンド カテゴリの一覧を表示するには:

1. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     管理者としてコマンド プロンプトを開き、作業ディレクトリを ConnectorAgent サブフォルダー (デフォルトのインストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) に変更します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナ内でコンソールを開きます。

2. インストール ワークフローに応じて、次のいずれかのコマンドを実行します。

   * Windows サーバーのインストール:

     connectoragent help

   * コンテナ化されたインストール:

     dotnet ConnectorAgent.dll help

次のリストが表示されます。

* service - 上記の「Qlik Data Gateway - 直接アクセス サービスの管理」を参照してください。

* qcs - サービス コマンドを除く、すべての文書化されたコマンドの前に置く必要があります。

  例 (Windows サーバーのインストール):

  connectoragent qcs show\_config

  例 (コンテナ化されたインストール):

  dotnet ConnectorAgent.dll qcs show\_config

* setup - サポート目的のみ。

* repository - サポート目的のみ。

* configuration - サポート目的のみ。