升級 Tableau Server 獨立閘道

本主題將引導您完成升級 Tableau Server 獨立閘道的過程。本主題中描述的過程對於所有版本升級均相同。即您可以將此處理序用於主要版本(例如,2022.1 至 2023.1)與維護版本(2022.1.1 至 2023.1.1)升級。

必須使用與 Tableau Server 版本相符的主要版本的 Tableau Server 獨立閘道安裝程式。我們建議維護版本(例如 2022.1.1或 2022.1.2)也可以,但這不是必需的。如果版本和版本之間的「靜態資產」變更不相符,可能會看到一些意想不到的影像影響。例如,如果 Independent Gateway 的版本早於 Tableau Server,則地圖可能不是最新的。

概觀

獨立閘道的升級過程實際上是一個解除安裝再重新安裝軟體的過程。但是,您可以按照本主題中所述的過程最大限度地減少設定及總體停機時間。

本主題中描述的過程假定您正在執行 Tableau Server 和 Tableau Server 獨立閘道的功能部署。如果要在升級過程中升級後端 Tableau Server 部署,建議首先升級獨立閘道伺服器,驗證與 Tableau 用戶端的基本連線能力,然後再升級 Tableau Server。

本主題中詳細介紹的步驟總結如下:

  1. 複製一些現有檔案以便在升級期間使用。
  2. 執行 obliterate 指令碼以刪除獨立閘道。
  3. 安裝新版本的獨立閘道。
  4. 選用:用原始副本覆寫 tsighk-auth 檔案。
  5. 更新 TLS 設定。
  6. 選用:更新後端 Tableau Server
  7. 重新啟動獨立閘道服務:

第 1 步:複製檔案以供參考

可能需要參考存儲在以下檔案中的組態設定。將這些檔案複製到安全且可存取的位置(檔案路徑是預設位置):

  • /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf
  • /var/opt/tableau/tableau_tsig/config/httpd.conf.stub
  • /etc/opt/tableau/tableau_tsig/environment.bash

第 2 步:刪除獨立閘道

要從伺服器中刪除獨立閘道,請執行 tableau-tsig-obliterate 指令碼:

  1. 在初始節點上,開啟終端會話。

  2. 執行 tableau-tsig-obliterate 指令碼:

    sudo /opt/tableau/tableau_tsig/packages/scripts.<version_code>/tableau-tsig-obliterate -y -y -y

  3. 重新啟動電腦。

第 3 步:安裝獨立閘道

下載要升級到的獨立閘道版本,然後按照主題使用獨立閘道安裝 Tableau Server中所述的相同安裝過程進行操作。

與原始安裝一樣,您需要在設定過程中指定初始化設定。要使用相同的值,請參考在步驟 1 中複製的檔案 enviornment.bash。不要用原始文件覆寫新的 bash 檔案。

第 4 步:(選用)用原始副本覆寫 tsighk-auth 檔案

tsighk-auth 檔案是一個組態檔案,其中存儲了名為 authsecret 的唯一字串。authsecret 用於驗證後端 Tableau Server 是否正在與獨立閘道的受信任執行個體進行通信。設定獨立閘道的原始執行個體時,必須使用 authsecret 更新後端 Tableau Server 上的組態檔案。

如果您的安全策略允許,則可以繼續在獨立閘道上使用原始 authsecret。這樣做可以避免使用新的 authsecret 更新和重新啟動後端 Tableau Server 的過程。

要使用原始 authsecret,請使用在步驟 1 中保存的副本覆寫 tsighk-auth.conf 檔案(位於 /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf) 。

如果您的安全策略要求重新整理 authsecret,請記錄安裝過程生成的新 authsecret。稍後您將使用新的 authsecret 更新後端 Tableau Server。

第 5 步:更新內務處理 TLS 設定

如果您沒有為獨立閘道執行個體和後端 Tableau Server 部署之間的內務處理 (HK) 通信設定 TLS,則可以跳過此步驟。

如果您設定了 HK TLS,則必須手動將設定從原始 httpd.conf.stub 檔案複製到位於 /var/opt/tableau/tableau_tsig/config/httpd.conf.stub 的檔案中。不要用原始檔案腹瀉新檔案,因為較新的檔案可能包含其他設定。

  1. 更新以下區塊中的相關 TLS 組態設定:

    <VirtualHost *:${TSIG_HK_PORT}>
    SSLEngine on
    #TLS# SSLHonorCipherOrder on
    #TLS# SSLCompression off
    SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
    SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
    SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>

    有關這些設定的更多資訊,請參閱在獨立網關上設定 TLS

  2. 完成更新 httpd.conf.stub後, 保存它。

  3. 複製 httpd.conf.stub,然後保存以覆寫同意目錄中的 httpd.conf

第 6 步:(選用)更新後端 Tableau Server 部署

如果將原始 authsecret 檔案 (tsighk-auth.conf ) 複製到獨立閘道的新執行個體,如第 4 步所述,則可以跳過此步驟。

如果在後端 Tableau Server 部署中重新整理 authsecret,則必須使用新 authsecret 更新初始節點中的 tsig.json檔案。參閱使用獨立閘道安裝 Tableau Server完成後,執行以下 TSM 命令:

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

第 7 步:重啟 tsig-httpd 服務

完成設定後,重新啟動 tsig-httpd 服務。

sudo su - tableau-tsig
systemctl --user restart tsig-httpd
exit