配置 Arbortext Publishing Engine (PE) 工作器
PE 工作器随 Windchill 一起自动安装。此工作器可将使用 Arbortext Editor 创建的动态文档发布为标准输出格式,如 PDF 或 HTML。
本节定义了配置 PE 工作器所需的步骤。
先决条件
在配置 PE 工作器之前,您应:
• 已安装并配置了 Arbortext Publishing Engine 软件及相关许可。已从 Windchill 单独购买并安装此软件。
• 具有映射到 Arbortext PE 工作实例的 URL。该 URL 存储在 wvsape.properties 文件的 ape.server 值中。
• 安装了可兼容 Arbortext 的 Windchill 解决方案。要验证您的 Windchill 解决方案是否与 Arbortext Publishing Engine 软件相兼容,请查看 PTC 参考文档 Web 站点中提供的 Arbortext Software Compatibility Matrices。
命名约定
就本文档而言,将使用以下目录命名约定:
• <Windchill> - Windchill 安装目录。
• <APEWorker> – 用于存储工作器配置文件的目录:arbortextEngineWorkerstart.bat 和 wvsape.properties。
过程概述
下图说明了 Windchill 服务器、WVS、工作器代理、PE 工作器以及 PE 之间的关系,以让您对所需配置的内容有大致的了解。
以下过程用于完成 PE 工作器配置:
1. 配置 PE 工作器。
2. 使用“工作器配置向导”配置工作器代理 (agent.ini)。
3. 验证工作器代理、PE 工作器以及 Arbortext Publishing Engine 是否均正常通信。
wvsape.properties 文件和工作器批处理文件可用于配置 PE 工作器。有关这些文件及其参数的详细说明,请参阅后续部分。
配置 PE 工作器
PE 工作器配置涉及到执行 PE 工作器的批处理文件以及用于指定 PE 工作器设置的 wvsape.properties 文件。PTC 建议将这些配置文件置于为保存已安装工作器文件而创建的新工作目录中。本部分将介绍如何创建批处理及 wvsape.properties 文件以配置工作器。
请执行以下步骤来配置 PE 工作器:
1. 在 Windchill 服务器上创建一个新的 <APEWorker> 目录,例如 C:\PTC\APEWorker。
| 目前不支持远程 PE 工作器配置。请不要与具有远程 PE 服务器相混淆。PE 工作器与 Windchill 服务器存放在一起,用于处理对 PE 服务器的请求/响应以及来自 PE 服务器的请求/响应。有关此配置的直观描述,请参见上图。 |
2. 在 <Windchill>\codebase\com\ptc\wvs\server\workers 目录中找到示例配置文件。该示例文件名为 wvsape.properties,而批处理文件名为 arbortextEngineWorkerstart.bat。
| 该过程假定您使用的是 Windows 操作系统。如果使用的是 UNIX,则请使用示例 shell 脚本 (arbortextEngineWorkerstart.sh)。 |
3. 将示例文件复制到在步骤 1 中创建的新目录内。不要从原始位置编辑或移动文件。
4. 使用文本编辑器编辑工作器批处理文件。当在后续步骤中配置“工作器代理”时,该批处理文件将用作 PE 工作器可执行命令。
下面显示了工作器批处理文件示例,并在后面附加了设置说明。
@echo on
set WORKER_DIR=C:\ptc\apeworker
set DEBUG="-D"
set PORT="5600"
set HOST="localhost"
set TYPE="APE"
set CMDCLASS="com.ptc.wvs.server.workers.ArbortextEngineWorker"
C:
cd “%WORKER_DIR%”
java -Dwvs.ape.properties=%WORKER_DIR%\wvsape.properties
com.ptc.wvs.server.cadagent.GenericWorker %DEBUG% -PORT %PORT%
-HOST %HOST% -TYPE %TYPE% -CMDCLASS %CMDCLASS% -DIR %WORKER_DIR%
-LOG "worker_"
◦ set WORKER_DIR=C:\PTC\APEWorker - 该值非常重要,且必须将其设置为在步骤 1 中创建的 <APEWorker> 目录。
◦ set DEBUG="-D" - 该值专用于调试,不应更改。
◦ set PORT="5600" - 可以更改该值,但不建议这样做。如果更改该值,则必须确保它与 agent.ini 文件 [agent] 部分的“端口”值相匹配。5600 为默认值。
◦ set HOST="localhost" - 该值可保持 "localhost" 不变,但应与工作器所在的计算机的主机名相匹配,对于 PE 工作器来说,也就是 Windchill 计算机。
◦ set TYPE="APE" - 该值不应更改。
◦ set CMDCLASS="com.ptc.wvs.server.workers.ArbortextEngineWorker" - 该值不应更改。
5. 将所做更改保存到 <APEWorker> 目录中的批处理文件中。
6. 根据需要编辑 wvsape.properties 文件。下面显示了属性文件示例,并在后面附加了设置说明。
ape.server=http://localhost/e3/servlet/e3
ape.worker.logfile.dir=C:\\ptc\\Windchill\\logs\\arbortext\\
ape.verbose=false
| 所提供的 ape.server URL 应对应于与当前 Arbortext 版本关联的 URL。且应指定完整的 URL。 |
◦ ape.server 是已安装的 Arbortext PE 服务器的 URL。需要定义该值。
◦ ape.worker.logfile.dir 是存储 Arbortext 工作器日志文件的目录。应更改该目录以与保存日志文件的位置相匹配。
◦ ape.verbose 是详细模式的 true/false 开关。
7. 将所做更改保存到 <APEWorker> 目录中,然后关闭特性文件。
8. 在 Windchill 主目录中,于文本编辑器中打开 site.xconf 文件。向 site.xconf 文件添加以下特性:
<Property name="worker.exe.allowlist.prefixes"
targetFile="codebase/WEB-INF/conf/wvs.properties"
value="APEWorker-path"/>
9. 使用 xconfmanager 实用程序传播所做的更改。从 <Windchill>\bin 目录中,输入以下命令:
xconfmanager -pF。
为 UNIX 配置 PE 工作器
对于 UNIX,需要创建脚本文件而非批处理文件。
配置 PE 工作器监视器
| 如果能够访问 Creo View 适配器 CD,建议使用“工作器监视器”。如果您没有 Creo View 适配器 CD,则可忽略本部分。 |
“工作器监视器”基于其自身超时进行监视,而不是完全依赖于报告错误的工作器,从而提供与工作器更稳健的通信。此外,配置工作器监视器后,通过 Web 浏览器利用工作器代理 UI 也可使用工作器日志。
1. 与上一部分中所述的配置工作器类似,在 <Windchill>\codebase\com\ptc\wvs\server\workers 中找到 arbortextEngineMonitorstart.bat 并将其复制到 <APEWorker> 目录中。
| 该过程假定您使用的是 Windows 操作系统。如果使用的是 UNIX,则请使用示例 shell 脚本 (arbortextEngineMoniterstart.sh)。 |
2. 使用文本编辑器编辑 <APEWorker> 目录中的 arbortextEngineMonitorstart.bat 文件。
下面显示了监视器批处理文件示例,并在后面附加了设置说明。
@echo on
set WORKER_DIR=C:\ptc\apeworker
set PORT="5600"
set HOST="localhost"
set TYPE="APE"
set PVIEW_HOME=C:\ptc\productview_adapters
C:
cd "%WORKER_DIR%"
"%PVIEW_HOME%\i486_nt\obj\workermonitor" -s "%WORKER_DIR%\
arbortextEngineWorkerstart.bat" -vt -EW %TYPE% -CS%HOST% %PORT%
%1 %2 %3 %4 %5 %6 %7 %8 %9
◦ set WORKER_DIR=C:\PTC\APEWorker - 该值非常重要,且必须将其设置为在步骤 1 中引用的 APEWorker 目录。
◦ set PORT="5600" - 可以更改该值,但不建议这样做。如果更改该值,则必须确保它与 agent.ini 文件 [agent] 部分中的“端口”值相匹配。5600 为默认值。
◦ set HOST="localhost" - 该值可保持 "localhost" 不变,但应与工作器所在的计算机的主机名相匹配,对于 PE 工作器来说,也就是 Windchill 计算机。
◦ set TYPE="APE" - 该值不应更改。
◦ set PV_HOME= C:\ptc\product_adapters - 该值必须设置为已安装 productview_adapters 目录的位置。
3. 将所做更改保存到 <APEWorker> 目录中的批处理文件中。
在工作器代理的执行命令中将使用该批处理文件而非工作器批处理文件 (请参见下一部分)。
为 UNIX 配置 PE 工作器监视器
对于 UNIX,需要创建脚本文件而非批处理文件。
配置工作器代理
要为 PE 工作器配置工作器代理,请参阅
配置工作器代理,并遵循以下 PE 指导原则:
• 选择数据类型 ARBORTEXT。
• “主机”(HOST) 应为服务器的名称。
• “工作器位置”应保持“Windchill 服务器”不变。
• “执行命令”应指向配置 PE 工作器时所创建的批处理文件。
| 如果要使用工作器监视器,则“执行命令”应指向监视器批处理文件而非工作器批处理文件。 |
• “工作器配置向导”的“工作器执行命令”页面中的 Max Instances 数目必须与为指定给 WVS 的 PE 池定义的 maxSubprocesses 值相匹配。有关池及 maxSubprocesses 的信息,请参阅 Arbortext PE 文档。