伺服器升級 - 收集組態詳細資訊
若您正在執行就地升級(不會在升級過程中更新硬體),則幾乎所有組態資料都會保留下來。嚴格來說,在這種情況下不需要收集所有組態資訊。但是,我們建議您收集本主題中所詳述的資訊。這樣一來,在升級失敗的情況下,如果您需要還原,您就能擁有所有組態資訊的記錄可用了。在任何情況下,都可以使用收集的組態詳細資訊來確認升級的完成與否。
擷取螢幕截圖
擷取組態基本資訊相對較快的方法是擷取 TSM Web 介面和 Tableau Server 管理區域的螢幕截圖。
點閱所有可見頁面並擷取螢幕截圖:
記錄物件計數
位於 Tableau Server 管理區域時,請記下每個站台中的以下項目:
- 專案、工作簿、檢視和資料來源
- 使用者和群組
收集資產檔案
許多上傳到 Tableau Server 的支援檔案(憑證、IdP 中繼資料、標誌等)都無法在上傳後以 TSM 存取。具體而言,經由用戶端檔服務上傳與管理的檔案,會先經過重新命名和混淆處理,之後再分散到部署中。此過程也會將 Tableau 服務所需的檔案屬性參數化。因此,以下檔案不會對應檔案系統中的單一檔案位置。如果您已上傳以下任何檔案,請務必從執行 Tableau Server 的電腦中儲存這些檔案的複本:
- SAML 憑證檔案
- SAML 金鑰檔案
- SAML IdP 中繼資料檔案
- OpenID.static.file
- Kerberos.keytab 檔案
- LDAP Kerberos Keytab 檔案
- LDAP Kerberos 組態檔
- 相互 SSL 憑證檔案
- 相互 SSL 撤銷檔案
- 自訂標頭標誌檔案
- 自訂登入標誌檔案
- 自訂精簡標誌檔案
收集自訂設定資訊
部分組態資訊不會顯示在 TSM 或 Tableau Server 網頁中。根據您自訂 Tableau 部署的方式,這個部分包含您可能需要收集的組態詳細資訊。
安全 SMTP
如果您已設定 Tableau Server 的 TLS,就需要記錄與 TLS 相關組態,但不包括在 TSM Web UI 中的電子郵件伺服器組態。
如要收集與 TLS 相關的組態,您必須使用以下機碼值執行 tsm configuration get
:
svcmonitor.notification.smtp.ssl_enabled
svcmonitor.notification.smtp.ssl_required
svcmonitor.notification.smtp.ssl_check_server_identity
svcmonitor.notification.smtp.ssl_trust_all_hosts
svcmonitor.notification.smtp.ssl_ciphers
svcmonitor.notification.smtp.ssl_versions
舉例來說,如要擷取針對 SMTP TLS 設定的密碼清單,請執行以下命令:
tsm configuration get -k svcmonitor.notification.smtp.ssl_ciphers
您可以在設定 SMTP 設定的 TSM CLI 部份中找到上述每個金鑰的相關詳細資訊 。
分析擴充
如果您已設定 Analytics 擴充(過去的「外部服務」),您需要記錄組態資訊。升級到 Tableau Server 2020.2 或之後版本將會移除此功能的所有組態。
若要擷取 Tableau Server 版本 2019.1 到 2020.1 的 Analytics 擴充組態,請執行以下命令:
tsm security vizql-extsvc-ssl list
若要檢索為分析擴充連線存放的密碼(如果有),請執行以下 tsm 命令:
tsm configuration get -k vizqlserver.rserve.password
如果您已設定 SSL,您也必須複製 Analytics 擴充的憑證。
外部存放庫
這僅在透過 Tableau Server 使用外部存放庫組態時套用。 若您不確定是否適用, 請參閱 Tableau Server 外部存放庫。
如果使用的是外部存放庫,則升級時可能需要執行其他步驟。
- 無版本變更— 如果 PostgreSQL 中沒有版本變更,則不需要執行任何特殊動作。
- 次要版本變更— 如果 PostgreSQL 中有次要版本變更,需要在升級 Tableau Server 之前升級外部存放庫。在大多數情況下,有這樣做的就地方法。您使用的方法取決於存放庫的位置,超出了本文件的範圍。
主要版本變更— 如果 PostgreSQL 中有主要版本變更,需要按照使用外部存放庫升級 Tableau Server,以取得全新的 PostgreSQL 主要版本中描述的步驟進行動作。
步驟包括:
- 建立 PostgreSQL 資料庫的全新執行個體。有關詳情,請參閱:
- 建立組態檔並下載步驟 1 中建立的新執行個體 SSl 憑證檔。
在升級期間,您需要使用組態檔將 Tableau Server 指向全新執行個體。升級過程會將內容從目前外部存放庫移轉到全新執行個體。有關詳情,請參閱 使用外部存放庫升級 Tableau Server,以取得全新的 PostgreSQL 主要版本。
外部檔案存放區
升級設定有外部文件存放區的 Tableau Server 時不需要特殊的步驟、動作或設定。可以使用正常過程升級 Tableau Server。
連接埠自訂
如果您變更了動態連接埠範圍或手動設定 Tableau Server 的連接埠,請記錄所做變更。
執行以下命令:
tsm topology list-ports
有關詳情,請參閱 Tableau 服務管理員埠。
Proxy 自訂
若正在使用 OAuth,並且對<drive>:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\conf
資料夾中 Tableau Server 的 net.properties
檔案進行了任何變更,則應記錄所做的變更。升級流程會建立一個新的 net.properties
檔案,升級後可能需要更新新的檔案。
可以將複本儲存到安全的位置,並在升級後將它與新建立的檔案進行比較,以瞭解任何差異。
有關詳細資訊,請參閱 Tableau Desktop 和 Web 製作說明中的為 OAuth 驗證設定 Proxy(連結在新視窗開啟) 。