對身份移轉問題進行疑難排解

套用到： Tableau Server

無法還原備份

升級到 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，而不會出現任何問題。

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

返回頂端
感謝您的意見回饋！