--- schema_version: "1" id: 109eaf97d62f74b4d30c34d0732463a37d05871111b9835c4c2c5c2b6db598dd title: 管理身份迁移 collection: tableau version: current locale: zh-cn portal_url: https://docs.salesforce.com/tableau/current/zh-cn/server/identity_migration_manage.md canonical_url: https://help.tableau.com/current/server/zh-cn/identity_migration_manage.htm source_site: help.tableau.com content_type: documentation content_hash: 39fb8d5b2f5c7e7c5503a5db291ccdbe21100faa1ad665d58be7f584ea91908d description: Monitor and manage identity migration jobs and settings on Tableau Server. --- [跳转到主要内容](#main-content) # 管理身份迁移 作为管理员，您可以通过 Tableau Server 的“用户”页面中提供的专用“身份迁移”页面监控和管理身份迁移，包括更改迁移作业的运行时间。此页面在迁移过程中可用。 ![身份迁移概览页面。](/tableau/current/zh-cn/server/zh-cn/Img/id_mig_main.png) 迁移作业设计为在后台运行，而不会中断或干扰 Tableau Server 的使用。但是，如果需要，您可以进行调整以影响迁移作业的运行频率、迁移作业的运行时间以及迁移作业的运行时长。 通常，迁移可能需要 3 分钟到 10 天不等，具体取决于 Tableau Server 部署的大小以及您在迁移期间对默认设置所做的任何更改。举例来说，如果您有 10,000 个用户，则迁移可能需要大约 30 分钟。 **注意：**在迁移作业运行时，所有身份验证和与用户相关的功能都正常工作。 ## 管理身份迁移作业 您可以管理身份迁移的以下方面。 解决身份冲突 若要查看迁移期间可能遇到的身份冲突，请参见[解决身份迁移冲突](https://help.tableau.com/current/server/zh-cn/identity_migration_conflicts.htm)。 更改每日迁移作业计划 1. 以管理员身份登录到 Tableau Server。 2. 从左侧导航窗格中，选择“用户”（或者，对于多站点 Tableau Server，为“所有站点”\>“用户”），然后单击“身份迁移”页面。 1. 在“迁移概述”标题旁边，单击“编辑计划”按钮。 2. 在“编辑计划”对话框中，更改作业的运行时间和频率。 **注意：**您可以忽略此对话框中的“优先级”和“执行”选项。 ![“编辑计划”对话框，其中包含用于编辑迁移频率的选项。](/tableau/current/zh-cn/server/zh-cn/Img/id_mig_schedule.png) 3. 完成后单击“更新”。 启动迁移作业 1. 以管理员身份登录到 Tableau Server。 2. 从左侧导航窗格中，选择“用户”（或者，对于多站点 Tableau Server，为“所有站点”\>“用户”），然后单击“身份迁移”页面。 1. 从任何选项卡中，选择一个或多个用户。 2. 从“操作”菜单中，选择“重试迁移”或“确认”，具体取决于您需要执行的操作。 ![“身份迁移操作”下拉菜单，其中包含“重试迁移”或“确认”选项。](/tableau/current/zh-cn/server/zh-cn/Img/id_mig_actions.png) 3. 在“迁移概述”标题旁边，单击“编辑计划”下拉箭头。 4. 选择“立即运行”。 ![用于编辑迁移计划的下拉菜单，其中突出显示了立即运行选项。](/tableau/current/zh-cn/server/zh-cn/Img/id_mig_runnow.png) 暂停身份迁移 1. 以管理员身份登录到 Tableau Server。 2. 从左侧导航窗格中，选择“用户”（或者，对于多站点 Tableau Server，为“所有站点”\>“用户”），然后单击“身份迁移”页面。 1. 在“迁移概述”标题旁边，单击“编辑计划”下拉箭头。 2. 选择“禁用”。 重新启动身份迁移 1. 以管理员身份登录到 Tableau Server。 2. 从左侧导航窗格中，选择“用户”（或者，对于多站点 Tableau Server，为“所有站点”\>“用户”），然后单击“身份迁移”页面。 1. 在“迁移概述”标题旁边，单击“编辑计划”下拉箭头。 2. 选择“启用”。 ## 更改身份迁移设置 为了减少身份迁移可能对您的 Tableau Server 造成的任何潜在压力，迁移配置为使用下面列出的默认设置运行。 ### 迁移设置
类型tsm 命令默认程序
作业计划不可用每天凌晨 3:00，直到完成可通过“身份迁移”页面配置，请参见上面的更改每日迁移作业计划。
每秒用户身份请求数（速率）tsm authentication identity-migration configure -–rate最多 5 个

如果需要，您可以使用 tsm authentication identity-migration 命令，使用以下步骤更改上面列出的迁移设置。

  1. 在群集中的初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。

  2. 运行 tsm authentication identity-migration 中描述的一个或两个命令。

    例如，若要更改单个作业的运行时间和速率的默认值，您可以运行以下命令：

    tsm authentication identity-migration configure --job-run-time 180 --rate 3

单个作业运行时间tsm authentication identity-migration configure -–job-run-time120 分钟
启用身份迁移tsm configuration set -k features.IdentityMigrationBackgroundJobfalse

通过启用身份迁移，Tableau Server 可以使用身份服务来存储和管理用户身份信息。

  1. 在群集中的初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。

  2. 运行以下命令：

    tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

注意：身份迁移和身份服务是身份池等某些功能的先决条件。有关 tsm 命令的详细信息，请参见 features.IdentityMigrationBackgroundJob。

### 禁用身份迁移 如果您已升级到 Tableau Server 版本 2021.4.21、2022.1.17、2022.3.9 和 2023.1.5，您可能需要禁用身份迁移。通过禁用身份迁移，Tableau Server 将无法使用身份服务来存储和管理用户身份信息。 1. 在群集中的初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。 2. 运行以下命令： `tsm configuration set -k features.IdentityMigrationBackgroundJob -v false` **注意：**身份迁移和身份服务是[身份池](https://help.tableau.com/current/server/zh-cn/identity_pools.htm)等某些功能的先决条件。 ## 完成身份迁移并配置身份服务 在解决所有用户冲突并运行迁移作业后，您必须将 Tableau Server 配置为使用身份服务来完成身份迁移过程。 ### 步骤 1：验证并完成身份迁移 1. 以管理员身份登录到 Tableau Server。 2. 从左侧导航窗格中，选择“用户”（或者，对于多站点 Tableau Server 为“所有站点”\>“用户”），然后单击“身份迁移”页面以验证迁移是否已开始。 您可以使用 Tableau Server 用户页面中提供的专用“身份迁移”页面来监控和管理其进度。有关详细信息，请参见[管理身份迁移](#)。 3. 按照[解决身份迁移冲突](https://help.tableau.com/current/server/zh-cn/identity_migration_conflicts.htm)中所述解决或确认所有身份冲突，以便“所有故障”选项卡显示“0”，如下图所示。 ![显示零失败的身份迁移摘要。](/tableau/current/zh-cn/server/zh-cn/Img/id_mig_failures_acknowledge.png) 4. 执行以下操作_之一_： - 若要立即运行身份迁移作业，请单击“迁移概述”标题旁边的“编辑计划”下拉箭头，然后选择“立即运行”。 ![用于编辑迁移计划的下拉菜单，其中包含禁用或立即运行的选项。](/tableau/current/zh-cn/server/zh-cn/Img/id_mig_overview_runnow.png) - 或者，您可以等待迁移作业在下一个计划时间运行。 5. 迁移完成后，从“身份迁移”页面验证“身份迁移”是否显示“100% 完成”。 ![显示 100％ 完成的身份迁移进度条。](/tableau/current/zh-cn/server/zh-cn/Img/id_mig_complete.png) ### 步骤 2：将 Tableau Server 配置为使用身份服务 1. 在群集中的初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。 2. 根据您正在运行的 Tableau Server 版本运行以下命令： - 对于 Tableau Server 版本 2022.1.8（及更高版本）、2022.3.10（及更高版本）、2023.1.6（及更高版本）及更高版本： ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false ``` - 对于 Tableau Server 版本 2022.1-2022.1.7、2022.3-2022.3.9 或 2023.1-2023.1.5： ``` tsm authentication legacy-identity-mode disable ``` **注意：**运行上述命令之一后，专用“身份迁移”页面将被移除，并且不再可访问。仅当 `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled` 为 `true` 或者启用 `tsm authentication legacy-identity-mode` 之后，该页面才可访问。 在 Tableau Server 配置为使用身份服务后，当用户登录到 Tableau Server 时，Tableau Server 会使用他们在配置的身份存储中的标识符来搜索他们的用户身份。从标识符中，将返回并使用通用唯一标识符 (UUID) 来匹配现有 Tableau Server 用户身份。然后，此过程为用户生成会话并完成身份验证工作流程。 ### 步骤 3：启用身份池 1. 运行以下命令： ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **注意：**运行这些命令会导致 Tableau Server 重新启动。