test

Sun Java System Calendar Server 6.3 管理指南

第 12 章 Calendar Server 6.3 部署的服务器管理

本章介绍 Calendar Server 部署的服务器管理。

本章包括以下各节：

可通过运行 Delegated Administrator 实用程序（以前称为用户管理实用程序）或 Calendar Server 命令行实用程序并编辑 ics.conf 配置文件来管理 Calendar Server。

要运行命令行实用程序，必须以具备管理权限的用户身份登录正在运行 Calendar Server 的系统。

有关详细信息，参见 附录 D，Calendar Server 命令行实用程序参考。

注 –

其他管理主题包含在单独的章节中。

这些章节包含以下主题：

12.1 启动和停止 Calendar Server 6.3 进程

本节介绍如何使用 start-cal 和 stop-cal 命令的概念性信息和说明。

本节包含以下主题：

12.1.1 关于 Calendar Server 6.3 命令 start-cal 和 stop-cal

可使用 start-cal 和 stop-cal 命令来启动和停止 Calendar Server。start-cal 和 stop-cal 实用程序位于 cal-svr-base/SUNWics5/cal/sbin 目录中。必须在已安装 Calendar Server 的本地计算机上运行这些实用程序。

注 –

检查脚本以确保没有使用旧的 csstart 和 csstop 实用程序。使用 start-cal 和 stop-cal 实用程序来启动和停止 Calendar Server。

start-cal 实用程序按以下顺序启动 Calendar Server 服务：

  1. watcher — 监视程序，监视系统的进程

  2. enpd— 事件通知服务 (Event Notification Service, ENS)

  3. csstored— 自动备份服务

  4. csnotifyd— 通知服务

  5. csadmind— 管理服务

  6. csdwpd— 数据库有线协议 (Database Wire Protocol, DWP) 服务，只能通过远程 Calendar Server 数据库配置启动的分布式数据库服务

  7. cshttpd— HTTP 服务

有关这些服务的说明，参见 1.10 Calendar Server 版本 6.3 中作为守护进程运行的服务

Procedure使用 start-cal 启动 Calendar Server 6.3 服务

  1. 以具备管理权限的用户身份登录。

  2. 验证是否已通过发出 stop-cal 命令停止了所有 Calendar Server 服务。

  3. 转至目录。

    cal-svr-base/SUNWics5/cal/sbin

  4. 启动 Calendar Server。

    ./start-cal

Procedure使用 stop-cal 停止 Calendar Server

  1. 以具备管理权限的用户身份登录正在运行 Calendar Server 的系统。

  2. 转至目录。

    cal-svr-base/SUNWics5/cal/sbin

  3. 停止 Calendar Server。

    ./stop-cal

12.2 在 Calendar Server 版本 6.3 中启用或禁用自动备份

自动备份由 csstored 进程来管理，在发出 start-cal 命令时，将自动启动该进程。但是，您可以根据需要来启用或禁用自动备份。默认值为禁用自动备份。即使未启用自动备份，csstored 进程也会运行。

有两种自动备份：紧急备份和归档备份。您可以分别启用或禁用它们。

有关自动备份的信息和配置 csstored 的说明，参见第 9 章，配置自动备份。

以下是启用和禁用自动备份的任务列表：

Procedure在 Calendar Server 版本 6.3 中启用紧急备份

  1. 以具有配置权限的管理员身份登录。

  2. 发布 stop-cal 命令停止 Calendar Server 服务。

  3. 转至 ics.conf 文件所在的目录。

    cd /etc/opt/SUNWics5/config

  4. 通过将以下 ics.conf 参数设置为 "yes" 来启用紧急备份：

    caldb.berkeleydb.hotbackup.enable="yes"

  5. 指定紧急备份目录的目录路径：

    caldb.berkeleydb.hotbackup.path=
   /var/opt/SUNWics5/hotbackup_directory

    默认值为当前目录。

  6. 编辑完 ics.conf 文件后，重新启动 Calendar Server.。

    cal-svr-base/SUNWics5/cal/sbin/start-cal

    无需为编辑 ics.conf 文件停止日历服务，但必须重新启动服务以使更改生效。

Procedure在 Calendar Server 版本 6.3 中启用归档备份

  1. 以具有配置权限的管理员身份登录。

  2. 发布 stop-cal 命令停止 Calendar Server 服务。

  3. 转至 ics.conf 文件所在的目录。

    cd /etc/opt/SUNWics5/config

  4. 通过将以下 ics.conf 参数设置为 "yes" 来启用归档备份：

    caldb.berkeleydb.archive.enable="yes"

  5. 指定归档目录的目录路径。

    caldb.berkeleydb.archive.path=
   /var/opt/SUNWics5/hotbackup_directory

    默认值为当前目录。

  6. 编辑完 ics.conf 文件后，重新启动 Calendar Server。

    cal-svr-base/SUNWics5/cal/sbin/start-cal

    无需为编辑 ics.conf 文件停止日历服务，但必须重新启动服务以使更改生效。

Procedure在 Calendar Server 版本 6.3 中禁用紧急备份

默认情况下，禁用备份。如果您先前已启用了它们而现在要禁用它们，请执行以下步骤：

  1. 以具有配置权限的管理员身份登录。

  2. 发布 stop-cal 命令停止 Calendar Server 服务。

  3. 转至 ics.conf 文件所在的目录。

    cd /etc/opt/SUNWics5/config

  4. 通过将以下 ics.conf 参数设置为 "no" 来禁用紧急备份：

    caldb.berkeleydb.hotbackup.enable="no"

  5. 编辑完 ics.conf 文件后，重新启动 Calendar Server。

    cal-svr-base/SUNWics5/cal/sbin/start-cal

    无需为编辑 ics.conf 文件停止日历服务，但必须重新启动服务以使更改生效。

Procedure在 Calendar Server 版本 6.3 中禁用归档备份

默认情况下，禁用备份。如果您先前已启用了它们而现在要禁用它们，请执行以下步骤：

  1. 以具有配置权限的管理员身份登录。

  2. 发布 stop-cal 命令停止 Calendar Server 服务。

  3. 转至 ics.conf 文件所在的目录。

    cd /etc/opt/SUNWics5/config

  4. 通过将以下 ics.conf 参数设置为 "no" 来禁用归档备份：

    caldb.berkeleydb.archive.enable="no"

  5. 编辑完 ics.conf 文件后，重新启动 Calendar Server。

    cal-svr-base/SUNWics5/cal/sbin/start-cal

    无需为编辑 ics.conf 文件停止日历服务，但必须重新启动服务以使更改生效。

12.3 管理 Calendar Server 版本 6.3 的组调度引擎队列

本节介绍管理组调度引擎 (Group Scheduling Engine, GSE) 的概念性信息和说明。

GSE 维持用于更新组件数据库的一系列事件。管理员可以更改超时值以调整 Calendar Server 扫描队列的时间间隔。还可以列出队列中的事件，如果需要也可以将特定事件删除。

本节包含以下主题：

12.3.1 关于 Calendar Server 版本 6.3 的 GSE

GSE 允许 Calendar Server 用户创建事件和邀请其他参与者。如果参与者也在同一个 Calendar Server 上，则会在其日历上预定此事件。如果参与者不在同一个 Calendar Server 上，则会通过电子邮件向其发送邀请。参与者可以接受或拒绝邀请，GSE 将根据回复来更新事件。

12.3.2 关于 Calendar Server 6.3 GSE 队列

GSE 队列实际上是由 csadmind 进程管理的一个单独数据库，Calendar Server 扫描队列来了解需对组件数据库执行的更新。

可以调整扫描的频率来调整 Calendar Server。这可通过更改 ics.conf 文件中的 gse.belowthresholdtimeout 的超时值来完成。请参见第 21 章，优化 Calender Server 的性能。

可以使用 csschedule 来管理（列出和删除）GSE 队列条目。必须在已安装 Calendar Server 的本地计算机上运行 csschedule。

12.3.3 列出 Calendar Server 6.3 GSE 队列中的条目

要列出 GSE 队列中的条目，使用 csschedule 实用程序的 list 命令。

例如，要列出 GSE 队列中的所有条目：

csschedule list

要列出 GSE 队列中存储的前十个条目：

csschedule -c 10 list

要列出 GSE 队列中 calid 为 Holiday_Schedule 的所有日历条目：

csschedule -v list Holiday_Schedule

12.3.4 在 Calendar Server 版本 6.3 中删除 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

12.4 监视 Calendar Server 6.3 进程

Calendar Server 和 Messaging Server 现在使用相同的停止和启动机制，它是 Sun JavaTM Enterprise System Monitoring Framework (JESMF) 的一部分。start-cal 命令首先启动 watcher 进程， 然后再启动所有其他进程。watcher 进程了解其他服务所具有的依赖关系，以及它们的启动顺序。

每个已注册的服务（进程）会打开一个与 Watcher 之间的连接。如果进程终止时并未正确断开，Watcher 将自动重新启动它。如果同一进程在定义的时间间隔内终止了两次，Watcher 将不会重新启动它。该超时时间间隔是可配置的。

Watcher 将向单个日志 cal-svr-base/data/log/watcher.log 中写入以下信息：

有关如何配置 Watcher 的信息，参见配置 Calendar Server 版本 6.3 的 Watcher 进程

12.5 在 Calendar Server 版本 6.3 中清除 CLD 高速缓存

本节介绍如何清除 CLD 高速缓存的概念性信息和说明。

本节包含以下主题：

12.5.1 为什么要清除 Calendar Server 6.3 的 CLD 高速缓存？

如果已启用 CLD 高速缓存，则可能需要经常清除此高速缓存。CLD 高速缓存会由于各种原因而失去与系统配置之间的同步（过时）。

以下是造成 CLD 高速缓存可能过时的一些原因。

如果执行了以上任一操作，则为了刷新 CLD 高速缓存，您必须清除它。

Procedure清除 CLD 高速缓存

  1. 停止 Calendar Server。

  2. 删除 /var/opt/SUNWics5/csdb/cld_cache 目录中的所有文件，但不要删除 cld_cache 目录本身。

  3. 重新启动 Calendar Server。

12.6 更改服务器名

如果在配置中添加、删除或更改了服务器名，则为了避免错误，应执行以下几个“内务处理”步骤。

以下步骤对于保持 CLD 为最新非常有用：

12.7 配置 Calendar Server 用户的匿名访问

本节介绍如何启用和禁用匿名访问（登录）的说明。

匿名访问是一种不需要验证的特殊登录方式。默认情况下，启用匿名登录时，将启用对公共日历的读写访问权限。有可能拒绝对公共日历的写访问权限。

本节包含以下主题：

注 –

Communications Express 需要允许进行读写操作的匿名登录。请参见4.1 配置 Communications Express。

Procedure启用匿名访问

  1. 以具有配置权限的管理员身份登录。

  2. 发布 stop-cal 命令停止 Calendar Server 服务。

  3. 转至 /etc/opt/SUNWics5/cal/config 目录。

  4. 通过复制和重命名旧的 ics.conf 文件来保存该文件。

  5. 编辑 ics.conf 中的以下参数来启用匿名访问：

    参数 

    说明和默认值 

    service.http.allowanonymouslogin

    如果需要，通过将该参数设置为 "yes" 可以启用匿名访问（登录）。默认值为 "yes"。

    service.calendarsearch.ldap

    出于安全性目的，启用匿名登录之后，您可能希望在进行日历搜索时，首先禁用对 LDAP 的搜索，为此可以将该参数设置为 "no"（默认值）。

    注 –

    Communications Express 需要 service.calendarsearch.ldap 参数值为 "no"。这与有关在 DWP 环境中调优系统以获得最佳性能的说明冲突。（数据库分布在多个后端中。）参见 21.2 提高日历搜索在 DWP 环境中的性能。

  6. 将此文件另存为 ics.conf。

  7. 重新启动 Calendar Server。

    cal-svr-base/SUNWics5/cal/sbin/start-cal

Procedure禁止匿名用户对公共日历的写操作

  1. 以具有配置权限的管理员身份登录。

  2. 发布 stop-cal 命令停止 Calendar Server 服务。

  3. 转至 /etc/opt/SUNWics5/cal/config 目录。

  4. 通过复制和重命名旧的 ics.conf 文件来保存该文件。

  5. 编辑下表中所示的以下 ics.conf 参数：

    参数 

    说明和默认值 

    service.wcap.anonymous.

    allowpubliccalendarwrite

    启用或禁用允许进行匿名访问的用户对公共日历的写操作。将此值设置为 "yes"（默认值）可以启用写访问权限。

  6. 将此文件另存为 ics.conf。

  7. 重新启动 Calendar Server。

    cal-svr-base/SUNWics5/cal/sbin/start-cal

12.8 启用代理管理员登录

为实现 Communications Express，必须启用代理管理员登录（代理验证）。有关为 Communications Express 配置代理验证的说明，请参见4.1 配置 Communications Express。

但是，即使不使用 Communications Express，也可以启用代理验证。本节包含启用代理验证而不使用 Communications Express 的过程：

Procedure在没有 Communications Express 的情况下启用代理授权

  1. 以有权更改此配置的管理员身份登录。

  2. 转至 /etc/opt/SUNWics5/cal/config 目录。

  3. 通过复制和重命名旧的 ics.conf 文件来保存该文件。

  4. 编辑 ics.conf 文件，确认以下参数的设置是否如下所示：

    service.http.allowadminproxy = "yes"

    如果不是，将其更改为 "yes"。

  5. 将此文件另存为 ics.conf。

  6. 重新启动 Calendar Server 以便新值生效。

Procedure验证代理验证正在工作

    使用以下 WCAP 命令验证管理员代理登录正在工作：

    http://server[:port]/login.wcap?
user=admin-user&password=admin-password
&proxyauth=calendar-user&fmt-out=text/html

    此列表定义了前一示例中的变量：

    • server—运行 Calendar Server 的服务器的名称。

    • port—Calendar Server 端口号。默认端口为 80。

    • admin-user—Calendar Server 管理员。例如，calmaster。

    • admin-password—admin-user 的密码。

    • calendar-user –Calendar Server 用户的 calid。

    如果命令运行成功，系统将显示 calendar-user 的日历。如果发生问题，系统将显示未授权。

    以下是命令可能失败的一些原因：

    • admin-user 没有 Calendar Server 管理员权限。

    • admin-password 不正确。

    • calendar-user 不是有效的 Calendar Server 用户。

12.9 刷新 Calendar Server 配置

在 Calendar Server 6.3 版本中，使用 stop-cal 和 start-cal 命令来刷新配置。有关详细信息，参见12.1 启动和停止 Calendar Server 6.3 进程。