Tabadmin と TSM の機能比較

Tableau Server on Windows 2018.2 バージョンには Tableau サービスマネージャー(TSM) と呼ばれる更新済の管理ツールセットが含まれています。これは、従来の tabadmin CLI および GUI ツールセットに代わるものです。レガシー ツール セットに含まれていたほとんどの機能は TSM に移行しています。以下のリストは直接移行していない、または Tableau Server には実装されなくなったレガシー機能を説明しています。

: 古いバージョンの Tableau Server on Windows 用の tabadmin または構成ユーティリティ コンテンツについては、Tableau ヘルプ ページのアーカイブされたオンライン ヘルプを参照してください。

TSM は、Tableau Server のサーバーレベルの構成の管理に使用されます。TSM へのアクセスはコマンドラインインターフェイス (CLI) または web インターフェイスで可能です。これは、以前のバージョンの Tableau Server にあった以下のツールに代わる機能を提供します。

  • Tableau Server 構成ユーティリティ
  • tabadmin コマンド ライン ユーティリティ
  • Tableau Server Monitor

簡単に言うと、このトピックではレガシーツールを [tabadmin]と称します。Tableau Server on Windows の以前のバージョンでは、例えば、現在は TSM で行われている以下のタスクの実行に tabadmin を使用していました。

  • インストール後の Tableau Server の初期構成
  • 設定の編集やサーバー トポロジの変更などを含む継続的な構成管理
  • バックアップ、復元、ログの圧縮などの管理タスクの実行

TSM の管理および使用方法の詳細については、Tableau Services Manager の概要を参照してください。

レガシー tabadmin CLI コマンドと TSM コマンドとの間のマッピングを理解するには、Tabadmin から TSM CLI への移行を参照してください。

TSM コマンド ラインからのみ利用可能な機能

このセクションに記載されている機能は、以前は Tableau Server 構成ユーティリティで利用可能でした。以下の機能は TSM web UI には表示されていないので、TSM CLI で構成する必要があります。

優先アクティブ リポジトリ

Tableau Server 構成ユーティリティには優先アクティブ リポジトリを設定するオプションがありました。TSM でこれを行うには、CLI コマンド tsm configuration set -k pgsql.preferred_host を使用します。詳細については、Tableau Server リポジトリの[優先アクティブ リポジトリ]を参照してください。

データ キャッシュ構成

以前のバージョンでは、Tableau Server 構成ユーティリティはグラフィック UI を提供してデータ キャッシングを構成していました。TSM バージョンの Tableau Server では、キャッシングを TSM CLI で構成する必要があります。データ キャッシュの構成を参照してください。

初期インストールのみの設定

以前のバージョンでは、インストール後であっても、Tableau Server 構成ユーティリティはグラフィック UI を提供してゲートウェイ ポートを変更してサンプルをインストールしていました。TSM では、これらのオプションをインストール時に Web UI で指定できますが、インストール完了後は、コマンドラインツールでしか変更できません。

Tableau サービス マネージャーのポート および publishsamplesをご覧ください。

初期 SQL

以前のバージョンの Tableau Server では、Tableau Server 構成ユーティリティの [データ接続] タブで [Ignore initial SQL statements for all data sources] オプションを選択することにより、初期 SQL ステートメントを無視するようにサーバーを構成することができました。この構成オプションは TSM Web UI に含まれていません。サーバーで初期 SQL ステートメントを無視するように構成するには、tsm configuration set コマンドを使用します。

tsm configuration set -k vizqlserver.initialsql.disabled -v true

サイト SAML

コア SAML 構成オプションが TSM web UI に含まれる一方、サイト SAML を構成するために、TSM CLI を使用する必要があります。サイト固有の SAML の構成を参照してください。

SAP HANA SSO

SAP HANA SSO の構成を参照してください。

検索インデックスの再構築

2018.2 以前の Tableau Server バージョンでは、Tableau Server の「状態」ページに、検索と参照インデックスを再構築するオプションが含まれていました。これはインデックスを再構築するための推奨方法ではないので、このオプションは 2018.2 の開始とともに削除されました。代わりに、 TSM maintenance reindex-search コマンドを使用します。詳細については、tsm maintenance reindex-searchを参照してください。

機能の違い

このセクションはレガシー tabadmin バージョンの Tableau Server on Windows における管理経験と比較した、TSM 実装の機能の違いを説明しています。

ホスト名構成

TSM では、Tableau Server のインストール後はホスト名を変更できません。

ログのアーカイブにはローカル管理者権限が必要です

Tableau Server のレガシー tabadmin バージョンでは、サイト管理者はアーカイブ ログのスナップショットを Tableau Server 管理ページから作成することができました。TSM バージョンの Tableau Server では、ログ スナップショット機能は TSM アクセスのある管理者にのみ制限されています。TSM web UI または CLI へのサインインに使用するアカウントは、Tableau Server が実行されている Windows コンピューターのローカル管理者グループのメンバーである必要があります。ログ ファイルのスナップショット (ログのアーカイブ)を参照してください。

Windows ファイアウォール構成

セットアップでは Windows ファイアウォールを構成しようとしません。Tableau Server をインストールする前に、適切なポートがローカル ファイアウォールで開いていることを検証します。ローカル ファイアウォール構成を参照してください。

バックアップおよび復元プロセス

TSM バージョンの Tableau Server では、バックアップされている Tableau Server データについてより制御できます。TSM では、tsm maintenance backup, tsm settings export、および tsm settings import コマンドを使用して Tableau Serverのインストールをバックアップし復元します。tsm maintenance backup コマンドではサーバー構成データはバックアップされず、tsm maintenance restore コマンドでは構成データは復元されません (tabadmin で作成したバックアップを復元する場合でも)。Tableau Server の完全なバックアップと復元を実行しますを参照してください。

バックアップと復元プロセスでは、決められた場所からファイルの書き込みと読み取りを行います。Tableau Server 2018.1 以前とは異なり、コマンド実行時にファイルの場所を指定することはできません。詳細については、固定されたファイルの場所を参照してください。

資産キー

資産キーはバックアップファイルに含まれています。バックアップを、レガシー tabadmin に再生成した資産キーを含めた場所に復元する場合、その .yml ファイルを TSM 復元プロセスの一部としてインポートする必要があります。Tableau Server の完全なバックアップと復元を実行しますを参照してください。

構成のインポートとエクスポート

レガシー tabadmin バージョンの Tableau Server では、構成およびトポロジ情報はバックアップと復元プロセスの一部として管理されていました。TSM の導入と共に、お使いの構成とトポロジ情報を tsm settings コマンドを使用してエクスポートおよびインポートできるようになりました。

Kerberos 構成

レガシーバージョンの Tableau Server では、Tableau Server 構成ユーティリティの Kerberos タブにオプションがあり、それがドメイン管理を実行するための構成 bat スクリプトを生成していました。このスクリプトがサービスプリンシパル名を設定し、Run As サービスアカウントのキータブファイルを作成しました。TSM バージョンの Tableau Server では、この bat スクリプトを文書化したので、管理用に準備できます。Keytab 要件の理解を参照してください。

ファイルストレージ

TSM バージョンの Tableau Server では、クライアントファイルサービス (CFS) と呼ばれる新しいプロセスがマルチノード展開でのファイル分散を処理します。TSM CLI または web インターフェースを使用して CFS が管理するファイルをアップロードする必要があります。Tableau Server プロセスを参照してください。

TSM はバッチ ファイルである

TSM はバッチ ファイルです。コマンド ラインで TSM コマンドを実行する際、バッチ ファイル (TSM.cmd) を呼び出しています。つまり、バッチ ファイルでサーバーのメンテナンスまたは構成をスクリプトで実行しているまたは自動化している場合、call コマンド (call tsm maintenance ziplogs など) を使用し、制御がバッチ ファイルに返されるようにする必要があります。

TSM の使用を認証する必要がある

tabadmin では Tableau がインストールされたローカル コンピューターでしかコマンドを実行できませんでしたが、これとは異なり、TSM では Web UI または CLI より、リモートでコマンドを実行することができます。この柔軟さを得るには、コマンドを実行する前に TSM にサインインする必要があります。Web UI にサインインするには、TSM Web ページ (https://<tsm_computer>:8850) を開き、プロンプトが表示されたらサインインします。CLI にサインインするには、tsm login コマンドを使用します。

キャッシュのクリーンアップおよびクリア

TSM バージョンの Tableau Server では、キャッシュのクリアなどのオプションのクリーンアップ操作が tsm maintenance cleanup コマンドに含まれます。

Web データ コネクタ

レガシー tabadmin バージョンの Tableau Server では、Web データコネクタ (WDCs) をインポートしてセーフリストに追加する両方が可能です。TSM バージョンの Tableau Server では、WDCs を tsm data-access web-data-connectors add コマンドおよび web-data-connector-settings エンティティを使用してセーフリストに追加できます。Tableau Server での Web データコネクタサポートの詳細については、Tableau Server での Web データ コネクタを参照してください。

アンインストールおよび削除 Tableau Server

レガシー tabadmin バージョンの Tableau Server では、Windows コントロール パネルを使用してアンインストールし、アンインストール プロセスではファイルやその他の Tableau Server 構成が残されます。

TSM を使用すると、Tableau Server のアンインストールは以下のように異なります。

  • ある TSM バージョン (2018.2.x 以降) からある TSM バージョンにアップグレードしているときは、Tableau Server をアンインストールしないでください。アップグレードが完了したら、Windows コントロール パネルを使用して以前のバージョンをアンインストールできます。

  • インストールやアップグレードの試行に失敗する場合は、Windows コントロール パネルを使用して Tableau Server をアンインストールしないでください。このような状況では、以下に記載する tableau-server-obliterate スクリプトを使用し、コンピューターから Tableau Server を完全に削除してください。

  • Windows コントロール パネルを使用して Tableau Server をアンインストールすると、データのバックアップは作成されません。tsm maintenance backup コマンドを使用してバックアップを作成しておき、Tableau をインストールしていないコンピューターの安全な場所に保存してください。

  • Tableau Server を完全に削除するには、tableau-server-obliterate.bat スクリプトを使用します。このスクリプトにより、すべての Tableau Server ファイルと構成が削除されます。ベスト プラクティスとして、obliterate スクリプトの実行後にコンピューターを再起動する必要があります。

Tableau Server のアンインストールと削除の詳細については、Tableau Server のアンインストールを参照してください。

Tableau Server \bin ディレクトリ

\bin ディレクトリは削除されました。

  • tabadmin インストールでは、既定の \bin ディレクトリは \Program Files\Tableau\Tableau Server\<version>\bin です。

  • TSM インストールでは、既定の \bin ディレクトリは \Program Files\Tableau\Tableau Server\packages\bin.<version_code> にあります。

Tableau Server インストール ディレクトリ

Tableau は a \packages フォルダーにインストールされます。

  • Tabadmin インストールでは、デフォルト場所はC:\Program Files\Tableau\Tableau Server\<version>です。

  • TSM インストールでは、既定のインストール場所は \Program Files\Tableau\Tableau Server\packages\ で、各プロセスやサービスのサブフォルダーにはバージョン番号が付いています。例: C:\Program Files\Tableau\Tableau Server\packages\bin.20182.18.1214.0751

固定されたファイルの場所

tabadmin では、生成されたファイル、またはバックアップ、復元、および ziplog などのコマンドに使用されるファイルの場所を指定することができました。TSM では、同等のコマンドの実行時に場所を指定できませんが、固定されたファイルの場所を設定してから、basefilepath 変数を使用してコマンドを実行できます。固定されたファイルの場所から読み取られる/書き込まれるコマンドの詳細については、tsm ファイル パスを参照してください。

ログ ファイルのスナップショット

ログ ファイルのスナップショットを作成するために進む場所は TSM で変更になりました。2018.2 以前のバージョンの Tableau Server on Windows では、ログ ファイルのスナップショットを作成して、Tableau Server の状態ページからダウンロードできました。TSM では、TSM メンテナンス ページで行います。TSM での新しいことは、ログ ファイルのスナップショットを直接 Tableau Support にアップロードできる機能です。これら 2 つの機能が TSM で動作する方法の詳細については、ログ ファイルのスナップショット (ログのアーカイブ)を参照してください。

高可用性および分散導入の変更

TSM では、分散インストールにおける Tableau Server ノードを説明するために使用した言い方を変更しました。TSM のリリース前は、1 番目のノードを [プライマリ]ノード、それ以外のノードを[ワーカー]ノードと呼んでいました。TSM では、ノードは以前のリリースよりもお互いにさらに類似しているので、1 番目のノードを[初期]ノード、それ以外のノードを[追加]のノードと呼びます。初期ノードには追加のノードにはインストールされていない、TSM コントローラーおよびライセンス サーバーを含む、TSM 固有のプロセスが含まれています。Tableau には、初期ノードで問題が発生した場合に、これらの主要なプロセスをインストールの他のノードに移動するスクリプトがあります。詳細については、初期ノードの障害からの回復を参照してください。

分散導入のインストールプロセスも変わりました。

  • 一般的なインストーラー ファイル— 2018.1 以前のバージョンでは、導入には 2 つの別のインストーラーが必要でした。2018.2 および TSM では、同じインストーラーをすべてのノードで実行して、初期ノードまたは追加のノードにインストールしているかどうかを示します。

  • ノードの自動検出なし—2018.2 以前のバージョンのf Tableau Server では、全ノードをインストールすると、サーバー構成ユーティリティを実行し、追加のワーカーノードをプライマリに追加しました。TSM では、初期ノードのインストール後、bootstrap 構成ファイルを生成し、これを使って全追加のノードをインストールします。マルチ ノード クラスタのインストールの詳細については、分散型/高可用性 Tableau Server インストール環境を参照してください。

  • 調整サービスのインストール—Tableau Server の分散インストールを構成する場合、追加ノードに調整サービス アンサンブルを展開する必要もあります。Tableau Server on Windows のバージョン 2018.2 以前では、調整サービスの追加インスタンスは、合計で 3 個または 5 個のノードを追加すると自動的に追加されていました。調整サービスの展開は手動で行うことが必要になりました。この方法の詳細は、調整サービス アンサンブルの展開を参照してください。

  • 「バックアップ プライマリなし」—「バックアップ プライマリ ノード」は不要になったので、TSM は初期ノードのバックアップ作成をサポートしなくなりました。TSM では、初期ノードに問題が発生したら、スクリプトを使用して、主要プロセスをそのノードから、別のクラスタ ノードに移動します。この方法の詳細については、初期ノードの障害からの回復を参照してください。

アップグレード プロセスの変更

アップグレード ステップは、アップグレード元がどのバージョンかによって変わります。レガシー tabadmin Tableau Server (Tableau Server 2018.1.x 以前) から TSM バージョン (2018.2 以降) へのアップグレードには、特別なステップが必要です。

- バージョン 2018.1 以前からのアップグレード: Tableau Server on Windows バージョン 2018.1 以前から Tableau Server on Windows バージョン 2018.2 以降にアップグレードしている場合は、以下の主要な側面をお読みになり、Tableau Server 2018.1 以前から TSM 搭載 Tableau Server へのアップグレードで詳細なアップグレード手順を参照してください。

- バージョン 2018.2 以降からのアップグレード: Tableau Server on Windows バージョン 2018.2 以降からアップグレードしている場合は、Tableau Server のアップグレードをお読みください。TSM 前から TSM へのアップグレードのステップには従わないでください。

以下の点は、Tableau Server をバージョン 2018.1 以前からバージョン 2018.2 にアップグレードする際に留意しておく必要がある主要な側面です。

すべてのアップグレードに関する事項:

  • ローカル管理者—ローカル管理者としてサインインします。Tableau Server セットアップ プログラムを実行し、アップグレードに関連したスクリプトを実行するには、Tableau Server コンピューターに「local admin」としてサインインする必要があります。「local admin」は、Windows の [ローカル ユーザーとグループ] 管理コンソールの管理者グループに含まれるメンバーであるユーザーのことです。

  • ライセンス発行

    • トライアル版のプロダクト キー—トライアル版のプロダクト キーを実行しているサーバーを、あるメジャー バージョンから別のバージョン (バージョン 10.5.x からバージョン 2018.x など) に直接アップグレードすることはできません。あるメジャー バージョンから別のバージョンにトライアル版のプロダクト キーを使用してアップグレードするには、新しいバージョンの Tableau Server を別のマシンにインストールし、そこでトライアル版のプロダクト キーをライセンス認証してから、既存のバージョンよりバックアップを復元します。詳細については、ライセンス発行要件の確認を参照してください。

    • メンテナンス期限切れ—サーバーのアップグレードは、メンテナンス期限が切れているプロダクト キー、またはアップグレード先のバージョンのリリース日より前の日付に切れるプロダクト キーを使用して行うことはできません。この状態でサーバーをアップグレードしようとすると、サーバーはライセンスなしの状態になり、アップグレードに失敗する場合があります。メンテナンス期限が切れているまたは古すぎる場合、元のバージョンをアンインストールするに、[プロダクト キーの管理] アプリケーションを使用してプロダクト キーを更新してください。2018.2.0 以前のバージョンでプロダクト キーを更新する方法の詳細については、「プロダクト キーのメンテナンス日の更新」を参照してください。キーを更新してもメンテナンスが有効な日付に更新されない場合は、Tableau カスタマー ポータルで Tableau Server キーのメンテナンスが最新かどうかを確認してください。

  • アンインストール—アップグレード前に既存の TSM 前バージョンの Tableau Server をアンインストールするには、Windows コントロール パネルを使用します。この特殊なケースのアップグレードは、以前のバージョンでのアップグレード (以前のバージョンの Tableau Server が自動的にアンインストールされていた) とは異なります。バージョン 2018.1 以前からバージョン 2018.2 以降にアップグレードする際に、以前のバージョンは自分でアンインストールする必要があります。以前のバージョンをアンインストールしていない場合は、新しいバージョンをインストールしようとする際にアンインストールするようメッセージが表示されます。これは 2018.1 以前から 20182 以降のアップグレードに固有のものです。

  • バックアップ—以前のバージョンのバックアップを別のコンピューターの安全な場所に保存します。以前のバージョンの Tableau Server をアンインストールすると、Tableau データ ディレクトリ (既定: C:\ProgramData\Tableau\Tableau Server) にバックアップが作成されます。このバックアップは、アップグレード前に Tableau Server インストールが含まれていないコンピューターにコピーしておくことを強くお勧めします。アップグレード前にバックアップを作成することで、以前のバージョンの Tableau Server に戻す必要がある場合に使用可能な最新バージョンのデータが得られます。アップグレードの適切な準備の詳細については、アップグレードの準備を参照してください。

  • ファイアウォール管理—ファイアウォール管理は手動で行います。以前のバージョンの Tableau Server とは異なり、Tableau Server を実行するコンピューターではローカル ファイアウォールの管理を行う必要があります。詳細については、ローカル ファイアウォール構成を参照してください。

  • アップグレード スクリプト—新しいバージョンをインストール後、アップグレードを完了して新しいバージョンに切り替えるには、upgrade-tsm.cmd スクリプトを実行します。このスクリプトは、インストールしたばかりの新しいバージョンの \scripts.<version_code> フォルダーにインストールされます。

  • ウイルス対策ソフトウェア—Tableau Server で使用されるディレクトリをスキャンするウイルス対策ソフトウェアは、Tableau Server のインストールや現在の使用に干渉する可能性があります。場合によっては、これによってインストール エラーや Tableau Server の起動の問題が発生したり、パフォーマンスへの影響が生じたりすることがあります。Tableau Server を実行しているコンピュータでウイルス対策ソフトウェアを実行する予定がある場合は、ナレッジ ベースの推奨事項に従ってください。

マルチノード アップグレードに関する事項:

  • マルチノード用語—TSM では、分散インストールで Tableau Server ノードを説明するために使用する用語を変更しました。TSM のリリース以前は、最初のノードを「プライマリ」ノードと呼び、追加のノードを「ワーカー」ノードと呼んでいました。TSM でノードがよりピアに近くなってきたため、今後は最初のノードを「最初の」ノードと呼び、その他のノードを「追加」ノードと呼ぶことにします。

  • アンインストール—アップグレード前にすべてのノードから既存の TSM 前バージョンの Tableau Server をアンインストールするには、Windows コントロール パネルを使用します。以前のバージョンをアンインストールしていない場合は、新しいバージョンをインストールしようとする際にアンインストールするようメッセージが表示されます。

  • ノードのインストール—クラスタ内のすべてのノードでセットアップ プログラムを実行します。2018.2 以前のバージョンにおける一部の分散インストールのアップグレードと異なり、追加のノードが自動的にアップグレードされることはありません。

  • 単一インストーラー—すべてのノードで同じセットアップ プログラムを使用します。2018.2 より、すべてのノードで同じインストーラーを使用し、プロンプトが表示される場合には、最初の (プライマリ) ノードまたは追加の (ワーカー) ノードをアップグレードしようとしているかを指定します。追加ノード向けの別のインストーラーはありません。

  • アップグレード スクリプト—クラスタ内のすべてのノードで新しいバージョンをインストール後、アップグレードを完了して新しいバージョンに切り替えるには、クラスタ内の最初のノードで upgrade-tsm.cmd スクリプトを実行します。

TSM に実装されていない機能

  • 構成データをバックアップ ファイル (.tsbak) から復元。レガシー バージョンの tabadmin バックアップには規定により構成データが含まれます。アナログ TSM コマンド、 tsm maintenance backup、には構成データは含まれません。構成データを TSM にバックアップして復元するには、 tsm settings コマンドを使用します。

  • Tableau サービス マネージャー (TSM) の導入に伴い、リポジトリを 2 ノード クラスタの最初の (プライマリ) ノードから移動できなくなりました。バージョン 2018.1 以前では、2 つ目のリポジトリを 2 番目のノードに追加し、最初のリポジトリを削除することができました。TSM では、2 つ目のリポジトリを 2 ノード クラスタに追加できません。つまり、リポジトリを最初のノード外に移動することができません。

ご意見をお寄せくださりありがとうございます。 ご意見の送信中にエラーが発生しました。もう一度実行するか、当社にメッセージを送信してください