安装
要使用 lsdoctor,您必须下载附加到本文的 ZIP 文件。 然后,使用您选择的文件移动实用程序(例如 WinSCP),将整个 ZIP 目录复制到要在其上运行它的节点。
注意:如果您使用 WinSCP 连接到 vCenter 设备遇到问题,请参见
Error when uploading files to vCenter Server Appliance using WinSCP。
将该工具复制到系统后,解压文件:
Windows:
右键单击文件,然后单击 "提取所有 ..."
VCSA将目录更改为文件的位置,然后运行以下命令:
unzip lsdoctor.zip
注意:运行该工具时,请确保您当前位于 "lsdoctor-master" 目录中。
启动工具
首先,确保您在 lsdoctor-master 目录中的命令行(VCSA 的 SSH 会话或 Windows 中的命令提示符)。
要运行 lsdoctor,请使用以下命令:
VCSApython
lsdoctor.py --help
Windows“%VMWARE_PYTHON_BIN%”
lsdoctor.py --help
注意:如果在 Windows 中运行脚本时遇到问题,请运行以下操作:
echo "%VMWARE_PYTHON_BIN%"。
对 python 的路径使用结果值。 例如:
"C:\Program Files\VMware\vCenter Server\python\python.exe" lsdoctor.py --help
功能
跳转到函数:
--lscheck--pscHaUnconfigure--stalefix--trustfix--solutionusers --rebuild
-l, --lscheck
此选项将检查 lookup service 中的常见问题。 不会对环境进行任何更改。 这将显示在 SSO 域 中的任何节点上发现的问题。 请参见发现结果和 JSON 报告的路径。
操作说明:
- 将 lsdoctor 复制并提取到任何节点的文件系统中
- 运行 "python lsdoctor.py-l"
- 提供 SSO 管理员帐户的密码
- 查看发现的问题的输出。 每个节点都将由其 SSO 站点 ,然后是其主机名或 PNID
执行所需的操作:
-p、--pscHaUnconfigure
此选项在移除 PSC HA 配置(负载平衡器后面的多个外部 Psc)时使用。 要使用此选项,请执行以下步骤:
操作说明:
- 对于负载平衡器后面的每个 PSC:
- 将 lsdoctor 复制并提取到文件系统
- 运行 "python lsdoctor.py-p"
- 验证您是否已创建相应的快照
- 提供 SSO 管理员帐户的密码
- 脚本完成后,移至负载平衡器后面的下一个节点。
执行所需的操作:
-s、--stalefix
此选项将清理从5.x 升级的系统中留下的任何失效配置。
操作说明:
- 将 lsdoctor 复制并提取到受影响节点的文件系统中
- 运行 "python lsdoctor.py-s"
- 验证您是否已创建相应的快照
- 提供 SSO 管理员帐户的密码
执行所需的操作:
- 脚本完成后, 重新启动所有服务 。
- 重新注册以前指向受影响的节点(SRM、vSphere Replication、NSX V 等)的所有外部解决方案–请参见产品文档了解相关说明)。
-t、--trustfix
此选项纠正了 lookup service 中的 SSL 信任不匹配问题。 Lookup service 注册可能具有与节点的端口443上的 MACHINE_SSL_CERT 不匹配的 SSL 信任值。 出现此问题的原因可能是在证书替换期间出现故障,以及其他故障。
操作说明:
- 将 lsdoctor 复制并提取到同一 SSO 站点中任何节点的文件系统中 为受影响的节点
- 运行 "python lsdoctor.py-t"
- 验证您是否已创建相应的快照
- 提供 SSO 管理员帐户的密码
执行所需的操作:
- 脚本完成后, 重新启动 SSO 站点中所有节点上的所有服务
- 重新注册以前指向受影响节点(SRM、vSphere Replication、NSX V 等)的所有外部解决方案
-u、--solutionusers
此选项用于为节点重新创建解决方案用户。 解决方案用户可能会丢失或不一致,但此脚本将删除任何现有条目,然后从头开始重新创建。
操作说明:
- 将 lsdoctor 复制并提取到受影响节点的文件系统中
- 运行 "python lsdoctor.py-u"
- 验证您是否已创建相应的快照
- 提供 SSO 管理员帐户的密码
- 脚本完成后, 重新启动该节点上的所有服务
执行所需的操作:
-r、--rebuild
为给定节点重新构建一个或所有服务注册时,将使用此选项。 此操作会执行最重要的更改,因此应采取额外的措施来确保可以进行安全回滚(请参见影响/风险部分)。
操作说明:
- 将 lsdoctor 复制并提取到同一 SSO 站点中任何节点的文件系统中 为受影响的节点
- 运行 "python lsdoctor.py-r"
- 验证您是否已创建相应的快照
- 提供 SSO 管理员帐户的密码
- 您将看到一个菜单:
注意: 版本、部署类型和主机名引用在您的环境中是唯一的。
方案 1:
仅当 lsdoctor 没有适用于您的 vCenter 内部版本的文件时,才会使用选项1。 此操作将为您的生成生成文件(请参见输出以获取模板的路径)。 然后,您可以将从正常系统生成的模板复制到同一内部版本的不正常系统中,以便与其他选项配合使用。 这种情况很少需要。
方案 2:
选项2将对此节点的现有 lookup service 注册进行备份,将其移除,并根据模板注册新的。 大多数模板都在模板目录中提供,您只需选择一个模板(如果不存在)。 如果 vCenter 内部版本的模板不存在,系统将提示您选择一个模板。 您应该尝试找到与您的系统最为匹配的模板。 或者,您也可以在同一内部版本的正常系统中使用选项1,并将该模板复制到受影响的系统。
选项 3:
选项3将对此节点执行所有 lookup service 注册的备份,加载当前内部版本的模板,并提供服务选择菜单。 选择要替换的服务类型,该工具将使用选定的服务类型取消注册此节点的所有服务,并根据检测到的模板注册一个新服务。 与 Option 2 一样,如果未自动提供模板,系统可能会提示您选择模板。
方案 4:
选项4允许您通过执行选项2或选项3从创建的自动备份还原 lookup service 注册。 系统将提示您选择由时间戳(最早到最新)标记的备份。 然后,它将移除所有当前服务注册并从备份中注册。
执行所需的操作:
- 脚本完成后, 重新启动所有服务
- 重新注册以前指向此节点的任何外部解决方案(SRM、vSphere Replication、NSX V 等)