使用獨立閘道安裝 Tableau Server

本主題將引導您完成安裝 Tableau Server 獨立閘道的過程。

按照此過程可得到獨立闸道網關組態,與後端 Tableau Sever 部署直接連线線。您可以在主題“使用獨立閘道配置 Tableau Server ”中了解有關直接轉送連線模式的更多資訊。

必要條件

  • 必須有一台專用伺服器,至少有 2 個核心(4 個 vCPU)、8 GB RAM 和 100 GB 可用磁碟空間。
  • 您必須使用 Tableau Server 2022.1 或更高版本。
  • 必須使用與 Tableau Server 版本匹配的主要版本(例如 2022.1)的 Tableau Server 獨立閘道安裝程式。建議維護版本(例如,2022.1.1 or 2022.1.5)也可以,的 這不是必需的。如果版本和版本之間的「靜態資產」變更不相符,可能會看到一些意想不到的影像影響。例如,如果 Independent Gateway 的版本早於 Tableau Server,則地圖可能不是最新的。
  • 您必須將 Advanced ManagementTableau Server 中啟用。若要深入瞭解 Advanced Management,請參閱关于 Tableau Server 中的 Tableau Advanced Management
  • 預設情況下,Independent Gateway 必須能夠在安裝期間通過連接埠 80 和 21319 與後端 Tableau Server 部署進行通訊。可以在初始化期間變更這些預設連接埠,如本主題後面所述。
  • 在安裝和配置 Independent Gateway 之前,驗證 Tableau Server 部署是否完整且正常。
  • 驗證在安裝獨立閘道的電腦上沒有執行任何其他 Web 感知應用程式。例如,若電腦上安裝了 Apache httpd,請將其解除安裝,或將 httpd 設定為不主動偵聽連接埠 80。

安裝 Tableau Server 和獨立網關

安裝獨立閘道是使用獨立安裝程序完成,其文件名中包含“tsig”,以區別於完整 Tableau Server 安裝程序。強烈建議在安裝 Tableau Server 並確認其按預期運行後安裝獨立閘道。必須有管理員權限、方可安裝。可以安裝一個或多個獨立網關實例,但必須單獨安裝每個獨立網關實例。如果要安裝多個實例以實現高可用性或分配繁重的客戶端負載,請為每個實例重複安裝步驟。

在安裝過程中,會執行名為initialize-tsig.bat的指令碼。該指令碼會提示您提供設定獨立閘道所需的信息。安裝獨立閘道後,需要在 Tableau Server 初始節點中執行 TSM 命令,以使用有關獨立閘道實例的詳細資訊設定伺服器。

IG 安裝包括以下步驟:

  • 執行特定於平台的安裝程式。

  • 執行後續安裝指令碼。這是由安裝程式自動完成。

  • 使用 TSM 啟用獨立閘道實例。

步驟 1:下載並安裝 Tableau Server

  1. 安裝 TSM:遵循本主題中提供的說明完成步驟 1-5,這些步驟執行安裝程式,並安裝 TSM。

  2. 啟用並註冊 Tableau Server:在啟動步驟中提供 Tableau Server 金鑰和 Advanced Management 金鑰。您需要執行下列命令兩次,先使用 Tableau Server 產品金鑰,然後再使用 Advanced Management 產品金鑰:

    tsm licenses activate -k <product key>

  3. 設定初始節點設定:遵循主題中提供的指示設定初始節點設定。

步驟 2:下載並安裝獨立閘道

下載 Tableau Server Independent Gateway 安裝檔案後,請按照下面的步驟安裝 Independent Gateway。

  1. 在要安裝 Independent Gateway 的計算機中,以具有管理員訪問權限的使用者身份登入,然後按兩下已下載的安裝文件。

  2. 在第一個屏幕上,您必須先接受許可協議,然後才能繼續。

  3. 接受許可協議後,可以採取以下兩種操作之一:

    • 按一下安裝來安裝 Independent Gateway
    • 按一下自訂變更安裝位置,然後安裝 Independent Gateway:

      預設將 Independent Gateway 安裝至 C:\Program Files\Tableau\Tableau Server\independentgateway。可以選擇非預設位置,包括不同的磁碟機,可以瀏覽或輸入新路徑。

      指定安裝位置後,按一下安裝在該位置安裝 Independent Gateway。

  4. 該安裝程式會安裝 Independent Gateway,並自動執行initialize-tsig.bat腳本。

    在安裝程式開啟的命令窗口中,系統會提示輸入用於設定 Independent Gateway 的值:

    • TSIG_TS_CLUSTER— 必要。沒有預設值。必須在出現提示時輸入一個值。

      這應該是Tableau Server叢集中每個節點的網際網路位址。可以使用通配符,並且可以使用子網路遮罩來指定多個節點。要指定多個位址,請用空格分隔。必須以 Apache httpd mod_authz_host "Require" 指令可接受的形式之一提供值。有關詳情,請參閱https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(連結在新視窗開啟)

    • TSIG_HK_PORT - 預設值為 21319。這是用於來自 Tableau Server 的傳入內務處理請求的連接埠。
    • TSIG_HK_PROTOCOL - 預設值為 http。有效的值為 http https。這是用於來自 Tableau Server 的內務處理請求的通訊協定。
    • TSIG_PORT - 預設值為 80。用於外部要求的連接埠。
    • TSIG_PROTOCOL - 預設值為 http。有效的值為 http https。這是用於外部請求的通訊協定。
    • TSIG_INSTANCE_ID - 預設為機器名稱。獨立網關實例的唯一識別碼。
  5. 指令碼完成執行並初始化 Independent Gateway 後,安裝完成。

步驟 3:在 Tableau Server 中啟用 Independent Gateway

安裝和設定 Independent Gateway 的最後一步是在 Tableau Server 中啟用 Independent Gateway。為此,請使用 TSM 命令tsm topology external-services gateway enable -c <file>附帶 JSON 文件,該文件標識一個或多個 Independent Gateway 實例,並為 Tableau Server 提供伺服器與 Independent Gateway 之間通信所需的詳細資訊。

Tableau Server 必須處於停止狀態才能啟用 Independent Gateway。

Independent Gateway JSON 文件內容

用於在 Tableau Server 上啟用 Independent Gateway 實例的 JSON 文件需要包含以下內容:

  • id - id 值必須與特定實例的 TSIG_INSTANCE_ID 匹配。如果在初始化期間未提供此資料,則預設為 Independent Gateway 電腦的機器名稱 (%COMPUTERNAME%)。json 文件中的值必須與hostname命令輸出相符。
  • 主機 - 主機必須是 Independent Gateway 電腦的 可解析 DNS 名稱。
  • 連接埠 - 接埠必須與 Independent Gateway 實例中指定的 TSIG_HK_PORT 值匹配。如果在初始化期間未提供此資料,則預設值為“21319”。
  • 協定 - 協定必須與 Independent Gateway 實例中指定的 TSIG_HK_PROTOCOL 匹配。如果在初始化期間未提供此資料,則預設為“http”。
  • authsecret — 身份驗證密碼必須與 Independent Gateway 實例初始化指令碼建立的密碼匹配。

Independent Gateway 身份驗證秘密

初始化指令碼在每台 Independent Gateway 電腦桌建立一個唯一的共享祕密。您需要此密碼才能在 Tableau Server 中啟用 Independent Gateway。複製祕密並將其作為“authsecret”包含在您的 JSON 文件中。

共享祕密位於tsighk-auth.conf文件在這裡:

C:\ProgramData\Tableau\Tableau Server\independentgateway\config\tsighk-auth.conf

Independent Gateway JSON 檔案範例

JSON 檔案應採用以下格式。此範例 JSON 文件顯示使用預設值的預設。您的檔案應該使用與您的 Independent Gateway 安裝和您的組織相匹配的實際值。

{
"independentGateways": [ { "id": "<IGCOMPUTER>", "host": "<DNS name of Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret01>" }, { "id": "<IGCOMPUTER2>", "host": "<DNS name of second Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret02>" } ] }

在 Tableau Server 中啟用 Independent Gateway

要完成 Independent Gateway 的安裝,需要使用 TSM 啟用它。

  1. 將 JSON 組態檔複製到 Tableau Server 的初始節點。
  2. 在初始節點中,以管理員身份開啟命令提示字元。
  3. 執行以下命令以停止 Tableau Server,使用 json 組態檔啟用 Independent Gateway,然後重新啟動伺服器:

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

第四步:驗證 Independent GatewayTableau Server

在瀏覽器中輸入 Independent Gateway 位址後就應該可以導航到 Tableau Server 登入頁面。

如果 Independent Gateway 和後端 Tableau Server 部署之間存在防火牆,則需要為 Tableau Server 處理序開啟連接埠進行直接連線。有關詳細信息,請參閱直接連線

也可以選擇通過為轉送連線設定 Independent Gateway 將連接埠要求降至最低。有關詳細信息,請參閱中繼連線

感謝您的意見反應!已成功提交您的意見回饋。謝謝!