# Data Movement gateway の設定

Data Movement gateway を設定するには、管理 サーバーと Data Movement gateway サーバーの両方で実行する必要がある手順が関与します。

情報メモ

* すべての CLI コマンドは、Data Movement gateway サーバーで実行する必要があります。

* インストール (RPM) およびサービス コマンドは、sudo または root として実行する必要があります。

* 管理 で実行する必要がある Data Movement gateway 手順には、テナント管理者の権限が必要です。

  参照先: [データ ゲートウェイをスペースと関連付ける際の注意事項](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-setting-up.htm#Consider)

ナレッジ マートの使用については、「[ナレッジマート用の Qlik データ ゲートウェイ - データ移動 の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/gateways-for-knowledge-mart.htm)」を参照してください。

## ステージ 1: Data Movement gateway をダウンロードする

1. データ ゲートウェイにアクセスするには、ランチャー メニュー (the Administration icon) から を選択し、[データ ゲートウェイ] を選択します。

   既存のすべてのデータ ゲートウェイが、[各ゲートウェイに関する基本情報を表示するテーブル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)にリストされます。

2. [展開] ツール バー ボタンをクリックします。

3. データ ゲートウェイ - データ移動 を選択し、[Qlik 顧客契約] を承認してから [ダウンロード] をクリックします。

   Data Movement gateway RPM (qlik-data-gateway-data-movement.rpm) がマシンにダウンロードされます。

## ステージ 2: Data Movement gateway をインストールしてセットアップする

このステージでは、Data Movement gateway のインストール、Qlik Cloud URL の設定、登録キーの生成を行います。管理 (以下のステージ 3) の Data Movement gateway 設定にキーをコピーする必要があります。キーは、Data Movement gateway と Qlik Cloud テナント間の認証済み接続を確立するために使用されます。

警告メモSELinux が有効なシステムに Data Movement gateway をインストールする場合、既定のインストール パスを使用するのがベストプラクティスです。別のパスを使用する場合は、[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)にお問い合わせください。

1. ダウンロードが完了したら、Data Movement gateway をインストールする Linux マシンに RPM ファイルをコピーします。マシンがファイアウォールの内側にあり、データ ソースおよび Qlik Cloud と通信できることを確認してください。

2. シェル プロンプトを開き、作業ディレクトリを RPM を含むディレクトリに変更します。

   例:

   /qlik/GatewayRPM/

3. 次のコマンドを実行して Data Movement gateway をインストールします。

   構文:

   QLIK\_CUSTOMER\_AGREEMENT\_ACCEPT=yes rpm -ivh gateway-rpm

   例:

   sudo QLIK\_CUSTOMER\_AGREEMENT\_ACCEPT=yes rpm -ivh qlik-data-gateway-data-movement.rpm

   ここで Qlik 顧客契約を表示できます: https://www.qlik.com/us/-/media/files/legal/license-agreements/qlik/qlik-customer-agreement-english.pdf (英語のみ)

4. インストールが完了したら、作業ディレクトリを次のように変更します。

   /opt/qlik/gateway/movement/bin

   次に、下記のコマンドを実行します。

   ### Qlik Cloud テナントとプロキシ サーバーの設定

   情報メモ

   プロキシ経由でクラウド データ ウェアハウスやストレージに接続する必要がある場合は、ランディング設定で関連するオプションがオンになっていることを確認してください。

   * プロキシを使用してクラウド データ ウェアハウスに接続
   * プロキシを使用してストレージに接続

   これらのオプションのいずれもオンになっていない場合、プロキシ接続は Qlik Cloud に対してのみとなります。

   これらのオプションについて詳しくは、「[データ ソースからのランディング データ](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Landing-data-data-sources.htm)」を参照してください。

   次のコマンドを実行して、Qlik Cloud テナント URL と、オプションでプロキシ サーバー URL を設定します。

   プロキシ サーバーなしの Qlik Cloud テナント URL の設定のコマンド:

   構文:

   ./agentctl qcs set\_config --tenant\_url URL

   例:

   ./agentctl qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

   Qlik Cloud テナント URL とプロキシ サーバー URL の設定のコマンド:

   構文:

   ./agentctl qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url https|http://host:port --proxy\_username username --proxy\_password password

   例:

   ./agentctl qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url https://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

   参照先: [Data Movement gateway サーバーの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm)

   ### CA バンドルの設定

   CA バンドルは Qlik Cloud テナントの ID を認証し、信頼できる接続であることを保証します。

   CA バンドルを設定する必要があるのは誰ですか？

   CA バンドルは以下の者のみ設定する必要があります:

   * Qlik Cloud Government 顧客
   * セキュリティ アプライアンスを使用する Qlik Cloud 商用の顧客。これはプロキシのように動作し、インターネットから受け取った証明書情報を自分の CA ルート証明書と置き換えます

   どのバンドルを使用したらよいですか？

   顧客は Qlik CA バンドルを使用するか、以下のような自分の CA バンドルを持参してください:

   * Qlik は CA バンドルを提供します: 標準的な環境の Qlik Cloud Government のユーザーが使用する必要があります。標準環境は、プロキシのように動作し、インターネットから受け取った証明書情報を自分の CA ルート証明書と置き換えるセキュリティ アプライアンスを持たない環境です。

     情報メモCA バンドル ファイルの名前を変更できますが、拡張子が .pem (例: qlikcerts.pem) であることを確認してください。次に、以下のコマンドを実行します。

   * ユーザー独自の CA バンドル: ユーザーの環境で、インターネットから受信した証明書情報を独自の CA ルート証明書に置き換えるプロキシとして機能するセキュリティ アプライアンスを使用している場合に使用する必要があります。それらの証明書が自己署名の場合は、CA バンドルの設定のコマンドの他に、CA バンドルを許可するコマンドも実行する必要があります。これらのコマンドが両方とも下で説明されています。これは Qlik Cloud Government 顧客と Qlik Cloud 商用の顧客の両方に適用されます。

   CA バンドルを設定するためのコマンド

   CA 証明書バンドルを設定するには以下のコマンドを実行します:

   構文:

   ./agentctl qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file

   例:

   ./agentctl qcs set\_config --ca\_bundle\_path /etc/ssl/certs/cacerts.pem

   CA バンドルを許可するためのコマンド

   いくつかの環境では、セキュリティ アプライアンスを使用しています。これはプロキシのように動作し、インターネットから受け取った証明書情報を自分の CA ルート証明書と置き換えます。. このコマンドは、セキュリティ アプライアンス自体が自己署名証明書を使用している場合にのみ実行する必要があります。そのような場合には、以下のコマンドを実行しない限り、CA バンドルが信頼されないかもしれません:

   ./agentctl qcs set\_config --ca\_bundle\_allow\_invalid\_certs true

   情報メモ自分の環境がこのようなセキュリティ アプライアンスを使用しているかどうか分からない場合は、担当の IT 管理者に連絡してください。

   ### 登録キーの生成と表示

   キーは、データ移動ゲートウェイと Qlik Cloud テナント間の認証済み接続を確立するために使用されます。

   次のコマンドを実行して、キーを生成して表示します。

   ./agentctl qcs get\_registration

   キーが表示されます。

   ![Data Movement 登録キーの画像](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/dm_reg_key.png)

5. 上の例のように、キー全体をコピーします。次のステージで Administration に貼り付ける必要があります。

## ステージ 3: 管理 に戻り、Data Movement gateway を登録する

1. データ ゲートウェイにアクセスするには、ランチャー メニュー (the Administration icon) から を選択し、[データ ゲートウェイ] を選択します。

   既存のすべてのデータ ゲートウェイが、[各ゲートウェイに関する基本情報を表示するテーブル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)にリストされます。

2. [作成] をクリックします。

   [データ ゲートウェイの作成] ダイアログが開きます。

   ![データ ゲートウェイ作成ダイアログの画像](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_dm-gate-create.png)

3. Data Movement gateway の名前を指定します。

4. 必要に応じて、Data Movement gateway の説明を入力します。

5. [ゲートウェイ タイプ] ドロップダウン リストから、[データ移動] を選択します。

6. [関連付けられたスペース] ドロップダウン リストから、スペースを選択します。関連項目: [データ ゲートウェイをスペースと関連付ける際の注意事項](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-setting-up.htm#Consider)。

7. 先ほど生成した登録キーを、[キー] 項目に貼り付けます。

8. [作成] をクリックします。

   Data Movement gateway が追加され、データ ゲートウェイ リストに表示されるようになります。

## ステージ 4: Data Movement gateway サーバーで Data Movement gateway サービスを起動する

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

   sudo systemctl start repagent

2. 次のコマンドを実行して、サービスが開始されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: active (running) since <timestamp> ago

   警告メモゲートウェイ サービスを開始したら、ブラウザーを更新して、Administration で更新されたデータ ゲートウェイのステータス (接続済み) を で確認する必要があります。

## ステージ 5: データ プロジェクトで Data Movement gateway データ ソースを使用する

1. データ ゲートウェイにアクセスするには、ランチャー メニュー (the Administration icon) から を選択し、[データ ゲートウェイ] を選択します。

   既存のすべてのデータ ゲートウェイが、[各ゲートウェイに関する基本情報を表示するテーブル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)にリストされます。

2. ブラウザーを更新して、データ ゲートウェイ テーブルが最新であることを確認します。

3. データ ゲートウェイ テーブルでゲートウェイを見つけ、その [状態] が「接続済み」であることを確認します。

Data Movement gateway が「接続済み」であることを Administration で確認すると、それを使用してデータ ソースとサポートされているターゲットにアクセスできます。

詳細については、「[データソースへの接続の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm)」および「[ターゲットへの接続の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top)」を参照してください。

## Data Movement gateway での作業

Qlik データ ゲートウェイ - データ移動 を使用する場合、フローは次のようになります。

1. 少なくとも 1 台のマシン ([ユース ケース](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common)に応じて) に Data Movement gateway をセットアップし、上記の説明に従って Qlik Cloud テナントへの接続を構成します。
2. [データソースへの接続の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm) の説明に従って、データ ソースに必要なドライバーをインストールし、その他の前提条件をすべて満たします。[ユース ケース](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common)によっては、ソースの近くに展開された Data Movement gateway サーバーにドライバーをインストールする必要がある場合があります。
3. [ターゲットへの接続の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top) の説明に従って、ターゲット プラットフォームに必要なドライバーをインストールし、その他の前提条件をすべて満たします。[ユース ケース](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common)によっては、ターゲットの近くに展開された Data Movement gateway サーバーにもドライバーをインストールする必要がある場合があります。
4. [データソースへの接続の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm) の説明に従って、データ ソースのコネクタを構成します。
5. [ターゲットへの接続の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top) の説明に従って、ターゲット プラットフォームのコネクタを構成します。
6. [データ パイプライン プロジェクトの作成と管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-projects.htm) の説明に従って、プロジェクトを作成して必要なタスクを実行します。

## データ ゲートウェイをスペースと関連付ける際の注意事項

Data Movement gateway をスペース (上記のステップ 3 を参照) に関連付ける際、次の点を考慮する必要があります。

* データゲートウェイは、データ スペースでのみ作成できます。

* あるスペースで別のスペースのデータ ゲートウェイを使用する接続を作成するには、データ ゲートウェイのスペースで [データ消費可能] ロールが必要です。

* データゲートウェイを作成するには、スペースオーナーであるか、または [管理可能] ロールが必要です。ユーザーベースのサブスクリプションの場合、Professional 資格も必要です。詳細については、「[ユーザー資格の管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-user-allocations.htm)」を参照してください。

* データゲートウェイを関連付けられるのは単一のスペースのみです。

関連する学習コンテンツ：

* [Qlik データ ゲートウェイ - データ移動の概要](https://help.qlik.com/lnk/Introduction_data_gateway_movement)

## 詳細を見る

* [Qlik データ ゲートウェイ - データ移動の概要](https://help.qlik.com/lnk/Introduction_data_gateway_movement)