Principals Reconnect Utility
Windchill Directory Server 不再与 Windchill 捆绑。您需要配置选定的目录服务器，以保留用户或组信息。
PTC 支持将参与者移动到任何其他与 LDAP V3 兼容的目录服务器中，方法是提供可帮助批量重新连接承担者的命令行实用程序。此实用程序称为 Principals Reconnect Utility，仅可供 Windchill 管理员使用。此实用程序还可用于将参与者移动到所选的其他目录服务器。
过程
1. 生成 xml 格式的映射文件。该文件必须采用以下格式之一：
◦ 具有多个 DN (可分辨名称) 条目的格式 - 此格式会针对要重新连接的每个用户采用 sourceDN 和 targetDN 映射。建议在必须单独映射各个特定源与目标 DN 的情况下使用此格式；例如，可以在 xml 文件中提供单独的 uid 值。
<dnMapping>
<reconnect>
<sourceDN>uid=<>,ou=<>,cn=<>,cn=<>,o=<></sourceDN>
<targetDN>cn=<>,ou=<>,cn=<>,cn=<>,o=ptc</targetDN>
</reconnect>
<reconnect>
<sourceDN>uid=<>,ou=<>,cn=<>,cn=<>,o=<></sourceDN>
<targetDN>cn=<>,ou=<>,cn=<>,cn=<>,o=ptc</targetDN>
</reconnect>
</dnMapping>
 |
由于“与”字符在 XML 中为特殊字符，XML 文件中包含“与”字符的数据应使用 & 对该字符进行转义。在下面的示例中，数据值 users & computers 表示为 users & computers。
//Original entry <sourceDN>cn=<value>,ou=users,ou=users & computers,ou=usa,DC=ab,DC=corp,DC=abcd,DC=com</sourceDN> //To be replaced by entry <sourceDN>cn=<value>,ou=users,ou=users & computers,ou=usa,DC=ab,DC=corp,DC=abcd,DC=com</sourceDN> |
◦ 具有单个适配器名称条目的格式 - 此格式将 adapterMapping 作为要映射的属性。
<adapterMapping>
<sourceAdapter>Adapter1</sourceAdapter>
<targetAdapter>Adapter2</targetAdapter>
</adapterMapping>
<sourceAdapter>Adapter1</sourceAdapter>
<targetAdapter>Adapter2</targetAdapter>
</adapterMapping>
2. 在命令行实用程序中使用映射文件之前，请检查以下内容：
◦ 在 targetDN 中指定的值应不存在于数据库中。
◦ sourceDN 和 targetDN 应表示相同的承担者类型。
◦ 指定的 sourceDN 条目应在 LDAP 中删除。
◦ sourceDN 参考的承担者应存在于数据库中。
◦ targetDN 应存在于为系统配置的任何 LDAP 适配器中。
3. 从 Windchill shell 运行以下命名行实用程序：只有 Windchill 站点管理员才能运行此实用程序。
windchill wt.org.util.ReconnectPrincipalsUtility [-u <user>] [-p <password>] -f <mappingFile> [-d][-h]
其中，强制性自变量如下：
◦ -u <userName> - 管理员用户名。
◦ -p <password> - 管理员密码。
◦ -f <mappingFile> - 映射文件，具有包含映射的 xml 文件的完全限定路径。
非强制性自变量如下：
◦ -d <debug> - 将调试消息保存到日志文件中
◦ -h <help> - 向控制台打印用法说明。
如果未正确指定任何参数，则会在显示说明上方显示相应的消息。如果显式请求用法说明，则会显示用法说明。
4. 成功执行命令后，将出现一条消息，其中包含日志文件的路径。验证日志文件。