使用獨立閘道安裝 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,則地圖可能不是最新的。
  • 您必須在 Tableau Server 啟用有效的 Advanced Management 授權 。若要深入瞭解 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 並確認其按預期運行後安裝獨立閘道。必須是 root 用戶(或能夠 sudo 到 root)方可安裝。可以安裝一個或多個獨立網關實例,但必須單獨安裝每個獨立網關實例。如果要安裝多個實例以實現高可用性或分配繁重的客戶端負載,請為每個實例重複安裝步驟。

安裝後,系統會提示執行名為initialize-tsig的指令碼完成安裝。該指令碼使用參數獲取您提供的信息,並配置獨立閘道。安裝獨立閘道後,需要在初始 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:下載並安裝獨立閘道

使用發行版本的套裝軟體管理器安裝 ,然後執行指令碼以初始化 Independent Gateway。安裝的套裝軟體附帶了該指令碼。

獨立閘道安裝在 /opt 目錄中。

  1. 以具有 sudo 存取權限的使用者身分登入到要在其中安裝 Independent Gateway 的電腦。

    附註:為避免可能出現的複雜情況,我們建議使用不包含任何特殊字元(例如,非 ASCII、「+」、「-」)的使用者帳戶。這些可能會造成問題,包括無法完全安裝 Independent Gateway,具體取決於環境的設定方式。

  2. Tableau Server 下載和版本說明頁面下載 .rpm.deb 安裝套裝程式。

  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 Server 使用者授權合約 (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 指令碼的說明輸出

步驟 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 電腦的完整網域名稱,小寫字母形式顯示。json 文件中的值必須與hostname命令輸出相符。
  • 主機 - 主機值必須是 Independent Gateway 電腦的可解析 DNS 名稱,可以由 Tableau Server 節點使用 DNS 解析。
  • 連接埠 - 連接埠必須與 Independent Gateway 實例中指定的內務連接埠匹配(tsig_housekeeping_port)。如果在初始化期間未提供此資料,則預設值為“21319”。
  • 協定 - 協定必須與 Independent Gateway 實例中指定的內務協定(tsig_housekeeping_port_protocol)。如果在初始化期間未提供此資料,則預設為“http”。
  • authsecret — authsecret 必須與在 Independent Gateway 實例初始化指令碼建立的密鑰匹配。

Independent Gateway 身份驗證秘密

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

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

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

Independent Gateway JSON 檔案範例

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

{
"independentGateways": [ { "id": "<mycomputer.example.com>", "host": "<DNS name of Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret01>" }, { "id": "<mycomputer2.example.com>", "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. 在初始解點鐘,使用為 tsmadmin 群組成員的帳戶開啟命令提示字元。
  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 將連接埠要求降至最低。有關詳細信息,請參閱中繼連線

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