無法還原備份

升級到 Tableau Server 2022.1(或更新版本)後,還原 Tableau Server 備份會導致以下錯誤:

「Tableau Server 預設使用新的身份服務表,因此無法還原備份。」

出現此問題的原因是 Tableau Server 需要執行身份移轉。移轉是填充身份服務必需的,身份服務是 Tableau Server 2022.1(及更新版本)用於佈建和驗證用戶的身份架構。為防止出現任何潛在問題,當 Tableau Server 檢測到 Tableau Server 備份使用與 Tableau Server 2022.1(或更新版本)不同的身份架構時,升級過程將無法繼續。

若要解決此問題,請執行以下步驟:

第 1 步:啟用 legacy-idenity-mode 並還原備份

  1. 在叢集中的初始節點(安裝 TSM)上以管理員身分開啟命令提示字元。
  2. 通過執行以下命令,將 Tableau Server 2022.1(或更新版本)設定為使用舊身分識別存放區模式:

    tsm authentication legacy-identity-mode enable
    tsm pending-changes apply

    Tableau Server 必須使用舊身分識別存放區模式來填充身份服務。有關 tsm 命令的詳情,請參閱 tsm authentication legacy-identity-mode

  3. 執行以下命令以再次還原備份並啟動移轉:

    tsm maintenance restore --file <file_name>
    tsm start

    重要提示:備份還原後,移轉會使用身份資訊填充身份服務。

第 2 步:驗證並完成身份移轉

  1. 以管理員身分登入 Tableau Server。
  2. 在左側巡覽窗格中,選取使用者(或多站台 Tableau Server 的所有站台>使用者),然後按一下身份移轉頁面以驗證移轉是否已開始。

    可以使用 Tableau Server 使用者頁面中提供的專用身份移轉頁面來監控和管理其進度。有關詳情,請參閱管理身份移轉

  3. 解決或確認所有身分衝突,如解決身份移轉衝突中所述,以便所有失敗索引標籤顯示「0」,如下圖所示。

  4. 執行以下其中一項動作:

    • 要立即執行身份移轉作業,請按一下「移轉概觀」標題旁邊的「編輯排程」下拉式箭頭,然後選取「立即執行」

    • 或者,可以等待移轉作業在下一個排程時間執行。
  5. 移轉完成後,從「身分移轉」頁面驗證「移轉概觀」是否顯示100% 完成

步驟 3:將 Tableau Server 配置為使用身份服務

  1. 在叢集中的初始節點(安裝 TSM)上以管理員身分開啟命令提示字元。
  2. 執行以下命令:

    tsm authentication legacy-identity-mode disable
    tsm pending-changes apply

    附註:執行上述命令後,專用的身分移轉頁面將被移除且無法再存取。僅當啟用 tsm authentication legacy-idenity-mode 時才能存取該頁面。

在 Tableau Server 配置為使用身份服務後,當使用者登入到 Tableau Server 時,Tableau Server 會使用他們在配置身份存放區中的識別碼來搜尋他們的使用者身份。識別碼會傳回通用唯一識別碼 (UUID) 並用於符合的現有 Tableau Server 使用者身份。然後,此過程為使用者產生工作階段並完成身份驗證工作流程。

身份移轉頁面上的「意外錯誤」

從身份移轉頁面解決或確認所有使用者身份後,會看到「意外錯誤」訊息。嘗試一次解決或確認超過 1000 個使用者身份時,可能會顯示此訊息。

要解決此問題,請選取並解決或確認 1000 個或更少的使用者身份,然後再試一次。

有關管理身份衝突的更多資訊,請參閱解決身份移轉衝突

移轉進度顯示失去回應或卡住

如果移轉狀態或移轉進度條顯示失去回應或卡住,請確認已解決並確認「移轉失敗」下的所有使用者衝突。

要解決此問題,請在所有失敗索引標籤中選取一或多個使用者身份,並從「動作」下拉式功能表中點一下「確認」來確保解決並確認所有衝突。執行此任務,直到所有失敗索引標籤顯示為「0」。有關管理身份衝突的更多資訊,請參閱解決身份移轉衝突

注意:解決所有身份衝突之後,還必須執行所有移轉作業,然後才能為 Tableau Server 啟用身份服務。現在可以點一下移轉概觀標題旁邊的「編輯排程」下拉箭頭,然後選取「立即執行」來執行移轉作業。「移轉概觀」顯示100% 完成時,就可以將 Tableau Server 設定為使用身份服務。有關詳情,請參閱步驟 3:將 Tableau Server 設定為使用身份識別服務

身分移轉頁面消失

身分移轉完成並且 Tableau Server 設定為使用身分服務時,專用的身分移轉頁面將被移除,並且不再可存取。只有在進行身分移轉或啟用 tsm authentication legacy-idenity-mode 時,才需要身分移轉頁面。

還原身份移轉

如果存在您認為是由身份服務引起的問題,例如某些使用者無法登入 Tableau Server,可以使用tsm authentication legacy-identity-mode命令以還原使用舊身分識別存放區模式。還原後,身份移轉後新增的新使用者和移轉前只能登入 Tableau Server 的使用者都可以登入 Tableau Server,而不會出現任何問題。

從身份服務還原到舊身分識別存放區模式後,可以使用身份移轉頁面為有問題的使用者身份執行移轉。有關管理身份衝突的更多資訊,請參閱解決身份移轉衝突

感謝您的意見回饋!