IBM Lotus Sametime Servers 故障诊断与排除
转自：http://www.ibm.com/developerworks/cn/lotus/d-ls-sttroubleshoot/index.html
Lotus Sametime（聊天和会议）基础知识
在版本 8.x 以前，Sametime Server 一直是一个 IBM Lotus Domino® Server 应用程序，并且始终安装在 Domino Server 上。然而，要获得最佳性能，Sametime 8.x 服务器不应当和其他 Domino Server 应用程序混合安装在任何 Domino 服务器上。例如，不应当将 Sametime 8.x 安装在 Domino 邮件服务器上，相反，应当安装到一个专用服务器中，并作为一个后台服务器进程启动。
有两种主要的服务器组件，Sametime Community（即时消息传递或聊天）和 Sametime Meetings（Web 会议）。建议将每种组件分别安装到单独的机器中。其中，Sametime Community 服务器充当用户的主 Sametime 服务器，而 Sametime Meetings 运行在一个专用的会议服务器上。
 |
|
有关完整部署场景的更多信息，请参考 IBM Red books® 刊物 “Sametime 7.5.1 - Best Practices for Enterprise Scale Deployment”, 第 28 页第 2.4 小节，部署选项。
由于 Lotus Sametime 常常与其他产品集成，因此必须执行以下检验：
- 目前使用的 Sametime 服务器许可：
Sametime Limited Use。为特定的客户端提供一组核心的感知和即时消息传递，例如 IBM Lotus Notes® 客户端和 Domino® Web Access (DWA)，用以实现消息传递和协作，但是不支持 Web 会议/Sametime 会议。
Sametime Entry。为 Lotus Sametime Connect 桌面客户端或支持 Sametime 的 Microsoft® Outlook 客户端额外提供了到场和即时消息传递功能。
Sametime Standard。额外提供了 Web 会议/Sametime Meeting；为 Lotus Sametime Connect 客户端提供了更多特性，例如集成的 Voice-over-IP (VoIP)、点对点视频、移动客户端；以及地理位置、屏幕截图和文件传输能力等额外特性。
可以在 Lotus Sametime 8 信息中心 中找到完整的对照列表。
- 理解并满足系统需求（平台、版本和硬件等等）
- 在所有互连的服务器中实现多服务器单点登录（SSO）
- 如果集成了其他产品的话（IBM Lotus QuickrTM、Domino Web Access / iNotes® 和 IBM WebSphere® Portal），STLINKS 可以正常工作
- 对于使用 LDAP 目录的 Sametime 专用聊天服务器，使用 STConfig.nsf 连接到 LDAP 目录服务器以实现身份验证（不需要目录帮助）。
- 对于 Sametime 会议服务器，使用 Domino Directory Assistance 数据库通过 Domino HTTP 堆栈对会议中心进行 Web 身份验证。
调试可以在不同级别上执行；具体分为：
- 在 Sametime Server 中
- 在处理集成、Sametime JavaTM 浏览器客户端或 Sametime 会议问题时在浏览器中执行
- 在 Sametime Connect 客户端中（通常称为 Sametime 独立客户端）
- 在 Lotus Notes 集成 Sametime 客户端
在本白皮书的后续小节中，我们将分步探讨每一个级别。由于故障排除的第一步就是收集相关的调试或跟踪数据，因此我们在附录部分（第 8 节）提供了各种调试/跟踪参数列表，可以根据出现问题的位置设置这些参数。
如附录中所述，可以使用 STDebugTool 动态地修改某些参数。这有助于快速收集调试信息，而不必等到下一次服务器重启。
如果您通过浏览器（一个会议或 Java Sametime 客户端）连接到 Sametime 服务器，那么客户端 Java 控制台将始终提供服务器跟踪数据（稍后讨论）。
Sametime Server
对于安装在 Domino Server 上的 Sametime Server，您可以使用以下参数进行调试：
- 特定于 Sametime community 服务器（聊天）的参数，被添加到 Sametime.ini [DEBUG] 部分
- Domino 参数，被添加到 Domino Notes.ini 文件
- 对于 Sametime 会议服务器，修改 Microsoft® Windows® Registry，或修改UNIX®/Linux® 的 meetingserver.ini 和 sametimed iag nostics*. Properties 中的特定参数。
配置信息存储在哪里？
所有配置设置都可以通过 Sametime 或 Enterprise Meeting Server (EMS) 管理员 Web 页面访问。对于未包含 EMS 的 Sametime 环境，该信息被存储在 Domino STConfig.nsf 数据库中。对于使用了 EMS 的 Sametime 环境，配置信息保存在一个 IBM DB2® 数据库中。要使任何配置修改生效，必须重启服务器。
下面列出了这个数据库的内容和选择的项的描述。
-
AnonymousAccess。针对这个 Sametime 社区的匿名访问设置。
-
BroadcastGateway。由 stbroadcastgateway.exe 进程读取。用于所有客户端和控制广播连接。注意，默认使用 554 和 8082 端口。
-
Cluster Information。只有在已经定义了一个 Sametime Community Cluster 的情况下包括该项。文档在 STConfig.nsf 中手动创建。
-
CommunityClient。针对 Connect 客户端的设置（Java Connect 客户端和自动客户端供应）。
-
CommunityConnectivity。配置 Sametime 社区中的所有连接选项；例如，是否启用通道，哪些服务器机器被授权连接到这个 Sametime 服务器。
-
CommunityGateway。只有在支持外部社区的情况下包含该项。
-
CommunityServices。有关社区服务目录组件的设置。
-
ConnectionProfile。A/V 客户端的连接速度。
-
LDAPServer。只有在连接到 LDAP 目录进行身份验证和授权的情况下包含此项。只有当连接到具有不同内容的目录时，才应当定义多个 LDAP 文档。故障转移或工作负载均衡机制不需要使用多个文档。
-
如果需要执行负载均衡或故障转移，应该独立实现一个 LDAP 负载均衡器，Sametime 服务器将连接到这个负载均衡器（而不是直接连接到 LDAP 服务器）。
-
LogEvents。控制将哪些事件记录到日志数据库中。
-
LogOutput。控制日志数据的输出方式的设置。
-
MeetingCenter。指定将用于连接 MeetingServer 的预定会议、数据库名和 URL。
-
MeetingServices。用于会议服务组件的设置，包括应当加载哪些 meetingservices、应当应用哪些选项、MeetingServer 主机名和 MeetingServer 连接细节。
-
MMCU。面向多媒体多端点控制单元的设置。
-
MMP。用于多媒体处理器的设置。
-
UsageLimits。针对即时和预定会议的使用限制。
-
UserInfo。名片设置。
Domino Directory 包含 Domino 服务器设置（参考 Server Configuration 文档，了解 Domino 服务器和 HTTP 设置）。此外，可以通过 Sametime Connection 文档实现 Sametime Invited Server 功能。该功能可以用于在两台服务器（发起服务器和受邀服务器）上同时生成会议。
Domino Directory Assistance Database 用于根据 LDAP 目录对 Sametime Meeting 服务的 HTTP 登录进行身份验证和授权。如果没有会议服务加载到 Sametime Server 中，并且 Domino 服务器上也不需要其他 HTTP 身份验证，那么就不需要使用 Directory Assistance 数据库，因为将根据 Sametime 配置 LDAP 文档进行身份验证。
Sametime 服务器加载哪些进程？
下面列出了 Sametime 服务器加载的进程：
-
STAddin or STaddin2 for iSeries®。负责启动 Sametime Server 服务（STLaunch）的主要服务。
-
STMSService (STMSactivityprovider)。Sametime Meeting Room Service，用于会议预定、安排、举办和调整。
-
STCommLaunch。Sametime Community Server Service。
-
STMeetingServer。运行在 Lotus Domino 之下的 Sametime Meeting Server 进程。它加载 Java Virtual Machine (JVM)（如果未加载的话）并启动 Sametime Event Service。
-
STEvent。Sametime Event Service，管理所有底层 Sametime 服务的启动以及这些服务的依赖关系。
默认情况下，会议服务在 Community 服务之前启动，但是对于专用的聊天服务器，会议服务应当被禁用。对于 Windows，可以通过注册表完成此操作；对于 UNIX 和 iSeries，可以在 Meetingserver.ini 文件中禁用会议服务。（有关更详细的步骤，请参考 Lotus Software Knowledge Base 文档 #1107137, How to disable Sametime meetings and only use Sametime for chat。
Sametime Meeting Server 服务包括（对于 Windows 平台，该列表和依赖关系存储在注册表
中，对于 UNIX/iSeries 平台，这些内容存储在 Meetingserver.ini 文件中）：
-
ActivityProvider。启动还依赖于 STCommunity 服务和所有额外的会议功能，比如 AV、T120 和白板。
-
AuthenticationServer。身份验证服务和事件。
-
AVMMP。 面向 A/V 多媒体功能的基本服务。
-
BroadcastGateway。 依赖于 T120MCU Multi-point Control Unit (MCU)。 CalendarService。 提供与 Domino Calendar & Scheduling 的集成。CapacityMonitor。 会议容量监视服务。
-
ConfigurationBridge。 检索Sametime 配置数据。
-
EventBridge。 Intraserver 令牌服务（默认端口 9094）。
-
EventServer。 Intraserver 事件服务（默认端口 9092）。
-
GWController。 启动还依赖于 STCommunity Service 和 broadcastgateway。
-
H323MCU。用于 IP A/V 功能；依赖于 T120MCU。
-
JavaServiceManager。Java Service Manager。
-
Logger。提供日志功能。
-
MaterialManager。为会议提供上传的幻灯片。SharedObjectServer。提供屏幕共享服务。
-
StatisticsSe rver。提供 Sametime 统计服务。 STStreamedMediaService。依赖于 AVMMP 服务。
-
T120MCU。提供开放标准 T.120 MCU 电话会议服务。
-
WhiteboardService。依赖于 T120MCU 服务。
STCommLaunch 负责启动 Sametime Community Server 服务集合（启动顺序列表存储在 StCommLaunch.dep 中）：
-
ST Community。提供聊天服务。
-
ST Configuration。定时检查 Sametime 服务配置服务。
-
ST Logger。提供日志功能。
-
ST Places。用于即时消息传递。
-
ST Users。提供用户身份验证。
-
ST OnlineDir。提供多台服务器之间的感知功能。
-
ST BuddyList。为所有用户、好友列表管理和对等服务器应用程序提供感知功能。
-
ST Conference。提供即时消息传递服务。
-
ST Directory。提供目录浏览功能。
-
ST Chat Logging。在 Sametime 服务器上提供聊天记录服务。
-
ST Polling。允许通过 HTTP 传输 Sametime 协议消息。
-
ST Links。在将 Sametime 感知集成到其他产品时使用该功能。
-
ST Resolve。负责处理所有名称解析功能，例如，向 LDAP 目录构建名称解析请求。
-
ST User Storage。负责管理 VPUserInfo.nsf，其中包含所有联系人列表细节。
-
ST Privacy。提供隐私消息（“谁能看见我”）服务。
-
ST Mux。提供用户和社区服务器之间的接口。
-
ST Admin。提供 Sametime 服务器管理服务。
-
ST Security。提供登录客户端版本控制或安全级别。
-
ST Policy。管理用户策略（在 Sametime 7.5x 中引入）。
-
ST Capabilities。支持客户端发布其登录属性，比如，Voice、Video 和富文本聊天。
-
ST File Transfer。提供客户端文件传输服务。
-
ST Reflector。为基本的客户端到客户端 VoIP 功能提供音频反射器。
修改 Sametime 服务器跟踪记录目录
默认情况下，所有跟踪文件均存储在 \Trace 目录中。Trace 文件夹的位置可以通过 Sametime.ini 参数修改。该目录必须在重启 Sametime Server 之前手动创建。
其他诊断数据通常通过 SametimeDiagnostics*.properties 文件被写入到默认的跟踪目录中。如果希望重定向所有跟踪数据，那么必须像下面这样修改这些文件：
[Config] ST_TRACE_PATH=X:\Sametime\Trace |
常见的 Sametime 活动信息，比如社区（聊天）、文件传输和会议统计数据以及日常活动，都被记录到 STLog.nsf 中。
Sametime 服务器跟踪在默认情况下被禁用，但是，可以通过使用如下 Notes.ini 参数启用它并指定给一个特定的文件：
ST_DEBUG_FILE_NAME=\ |
由于服务器控制台上显示的所有信息并非全部被写入到 STLog.nsf，因此常常需要确保 Sametime 跟踪已被启用并且收集了跟踪数据。
附录中提供了一组额外的 Same 调试参数列表。
Sametime 服务器性能
由于 Sametime 服务器被加载到 Domino 服务器中，因此必须同时审视 Sametime 服务器性能和 Domino 服务器的一般性能。性能是一个广泛而深入的主题，并且您必须通过考虑完整的服务器运行环境来对性能进行分析。
首先，您需要判断出现性能问题的位置：
- 检查加载的任务的 CPU 使用情况。不要启用多余的功能；例如，在使用大型 LDAP 目录时，Directory Search 的开销将非常巨大。
- 对于使用 Domino HTTP 任务的 Sametime 活动（比如会议），通过 HTTP 请求记录确定 Domino Web 服务器出现的问题。例如，使用端口 ping 评估服务器可用性的监视器（比如 IBM WebSphere Edge server 和 Big-IP）会对 Domino HTTP 服务器造成过量负载，这将对 Sametime HTTP 行为造成直接的负面影响。
- 对于 Sametime LDAP 请求，检查与 LDAP 服务器的连接是如何配置的。STConfig.nsf 应当只包含一个指向 LDAP 服务器的 LDAP 文档，或者最好包含面向多个 LDAP 服务器的负载均衡器。
如果使用了一个 LDAP 负载均衡器，那么确保对地址进行定期检查。默认情况下，ST-to-LDAP 连接永远不会被重新建立（re-spray），因此 Sametime 服务器将在启动时从 LDAP 负载均衡器接收一个 LDAP IP 地址，但是永远不会对这个地址进行重新检查。
这将产生一个负面影响，这是因为如果特定的 LDAP 服务器停机或与该服务器的连接出现问题，那么不会执行任何故障转移，直到重启 STDirectory 服务。因此对 LDAP 地址进行定期检查十分重要（Sametime 服务器将每隔 X 分钟检查一次 LDAP 负载均衡器，确保使用了一个有效的 LDAP IP 地址），使用如下参数：
ST_DB_LDAP_RESPRAY_I NTERVAL= (default=0)
注意：术语“重建”表示连接将被移除并重新建立，因此建议不要把值设得过低，以避免引起过高的开销。可以先将时间间隔设置为 5 分钟，然后根据具体环境进行调整。
- 如果 Lotus Sametime 在响应身份验证或名称查找请求时速度较慢，那么应检查一下与目录服务器的连接，并在 Sametime 解析或社区跟踪日志中查找可能的队列消息（通过VP_LDAP_TRACE=1 启用）。
低性能可能是由 Sametime 服务器、目录服务器以及两者之间的连接出现超载引起的，因此不能足够快地处理传入的请求。参考 Lotus Support Technote #1 200143， Optimizing LDAP connections and queries on a Sametime server 获得有关 Sametime 和 LDAP 服务器连接的指导。
- 如果在集成另一个产品（Domino Web Access/iNotes、Lotus Quickr 和 WebSphere Portal）的情况下，与 Lotus Sametime 的连接十分缓慢，那么应当检查 STLINKS 的行为。在协作产品中通过 Java applet STLINKS 提供了感知功能；因此，感知集成依赖于 STLINKS 限制。
技巧：将默认的 128MB STLINKS JVM 内存提高到更高的值可以改善性能并解决内存不足问题。比如，我们在 Sametime 服务器的 Sametime.ini 中将 STLINKS JVM 内存提高到 256MB：
[STLinks] STLI N KS_VM_ARGS=-Xmx256m -Xms256m -Xgcpolicy:optavg pause
- 如果协作产品中负责感知功能的主 Sametime 服务器是一台专用的聊天服务器，那么不需要对其使用目录帮助数据库执行身份验证。
在 Sametime Domino 服务器上显示目录帮助可以缩短加载时间，因为在包含 Lightweight Third-party Authentication (LTPA) 令牌的 HTTP 下载请求之后，不会执行额外的（多余的）身份验证和授权。
在对会议服务器检查连接问题时，还需要知道问题发生在哪个区域。如本白皮书第 3 节所述，有关会议室客户端（MRC）的问题，还应当收集浏览器的 Java 控制台日志。
客户端故障排除
浏览器客户端
浏览器客户端主要用于：(1) 聊天和感知（当集成其他产品时将使用 Sametime Java Connect 客户端或 STLINKS）；(2) 会议中心客户端。
如果出现于浏览器客户端有关的问题，需要执行以下操作：
- 同时从客户端和服务器端收集跟踪信息（确保数据是在同一时间收集的）：
- 在客户端，收集浏览器 Java 控制台和 IBM Page Detailer 跟踪（Page Detailer 是一款图形化工具，允许 Web 内容提供者快速、准确地测量 Web 页面在客户端的性能）。
- 使用 DebugLevel.class.5（位于 Debug 子目录）替换 DebugLevel.class 文件（位于 Sametime 服务器中的 \domino\html \sametime\[stlinks or javaconnect]），增强 Java Connect 和 STLINKS 在客户端的调试。
注意：确保在复制后删除 .5，并在重试之前清除浏览器缓存。
- 在服务器端，可以在 Sametime.ini [Debug] 部分启用额外的调试选项（参见附录）。
- 同时从客户端和服务器端收集跟踪信息（确保数据是在同一时间收集的）：
Sametime 连接客户端
首先，参考 Lotus Support Technote #1319789， “Collecting Data: Lotus Sametime Connect client (standalone desktop) for version 7.5x and 8.x.”
在客户端，确保调试级别被设置为更高的细节程度：
- 对于 7.5.x Connect 客户端，在 sametime.properties 文件中将 “.level=” 修改为 FINE，该文件位于 Sametime 客户端安装目录。
- 对于 8.x Connect 客户端，在 rcpinstall.properties 文件中将 “.level=” 修改为 FINE，该文件位于 Windows XP 用户配置目录， \Application Data\Lotus\Sametime\.config。例如：
C :\Docu ments and Settings\Ad ministrator\Application Data\Lotus\Sametime\.config
注意：“.level=FINEST”可以设置为获取更多的细节。
输出被写入到用户配置目录，但是，根据 Connect 客户端的具体版本，子目录是不同的：
Sametime Connect 客户端 7.5.1 在 Windows XP 上：
\l BM\RCP\Sametime |
在 Macintosh & Linux 上：
/Library/Preferences/Sametime |
Sametime Connect 客户端 8.x 在 Windows XP 上：
\Application Data\Lotus\Sameti me\logs |
在 Macintosh & Linux 上：
/Lotus/Sametime or /lotus/Sameti me/logs |
Sametime Connect 客户端 8.x 在 Windows Vista 上：
\AppData\Roaming\Lotus\Sametime\logs |
在 Sametime 8.x Connect 客户端中，可以通过使用 IBM Support Assistance 轻松地收集完整的调试文件集合（从菜单中选择 Help > Support > IBM Support Assistance > Service）。
Lotus Notes integrated Sametime 客户端
和对 Sametime 连接客户端进行故障排除一样，您必须首先将调试级别设置为一个更加详细级别。对于 Notes 8.x 标准客户端，在 rcpinstall.properties 文件中修改以下两个参数，该文件位于 Notes data dir\workspace\.config中：
com.ibm.collaboration.realtime.level=FINE (or FINEST) com.lotus.sametime.level=FINE (or FINEST) |
输出被写入到 \workspace\logs。有关更多信息，请参考 Lotus Support Technote #1320442, Collecting data for embedded Sametime client for Notes 8.x clients。
Lotus Sametime Enterprise Meeting Server (EMS)
Lotus Sametime EMS 将 IBM WebSphere Application Server、DB2 和 LDAP 目录技术集成到一个负载均衡的、容错的、高可用性的企业会议解决方案中，并且是对 Lotus Sametime 技术的自然扩展。
现在让我们来讨论各种可以增强 Sametime EMS 和 Sametime Meeting Room Servers 的可靠性、服务能力和性能的实践（适用于版本 7.5.1 和 8.0.x）。
Sametime EMS 基础设施需求
下面是来自安装包中的 EMS 基础设施需求：
对于 Sametime EMS 7.5.1：WebSphere Application Server V6.0.2.11 和 DB2 Enterprise Server Edition 8.2
对于 Sametime EMS 8.0.x：WebSphere Application Server V6. 1.0.9 和 DB2 Enterprise Server Edition 9.1
根据客户需求和实际的部署，可以对 WebSphere Application Server 执行基础部署或网络部署（ND）。
建议将 WebSphere Application Server / IBM HTTP Server 和 DB2 更新到最新的补丁级别。对于 WebSphere Application Server、HIS 和 IHS-plugin，除非特殊说明，否则补丁级别和 iFix 级别应当始终匹配。DB2 服务器和 Connect 客户端必须保持在相同的版本。
EMS 设计
作为一项最佳实践，每个 Sametime 基础设施组件都应当放在一个专用的、单独的硬件平台上，从而获得最佳性能。
一种基本的生产设计就是对 WebSphere Application Server、DB2 和 Sametime EMS 使用三个专用的硬件平台；具体来讲，为 Sametime 会议和社区服务器使用两个专用硬件平台，为 LDAP 目录使用一个专用硬件平台。
通过增加以上任何组件以及 IP sprayer 负载均衡器和反向代理服务器，可以演变为更复杂的设计（见图 1）。
图 1. 理想的生产设计
注意：Sametime EMS 要求使用相同的Sametime Server 版本。在升级过程中，一定要从 Sametime EMS 集群中删除 Sametime 服务器，并在完成 Sametime Server 和 EMS 的升级后将 Sametime Server 添加回 Sametime EMS 集群。
Sametime EMS Application Server
所有 EMS Application Server 数据均存储在 DB2 数据库中，可以通过 DB2 客户端连接对这些数据执行本地访问或远程访问。表 1 总结了这三个 EMS WebSphere Application Server。
表 1. EMS WebSphere Application Server
| 服务器名称 | 描述 |
| STAdmin | EMS 管理，用于管理用户界面（UI）和功能 |
| STServer | EMS 管理，用于 Scheduler、负载均衡、会议管理、健康检查；提供 Configuration Server 功能 |
| STCenter | EMS Meeting Center，用于用户界面（UI）和功能 |
Sametime EMS 故障排除
EMS 应用程序位于 WebSphere Application Server 和 Java 堆栈中，具有与 DB2 数据库存储的 JDBC 连接。在这样一种复杂的应用程序堆栈中，为所有可能的问题确定一个故障排除过程是极其困难的。
关键在于将问题分离到更小的堆栈或单个应用程序中，然后再执行进一步的调试或跟踪。例
如，表 2 总结了在一个会议周期中，Sametime EMS 和 Sametime Meeting Room (MR) 服务器之间的关系。
表 2. Sametime MR 服务器和 Sametime EMS 关系综述
| 会议阶段 | 组件 | 功能说明 |
| 计划会议 | EMS | EMS 提供用户身份验证、会议进入验证，检查 MR 容量、外部电话配置/预定（如果已配置的话），将会议数据和幻灯片存储到 DB2 数据库中，并发送电子邮件通知。 |
| 开始会议 | EMS，MR 服务器 | EMS 评估合适的会议服务器并与 MR 服务器交互，将触发器发送给外部电话提供者（如果已配置的话），并将会议数据和幻灯片传递到 MR 服务器。 |
| 参加会议 | EMS，MR 服务器 | EMS 充当会议的前端，提供用户身份验证，并将用户重定向到合适的会议服务器。MR 服务器在用户的浏览器中与 Sametime 会议室客户端（Java applet）交互，并帮助用户准备参加会议。 |
| 出席会议 | MR 服务器 | MR 服务器提供会议控制、服务和交付。 |
| 结束会议 | MR 服务器，EMS | MR 服务器请求 EMS 关闭 DB2 数据库中开放的资源并清除其中的临时数据。EMS 完善会议数据，标记会议结束，并在 DB2 数据库中更新和记录会议细节。 |
在某些情况下，您可能需要联系 IBM Technical Support 来解决问题。如果是这样的话，一定要包含问题的详细描述、相关屏幕截屏和屏幕动画以及所有可用数据，这些内容有助于解决您的问题。
EMS 服务依赖关系
EMS 启动
每个与 EMS 相关的组件都必须按顺序启动，从而满足服务的依赖关系。必需的依赖关系如下所示（见图 2）：
- 必须在启动任何 Sametime EMS Application Server 之前启动LDAP、DB2 和 HTTP Server 并保持可用。
- 必须在任何 Sametime Servers (Meeting Rooms) 之前启动 STAdmin 和 STServer。
- STCenter 应当最后启动，以防止用户在 Sametime Servers (Meeting Rooms) 变得可用之前收到任何异常结果。
图 2. Sametime EMS 启动依赖关系
|
|
|
 |
英文原文 |
级别： 中级
Frank Meng, 咨询软件工程师, IBM
Anne-Liese Stuer, 咨询软件工程师, IBM
2009 年 11 月 11 日
本白皮书旨在帮助您理解构成 IBM® Lotus® Sametime® 7.5.1 和 8.x 服务器及其环境的各个组件，以更好地诊断和排除可能出现的故障。我们介绍了独立的 Sametime（聊天或会议）服务器以及 Sametime Enterprise Meeting Server (EMS)，后者提供了集群、负载均衡和 Sametime 会议服务器集中管理功能。
Lotus Sametime（聊天和会议）基础知识
在版本 8.x 以前，Sametime Server 一直是一个 IBM Lotus Domino® Server 应用程序，并且始终安装在 Domino Server 上。然而，要获得最佳性能，Sametime 8.x 服务器不应当和其他 Domino Server 应用程序混合安装在任何 Domino 服务器上。例如，不应当将 Sametime 8.x 安装在 Domino 邮件服务器上，相反，应当安装到一个专用服务器中，并作为一个后台服务器进程启动。
有两种主要的服务器组件，Sametime Community（即时消息传递或聊天）和 Sametime Meetings（Web 会议）。建议将每种组件分别安装到单独的机器中。其中，Sametime Community 服务器充当用户的主 Sametime 服务器，而 Sametime Meetings 运行在一个专用的会议服务器上。
|
|
有关完整部署场景的更多信息，请参考 IBM Red books® 刊物 “Sametime 7.5.1 - Best Practices for Enterprise Scale Deployment”, 第 28 页第 2.4 小节，部署选项。
由于 Lotus Sametime 常常与其他产品集成，因此必须执行以下检验：
- 目前使用的 Sametime 服务器许可：
Sametime Limited Use。为特定的客户端提供一组核心的感知和即时消息传递，例如 IBM Lotus Notes® 客户端和 Domino® Web Access (DWA)，用以实现消息传递和协作，但是不支持 Web 会议/Sametime 会议。
Sametime Entry。为 Lotus Sametime Connect 桌面客户端或支持 Sametime 的 Microsoft® Outlook 客户端额外提供了到场和即时消息传递功能。
Sametime Standard。额外提供了 Web 会议/Sametime Meeting；为 Lotus Sametime Connect 客户端提供了更多特性，例如集成的 Voice-over-IP (VoIP)、点对点视频、移动客户端；以及地理位置、屏幕截图和文件传输能力等额外特性。
可以在 Lotus Sametime 8 信息中心 中找到完整的对照列表。
- 理解并满足系统需求（平台、版本和硬件等等）
- 在所有互连的服务器中实现多服务器单点登录（SSO）
- 如果集成了其他产品的话（IBM Lotus QuickrTM、Domino Web Access / iNotes® 和 IBM WebSphere® Portal），STLINKS 可以正常工作
- 对于使用 LDAP 目录的 Sametime 专用聊天服务器，使用 STConfig.nsf 连接到 LDAP 目录服务器以实现身份验证（不需要目录帮助）。
- 对于 Sametime 会议服务器，使用 Domino Directory Assistance 数据库通过 Domino HTTP 堆栈对会议中心进行 Web 身份验证。
调试可以在不同级别上执行；具体分为：
- 在 Sametime Server 中
- 在处理集成、Sametime JavaTM 浏览器客户端或 Sametime 会议问题时在浏览器中执行
- 在 Sametime Connect 客户端中（通常称为 Sametime 独立客户端）
- 在 Lotus Notes 集成 Sametime 客户端
在本白皮书的后续小节中，我们将分步探讨每一个级别。由于故障排除的第一步就是收集相关的调试或跟踪数据，因此我们在附录部分（第 8 节）提供了各种调试/跟踪参数列表，可以根据出现问题的位置设置这些参数。
如附录中所述，可以使用 STDebugTool 动态地修改某些参数。这有助于快速收集调试信息，而不必等到下一次服务器重启。
如果您通过浏览器（一个会议或 Java Sametime 客户端）连接到 Sametime 服务器，那么客户端 Java 控制台将始终提供服务器跟踪数据（稍后讨论）。
 |
|
Sametime Server
对于安装在 Domino Server 上的 Sametime Server，您可以使用以下参数进行调试：
- 特定于 Sametime community 服务器（聊天）的参数，被添加到 Sametime.ini [DEBUG] 部分
- Domino 参数，被添加到 Domino Notes.ini 文件
- 对于 Sametime 会议服务器，修改 Microsoft® Windows® Registry，或修改UNIX®/Linux® 的 meetingserver.ini 和 sametimed iag nostics*. Properties 中的特定参数。
配置信息存储在哪里？
所有配置设置都可以通过 Sametime 或 Enterprise Meeting Server (EMS) 管理员 Web 页面访问。对于未包含 EMS 的 Sametime 环境，该信息被存储在 Domino STConfig.nsf 数据库中。对于使用了 EMS 的 Sametime 环境，配置信息保存在一个 IBM DB2® 数据库中。要使任何配置修改生效，必须重启服务器。
下面列出了这个数据库的内容和选择的项的描述。
-
AnonymousAccess。针对这个 Sametime 社区的匿名访问设置。
-
BroadcastGateway。由 stbroadcastgateway.exe 进程读取。用于所有客户端和控制广播连接。注意，默认使用 554 和 8082 端口。
-
Cluster Information。只有在已经定义了一个 Sametime Community Cluster 的情况下包括该项。文档在 STConfig.nsf 中手动创建。
-
CommunityClient。针对 Connect 客户端的设置（Java Connect 客户端和自动客户端供应）。
-
CommunityConnectivity。配置 Sametime 社区中的所有连接选项；例如，是否启用通道，哪些服务器机器被授权连接到这个 Sametime 服务器。
-
CommunityGateway。只有在支持外部社区的情况下包含该项。
-
CommunityServices。有关社区服务目录组件的设置。
-
ConnectionProfile。A/V 客户端的连接速度。
-
LDAPServer。只有在连接到 LDAP 目录进行身份验证和授权的情况下包含此项。只有当连接到具有不同内容的目录时，才应当定义多个 LDAP 文档。故障转移或工作负载均衡机制不需要使用多个文档。
-
如果需要执行负载均衡或故障转移，应该独立实现一个 LDAP 负载均衡器，Sametime 服务器将连接到这个负载均衡器（而不是直接连接到 LDAP 服务器）。
-
LogEvents。控制将哪些事件记录到日志数据库中。
-
LogOutput。控制日志数据的输出方式的设置。
-
MeetingCenter。指定将用于连接 MeetingServer 的预定会议、数据库名和 URL。
-
MeetingServices。用于会议服务组件的设置，包括应当加载哪些 meetingservices、应当应用哪些选项、MeetingServer 主机名和 MeetingServer 连接细节。
-
MMCU。面向多媒体多端点控制单元的设置。
-
MMP。用于多媒体处理器的设置。
-
UsageLimits。针对即时和预定会议的使用限制。
-
UserInfo。名片设置。
Domino Directory 包含 Domino 服务器设置（参考 Server Configuration 文档，了解 Domino 服务器和 HTTP 设置）。此外，可以通过 Sametime Connection 文档实现 Sametime Invited Server 功能。该功能可以用于在两台服务器（发起服务器和受邀服务器）上同时生成会议。
Domino Directory Assistance Database 用于根据 LDAP 目录对 Sametime Meeting 服务的 HTTP 登录进行身份验证和授权。如果没有会议服务加载到 Sametime Server 中，并且 Domino 服务器上也不需要其他 HTTP 身份验证，那么就不需要使用 Directory Assistance 数据库，因为将根据 Sametime 配置 LDAP 文档进行身份验证。
Sametime 服务器加载哪些进程？
下面列出了 Sametime 服务器加载的进程：
-
STAddin or STaddin2 for iSeries®。负责启动 Sametime Server 服务（STLaunch）的主要服务。
-
STMSService (STMSactivityprovider)。Sametime Meeting Room Service，用于会议预定、安排、举办和调整。
-
STCommLaunch。Sametime Community Server Service。
-
STMeetingServer。运行在 Lotus Domino 之下的 Sametime Meeting Server 进程。它加载 Java Virtual Machine (JVM)（如果未加载的话）并启动 Sametime Event Service。
-
STEvent。Sametime Event Service，管理所有底层 Sametime 服务的启动以及这些服务的依赖关系。
默认情况下，会议服务在 Community 服务之前启动，但是对于专用的聊天服务器，会议服务应当被禁用。对于 Windows，可以通过注册表完成此操作；对于 UNIX 和 iSeries，可以在 Meetingserver.ini 文件中禁用会议服务。（有关更详细的步骤，请参考 Lotus Software Knowledge Base 文档 #1107137, How to disable Sametime meetings and only use Sametime for chat。
Sametime Meeting Server 服务包括（对于 Windows 平台，该列表和依赖关系存储在注册表
中，对于 UNIX/iSeries 平台，这些内容存储在 Meetingserver.ini 文件中）：
-
ActivityProvider。启动还依赖于 STCommunity 服务和所有额外的会议功能，比如 AV、T120 和白板。
-
AuthenticationServer。身份验证服务和事件。
-
AVMMP。 面向 A/V 多媒体功能的基本服务。
-
BroadcastGateway。 依赖于 T120MCU Multi-point Control Unit (MCU)。 CalendarService。 提供与 Domino Calendar & Scheduling 的集成。CapacityMonitor。 会议容量监视服务。
-
ConfigurationBridge。 检索Sametime 配置数据。
-
EventBridge。 Intraserver 令牌服务（默认端口 9094）。
-
EventServer。 Intraserver 事件服务（默认端口 9092）。
-
GWController。 启动还依赖于 STCommunity Service 和 broadcastgateway。
-
H323MCU。用于 IP A/V 功能；依赖于 T120MCU。
-
JavaServiceManager。Java Service Manager。
-
Logger。提供日志功能。
-
MaterialManager。为会议提供上传的幻灯片。SharedObjectServer。提供屏幕共享服务。
-
StatisticsSe rver。提供 Sametime 统计服务。 STStreamedMediaService。依赖于 AVMMP 服务。
-
T120MCU。提供开放标准 T.120 MCU 电话会议服务。
-
WhiteboardService。依赖于 T120MCU 服务。
STCommLaunch 负责启动 Sametime Community Server 服务集合（启动顺序列表存储在 StCommLaunch.dep 中）：
-
ST Community。提供聊天服务。
-
ST Configuration。定时检查 Sametime 服务配置服务。
-
ST Logger。提供日志功能。
-
ST Places。用于即时消息传递。
-
ST Users。提供用户身份验证。
-
ST OnlineDir。提供多台服务器之间的感知功能。
-
ST BuddyList。为所有用户、好友列表管理和对等服务器应用程序提供感知功能。
-
ST Conference。提供即时消息传递服务。
-
ST Directory。提供目录浏览功能。
-
ST Chat Logging。在 Sametime 服务器上提供聊天记录服务。
-
ST Polling。允许通过 HTTP 传输 Sametime 协议消息。
-
ST Links。在将 Sametime 感知集成到其他产品时使用该功能。
-
ST Resolve。负责处理所有名称解析功能，例如，向 LDAP 目录构建名称解析请求。
-
ST User Storage。负责管理 VPUserInfo.nsf，其中包含所有联系人列表细节。
-
ST Privacy。提供隐私消息（“谁能看见我”）服务。
-
ST Mux。提供用户和社区服务器之间的接口。
-
ST Admin。提供 Sametime 服务器管理服务。
-
ST Security。提供登录客户端版本控制或安全级别。
-
ST Policy。管理用户策略（在 Sametime 7.5x 中引入）。
-
ST Capabilities。支持客户端发布其登录属性，比如，Voice、Video 和富文本聊天。
-
ST File Transfer。提供客户端文件传输服务。
-
ST Reflector。为基本的客户端到客户端 VoIP 功能提供音频反射器。
修改 Sametime 服务器跟踪记录目录
默认情况下，所有跟踪文件均存储在 \Trace 目录中。Trace 文件夹的位置可以通过 Sametime.ini 参数修改。该目录必须在重启 Sametime Server 之前手动创建。
其他诊断数据通常通过 SametimeDiagnostics*.properties 文件被写入到默认的跟踪目录中。如果希望重定向所有跟踪数据，那么必须像下面这样修改这些文件：
[Config] ST_TRACE_PATH=X:\Sametime\Trace |
常见的 Sametime 活动信息，比如社区（聊天）、文件传输和会议统计数据以及日常活动，都被记录到 STLog.nsf 中。
Sametime 服务器跟踪在默认情况下被禁用，但是，可以通过使用如下 Notes.ini 参数启用它并指定给一个特定的文件：
ST_DEBUG_FILE_NAME=\ |
由于服务器控制台上显示的所有信息并非全部被写入到 STLog.nsf，因此常常需要确保 Sametime 跟踪已被启用并且收集了跟踪数据。
附录中提供了一组额外的 Same 调试参数列表。
Sametime 服务器性能
由于 Sametime 服务器被加载到 Domino 服务器中，因此必须同时审视 Sametime 服务器性能和 Domino 服务器的一般性能。性能是一个广泛而深入的主题，并且您必须通过考虑完整的服务器运行环境来对性能进行分析。
首先，您需要判断出现性能问题的位置：
- 检查加载的任务的 CPU 使用情况。不要启用多余的功能；例如，在使用大型 LDAP 目录时，Directory Search 的开销将非常巨大。
- 对于使用 Domino HTTP 任务的 Sametime 活动（比如会议），通过 HTTP 请求记录确定 Domino Web 服务器出现的问题。例如，使用端口 ping 评估服务器可用性的监视器（比如 IBM WebSphere Edge server 和 Big-IP）会对 Domino HTTP 服务器造成过量负载，这将对 Sametime HTTP 行为造成直接的负面影响。
- 对于 Sametime LDAP 请求，检查与 LDAP 服务器的连接是如何配置的。STConfig.nsf 应当只包含一个指向 LDAP 服务器的 LDAP 文档，或者最好包含面向多个 LDAP 服务器的负载均衡器。
如果使用了一个 LDAP 负载均衡器，那么确保对地址进行定期检查。默认情况下，ST-to-LDAP 连接永远不会被重新建立（re-spray），因此 Sametime 服务器将在启动时从 LDAP 负载均衡器接收一个 LDAP IP 地址，但是永远不会对这个地址进行重新检查。
这将产生一个负面影响，这是因为如果特定的 LDAP 服务器停机或与该服务器的连接出现问题，那么不会执行任何故障转移，直到重启 STDirectory 服务。因此对 LDAP 地址进行定期检查十分重要（Sametime 服务器将每隔 X 分钟检查一次 LDAP 负载均衡器，确保使用了一个有效的 LDAP IP 地址），使用如下参数：
ST_DB_LDAP_RESPRAY_I NTERVAL= (default=0)
注意：术语“重建”表示连接将被移除并重新建立，因此建议不要把值设得过低，以避免引起过高的开销。可以先将时间间隔设置为 5 分钟，然后根据具体环境进行调整。
- 如果 Lotus Sametime 在响应身份验证或名称查找请求时速度较慢，那么应检查一下与目录服务器的连接，并在 Sametime 解析或社区跟踪日志中查找可能的队列消息（通过VP_LDAP_TRACE=1 启用）。
低性能可能是由 Sametime 服务器、目录服务器以及两者之间的连接出现超载引起的，因此不能足够快地处理传入的请求。参考 Lotus Support Technote #1 200143， Optimizing LDAP connections and queries on a Sametime server 获得有关 Sametime 和 LDAP 服务器连接的指导。
- 如果在集成另一个产品（Domino Web Access/iNotes、Lotus Quickr 和 WebSphere Portal）的情况下，与 Lotus Sametime 的连接十分缓慢，那么应当检查 STLINKS 的行为。在协作产品中通过 Java applet STLINKS 提供了感知功能；因此，感知集成依赖于 STLINKS 限制。
技巧：将默认的 128MB STLINKS JVM 内存提高到更高的值可以改善性能并解决内存不足问题。比如，我们在 Sametime 服务器的 Sametime.ini 中将 STLINKS JVM 内存提高到 256MB：
[STLinks] STLI N KS_VM_ARGS=-Xmx256m -Xms256m -Xgcpolicy:optavg pause
- 如果协作产品中负责感知功能的主 Sametime 服务器是一台专用的聊天服务器，那么不需要对其使用目录帮助数据库执行身份验证。
在 Sametime Domino 服务器上显示目录帮助可以缩短加载时间，因为在包含 Lightweight Third-party Authentication (LTPA) 令牌的 HTTP 下载请求之后，不会执行额外的（多余的）身份验证和授权。
在对会议服务器检查连接问题时，还需要知道问题发生在哪个区域。如本白皮书第 3 节所述，有关会议室客户端（MRC）的问题，还应当收集浏览器的 Java 控制台日志。
|
|
客户端故障排除
浏览器客户端
浏览器客户端主要用于：(1) 聊天和感知（当集成其他产品时将使用 Sametime Java Connect 客户端或 STLINKS）；(2) 会议中心客户端。
如果出现于浏览器客户端有关的问题，需要执行以下操作：
- 同时从客户端和服务器端收集跟踪信息（确保数据是在同一时间收集的）：
- 在客户端，收集浏览器 Java 控制台和 IBM Page Detailer 跟踪（Page Detailer 是一款图形化工具，允许 Web 内容提供者快速、准确地测量 Web 页面在客户端的性能）。
- 使用 DebugLevel.class.5（位于 Debug 子目录）替换 DebugLevel.class 文件（位于 Sametime 服务器中的 \domino\html \sametime\[stlinks or javaconnect]），增强 Java Connect 和 STLINKS 在客户端的调试。
注意：确保在复制后删除 .5，并在重试之前清除浏览器缓存。
- 在服务器端，可以在 Sametime.ini [Debug] 部分启用额外的调试选项（参见附录）。
Sametime 连接客户端
首先，参考 Lotus Support Technote #1319789， “Collecting Data: Lotus Sametime Connect client (standalone desktop) for version 7.5x and 8.x.”
在客户端，确保调试级别被设置为更高的细节程度：
- 对于 7.5.x Connect 客户端，在 sametime.properties 文件中将 “.level=” 修改为 FINE，该文件位于 Sametime 客户端安装目录。
- 对于 8.x Connect 客户端，在 rcpinstall.properties 文件中将 “.level=” 修改为 FINE，该文件位于 Windows XP 用户配置目录， \Application Data\Lotus\Sametime\.config。例如：
C :\Docu ments and Settings\Ad ministrator\Application Data\Lotus\Sametime\.config
注意：“.level=FINEST”可以设置为获取更多的细节。
输出被写入到用户配置目录，但是，根据 Connect 客户端的具体版本，子目录是不同的：
Sametime Connect 客户端 7.5.1 在 Windows XP 上：
\l BM\RCP\Sametime |
在 Macintosh & Linux 上：
/Library/Preferences/Sametime |
Sametime Connect 客户端 8.x 在 Windows XP 上：
\Application Data\Lotus\Sameti me\logs |
在 Macintosh & Linux 上：
/Lotus/Sametime or /lotus/Sameti me/logs |
Sametime Connect 客户端 8.x 在 Windows Vista 上：
\AppData\Roaming\Lotus\Sametime\logs |
在 Sametime 8.x Connect 客户端中，可以通过使用 IBM Support Assistance 轻松地收集完整的调试文件集合（从菜单中选择 Help > Support > IBM Support Assistance > Service）。
Lotus Notes integrated Sametime 客户端
和对 Sametime 连接客户端进行故障排除一样，您必须首先将调试级别设置为一个更加详细级别。对于 Notes 8.x 标准客户端，在 rcpinstall.properties 文件中修改以下两个参数，该文件位于 Notes data dir\workspace\.config中：
com.ibm.collaboration.realtime.level=FINE (or FINEST) com.lotus.sametime.level=FINE (or FINEST) |
输出被写入到 \workspace\logs。有关更多信息，请参考 Lotus Support Technote #1320442, Collecting data for embedded Sametime client for Notes 8.x clients。
|
|
Lotus Sametime Enterprise Meeting Server (EMS)
Lotus Sametime EMS 将 IBM WebSphere Application Server、DB2 和 LDAP 目录技术集成到一个负载均衡的、容错的、高可用性的企业会议解决方案中，并且是对 Lotus Sametime 技术的自然扩展。
现在让我们来讨论各种可以增强 Sametime EMS 和 Sametime Meeting Room Servers 的可靠性、服务能力和性能的实践（适用于版本 7.5.1 和 8.0.x）。
Sametime EMS 基础设施需求
下面是来自安装包中的 EMS 基础设施需求：
对于 Sametime EMS 7.5.1：WebSphere Application Server V6.0.2.11 和 DB2 Enterprise Server Edition 8.2
对于 Sametime EMS 8.0.x：WebSphere Application Server V6. 1.0.9 和 DB2 Enterprise Server Edition 9.1
根据客户需求和实际的部署，可以对 WebSphere Application Server 执行基础部署或网络部署（ND）。
建议将 WebSphere Application Server / IBM HTTP Server 和 DB2 更新到最新的补丁级别。对于 WebSphere Application Server、HIS 和 IHS-plugin，除非特殊说明，否则补丁级别和 iFix 级别应当始终匹配。DB2 服务器和 Connect 客户端必须保持在相同的版本。
EMS 设计
作为一项最佳实践，每个 Sametime 基础设施组件都应当放在一个专用的、单独的硬件平台上，从而获得最佳性能。
一种基本的生产设计就是对 WebSphere Application Server、DB2 和 Sametime EMS 使用三个专用的硬件平台；具体来讲，为 Sametime 会议和社区服务器使用两个专用硬件平台，为 LDAP 目录使用一个专用硬件平台。
通过增加以上任何组件以及 IP sprayer 负载均衡器和反向代理服务器，可以演变为更复杂的设计（见图 1）。
图 1. 理想的生产设计
注意：Sametime EMS 要求使用相同的Sametime Server 版本。在升级过程中，一定要从 Sametime EMS 集群中删除 Sametime 服务器，并在完成 Sametime Server 和 EMS 的升级后将 Sametime Server 添加回 Sametime EMS 集群。
Sametime EMS Application Server
所有 EMS Application Server 数据均存储在 DB2 数据库中，可以通过 DB2 客户端连接对这些数据执行本地访问或远程访问。表 1 总结了这三个 EMS WebSphere Application Server。
表 1. EMS WebSphere Application Server
| 服务器名称 | 描述 |
| STAdmin | EMS 管理，用于管理用户界面（UI）和功能 |
| STServer | EMS 管理，用于 Scheduler、负载均衡、会议管理、健康检查；提供 Configuration Server 功能 |
| STCenter | EMS Meeting Center，用于用户界面（UI）和功能 |
Sametime EMS 故障排除
EMS 应用程序位于 WebSphere Application Server 和 Java 堆栈中，具有与 DB2 数据库存储的 JDBC 连接。在这样一种复杂的应用程序堆栈中，为所有可能的问题确定一个故障排除过程是极其困难的。
关键在于将问题分离到更小的堆栈或单个应用程序中，然后再执行进一步的调试或跟踪。例
如，表 2 总结了在一个会议周期中，Sametime EMS 和 Sametime Meeting Room (MR) 服务器之间的关系。
表 2. Sametime MR 服务器和 Sametime EMS 关系综述
| 会议阶段 | 组件 | 功能说明 |
| 计划会议 | EMS | EMS 提供用户身份验证、会议进入验证，检查 MR 容量、外部电话配置/预定（如果已配置的话），将会议数据和幻灯片存储到 DB2 数据库中，并发送电子邮件通知。 |
| 开始会议 | EMS，MR 服务器 | EMS 评估合适的会议服务器并与 MR 服务器交互，将触发器发送给外部电话提供者（如果已配置的话），并将会议数据和幻灯片传递到 MR 服务器。 |
| 参加会议 | EMS，MR 服务器 | EMS 充当会议的前端，提供用户身份验证，并将用户重定向到合适的会议服务器。MR 服务器在用户的浏览器中与 Sametime 会议室客户端（Java applet）交互，并帮助用户准备参加会议。 |
| 出席会议 | MR 服务器 | MR 服务器提供会议控制、服务和交付。 |
| 结束会议 | MR 服务器，EMS | MR 服务器请求 EMS 关闭 DB2 数据库中开放的资源并清除其中的临时数据。EMS 完善会议数据，标记会议结束，并在 DB2 数据库中更新和记录会议细节。 |
在某些情况下，您可能需要联系 IBM Technical Support 来解决问题。如果是这样的话，一定要包含问题的详细描述、相关屏幕截屏和屏幕动画以及所有可用数据，这些内容有助于解决您的问题。
EMS 服务依赖关系
EMS 启动
每个与 EMS 相关的组件都必须按顺序启动，从而满足服务的依赖关系。必需的依赖关系如下所示（见图 2）：
- 必须在启动任何 Sametime EMS Application Server 之前启动LDAP、DB2 和 HTTP Server 并保持可用。
- 必须在任何 Sametime Servers (Meeting Rooms) 之前启动 STAdmin 和 STServer。
- STCenter 应当最后启动，以防止用户在 Sametime Servers (Meeting Rooms) 变得可用之前收到任何异常结果。
图 2. Sametime EMS 启动依赖关系
EMS 关机
如果需要完整地关闭 EMS，只需按照相反的顺序执行上面的启动步骤。
EMS 重启
- 停止所有 Sametime 服务器。
- 停止 EMS STServer、STAdmin 和 STCenter Application Server。
- 启动 STAdmin / STServer Application Server。
- 启动 Sametime 服务器。
- 在至少一台 Sametime Meeting Room 服务器进入运行状态后，可以启动 STCenter。注意，可能需要 5 到 10 分钟的时间才能使 Sametime 服务器进入一个“健康”（即运行）状态。
提示：可以通过访问下面的 EMS 管理 Server 概览页面监视 Sametime 服务器启动过程：
http:///iwc-adm in/client |
针对 Windows 的样例脚本
下面展示了一些针对 Windows 的样例脚本，可以启动、停止、重启 EMS 并检查其状态。用户名和密码使用了明确的格式，必须做出相应的修改。
启动 EMS：
REM *****Start EMS Servers***************
call C:\WebSphere\AppServer\bi n\startserver.bat STAdmin
-username wasadmin -password password
call C:\WebSphere\AppServer\bi n\startserver.bat STServer
-username wasadmin -password password pause
REM *****Wait for Sametime Meeting Room Server to be active**************
call C:\WebSphere\AppServer\bi n\startserver.bat STCenter
-username wasadmin -password password pause
停止 EMS：
REM *****Stop EMS Servers***************
call C:\WebSphere\AppServer\bi n\stopserver.bat STAdm in
-username wasadmi n -password password REM ******************
call C:\WebSphere\AppServer\bi n\stopserver.bat STServer
-username wasadm in -password password REM ******************
call C:\WebSphere\AppServer\bi n\stopserver.bat STCenter
-username wasadmin -password password pause
重启 EMS：
REM *****Stop EMS Servers***************
REM ...
call C:\WebSphere\AppServer\bi n\stopserver.bat STAdmin
-username wasadmin -password password REM ...
call C:\WebSphere\AppServer\bi n\stopserver.bat STCenter
-username wasadmin -password password REM ...
call C:\WebSphere\AppServer\bi n\stopserver.bat STServer
-username wasadmin -password password
REM *****Start EMS Servers***************
call C:\WebSphere\AppServer\bi n\startserver.bat STAdmin
-username wasadmin -password password
REM ...
call C:\WebSphere\AppServer\bi n\startserver.bat STCenter
-username wasadmin -password password
REM ...
REM *****Wait for Sametime Meeting Room Server to be active**************
pause
call C:\WebSphere\AppServer\bi n\startserver.bat STServer
-username wasadmin -password password pause
检查 EMS 状态：
REM *****Check EMS Server Status***************
call C:\WebSphere\AppServer\bin\serverstatus.bat -all
-username wasadmin -password password pause
|
Sametime Server 配置信息在 EMS 中的存储位置
将 Sametime Server 成功添加到 Sametime EMS 集群之后，所有配置信息将被存储在 DB2 数据库中的 STConfig 模式中。Sametime Server 将不再读取 STConfig.nsf 来获得它的配置数据，相反，将通过 Sametime EMS STServer 应用程序读取。
以下配置将被反映到 Sametime 服务器的 Sametime.ini 中：
ConfigurationPort=80 ConfigurationHost=* ConfigurationServletURL=/stserver/config Sameti垃圾广告nagedServer=true Sameti meAdm inAuthorization=xxxxxxxxxxxx (Authorization key) |
如果 SSL 在 EMS 上被启用，那么配置将为：
Configuration Port=443 ConfigurationSSLEnabled=true |
可以使用三种方法检查配置：
方法 1（推荐）。使用 Sametime EMS Administration UI 查看和修改 Sametime Server 配置：
http:///iwc-ad m in/client |
方法 2. 使用以下 URL 查看 XML 格式的配置： http:///stserver/config?xpath
方法 3. 使用一条 SQL 语句从 Sametime DB2 数据库的 STCON FIG 模式下的相关表中检索数据。可以通过 SQL 语句更新配置，从而更新相关表中的记录，但是不推荐使用这种方法，因为任何错配的记录都会引起不一致性和异常结果。
以下是 Sametime 服务器配置 DB2 Table Names：
STCONFIG.communitySERVER STCONFIG.eventSERVER STCONFIG.ROOMSERVER STCONFIG. meetingSERVER STCONFIG.tokenSERVER STCONFIG. BroadcastGateway STCONFIG.mmcu STCONFIG.MMP STCONFIG.SERVERAPPLICATION STCONFIG.TOKENSERVER |
在 EMS 中向 Sametime Server 应用热补丁
最佳实践要求对 Sametime Community 和 Sametime Meeting Room Server 使用专用服务器，并对负载均衡和故障包容实现冗余。在一个企业 EMS 部署中，在单一 Sametime 服务器中共享这两种服务器类型的可能性非常低，除非用于试验或测试环境。
为了便于管理，应当维护相同的服务器版本，并使用相同的补丁包级别；也就是说，应用到 Sametime Community Server 的任何热补丁也应当应用到 Sametime Meeting Room Server，反之亦然。
应用 Sametime Server 热补丁
在将热补丁应用到 Sametime EMS 环境之前，必须对其进行检验。推荐的步骤是首先从 Sametime EMS 集群中删除 Sametime Server，应用 Sametime Server 热补丁，然后检查热补丁是否成功应用，随后再将 Sametime Server 添加回 EMS 集群。
应用 Sametime EMS 热补丁
遵循以下步骤应用 EMS 热补丁，这个热补丁通常为一个 .jsp 或 Java 类/jar 文件：
- 首先，对原始的 .jsp 文件进行备份，然后使用系统中的 hotfix .jsp 文件替换原始文件。无需重新启动；WebSphere Application Server 将检测文件是否修改，并在下一次访问时重新编译 .jsp 文件。
- 对原始 .jar 文件进行备份后，必须将 Java 类/ jar 文件添加到具有相同目录结构的相应的 .jar 文件中。由于很容易将类文件放到错误的目录结构中，因此在应用了补丁后重新检查一遍 .jar 文件是明智的做法。
- 如果要替换 lib 目录中的 Java .jar 文件，应当对所有三个 WebSphere Application Server（STAdmin、STServer 和 STCenter）应用程序应用补丁，从而确保一致性和管理的简单性。遵循一般的热补丁指导说明。
一般情况下，遵循所有的热补丁说明，检查它是否得到正确运用，并注意以下几点：
- 任何 Java 类/jar 文件修改都需要重新启动相应的 EMS 应用服务器。
- 一个 SQL 语句文件（.sql）可能也被包含在 EMS 热补丁中。遵循说明，在 DB2 命令行中执行 SQL 语句。
启用 Sametime MR Server、EMS 和 Meeting 客户端跟踪/调试
Sametime MR Server 调试
由于 Sametime MR Server 使用了 Domino HTTP 进程，第一步可能需要启用 Domino HTTP 请求调试，以理解会议 HTTP 请求。Page Detailer 跟踪和分析可以帮助评估 Web 服务器性能。
Sametime MR Server 调试方法对于 Windows 和 UNIX（AIX®、Solaris 和 Linux）平台可能有所不同，但是相关的参数仍然是一样的。所有调试文件将输出在 \trace 文件夹中；例如，c:\lotus\domino\trace。
两种 MR Server 调试类型分别是：
- C++ 调试，适用于 Meeting Server 组件或作为可执行 (.exe) 文件运行的模块
- Java 调试，适用于在 JVM 进程下运行的 4 个 Java 服务。这四个服务分别为 Event Server (ES)、Gateway Controller (GWC)、Java Service Manager (JSM) 和 Token Server (TS)
在调试 MR Server 问题时，建议同时启用 C++ 和 Java 诊断。
与 Sametime MR Server C++ 相关的代码调试
Windows：
在 Windows 上，通过修改以下注册表键在 Windows Registry 中启用调试：
[H KEY_LOCAL_MACH IN E\SOFTWARE\Lotus\Sametime\MeetingServer\Diag nostics] "Log PrintLevel"=dword :00000010 "ModuleLogEnabled"=dword:0000000 1 "MaxLogSizeM b"=dword :0000000a "SummaryLogEnabled"=dword:00000001 "SummaryLogFilename"="summary.diag" |
这些参数的定义如下：
LogPrintLevel。表 3 总结了 Diagnostic Log Print Levels。
表 3. Diagnostic Log Print Levels
| LogPrintLevel | 诊断输出前缀 | 诊断 |
| 0x00=0 | 没有记录诊断 | |
| 0x02=2 | [error] | 记录的错误级别 |
| 0x04=4 | [warning] | 记录的错误和警告级别 |
| 0x08=8 (default log level) |
[trace] | 记录的错误、警告和跟踪级别 |
| 0x10=16 | [notify] | 记录的错误、警告、跟踪和通知级别 |
在执行普通操作期间，应当避免禁用 LogPrintLevel 并将其设置为 0x04 (Warning) 或 0x08 (Trace) 级别，以帮助管理员解决一般的生产问题。
ModuleLogEnabled。启用分区（splitting）模块记录。启用该功能后，将针对每一个模块进程单独创建模块调试文件，并使用 .diag 作为后缀，例如 stconfigurationbridge.exe.diag。
避免禁用 ModuleLogEnabled，因为当它被禁用后，所有模块调试输出将被存储到一个单一的 summary.diag 文件中。这将使文件变得冗长，并使文件体积不断增长，直到触及 OS 的底限。
MaxLogSizeMb。当禁用 ModuleLogEnabled 之后，每个模块输出文件的大小将被限制。当达到了大小限制并重启 Sametime Server 后，当前的调试文件将被重命名并生成一个新文件。如果永远不重启 Sametime Server，那么输出文件的大小将一直增长，直到触及系统的底限。
定期重启 Sametime Server 非常重要，这样才能控制日志文件的大小。由于只保留了两个文件，当前文件和早先的一个文件，因此在时间敏感数据被重写或丢失之前，还需要收集这些数据。如果没有设置 MaxLogSizeMb，那么默认值为 2047MB。
在本例中，"MaxLogSizeMb"=dword:OOOOOOOa，MaxLogSize 被设置为 10MB。注意，设置使用的是十六进制，十六进制的 Oxa 等于十进制中的 10。
SummaryLogEnabled。启用或禁用 summary 日志。将这个注册表值设置为 "OxOO" 将禁用 summary 日志输出。该设置将把 ALL 诊断模块记录到一个单一文件中。如 "ModuleLogEnabled" 被启用，那么各个模块也将被同时记录。
如果生成了大量调试数据，那么 summary 日志文件会不断增长直到失去控制，在这种情况下，您应当在启用 "ModuleLogEnabled" 之后禁用 summary 日志。MaxLogSizeMb 不适合用于 summary 日志文件。
SummaryLogFilename。Summary 日志文件的名称，默认名称为 summary.diag。
UNIX：
在 UNIX 上，在
可以在必要时添加/编辑以下参数，每个参数的解释与使用 Windows 的情况相同：
[SOFTWARE\Lotus\Sametime\MeetingServer\Diag nostics] LogPrintLevel=16 SummaryLogEnabled=1 SummaryLogFilename=summary.diag ModuleLogEnabled=1 MaxLogSizeMb=1 0 |
与 Sametime MR Server Java 有关的日志
通过修改相应的服务 JVM 诊断属性文件，可以启用与 Sametime MR Server Java 有关的调试，方法与使用 Windows 和 UNIX 平台的情况相同。注意，在做出任何修改之前，必须备份当前的 SametimeDiagnostic*.properties 文件。
下面展示了 中的相关属性文件：
SametimeDiagnostics. properties Sametime Server servlet SametimeDiagnostics_JSM . properties Java Service Manager SametimeDiagnostics_TS.properties Token Server Sameti meDiag nostics_GWC. properties Gateway Controller SametimeDiagnostics_ES.properties Event Server |
可以按如下所示修改服务调试级别：
# Levels: Off(0), Critical(10), Error(20), Warning(30), Notify(40), Trace(50) com=50 com.lotus=50 com.ibm=50 |
与 Sametime Telephony Service 有关的调试
Sametime Audio/Video Services 支持交互式 IP 音频和视频功能，并支持拥有相应硬件的客户端（声卡、麦克风、扬声器和摄像头）在 Sametime 会议期间传输和接收实时音频和视频。
要启用调试，修改 SametimeDiagnostics_Telephony.properties，将以下两个字段设置为 FINE 或 FINEST（如果需要额外的细节信息的话）：
.level= FINE java.util .logging.ConsoleHandler.level = FINE |
Sametime MR Client 调试
对于 Sametime Server 版本 8.0 和更高版本，默认情况下启用了 Meeting Room Client 调试，并且用户只需打开 Java 控制台来获得 MR Client 调试信息。
对于 Sametime Server 版本 7.5.1，MR 客户端调试默认情况下被禁用，因此必须执行以下操作：
为单个客户端工作站启用调试
首先，必须确定工作站上的 Java 主目录的名称。为此：
- 在目标客户端工作站，在进入一个 Sametime 会议后，打开 Java 控制台并查看类似如下所示的条目：
Java Plug-in 1.6.0_13 Using JRE version 1.6.0_13 Java HotSpot(TM) Client VM User home directory = C:\Documents and Settings\Administrator
在本例中，Java 主目录为 C:\Documents and Settings\Administrator
- 将 Diagnostics.properties（如下所示）保存到客户端的 Java 主目录中。
- 重启客户端浏览器后，有关 Sametime Meeting Room Client 和 Broadcast Client 的额外的调试信息将被记录到浏览器 Java 控制台中。
- 完成调试后，从工作站的 Java 主目录中删除 diagnostics.properties 文件，或者编辑 diagnostics.properties 文件，以将诊断设置修改回 false。
- 重启浏览器以使修改生效。
Diagnostics.properties 文件：
# ***************************************************************** # # IBM Confidential # # OCO Source Materials # # (C) Copyright IBM Corp. 2002, 2005 # # The source code for this program is not published or otherwise # divested of its trade secrets, irrespective of what has been # deposited with the U.S. Copyright Office. # # ***************************************************************** # Diagnostics # DO NOT TRANSLATE THIS FILE MRCNotifyEnabled=true MRCWarningEnabled=true MRCTraceEnabled=true BCNotifyEnabled=true BCWarningEnabled=true BCTraceEnabled=true DirectoryNotifyEnabled=true DirectoryWarningEnabled=true DirectoryTraceEnabled=true CTDNotifyEnabled=true CTDWarningEnabled=true CTDTraceEnabled=true # Logging Level # # The logging level can be changed to alter the visibility # of diagnostic log prints. # The default log level is '1' and includes all diagnostic # prints that don't require a higher log-level setting. The following # values can be used, but there's no limit on the log-level value. # The following log-level values are commonly used. # # LogLevel=1 Normal logging (basic) # LogLevel=5 Trace logging (moderate) # LogLevel=10 Debug logging (verbose) LogLevel=10 # Log Format # # The log format can be modified to alter the content and format # of diagnostic log entries. The log is formatted using Java's # MessageFormat class if formatting information is required. # |
| Ordinal | Type Description | |
| {0} | Date Date/time of diagnostic event | |
| String | Thread | |
| String | Module | |
| String | Diagnostic message | |
# The following log-entry values are available for each diagnostic print.
# # # # # #
LogFormat=[{0,date,MM/dd H:mm:ss.SSS}]\t{ 1 }\t{2}\t{3}
|
在 Sametime MR Server 上为所有 Meeting Room 客户端启用调试
不需要重启 Sametime MR Server，但是 Meeting 客户端浏览器必须重启，这样才能使修改生效。
1. 要查找和编辑 Diagnostics.Properties 文件，执行以下操作：
- 在 Meeting Room 客户端上，它位于 Sametime 服务器数据目录的以下子目录中：
\domino\html\sameti me\stmeeting roomcl ient\STMRCResxx \properties
（其中 xx 表示 Lotus Sametime 的发行版）
- 在 Broadcast 客户端上，它位于 Sametime 服务器数据目录的以下子目录中：
\Lotus\Domino\data\domi no\html\sametime\stbroadcastcl ient
2. 修改一下设置：
如果调试 MR 客户端：
MRCNotifyEnabled=true MRCWarningEnabled=true MRCTraceEnabled=true |
如果调试 Broadcast 客户端：
BCNotifyEnabled=true BCWarningEnabled=true BCTraceEnabled=true |
同样，修跟踪的日志级别：
Log Level=1 0 |
3. 当调试完成后，将值设置回 false 和 LogLevel=1。
在 Windows 上启用和获得调试信息（Sun JVM），执行以下步骤：
- 选择 Start > Control Panel > Java。
- 在 Advanced 选项卡中，在 Settings 下，展开 Java 控制台，选择 Show 控制台选项，然后单击 Apply（参见图 3）。控制台应当会自动启动。
图 3. 在浏览器中启用 Java Logging
要在 Internet Explorer 中查看 Java 控制台，从菜单中选择 Tools > Sun Java Console。（如果需要的话，保存控制台信息以发送给 IBM Support）。
注意：要自动将调试保存到文本文件，您有两种选择：为 Java 启用日志选项：
- 单击 Start > Control Panel > Java。
- 在 Advanced 选项卡中，在 Settings 下展开 Debugging，选择 Enable Logging 选项并单击 Apply。
或者
在 Java 控制台中使用命令动态启用或禁用日志（见图 4），只需输入 "o" 即可启用日志，再次输入 "o" 将禁用日志。
图 4. 从 Java 控制台触发 Java 日志
Java 跟踪日志文件将被命名为 plugin*.trace，该文件位于 \Application Data\Su n\Java\Deployment\log 文件夹。例如：
c:\docu ments and settings\ad ministrator\application data\su n\java\deployment\log.
Sametime EMS 调试
您可以在 WebSphere Application Server Deployment Manager 或 server01 配置下设置 Sametime Enterprise Meeting Server 调试（单个 WebSphere Application Server 部署）。
要启用 Sametime EMS 调试，遵循以下步骤：
- 以管理员身份登录到 WebSphere Application Server Console：
对于 WebSphere Application Server 网络部署：
http:// :9060/ibm/console
对于 WebSphere Application Server 基础部署：
http:// :9060/ibm/console
- 转到 Troubleshooting > Logs and Trace，然后选择所需的 EMS 应用服务器名称，并选择 Change Log Detail Levels。
- 在方框中，将 *=info 修改为 *=info:com .lotus.sametime.*=all；单击 OK。
- 对 STAdmin 和 STServer 执行相同的步骤。
- 修改了所有三项内容后，单击 Save。
- 重启 EMS 应用服务器，以使更改生效。
要禁用高级日志功能，遵循和上面相同的步骤，将 *=info:com.lotus.sametime.*=all 修改为 *=info。
Trace 日志文件将在 /profile//logs/ 下生成；例如，C:\WebSphere\AppServer\profiles\AppSrv01\logs\STAdmin。
由于生成的跟踪文件可能非常大和冗长，因此需要针对您的特定问题寻找相应的文件：
- STCenter 跟踪文件将针对与用户有关的问题记录行为，例如，某个用户无法创建会议。
- STServer 跟踪文件针对和服务器相关的问题，例如，会议无法开始，多个会议、room 服务器无法启动。
- STAdmin 跟踪用于管理问题。
维护 Sametime EMS 和 Sametime Server 跟踪文件
在 Sametime EMS 和 Sametime Server 上，可以启动某些详细的跟踪和调试来排除众多问题。然而，一定要确保只启用了必要的调试来捕捉问题的范围。如果启用了大量无关的调试参数，那么将引起性能下降，因为大量数据将被写入到跟踪文件或数据库中。
可能需要缩小范围来判断问题的根源所在，因此，要将跟踪文件控制到一个合理的大小，您应当在服务器离线时对生成的跟踪和日志文件执行备份，并清除这些文件。
将日志文件控制在一个合理的大小，这样可以帮助 IBM Technical Support 团队轻松地读取数据并准确地判断问题。在问题得到解决后，应当删除这些相关的调试和跟踪文件。
下面的文件应当经常执行备份和清理：
Sametime EMS：/profile/logs 目录。
Sametime Server：/Trace 目录，/sametime.log
Sametime MR Domino Server SSO 调试
启用以下调试，在 Domino Server 上获得有关 LTPA 和 SSO 的详细信息：
WEBAUTH_VERBOSE_TRACE=1 Debug_SSO_Trace_Level= 1 (or 2 to provide additional information) WebSess_Verbose_Trace= 1 Console_log_enabled= 1 |
无需重启 Lotus Sametime 或 Lotus Domino，也可以通过 “set config” 命令在 Domino 服务器上动态设置参数。输出将被记录到 Domino 控制台以及 /IBM_TECHNICAL_SUPPORT/ console.log 文件中。
示例故障排除场景
用户登录问题
理解用户登录过程（见图 5）可以帮助判断出现问题的位置，并以一种系统化方式解决问题：
- 在用户登录时，HTTP 请求被传递给负载均衡器（如果实现的话）和 IBM HTTP 服务器。
- 请求被传递给 EMS STCenter，它将根据 LDAP 配置形成一个 LDAP 搜索查询：LDAP 主机、LDAP 端口（如果使用 SSL）、LDAP 过滤器和 LDAP 绑定查找用户凭证。
图 5. 用户登录流程表 - 一个 LDAP 身份验证查询被发送给 LDAP 服务器，后者根据请求返回相应的结果。
- STCenter 将与 WebSphere Application Server 安全模块交互以实现身份验证。
- 对用户执行身份验证后，将生成一个 LTPA 令牌 cookie，并且被保存到客户端浏览器中。
如果用户能够登录到 EMS 主页，但是无法加入到会议中，那么也可以使用以下故障排除步骤：
身份验证失败
如果用户收到身份验证错误，那么问题的原因可能有两个：(1) 凭证错误；或者 (2) EMS 中的 LDAP 配置错误。
- 要判断具体属于哪一种情况，使用与 LDAP 浏览器（比如 Softerra LDAP 浏览器）中的 Sametime Server LDAP 身份验证配置相同的搜索字符串，或者可以使用 Lotus Notes/Domino LDAPSearch.exe 执行相同的搜索。
如果 LDAP 搜索能够返回结果，那么 EMS 中的 LDAP 配置就是正确的，问题应当出在错误的登录凭证上面。这种方法可以帮助判断并解决最常见的与 LDAP 相关的问题，而不需要在 LDAP 服务器中启用详细的调试。例如：
Login name: wasadmin LDAP authentication configuration: (&(objectclass=organ izationalPerson)( | (u id=%s*)(cn=% s)(given name=%s)(sn=%s)(mail=%s))) LDAP server host name: tds.cam.itso.ibm.com LDAP server host is enabled anonymous access - 使用如下 Notes/Domino ldapsearch.exe 命令执行验证：
C:\Lotus\Domino>ldapsearch -h tds.cam.itso.ibm.com "(&(objectclass=organizationalPerson)(|(uid=wasadmin*) (cn=wasadmin)(givenname=wasadmi n)(sn=wasadm in)(mail=wasadmin)))"
返回结果：
uid=wasadmin,cn=users,dc=itso,dc=com bjectclass=inetOrgPerson bjectclass=organizationalPerson bjectclass=person bjectclass=top bjectclass=ePerson givenname= sn=wasadmin cn=wasadmin uid=wasadmin
- 接下来，判断用户是否能够在不进行进一步身份验证的情况下访问具有相同域后缀的服务器资源；例如，要访问 Sametime MR 服务器的 Domino 目录（Names.nsf），使用：
http:///names.nsf
如果用户能够访问的话，那么身份验证配置就是正确的。
- 如果用户无法访问资源，那么检查以下几个方面：
- 用户的浏览器允许他们存储 cookies 并且将相应地生成一个 LTPA 令牌。
- Sametime Domino 服务器的 SSO 文档包含相应的导出的 WebSphere Application Server LTPA 键。
- 完全限定的域后缀配置在 WebSphere Application Server 和 Domino 服务器中是正确的。 启用一个详细的 SSO 跟踪（参见 5.5 小节）将帮助揭示 Domino 服务器中正在发生的操作。
- Domino 服务器的 SSO 文档中的 LDAP 服务器配置是正确的。
SSO with LTPA
当用户第一次执行身份验证时，将在用户的浏览器中生成一个 LTPA 令牌。当在默认的 EMS 会议页面 “/iwc/center”（或任何具有 WebSphere Application Server 应用程序的页面）中完成身份验证时，将同时生成 LTPA 和 LTPA2 令牌。
在 Lotus Domino 中，当用户第一次在 Sametime Server 中执行身份验证时，将只生成 LTPA 令牌；不会生成 LTPA2 令牌。如果 EMS 和 Sametime 服务器环境中都未使用 LTPA2 特性，那么这不会引起任何问题。
EMS / WebSphere Application Server 上的默认 LTPA 令牌超时期限为 120 分钟，而在 Domino 上的 Sametime Server 中则为 30 分钟，因此务必在设计期间将这些设置同步为相同的值。
要为 WebSphere Application Server 生成 LTPA 键，请在管理控制台页面完成如下步骤：
注意：如果 WebSphere Application Server 执行的是基础部署，那么在访问管理控制台页面之前需要首先启动 Server1：
http ://: 9060/ibm/console
- 选择 Security > Secure administration, applications, and infrastructure。
- 在 Authentication 下，单击 Authentication mechanisms and expiration。
- 在 Configuration 选项卡中，在 Authentication expiration 区段，为字段 "Timeout value for forwarded credentials between servers" 输入理想的值；默认值为 120 分钟。
- 在 Cross-cell single sign-on 区段填充必要的字段。
- 保存更改以生成 LTPA 键文件。
有关将 LTPA 键文件导入到 Domino 服务器的详细步骤，请参考 IBM Redbooks® 刊物 “Sametime 7.5.1 - Best Practices for Enterprise Scale Deployment” 第 722 页 "Install Domino on the first room server" 小节。
由于 Sametime 服务器大量使用了 LTPA 令牌，因此必须为客户端浏览器启用 cookies。在浏览器 URL 框中执行以下命令，检查 LTPA 令牌并显示结果（见图 6）：
javascript.:alert(document.cookie) |
图 6. LTPA 和 LTPA2 令牌
上图以加密的形式展示了 LTPA 和 LTPA2 令牌，这不利于了解细节。
管理员要想在不借助复杂开发工具的情况下解密信息，一种简单方法就是启用 Domino SSO 调试（参见 5.5 小节）并使用相同的 Web 浏览器页面访问 Domino Web 页面，例如：
http :///name.nsf |
解密后的 LTPA 令牌信息将显示在 Domino 控制台日志中：
[0328:0024-0BFC] 08/10/2009 01:29:48.25 PM SSO API>
*** Validating Token List (SECTokenListValidateAndGetInfo) ***
[0328:0024-0BFC] 08/10/2009 01:29:48.25 PM SSO API>
ConfigName specified [LtpaToken].
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
Retrieved global static cache memory for config [LtpaToken].
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
*** Retrieving Extra Token Info (SECTokenValidateAndGetTokenInfo2) ***
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
ConfigName specified [LtpaToken].
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
Retrieved global static cache memory for config [LtpaToken].
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
Decoding Websphere style. LTPA Single Sign-On token (LtpaToken).
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
-Raw Token Username =
uid=fmeng,cn=users,dc=itso, dc=com
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
-LDAP Realm = tds.cam.itso.ibm.com\:389
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
-Username = uid=fmeng/cn=users/dc=itso/dc=com
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
-Raw Token Username =
uid=fmeng,cn=users,dc=itso, dc=com
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
-Expiration Ticks = 1249889271666 [08/10/2009 03:27:51 PM].
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
*** Freeing Single Sign-On Token List (SECTokenListFree) ***
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
*** Freeing Single Sign-On Token (SECToken Free) ***
[0328:0024-0BFC] 08/10/2009 01:29:48.27 PM SSO API>
*** Freeing Single Sign-On Token (SECToken Free) ***
|
用户无法创建会议
如果用户无法创建会议，第一步是判断是否能够从会议中心创建会议，因为可以从其他应用程序中通过在线会议工具箱来对会议进行安排。会议中心的 URL 为：
http :///iwc/center |
要确认会议已被成功创建，打开 DB2 Control Center 并查看 sametime.schedule 表，看看会议是否被存储在 DB2 数据库中。
技巧：通过使用管理员帐户，DB2 SQL 查询也可以通过以下 URL 提交：
http :///iwc-ad m in/sql .jsp? |
图 7 展示了 DB2 数据库中的已安排会议的记录。
图 7. DB2 中的已安排会议记录的示例
在会议计划期间，如果按照最大容量对所有 Sametime Room Servers 进行安排，那么用户将收到一条消息，表示无法安排会议并将尝试在另外一个时间安排会议。
要进一步研究此问题，您可以启用 EMS STCenter 和 STServer 跟踪（参见 6.2 小节）。对跟踪日志执行分析，确定在安排会议时将数据存储到 DB2 中是否出现问题，然后从 STCenter 和 STServer 的 SystemOut.log 和 SystemErr.log 文件中查找任何 Java 异常。
会议无法激活
如果某个会议无法激活，那么可能是由 EMS 或 Sametime MR 服务器引起的。要解决这个问题，检查一下几个方面：
- 通过 EMS Administration Server 概览页面，确认至少有一个 MR 保持在运行状态。
- 通过 EMS Administration Monitoring > Meetings and Participants page > Logging - Capacity Warnings 页面，确保所有 MR 已配置功能得到充分利用。
- 通过 EMS Administration Logging > Meeting Events 页面，可以找到至少一个会议服务器。
- Sametime MR 中的 STconfig.nsf 没有丢失或被损坏。
- 在任意 Sametime MR 服务器中创建了一个临时会议文档。
当会议被激活后，EMS STServer 应用程序将在 Sametime MR 服务器上通过 Sametime 会议管理 API (MMAPI) 传输会议信息。它将在 Sametime (stconf.nsf) 会议数据库中创建一个临时文档，然后在会议结束后删除该文档。
如果 Sametime MR 服务器的 stconf.nsf 中没有创建任何文档，那么执行以下步骤：
- 检查 Domino 服务器控制台，确认 MMAPI servlet 已正确启动，例如：
08/05/2009 02:38:59 PM Servlet engine initialization was successful
...
08/05/2009 02:39:15 PM com.lotus.sametime.m eetingmanagement.remote.servlet.MMAPIServlet: init
- 检查位于 trace/servlets_yy_mm_dd__.java.diag 中的 Sametime MR servlet 日志，查看 MMAPI 中出现的任何错误。
- 启用与 Sametime Java 有关的调试（参见 5.1.2 小节），进一步研究问题。
- 查看 EMS STServer 的 SystemOut.log 和 SystemErr.log 中的任何错误。
- 启用 EMS STServer 跟踪（参见 5.3 小节），进一步研究问题。
在 Sametime MR 服务器中创建了会议文档后，STMS 行为提供者服务（在 Windows 中为 STMSActivityProvider.exe）将开始初始化会议。任务将每 5 秒钟对 stconf.nsf 中的文档执行一次检查，这使得进程 CPU 利用率每 5 秒钟达到一次峰值。
如果 CPU 利用率始终为 0 或一直保持较高的值，那么说明此任务出现异常。
Sametime MR Server 处于不健康状态
EMS STServer 健康监视和服务请求事件应用程序
EMS STServer 健康监视应用程序将根据已配置的时间间隔，定期向 Sametime MR 服务器发送健康监视消息（默认时间间隔为 30 秒，在 healthmonitor.config 中通过 healthCheckInterval 指定）。
Sametime MR 服务器状态将根据已配置的超时确定（默认为 90 秒，在 healthmonitor.config 中通过 healthTimeout 指定）：
- 如果在超时期限内接收到消息，那么 MR 服务器被标记为健康。
- 如果在超出已配置的超时期限后接收到消息，或者根本没有接收到任何消息，那么服务器将被标记为不健康。该服务器上的任何运行中的会议将在另一台运行中的 MR 服务器上自动重启，并且不会在这台服务器上安排任何会议，除非它是环境中惟一的一台服务器。
EMS STServer 服务请求事件应用程序将根据已配置的超时（默认为 90 秒，在 health.config 中通过 healthTimeout 指定），定期（默认为 30 秒，在 health.config 中通过 healthCheckInterval 指定）检查 Sametime MR 服务器服务（网络侦听器）的状态，从而确定 Sametime MR 服务器服务的状态。
如果状态在超出已配置的超时期限后不可用，那么 EMS STServer 健康监视应用程序将停止检查这台 Sametime MR 服务器的健康状态，并且这台 MR 服务器的状态在 EMS 中将被标记为停机。
下面展示了每台 EMS Application 服务器（STCenter、STServer、STAdmin）上的 ST*.ear\lib\configuration.jar 文件中相关的配置时间；例如，在 Windows 中：
C :\WebSphere\AppServer\profiles\AppSrvo 1 \installedApps\emsNodeo
1 Cell\STCenter.ear\lib
File: healthmonitor.config healthTimeout=90000
healthCheckI nterval=30000
File: health.config
healthTimeout=90000
healthCheckI nterval=30000
|
故障排除
当 EMS 管理页面中的 MR 服务器处于不健康或停机状态，那么可能表示健康检查结果失败，或者 Sametime MR 服务器服务失败。
延长健康检查超时时间。在某些生产环境中，由于加载和网络延迟，针对健康监视和服务检查设置的默认的 90 秒超时可能过于短暂，无法反映实际的环境。
另一种可能性是 Sametime MR 服务器在运行和非运行状态之间交替。比如，您可以通过将 healthTimeout 延长到 360000（6 分钟）来调整超时。为此，执行以下操作：
- 停止所有 Sametime 服务器和 EMS 应用程序。
- 备份并展开 STServer 的 configuration.jar 文件，提取 config \HealthMonitor.config 文件，保留原始的目录结构。
- 编辑 HealthMonitor.config，以毫秒为单位调整 healthTimeout 的值；例如，将其延长到 6 分钟，设置为 healthTimeout=360000。
- 在 configuration.jar 中替换 HealthMonitor.config 文件，再次保留目录结构。如果您使用 WinZip 或 WinRAR 替换 configuration.jar 中的 HealthMonitor.config，那么确保禁用压缩比率或方法（见图 8）。
图 8. WinRAR 的示例存储（无压缩）方法 - 尽管配置只对 EMS STServer 应用程序有效，但是考虑到一致性，在 STServer 应用程序目录中复制 configuration.jar，并替换 STCenter 和 STAdmin 应用程序中的相同文件。
- 根据 4.3 小节描述的过程启动 Sametime 和 EMS 服务器。
检查 Sametime MR 服务器。 应当对 Sametime MR 服务器进行检查，以确定它的实际状态。如果它出于某种原因被标记为“非运行状态”，那么该服务器应当执行重启以恢复服务。
尽管可以重新启动所选的 Sametime 服务器服务，但是并不建议对 EMS 环境中的 Sametime 服务器这样做；也就是说，重新启动整个 Sametime 服务器。
要进一步研究，检查 MR 服务器跟踪日志。在开始检查其他相关跟踪文件之前，首先看一下 summary.diag。应当对 EMS STServer 的 SystemOut.log 和 SystemErr.out 文件进行检查，查看任何错误或异常。如果需要的话，启用一个相应的模块跟踪日志。
Sametime MR Server 无法添加到 EMS
当 Sametime MR 服务器被添加到 EMS 时，EMS STAdmin 应用程序将使用用户提供的凭证访问 MR 服务器上的 MR 服务器配置 servlet。要访问配置信息，必须在 stconfig.nsf ACL 中以正确的 LDAP 标准格式输入凭证。
当凭证被匹配后，配置 servlet 将以 XML 格式返回 MR 服务器的配置信息，这些信息将被保存到 DB2 数据库中的 STCONFIG 模式下。
以下为故障排除步骤：
- 确保以正确的格式输入 stconfig.nsf ACL 中的用户凭证（例如，wasadmin/users/ibm/com），用户类型为 “person” 和管理员访问，并且所有用户均被选择。
- 确保在 stconfig.nsf 中，Meeting Services 文档的 Remote Service Access 部分的用户名和密码是正确的。
- 确保 Sametime MR 服务器中的 LDAP 得到了正确配置。
- 版本是否正确？例如，Sametime 8.0 Servers 不能被添加到 Sametime 7.5.1 EMS 中。
- 查看 STAdmin 的 SystemOut.log 和 SystemErr.log 文件中的任何错误或异常。如果需要的话，启用更多的跟踪以进一步研究。
Sametime DB2 数据库 Lock List 和 Lock Time-out
由于默认的 Sametime DB2 数据库锁超时是不受限制的 (LOCKTIMEOUT=-1)，因此在高工作负载的 Sametime EMS 环境中，Sametime EMS 的行为就好象是被暂停了一样。
因此，一定要调整以下两个与 DB2 锁有关的参数，避免出现长时间的锁等待：
Max storage for lock list (4KB): (LOCKLIST) = 10000 to 50000 Lock timeout (sec): (LOCKTIMEOUT) = 60 |
因此，对于 LOCKLIST=10000（建议值），将需要 40MB 的内存。您应当计算并调整实际的值，收集相应的 DB2 统计数据。
举例来说，在 Windows 环境中，让我们将 LOCKLIST 更新到 10000，而将 LOCKTIMEOUT 更新到 60。为此：
- 选择 Menu > Start > Programs，IBM DB2\DB2COPYI (default) > Command Line Tools > Command Line Processor，然后输入如下内容：
db2 => connect to sametime
- 将显示如下 Database Connection 信息：
Database server = DB2/NT 9.1.3 SQL authorization ID = ADMINIST... Local database alias = SAM ETIME
- 现在输入如下命令：
db2 => update db cfg for sametime using locklist 10000 maxlocks 60 locktimeout 60 DB20000 I
成功完成以上命令后，将得到如下所示的 DB2 服务器响应：
The UPDATE DATABASE CONFIGURATION command completed successfully. SQL1363W One or more of the parameters submitted for immediate modification were not changed dynamically. For these configuration parameters, all applications must disconnect from this database before the changes become effective.
- 输入以下命令来检验 DB2 中的配置：db2 =>get db cfg
- 检查以下配置项的配置输出：
...Max storage for lock list (4KB) (LOCKLIST) = 10000 Lock timeout (sec) (LOCKTIMEOUT) = 60
其他场景
请参考 IBM Redbooks 刊物, Sametime 7.5.1 - Best Practices for Enterprise Scale Deployment 第 731 页第 10.9 节 "Troubleshooting EMS"，了解其他场景。
由于 EMS 和 Sametime Meeting Room (MR) 服务器之间彼此连接，因此有时很难确定问题是出在 EMS 上，还是出在 Sametime MR Server 上。在这种情况下，可以暂时从 EMS 集群中移除 Sametime MR 服务器，然后重复相同的测试场景，以进一步分离和排除故障。
结束语
这份白皮书提供了针对 Lotus Sametime Server 和 Lotus Sametime Enterprise Meeting Server (EMS) 的最佳实践和故障排除指导。它详细阐述了应用跟踪的步骤，并详尽解释了问题诊断、管理和支持的可用调试选项。
来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/14751907/viewspace-623284/，如需转载，请注明出处，否则将追究法律责任。
转载于:http://blog.itpub.net/14751907/viewspace-623284/