使用獨立閘道安裝 Tableau Server

套用到： Tableau Advanced Management

本主題將引導您完成安裝 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 Management 在 Tableau 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 並確認其按預期運行後安裝獨立閘道。必須是 root 用戶（或能夠 sudo 到 root）方可安裝。可以安裝一個或多個獨立網關實例，但必須單獨安裝每個獨立網關實例。如果要安裝多個實例以實現高可用性或分配繁重的客戶端負載，請為每個實例重複安裝步驟。

安裝後，系統會提示執行名為initialize-tsig的指令碼完成安裝。該指令碼使用參數獲取您提供的信息，並配置獨立閘道。安裝獨立閘道後，需要在初始 Tableau Server 節點中執行 TSM 命令，以使用有關獨立閘道實例的詳細信息來配置伺服器。

IG 安裝包括以下步驟：

執行特定於平台的安裝程式。
執行後續安裝指令碼。
使用 TSM 啟用獨立閘道實例。

步驟 1：下載並安裝 Tableau Server

安裝和初始化 TSM：遵循本主題中提供的說明完成步驟 1-5，這些步驟執行安裝程式，並安裝 TSM。
啟用並註冊 Tableau Server：在啟動步驟中提供 Tableau Server 金鑰和 Advanced Management 金鑰。您需要執行下列命令兩次，先使用 Tableau Server 產品金鑰，然後再使用 Advanced Management 產品金鑰：
tsm licenses activate -k <product key>
設定初始節點設定：遵循主題中提供的指示設定初始節點設定。

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

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

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

以具有 sudo 存取權限的使用者身分登入到要在其中安裝 Independent Gateway 的電腦。
附註：為避免可能出現的複雜情況，我們建議使用不包含任何特殊字元（例如，非 ASCII、「+」、「-」）的使用者帳戶。這些可能會造成問題，包括無法完全安裝 Independent Gateway，具體取決於環境的設定方式。
從 Tableau Server 下載和版本說明頁面下載 .rpm 或 .deb 安裝套裝程式。
巡覽到您在其中複製了 .rpm 或 .deb 套裝軟體的目錄。
使用套裝軟體管理器來安裝 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指令碼。

巡覽到 scripts 目錄：

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

執行下列指令碼初始化並啟動 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 啟用它。

將 JSON 組態檔複製到 Tableau Server 的初始節點。
在初始解點鐘，使用為 tsmadmin 群組成員的帳戶開啟命令提示字元。
執行以下命令以停止 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 將連接埠要求降至最低。有關詳細信息，請參閱中繼連線。

返回頂端

感謝您的意見反應！

已成功提交您的意見回饋。謝謝！

Linux 版 Tableau Server 說明