|
| |
| Sun Java System Calendar Server 管理指南 | |
第 10 章
管理 Calendar Server本章介绍了如何管理 Calendar Server，其中包含以下小节：
可以通过运行命令行实用程序和编辑 ics.conf 配置文件来管理 Calendar Server。
要运行命令行实用程序，必须以管理员用户身份登录正在运行 Calendar Server 的系统。
有关详细信息，请参阅附录 D“Calendar Server 命令行实用程序参考”和附录 E“Calendar Server 配置参数”。
启动和停止 Calendar Server可以使用 start-cal 和 stop-cal 命令启动和停止 Calendar Server。请参阅使用 start-cal 和 stop-cal 实用程序。
注意 Calendar Server 提供了 csstart 和 csstop 实用程序只是为了与其早期版本兼容。如果可能，还是请使用 start-cal 和 stop-cal 实用程序来启动和停止 Calendar Server。
本节包含以下主题：
使用 start-cal 和 stop-cal 实用程序
start-cal 和 stop-cal 实用程序都位于 cal_svr_base/opt/SUNWics5/cal/sbin 目录中。必须在已安装 Calendar Server 的本地计算机上运行这些实用程序。有关可能出现的问题，请参阅 start-cal 和 stop-cal 实用程序错误诊断。
start-cal 实用程序按以下顺序启动 Calendar Server 服务：
有关这些服务的介绍，请参阅“Calendar Server 服务”。
使用 start-cal 命令启动 Calendar Server：
使用 stop-cal 命令停止 Calendar Server：
start-cal 和 stop-cal 实用程序错误诊断
在启动和停止 Calendar Server 时，可能会出现以下问题：
- start-cal 实用程序无法启动所有 Calendar Server 进程。例如，start-cal 可以启动 enpd、csnotifyd 和 csadmind 进程，但无法启动 cshttpd。在这种情况下，必须先停止所有 Calendar Server 进程，然后再尝试重新启动 Calendar Server。
- stop-cal 实用程序无法停止所有 Calendar Server 进程。例如，stop-cal 可以停止 cshttpd 父进程，但无法停止任何 cshttpd 子进程。在这种情况下，必须停止其余的 Calendar Server 进程。
- 在正在运行 Calendar Server 的 Linux 系统中，如果使用 ps 命令搜索日历进程，搜索结果的显示可能会十分混乱。在 Linux 系统中，ps 命令返回正在运行的线程列表，而非进程列表。目前尚未发现仅显示进程的解决方法。
停止 Solaris 操作系统上的 Calendar Server 进程：
- 以系统管理员用户身份登录正在运行 Calendar Server 的系统。
- 通过对每项服务输入 ps 命令来确定其余 Calendar Server 进程的进程 ID (PID)：
ps -elf | grep cs-process
其中，cs-process 可以是 enpd、csnotifyd、csdwpd、csadmind 或 cshttpd。例如：
ps -elf | grep cshttpd
- 使用正在运行的每个进程的 PID，并输入 pkill -15 命令来终止这些进程。例如：
pkill -15 9875
- 再次对每项服务输入 ps 命令，确保所有 Calendar Server 进程均已停止。
如果仍有 Calendar Server 进程正在运行，请输入 pkill -9 命令将其终止。例如：
pkill -9 9875
警告 在停止所有 Calendar Server 进程之后，重新启动 Calendar Server 之前，请考虑通过运行 csdb 实用程序的 check 命令来检查是否可能有日历数据库损坏情况发生。
有关 check 命令的信息，请参阅检测和重建日历数据库。
管理组计划引擎队列组计划引擎 (GSE) 保持一个将用于更新组件数据库的事件队列。管理员可以更改超时值以调整 Calendar Server 扫描队列的时间间隔。还可以列出队列中的事件，如果需要也可以将特定事件删除。
本节包含以下主题：
关于 GSE
GSE 允许 Calendar Server 用户创建事件和邀请其他参与者。如果参与者也在同一个 Calendar Server 上，则会在其日历上安排此事件。如果参与者不在同一个 Calendar Server 上，则会通过电子邮件向其发送邀请。参与者可以接受或拒绝邀请，GSE 将根据回复来更新事件。
关于 GSE 队列
GSE 队列实际上是由 GSE 管理的独立数据库。Calendar Server 将扫描队列来查找需要对组件数据库进行哪些更新。
可以调整扫描的频率来调整 Calendar Server。这可通过更改 ics.conf 文件中 gse.belowthresholdtimeout 的超时值来完成。请参阅第 19 章“优化 Calender Server 的性能”。
可以使用 csschedule 来管理（列出和删除）GSE 队列条目。必须在已安装 Calendar Server 的本地计算机上运行 csschedule。
列出 GSE 队列中的条目
要列出 GSE 队列中的条目，请使用 csschedule 实用程序的 list 命令。例如，要列出 GSE 队列中的所有条目：
csschedule list
要列出 GSE 队列中存储的前十个条目：
csschedule -c 10 list
要列出 GSE 队列中带有 calid Holiday_Schedule 的日历中的所有条目：
csschedule -v list Holiday_Schedule
删除 GSE 队列中的条目
要删除 GSE 队列中的条目，请使用 csschedule 实用程序的 delete 命令。例如，要删除 GSE 队列中的所有条目：
csschedule -v delete
要从 GSE 队列的 calA 日历中删除首次计划时间为 2001 年 11 月 30 日 13:30:45，偏移数为 1，唯一标识符为 1111，周期 ID 为 0，序列号为 0 的条目：
csschedule -v -t 20011130T133045Z -o 1 -u 1111 -r 0 -n 0 delete calA
监视 Calendar Server要监视 Calendar Server 活动，请使用 csmonitor、csstats 和 cstool 实用程序。本节介绍以下任务：
列出计数器统计信息
csstats 实用程序显示日历配置 (counter.conf) 文件中定义的计数器对象的统计信息。计数器对象（例如 httpstat、authstat、wcapstat 或 dbstat）显示 Calendar Server 的以下信息：
有关 Calendar Server 计数器统计信息的详细信息，请参阅计数器配置文件 (counter.conf)。
列出统计信息：
要列出统计信息，请使用 csstats 实用程序的 list 命令。例如，要显示计数器对象的基本信息和可用类型：
csstats list
只列出 httpstat 计数器对象的统计信息：
csstats list http
只列出 wcapstat 计数器对象的统计信息：
在此示例中，将频率设为：以一小时为持续时间，每隔 10 秒列出一次。
csstats -i 360 -s 10 list wcap
监视 Calendar Server 日志文件
每个 Calendar Server 服务都将状态信息写入它的日志文件。每个日志文件都根据其相关的服务名命名，如表 10-1 所示：
表 10-1 Calendar Server 日志文件
服务名
日志文件名
管理服务 (csadmind)
admin.log
分布式数据库服务 (csdwpd)
dwp.log
HTTP 服务 (cshttpd)
http.log
通知服务 (csnotifyd)
notify.log
单点登录
am_sso.log
启动命令的日志
start.log
停止命令的日志
stop.log
Calendar Server 日志文件存储在 Solaris 操作系统上的以下默认目录中：
/var/opt/SUNWics5/logs
根据配置的时间和大小限制，每个日志文件将回滚为具有新名称的新文件，如下所示：
ServiceName.TimeStamp.#
例如：
admin.log.8.1083013284
http.log.8.1083013284日志事件严重级别
Calendar Server 为日志文件中报告的事件提供了 8 种严重级别，如表 10-2 所示。
表 10-2 Calendar Server 日志错误严重级别
严重级别
含义
CRITICAL
表示处于危险状态。
ERROR
表示处于错误状态。
WARNING
表示处于警告状态。
NOTICE
表示处于运行正常、但需要特别注意的状态。这是每个日历服务的默认报告级别。
INFORMATION
表示提示性信息。
DEBUG
表示调试级别的信息。
一个日志事件通过一行内容表示，其中显示相关的时间标记、服务器主机名、严重级别、进程名（进程 ID）、事件类型、优先级和说明。可以通过修改 ics.conf 文件中的某些配置设置，指定 Calendar Server 在日志文件中报告的事件的严重级别。有关信息，请参阅日历日志信息配置。
应该定期查看日志文件，了解系统是否发生了 EMERGENCY、ALERT、CRITICAL、ERROR 和 WARNING 级别的错误，如果发现这些错误，请查看这些事件以找出 Calendar Server 操作可能出现的问题。在 Calendar Server 的正常操作过程中，系统会生成 NOTICE 和 INFORMATION 级别的日志事件，以帮助您监视服务器活动。
强制回应 Calendar Server要验证 Calendar Server 服务是否正在侦听指定的端口号，请使用 cstool 实用程序的 ping 命令。强制回应服务无法验证该服务是否正在运行，但可以表明该服务是否可以接受套接连接。
Calendar Server 服务选项如下：
要运行 cstool，必须正在运行 Calendar Server。
例如，要强制回应主机名为 calserver 的计算机以查看 cshttpd 服务是否正在侦听端口 80：
cstool -p 80 -h calserver ping http
默认情况下，cstool 等待响应的时间为 120 秒，但您可以使用 -t timeout 选项更改此值。
有关完整的实用程序参考资料，请参阅 Calendar Server 命令行实用程序参考。
刷新 Calendar Server 配置在当前发行版中，请不要使用 cstool refresh 命令刷新配置。应使用 stop-cal 和 start-cal 命令。有关详细信息，请参阅启动和停止 Calendar Server。
关闭原有的 Calendar Express UI如果已安装了新的 Communications Express UI，没有必要关闭原有的 Calendar Express UI。但是，如果要关闭原先的 Calendar Express UI，可以通过重命名以下文件来完成此操作：default.html。
可以在以下目录中找到 default.html 文件：
/opt/SUNWics5/cal/html