Qlik DataTransfer のインストール

Qlik DataTransfer は、ファイアウォール トンネリングなしでオンプレミスのデータ ソースから Qlik Cloud テナントにデータをアップロードできる軽量の Windows アプリケーションです。サービス アカウント所有者 (SAO) またはテナント管理者がテナントから API キーを生成し、それを使用して Qlik DataTransfer を認証します。認証されると、データの自動リロードをスケジュールしたり、手動でデータをアップロードしたりできます。

Qlik DataTransfer は、次の種類のデータ ソースを処理します。

• アプリ データ
• 接続データ
• フォルダ

Qlik DataTransfer で使用できるデータ型については、Qlik DataTransfer を使用したオンプレミス データのアップロード を参照してください。

Qlik DataTransfer のインストールは、単一の Qlik Cloud テナントにのみ関連付けることができます。

Qlik DataTransfer システム必要条件

開始する前に

Qlik DataTransfer インストーラーをダウンロードして実行する前に、次の要件を満たしていることを確認してください。

• Qlik Cloud テナントにアクセスできる。
• そのテナントの Professional 資格または Full User 資格 のユーザーである。
• そのテナントの開発者ロールが割り当てられている。
• Qlik DataTransfer からデータをアップロードするすべてのスペースにアクセスできる。詳細については、「スペースの管理」を参照してください。
• オンプレミスのデータ ソースにアクセスできる Windows マシンの管理者権限を持っている。
• 使用中の Windows マシンがシステム要件を満たしている (Qlik DataTransfer のシステム要件)。
• API キーは、Administration アクティビティ センターで有効になります。API キーを有効にする方法については、「API キーの管理」を参照してください。

• [SSL 構成の設定] ポリシーは、Qlik DataTransfer をインストールしているマシンで IANA 形式のサポート暗号のみに設定する必要があります。

  Windows Server 2012 R2 で Qlik DataTransfer May 2021以降をインストールまたはアップグレードする場合は、TLS Cipher Suite を更新する必要があります。Windows Server 2021 R2 の規定値のセキュリティポリシーに含まれる既定の暗号は、Qlik DataTransfer May 2012 以降ではサポートされていません。次の暗号スイートが存在する必要があります:

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

  • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  お使いのシステムで TLS 暗号スイートをアップデートする手順または、Qlik DataTransfer 環境で脆弱な暗号を無効化する手順については、以下のコミュニティ記事を参照してください。 https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

• Qlik DataTransfer には Windows ユーザー アカウントが必要です。Qlik DataTransfer サービスを実行するには、管理者権限を持つ専用のユーザー アカウントを使用することをお勧めします。インストールの際、専用のユーザーが管理者である場合は、そのユーザーとしてログインして Qlik DataTransfer をインストールできます。専用のユーザーがローカル管理者ではない場合は、管理者アカウントを使用して Qlik DataTransfer をインストールする必要があります。

  Qlik Sense Enterprise on Windows がインストールされた Windows サーバーで Qlik DataTransfer をインストールまたはアップグレードする場合、Qlik Sense インストールで使用される Qlik Sense サービス ユーザーを Qlik DataTransfer にインストールする必要があります。

• Qlik DataTransfer をインストールするユーザー アカウントには、RemoteSigned 実行ポリシーを使用して PowerShell スクリプトを実行するアクセス権限が必要です

• テナントに Qlik Data Transfer (Qlik データ転送) を構成した後でサービス ログオン アカウントを変更した場合は、テナントと接続を再構成する必要があります。次に、%ProgramData%/Qlik/DataTransfer/DataUpload/storage で token.json を削除します。Qlik DataTransfer サービスを再起動します。

• February 2021 SR1 では、Qlik Sense Enterprise on Windows または QlikView Server とは別のサーバーに Qlik DataTransfer をインストールすることをお勧めします。Qlik DataTransfer が Qlik Sense Enterprise on Windows サーバーまたは QlikView Server にインストールされている場合、Qlik DataTransfer はローカル システムのユーザー アカウントを使用して実行されます。サービス ユーザー アカウントを変更すると、Qlik DataTransfer または Qlik Sense Service Dispatcher のいずれかが停止します。

インストール ユーザー アカウント実行ポリシーの確認

Qlik DataTransfer をインストールするユーザー アカウントには、RemoteSigned 実行ポリシーを使用して PowerShell スクリプトを実行するアクセス権限が必要です。ユーザー アカウントの権限を割り当てる権限がない場合は、管理者に連絡して、インストール ユーザー アカウントにこれらの権限を付与してください。

次の手順を実行します。

1. PowerShell を管理者モードで開きます。

2. Get-ExecutionPolicy を実行します。RemoteSigned が推奨されます。Restricted または Disabled の場合、次のステップに進みます。

3. Set-ExecutionPolicy RemoteSigned を実行します。

4. Y を選択します。

インストーラのダウンロードと実行

次の手順を実行します。

1. 次のいずれかから Qlik DataTransfer.exe ファイルをダウンロードします。

   • 製品のダウンロード
     詳細については、「ツールとインストール ファイルのダウンロード」を参照してください。

   • Qlik Cloud
     右上のプロフィール アイコンをクリックし、[プロファイルの設定] をクリックします。[その他] にある [ツール] をクリックします。

     Qlik Cloud Government に関する注意 このオプションは、Qlik Cloud Government では利用できません。

2. インストーラを実行し、Qlik ユーザー ライセンス契約に同意します。既定のインストール パスは %Program Files%\Qlik\DataTransfer です。サービスのクレデンシャルを入力するとき、ユーザー名は domain\username の形式である必要があります。

   情報メモ

   20 文字を超える長さのユーザー名を入力する場合は、ユーザー プリンシパル名 (UPN) 形式であり、完全なドメイン名を含める必要があります。例えば、「longusername@full.domain.name」のように入力します。

   情報メモ

   同じサーバーに Qlik Sense Desktop または別の Qlik プラットフォームがインストールされている場合、Qlik DataTransfer をインストールする前に、それらをシャットダウンし、Qlik サービスを停止する必要があります。

   

   インストールしたら、次の順序で Qlik サービスを再起動します。

   1. Qlik Sense Service Dispatcher

   2. Qlik Logging Service

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Qlik Sense Engine Service

   7. Qlik Sense Printing Service

3. [Service Credentials (サービス資格情報)] ウィンドウで、Qlik DataTransfer サービスを実行するために使用するアカウントのユーザー名とパスワードを入力します。

4. services.config ファイルの追加設定をカスタマイズするには、「Qlik DataTransfer の構成」を参照してください。

インストーラは、Qlik DataTransfer アプリケーションを起動するデスクトップ ショートカットを作成します。

API キーの生成

API キーには有効期限があります。既定の有効期限は、ビジネスのニーズに適さない場合があります。API キーを生成する前に、Administration アクティビティ センターの設定でトークンの最大有効期限を変更することを検討してください。 詳細については、「テナントでの API キーの有効化」を参照してください。

次の手順を実行します。

1. Qlik Cloud テナントへのログイン
2. アクティビティ センターから、右上にあるプロファイル アイコンをクリックし、 [プロファイル設定] をクリックします。
3. API キーを選択します。

4. 新規キーの生成を選択します。

   
5. API キーの名前を入力し、[有効期限] 時間を選択します。

6. [生成] をクリックします。

   

7. [コピーして閉じる] をクリックして、API をクリップボードにコピーします。

   情報メモ必ず API キーを保存してください。 Qlik DataTransfer を認証するには、このキーが必要です。
   

   API キーを取得したので、Qlik DataTransfer と自分の Qlik Cloud テナント間に安全な接続を作成できます。API キーは、データをテナントにアップロードするときに Qlik DataTransfer を認証するために使用されます。API には有効期限があるため、新しい API キーを作成し、このキーの有効期限が切れたときに Qlik DataTransfer を再認証する必要があります。API キーの有効期限が切れた場合、データ接続を再作成する必要はありません。

Qlik DataTransfer の認証

次の手順を実行します。

1. Qlik DataTransfer を開きます。

   Qlik DataTransfer を初めて開くと、[Qlik DataTransfer のセットアップ] 認証画面が表示されます。

   
2. 接続の名前を入力します。
3. Qlik Cloud テナントに URL を入力します。

4. テナントから生成した API キーを貼り付けます。

5. [適用] をクリックしてテナントを検証します。

6. API キーの有効期限が切れたときや、別のテナントに対して Qlik DataTransfer を認証するときは、 をクリックして新しい API キーを入力し、[確認] をクリックします。

   

Qlik DataTransfer が認証されると、Qlik Cloud テナントにオンプレミス データをアップロードできます。Qlik DataTransfer の使用方法については、「Qlik DataTransfer を使用したオンプレミス データのアップロード」を参照してください。

Qlik DataTransferのアップグレード

Qlik DataTransfer は、新しいバージョンが利用可能になると通知バナーを表示します。Qlik DataTransfer は自動的に新しいバージョンにアップグレードしません。

次の手順を実行します。

1. 新しいバージョンの Qlik DataTransfer を、アプリ内バナーまたは 製品のダウンロード からダウンロードします。
2. Qlik DataTransfer の現在のバージョンを閉じます。

3. Qlik DataTransfer インストーラを実行します。

   情報メモ

   Qlik Sense Enterprise on Windows がインストールされた Windows サーバーで Qlik DataTransfer をアップグレードする場合、Qlik Sense インストールで使用される Qlik Sense サービス ユーザーを Qlik DataTransfer でアップグレードする必要があります。

4. [アップグレード] をクリックします。

   

のアンインストールQlik DataTransfer

次の手順を実行します。

1. Qlik DataTransfer インストーラを実行します。

   情報メモ

   同じサーバーに Qlik プラットフォームがインストールされている場合、Qlik DataTransfer をアンインストールする前に、他の Qlik サービスを停止する必要があります。

2. [アンインストール] をクリックします。

3. アンインストールしたら、該当する場合、次の順序で Qlik サービスを再起動します。

   1. Qlik Sense Service Dispatcher

   2. Qlik Logging Service

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Qlik Sense Engine Service

   7. Qlik Sense Printing Service

制限事項

Qlik DataTransfer には次の制限があります。

• 2020 年 10 月以降のリリースからアップグレードすると、構成ファイルを保存する場所と Qlik DataTransfer の実行に使用されるポートが、構成ファイル Service.conf の既定に変更されます。構成ファイルを保存するための既定の場所または Qlik DataTransfer を実行するための既定のポートを使用しなかった場合、これらの設定は失われます。設定を保持するには、アップグレード前に Service.conf をバックアップし、アップグレードの完了後にバックアップ ファイルから Service.conf の設定をやり直します。

• Service.conf に構成ファイルを保存するために既定の場所を使用しなかった場合は、選択したフォルダー内のファイルを手動で削除する必要があります。

• プロキシを使用する場合は、Qlik Cloud テナント URL を使用して、Qlik DataTransfer のバイパスをファイアウォールに追加する必要があります。バイパスがなければ、Qlik DataTransfer は Qlik Cloud に接続できません。

• Qlik DataTransfer は、Qlik DataTransfer システム必要条件 で規定されている専用の Window Server にインストールする必要があります。実際のデータ ソース サーバー、または Qlik Data Gateway - 直接アクセス がインストールされているサーバーにはインストールしないでください。