在本地环境中安装 Windchill AI 助手插件之前的必要设置
 |
本主题适用于设置 Windchill 本地系统的管理员。
|
在安装此插件之前，管理员必须完成以下先决条件：
• 设置插件安装目录
• 设置插件临时目录
配置 Windchill 服务器
在 Windchill 环境中安装 AI 插件之前，请确保系统满足支持的版本和要求中所述的配置要求。满足上述要求对于插件在 Windchill 生态系统中的兼容性、性能和稳定性至关重要。
有关配置 Windchill 服务器的详情，请参阅安装 Windchill 以及安装流程。
由于此插件将与方法服务器托管在同一台计算机上，因此需要额外的内存来确保平稳运行。
Apache 服务器配置 - 插件通过 Apache 使用以下身份验证方法：
• 基本身份验证 - 简单的用户名/密码访问
• SSO SAML
• CAC-PKI (客户端证书) - 使用 SSL 证书进行强身份验证
手动更新 Apache 设置
安装支持插件管理器功能与“保留 Apache 设置”的最新 CPS 版本时，升级过程中不会更新 Apache 服务器。这意味着现有 Apache 配置保持不变，且不会自动应用更新中引入的任何新配置变更。要手动应用所需的 Apache 配置变更，请执行以下步骤。
执行以下步骤，这些步骤通常适用于所有身份验证类型 (SAML SSO 或基本身份验证)：
1. 加载所需模块 - 更新位于 <Windchill_Home>\HTTPServer\conf\templates 的 modules-load.conf.template 文件，以包括下列代码：
<IfModule !rewrite_module>
LoadModule rewrite_module modules/mod_rewrite.so
</IfModule>
<IfModule !proxy_module>
LoadModule proxy_module modules/mod_proxy.so
</IfModule>
<IfModule !proxy_http_module>
LoadModule proxy_http_module modules/mod_proxy_http.so
</IfModule>
<IfModule !proxy_hcheck_module>
LoadModule proxy_hcheck_module modules/mod_proxy_hcheck.so
</IfModule>
<IfModule !proxy_balancer_module>
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
</IfModule>
<IfModule !slotmem_shm_module>
LoadModule slotmem_shm_module modules/mod_slotmem_shm.so
</IfModule>
<IfModule !watchdog_module>
LoadModule watchdog_module modules/mod_watchdog.so
</IfModule>
<IfModule !lbmethod_byrequests_module>
LoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so
</IfModule>
LoadModule rewrite_module modules/mod_rewrite.so
</IfModule>
<IfModule !proxy_module>
LoadModule proxy_module modules/mod_proxy.so
</IfModule>
<IfModule !proxy_http_module>
LoadModule proxy_http_module modules/mod_proxy_http.so
</IfModule>
<IfModule !proxy_hcheck_module>
LoadModule proxy_hcheck_module modules/mod_proxy_hcheck.so
</IfModule>
<IfModule !proxy_balancer_module>
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
</IfModule>
<IfModule !slotmem_shm_module>
LoadModule slotmem_shm_module modules/mod_slotmem_shm.so
</IfModule>
<IfModule !watchdog_module>
LoadModule watchdog_module modules/mod_watchdog.so
</IfModule>
<IfModule !lbmethod_byrequests_module>
LoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so
</IfModule>
。
根据您的身份验证类型，需要执行额外的步骤。
2. SAML SSO：
a. 对于 REMOTE_USER，确保指令 ShibUseHeaders On 存在于 /apache/conf/conf.d/30-app-Windchill-1Auth.conf 的 LocationMatch 元素中。如果缺少该项，请进行添加。
b. 重新配置 Apache。在继续操作之前，请确保已备份 Apache 目录。然后，运行以下命令以重新配置 Apache：
ant -f config.xml reconfigure
3. 基本身份验证：
a. 更新位于 <Windchill_Home>\HTTPServer\conf\templates\xsl 的 webAppAuthResToConf.xsl 文件，以便在 Require valid-user 行后包括下列代码：
<xsl:if test="$resource='WCPlugins'">
RewriteRule .* - [E=PROXY_USER:%{LA-U:REMOTE_USER}]
RequestHeader set REMOTE_USER %{PROXY_USER}e
</xsl:if>
RewriteRule .* - [E=PROXY_USER:%{LA-U:REMOTE_USER}]
RequestHeader set REMOTE_USER %{PROXY_USER}e
</xsl:if>
b. 修改 app-Windchill-AuthRes.xml - 更新位于 <Windchill_Home>\HTTPServer\conf 的 app-Windchill-AuthRes.xml 文件，使以下行紧随起始 <resources> 标记之后，位于现有全部 <resource> 条目之前：
<resource>WCPlugins</resource>
c. 重新配置 Apache。在继续操作之前，请确保已备份 Apache 目录。然后，运行以下命令以重新配置 Apache：
ant -f webAppConfig.xml regenAllWebApps
ant -f config.xml reconfigure
ant -f config.xml reconfigure
|
|
请验证是否已将 Windchill 配置为使用 HTTPS。有关详情，请参阅为 PTC HTTP Server 和 Windchill 配置 HTTPS。
|
设置插件安装目录
预设 (OOTB) 提供了专用特性 wt.plugins.installed.dir，用于定义解压缩和安装插件文件的目录。默认情况下，此特性留空，表示未预定义安装路径。
安装 Windchill 的管理员必须在 Windchill 主目录之外手动创建一个具有读取、写入和执行权限的安全目录，然后相应地配置此特性。
要使用 xconfmanager 在 wt.properties 文件中添加和传播 wt.plugins.installed.dir 特性，请使用以下命令。例如：
xconfmanager -s wt.plugins.installed.dir=<your_custom_path> -t codebase/wt.properties && xconfmanager -pF
确保仅向管理员用户授予安装目录的访问权限。不应向任何其他用户授予此权限。
|
|
如果未按照所述方式创建插件安装目录，则插件安装将不会继续进行。
|
创建目录并使用特性对其进行定义后，无需重新启动 Windchill 服务器即可安装插件。
插件安装目录中的日志文件
插件安装目录包含一个日志文件夹，其中包含插件生成的文件，例如 /opt/ptc/plugins/logs。管理员可以参考这些详细日志来排除故障或验证操作。其中日志包括时间戳、请求详情和错误消息。
确保仅向管理员用户授予日志目录的访问权限。不应向任何其他用户授予此权限。
提供了专用特性 wt.plugins.logs.dir，用于指定生成插件日志的自定义位置。
• 如果未设置此特性，则会在插件安装目录 (例如 /opt/ptc/plugins/logs) 中生成插件日志。
• 如果设置了该特性，则会在特性指定的目录中生成插件日志。
|
|
Windchill 相关日志可在 Windchill 安装日志记录目录内的 Apache 和方法服务器日志中找到。
|
设置插件临时目录
引入了新特性 wt.plugins.temp.dir。此为可选特性，用于定义存储临时插件文件的目录。默认情况下，目录路径设置为 ${wt.temp}/<pluginId>。wt.temp 是用于定义 Windchill 临时位置的现有 wt 特性。请务必确保仅对管理用户授予此目录的写入权限。不应向任何其他用户授予此权限。
使用以下命令设置此特性：
xconfmanager -s wt.plugins.temp.dir=<your_custom_path> -t codebase/wt.properties && xconfmanager -pF
保留 Java 证书
该插件从 Azure 上 PTC 托管的位置安装。确保保留 Java CA 证书；否则，从 Windchill 服务器到 Internet 的 TLS 连接将失败。安装插件前，请在命令行窗口中以管理员权限运行以下命令：
"%JAVA_HOME%\bin\keytool.exe" -importkeystore -srckeystore "%JAVA_HOME%\lib\security\cacerts" -srcstorepass changeit -destkeystore
"%JAVA_HOME%\lib\security\jssecacerts" -deststoretype jks -deststorepass changeit
"%JAVA_HOME%\lib\security\jssecacerts" -deststoretype jks -deststorepass changeit
配置用于在 Windchill 集群环境中安装插件的共享目录
在 Windchill 集群环境中，插件安装需要一个可从集群中所有节点访问的共享目录。此共享位置可确保插件在整个环境中的部署和可用性保持一致。
 |
仅支持通过共享目录在群集环境中安装插件。不支持本地目录。如果共享目录未正确配置，或无法被任何节点访问，则插件安装过程将失败。
|
为正确配置和保护共享目录，管理员必须遵循以下指导原则：
• 创建网络共享文件夹作为公用插件安装目录，可从所有 Windchill 节点访问该文件夹。
• 指定有效的网络路径：
◦ \\shared\plugins (对于使用 UNC 路径格式的 Windows 系统)
◦ /mnt/shared/plugins (对于使用已挂载网络路径的 Linux 系统)
• 确保所有节点都具有共享文件夹的读写权限，且为 Windchill 安装程序用户授予执行权限。在 Windows 集群设置中，插件服务器始终以无头模式运行。
• 使用 xconfmanager 实用程序在每个节点上设置 wt.plugins.installed.dir 特性，并确保其始终指向共享目录。
• 共享目录必须具有足够的可用空间，以容纳安装的所有插件。例如，如果您计划安装 10 个插件，并且每个插件的大小不同，则可通过将所有插件的大小相加来计算所需的总空间。
|
|
在集群设置中，如果某个节点在插件安装期间关闭，则仅在当前正在运行的节点上安装插件。当关闭的节点重新联机时，将自动在该节点上安装插件，并相应更新 Apache 配置变更。
例如，假设设置了节点 1 和节点 2。如果节点 2 在插件安装期间关闭或离线，此时不会在节点 2 上安装插件。重新启动服务器和 Apache 服务且节点 2 重新联机后，节点 2 上所有必要安装文件都会自动更新。无需执行任何手动步骤。
|