设置 JMX 环境
基本 JMX 功能包括针对定义的事件自动发送电子邮件通知功能。要使用此功能，您必须：
• 确保已将您的邮件服务器设置为发送电子邮件通知。与站点 IT 部门联系，核实是否为运行 Windchill 的环境设置了邮件主机。默认情况下，Windchill 将所有电子邮件匿名发送至 wt.mail.mailhost 特性中定义的 SMTP 主机。
如果对服务器的访问存在某些限制 (如“禁止转发”或“拒绝匿名连接”)，则 Windchill 发送的消息会遭到邮件服务器拒绝。要将 Windchill 配置为验证 SMTP 服务器，应将以下特性手动添加至 Windchill 代码库以外的文件中 (例如 <Windchill>/mail.properties)。
◦ wt.mail.smtp.username=<邮件用户>
◦ wt.mail.smtp.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 并导航至以下路径，然后更新管理员的电子邮件地址。
> > > > >
要保留已修改的配置，请从 Jconsole 导航至以下路径，然后单击 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
-t wt.properties -p
检查通知阈值和错误级别
每个 JVM 都具有一组阈值和错误级别，它们是在默认情况下针对可能发生的通知活动而设置。例如，每当服务器管理器启动时都会发送一个电子邮件通知。通知的设置由在每个 JVM 中提供的 NotificationHandlers MBean 进行处理。每个 MBean 在 EmailRecipientList Name 属性中确定电子邮件的接收用户。默认情况下，该值为 JMX-Administrators。
有关详细信息，请参阅从 JConsole 访问 Windchill Mbean 和 Windchill 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)，通过单个连接导航至 > > MBean。使用 Operations 节点上提供的相应方法添加和移除地址。刷新属性以查看您添加和删除的项。
有关电子邮件列表的详细信息，请参阅 Windchill MBeans 中的 Emailer 部分。
有关用户错误报告电子邮件的信息，请参阅了解最终用户错误电子邮件。