--- schema_version: "1" id: c132f0eb844baf68afc151b2b85d16276f73eeda4eb082cb60513bd5ef9674f5 title: 對身份移轉問題進行疑難排解 collection: tableau version: current locale: zh-tw portal_url: https://docs.salesforce.com/tableau/current/zh-tw/server/identity_migration_troubleshoot.md canonical_url: https://help.tableau.com/current/server/zh-tw/identity_migration_troubleshoot.htm source_site: help.tableau.com content_type: documentation content_hash: e8e7c6d9e8c336b11c9bacaadf77e79b9f0bebc5b96298a0c1c2dbefe2dc1043 description: Troubleshoot identity migration issues such as backup restore failures. --- [跳至主要內容](#main-content) # 對身份移轉問題進行疑難排解 ## 無法還原備份 升級至使用身分服務作為預設結構描述的 Tableau Server 版本（版本 2022.1-2022.1.7、2022.3-2022.3.9 和 2023.1-2023.15）後，還原 Tableau Server 備份可能會導致下列錯誤： _「Tableau Server 預設使用新的身份服務表，因此無法還原備份。」_ 如果 Tableau Server 需要執行身分移轉（這是填入身分識別服務的必要程序），可能會發生此問題。身分服務是一種身分結構描述，從版本 2022.1 開始引入到 Tableau Server 的多個版本中，用於佈建和驗證使用者。為防止任何潛在問題，Tableau Server 偵測到 Tableau Server 備份所使用的身分架構與其要還原到的版本不同時，還原程序將無法繼續。 若要解決此問題，請執行以下步驟： **重要提示：**下述程序僅適用於您執行的是 Tableau Server 版本 2022.1.0-2022.1.7、2022.3.0-2022.3.9 和 2023.1.0-2023.15。 ### 第 1 步：啟用 `legacy-identity-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`](https://help.tableau.com/current/server/zh-tw/cli_authentication_tsm.htm#tsm_identity_mig_legacy)。 3. 執行以下命令以再次還原備份並啟動移轉： ``` tsm maintenance restore --file tsm start ``` **重要提示：**備份還原後，移轉會使用身份資訊填充身份服務。有關使用備份還原的一般資訊，請參閱[還原備份內容](https://help.tableau.com/current/server/zh-tw/db_restore.htm)。 ### 第 2 步：驗證並完成身份移轉 1. 以管理員身分登入 Tableau Server。 2. 在左側巡覽窗格中，選取使用者（或多站台 Tableau Server 的所有站台\>使用者），然後按一下身份移轉頁面以驗證移轉是否已開始。 可以使用 Tableau Server 使用者頁面中提供的專用身份移轉頁面來監控和管理其進度。有關詳情，請參閱[管理身份移轉](https://help.tableau.com/current/server/zh-tw/identity_migration_manage.htm)。 3. 解決或確認所有身分衝突，如[解決身份移轉衝突](https://help.tableau.com/current/server/zh-tw/identity_migration_conflicts.htm)中所述，以便所有失敗索引標籤顯示「0」，如下圖所示。 ![顯示零失敗的身分遷移摘要。](/tableau/current/zh-tw/server/zh-tw/Img/id_mig_failures_acknowledge.png) 4. 執行以下_其中一項_動作： - 要立即執行身份移轉作業，請按一下「移轉概觀」標題旁邊的「編輯排程」下拉式箭頭，然後選取「立即執行」 。 ![編輯移轉排程的下拉式功能表，其中包含停用或立即執行選項。](/tableau/current/zh-tw/server/zh-tw/Img/id_mig_overview_runnow.png) - 或者，可以等待移轉作業在下一個排程時間執行。 5. 移轉完成後，從「身分移轉」頁面驗證「移轉概觀」是否顯示100% 完成。 ![身分移轉進度條，顯示 100% 完成。](/tableau/current/zh-tw/server/zh-tw/Img/id_mig_complete.png) ### 步驟 3：將 Tableau Server 配置為使用身份服務 1. 在叢集中的初始節點（安裝 TSM）上以管理員身分開啟命令提示字元。 2. 執行以下命令： ``` tsm authentication legacy-identity-mode disable tsm pending-changes apply ``` **附註：**執行上述命令後，專用的身分移轉頁面將被移除且無法再存取。僅當啟用 `tsm authentication legacy-identity-mode` 時才能存取該頁面。 在 Tableau Server 配置為使用身份服務後，當使用者登入到 Tableau Server 時，Tableau Server 會使用他們在配置身份存放區中的識別碼來搜尋他們的使用者身份。識別碼會傳回通用唯一識別碼 (UUID) 並用於符合的現有 Tableau Server 使用者身份。然後，此過程為使用者產生工作階段並完成身份驗證工作流程。 ### 步驟 4：確保身分集區已啟用 1. 執行以下命令： ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **附註：**執行這些命令會導致 Tableau Server 重新啟動。 ## 身份移轉頁面上的「意外錯誤」 從身份移轉頁面解決或確認所有使用者身份後，會看到「意外錯誤」訊息。嘗試一次解決或確認超過 1000 個使用者身份時，可能會顯示此訊息。 要解決此問題，請選取並解決或確認 1000 個或更少的使用者身份，然後再試一次。 有關管理身份衝突的更多資訊，請參閱[解決身份移轉衝突](https://help.tableau.com/current/server/zh-tw/identity_migration_conflicts.htm)。 ## 移轉進度顯示失去回應或卡住 如果移轉狀態或移轉進度條顯示失去回應或卡住，請確認已解決並確認「移轉失敗」下的所有使用者衝突。 ![身分移轉進度條停留在完成度 37%。](/tableau/current/zh-tw/server/zh-tw/Img/id_mig_overview_stuck.png) 要解決此問題，請在所有失敗索引標籤中選取一或多個使用者身份，並從「動作」下拉式功能表中點一下「確認」來確保解決並確認所有衝突。執行此任務，直到所有失敗索引標籤顯示為「0」。有關管理身份衝突的更多資訊，請參閱[解決身份移轉衝突](https://help.tableau.com/current/server/zh-tw/identity_migration_conflicts.htm)。 ![兩個移轉失敗摘要的比較。](/tableau/current/zh-tw/server/zh-tw/Img/id_mig_complete_compare.png) **注意：**解決所有身份衝突之後，還必須執行所有移轉作業，然後才能為 Tableau Server 啟用身份服務。現在可以點一下移轉概觀標題旁邊的「編輯排程」下拉箭頭，然後選取「立即執行」來執行移轉作業。「移轉概觀」顯示100% 完成時，就可以將 Tableau Server 設定為使用身份服務。有關詳情，請參閱[步驟 3：開始身分移轉](https://help.tableau.com/current/server/zh-tw/identity_migration.htm#step3)。 ## 「身分移轉進行中」快顯仍然存在 儘管完成了身分移轉，但因為尚未啟用身分服務，「身分移轉進行中」通知仍然存在。要完成身分移轉，需要在[步驟 4：完成身分移轉](https://help.tableau.com/current/server/zh-tw/identity_migration.htm#step4)中啟用身分服務，以便 Tableau Server 可以使用啟用身分集區功能的身分結構。 ## 身分移轉頁面消失 身分移轉完成並且 Tableau Server 設定為使用身分服務時，專用的身分移轉頁面將被移除，並且不再可存取。只有在進行身分移轉或啟用 `tsm authentication legacy-identity-mode` 時，才需要身分移轉頁面。 ## 使用者無法登入 身分移轉完成並啟用身分服務後，某些使用者無法登入 Tableau Server。大多數情況下，有身分衝突並隨後在身分移轉過程中**得到確認**的使用者會發生此問題。已確認的使用者身分不會移轉到身分服務，隨後在 Active Directory (AD) 或 LDAP 群組同步期間將被忽略。 如果與這些已確認的使用者身分關聯的使用者需要再次存取 Tableau Server，請手動將使用者新增至 Tableau Server。手動新增使用者後，後續 AD 或 LDAP 群組同步將識別使用者身分並如預期進行同步。 ## 還原身份移轉 如果存在您認為是由身份服務引起的問題，例如某些使用者無法登入 Tableau Server，可以使用[`tsm authentication legacy-identity-mode`](https://help.tableau.com/current/server/zh-tw/cli_authentication_tsm.htm#tsm_identity_mig_legacy)命令以還原使用舊身分識別存放區模式。還原後，身份移轉後新增的新使用者和移轉前只能登入 Tableau Server 的使用者都可以登入 Tableau Server，而不會出現任何問題。 從身份服務還原到舊身分識別存放區模式後，可以使用身份移轉頁面為有問題的使用者身份執行移轉。有關管理身份衝突的更多資訊，請參閱[解決身份移轉衝突](https://help.tableau.com/current/server/zh-tw/identity_migration_conflicts.htm)。