Tableau Server on Linux ヘルプ

IG のインストールは、次の手順で行います。

• プラットフォーム固有のインストーラーを実行します。

• インストール後のスクリプトを実行します。

• TSM を使用して Independent Gateway インスタンスを有効にします。

ディストリビューションのパッケージ マネージャーを使用して Tableau Server Independent Gateway をインストールしてから、スクリプトを実行して Independent Gateway を初期化します。スクリプトはインストールされたパッケージに含まれています。

Independent Gateway は /opt ディレクトリにインストールされます。

1. Independent Gateway をインストールするコンピューターに sudo アクセス権を持つユーザーとしてログオンします。

   注: 複雑な問題を避けるため、特殊文字 (たとえば、非ASCII 文字、"+"、"-" など) を含まないユーザー アカウントを使用することをお勧めします。特殊文字を使用すると、環境の構成によっては、Independent Gateway の完全インストールの失敗などの問題が発生する可能性があります。

2. .rpm または .deb インストーラー パッケージを 「Tableau Server のダウンロードおよびリリース ノート」ページからダウンロードします。

3. .rpm または .deb パッケージをコピーしたディレクトリに移動します。

4. パッケージ マネージャーを使用して、Independent Gateway パッケージをインストールします。

   シンボリック リンクを使用している場所や、ネットワーク ファイル システム (NFS) ボリューム上のディレクトリにインストールしないでください。次のコマンドを実行して Independent Gateway をインストールします。<version> は「メジャー番号 - マイナー番号 - メンテナンス番号」の形式です (例: 2022-1-0)。

   • RHEL 系ディストリビューション (CentOS を含む) の場合:

     sudo yum update

     sudo yum install tableau-tsig-<version>.x86_64.rpm

   • Ubuntu の場合:

     sudo apt-get update
     sudo apt-get upgrade
     sudo apt-get -y install gdebi-core
     sudo gdebi -n tableau-tsig-<version>_amd64.deb
     

Tableau Server Independent Gateway の初期化

次のステップでは、スクリプト initialize-tsig を実行します。

1. scripts ディレクトリへ移動します。

   cd /opt/tableau/tableau_tsig/packages/scripts.<version_code>/

2. 次のスクリプトを実行し、Independent Gateway を初期化して起動します。

   sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>

   initialize-tsig スクリプトで必要なパラメーターは --accepteula と -c のみです。

   • --accepteula - このパラメーターは、Tableau エンド ユーザー ライセンス契約 (EULA) に同意するために含める必要があります。EULA へのリンクは次の場所にあります。

     /opt/tableau/tableau_tsig/packages/docs.<version_code>/

   • -c - このパラメーターは、Tableau Server クラスター内のすべてのノードのネットワーク上の場所を指定するために含める必要があります。これらのノードは、「ハウスキーピング」要求を Independent Gateway に送信している可能性があります。ワイルドカードとサブネットマスクを使用すると、複数のノードを指定できます。複数のアドレスを指定するには、アドレスをスペースで区切り、全体を引用符で囲みます。値は、Apache httpd mod_authz_host の「必須」ディレクティブで受け入れ可能な形式で指定する必要があります。詳しくは、「https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(新しいウィンドウでリンクが開く)」を参照してください。

   その他のパラメーター (HTTP やハウスキーピング プロセスで使用されるデフォルトのポートなど) はオプションであり、オフのままにするとデフォルト値が付与されます。スクリプトを実行する前に、パラメーターとそのデフォルト値を確認してください。「initialize-tsig スクリプトの出力ヒント」

Independent Gateway JSON ファイルの内容

Tableau Server で Independent Gateway インスタンスの有効化に使用する JSON ファイルには、以下が含まれている必要があります。

• id: ID の値は、特定のインスタンスの tsig_instance_id と一致する必要があります。これを指定しなかった場合のデフォルト値は、Independent Gateway コンピューターの完全修飾ドメイン名 (小文字) です。JSON ファイル内の値は、hostname コマンドの出力と一致する必要があります。
• host: ホストの値は、Tableau Server ノードが DNS を使用して解決できる、Independent Gateway コンピューターの DNS で解決可能な名前である必要があります。
• port: ポートは、Independent Gateway インスタンスで指定したハウスキーピング ポート (tsig_housekeeping_port) と一致する必要があります。初期化中にこれを指定しなかった場合のデフォルト値は「21319」です。
• protocol: プロトコルは、Independent Gateway インスタンスで指定したハウスキーピング プロトコル (tsig_housekeeping_port_protocol) と同じである必要があります。初期化中にこれを指定しなかった場合のデフォルト値は「http」です。
• authsecret: authsecret は、Independent Gateway インスタンスの初期化スクリプトで作成されたシークレットと一致する必要があります。

Independent Gateway の認証シークレット

初期化スクリプトは、各 Independent Gateway コンピューターに一意の共有シークレットを作成します。Tableau Server で Independent Gateway を有効にするには、このシークレットが必要です。シークレットをコピーして、JSON ファイルに「authsecret」として含めます。

共有シークレットは、次の場所の tsighk-auth.conf ファイルにあります。

/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf

Tableau Server で Independent Gateway を有効化

Independent Gateway のインストールを完了するには、TSM を使用して Independent Gateway を有効にする必要があります。

1. JSON 構成ファイルを Tableau Server の初期ノードにコピーします。
2. 初期ノードで、tsmadmin グループのメンバーであるアカウントで、コマンド プロンプトを開きます。

3. 次のコマンドを実行して Tableau Server を停止し、JSON 構成ファイルを使用して Independent Gateway を有効にして、サーバーを再起動します。

   tsm stop
   tsm topology external-services gateway enable -c tsig.json
   tsm start