专业化管理 > 站点维护 > 使用 Java Management Extensions (JMX) > 设置 JMX 环境
  
设置 JMX 环境
基本 JMX 功能包括针对定义的事件自动发送电子邮件通知功能。要使用此功能,您必须:
确保已将您的邮件服务器设置为发送电子邮件通知。与站点 IT 部门联系,核实是否为运行 Windchill 的环境设置了邮件主机。默认情况下,Windchill 将所有电子邮件匿名发送至 wt.mail.mailhost 特性中定义的 SMTP 主机。
如果对服务器的访问存在某些限制 (如“禁止转发”或“拒绝匿名连接”),则 Windchill 发送的消息会遭到邮件服务器拒绝。要将 Windchill 配置为验证 SMTP 服务器,应将以下特性手动添加至 Windchill 代码库以外的文件中 (例如 <Windchill>/mail.properties)。
wt.mail.smtp.username=<mail-user>
wt.mail.smtp.password=<mail-user-password>
此外,必须按以下方式在 wt.properties 中将 wt.mail.properties 设置为 mail.properties 文件:
xconfmanager -s "wt.mail.properties=$(wt.home)$(dir.sep)mail.properties" -t "codebase/wt.properties"
配置主服务器站点和文件服务器站点,以在文件上载操作失败时收到电子邮件通知。站点管理员应在 wt.properties 文件中手动配置 wt.mail.mailhost 特性,并在 JMX 中添加其电子邮件地址,以接收自动电子邮件通知。要在 JMX 客户端上配置电子邮件地址,请打开 Jconsole 并导航至以下路径,然后更新管理员的电子邮件地址。
com.ptc > Emailer > EmailLists > JMX-Administrators > Attributes > AddressList
要保留已修改的配置,请从 Jconsole 导航至以下路径,然后单击 save()
com.ptc > Loader > Operations > save()
确定用于发送通知的默认阈值是否适合您的站点。
建立用户组,该用户组可接收用户发送的自动 JMX 电子邮件通知和错误报告电子邮件。默认情况下,JMX-Administrators 列表用于此用途。
被添加到 JMX-Administrators 列表中的用户通常需要系统监控权限。用户在具有以下身份时拥有系统监控权限:
站点“管理员”组的成员。
选择“站点” > “管理员”将显示“站点管理员”表。从此表可将用户添加到“管理员”组中。
位于 wt.util.jmx.AccessUtil.siteAdministrators 特性中指定的用户列表中。这些用户可以访问“系统配置收集器”“服务器状况”“监控工具”页面。
默认情况下,wt.properties 文件中不包括 wt.util.jmx.AccessUtil.siteAdministrators 特性。您可以添加 wt.util.jmx.AccessUtil.siteAdministrators 特性。例如,要为名为 auser135 和 buser246 的用户授予监控权限而不使其成为站点管理员,请在 Windchill shell 中输入以下 xconfmanager 命令 (在一行中):
xconfmanager -s wt.util.jmx.AccessUtil.siteAdministrators=auser135,buser246
-t wt.properties -p
检查通知阈值和错误级别
每个 JVM 都具有一组阈值和错误级别,它们是在默认情况下针对可能发生的通知活动而设置。例如,每当服务器管理器启动时都会发送一个电子邮件通知。通知的设置由在每个 JVM 中提供的 NotificationHandlers MBean 进行处理。每个 MBean 在 EmailRecipientList Name 属性中确定电子邮件的接收用户。默认情况下,该值为 JMX-Administrators。
有关详细信息,请参阅从 JConsole 访问 Windchill MbeanWindchill MBeans 中的 NotificationHandlers 一节。
填充 JMX-Administrators 列表
JMX-Administrators 列表显示了一个用户组,该用户组可接收用户发送的自动 JMX 电子邮件通知和错误报告电子邮件。
要填充特定系统中 servlet 引擎、服务器管理器、方法服务器和 Windchill Directory Server的 JMX-Administrators 列表,可以使用以下 ant 脚本。从 Windchill shell 中,导航至 Windchill 代码库目录并输入以下命令:
ant -f modifyMBeanConfig.xml setEmailList -DemailAddresses=<逗号分隔的电子邮件地址列表>
在脚本命令中指定的电子邮件地址将被添加到每个 JMX-Administrators 列表。
如果安装时运行 Windchill Configuration Assistant,则使用安装过程中输入的管理员填充 servlet 引擎、服务器管理器、方法服务器和 Windchill Directory Server的 JMX-Administrators 列表。传播这些列表时,Windchill Configuration Assistant将使用本主题中所述的 ant 脚本。
如果手动运行 Windchill Configuration Assistant,传播 Windchill 值时,会涉及将助手维护的方法服务器 MBean 配置文件中间副本中存储的 JMX-Administrators 列表内容应用于所有 JMX-Administrators 列表。Windchill Configuration Assistant启动时使用的初始管理员列表是存储在方法服务器 MBean 中的列表。如果在交互模式下运行 Windchill Configuration Assistant,则可以更新中间副本。Windchill Configuration Assistant始终将中间副本应用到所有 JMX-Administrators 列表。
要在 Windchill Configuration Assistant传播 JMX-Administrators 列表的更改后单独管理各列表,请使用 MBean 界面。从 JMX 客户端 (例如 JConsole 或 VisualVM),通过单个连接导航至 Emailer > EmailLists > JMX-Administrators MBean。使用 Operations 节点上提供的相应方法添加和移除地址。刷新属性以查看您添加和删除的项。
有关电子邮件列表的详细信息,请参阅 Windchill MBeans 中的 Emailer 部分。
有关用户错误报告电子邮件的信息,请参阅了解最终用户错误电子邮件