系统信息的发送位置选项
默认情况下,已建立的操作会将系统信息发送至 PTC 技术支持,并将所发送内容的副本存储在本地目录中。有关已建立的操作的信息,请参阅
发送系统信息的操作。
通常,可以选择将系统信息发送至如下目标位置:
• 不将信息直接发送至技术支持,而是仅在本地目录中存储编译的数据或将编译的数据发送至外部系统。
• 除了将信息直接发送至技术支持外,还在本地目录中存储所发送内容的一份或多份副本,或者将信息发送至一个或多个外部系统。
要更改发送系统信息的位置,请使用 xconfmanager 实用程序设置“系统信息发送选项的特性”一节所述的特性。
|
所做的任何更改都会对所有的发送操作产生影响;无法选取更改特定操作 (例如,使用 Support MBean) 发送信息的目标位置而不更改所有操作发送信息的目标位置。
|
系统信息发送选项的特性
使用以下特性更改默认发送选项。发送选项用于指定对收集到的信息执行哪些处理。这些选项包括:
• 使用 Windchill 中定义的 HTTP 传输机制发送信息。利用此传输机制,您可以将数据发送至 PTC 技术支持,也可以将数据发送至已配置为接受通过 URL 发送的数据的其他外部系统。
• 使用在本地目录中存储数据的传输机制发送信息。
在以下属性格式中,格式中的 .instance.<instance_name> 标识为该属性定义的唯一实例。使用多个实例名称可以指定相同基础特性的不同唯一特性值。如果在给定 Windchill 系统中仅定义了一个属性实例,则不需要指定 .instance.<instance_name>:
wt.jmx.core.transport.Transport.support
标识发送收集到的数据所采用的传输。如果仅使用单个传输,则设置以下任一值:
◦ wt.jmx.core.transport.LocalDirTransport.instance\:<instance_name> 指定将收集的数据发送到指定的本地目录。
◦ wt.jmx.core.transport.SimpleHttpTransport.instance\:<instance_name> 指定将收集的数据上传到指定 URL。
如果要指定多个传输,可将 wt.jmx.core.transport.Transport.support 特性设置为以下值:
wt.jmx.core.transport.MultiplexedTransport.instance\:<instance_name>
该值指定依据 wt.jmx.core.transport.MultiplexedTransport.instance.<instance_name>.transports 属性中设置的传输发送或上传收集到的数据。
wt.jmx.core.transport.MultiplexedTransport.instance.<instance_name>.transports
如果想要为每次数据传输指定多个传输用于发送数据,可使用此特性来指定所有传输,并使用空格分隔每个传输。
使用以下值指定传输:
◦ wt.jmx.core.transport.LocalDirTransport.instance\:<instance_name> 指定将收集的数据发送到指定的本地目录。
◦ wt.jmx.core.transport.SimpleHttpTransport.instance\:<instance_name> 指定将收集的数据上传到指定 URL。
wt.jmx.core.transport.LocalDirTransport.instance.<instance_name>.targetDir
标识本地目录传输的目标目录。您的 Windchill 系统必须具有指定目录的写入权限。
为该特性中给定实例名称指定的目标目录用于所有使用同一实例名称的本地目录。
默认的目标目录为:
<Windchill>/utilities/SystemConfigurationCollector/sent/C<call>
其中 <Windchill> 是 Windchill 安装目录,<call> 是为发送信息而输入的技术支持呼叫号。
wt.jmx.core.transport.SimpleHttpTransport.instance.<instance_name>.targetURL
标识用于将收集到的数据上传到外部系统的 URL。
为该特性中给定实例名称指定的 URL 用于所有使用同一实例名称的 HTTP 传输。
默认 URL 会将收集的信息发送到 PTC 技术支持数据库。
为系统信息的发送设定的默认值
Windchill 为系统信息的发送提供以下默认值:
wt.jmx.core.transport.Transport.support=wt.jmx.core.transport. MultiplexedTransport
wt.jmx.core.transport.MultiplexedTransport.transports=wt.jmx.core.transport.SimpleHttpTransport wt.jmx.core.transport.LocalDirTransport
wt.jmx.core.transport.SimpleHttpTransport.targetURL=http://support.ptc.com/appserver/support/windchillSCC/windchill_upload.jsp
wt.jmx.core.transport.LocalDirTransport.targetDir=$(wt.home)/utilities/SystemConfigurationCollector/sent
此外,Windchill 使用以下特性标识用于向 PTC 发送质量代理报告的传输机制:
wt.jmx.core.transport.MultiplexedTransport.instance.QUALITYAGENT.transports
|
请勿更改该特性设置或 QUALITYAGENT 实例的任何传输设置。
|
仅在本地目录中存储信息的示例特性
要将发送的 ZIP 文件存储在本地目录中且不将信息真正发送到 PTC 技术支持部门,可对 wt.properties 文件中的以下特性进行设置:
• 将 wt.jmx.core.transport.Transport.support 设置为 wt.jmx.core.transport.LocalDirTransport.instance\:<instance_name>。
• 或者设置 wt.jmx.core.transport.LocalDirTransport.instance.<instance_name>.targetDir 属性,以更改所发送数据的存储目录位置。
例如,假定您想要使用 myCompany 实例将发送的 ZIP 文件存储在 <Windchill>/TechSupport 目录中,并且不将该 ZIP 文件发送到 PTC。然后,从 Windchill shell 输入以下 xconfmanager 命令 (在一行上):
xconfmanager
-s wt.jmx.core.transport.Transport.support= wt.jmx.core.transport.LocalDirTransport\:myCompany
-s wt.jmx.core.transport.LocalDirTransport.instance.myCompany.targetDir= $(wt.home)$(dir.sep)TechSupport
-t wt.properties -p
有关选择将信息存储在本地目录时所存储目录内容的信息,请参阅“了解所发送文件的 ZIP 文件详细信息”一节。
将信息发送到技术支持以及其他外部系统的示例特性
要将收集的信息发送到 PTC 技术支持部门,同时将这些信息的副本发送到另一外部站点,可对 wt.properties 文件中的以下特性进行设置:
• 将 wt.jmx.core.transport.Transport.support 设置为 wt.jmx.core.transport.MultiplexedTransport\:<instance_name>。
• 将 wt.jmx.core.transport.MultiplexedTransport.instance.<instance_name>.transports 设置为 wt.jmx.core.transport.SimpleHttpTransport.instance.<instance_name> 的两个实例,其中每个实例都定义一个唯一的目标 URL,一个指向 PTC 技术支持,另一个指向设置为接收数据的外部站点。用空格分隔这两个实例。
• 将 wt.jmx.core.transport.SimpleHttpTransport.instance.<instance_name>.targetURL 属性的一个实例设置为 PTC 技术支持 URL,另一个实例设置为外部站点。
例如,要将 ZIP 文件发送到 PTC 技术支持,并且将 ZIP 文件的副本存储在已使用 https://www.myCompany.com/cgi/ssl/windchill/upload.pl 设置的另一外部站点上,可从 Windchill shell 使用一个或多个 xconfmanager 命令设置以下特性:
xconfmanager
-s wt.jmx.core.transport.Transport.support=wt.jmx.core.transport.
MultiplexedTransport\:AddOne
-s wt.jmx.core.transport.MultiplexedTransport.AddOne.transports=
wt.jmx.core.transport.SimpleHttpTransport.instance\:PTCTechSupport
wt.jmx.core.transport.SimpleHttpTransport.instance\:externalSite
-s wt.jmx.core.transport.SimpleHttpTransport.instance.PTCTechSupport.targetURL=
http://support.ptc.com/appserver/support/windchillSCC//windchill_upload.jsp
-s wt.jmx.core.transport.SimpleHttpTransport.instance.externalSite.targetURL=
https://www.myCompany.com/cgi/ssl/windchill/upload.pl
-t wt.properties -p
有关所发送文件的信息,请参阅“了解所发送文件的 ZIP 文件详细信息”一节。
了解所发送文件的 ZIP 文件详细信息
使用 HTTP 或本地目录传输机制发送信息时,Windchill 会创建 ZIP 文件和相应的 PROPERTIES 文件。每个 PROPERTIES 文件都包含说明相应 ZIP 文件内容的元数据。
ZIP 文件可包含从以下位置或方式获取的数据:
• 使用“系统配置收集器”发送信息时用于保存收集到的信息的目录。
• 执行特定 Support MBean 或 wt.util.jmx.TechSuppportMain 命令行实用程序。
ZIP 文件使用以下信息命名:
• 数据类型,例如 PTC_Logs 或 Utilities,如“系统配置收集器”帮助中所述
• 生成数据的计算机,例如 USERA203L
• 生成数据的进程 ID
• 时间戳,表明数据的发送时间
• 附加序列号,当已经有另一个文件与当前构建的名称同名时,此序列号用于唯一地标识此文件
例如,以下 ZIP 文件包含在名为 USERA203L 计算机上的 Windchill 日志目录中收集到的日志目录,其中使用的收集进程 ID 为 4624,时间戳为 2009 年 6 月 17 日上午 10:05:
PTC_Logs-USERA203L-4624-0906171005.zip
相应的 PROPERTIES 文件为:
PTC_Logs-USERA203L-4624-0906171005.zip.properties
如果使用本地目录传输,Windchill 将在 wt.jmx.core.transport.LocalDirTransport.instance.<instance_name>.targetDir 属性中指定的本地目录下创建一个目录,具体内容为在呼叫号前面指定一个字母 C。例如,假定呼叫号为 4567890,本地目录为 C:/ptc/Windchill/diagnostics/sent。则发送信息的存储目录为:
C:/ptc/Windchill/diagnostics/sent/C4567890
如果使用 HTTP 传输,则 Windchill 会将 ZIP 文件和相应的 PROPERTIES 文件直接发送到 wt.jmx.core.transport.SimpleHttpTransport.instance.<instance_name>.targetURL 属性中标识的 URL。