4.6 配置日历服务（守护进程）

本节包含有关如何配置日历服务（守护进程）的说明。

本节包含以下主题：

• 配置启动和停止服务

• 配置 Calendar Server 版本 6.3 的 Watcher 进程

• 配置管理服务 (csadmind)

• 配置 Calendar Server 版本 6.3 的 HTTP 服务 (cshttpd)

• 配置 Calendar Server 版本 6.3 的警报通知

另请参见第 9 章，配置自动备份。

配置启动和停止服务

start-cal 和 stop-cal 命令为包装脚本，可轻松地启动和停止 Calendar Server。实用程序的定义在附录 D，Calendar Server 命令行实用程序参考中。

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

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

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

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

5. 编辑下表中所示的一个或多个参数：

   参数	说明和默认值
   local.serveruid	运行时用户标识符 (uid)。默认值为 "icsuser"。它是在不需要超级用户权限时使用的用户标识符。
   local.servergid	运行时组标识符 (gid)。默认值为 "icsgroup"。它是在不需要超级用户权限时使用的组标识符。
   local.autorestart	将此参数设置为 "yes" 时，如果连接到 watcher 的服务未正确断开连接就终止，将自动重新启动此服务。
   local.autorestart.timeout	定义自动重启的超时时间间隔。为避免在自动启动时无限次尝试重启，如果一个服务在特定时间间隔内终止两次，则不再重新启动它。默认设置为 10 分钟。

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

7. 重新启动 Calendar Server。

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

配置 Calendar Server 版本 6.3 的 Watcher 进程

监视程序进程 watcher 用于监视失败的套接字连接。它将与 Calendar Server 和 Messaging Server 一起使用。要设置 Calendar Server 参数以配置 Watcher，执行以下步骤：

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

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

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

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

5. 编辑下表中所示的一个或多个参数：

   参数	说明和默认值
   local.watcher.enable	如果此参数设置为 "yes"，启动程序将先尝试启动 Watcher 再启动任意其他服务。而守护进程将通过套接字连接与其连接。默认值为 "no"，但配置程序会将其更改为 "yes"。
   local.watcher.port	它是 Watcher 在其上进行侦听的端口。Messaging Server 使用端口 49994。Calendar Server 应使用另一端口，例如 49995。
   local.watcher.config.file	Watcher 的配置文件。如果为相对路径，它将相对于 config 目录。默认值为 watcher.cnf。
   service.autorestart	如果设置为 "yes"，Watcher 将自动重新启动在没有正确断开连接的情况下终止的所有已注册服务。如果服务在 10 分钟内终止两次，Watcher 将不会再重新启动它。

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

7. 重新启动 Calendar Server。

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

另请参见

有关 Watcher 进程的更多信息，参见《Sun Java System Messaging Server 6.3 Administration Guide》。第 4 章和第 23 章中都包含相关信息。

如果启用了 Watcher，必须向 Watcher 进程注册其所监视的每个服务。此过程由 Calendar Server 守护进程在内部自动完成。此外，守护进程会在 cal-svr-base/data/proc 目录中创建 pid 文件，此文件包含每个服务的进程 ID 及其状态（"init" 或 "ready"）。

配置管理服务 (csadmind)

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

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

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

4. 编辑下表中所示的一个或多个参数：

   参数	说明和默认值
   local.store.checkpoint.enable	如果设置为 "yes"，则启动 csadmind 数据库检查点线程。如果设置为 "no"，则不创建任何检查点日志文件。默认值为 "yes"。
   service.admin.dbcachesize	Berkeley 数据库用于管理会话的最大缓存大小（以字节为单位）。默认值为 "8388608"。
   local.store.deadlock.enable	如果设置为 "yes"，则启动 csadmind 数据库死锁检测线程。默认值为 "yes"。
   service.admin.diskusage	如果设置为 "yes"，则启动 csadmind 磁盘空间不足监视线程。默认值为 "no"。默认情况下，不监视磁盘使用情况。
   service.admin.enable	如果设置为 "yes"，则在启动所有服务时启动 csadmind，并在停止所有服务时停止 csadmind。默认值为 "yes"。
   service.admin.maxthreads	每个管理会话正在运行的线程的最大数目。默认值为 "10"。
   service.admin.resourcetimeout	管理连接超时前的秒数。默认值为 "900"。
   service.admin.serverresponse	如果设置为 "yes"，则启动 csadmind 服务响应线程。默认值为 "no"。
   service.admin.sessiondir.path	管理会话请求的临时目录。无默认值。
   service.admin.sessiontimeout	csadmind 中的 HTTP 会话超时前的秒数。默认值为 "1800"。
   service.admin.sleeptime	两次检查已启动、已停止或已就绪的日历服务中间等待的秒数。默认值为 "2"。
   service.admin.starttime	启动日历服务前等待的秒数。默认值为 "300"。
   service.admin.stoptime	停止日历服务前等待的秒数。默认值为 "300"。
   service.admin.stoptime.next	两次向任意日历服务发送停止命令中间等待的秒数。默认值为 "60"。

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

6. 重新启动 Calendar Server。

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

配置 Calendar Server 版本 6.3 的 HTTP 服务 (cshttpd)

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

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

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

4. 编辑下表中所示的一个或多个参数：

   参数	说明和默认值
   service.http.admins	对此 Calendar Server 具有管理权限的用户 ID 列表，ID 之间用空格分隔。默认值为 "calmaster"。
   service.http.allowadminproxy	如果设置为 "yes"，则允许通过代理登录，它是默认值。
   service.http.allowanonymouslogin	如果设置为 "yes"，则允许匿名（无验证）访问。这是一种仅允许进行指定的、受限的访问（通常是对公共日历进行只读访问）的特殊登录类型。默认值为 "yes"。
   service.http.calendarhostname	用于检索 HTML 文档的 HTTP 主机。要允许用户使用全限定主机名访问日历数据，此值必须为正在运行 Calendar Server 的计算机的全限定主机名（包括计算机名、DNS 域和后缀），例如 mycal@sesta.com。 如果不指定，则使用本地 HTTP 主机。
   service.http.commandlog	该参数只用于调试。如果设置为 "yes"，则系统将把所有接收到的命令记录到 http.commands 日志文件中。 在生产运行时过程中不要使用该参数。它将很快填满日志文件，并导致性能下降。
   service.http.commandlog.all	该参数只用于调试。如果设置为 "yes"，系统将把所有 HTTP 请求记录到 http.access 日志文件中。 在生产运行时过程中不要使用该参数。它将很快填满日志文件，并导致性能下降。
   service.http.cookies	通知服务器是否支持 Cookie (yes/no)。要启用单点登录，必须将其设置为 "yes"。默认值为 "yes"。
   service.http.dbcachesize	Berkeley 数据库用于 HTTP 会话的最大缓存大小。默认值为 "8388308"。
   service.http.domainallowed	如果指定，且不为空白 (" ")，则过滤以允许基于 TCP 域的访问。例如，"ALL: LOCAL.sesta.com" 将允许 sesta.com 域中的任何人进行本地 HTTP 访问。过滤器之间用 CR-LF（换行）分隔。默认为空白 ("")。
   service.http.domainnotallowed	如果指定，且不为空白 (" ")，则过滤以允许基于 TCP 域的访问。例如，"ALL: LOCAL.sesta.com" 将不允许 sesta.com 域中的任何人进行 HTTP 访问。 过滤器之间必须用 CR-LF（换行）分隔。默认为空白 (" ")。
   service.http.attachdir.path	相对于 local.queuedir 的目录位置（或如果已指定，则为绝对路径），在其中临时存储导入的文件。默认值为当前目录 (".")。
   service.http.ipsecurity	如果设置为 "yes"，则引用现存会话的所有请求都被认为来自同一个 IP 地址。默认值为 "yes"。
   service.http.enable	如果设置为 "yes"，则在启动所有服务时启动 cshttpd 服务，并在停止所有服务时停止 cshttpd。默认值为 "yes"。 注意 – 用此参数禁用 HTTP 服务也将禁用 HTTPS。
   service.http.idletimeout	HTTP 连接超时前的秒数。默认值为 "120"。
   service.http.listenaddr	指定 HTTP 服务用于侦听客户机请求的 TCP 地址。默认值为 "INADDR_ANY"，表示任一地址。
   service.http.logaccess	如果设置为 "yes"，则完全记录服务器的 HTTP 连接。默认值为 "no"。
   service.http.maxsessions	cshttpd 服务中 HTTP 会话的最大数目。默认值为 "5000"。
   service.http.maxthreads	cshttpd 服务中对服务 HTTP 请求的最大线程数。默认值为 "20"。
   service.http.numprocesses	在一台服务器上允许并行运行 HTTP 服务 (cshttpd) 进程的最大数目。默认值为 "1"。 有关具有多个 CPU 的服务器的信息，请参见 21.8 在多个 CPU 中使用负载平衡。
   service.http.port	来自 Calendar Server 用户的 HTTP 请求的端口。默认值为 "80"。
   service.http.proxydomainallowed	如果指定，且不为 ""，则过滤以允许基于 TCP 域的代理登录。它与 service.http.domainallowed 具有相同的语法。默认值为 " "。
   service.http.resourcetimeout	HTTP 会话超时前的秒数。默认值为 "900"。
   service.http.sessiondir.path	HTTP 会话数据库的目录。默认值为 "http"。
   service.http.sessiontimeout	cshttpd 服务中的 HTTP 会话超时前的秒数。默认值为 "1800"。
   service.http.sourceurl	用于存储文件的所有 URL 引用的目录，与可执行文件相对。默认值为 " "（空）。
   service.http.tmpdir	HTTP 会话的临时目录。默认值为 "/var/opt/SUNWics5/tmp"。

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

6. 重新启动 Calendar Server。

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

配置 Calendar Server 版本 6.3 的警报通知

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

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

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

4. 编辑下表中所示的一个或多个 ics.conf 参数：

   参数	说明和默认值
   alarm.diskstat.msgalarmdescription	随“磁盘空间不足”消息一起发送的说明。  默认说明为："percentage calendar partition diskspace available"。
   alarm.diskstat.msgalarmstatinterval	监视磁盘空间的时间间隔（以秒为单位）。默认值为 "3600"。
   alarm.diskstat.msgalarmthreshold	发送警告消息时可用磁盘空间占总磁盘空间的百分比。默认值为 "10"。
   alarm.diskstat.msgalarmthresholddirection	alarm.diskstat.msgalarmthreshold 是高于还是低于百分比。-1 表示低于，1 表示高于。默认值为 "-1"。
   alarm.diskstat.msgalarmwarninginterval	发送“磁盘空间不足”警告消息的时间间隔（以小时为单位）。默认值为 "24"。
   alarm.msgalarmnoticehost	用来发送服务器警报的 SMTP 服务器的主机名。默认值为 "localhost"。
   alarm.msgalarmnoticeport	用来发送服务器警报的 SMTP 端口。默认值为 "25"。
   alarm.msgalarmnoticercpt	服务器警报收件人的电子邮件地址。"Postmaster@localhost"
   alarm.msgalarmnoticesender	服务器警报发件人的电子邮件地址。默认值为 "Postmaster@localhost"
   alarm.msgalarmnoticetemplate	电子邮件警报的默认格式：  "From: %s\nTo: %s\nSubject: ALARM: %s of \"%s\" is n\n%s\n"
   alarm.responsestat.msgalarmdescription	随“无服务响应”消息一起发送的说明。默认值为 "calendar service not responding"。
   alarm.responsestat.msgalarmstatinterval	监视服务的时间间隔（以秒为单位）。默认值为 "3600"。
   alarm.responsestat.msgalarmthreshold	默认值为 "100"（当没有服务响应时，仅触发警告消息的发送) 开始
   alarm.responsestat. msgalarmthresholddirection	指定 alarm.responsestat.msgalarmthreshold 是高于还是低于百分比。-1 表示低于，1 表示高于。默认值为 "-1"。
   alarm.responsestat. msgalarmwarninginterval	发送“无服务响应”警告消息的时间间隔（以小时为单位）。默认值为 "24"。
   local.rfc822header.allow8bit	允许 ("y") 或不允许 ("n") 在此服务器发送的电子邮件消息中使用 8 位头。
   service.admin.alarm	启用 ("yes") 或禁用 ("no") 管理工具的报警通知。默认值为 "yes"。

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

6. 重新启动 Calendar Server。

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