Tableau Server on Linux ヘルプ

Tableau Server in a Container に関する制限事項

• Tableau Server in a Container では、サーバー ATR を使用したライセンス認証のみをサポートします。Server ATR を使用したオフライン アクティベーションは、2023.1 以降でサポートされています。この機能はコンテナで利用できますが、追加の手順と承認が必要です。エアギャップ環境またはオフライン環境のコンテナで Tableau Server を実行する必要がある場合、詳細についてはアカウント担当者にお問い合わせください。
• Tableau Server in a Container では現在、Resource Monitoring Tool (RMT) エージェントはサポートされていません。
• Kerberos は、Tableau Server in a Container ではサポートされていません。

Tableau Server in a Container - クイック スタート ガイド

このトピックでは、コマンド ラインを使用して Tableau Server in a Container のイメージの基本的なクイック スタート展開を実行するために必要なステップを説明します。ここで説明する構成は、コンテナー内で実行している Tableau Server on Linux をインストールするための最も迅速でシンプルな方法を提供することを目的としています。Tableau Server in a Container で提供される内容を確認するには、Tableau Server in a Container のセットアップ ツール または Tableau Server in a Container のイメージ までスキップしてください。

重要: 本番環境に Tableau Server を展開する際は、次のクイック スタート手順をスタンドアロン リソースとして使用しないでください。

はじめる前に

Tableau Server in a Container を使用するには、次の 2 つの基本的なステップが必要です。

1. Docker イメージを構築する

   Tableau Server in a Container の Docker イメージの構築は、RHEL ベースの Linux システム (RHEL、CentOS、または Amazon Linux 2) でのみサポートされます。他の Linux ディストリビューションでの構築は可能ですが、現在はテストが行われておらず、サポートもされていません。macOS でのイメージの構築はサポートされていません。作成されたイメージは、UBI 8 イメージ (バージョン 2022.1 以前は CentOS 7.x) に基づいています。

   コンテナー イメージを構築するには、Docker バージョン 18.09 以降がホストにインストールされている必要があります。一般的に、Docker の最新の安定したバージョンを使用することが推奨されています。一部の Linux ディストリビューションでは、ソフトウェア リポジトリに古いバージョンの Docker のみが提供されています。その場合、別のソースから Docker をインストールする必要がある場合があります。バージョン 18.09 より前のバージョンの Docker には、Tableau Server in a Container に必要な機能が含まれていません。

2. Docker イメージを実行する

   Tableau Server in a Container の本番環境での使用は、Linux でのみサポートされています。探索的なプロトタイピングやテスト作業を行う場合、Linux ベースの Docker イメージを実行できるシステムはすべて、Tableau Server in a Container のイメージを実行できる必要があります (インストールの前に...で概説されているハードウェアとオペレーティング システムの要件を満たしていることを前提としています)。

   Tableau Server in a Container のイメージを実行するには、Tableau Server 自体と同じハードウェア リソースが必要です。本番環境に展開する場合は、本番環境の最小ハードウェア推奨事項に記載されている推奨事項に従ってください。探索的作業をする場合は、インストールの最小ハードウェア要件に記載されている推奨事項に従ってください。パブリック クラウド環境に展開する場合は、インスタンスのサイズ設定の推奨事項が記載されているTableau Server の最小ハードウェア要件と推奨事項ページ下部のリンクを参照してください。コンテナーの既定のリソース制限は最小要件をはるかに下回る値に設定されているため、Docker Desktop を Windows または macOS で探索作業に使用している場合は、コンテナーを正常に実行するために制限値を増やす必要があることに注意してください。

注: Tableau Support は、サポートされていないプラットフォームや構成での問題を解決することはできません。

以下のステップは、Docker がインストールされた Linux システムがあり、Tableau Server in a Container のセットアップ ツールおよび互換性があるバージョンの Tableau Server RPM インストーラーをダウンロードしたことを前提としています。

1. Tableau Server in a Container のセットアップ ツールを解凍する

   Tableau Server in a Container のセットアップ ツールは、tarball として提供されます。tar アーカイブを解凍するには、次のコマンドを使用します。

   tar -xzf tableau-server-container-setup-tool-<VERSION>.tar.gz

2. エンド ユーザー ライセンス契約に従い、登録ファイルを編集して、Tableau Server を登録するために必要な一意の識別情報を入力します。ファイル reg-info.json は、一意に識別可能な必須登録情報のテンプレートとして使用でき、Tableau Server in a Container のセットアップ ツールの最上位ディレクトリにあります。このファイルは、イメージで実行されている Tableau Server インスタンスを登録するために使用します。正確な情報を提供することで、登録プロセスを適切に完了させることができます。

   eula フィールド値には「accept」が事前に入力されており、エンド ユーザー ライセンス契約 (EULA) に同意していることを示します。EULA は、ビルド ツールの EULA ディレクトリで表示できます。EULA で概説されているように、Tableau Server をアクティブ化するときは、一意に識別可能なユーザー登録を送信する必要があります。登録ファイルの編集が完了すると、他のフィールドに一意の情報を反映する値が入力されます。このファイルは、イメージで実行されている Tableau Server インスタンスを登録するために使用します。正確な情報を入力して登録プロセスを完了させ、登録を送信すると、ライセンス付与の要件が満たされます。

   注: Tableau Server を使用するには、EULA に同意する必要があります。EULA に同意しない場合、Tableau Server を実行できません。

   編集前の登録ファイル テンプレート reg-info.json:

   {
   "zip" : "<value>",
   "country" : "<value>",
   "city" : "<value>",
   "last_name" : "<value>",
   "industry" : "<value>",
   "eula" : "accept",
   "title" : "<value>",
   "phone" : "<value>",
   "company" : "<value>",
   "state" : "<value>",
   "department" : "<value>",
   "first_name" : "<value>",
   "email" : "<value>"
   }

3. Tableau Server in a Container のイメージを構築する

   Tableau Server in a Container のセットアップ ツールで、build-image スクリプトを実行します

   ./build-image --accepteula -i <Tableau Server Installer>.rpm

4. Tableau Server in a Container のイメージを実行する

   1. すべての引数を入力して、docker run コマンドを実行します。コマンド ラインに次の情報を入力する必要があります。

      • プロダクト キーまたはプロダクト キー ファイル
      • 新しい初期管理者アカウントのユーザー名とパスワード (Tableau Server の起動後にサインインするために使用します)
        
      • コンピューターの静的 (内部) ホスト名
      • Tableau Server in a Container のイメージの名前

   2. この情報を収集したら、最小仕様のホストで次の docker コマンドを実行します。

      docker run \
      -e LICENSE_KEY=<key> \
      -e TABLEAU_USERNAME=<username> \
      -e TABLEAU_PASSWORD=<password> \
      --hostname=<static (internal) name of host machine> \
      -p 8080:8080 -d <Tableau Server in a Container image ID or tag>

   3. 10~20分後に、Tableau Server が初期化されます。

5. Tableau Server にアクセスする

   Tableau Server が完全に初期化されたら、Web ブラウザーを開いて、サーバーが正しく実行されていることを確認し、 http://<hostname>:8080 に移動します。<hostname> はイメージを実行しているマシンのホスト名です。

この時点で、Docker コンテナー内の Tableau Server インスタンスを実行する必要があります。より高度でカスタマイズされた展開については、以下のドキュメントを参考にしてください。

展開構成の例

Docker

Tableau Server in a Container の基本的な使用例

docker run \
-e LICENSE_KEY=<key>
-p 8080:8080
-d <Tableau Server in a Container image ID or tag>

自動化された初期管理ユーザーによる Tableau Server in a Container の基本的な使用例

docker run \
-e LICENSE_KEY=<key> \
-e TABLEAU_USERNAME=<myadmin> \
-e TABLEAU_PASSWORD_FILE=/etc/tableau-admin-secret \
-v <full-path-to-pw-file>:/etc/tableau-admin-secret \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

TSM 専用モード

docker run \
-e TSM_ONLY=1 \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

マルチノードの基本的な使用例

最初のノード

オプション 1: サーバー構成 (CONFIG_FILE) でマルチノード トポロジが指定される場合にこれを使用します。

docker run \
-v <network-shared-directory>:/docker/config/bootstrap \
-v <full-path-to-config-file>:/docker/config/config.json:ro \
-e LICENSE_KEY=<key> \
-p 8080:8080 -p 8800-9000:8800-9000 -p 27000-27010:27000-27010 \
--hostname=<static (internal) name of host machine> \
-d <Tableau Server in a Container image ID or tag>

オプション 2: サーバー構成でマルチ ノードトポロジが指定されていない場合でも、マルチノード展開が必要な場合は、これを使用します。

docker run \
-v <network-shared-directory>:/docker/config/bootstrap \
-e LICENSE_KEY=<key> -e ALWAYS_WRITE_BOOTSTRAP_FILE=1 \
-p 8080:8080 -p 8800-9000:8800-9000 -p 27000-27010:27000-27010 \
--hostname=<static (internal) name of host machine> \
-d <Tableau Server in a Container image ID or tag>

追加ノード

docker run \
-v <network-shared-directory>:/docker/config/bootstrap \
-e BOOTSTRAP_INSTALL=1 \
-p 8080:8080 -p 8800-9000:8800-9000 \
--hostname=<static (internal) name of host machine> \
-d <Tableau Server in a Container image ID or tag>

データ使用の外部化

docker run \
-v <empty-data-dir>:/var/opt/tableau \
-e LICENSE_KEY=<key> \
--hostname=<static (internal) name of host machine> \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Init コンテナーの基本的な使用例

Init コンテナー

docker run \
-v <empty-data-dir>:/var/opt/tableau \
-e LICENSE_KEY=<key> \
-e INIT_CONTAINER=1 \
--hostname=<static (internal) name of host machine> \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

コンテナーの実行

docker run \
-v <empty-data-dir>:/var/opt/tableau \
--hostname=<static (internal) name of host machine> \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

シングルノード バックアップからの基本的な復元

docker run \
-v <full-path-to-backup-file>:/docker/config/backup/backup-file.tsbak \
-v <full-path-to-config-only-file>:/docker/config/config.json:ro \
-e LICENSE_KEY=<key> \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Docker の構成

version: '3.2'
services:
    tableau-server:
         hostname: localhost
         volumes:
              - <your-tsm-command-file>:/docker/config/tsm-commands:ro
              - <your-config-file >:/docker/config/config.json:ro
         ports:
              - "8080:8080"
         image: ${IMAGE_NAME}
         environment:
              - LICENSE_KEY=<license-key>