本部分包含该本管理指南的附录。
该工作单可以帮助您收集运行 comm_dssetup.pl 时将要问到的信息。第一列显示无提示模式选项以及选项后跟的预期信息。第二列显示交互模式下的相应选项以及默认答案。
右侧列中有一条横线,您可以在横线上提供答案。它适用于无提示模式和交互模式。对于无提示模式,请使用这些答案作为选项后跟的值。对于交互模式,请在提示符下输入值。
有关如何运行 comm_dssetup.pl 的示例和说明,请参见运行目录准备脚本。
表 A–1 Directory Server 设置脚本 (comm_dssetup.pl) 工作单
本附录包含以下工作单,这些工作单将有助于您跟踪运行 Calendar Server 配置程序时所需的信息,如第 3 章,Calendar Server 配置程序 (csconfigurator.sh)所述。
选项 |
说明 |
---|---|
LDAP 服务器主机名 |
要用于用户验证的 LDAP Directory Server 的主机名。 默认值:当前主机。 您的值: |
LDAP 服务器端口 |
LDAP 服务器侦听的端口号。 默认值:389。 您的值: |
基本 DN |
LDAP 目录中用作搜索起点的条目。 默认值:o=host.com。 您的值: |
目录管理员 DN |
可以在 Directory Server 模式下进行更改的用户名。 默认值:cn=Directory Manager。 您的值: |
目录管理员密码 |
目录管理员 DN 的密码。 默认值:无 您的值: |
管理员用户 ID |
Calendar Server 管理员的用户 ID。此用户必须为上述 LDAP Directory Server 中的用户。 默认值:calmaster。 您的值: |
管理员密码 |
Calendar Server 管理员的密码。 默认值:无 您的值: |
选项 |
说明 |
---|---|
电子邮件警报 |
指定在服务器出现故障时 Calendar Server 是否向 Calendar Server 管理员发送电子邮件警报消息。 默认值:已启用。 您的值: |
管理员电子邮件地址 |
将接收电子邮件警报信息的 Calendar Server 管理员的电子邮件地址。 默认值:无。 您的值: |
SMTP 主机名 |
用于发送电子邮件警报消息的 SMTP 服务器的主机名。 默认值:当前主机。 您的值: |
选项 |
说明 |
---|---|
服务端口 |
Calendar Server 用于侦听以向用户提供 Web (HTTP) 访问的端口号。 默认值:80。 您的值: |
最大会话数 |
Calendar Server 会话的最大数目。 默认值:5000。 您的值: |
最大线程数 |
Calendar Server 线程的最大数目。 默认值:20。 您的值: |
服务器进程数 |
Calendar Server 进程的最大数目。 默认值:安装 Calendar Server 的服务器上 CPU 的数目。 您的值: |
运行时用户 ID |
Calendar Server 运行时使用的 UNIX 用户名。 默认值:icsuser。 您的值: |
运行时组 ID |
Calendar Server 运行时使用的 UNIX 组。 默认值:icsgroup。 您的值: |
启动 Calendar Server |
成功安装后启动。 默认值:已选中。 您的值: 在系统启动时启动。 默认值:已选中。 您的值: |
选项 |
说明 |
---|---|
数据库目录 |
Calendar Server 在其中创建和存储日历数据库文件的目录。 默认值:/var/opt/SUNWics5/csdb 您的值: |
日志目录 |
Calendar Server 在其中写入日志文件的目录。 默认值:/var/opt/SUNWics5/logs 您的值: |
临时文件目录 |
Calendar Server 在其中写入临时文件的目录。 默认值:/var/opt/SUNWics5/tmp 您的值: |
要为 Calendar Server 规划高可用性 (High Availability, HA) 配置,请使用下列工作单:
如果您查看的这些工作单为 HTML 格式且您希望打印它们,请考虑打印 PDF 格式的工作单,以便更好地控制分页符。
组件 |
值和注释 |
---|---|
文件系统安装点 |
例如:/global/cal 您的值: |
逻辑主机名 |
例如:cal-logical-host 您的值: |
逻辑主机名 IP 地址 |
您的值: |
群集中的节点 |
例如:cal-node-1 和 cal-node-2 您的值: |
日历资源组名 |
例如:cal-resource-group 您的值: |
Calendar Server 存储资源 |
例如:cal-resource-group-store 您的值: |
Calendar Server 资源 |
例如:cal-resource 您的值: |
下表列出了使用 Sun Java Enterprise System 安装程序安装 Calendar Server 时设置的值。
表 C–2 Calendar Server 安装工作单
组件 |
说明和注释 |
---|---|
Calendar Server 安装目录 |
默认值:opt/ 例如:/global/cal/opt/r 您的值: |
下表列出了运行 Calendar Server 配置程序 (csconfigurator.sh) 时设置的值。
表 C–3 Calendar Server 配置工作单
组件 |
说明和注释 |
---|---|
LDAP 服务器主机名 |
例如:ldaphost.sesta.com 您的值: |
LDAP 服务器端口 |
LDAP 服务器侦听的端口号。 默认值:389。 您的值: |
目录管理员 DN |
可以在 Directory Server 模式下进行更改的用户名。 默认值:cn=Directory Manager。 您的值: |
目录管理员密码 |
目录管理员 DN 的密码。 默认值:无 您的值: |
管理员用户 ID |
Calendar Server 管理员的用户 ID。此用户必须为上述 LDAP Directory Server 中的用户。 默认值:calmaster。 您的值: |
管理员密码 |
Calendar Server 管理员的密码。 默认值:无 您的值: |
电子邮件警报 |
指定在服务器出现故障时 Calendar Server 是否向 Calendar Server 管理员发送电子邮件警报消息。 默认值:已启用。 您的值: |
管理员电子邮件地址 |
将接收电子邮件警报消息的 Calendar Server 管理员的电子邮件地址。 默认值:无。 您的值: |
SMTP 主机名 |
用于发送电子邮件警报消息的 SMTP 服务器的主机名。 默认值:当前主机。 您的值: |
服务端口 |
Calendar Server 用于侦听以向用户提供 Web (HTTP) 访问的端口号。 默认值:80。 您的值: |
最大会话数 |
Calendar Server 会话的最大数目。 默认值:5000。 您的值: |
最大线程数 |
Calendar Server 线程的最大数目。 默认值:20。 您的值: |
服务器进程数 |
Calendar Server 进程的最大数目。 默认值:安装 Calendar Server 的服务器上 CPU 的数目。 您的值: |
运行时用户 ID |
默认值:icsuser 对于 HA 配置,添加到群集中所有节点上的 /etc/passwd。 您的值: |
运行时组 ID |
默认值:icsgroup 对于 HA 配置,添加到群集中所有节点上的 /etc/group。 您的值: |
启动 Calendar Server |
成功安装后启动。 默认值:已选中。 您的值:对于 HA 配置,请勿选中该选项。 在系统启动时启动。 默认值:已选中。 您的值:对于 HA 配置,请勿选中该选项。 |
数据库目录 |
默认值:var/opt/SUNWics5/csdb 例如:/global/cal/var/opt/SUNWics5/csdb 您的值: |
日志目录 |
默认值:var/opt/SUNWics5/logs 例如:/global/cal/var/opt/SUNWics5/logs 您的值 |
临时文件目录 |
默认值:var/opt/SUNWics5/tmp 例如:/global/cal/var/opt/SUNWics5/tmp 您的值: |
有关每个实用程序的简短说明,请参见命令行实用程序的简短说明。
Calendar Server 提供了在与 Access Manager 捆绑的 Delegated Administrator 中未包含的命令行实用程序。
这些 Calendar Server 实用程序可以从批处理命令、shell 和脚本程序(例如 Perl)中调用。其中的一些实用程序(csuser、csresource 和 csdomain)已经被 Delegated Administrator 实用程序取代,但是其他的实用程序还在使用,即使是在 Schema 2 环境中。对于 Schema 1,您必须继续使用 csuser、csresource 和 csdomain,而不能使用 Delegated Administrator。
必要时,这些实用程序将使用 ics.conf 配置文件中的默认值。
命令行实用程序位于以下目录中:cal_svr_base/SUNWics5/cal/sbin
所有实用程序均必须从 sbin 目录下启动,但 start-cal 和 stop-cal 除外,它们可以从任何目录下运行(如果指定了完整路径)。
来自这些管理工具的错误消息将被写入位于 csdb 目录的 admin.log 文件中。
本章提供了以下信息:
以运行 Calendar Server 的用户和组身份或以 root 身份登录时,运行命令行实用程序。这将在安装过程中指定,默认为 icsuser 和 icsgroup。
例如,如果 Calendar Server 基目录为 cal_svr_base,要运行 cscal 实用程序的 list 命令,应在登录后执行以下命令:
cd cal_svr_base/SUNWics5/cal/sbin ./cscal list
Calendar Server 命令行实用程序使用以下语法:
utility [ -option [value]] command [target]
其中:
utility 是可执行实用程序的名称,例如 cscal 或 csuser。
option 决定命令要执行的操作。选项以小写字母表示,前面带有连字符 (-),例如 -d。括号 ([]) 内的选项为可选选项。如果表明是可选选项,则可以同时使用两个或多个选项。
value 进一步限制了 option 指定的操作,例如随 -d 选项一起使用的说明。括号 ([]) 内的值为可选值。包含空格的值必须括在双引号 (" ") 中。多个值必须括在双引号 (" ") 中,值与值之间必须用空格隔开,除非另有说明(例如使用分号分隔的列表)。
command 是实用程序执行的操作,例如 list 或 create。命令之间用竖线 (|) 隔开,表示可以使用任意一条命令,但不能同时使用这两条命令。
target 是命令执行的对象,例如日历 ID 或用户 ID。
如果只指定实用程序名称,它将列出所有命令、选项和多个示例。
如果不指定必需的密码,实用程序将提示您输入密码。
-v(详细)和 -q(静默)选项可用于所有实用程序。
如果某个命令具有破坏性(即,可能会导致数据丢失),实用程序将在执行该命令之前提示用户进行确认。举例来说,cscal 和 csuser 就是具有破坏性的命令,前者可以删除日历,后者可以删除用户。但 -q(静默)选项可以禁用确认提示。
version 命令可用于所有实用程序。
如果从脚本中运行命令行实用程序,则实用程序运行成功时,返回码为 "0",运行失败时返回码为 "-1"。
下表给出了 Calendar Server 命令行实用程序的简短说明。
表 D–1 Calendar Server 命令行实用程序汇总
实用程序 |
说明 |
---|---|
管理日历用户或资源的 LDAP 属性。 |
|
备份单个日历、用户和日历数据库。 |
|
管理日历及其属性。 |
|
删除状态属性 (inetUserStatus) 已被 Delegated Administrator 标记为“已删除”的 Calendar Server 用户的用户日历和资源日历。 |
|
管理日历组件:事件和任务(待办事件)。 |
|
管理日历数据库。 |
|
管理 LDAP 目录中托管(虚拟)域的 Calendar Server 属性。 |
|
以 iCalendar (.ics) 或 XML (.xml) 格式导出日历。 |
|
以 iCalendar (.ics) 或 XML (.xml) 格式导入日历。 |
|
监视日历数据库的 LDAP 连接、日志文件和可用磁盘空间。 |
|
查看、启用或禁用已配置的 Calendar Server API (CSAPI) 插件。 |
|
允许手动清除删除日志数据库 (ics50deletelog.db) 中的条目。 |
|
允许重命名用户 ID。将导致整个数据库被重写。 |
|
管理日历资源,例如会议室和设备。 |
|
恢复单个日历、用户和日历数据库。 |
|
管理组计划引擎 (GSE) 队列中的计划条目。 |
|
在 Calendar Server 中显示计数器。 |
|
强制回应正在运行的 Calendar Server 实例。 |
|
管理日历用户。 |
|
启动所有 Calendar Server 进程。 |
|
停止所有 Calendar Server 进程。 |
csattribute 实用程序可以管理 Calendar Server 用户或资源 LDAP 条目属性。命令包括:
add,用于将 LDAP 属性和值添加到指定的目标(用户对象或资源对象)。
list,用于列出目标对象的属性。
delete,用于从目标中删除属性。
如果您的站点正在使用 LDAP CLD 插件,请勿在尝试指定新的后端主机服务器时使用 csattribute 来更改 icsDWPHost 属性。修改 icsDWPHost 并不会在新后端主机上创建新日历。有关更多信息,请参见第 6 章,在多个计算机上配置日历数据库分发
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户或组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csattribute [-q|-v] -a attribute=value [-t resource | user] [-d domain] add target csattribute [-q|-v] -a attribute[=value] [-t resource | user] [-d domain] delete target csattribute [-q | -v] [-t resource | user] [-d domain] list target |
下表介绍了可用于 csattribute 的命令。
表 D–2 csattribute 实用程序命令
命令 |
说明 |
---|---|
add target |
将 LDAP 属性和值添加到指定的目标(用户对象或资源对象)。 |
list target |
列出目标对象的属性。 |
delete target |
从目标中删除属性。 |
version |
显示实用程序的版本。 |
下表介绍了 csattribute 实用程序命令选项。
表 D–3 csattribute 实用程序命令选项
将值为 tchang 的 icsCalendar LDAP 属性添加到用户 ID tchang:
csattribute -a icsCalendar=tchang add tchang
从 tchang 中删除 LDAP 属性 icsCalendar:
csattribute -a icsCalendar delete tchang
显示 tchang 的属性:
csattribute list tchang
csbackup 实用程序可以备份日历数据库、指定日历或用户的默认日历。命令包括:
database,用于备份日历数据库。
calendar,用于备份指定日历。
defcal,用于备份用户的默认日历。
version,用于显示当前安装的实用程序的版本号。
位于指定备份目录中的 caldb.conf 版本文件显示了已备份的数据库的版本号。
有关 csrestore 的信息,请参见csrestore。
Calendar Server 可以正在运行或已经停止。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csbackup [-q|-v] -f database target csbackup [-q|-v] -c calid calendar target csbackup [-q|-v] -a userid [-b basedn] defcal target |
下表介绍了可用于 csbackup 的命令。
表 D–4 csbackup 实用程序命令
命令 |
说明 |
---|---|
database target |
将日历数据库备份到指定的目标数据库目录。默认情况下,目标数据库目录为: cal_svr_base/SUNWics5/cal/sbin /target-directory 如果只指定目标数据库目录,请勿在目录名称前包含斜杠 (/)。例如: csbackup database backupdir 备注:如果目标备份目录已经存在而您没有指定 -f 选项,csbackup 实用程序将失败。例如,如果 backupdir 已经存在,即使该目录为空,以下命令也将失败: csbackup database backupdir 因此,如果指定的目标备份目录已经存在,必须在运行 csbackup 时包含 -f 选项。 也可以指定一个不存在的目标备份目录,让 csbackup 为您创建该目录。 |
calendar calid target |
将指定的日历 ID 备份到指定的目标输出文件。文件的数据格式由文件的扩展名决定,.ics 对应 text/calendar 格式,.xml 对应 text/xml 格式。 |
defcal userid target |
将指定用户 ID 的默认日历备份到指定的目标文件。文件的数据格式由文件的扩展名决定,.ics 对应 text/calendar 格式,.xml 对应 text/xml 格式。 |
version |
显示实用程序的版本。 |
下表介绍了 csbackup 实用程序命令选项。
表 D–5 csbackup 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-a userid |
要备份的日历用户的用户 ID。使用默认选项时,此选项是必需的。无默认值。 |
-b basedn |
用于此用户的基本 DN。默认值来自 ics.conf 文件中定义的 local.ugldapbasedn 设置。 基本 DN(标识名)为 LDAP 目录中的项,搜索将从此处开始。 例如,如果您指定基本 DN 为 ou=people, o=sesta.com,则由 Calendar Server 执行的所有 LDAP 搜索操作仅检查 o=sesta.com 目录树中的 ou=people 子树。 |
-c calid |
要备份的日历 ID。运行 calendar 命令时,此选项是必需的。无默认值。 有关更多信息,请参见创建日历的唯一标识符 (calid)。 |
-f |
强制删除现有的备份文件。 在当前发行版中,如果备份目标目录已经存在,则必须包含选项 -f,即使该目录为空。 |
-l |
准备要在 SolsticeTM BackupTM 或 Legato NetworkerTM 备份程序中使用的备份文件。有关更多信息,请参见第 17 章,备份和恢复 Calendar Server 数据。 |
将日历数据库备份到名为 backupdir 的目录中:
csbackup database backupdir
将日历 ID 为 tchang 的日历以 text/calendar 格式备份到文件 tchang.ics 中:
csbackup -c tchang calendar tchang.ics
将 tchang 的默认日历以 text/xml 格式备份到文件 tchang.xml 中:
csbackup -a tchang defcal tchang.xml
create,用于创建日历
delete,用于删除日历
disable,用于禁用日历
enable,用于启用日历
list,用于列出日历
modify,用于修改日历属性和组计划访问控制
reset,用于将日历属性重置为默认设置
version,用于显示当前安装的实用程序的版本号
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
cscal [-q|-v] [-a aces] [-c charset] [-d description] [-g categories] [-k yes|no] [-l langcode] [-m email] [-n name] [-o owner’s uid] [-y otherowners] create|modify calid cscal [-q|-v] [-o owner’s uid] [-O] delete|reset calid cscal [-q|-v] [-o owner’s uid] [-O] disable|list [calid] cscal [-q|-v] [-k yes|no] [-o owner’s uid] [-O] enable [calid] |
尽管在输入 -o(属主的 uid)时,cscal 不检查大小写,搜索也不区分大小写。
下表介绍了可用于 cscal 实用程序的命令。
表 D–6 cscal 实用程序命令
命令 |
说明 |
---|---|
create calid |
创建由 calid 指定的日历。 注意:如果您的站点正在使用 LDAP CLD 插件,则特定用户的所有日历必须在同一个后端服务器上,如用户的 icsDWPHost LDAP 属性所示。如果试图在不同的后端服务器上为用户创建日历,Calendar Server 将返回一条错误信息。 |
delete calid |
删除由 calid 指定的日历。 如果指定了 -o owner 选项,将删除主要属主为指定 uid 的所有日历。 |
enable [calid] |
启用由 calid 指定的日历。如果未指定 calid,将启用所有日历。 如果指定了 -o owner 选项,将启用主要属主为指定 uid 的所有日历。 |
disable [calid] |
禁用由 calid 指定的日历。如果未指定 calid,将禁用所有日历。 如果指定了 -o owner 选项,将禁用主要属主为指定 uid 的所有日历。 |
list [calid] |
列出由 calid 指定的日历的属性。如果未指定 calid,将列出所有日历的属性。 如果指定了 -o owner's uid 选项,将列出主要属主为指定属主 uid 的所有日历。 |
modify calid |
修改由 calid 指定的日历的属性。 |
reset calid |
将由 calid 指定的日历的属性重置为默认的配置设置。 |
version |
显示实用程序的版本。 |
下表介绍了 cscal 实用程序命令选项。
表 D–7 cscal 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-a [aces] |
指定日历的访问控制条目 (Access Control Entries, ACE)。ACE 决定可以访问组计划日历的人员以及他们拥有的权限类型,例如创建、删除、读取和写入权限。ACE 字符串或存取控制表 (Access Control List, ACL) 必须括在双引号 (" ") 中。 默认值来自 ics.conf 文件中的 calstore.calendar.default.acl 参数。 有关 ACE 格式的详细信息,请参见日历访问控制。 |
-c charset |
字符集。默认情况下无字符集。 |
-d description |
说明(有关日历用途的可视注释)。默认无说明。 |
-g category |
类别。多个类别必须括在双引号 (" ") 中,类别之间用空格隔开。默认情况下无类别。 |
-k yes|no |
指定是否允许用户日历的双重预订。例如,yes 表示可以为日历中的同一时段预定多个事件。 如果省略 -k 选项,默认值将来自 ics.conf 文件中的 user.allow.doublebook 参数。但是,仅当创建日历时才使用 user.allow.doublebook 参数。 创建日历后,Calendar Server 将检查日历属性数据库 ics50calprops.db,以决定是否允许双重预订。要更改日历的日历属性以允许或禁止双重预订,请使用 -k 选项重新运行 cscal。 |
-l langcode |
语言代码。默认情况下无语言代码。 |
-m email |
电子邮件地址。默认情况下无电子邮件。 |
-n name |
名称。默认情况下无名称。 |
-o owner |
主要属主。默认设置为日历 ID (calid),该 ID 通常与用户 ID 相同。 |
-O |
指定主要属主的所有日历。默认情况下只有指定的日历。 |
-y otherowners |
其他日历属主。多个属主必须括在双引号 (" ") 中,属主之间用空格隔开。默认情况下无其他属主。 |
使用默认访问控制设置(如 ics.conf 文件中的 calstore.calendar.default.acl 所定义)创建一个日历,其日历 ID 为 tchang,主要属主为 tchang,可视名称为 Public_Calendar:
cscal -o tchang -n Public_Calendar create tchang
修改日历 chang 使所有用户都拥有读写权限,该日历与类别 sports 关联并且由 jsmith@sesta.com 共同所有:
cscal -a "@^a^rw^g" -g sports -y jsmith@sesta.com modify tchang
禁用日历 ID 为 tchang 的日历(不允许用户通过用户界面读取、写入或查找该日历):
cscal disable tchang
启用日历 ID 为 tchang 的日历(允许用户通过用户界面读取或写入该日历),但不允许双重预订:
cscal -k no enable tchang
列出 tchang 的属性:
cscal list tchang
列出 tchang 的所有属性:
cscal -v list tchang
列出数据库中的所有日历:
cscal list
将日历 ID 为 tchang 的日历重置为默认配置设置:
cscal reset tchang
从日历 ID 为 tchang 的日历中删除一个说明:
cscal -d "" modify tchang
从日历 ID 为 tchang 的日历中删除所有类别:
cscal -g "" modify tchang
从日历 ID 为 tchang 的日历中删除其他属主:
cscal -y "" modify tchang
从日历数据库中删除 tchang:
cscal delete tchang
从主要属主为 tchang 的日历数据库中删除所有日历:
cscal -o tchang delete
csclean 实用程序仅运行在 Schema 2 托管域模式中。它将删除状态属性 (icsStatus) 已被 Delegated Administrator 标记为“已删除”的用户的用户日历和资源日历。
对于 Schema 1 和非托管域模式,请使用 csuser 和 cscal 来删除已删除用户的所有日历。
必须使用 Schema 2 托管域。
Calendar Server 可以正在运行或已经停止。
必须在安装了 Calendar Server 的本地计算机上运行 csclean。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csclean [-q | -v] [-g graceperiod] clean domain |
下表介绍了 csclean 实用程序命令选项。
表 D–8 csclean 实用程序命令选项
移除 sesta.com 中日历服务已被删除至少 5 天的所有用户和资源的日历:
csclean -g 5 clean sesta.com
移除所有域中日历服务已被删除至少 10 天的所有用户和资源的日历:
csclean clean "*"
cscomponents 实用程序可以管理日历组件:事件和任务(待办事件)。命令包括:
delete,用于删除日历中的事件和任务。
list,用于列出日历中的事件和任务。
version,用于显示当前安装的实用程序的版本号。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
cscomponents [-v|-q] [-e endtime] [-s starttime] [-t event|task] delete|list calid |
下表介绍了可用于 cscomponents 实用程序的命令。
表 D–9 cscomponents 实用程序命令
命令 |
说明 |
---|---|
delete calid |
删除具有指定日历 ID 的日历中的事件和任务。 |
list calid |
列出具有指定日历 ID 的日历中的事件和任务。 |
version |
在屏幕上显示实用程序的版本。 |
下表介绍了 cscomponents 实用程序命令选项。
表 D–10 cscomponents 实用程序命令选项
删除日历 ID 为 tchang 的日历中 2000 年的所有事件:
cscomponents -s 20000101T000000Z -e 20001231T000000Z delete tchang
列出日历 ID 为 tchang 的日历中所有事件和任务的详细信息:
cscomponents -v list tchang
csdb 实用程序可以管理日历数据库(日历、会话和统计信息)。命令包括:
create,用于创建新数据库。(如果启动服务器时数据库不存在,Calendar Server 将自动创建一个数据库。)
delete,用于删除现有的日历数据库。不能删除打开的数据库(当 Calendar Server 正在运行时)。
list,用于列出数据库的信息。
check,用于检查日历数据库以确定数据库是否被损坏。
rebuild,用于重建已损坏的日历数据库。
recover,用于恢复已损坏的日历数据库。
version,用于显示当前安装的实用程序的版本号。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
运行 create、delete 或 rebuild 命令时,必须停止 Calendar Server。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csdb [-q|-v] [-t caldb|sessdb|statdb] create|delete [dbdir] csdb [-q|-v] [-t caldb|sessdb|statdb] list [dbdir] csdb [-q|-v] [-f] [-t caldb|sessdb|statdb] recover [dbdir] csdb check [dbdir] csdb rebuild [-a, -V] [-g] [dbdir [dstdir]] |
下表介绍了可用于 csdb 实用程序的命令。
表 D–11 csdb 实用程序命令
命令 |
说明 |
---|---|
create [dbdir] |
在指定的数据库目录中创建数据库。如果未指定数据库目录,将使用当前目录。如果启动服务器时数据库不存在,Calendar Server 将自动创建一个数据库。 |
delete [dbdir] |
删除指定数据库目录中的数据库。如果未指定数据库目录,将使用当前目录。不能删除打开的数据库(当 Calendar Server 正在运行时)。 |
list [dbdir] |
列出指定数据库目录中的数据库的信息。如果未指定数据库目录,将使用当前目录。 |
recover [dbdir] |
尝试恢复指定数据库目录中已损坏的日历数据库。如果未指定数据库目录,将使用当前目录。不会为会话或统计信息数据库执行该命令。 |
check [dbdir] |
扫描指定数据库目录中的日历数据库以确定数据库是否被损坏,并在输出中报告扫描结果。如果未指定数据库目录,将使用当前目录。 |
rebuild [dbdir [dstdir]] |
扫描指定数据库目录中所有日历数据库以确定数据库是否被损坏,如果有损坏,则重建一个日历数据库(.db 文件)。如果未指定数据库目录,将使用当前目录。重建数据库后,db_verify 将运行。 dstdir 用于指定可选的目标目录。 |
version |
显示实用程序的版本。 |
下表介绍了 csdb 实用程序命令选项。
表 D–12 csdb 实用程序命令选项
在当前目录中创建一个新的、未经填充的数据库:
csdb -t caldb create
删除当前目录中的数据库:
csdb -t caldb delete
列出当前目录中的日历数据库的信息:
csdb -v -t caldb list
尝试恢复当前目录中所有被损坏的数据库:
csdb recover
列出当前目录中的会话数据库的信息:
csdb -t sessdb list
仅重建警报数据库:
csdb -a -V rebuild
csdomain 实用程序可以在托管(虚拟)域的 LDAP 目录中管理 Calendar Server 属性。这些属性是 icsCalendarDomain 对象类的一部分。命令包括:
create,用于在 LDAP 目录中创建一个新的托管域。
add,用于在 LDAP 目录中为指定的托管域添加 Calendar Server 属性及其关联值。
delete,用于从 LDAP 目录中删除特定托管域的 Calendar Server 属性或删除整个托管域。
list,用于列出 LDAP 目录中特定托管域的 Calendar Server 属性。
必须处于托管(虚拟)域模式下,才能运行 csdomain。也就是说,必须设置 ics.conf 文件中的以下参数:
service.virtualdomain.support 必须设置为 "yes"。
local.schemaversion 必须设置为 LDAP schema 的版本("1"、"1.5" 或 "2")。
如果 local.schemaversion = “1” 或 “1.5” ,则 service.dcroot 必须设置为 LDAP 目录中 DC 树的根后缀。
如果 local.schemaversion = “2”,则 service.schema2root 必须设置为所有域所在目录的根后缀。
在使用 csdomain 添加组织树节点之前,必须按照第 11 章,设置托管域中的说明进行操作。
必须在已安装 Calendar Server 的本地计算机上运行 csdomain。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csdomain [-q | -v] -n node create domain csdomain [-q | -v] {-a attr[=value] | -f filename} add domain csdomain [-q | -v] [-a attr | -f filename] delete domain csdomain [-q | -v] list domain |
下表介绍了可用于 csdomain 实用程序的命令。
表 D–13 csdomain 实用程序命令
命令 |
说明 |
---|---|
create |
在 LDAP 目录中创建新的托管域。然后,在目录中的此条目下创建域的所有 Calendar Server 用户和资源。 |
add |
在 LDAP 目录中为特定域添加 Calendar Server 属性及其关联值。如果使用 csdomain 添加或更新域的 LDAP 属性,必须重新启动 Calendar Server 才能使新值生效。 |
delete |
从 LDAP 目录中删除某个特定托管域的 Calendar Server 属性,或删除整个域的所有 LDAP 条目。 |
list |
列出 LDAP 目录中某个特定域的 Calendar Server 属性。 |
version |
显示实用程序的版本。 |
下表介绍了 csdomain 实用程序命令选项。
表 D–14 csdomain 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-a attr[=value] |
指定 LDAP 属性的属性名及其可选值。 有关这些属性和 Property 名的列表,请参见LDAP 属性和 property 名。 |
-f filename |
指定包含 Calendar Server LDAP 目录的 property 名及其关联值的文本文件。 例如: createLowerCase="yes" filterPrivateEvents="no" fbIncludeDefCal="no" subIncludeDefCal="no" uiProxyUrl="https://proxyserver " |
-n node |
按照如下说明应用到 create 命令:
|
domain |
对于 add、delete 和 list 命令,指定 LDAP 目录中的现有域。 对于 create 命令,为将在 LDAP 目录中创建的新域指定一个唯一的名称。 例如:west.sesta.com |
下表介绍了应用于 csdomain 实用程序的 LDAP 属性和 property 名。这些属性是 icsCalendarDomain 对象类的一部分。添加或删除值时,必须使用 property 名而不是属性名。
如果使用 csdomain 添加或更新域的 LDAP 属性,必须重新启动 Calendar Server 才能使新值生效。
LDAP 属性和 property 名介绍了可以使用 csdomain 实用程序设置的 icsAllowRights 属性及其属性。属性是一个 32 位的数字字符串,字符串中的每一位都对应于一种特定的用户权限。(在当前发行版中,一些位没有使用,默认情况下被设置为零。)如果设置了与某个权限对应的位(值 = 1),则不允许该权限。如果未设置该位(值 = 0),则允许该权限。
icsAllowRights 属性中的每个属性都有一个对应的 ics.conf 参数。如果某个属性没有设置(值 = 0)或不存在 (service.virtualdomain.support = "no"),Calendar Server 将使用对应的 ics.conf 参数作为默认值。
icsAllowRights 的值是数字字符串,而不是整数。要在按位进行的操作中以编程方式使用 icsAllowRights,必须首先将其字符串值转换为整数。
表 D–15 icsAllowRights LDAP 目录属性和 Property
位 |
property 名 |
说明 |
---|---|---|
0 |
allowCalendarCreation |
如果设置(第 0 位 = 1),则不允许创建日历。 对应的 ics.conf 参数: service.wcap.allowcreatecalendars |
1 |
allowCalendarDeletion |
如果设置(第 1 位 = 1),则不允许删除日历。 对应的 ics.conf 参数: service.wcap.allowdeletecalendars |
2 |
allowPublicWritableCalendars |
如果设置(第 2 位 = 1),则不允许公共可写日历。 对应的 ics.conf 参数: service.wcap.allowpublicwriteablecalendars |
3 |
当前发行版中未使用。 |
|
4 |
allowModifyUserPreferences |
如果设置(第 4 位 = 1),则不允许域管理员使用 WCAP 命令来获取或设置用户首选项。 对应的 ics.conf 参数: service.admin.calmaster.wcap.allowgetmodifyuserprefs |
5 |
allowModifyPassword |
如果设置(第 5 位 = 1),则不允许用户通过此服务器更改密码。 对应的 ics.conf 参数: service.wcap.allowchangepassword |
6 |
当前发行版中未使用。 |
|
7 |
当前发行版中未使用。 |
|
8 |
allowUserDoubleBook |
如果设置(第 8 位 = 1),则不允许双重预订用户日历。 对应的 ics.conf 参数: user.allow.doublebook |
9 |
allowResourceDoubleBook |
如果设置(第 9 位 = 1),则不允许双重预定资源日历。 对应的 ics.conf 参数: resource.allow.doublebook |
10 |
allowSetCn |
如果设置(第 10 位 = 1),则不允许用户使用 WCAP set_userprefs 命令来设置通用名称 (cn) 属性。 对应的 ics.conf 参数: service.wcap.allowsetprefs.cn |
11 |
allowSetGivenName |
如果设置(第 11 位 = 1),则不允许用户使用 WCAP set_userprefs 命令来设置 givenName 属性。 对应的 ics.conf 参数: service.wcap.allowsetprefs.givenname |
12 |
allowSetGivenMail |
如果设置(第 12 位 = 1),则不允许用户使用 WCAP set_userprefs 命令来设置 mail 属性。 对应的 ics.conf 参数: service.wcap.allowsetprefs.mail |
13 |
allowSetPrefLang |
如果设置(第 13 位 = 1),则不允许用户使用 WCAP set_userprefs 命令来设置 preferredLanguage 属性。 对应的 ics.conf 参数: service.wcap.allowsetprefs.preferredlanguage |
14 |
allowSetSn |
如果设置(第 14 位 = 1),则不允许用户使用 WCAP set_userprefs 命令来设置 surname (sn) 属性。 对应的 ics.conf 参数: service.wcap.allowsetprefs.sn |
15–31 |
当前发行版中未使用。 |
下表介绍了可以使用 csdomain 实用程序设置的 icsExtendedDomainPrefs 属性及其属性。每个属性都有一个对应的 ics.conf 参数。如果某个属性没有设置(值 = 0,service.virtualdomain.support = "no")或不存在,Calendar Server 将使用对应的 ics.conf 参数作为默认值。
表 D–16 icsExtendedDomainPrefs LDAP 目录属性
property 名 |
说明 |
---|---|
allowProxyLogin |
指定 yes(允许代理登录)或 no(不允许代理登录)。 对应的 ics.conf 参数: service.http.allowadminproxy(默认值 = no) |
calmasterAccessOverride |
指定 yes(允许 Calendar Server 管理员覆盖访问控制)或 no(不允许 Calendar Server 管理员覆盖访问控制)。 对应的 ics.conf 参数: service.admin.calmaster.overrides.accesscontrol(默认值 = "no") |
calmasterCred |
指定一个 ASCII 字符串,该字符串是指定为 Calendar Server 域管理员的用户 ID 的密码。 对应的 ics.conf 参数: service.admin.calmaster.cred(无默认值) |
calmasterUid |
指定一个 ASCII 字符串,该字符串是指定为 Calendar Server 域管理员的用户的用户 ID。 对应的 ics.conf 参数: service.admin.calmaster.userid(无默认值) |
createLowercase |
如果指定 yes,创建新日历或搜索日历时 Calendar Server 会将日历 ID (calid) 转换为小写;如果指定 no,则不进行转换。 对应的 ics.conf 参数: calstore.calendar.create.lowercase(默认值 = "no") |
domainAccess |
指定域的访问控制列表 (ACL)。有关 ACL 的信息,请参见访问控制列表 (ACL)。 此 ACL 用于交叉域搜索。有关更多信息,请参见交叉域搜索。 |
fbIncludeDefCal |
如果指定 "yes",则在用户的空闲/繁忙日历列表中包括用户的默认日历;如果指定 "no" 则不包括。 对应的 ics.conf 参数: calstore.freebusy.include.defaultcalendar(默认值 = yes) |
filterPrivateEvents |
如果指定 "yes",则 Calendar Server 过滤(识别)“私人”和“仅时间与日期(保密)”事件和任务。如果指定 "no",Calendar Server 将按照处理“公用”事件和任务的方式处理这些事件和任务。 对应的 ics.conf 参数: calstore.filterprivateevents(默认值 = yes) |
groupMaxSize |
指定展开事件时,一个 LDAP 组中允许的最大参与者数目。 对应的 ics.conf 参数: calstore.group.attendee.maxsize(默认值是 "0"—展开整个组) |
language |
指定域的语言。 对应的 ics.conf 参数: local.domain.language |
resourceDefaultAcl |
指定访问控制列表 (ACL),该列表是创建资源日历时使用的默认访问控制权限。 对应的 ics.conf 参数: resource.default.acl(默认值是 "@@o^a^r^g;@@o^c^wdeic^g; @^a^rsf^g") |
setPublicRead |
指定最初是将用户的默认日历设置为公用读/专用写 (yes) 还是专用读/专用写 (no)。 对应的 ics.conf 参数: service.wcap.login.calendar.publicread(默认值 = "no") |
searchFilter |
指定用于查找用户的搜索过滤器。 对应的 ics.conf 参数: local.userSearchFilter |
ssoCookieDomain |
指定浏览器只将 Cookie 发送到指定域中的服务器。值必须以句点 (.) 开始。例如:".sesta.com" 对应的 ics.conf 参数: sso.cookiedomain(默认值为当前域) |
ssoUserDomain |
指定作为用户 SSO 验证的一部分使用的域。 对应的 ics.conf 参数: sso.userdomain(无默认值) |
subIncludeDefCal |
如果指定 "yes",则用户的默认日历包含在用户订阅的日历列表中;如果指定 "no" 则不包含。 对应的 ics.conf 参数: calstore.subscribed.include.defaultcalendar(默认值 = "yes") |
uiAllowAnyone |
如果指定 "yes",用户界面将显示并使用“每人”存取控制表 (Access Control List, ACL);如果指定 "no" 则不显示和使用。 对应的 ics.conf 参数: ui.allow.anyone(默认值 = "yes") |
uiAllowDomain |
如果指定 "yes",则用户界面将显示并使用此域的存取控制表 (Access Control List, ACL);如果指定 "no" 则不显示和使用。 对应的 ics.conf 参数: ui.allow.domain(默认值 = "no") |
uiBaseUrl |
指定基本服务器地址的 URL。例如:"https://proxyserver" . 对应的 ics.conf 参数: ui.base.url(无默认值) |
uiConfigFile |
指定一个基于 xml 的可选配置文件,Calendar Server 启动时可以读取该文件,从而隐藏用户界面的某些部分。 对应的 ics.conf 参数: ui.config.file(无默认值) |
uiProxyURL |
指定要放在 HTML UI JavaScript 文件前面的代理服务器地址的 URL。例如:"https://web_portal.sesta.com/" 对应的 ics.conf 参数: ui.proxyaddress.url(无默认值) |
下表介绍了可以使用 csdomain 实用程序设置的其他 LDAP 属性及其属性。
表 D–17 可以使用 csdomain 实用程序设置的其他 LDAP 目录属性
使用 LDAP Schema 1 创建一个名为 west.sesta.com 的新托管域:
csdomain -v -n o=nodewest,o=sesta create west.sesta.com
使用 LDAP Schema 2 创建一个名为 east.sesta.com 的新托管域:
csdomain -v -n nodeeast create east.sesta.com
显示名为 west.sesta.com 的托管域的 Calendar Server LDAP 属性列表:
csdomain -v list west.sesta.com
将名为 west.sesta.com 的托管域的时区设置为 America/New_York:
csdomain -v -a timezone=America/New_York add west.sesta.com
csexport 实用程序将日历以 iCalendar (.ics) 或 XML (.xml) 格式导出至某个文件。命令包括:
calendar,用于导出指定日历。
version,用于显示当前安装的实用程序的版本号。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csexport [-v|-q] -c calid calendar outputfile |
下表介绍了可用于 csexport 实用程序的命令。
表 D–18 csexport 实用程序命令
命令 |
说明 |
---|---|
calendar outputfile |
将日历导出至指定的输出文件。文件的数据格式由指定的文件扩展名决定:
|
version |
显示实用程序的版本。 |
下表介绍了 csexport 实用程序命令选项。
表 D–19 csexport 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-c calid |
要导出的日历的日历 ID。运行 calendar 命令时,此选项是必需的。无默认值。 |
以 iCalendar (text/calendar) 格式将日历 ID 为 tchang 的日历导出至名为 tchang.ics 的文件:
csexport -c tchang calendar tchang.ics
以 XML (text/xml) 格式将日历 ID 为 tchang 的日历导出至名为 tchang.xml 的文件:
csexport -c tchang calendar tchang.xml
csimport 实用程序可从 csexport 实用程序保存的 iCalendar (ics) 或 XML 格式的文件中导入日历。命令包括:
calendar—用于导入指定日历。
version—用于显示当前安装的实用程序的版本号。
导入日历组件的日期计算使用该组件的关联 X-NSCP-DTSTART-TZID 中指定的时区。如果不存在这样的时区,则使用在 ics.conf 中找到的服务器时区。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csimport [-v|-q] -c calid calendar inputfile |
下表介绍了可用于 csimport 实用程序的命令。
表 D–20 csimport 实用程序命令
命令 |
说明 |
---|---|
calendar inputfile |
从指定的输入文件导入日历。文件的数据格式由文件扩展名决定:
|
version |
显示实用程序的版本。 |
下表介绍了 csimport 实用程序命令选项。
表 D–21 csimport 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-c calid |
要导入的日历的日历 ID。运行 calendar 命令时,此选项是必需的。 如果指定的日历 ID 已经存在,导入的数据将与当前日历合并。无默认值。 有关更多信息,请参见创建日历的唯一标识符 (calid)。 |
从文件 tchang.ics 中以 iCalendar(text/calendar 文件)格式导入日历 ID 为 tchang 的日历:
csimport -c tchang calendar tchang.ics
从文件 tchang.xml 中以 XML(text/xml 文件)格式导入日历 ID 为 tchang 的日历:
csimport -c tchang calendar tchang.xml
csmonitor 实用程序是执行以下监视功能的脚本:
根据特定的 ics.conf 参数检查 LDAP 连接。
检查事务日志文件,如果存在多个文件,csmonitor 将通过电子邮件发送警告。
检查日历数据库的可用磁盘空间。
检查 Calendar Server 服务是否正在运行。
csmonitor [ -k | -c | -help] |
下表介绍了 csmonitor 实用程序的命令。
表 D–22 csmonitor 实用程序命令选项
参数 |
说明 |
---|---|
-k |
停止 csmonitor。 |
-c |
备份并清理 csmonitor 日志。 |
-help |
显示 csmonitor 用法说明。 |
下表 csmonitor。
表 D–23 csmonitor 配置参数
参数 |
说明 |
---|---|
service.monitor.continuous |
指定 csmonitor 是否应持续循环: "0"—不持续循环。 "1"—持续循环。 默认值为 "0"。 |
service.monitor.loopsdelay |
指定两次监视循环之间的延迟秒数。默认值为 "60"。 |
service.monitor.emailaddress.from |
指定 csmonitor 从中发送消息的电子邮件地址。无默认值。 |
service.monitor.emailaddress.to |
指定 csmonitor 向其发送消息的电子邮件地址。无默认值。 |
service.monitor.csdb.logthreshold |
以总磁盘空间百分比的形式指定一个阈值,该值代表被视为正常的最大磁盘空间占用率。如果日历数据库(csdb 目录)所在磁盘的占用率超过该值,csmonitor 将发送警告电子邮件消息。 默认值为 "90"。 |
logfile.monitor.logname |
指定 csmonitor 日志文件名。 默认值为 "csmonitor.log"。 |
logfile.monitor.maxlogfilesize |
指定日志文件的最大大小。如果日志文件超过该值,csmonitor 将日志另存为 csmonitor.log.timestamp,然后重置日志。 默认值为 "2097152"。 |
service.monitor.dbglevel |
指定调试级别。值越高,csmonitor 发送的消息就越精确,越详细。 默认值为 "0"。 |
csplugin 用于管理为 Calendar Server 安装配置的 CSAPI 插件。命令包括:
activate,用于装入并启动指定插件。
deactivate,用于关闭并禁用指定的插件类型和插件名称。(有关支持的插件类型的说明,请参见表 D–25 中的 -t 选项。)
list,用于显示所有支持的插件。
version,用于显示当前安装的实用程序的版本号。
必须在已安装 Calendar Server 的本地计算机上运行。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate activate|deactivate plugin csplugin [-q|-v] list |
下表介绍了可用于 csplugin 实用程序的命令。
表 D–24 csplugin 实用程序命令
命令 |
说明 |
---|---|
activate -t type name |
装入并启用指定的插件类型和插件名称。(有关支持的插件类型的说明,请参见表 D–25 中的 -t 选项。) |
deactivate -t type name |
关闭并禁用指定的插件类型和插件名称。(有关支持的插件类型的说明,请参见表 D–25 中的 -t 选项。) |
list |
列出所有支持的插件类型、名称和活动状态。(有关支持的插件类型的说明,请参见表 D–25 中的 -t 选项。) |
version |
显示实用程序的版本。 |
下表介绍了 csplugin 实用程序命令选项。
表 D–25 csplugin 实用程序命令选项
列出所有支持插件的详细信息,包括为与此服务器实例一起使用而配置的每个插件的类型、名称以及激活状态:
csplugin -v list
装入并启用类型为 lookup,文件名为 mylookup 的插件:
csplugin activate -t lookup mylookup
禁用类型为 lookup,文件名为 mylookup 的插件,然后将其从 plugin 目录中删除:
csplugin deactivate -t lookup mylookup -r
cspurge 实用程序,使用该实用程序可以手动清除删除日志数据库 (ics50deletelog.db) 中的条目。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
cspurge [-q|-v] -e endtime -s starttime |
下表介绍了 cspurge 实用程序命令选项。
表 D–26 cspurge 实用程序命令选项
清理“删除日志”中的所有条目:
cspurge -v -e 0 -s 0
清理从 2003 年 7 月 1 日至 2003 年 7 月 31 日的所有条目:
cspurge -v -e 20030731T235959Z -s 20030701T120000Z
清理 2003 年 9 月 30 日之前的所有条目:
cspurge -v -e 20031030T235959Z -s 0
csrename 实用程序允许您重命名一个或多个日历用户。此实用程序按以下方式重命名日历用户:
日历数据库文件—重命名日历数据库文件中的用户(用户 ID),然后将新数据库文件写入目标目录。不修改现有的日历数据库文件。
LDAP Directory Server—转换 Calendar Server LDAP 属性(即带有 "ics" 前缀的属性)中的用户 ID。适当修改 LDAP Directory Server 。
csrename 实用程序位于以下目录中:
cal_svr_base/SUNWics5/cal/sbin
运行 csrename 之前,您必须先:
为要转换的用户创建输入映射文件(-m 选项)。
创建 LDAP Directory Server 中的所有新用户(如果需要)。
停止 Calendar Server。
要运行 csrename,您必须以 icsuser(或在配置过程中指定的 Calendar Server 运行时用户 ID)身份登录。如果您以超级用户 (root) 身份运行 csrename,则可能需要重置对新数据库文件的权限。要修改 LDAP Directory Server 属性,您还必须具有该目录的管理权限。
如果 Calendar Server 安装具有前端/后端服务器配置,则必须对每个后端服务器运行 csrename。
请使用以下语法运行 csrename:
csrename [-t DestinationDB] [-c ConfigFile] [-e ErrorFile] -m MappingFile rename [DB|LDAP] |
该表列出了此实用程序的选项以及对每个选项的说明:
表 D–27 csrename 选项
选项 |
说明 |
---|---|
-t DestinationDB |
指定目标目录,csrename 在该目录中创建具有已转换用户名的新数据库。默认值为 MigratedDB。运行完 csrename 后,ics.conf 文件中的 caldb.berkeleydb.homedir.path 参数必须指向目标数据库。重置 caldb.berkeleydb.homedir.path 以指向目标数据库目录,或将目标数据库文件移到参数所指示的目录。 |
-c ConfigFile |
用于指定 Calendar Server 配置文件的输入参数。默认值为 ics.conf 文件。csrename 使用配置文件中的 caldb.berkeleydb.homedir.path 参数来确定输入日历数据库的位置。日历数据库的默认位置为 /var/opt/SUNWics5/csdb。 |
-e ErrorFile |
是 csrename 向其中写入无法解决的错误或数据库项的文件。默认值为 MigrateError。 |
-m MappingFile |
指定输入映射文件。默认值为 MigrateMapping。输入映射文件是将现有用户 ID 映射到新用户 ID 中的文本文件。运行 csrename 之前,必须创建映射文件。每行指定一个条目,在旧值和新值之间留有一个空格。 例如: tchang tc897675 jsmith js963123 bkamdar bk548769 如果检查了结果之后,发现遗漏了一个或多个预定的名称更改,可以通过创建只包含遗漏名称的新映射文件并重新运行 csrename 来更正错误。 |
DB|LDAP |
指定获得更新的数据库: DB 只转换新日历数据库中的用户 ID(默认)。 LDAP 转换新日历数据库和 LDAP Directory Server 属性中的用户 ID。 |
根据名为 DBMapFile 的映射文件重命名用户,并在名为 newcalDB 的目标目录中创建新的日历数据库:
csrename -t newcalDB -m DBMapFile rename DB
根据名为 NewNames 的映射文件中的值重命名用户,在名为 NewDB 的目标目录中创建新的日历数据库,并修改 LDAP Directory Server 中的 Calendar Server 属性:
csrename -t NewDB -m NewNames rename LDAP
csresource 实用程序为资源(例如会议室或设备)创建并管理 LDAP 条目和日历。(csresource 实用程序仅对与资源关联的日历可用,如果将其用于用户日历,将返回错误。)命令包括:
create,用于在指定日历 ID (calid) 中添加新资源
delete,用于移除一项资源或所有资源
disable,用于禁用一项资源或所有资源
enable,用于启用一项资源或所有资源
list,用于显示单项资源或所有资源列表
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csresource [-q|-v] [-a aces] [-b basedn] [-d domain] [-t description] [-k yes|no] [-o owner] [-y otherowners] -m email -c calid create common_name csresource [-q|-v] [-b basedn] [-d domain] delete|disable|enable [common_name] csresource [-q|-v] [-b basedn] [-d domain] [-h host] list [common_name] |
下表介绍了可用于 csresource 实用程序的命令。
表 D–28 csresource 实用程序命令
命令 |
说明 |
---|---|
create common_name |
为指定日历 ID 的日历创建新资源。 |
delete [common_name] |
删除一项资源,如果未指定资源 common_name,则删除所有资源。 |
enable [common_name] |
启用一项资源,如果未指定资源 common_name,则启用所有资源。 |
disable [common_name] |
禁用一项资源,如果未指定资源 common_name,则禁用所有资源。 |
list [common_name] |
显示单个资源日历,如果未指定资源 name,则显示所有资源日历。 如果包含 -h host 选项,则显示该后端服务器上具有指定名称的资源日历(或所有资源日历)的日历属性。 |
在上述任何命令中,如果 name 包含空格,则必须将其括在双引号 (" ") 中。
下表介绍了 csresource 实用程序命令选项。
表 D–29 csresource 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-a [aces] |
指定日历的访问控制条目 (Access Control Entries, ACE)。ACE 决定可以访问组计划日历的人员以及他们拥有的权限类型,例如创建、删除、读取和写入权限。ACE 字符串或存取控制表 (Access Control List, ACL) 必须括在双引号 (" ") 中。 默认值为 ics.conf 文件中的 resource.default.acl 参数。 有关 ACE 格式的信息,请参见日历访问控制。 |
-b [basedn] |
要用于指定资源的 LDAP 基本 DN(标识名)。默认值来自 ics.conf 文件中的 local.ugldapbasedn 参数。 |
-c calid |
icsCalendar 属性。运行 create 命令时,此选项是必需的。有关更多信息,请参见创建日历的唯一标识符 (calid)。 |
-d domain | |
-t [description] |
指定有关日历用途的可视注释。默认无说明。 |
-h host |
指定资源日历所在的后端服务器的名称。此选项仅适用于 list 命令。 |
-k yes|no |
指定是否允许双重预订与资源(例如会议室)关联的日历。例如,yes 表示可以为资源日历中的同一时段预定多个事件。 如果省略 -k 选项,则默认值来自 ics.conf 文件中的 resource.allow.doublebook 参数。但是,仅当创建日历时才使用 resource.allow.doublebook 参数。 创建日历后,Calendar Server 将检查日历属性数据库 (ics50calprops.db),以决定是否允许双重预订。要更改日历的日历属性以允许或禁止双重预订,请使用 -k 选项重新运行 csresource。 |
-m email |
指定资源的 LDAP mail 属性(主要电子邮件地址)。 |
-o owner |
主要属主。 |
-y otherowners |
其他属主。多个属主必须括在双引号 (" ") 中,属主之间用空格隔开。默认情况下无其他属主。 |
version |
显示实用程序的版本。 |
显示所有资源日历及其 LDAP 属性的列表:
csresource -v list
创建一个日历 ID (calid) 为 room100,可视名称(LDAP cn 属性)为 MeetingRoom100 的资源日历:
csresource -m room100@sesta.com -c room100 create MeetingRoom100
显示可视名称为 MeetingRoom100 的资源日历的 LDAP 属性:
csresource -v list MeetingRoom100
禁用可视名称为 MeetingRoom100 的资源日历:
csresource disable MeetingRoom100
启用可视名称为 MeetingRoom100 的资源日历并允许双重预订:
csresource -k yes enable MeetingRoom100
删除可视名称为 MeetingRoom100 的资源日历:
csresource delete MeetingRoom100
显示后端服务器 sesta 上可视名称为 MeetingRoom100 的资源日历的 LDAP 属性:
csresource -v -h sesta list MeetingRoom100
csrestore 实用程序恢复使用 csbackup 或 csexport 保存的日历数据库、指定日历或用户的默认日历。命令包括:
database,用于恢复日历数据库。
calendar,用于恢复指定日历。
defcal,用于恢复用户的默认日历。
version,用于显示当前安装的实用程序的版本号。
位于指定备份目录中的 caldb.conf 版本文件显示了已备份的数据库的版本号。
Calendar Server 6 csrestore 与 csrestore 版本 2 不兼容。请勿尝试恢复使用 Calendar Server 2 csrestore 备份的数据,否则可能会导致数据丢失。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
恢复日历数据库时,必须停止 Calendar Server。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csrestore [-v|-q] [-f] database inputdir csrestore [-v|-q] -c calid calendar inputfile csrestore [-v|-q] -a userid [-b basedn] defcal inputfile |
下表介绍了可用于 csrestore 实用程序的命令。
表 D–30 csrestore 实用程序命令
下表介绍了 csrestore 实用程序命令选项。
表 D–31 csrestore 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-a userid |
要恢复的用户 ID。使用默认选项时,此选项是必需的。无默认值。 |
-b basedn |
要用于指定用户 ID 的 LDAP 基本标识名 (Distinguished Name, DN)。默认值来自 ics.conf 文件中定义的 local.ugldapbasedn 设置。 |
-f |
强制删除现有的数据库文件。 |
-c calid |
要恢复的日历 ID。运行 calendar 命令时,此选项是必需的。无默认值。 有关更多信息,请参见创建日历的唯一标识符 (calid)。 |
恢复以前使用 csbackup 保存的、存储在目录 backupdir 中的日历数据库:
csrestore database backupdir
从位于目录 backupdir 中的文件 tchang.ics 中恢复日历 ID 为 tchang 的日历,该日历以前使用 csbackup 或 csexport 保存为 iCalendar(text/calendar 文件)格式:
csrestore -c tchang calendar backupdir/tchang.ics
从位于 backupdir 的日历数据库中恢复以前使用 csbackup 保存的 tchang:
csrestore -c tchang calendar backupdir
从位于目录 backupdir 中的文件 tchang.ics 中恢复 tchang 拥有的默认日历,该日历以前使用 csbackup 或 csexport 保存为 iCalendar(text/calendar 文件)格式:
csrestore -a tchang defcal backupdir/tchang.ics
csschedule 实用程序管理组计划引擎 (Group Scheduling Engine, GSE) 队列中存储的计划条目。命令包括:
list,用于显示指定日历 ID 请求的 GSE 队列中的条目。
delete,用于从指定日历 ID 请求的 GSE 队列中移除一个条目。
version,用于显示当前安装的实用程序的版本号。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
必须停止 Calendar Server。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csschedule [-q|-v] [-c count] [-e endtime] [-s starttime] [-t scheduletime -o offset] [-u uid] list [calid] csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber -r rid] list [calid] csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber -r rid] delete [calid] csschedule [-q|-v] [-s starttime] [-e endtime] delete [calid] |
下表介绍了可用于 csschedule 实用程序的命令。
表 D–32 csschedule 实用程序命令
命令 |
说明 |
---|---|
list |
显示指定日历 ID 请求的 GSE 队列中的条目。 |
delete |
从指定日历 ID 请求的 GSE 队列中删除一个条目。 |
version |
显示实用程序的版本。 |
下表介绍了 csschedule 实用程序命令选项。
表 D–33 csschedule 实用程序命令选项
列出 GSE 队列中存储的所有条目的详细信息:
csschedule -v list
列出 GSE 队列中存储的前十个条目:
csschedule -c 10 list
列出 GSE 队列中,2000 年 12 月 31 日 10:30:45 到 11:30:45 之间计划的条目:
csschedule -s 20001231T103045Z -e 20001231T113045Z list
列出 GSE 队列中,日历 tchang 中计划于 10:30:45 开始的条目,其 2000 年 12 月 31 日 10:30:45 时的偏移数为 2,唯一标识符为 1111,周期 ID 为 0,序列号为 0:
csschedule -v -t 20001231T103045Z -o 2 -u 1111 -r 0 -n 0 list tchang
删除 GSE 队列中,日历 tchang 中计划于 10:30:45 开始的条目,其 2000 年 12 月 31 日 10:30:45 时的偏移数为 1,唯一标识符为 1111,周期 ID 为 0,序列号为 0:
csschedule -v -t 20001231T103045Z -o 1 -u 1111 -r 0 -n 0 delete tchang
删除 GSE 队列中,2000 年 12 月 31 日 10:30:45 到 16:30:45 之间计划的条目:
csschedule -v -s 20001231T103045Z -e 20001231T163045Z delete
删除 GSE 队列中的所有条目:
csschedule -v delete
csstats 实用程序用于显示 Calendar Server 统计信息。命令包括:
list,用于列出指定 Calendar Server 子系统的计数器统计信息。
version,用于显示当前安装的实用程序的版本号。
有关计数器的更多信息,请参见计数器配置文件 (counter.conf)。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csstats [-q|v] [-r registry] [-i iterations] [-s delay] list [subsystem] |
下表介绍了可用于 csstats 实用程序的命令。
表 D–34 csstats 实用程序命令
下表介绍了 csstats 实用程序命令选项。
表 D–35 csstats 实用程序命令选项
显示计数器的基本信息和可用类型:
csstats list
列出有关 HTTP 服务子系统 (hpptstat) 的计数器统计信息:
csstats list http
在一小时(3600 秒)内每隔 10 秒列出一次有关 WCAP 子系统 (wcapstat) 的计数器统计信息:
csstats -i 3600 -s 10 list wcap
HTTP 进程,cshttpd。
管理服务,csadmind。
事件通知服务 (Event Notification Service, ENS) 进程,enpd。
cstool 实用程序还可以显示自身版本号。
cstool 不能用于强制回应以下进程:
通知进程,csnotifyd。
DWP 进程,csdwpd。
要刷新配置,请使用 stop-cal,然后使用 start-cal 来停止并随后重新启动 Calendar Server。
请勿使用 cstool 来刷新配置。可能会导致意外的负面结果。
有关更多信息,请参见启动和停止 Calendar Server。
Calendar Server 必须正在运行。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
cstool [-q|-v] [-h host] [-p port] [-t timeout] ping [http|ens] cstool [-q|-v] [-h host] version |
下表介绍了 cstool 命令及其参数。
表 D–36 cstool 实用程序命令
命令 |
参数 |
说明 |
---|---|---|
ping |
[http|admin |ens] 均未指定参数 |
强制回应 cshttpd 进程、csadmind 进程或 ENS 进程 (enpd) 强制回应 Calendar Server 所在的服务器。 |
version |
无 |
显示实用程序的版本。 |
下表介绍了 cstool 实用程序选项。
表 D–37 cstool 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-h host |
指定运行 Calendar Server 的计算机的主机名。在安装时设置默认值,它来自 ics.conf 文件中的 local.hostname 参数。访问远程计算机上运行的 Calendar Server 时,请使用此选项。 |
-p port |
指定服务的端口,如果没有指定服务,则使用 ics.conf 文件中定义的端口默认值。 |
-t timeout |
等待服务器响应的时间(以秒为单位)。默认值为 120 秒。 |
强制回应 cshttpd 服务:
cstool ping http
强制回应主机名为 sesta 的服务器中的 ENS:
cstool -h sesta ping ens
强制回应主机名为 calserver 的计算机,以检查 Calendar Server cshttpd 服务是否在侦听端口 80:
cstool -p 80 -h calserver -p 80 ping http
强制本地 Calendar Server 刷新所有服务的配置:
cstool refresh
csuser 实用程序用于管理存储在 LDAP Directory Server 和 Calendar Server 日历数据库中的日历用户信息。命令包括:
check,用于检查是否已允许用户执行日历操作。
create,用于创建用户并允许其执行日历操作。
此实用程序无法使用户获得 Communications Express 要求的通讯录。这需要使用 ldapmodify 手动完成。
delete,用于删除用户及其默认日历。
处于非托管域模式中时,您必须使用此命令删除用户。但是,该用户拥有的其他日历并不会被删除。使用 cscal 来删除已删除用户的其他日历。
disable,用于禁止用户登录 Calendar Server。
enable,用于允许用户登录 Calendar Server。
list,用于列出用户的日历属性。
reset,用于将用户的日历属性重置为默认设置。
如果使用 Directory Server,您还可以使用 ldapsearch 和 ldapmodify 实用程序。有关这两个实用程序的信息,请参阅以下 Web 站点上的 Directory Server 文档:
http://docs.sun.com/coll/1316.1 和 http://docs.sun.com/coll/1389.1
Calendar Server 可以正在运行或已经停止。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
存储日历用户信息的 LDAP 服务器必须正在运行。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
csuser [-q|-v] [-a aces] [-b basedn] -m email address [-d domain] -f filename -g givenname [-k yes|no] [-l langcode] -s surname -y userpassword create userid csuser [-q|-v] [-b basedn] [-d domain] [-h host] list [userid] csuser [-q|-v] [-b basedn] [-d domain] [check|delete|disable|enable|reset] userid |
下表介绍了可用于 csuser 实用程序的命令。
表 D–38 csuser 实用程序命令
命令 |
说明 |
---|---|
check userid |
检查是否已允许指定的用户 ID 执行日历操作。 |
create userid |
创建指定的用户 ID,并允许该用户登录 Calendar Server。 |
delete userid |
删除指定的用户 ID。 |
disable userid |
禁用指定的用户 ID 执行日历操作。实用程序将 http 定义为 icsAllowedServiceAccess 属性的值。 |
enable userid |
允许指定的用户 ID 执行日历操作。 |
list [userid] |
列出指定用户 ID 的日历属性。如果未指定用户 ID,则列出所有已启用用户的属性。 如果包含 -hserver-name 选项,则列出该后端服务器上指定用户 ID(或所有已启用用户)的日历属性。 |
reset userid |
将某个用户 ID 的所有日历属性重置为其默认设置。 备注:重置用户 ID 的日历属性后,将删除用户的 LDAP 条目中的所有日历属性,包括 icsCalendarUser(对象类)、icsSubscribed、icsCalendarOwned、icsCalendar 和 icsDWPHost(如果该用户使用 LDAP CLD 设置)。Calendar Server 管理员随后将不能代表该用户创建日历。 Calendar Server 管理员对用户发出 csuser enable 命令后,这些属性将在该用户的 LDAP 条目中恢复。 |
version |
显示实用程序的版本。 |
下表介绍了 csuser 实用程序命令选项。
表 D–39 csuser 实用程序命令选项
选项 |
说明 |
---|---|
-v |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-b basedn |
要用于所有 LDAP 用户的基本 DN。默认值来自 ics.conf 文件中定义的 local.ugldapbasedn 设置。 |
-b basedn |
指定用户的基本 DN。 |
-d domain | |
-a [aces] |
指定日历的访问控制条目 (Access Control Entries, ACE)。ACE 决定可以访问组计划日历的人员以及他们拥有的权限类型,例如创建、删除、读取和写入权限。ACE 字符串或存取控制表 (Access Control List, ACL) 必须括在双引号 (" ") 中。 默认值为: "@@o^a^r^g;@@o^c^wdeic^g; @^a^sf^g;@^c^^g;@^p^r^g" 有关 ACE 格式的详细信息,请参见服务配置。 |
-f filename |
用于为需要密码的选项(-y 参数)指定密码的文件名。如果从脚本运行 csuser,请在 filename 中指定密码,以增加安全性。 |
-g givenname |
用户的 LDAP 名。此选项是必需的。无默认值。 |
-h host |
指定用户日历所在的后端服务器的名称。此选项仅适用于 list 命令。 |
-p port |
LDAP 服务器正在侦听的端口号。默认值来自 ics.conf 文件中定义的 local.ugldapport 设置。 |
-k yes|no | |
-l [langcode] |
语言代码。默认值为 ics.conf 中 local.sitelanguage 的值。 |
-m email address |
指定用户的 LDAP mail 属性(主要电子邮件地址)。 |
-s surname |
用户的 LDAP 姓。此选项是必需的。无默认值。 |
-u adminDN |
有权管理 LDAP 服务器(存储用户验证信息)的用户的 LDAP 标识名 (Distinguished Name, DN)。默认值来自 ics.conf 文件中定义的配置设置 local.enduseradmindn。 |
-w password |
由 -u 选项指定的 LDAP 管理员 DN 的密码。 默认值来自 ics.conf 文件中定义的配置设置 local.enduseradmincred。如果使用 -u 选项,则该选项是必需的。 |
-y userpassword |
所需的日历用户的密码。无默认值。 |
检查是否已允许日历用户 jsmith@sesta.com 执行日历操作(即,检查此现有日历用户是否有权访问该 Calendar Server 的日历数据):
csuser check jsmith@sesta.com
创建一个 LDAP 用户,其用户 ID 为 jsmith@sesta.com,给定的名为 John,姓为 Smith,电子邮件地址为 jsmith@sesta.com,域为 sesta.com:
csuser -g John -s Smith -y password -m jsmith@sesta.com create jsmith@sesta.com -d sesta.com
删除日历用户 jsmith@sesta.com
csuser delete jsmith@sesta.com
禁止日历用户 jsmith@sesta.com 登录 Calendar Server:
csuser disable jsmith@sesta.com
此命令将阻止 jsmith@sesta.com 登录 Calendar Server 以访问日历数据,但并未将 jsmith 的数据从日历数据库中删除。如果 jsmith 当前已经登录 Calendar Server,他将一直拥有对日历数据的访问权,直到注销。
允许 jsmith@sesta.com 执行日历操作(即,允许现有日历用户登录 Calendar Server):
csuser enable jsmith@sesta.com
列出 jsmith@sesta.com 的所有日历属性:
csuser -v list jsmith@sesta.com
列出前缀为字符串 user 的所有日历用户 ID 的日历属性:
csuser -v list "user*"
将 jsmith@sesta.com 的所有日历属性重置为默认配置设置:
csuser reset jsmith@sesta.com
列出后端服务器 sesta 上 tchang 的所有日历属性:
csuser -v -h sesta list tchang
start-cal 实用程序用于按照以下顺序启动 Calendar Server 服务:
enpd—事件通知服务 (Event Notification Service, ENS)
csnotifyd—通知服务
csadmind—管理服务
csdwpd—数据库有线协议 (Database Wire Protocol, DWP) 服务,它是只能通过远程 Calendar Server 数据库配置启动的分布式数据库服务
cshttpd—HTTP 服务
必须在已安装 Calendar Server 的本地计算机上运行 start-cal。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
start-cal |
cal_svr_base/SUNWics5/cal/sbin/start-cal
有关更多信息,请参见启动和停止 Calendar Server。
stop-cal 实用程序用于停止所有 Calendar Server 服务。
必须在已安装 Calendar Server 的本地计算机上运行 stop-cal。
必须以安装过程中指定的运行 Calendar Server 的用户和组(例如 icsuser 和 icsgroup)身份登录,或以 root 身份登录。
stop-cal |
cal_svr_base/SUNWics5/cal/sbin/stop-cal
有关更多信息,请参见启动和停止 Calendar Server。
Calendar Server 配置参数存储在配置文件 ics.conf 和 counter.conf 中。
本章提供了以下信息:
Calendar Server 配置参数存储在以下文件中:
/etc/opt/SUNWics5/config/ics.conf
ics.conf 文件是一个 ASCII 文本文件,其中的每一行定义一个参数以及该参数的相关值。所有参数都在安装 Calendar Server 过程中进行初始化。安装后,可以使用文本编辑器编辑该文件。
要修改 ics.conf 文件中的参数设置,必须按照 Sun 文档中介绍的方法或在用户支持代表的指导下进行。
例如:没有为 Calendar Server 启用远程管理。请勿更改 service.admin.port 参数,因为该参数已被设置为 Calendar Server 所需的值。否则,csadmind 进程可能无法正常运行。
以具备管理权限的用户身份登录正在运行 Calendar Server 的系统。
转到 ics.conf 文件所在的 /etc/opt/SUNWics5/config 目录。
使用文本编辑器(例如 vi)编辑 ics.conf 文件中的参数。以下为参数约定:
所有参数都只能用小写表示。
必须用等号 (=) 分隔参数及其相关值,但等号前后可以有空格或制表符。例如:
service.http.idletimeout = "120"
每个参数值都必须包括在双引号 (" ") 中。如果一个参数允许多个值,则整个值字符串都必须括在双引号中。例如:
calstore.calendar.owner.acl= "@@o^a^rsf^g;@@o^c^wdeic^g"
每个注释行都以感叹号 (!) 开头。注释行仅用于提示性目的,运行时将被 Calendar Server 忽略。
有些参数作为注释发布,它们以一个或两个感叹号(! 或 !!)开头。要使用这种类型的参数,必须删除其前的感叹号并为其提供一个值(如果需要),然后重新启动 Calendar Server 以使此参数生效。
例如,要使用 !!caldb.dwp.server.[hostname].ip,必须删除感叹号 (!!),为 hostname 提供一个值,然后重新启动 Calendar Server。
如果某个参数不在 ics.conf 文件中,则将该参数及其相关值添加到该文件中。
如果一个参数出现多次,则最后列出的那个参数值将覆盖前面的值。
所有选项必须在行的开头处启动。
更改 ics.conf 文件中的参数后,需要停止并重新启动 Calendar Server 才能使新配置值生效。
如果需要,也可以在编辑 ics.conf 文件之前停止 Calendar Server。有关更多信息,请参见启动和停止 Calendar Server。
ics.conf 文件中的配置参数包括:
下表显示了本地配置参数以及每个参数的默认值和说明。
表 E–1 ics.conf 文件中的本地配置参数
参数 |
默认值 |
说明 |
---|---|---|
"yes" |
启用 ("yes") 或禁用 ("no") Calendar Server 的自动置备用户功能。 |
|
" " |
LDAP 验证的基本 DN。如果不指定,则使用 local.ugldapbasedn。 |
|
"localhost" |
LDAP 验证的主机。如果不指定,则使用 local.ugldaphost。 |
|
" " |
在 local.authldapbinddn 中指定的用户的绑定证书(密码)。 |
|
" " |
用来绑定 LDAP 验证主机以搜索用户 DN 的 DN。如果不指定或为 " ",则进行匿名绑定。 |
|
"389" |
LDAP 验证的端口。如果不指定,则使用 local.ugldapport。 |
|
"1" |
为 LDAP 验证维护的最小 LDAP 客户端连接数目。如果不指定,则使用 local.ugldappoolsize。 |
|
"1024" |
为 LDAP 验证维护的最大 LDAP 客户端连接数目。如果不指定,则使用 local.ugldapmaxpool。 |
|
"3" |
指定在参与者查找搜索中使用通配符搜索的最小字符串大小。零 (0) 表示总是进行通配符搜索。 |
|
"no" |
定期检查 Berkeley 数据库是否处于死锁状态,如果是,则指示该数据库重置。 |
|
"en" |
域的语言。 |
|
" " |
LDAP 用户首选项验证的绑定证书(密码)。 |
|
" " |
用来绑定 LDAP 用户首选项主机的 DN。必须指定。如果为 " "(不指定),则假定为匿名绑定。 |
|
" " |
已经安装 Calendar Server 的计算机的主机名。 |
|
"cal_svr_base/SUNWics5 /cal" |
Calendar Server 的安装目录路径位置。 |
|
"cal_svr_base/SUNWics5/ cal" |
此 Calendar Server 实例的程序和数据的安装目录路径位置。 |
|
local.instance.lockdir.path |
"cal_svr_base/SUNWics5/ cal/lib/lock" |
指定存储此服务器实例的锁定文件的位置。 |
"/etc/opt/SUNWics5/ config" |
指定存储此服务器实例的 PID 文件的位置。 |
|
"cal_svr_base/SUNWics5/cal/ lib/counter" |
指定存储此服务器实例的计数器文件的位置。 |
|
" " |
此 Calendar Server 实例的 CSAPI 插件的安装目录路径位置。 |
|
"n" | ||
"icsgroup" | ||
"icsuser" | ||
"en" |
此 Calendar Server 实例的默认语言。 |
|
" " |
用来查找与某个电子邮件地址相对应的参与者日历 ID 的默认域名。例如,如果此设置的值为 "sesta.com",则 jsmith 被解析为 jsmith@sesta.com。 |
|
"en" |
此 Calendar Server 实例支持的用户语言。 |
|
" " |
LDAP 用户首选项的基本 DN。必须指定且不能为空。 |
|
"localhost" |
存储 LDAP 用户首选项的计算机的主机名。 |
|
"ceColorSet, ceFontFace, ceFontSizeDelta, ceDateOrder, ceDateSeparator, ceClock, ceDayHead, ceDayTail, ceInterval, ceToolText, ceToolImage, ceDefaultAlarmStart, ceSingleCalendarTZID, ceAllCalendarTZIDs, ceDefaultAlarmEmail, ceNotifyEmail, ceNotifyEnable, ceDefaultView, ceExcludeSatSun, ceGroupInviteAll" |
icsExtendedUserPrefs 属性中选项的值。 |
|
"389" |
存储 LDAP 用户首选项的计算机的端口号。 |
|
"1" |
为 LDAP 用户首选项维护的最小 LDAP 客户端连接数目。 |
|
"1024" |
为 LDAP 用户首选项维护的最大 LDAP 客户端连接数目。 |
|
local.user.authfilter |
"uid=%u’" |
用于用户查找的过滤器。 |
下表显示了日历存储配置参数以及每个参数的默认值和说明。
表 E–2 ics.conf 文件中的日历存储配置参数
参数 |
默认值 |
说明 |
---|---|---|
"anonymous" |
用于匿名登录的日历 ID (calid)。 |
|
"yes" |
确定创建日历时是否允许为用户日历的同一时段预定多个事件:
|
|
"@@o^a^r^g; @@o^c^wdeic^g; @^a^fs^g; @^c^^g; @^p^r^g" |
指定用户创建日历时使用的默认访问控制权限。其格式由一个以分号分隔的访问控制条目 (ACE) 变量字符串列表指定。 有关 ACE 格式的详细信息,请参见日历访问控制。 要使用命令行实用程序指定一个或多个日历的访问控制条目,请参见cscal。 |
|
"@@o^a^rsf^g; @@o^c^wdeic^g" |
指定日历属主的默认访问控制设置。 |
|
calstore.calendar.create. lowercase |
"no" |
指定在创建新日历或使用 LDAP CLD 插件查找日历时,Calendar Server 是否应将日历 ID (calid) 转换为小写。 |
"America/ New_York" |
在以下情况下将要使用的时区 ID:
|
|
"yes" |
指定 Calendar Server 是否过滤(识别)“私人”和“仅时间与日期(保密)”事件和任务。如果指定为 "no",Calendar Server 会将它们与“公用”事件和任务一样处理。 |
|
defaultcalendar |
"yes" |
指定是否在用户的空闲/繁忙日历列表中包括用户的默认日历。 |
defaultcalendar |
"no" |
指定是否可以从用户的空闲/繁忙日历列表中删除用户的默认日历。 |
"0" |
展开事件时,一个 LDAP 组中允许的最大参与者数目。值为 "0" 时表示完全展开组。 |
|
"60" |
周期性扩展可以创建的最大事件数目。 |
|
defaultcalendar |
"yes" |
指定是否在用户的预定日历列表中包括用户的默认日历。 |
defaultcalendar |
"no" |
指定是否可以从用户的预定日历列表中删除用户的默认日历。 |
"200" |
从用户搜索的 LDAP 查找中返回的最大结果数目。值为 "0" 时表示没有限制。 |
|
fmt1.type |
"uid" |
指定在执行事件参与者的目录查找时,Calendar Server 如何处理字符串,例如 jdoe 或 jdoe:tv。允许的值有:uid、cn、gid、res、mailto 和 cap。 |
fmt2.type |
"mailto" |
指定在执行事件参与者的目录查找时,Calendar Server 如何处理带 @ 符号的字符串,例如 jdoe@sesta.com。允许的值有:uid、cn、gid、res、mailto 和 cap。 |
fmt3.type |
"cn" |
指定在执行事件参与者的目录查找时,Calendar Server 如何处理带空格的字符串,例如 john doe。允许的值有:uid、cn、gid、res 和 cap。 |
"." |
存储日历信息的主磁盘分区的位置。 |
下表显示了日历日志配置参数以及每个参数的默认值和说明。
表 E–3 ics.conf 文件中的日历日志配置参数
参数 |
默认值 |
说明 |
---|---|---|
"admin.log" |
日历管理工具的日志文件的名称。 |
|
"0" |
日志缓冲区的大小(以字节为单位)。 |
|
"dwp.log" |
与日志数据库有线协议相关的管理工具的日志文件的名称。 |
|
"604800" |
日志文件过期前的秒数。 |
|
"60" |
刷新缓冲区至日志文件的间隔秒数。 |
|
"http.log" |
cshttpd 服务的当前日志文件的名称。 |
|
"httpd.access" |
当前 HTTP 访问日志文件的名称。 |
|
"logs" |
日志文件的目录位置。 |
|
"NOTICE" |
决定服务器记录细节的级别。每个日志条目被指定以下级别之一:CRITICAL、ALERT、ERROR、WARNING、NOTICE、INFORMATION 和 DEBUG。 |
|
"10" |
日志目录中的日志文件的最大数目。 |
|
"2097152" |
每个日志文件的最大大小(以字节为单位)。 |
|
"20971520" |
所有日志文件的最大磁盘空间(以字节为单位)。 |
|
"5242880" |
必须为日志预留的最小可用磁盘空间(以字节为单位)。 |
|
"notify.log" |
csnotifyd 服务的日志文件名。 |
|
"86400" |
旋转日志文件前的秒数。 |
下表列出了属于管理员的 ics.conf 参数。
表 E–4 管理员配置参数
参数 |
默认值 |
说明 |
---|---|---|
cred |
" " |
指定作为 Calendar Server 管理员的用户 ID 的密码。必须在安装过程中为安装程序提供此值。 |
userid |
"calmaster" |
指定作为 Calendar Server 管理员的用户的用户 ID。必须在安装过程中为安装程序提供此值。 |
overrides.accesscontrol |
"no" |
指定 Calendar Server 管理员是否可以覆盖访问控制。 |
service.admin.calmaster .wcap.allowgetmodify userprefs |
"no" |
指定 Calendar Server 管理员是否可以使用 WCAP 命令获得并设定用户首选项。 |
"yes" |
如果设置为 "yes",则为 service.admin.calmaster.userid 中指定的用户启用用户验证 LDAP。 |
下表显示了各种服务配置参数以及每个参数的默认值和说明。
表 E–5 ics.conf 文件中的服务配置参数
参数 |
默认值 |
说明 |
---|---|---|
"yes" |
启用 ("yes") 或禁用 ("no") 管理工具的报警通知。 |
|
"yes" |
如果设置为 "yes",则启动 csadmind 数据库检查点线程。 |
|
"8388608" |
Berkeley 数据库用于管理会话的最大缓存大小(以字节为单位)。 |
|
"yes" |
如果设置为 "yes",则启动 csadmind 数据库死锁检测线程。 |
|
"no" |
如果设置为 "yes",则启动 csadmind 低磁盘空间监视线程。 |
|
"yes" |
如果设置为 "yes",则在启动所有服务时启动 csadmind 服务,并在停止所有服务时停止 csadmind。 |
|
"120" |
csadmind 中的 HTTP 连接超时前的秒数。 |
|
"100" |
允许的管理会话的最大数目。 |
|
"10" |
每个管理会话正在运行的线程的最大数目。 |
|
无 |
允许的最大并行管理进程数目。 |
|
service.admin.port **警告** |
无 |
由系统设置。请勿更改。 |
"900" |
管理连接超时前的秒数。 |
|
"no" |
如果设置为 "yes",则启动 csadmind 服务响应线程。 |
|
" " |
管理会话请求的临时目录。 |
|
"1800" |
csadmind 中的 HTTP 会话超时前的秒数。 |
|
"2" |
两次检查已启动、已停止或已就绪的日历服务中间等待的秒数。 |
|
"300" |
启动日历服务前等待的秒数。 |
|
"300" |
停止日历服务前等待的秒数。 |
|
"60" |
两次向任意日历服务发送停止命令中间等待的秒数。 |
|
"o=internet" |
目录中 DC 树的根后缀。 |
|
"no" |
如果设置为 "yes",则在允许 HTTP 访问时根据 DNS 检查客户端 IP 地址。 |
|
"0" |
成功使用纯文本密码验证用户后所延迟的秒数。 |
|
"calmaster" |
对此 Calendar Server 具有管理权限的用户 ID 列表,ID 之间用空格分隔。 |
|
"no" |
如果设置为 "yes",则允许通过代理登录。 |
|
"yes" |
如果设置为 "yes",则允许匿名(无验证)访问。这是一种仅允许进行指定的、受限的访问(通常是对公共日历进行只读访问)的特殊登录类型。 |
|
""(空) |
用于检索 HTML 文档的 HTTP 主机。 |
|
"yes" | ||
"8388608" |
Berkeley 数据库用于 HTTP 会话的最大缓存大小。 |
|
""(空) |
如果指定,且不为 "",则过滤以允许基于 TCP 域的访问。例如,"ALL:LOCAL.sesta.com" 将允许 sesta.com 域中的任何人进行本地 HTTP 访问。过滤器之间用 CR-LF(换行)分隔。 |
|
""(空) |
如果指定,且不为 " ",则过滤以禁止基于 TCP 域的访问。例如,"ALL:LOCAL.sesta.com" 将拒绝 sesta.com 域中的任何人进行 HTTP 访问。过滤器之间必须用 CR-LF(换行)分隔。 |
|
"." |
临时存储导入文件的目录位置,与 local.queuedir(或指定的绝对路径)相对。 |
|
"yes" |
如果设置为 "yes",则引用现存会话的所有请求都被认为来自同一个 IP 地址。 |
|
"yes" |
如果设置为 "yes",则在启动所有服务时启动 cshttpd 服务,并在停止所有服务时停止 cshttpd。 |
|
"120" |
HTTP 连接超时前的秒数。 |
|
"yes" |
如果设置为 "yes",则创建并维护验证和用户首选项的 LDAP 连接。 |
|
"INADDR_ANY" |
指定 HTTP 服务用于侦听客户机请求的 TCP 地址。"INADDR_ANY" 表示任一地址。 |
|
"no" |
如果设置为 "yes",则完全记录服务器的 HTTP 连接。 |
|
"5000" |
cshttpd 服务中 HTTP 会话的最大数目。 |
|
"20" |
cshttpd 服务中对服务 HTTP 请求的最大线程数。 |
|
"1" |
在一台服务器上允许并行运行 HTTP 服务 (cshttpd) 进程的最大数目。 有关具有多个 CPU 的服务器的信息,请参见在多个 CPU 中使用负载平衡。 |
|
"80" |
来自 Calendar Server 用户的 HTTP 请求的端口。 |
|
"" |
如果指定,且不为 "",则过滤以允许基于 TCP 域的代理登录。它与 service.http.domainallowed 具有相同的语法。 |
|
"900" |
HTTP 会话超时前的秒数。 |
|
"http" |
HTTP 会话的临时目录。 |
|
"1800" |
cshttpd 服务中的 HTTP 会话超时前的秒数。 |
|
" " |
用于存储文件的所有 URL 引用的目录,与可执行文件相对。 |
|
service.http.tmpdir |
用于存储文件的所有 URL 引用的目录,与可执行文件相对。 默认值为:"/var/opt/SUNWics5/tmp" |
|
"html" |
包含默认日历客户端的目录。如果仅允许 WCAP 访问,则设置为 ""。 |
|
"no" |
如果设置为 "yes",则使用 LDAP SDK 中的缓存。 |
|
"30" |
如果 service.ldapmemcache 的值为 "yes",则将此值传递给 LDAP SDK。这是一个条目所允许的最大缓存秒数。如果设置为 0,则条目的缓存时间没有限制。 |
|
"131072" |
如果 service.ldapmemcache 的值为 "yes",则将此值传递给 LDAP SDK。这是缓存将消耗的最大内存量(以字节为单位)。如果设置为 0,则缓存没有大小限制。 |
|
.allowpubliccalendarwrite |
"yes" |
如果设置为 "yes",则允许匿名用户写入可写入的公共日历。 |
"text/calendar" |
指定当前仅应用于空闲/繁忙的默认命令输出格式。 |
|
"30" |
指定 get_freebusy 与当前时间的默认偏移(以天数为单位)的开始范围。 |
|
"30" |
指定 get_freebusy 与当前时间的默认偏移(以天数为单位)的结束范围。 |
|
service.wcap.freebusy.redirecturl |
"" |
用于迁移目的,当迁移只是被部分完成并且日历在原始数据库和 Calendar Server 目标数据库之间被分隔时使用。在 Calendar Server 数据库中没有找到日历的情况下,要在其中查找日历的原始数据库的 URL。 |
"yes" |
如果设置为 "yes",则允许创建日历。 |
|
"yes" |
如果设置为 "yes",则允许删除日历。 |
|
"no" |
如果设置为 "yes",则允许用户通过此服务器更改密码。 |
|
allowpublicwritablecalendars |
"yes" |
如果设置为 "yes",则允许用户拥有可写入的公共日历。 |
"no" |
如果设置为 "yes",则允许使用 set_userprefs.wcap 属性修改用户首选项中的 "cn"(LDAP 用户的通用名称)。 |
|
"no" |
如果设置为 "yes",则允许使用 set_userprefs.wcap 属性修改用户首选项中的 "givenname"(LDAP 用户的名字)。 |
|
"no" |
如果设置为 "yes",则允许使用 set_userprefs.wcap 属性修改用户首选项中的 "icsCalendar"(用户的默认日历标识符)。 |
|
"no" |
如果设置为 "yes",则允许使用 set_userprefs.wcap 属性修改用户首选项中的 "mail"(用户的电子邮件地址)。 |
|
.preferredlanguage |
"no" |
如果设置为 "yes",则允许使用 set_userprefs.wcap 属性修改用户首选项中的 "preferredlanguage"(LDAP 用户的首选语言)。 |
"no" |
如果设置为 "yes",则允许使用 set_userprefs.wcap 属性修改用户首选项中的 "sn"(LDAP 用户的姓氏)。 |
|
"no" |
如果设置为 "yes",则允许使用 set_userprefs.wcap 属性修改用户首选项中的 "nswccalid"(用户的默认日历 ID)。 |
|
"no" |
如果设置为 "yes",则默认用户日历初始设置为公用读/专用写。如果设置为 "no",则默认用户日历初始设置为专用读/专用写。 |
|
"no" |
如果设置为 "yes",则启用 get_userprefs.wcap 命令的 LDAP 代理验证。wcap command. 如果设置为 "no",则执行匿名的 LDAP 搜索。 |
|
"no" |
如果设置为 "yes",服务器必须验证以确保日历的每个属主都存在于目录中(通过 LDAP 或 CSAPI 兼容用户目录机制)。 |
|
"3.0" |
WCAP 版本。 |
下表显示了 ics.conf SSL 配置参数以及每个参数的默认值和说明。大多数的 SSL 参数使用默认值即可,但需要将其中两个参数从系统默认值更改为 SSL 值,如下所示:
service.http.ssl.usessl = "yes"
service.http.ssl.port.enable = "yes"
下表显示了 ics.conf 参数及其默认设置。请验证您的 ics.conf 参数是否具有适当的值:
表 E–6 SSL 配置参数
参数 |
默认值 |
说明 |
---|---|---|
"on" |
启用 SSL 的 RSA 算法加密族服务。 |
|
"internal" |
指定 RSA 算法加密族标记的位置。 |
|
"SampleSSLServerCert" |
指定 RSA 算法加密族的证书名称。 |
|
service.http.tmpdir |
"/var/opt/SUNWis5/ tmp" |
指定临时路径。 |
service.http.uidir.path |
"html" |
指定找到 UI 文件的目录。 |
"." |
指定 SSL 缓存的物理路径位置。 |
|
"10000" |
指定 SSL 缓存数据库的最大大小。 |
|
"no" |
对于 SSL 配置,请将此值更改为 "yes"。 指定 cshttpd 进程是否应使用 SSL 子系统。 |
|
"no" |
对于 SSL 配置,请将此值更改为 "yes"。 注 – 这并没有禁用 HTTP 进程侦听其端口。实际上没有任何方法可以禁用 HTTP,但是可以将其指定给其他非功能端口。 请不要设置 service.http.enable="no"。这也将禁用 HTTPS 进程。 |
|
"443" |
为侦听 Calendar Server 用户的 HTTPS 请求的 cshttpd 进程指定 SSL 端口号。 请勿将其设置为与 HTTP 所使用的默认端口号 ("80") 相同的端口号。 |
|
"yes" |
指定是否对整个会话加密。 |
|
"alias" |
指定 SSL 证书数据库的物理路径位置。 |
|
"password" |
指定 SSL 证书数据库的访问密码。 |
|
"https://localhost:443" |
指定原始源 URL 的 SSL 主机名和端口号。 |
|
"" |
指定 SSL2 的加密算法。 |
|
"0" |
指定 SSL2 的会话超时时间。 |
|
"rsa_rc4_40_md5, rsa_rc2_40_md5, rsa_des_sha, rsa_rc4_128_md5, rsa_3des_sha" |
指定支持的或有效的 SSL 加密算法的列表。 |
|
sessiontimeout |
"0" |
指定 SSL 会话的超时值。 |
下表显示了托管(虚拟)域配置参数以及每个参数的默认值和说明。
表 E–7 托管域支持的配置参数
参数 |
默认值 |
说明 |
---|---|---|
support |
"n" |
启用 ("y") 或禁用 ("n") 对托管(虚拟)域的支持。 |
"1" |
指定 LDAP 模式的版本:
|
|
" " |
如果 local.schemaversion="1",则指定 LDAP 目录中 DC 树的根后缀。例如:"o=internet" |
|
service.schema2root |
" " |
如果 local.schemaversion="2",则指定包含所有域的根后缀。例如:"o=sesta.com" |
" " |
指定此 Calendar Server 实例的默认域。用于在登录过程中没有提供域名的情况。例如:"sesta.com"。 |
|
"@+" |
指定 Calendar Server 解析 userid[login-separator]domain 时用于 login-separator 的分隔符字符串。Calendar Server 将依次尝试每一个分隔符。 |
|
" " |
指定域管理员的用户 ID。 |
|
service.siteadmin.cred |
" " |
指定域管理员的密码。 |
下表显示了报警通知服务器配置参数以及每个参数的默认值和说明。
表 E–8 ics.conf 文件中的警报通知配置参数
参数 |
默认值 |
说明 |
---|---|---|
"percentage calendar partition disk space available" |
随“磁盘空间不足”消息一起发送的说明。 |
|
"3600" |
监视磁盘空间的时间间隔(以秒为单位)。 |
|
"10" |
发送警告消息时可用磁盘空间占总磁盘空间的百分比。 |
|
"-1" |
alarm.diskstat.msgalarmthreshold 是高于还是低于百分比。-1 表示低于,1 表示高于。 |
|
msgalarmwarninginterval |
"24" |
发送“磁盘空间不足”警告消息的时间间隔(以小时为单位)。 |
"localhost" |
用来发送服务器警报的 SMTP 服务器的主机名。 |
|
"25" |
用来发送服务器警报的 SMTP 端口。 |
|
"Postmaster @localhost" |
服务器警报收件人的电子邮件地址。 |
|
"Postmaster @localhost" |
服务器警报发件人的电子邮件地址。 |
|
alarm.msgalarmnoticetemplate |
"" |
电子邮件警报的默认格式: "From: %s\nTo: %s\nSubject: ALARM: %s of \"%s\" is n\n%s\n" |
msgalarmdescription |
"calendar service not responding" |
随“无服务响应”消息一起发送的说明。 |
msgalarmstatinterval |
"3600" |
监视服务的时间间隔(以秒为单位)。 |
msgalarmthreshold |
"100" |
如果无服务响应,则只发送警告消息。 |
msgalarmthresholddirection |
"-1" |
指定 alarm.responsestat. msgalarmthreshold 是高于还是低于阈值的百分比。 值为 -1 时表示低于,值为 1 时表示高于。 |
msgalarmwarninginterval |
"24" |
发送“无服务响应”警告消息的时间间隔(以小时为单位)。 |
下表显示了日历查找数据库 (Calendar Lookup Database, CLD) 参数以及每个参数的默认值和说明。
表 E–9 ics.conf 文件中日历查找数据库 (CLD) 参数
参数 |
默认值 |
说明 |
---|---|---|
"n" |
启用 ("y") 或禁用 ("n") 日历查找插件。 |
|
"*" |
指定要装入的特定日历查找插件的名称。如果此值为星号 ("*"),Calendar Server 将装入所有插件。 |
|
"local" |
指定要使用的 CLD 插件的类型: "local" 指定将所有日历存储在运行 Calendar Server 的本地服务器上,并且不装入任何插件。 "directory" 指定 LDAP CLD 插件,该插件使用日历属主的 icsDWPHost LDAP 属性来确定存储指定日历的服务器。 |
|
" " |
如果 LDAP 服务器数据库中的用户或资源日历条目没有 icsDWPHost 属性,则指定 Calendar Server 使用的全限定默认 DWP 服务器名。 如果通过 Communications Express 或使用 WCAP 命令登录 Calendar Server 的用户没有 icsDWPHost 属性,Calendar Server 将使用此参数自动置备此属性。 如果用户已经有一个 icsDWPHost 属性,则不使用 caldb.dwp.server.default。 此名称必须能够被域名服务 (DNS) 解析成有效的 IP 地址。 |
|
"yes" |
启用 ("yes") 或禁用 ("no") 日历查找数据库 (CLD) 高速缓存选项。要获得 LDAP CLD 插件的最佳性能,请将其设置为 "yes"。 |
|
"10" |
以兆字节为单位指定检查点文件的最大大小。 |
|
"4" |
以兆字节为单位指定共享内存的大小。 |
|
"1000" |
指定数据库线程的最大数目。 |
|
"." |
指定 CLD 缓存选项的数据库事件、任务和警报文件的位置。默认值 "." 指定将这些文件存储在 /var/opt/SUNWics5/csdb/cld_cache 目录中。 |
|
"60" |
指定检查点之间的秒数。 |
|
"yes" |
指定为 CLD 缓存选项同步检查点文件后是否将它们删除。 |
|
caldb.dwp.server.host-name.ip |
" " |
指定存储日历数据库的服务器的主机名。该服务器必须正在运行 DWP 服务 (csdwpd)。此名称必须能够被域名服务 (DNS) 解析成有效的 IP 地址。此参数由 LDAP CLD 插件使用。 备注:host-name 在参数的每个部分中都必须保持一致,并且是全限定名称。例如: caldb.dwp.server.sesta.com.ip="sesta.com" |
"1" |
服务器建立新的网络连接前待处理请求的最大数目。 |
|
"2" |
数据库有线协议服务客户端与每个数据库有线协议服务主机之间的初始连接数目。 |
|
"2" |
用于处理数据库有线协议服务请求的初始线程数。 |
|
"1000" |
允许使用数据库有线协议服务的最大服务器连接数目。 |
|
"20" |
允许使用数据库有线协议服务的最大服务器线程数目。 |
|
"n" |
指定服务器是否对所有数据库有线协议服务请求执行 MD5(消息摘要 5)单向散列检查。(单向散列功能用于为消息验证生成数字签名。)
|
|
" " |
为指定计算机主机名上使用数据库有线协议 (Database Wire Protocol, DWP) 服务的服务器指定 IP 地址。 |
|
"9779" |
为指定计算机主机名上使用数据库有线协议 (DWP) 服务的服务器指定端口号。 |
|
" " |
在前端服务器上,指定用来对到后端服务器的 DWP 连接进行验证的用户 ID。其中的 back-end-server 是服务器的名称。 |
|
" " |
在前端服务器上,指定用来对到后端服务器的 DWP 连接进行验证的密码。其中的 back-end-server 是服务器的名称。 |
|
"65536" |
数据库有线协议服务线程的堆栈大小。 |
|
在日历定位机制中使用 LDAP 插件时用于验证的基本 DN。 |
||
在日历定位机制中使用 LDAP 插件时要访问的 LDAP 服务器的主机名。 |
||
在日历定位机制中使用 LDAP 插件时,在 local.authldapbinddn 设置中指定的用户的绑定证书(密码)。 |
||
在日历定位机制中使用 LDAP 插件时,用于绑定验证以搜索用户 DN 的 DN。 |
||
"389" |
在日历定位机制中使用 LDAP 插件时,要访问的 LDAP 服务器的端口号。 |
|
"n" |
如果设置为 "y",将只装入在 csapi.plugin.authentication.name 中指定的插件,或者如果不指定,则按字母顺序装入所有验证类插件。验证时,将按字母顺序依次使用每个插件。 |
|
" " |
如果 csapi.plugin.loadall 的值为 "n" 而 csapi.plugin.authentication 的值为 "y",则只装入此特定插件。如果不指定或为空白 (" "),则装入所有验证类插件。 |
|
"0" |
数据库有线协议服务日志缓冲区的大小(以字节为单位)。 |
|
"604800" |
数据库有线协议服务日志文件过期前的秒数。 |
|
"60" |
对数据库有线协议服务日志文件进行缓冲区刷新之间的间隔秒数。 |
|
"logs" |
数据库有线协议服务日志文件的目录位置。 |
|
"Notice" |
决定服务器记录数据库有线协议服务细节的级别。每个数据库有线协议日志条目被指定以下级别之一(从最严重的级别开始):Critical、Error、Warning、Notice、Information 和 Debug。如果将此首选项设置为 Critical,服务器将记录最少的细节。如果希望服务器记录最多的细节,请指定 Debug。例如,如果指定 Warning,将只记录 Critical、Error 和 Warning 级别的日志条目。 |
|
"10" |
日志目录中数据库有线协议相关日志文件的最大数目。 |
|
"2097152" |
每个数据库有线协议日志文件的最大大小(以字节为单位)。 |
|
"20971520" |
所有数据库有线协议日志文件的最大磁盘空间(以字节为单位)。 |
|
"5242880" |
记录数据库有线协议服务活动所必需的最小可用磁盘空间(以字节为单位)。达到此值后,服务器将通过使旧日志文件过期来释放磁盘空间。如果没有可以释放的空间,所有记录操作都将暂停。 |
|
"86400" |
数据库有线协议服务日志文件旋转前的秒数。 |
|
" " |
在后端服务器上,指定用来验证 DWP 连接的用户 ID。此参数为可选参数。如果后端服务器不指定用户 ID,则不执行验证。 |
|
" " |
在后端服务上,指定用来对 DWP 连接进行验证的密码。此参数为可选参数。如果后端服务器不指定密码,则不执行验证。 |
|
"localhost" |
运行数据库有线协议服务的计算机的主机名。 |
|
"1000" |
并行运行的数据库有线协议服务线程的最大数目。 |
|
"1" |
一台服务器上允许并行运行数据库有线协议 (DWP) 服务 (csdwpd) 进程的最大数目。 有关具有多个 CPU 的服务器的信息,请参见在多个 CPU 中使用负载平衡。 |
|
"no" |
如果设置为 "yes",则在启动所有服务时启动 csdwpd 服务,并在停止所有服务时停止 csdwpd。 |
|
"86400" |
关闭空闲数据库有线协议服务持久性连接之前的秒数。 |
|
"59779" |
数据库有线协议服务侦听的端口号。此值为 LDAP CLD 插件的默认端口。 |
|
"yes" |
启用 ("yes") 或禁用 ("no") 数据库有线协议 (csdwpd) 服务的远程用户验证的 LDAP。 |
|
service.calendarsearch.ldap |
"yes" |
指定 Calendar Server 是先搜索 LDAP 目录,然后搜索日历数据库 ("yes") 还是只搜索日历数据库 ("no")。 |
下表介绍了 ics.conf 文件中有关 LDAP 数据高速缓存的配置参数。
表 E–10 LDAP 数据高速缓存配置参数
参数 |
说明 |
---|---|
local.ldap.cache.enable |
启用 ("yes") 或禁用 ("no") LDAP 数据高速缓存。默认值为 "no"。 |
local.ldap.cache.checkpointinterval |
指定检查点线程休眠的秒数。默认时间为 "60" 秒。 |
local.ldap.cache.circularlogging |
指定是否要删除旧的高速缓存文件。默认值为 "yes"。 |
local.ldap.cache.homedir.path |
指定 LDAP 数据高速缓存数据库的物理位置。默认值为 /var/opt/SUNWics5/csdb/ldap_cache。 |
local.ldap.cache.logfilesizemb |
以兆字节为单位指定检查点文件的最大大小。默认值为 "10" 兆字节。 |
local.ldap.cache.maxthreads |
指定 LDAP 数据高速缓存数据库的最大线程数。默认值为 "1000"。 |
local.ldap.cache.mempoolsizemb |
以兆字节为单位指定共享内存的大小。默认值为 "4" 兆字节。 |
local.ldap.cache.entryttl |
以秒为单位指定 LDAP 数据高速缓存条目的生存时间 (TTL)。默认时间为 "3600" 秒(1 小时)。 |
local.ldap.cache.stat.enable |
指定是否将访问记录到 LDAP 数据高速缓存,以及是否在日志文件中记录统计信息。默认值为 "no"。 注意,此参数仅适用于调试模式。 |
local.ldap.cache.stat.interval |
以秒为单位指定每个统计报告写入日志文件的时间间隔。默认值为 "1800" 秒(30 分钟)。 |
local.ldap.cache.cleanup.interval |
以秒为单位指定清理数据库的时间间隔。默认值为 "1800" 秒(30 分钟)。 |
要配置资源日历,请使用在下表中找到的参数:
表 E–11 资源日历配置参数
参数 |
默认值 |
说明 |
---|---|---|
"no" |
确定在创建日历时,是否可以为资源(如会议室或音频视频设备)日历的同一时段预定多个事件: |
|
指定创建资源日历时使用的默认访问控制权限。 默认值为:"@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g" |
下表显示了使用 Access Manager 时的 SSO 配置参数以及每个参数的默认值和说明。
表 E–12 ics.conf 文件中的 SSO 配置参数(通过 Access Manager)
参数 |
默认值 |
说明 |
---|---|---|
local.calendar.sso.singlesignoff |
"yes" |
启用 ("yes") 或禁用 ("no") Calendar Server 的 SSO。 |
local.calendar.sso.amcookiename |
"iPlanetDirectoryPro" |
指定 Access Manager SSO Cookie 的名称。 |
local.calendar.sso.amnamingurl |
”http://AccessManager:port /amserver/namingservice” |
指定 Access Manager SSO 命名服务的 URL。 |
local.calendar.sso.amloglevel |
"3" |
指定 Access Manager SSO 的日志级别。取值范围从 1(静默)到 5(详细)。 |
local.calendar.sso.logname |
"am_sso.log" |
指定 Access Manager SSO API 日志文件名。 |
下表显示了使用通信服务器信任环技术时的 SSO 配置参数以及每个参数的默认值和说明。
表 E–13 ics.conf 文件中使用通信服务器信任环技术的 SSO 配置参数
参数 |
默认值 |
说明 |
---|---|---|
"ics50" |
用于此 Calendar Server 安装的唯一应用程序 ID。每个信任的应用程序也必须有一个唯一的应用程序 ID。例如:sso.appid="ics50" |
|
"ssogrp1" |
用于格式化 SSO Cookie 的前缀值。所有信任的应用程序必须使用相同的值,因为 Calendar Server 只能识别带有此前缀的 SSO Cookie。 应用程序前缀不能以连字符 (-) 结束,因为 Calendar Server 会在值后面添加一个连字符。例如: sso.appprefix="ssogrp1" |
|
为 sso.appid 指定的值的验证 URL。例如: "sso.ics50.url="http://siroe.com:80/ default.html" |
||
sso.appid.ip |
为 sso.appid 指定的值的 IP 地址。例如:sso.ics50.ip= "123.12.456.123" |
|
"." |
指定浏览器只将 Cookie 发送到指定域中的服务器。 值必须以句点 (.) 开头。例如: ".sesta.com" |
|
"1" |
启用或禁用 SSO:
|
|
"true" |
如果设置为 "true",当与 sso.appprefix 的值匹配的用户注销时,服务器将删除该用户的所有 SSO Cookie。如果设置为 "false",服务器将只删除其 SSO 用户 Cookie。 |
|
" " |
设置用作用户 SSO 验证一部分的域。 |
|
" " |
指定对等 SSO 主机的验证 URL 值。每个信任的对等 SSO 主机都需要一个参数。 appid 是包含可信 SSO Cookie 的对等 SSO 主机的应用程序 ID。对于 Calendar Server,appid 为 ics50。 verifyurl 标识可信对等主机的 URL,格式如下:"http://host:port/VerifySSO?"。VerifySSO 后面的问号 (?) 不能省略。 “host”表示主机的 URL,“port”表示主机的端口号。 例如,对于 sesta.com 上端口号为 8883 的 Calendar Server,则为: sso.ics50.url= "http://sesta.com:8883/VerifySSO?" |
下表显示了组计划引擎 (GSE) 配置参数以及每个参数的默认值和说明。
表 E–14 ics.conf 文件中的组计划引擎 (GSE) 配置参数
参数 |
默认值 |
说明 |
---|---|---|
"yes" |
指定是否启用或禁用自动刷新功能。如果启用自动刷新功能,当某个参与者回复事件组织者后,该参与者的回复状态信息将自动传递给该计划事件的其他参与者。
|
|
"3" |
指定服务器扫描计划队列中的传入作业之前等待的秒数。如果队列中的作业数目大于分配的最大线程数,最后一个线程始终会重新扫描作业队列。因此,此设置仅在作业数目少于分配的最大线程数时才有效。 增加该值可以减少服务器扫描作业队列的频率,改进总体性能。 |
|
"10" |
指定服务器处理计划队列时使用的最大并行线程数。每个线程处理队列中的一个作业。 |
|
"86400" |
指定服务器重新尝试完成组计划作业所需的最长时间(以秒为单位)。如果所用时间超过指定的最长时间,服务器将此作业按重试过期的情况处理,并报告此错误。 请注意,默认值为 86400 秒,即一天。 |
|
"300" |
指定服务重试以前失败的作业的频率(以秒为单位)。仅当出现网络错误时,服务器才会重试失败的作业。但服务器会将大多数网络错误作为致命错误而不是作为重试处理。 |
|
"65535" |
指定组计划线程的最大堆栈大小(以字节为单位)。 |
下表列出了用于配置数据库处理的 ics.conf 参数,并提供了每个参数的默认值和说明。
表 E–15 ics.conf 文件中的数据库配置参数
参数 |
默认值 |
说明 |
---|---|---|
"60" |
指定检查点数据库事务的时间间隔(以秒为单位)。 |
|
"yes" |
如果设置为 "yes",则在同步数据库检查点文件的事务后删除该文件。请勿将此参数设置为 "no",除非已启用自动备份。 |
|
"100" |
检查需要中断的数据库死锁的时间间隔(以毫秒为单位)。 |
|
"." |
存储数据库事件、任务和警报文件的目录(相对于可执行程序文件或指定的绝对路径)。默认值为 ".",它指定: /var/opt/SUNWics5/csdb |
|
"10" |
数据库检查点文件的最大字节数(以兆字节为单位)。 |
|
"10000" |
数据库环境必须准备容纳的最大线程数。 |
|
"4" |
数据库环境的共享内存(以兆字节为单位)。 |
|
" " |
用于管理数据库的用户或别名的电子邮件。 |
|
"yes" |
如果设置为 "yes",将计算数据库统计信息(读取、写入和删除)。 |
|
"100" |
可以拥有计数器的最大日历数目。可使用 cscal 命令行实用程序启用日历的计数器。 |
|
"en" |
指定 /etc/opt/SUNWics5/config 下包含用来格式化电子邮件通知的本地化版本文件的目录。 例如,"en" 指定英文本地化版本的目录,而 "fr" 指定法文本地化版本的目录。 |
|
"25" |
SMTP 主机的端口。 |
下表列出了自动备份进程 (csstored) 所使用的参数,提供了默认值(如果可用),并介绍了 ics.conf 参数。
表 E–16 自动备份进程所使用的 ics.conf 参数
参数 |
默认值 |
说明 |
---|---|---|
defaultstore.log |
日志文件名。 |
|
"." |
日志目录的路径。 |
|
caldb.berkeleydb.homedir.path |
无 |
动态数据库的路径。 |
caldb.berkeleydb.archive.path |
无 |
归档备份的路径。 |
caldb.berkeleydb.hotbackup.path |
无 |
热备份的路径。 |
caldb.berkeleydb.archive.enable |
"yes" |
启用/禁用自动归档备份。 |
caldb.berkeleydb.hotbackup.enable |
"yes" |
启用/禁用自动热备份。 |
caldb.berkeleydb.hotbackup.mindays |
"3" |
保留在磁盘上的热备份副本的最小数目。 |
caldb.berkeleydb.hotbackup. maxdays |
"7" |
保留在磁盘上的热备份副本的最大数目。 |
caldb.berkeleydb.hotbackup. threshold |
"70" |
触发清除旧的热备份副本时已用磁盘空间占总磁盘空间的百分比。 |
caldb.berkeleydb.archive.mindays |
"3" |
保留在磁盘上的归档备份副本的最小数目。 |
caldb.berkeleydb.archive.maxdays |
"7" |
保留在磁盘上的归档备份副本的最大数目。 |
caldb.berkeleydb.archive.threshold |
"70" |
触发清除旧的归档备份副本时已用磁盘空间占总磁盘空间的百分比。 |
caldb.berkeleydb.circularlogging |
"yes" |
启用/禁用对备份副本数和备份副本所占磁盘空间的管理。 |
caldb.berkeleydb.archive.interval |
"120" |
打开各个新事务日志之间的时间(以秒为单位)。 |
alarm.msgalarmnoticercpt |
"root@ localhost" |
管理员的电子邮件地址,在必要时使用它进行通知。 |
service.store.启用 (未包含在 ics.conf 文件中) |
"yes" |
使 csstored 可以由 start-cal 启动。如果要禁止 csstored 由 start-cal 启动,则必须将此参数添加到 ics.conf 文件中,并将其设置为 "no"。 |
下表介绍了用于配置日历数据库的各参数的参数、默认值以及说明。如果需要非默认值,则必须在 ics.conf 文件中进行设置。
表 E–17 用于 ENS 消息的日历数据库参数
参数 |
默认值 |
说明 |
---|---|---|
"enp:///ics/alarm" |
指定 ENS 消息的 URL。 |
|
"" |
指定警报数据的内容类型。有效值为 "text/xml" 或 "text/calendar"。 |
|
"no" |
创建日历时创建 ENS 消息。 |
|
"enp:///ics/ calendarcreate" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
删除日历时创建 ENS 消息。 |
|
"enp:///ics/ calendardelete" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
修改日历时创建 ENS 消息。 |
|
"enp:///ics/ calendarmodify" |
ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
创建事件时创建 ENS 消息。 |
|
"enp:///ics/ caleventcreate" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
修改事件时创建 ENS 消息。 |
|
"enp:///ics/ caleventmodify" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
删除事件时创建 ENS 消息。 |
|
"enp:///ics/ caleventdelete" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
创建待办事件时创建 ENS 消息。 |
|
"enp:///ics/ caltodocreate" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
修改待办事件时创建 ENS 消息。 |
|
"enp:///ics/ caltodomodify" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
|
"no" |
删除待办事件时创建 ENS 消息。 |
|
"enp:///ics/ caltododelete" |
指定 ENS 消息的 URL。 |
|
"text/xml" |
指定消息数据的内容类型:"text/xml"(默认值)或 "text/calendar"。 |
可将 Calendar Server 配置为使用外部通用服务,即事件通知服务 (ENS),该服务接受服务器级别的事件(可按特定的兴趣区域归类)报告,然后通知其他已注册的对某些事件感兴趣的服务器。Calendar Server 使用 ENS 发送和接收警报通知,包括日历事件和任务的创建、删除或修改以及常规操作警告和错误消息。
下表显示了 ics.conf 中的事件通知服务器 (ENS) 配置参数以及每个参数的默认值和说明。
表 E–18 ics.conf 文件中的事件通知服务 (ENS) 配置参数
参数 |
默认值 |
说明 |
---|---|---|
"yes" |
如果设置为 "yes",则在启动所有服务时启动 enpd 服务,并在停止所有服务时停止 enpd。 |
|
"localhost" |
运行 ENS 的计算机的主机名。 |
|
"57997" |
运行 ENS 的计算机的端口号。 |
|
"xenp" |
ENS 插件的名称。 |
|
"yes" |
如果设置为 "yes",则在启动所有服务时启动 csnotifyd 服务,并在停止所有服务时停止 csnotifyd。 |
|
"-1" |
csnotifyd 将连续重试且无法联系 ENS 的次数。 值为 "-1" 表示让报警线程无限期地重试。 |
|
"3" |
连接失败后 csnotifyd 尝试重新联系 ENS 之前等待的秒数。 |
|
"0" |
Calendar Server 在停止之前尝试联系 ENS 的总秒数。此设置类似于 caldb.serveralarms.maxretrytime 的设置,不同之处在于它仅应用于第一次启动报警线程时。成功启动报警线程后,将使用 caldb.serveralarms.maxretrytime。 值为 "0" 指示报警线程如果在启动时无法连接 ENS,则立即退出。 |
|
"0" |
可接受的值为:
|
|
"300" |
出现可恢复的警报发送错误后重试的时间(以秒为单位)。 |
|
"no" |
如果设置为 "yes",则在创建日历时使用以下格式创建事件通知服务消息: enp://ics/createcal?calid=cal |
|
"no" |
如果设置为 "yes",则在修改日历时使用以下格式创建事件通知服务消息: enp://ics/modifycal?calid=cal |
|
"no" |
如果设置为 "yes",则在删除日历时使用以下格式创建事件通知服务消息: enp://ics/deletecal?calid=cal |
|
"no" |
指定如何发布修改事件通知: |
|
"no" |
如果设置为 "yes",则在创建事件时创建 ENS 消息。 |
|
"no" |
如果设置为 "yes",则在删除事件时创建 ENS 消息。 |
|
"no" |
如果设置为 "yes",则在修改事件时创建 ENS 消息。 |
|
"no" |
指定 Calendar Server 是否在刷新事件时创建 ENS 消息。 |
|
"text/xml" |
指定刷新事件的消息数据的内容类型。有效值为 "text/xml" 或 "text/calendar"。 |
|
"enp:///ics/ caleventrefresh" |
指定刷新事件的 ENS 消息的 URL。 |
|
"no" |
指定 Calendar Server 是否应为回复事件创建 ENS 消息。 |
|
"text/xml" |
指定回复事件的消息数据的内容类型。有效值为 "text/xml" 或 "text/calendar"。 |
|
"enp:///ics /caleventreply" |
指定回复事件的 ENS 消息的 URL。 |
|
"no" |
如果设置为 "yes",则在创建待办事件(任务)时使用以下格式创建事件通知服务消息: enp://ics/createtodo? uid=uid&rid=rid |
|
"no" |
如果设置为 "yes",则在修改任务时使用以下格式创建事件通知服务消息: enp://ics/modifytodo? uid=uid&rid=rid |
|
"no" |
如果设置为 "yes",则在删除任务时将使用以下格式创建事件通知服务消息: enp://ics/deletetodo?uid=uid&rid=rid |
|
"10000" |
内存中 ENS 消息队列的初始大小。此队列存储除警报提醒通知以外的所有 ENS 消息。 |
|
"no" |
如果设置为 "yes",则在删除写入日历的计划请求时使用以下格式创建事件通知服务消息: enp://ics/schedreq?calid=cal &method=method&type={event|todo} &uid=uid&rid=rid |
|
"yes" |
如果设置为 "yes",则发送警报电子邮件。 |
|
"30" |
指定在发布报警通知后,ENS 报警线程等待 csnotifyd 确认的秒数。如果超时过期,报警线程将假定不再处理报警通知并再次发布报警通知。 |
|
"ens" |
指定 Calendar Server 警报的分发类型:
|
|
"10" |
服务器报警线程的初始数目。 |
|
"-1" |
报警线程将连续重试且无法联系 ENS 的次数。 "-1" 表示让报警线程无限期地重试。 |
|
"10" |
服务器报警线程的最大数目。 |
|
"5" |
报警线程(在 csadmind 中)在尝试重新联系 ENS 之前等待的秒数。 |
|
"65536" |
服务器报警线程的堆栈框架大小。 |
|
"0" |
Calendar Server 在失败之前尝试联系 ENS 的总秒数。此设置类似于 caldb.serveralarms.maxretrytime 的设置,不同之处在于它仅应用于第一次启动警报线程时。成功启动警报线程后,将使用 caldb.serveralarms.maxretrytime。 如果设置为 "0",则报警线程如果在启动时无法连接 ENS,将立即退出。 |
|
"localhost" |
将警报电子邮件发送到此 SMTP 主机。 |
下表显示了 Calendar Server API (CSAPI) 配置参数以及每个参数的默认值和说明。
表 E–19 ics.conf 文件中的 CSAPI 配置参数
参数 |
默认值 |
说明 |
---|---|---|
"n" |
如果值为 "y",则只装入在 csapi.plugin.authentication.name 中指定的插件。 |
|
"n" |
启用 ("y") 或禁用 ("n") 访问控制插件。 |
|
"n" |
如果值为 "y",则只装入在 csapi.plugin.authentication.name 中指定的插件。 如果值为 "n";或者如果不指定,则按字母顺序装入所有验证类插件。验证时,将按字母顺序依次使用每个插件。 |
|
name |
" " |
如果 csapi.plugin.loadall 的值为 "n" 且 csapi.plugin.authentication 的值为 "y",则只装入此特定插件。如果不指定或为空白 (" "),则装入所有验证类插件。 |
"y" |
如果设置为 "y",则只装入在 csapi.plugin.database.name 中指定的插件。 如果设置为 "n";或者如果不指定,则按字母顺序装入所有数据库插件。 |
|
"cs_caldb _berkeley10" |
如果 csapi.plugin.loadall 的值为 "n" 且 csapi.plugin.database 的值为 "y",则只装入此插件。如果不指定或为空白 (" "),则按字母顺序装入所有数据库插件。 |
|
"y" |
如果设置为 "y",将只装入在 csapi.plugin.datatranslator.name 中指定的插件;如果不指定,则按字母顺序装入所有数据转换器类插件。转换数据时,将按字母顺序依次使用每个插件。 |
|
name |
"cs_data translatorcsv10" |
如果 csapi.plugin.loadall 的值为 "n" 且 csapi.plugin.datatranslator 的值为 "y",则装入此特定插件。 如果为空白 (" "),或者不指定,则装入所有数据转换器类插件。 |
"y" |
启用 ("y") 或禁用 ("n") 数据库输出格式插件。 |
|
"*" |
如果 csapi.plugin.dbtranslator 的值为 "y",则:
如果 csapi.plugin.dbtranslator 的值为 "n",则忽略此设置。 |
|
"n" |
如果设置为 "y",则装入插件目录中的所有插件。(插件带有 .so 扩展名。) 如果设置为 "n",则只装入由相应参数标记的特定类插件。例如,如果将 csapi.plugin.authentication 设置为 "y",则装入验证类插件。 |
|
"n" |
如果设置为 "y",将只装入在 csapi.plugin.userprefs.name 中指定的插件;如果不指定,则按字母顺序装入所有用户首选项类插件。对于用户首选项,将按字母顺序依次使用每个插件。 |
|
" " |
如果 csapi.plugin.loadall 的值为 "n" 且 csapi.plugin.userprefs 的值为 "y",则使用此参数。如果不指定或为空白 (" "),则装入所有用户首选项类插件。否则,只装入此特定插件。 |
下表显示了 csmonitor 实用程序配置参数以及每个参数的默认值和说明。
表 E–20 ics.conf 文件中的 csmonitor 实用程序配置参数
参数 |
默认值 |
说明 |
---|---|---|
"0" |
指定 csmonitor 是否应持续循环: "0"—不持续循环。 "1"—持续循环。 此选项需要更多的系统资源,但在调试模式中非常有用。 |
|
"60" |
指定两次监视循环之间的延迟秒数。 |
|
无 |
指定 csmonitor 从中发送消息的电子邮件地址。 |
|
无 |
指定 csmonitor 向其发送消息的电子邮件地址。 |
|
service.monitor.csdb.logthreshold |
"90" |
以总磁盘空间百分比的形式指定一个阈值,该值代表被视为正常的最大磁盘空间占用率。如果日历数据库(csdb 目录)所在磁盘的占用率超过该值,csmonitor 将发送警告电子邮件消息。 |
"csmonitor.log" |
指定 csmonitor 日志文件的名称。 |
|
"2097152" |
指定日志文件的最大大小。如果日志文件超过此值,则 csmonitor 将日志另存为 csmonitor.log.timestamp,然后重置该日志。 |
|
"0" |
指定调试级别。值越高,csmonitor 发送的消息就越精确,越详细。 |
Calendar Server 计数器(统计信息)配置参数存储在以下文件中:
/etc/opt/SUNWics5/config/counter.conf
counter.conf 文件是一个 ASCII 文本文件,其中的每一行定义一个计数器以及该计数器的参数:名称、类型、大小(以字节为单位)和说明。带空格的参数必须括在双引号 (" ") 中。每个注释行都必须以感叹号 (!) 开头。注释行仅用于提示性目的。
计数器名称的第一部分标识与 csstats 实用程序一起使用的计数器对象。有关命令行实用程序的更多信息,请参见附录 D,Calendar Server 命令行实用程序参考。
如果没有用户支持工作人员的指导,请勿修改 counter.conf 文件。
本节介绍 Calendar Server counter.conf 参数,包括以下内容:
下表显示了每个报警计数器的名称、类型、大小和说明。
表 E–21 counter.conf 文件中的警报计数器
名称 |
类型 |
大小 |
说明 |
---|---|---|---|
计量器 |
4 |
过去记录的最高值。 |
|
计量器 |
4 |
过去记录的最低值。 |
|
计量器 |
4 |
当前监视的值。 |
|
计量器 |
4 |
警告状态:是 (1) 或否 (0)。 |
|
计数器 |
4 |
超出阈值的次数。 |
|
计数器 |
4 |
已发送警告的次数。 |
|
时间 |
4 |
上次设置当前值的时间。 |
|
时间 |
4 |
上次发送警告的时间。 |
|
时间 |
4 |
上次执行重置的时间。 |
|
时间 |
4 |
上次更改警告状态的时间。 |
下表显示了每个磁盘使用计数器的名称、类型、大小和说明。
表 E–22 counter.conf 文件中的磁盘使用计数器
名称 |
类型 |
大小 |
说明 |
---|---|---|---|
计量器 |
5 |
磁盘分区中总的可用空间。 |
|
时间 |
4 |
上次记录统计信息的时间。 |
|
字符串 |
512 |
日历分区路径。 |
|
计量器 |
4 |
磁盘分区可用空间的百分比。 |
|
计量器 |
5 |
磁盘分区的总空间。 |
下表显示了每个 HTTP 计数器的名称、类型、大小和说明。
表 E–23 counter.conf 文件中的 HTTP (httpstat) 计数器
名称 |
类型 |
大小 |
说明 |
---|---|---|---|
计量器 |
4 |
平均连接响应次数。 |
|
时间 |
4 |
启动 Calendar Server 的时间。 |
|
时间 |
4 |
上次接受新客户端连接的时间。 |
|
计数器 |
4 |
提供并行连接的最大数目。 |
|
计数器 |
4 |
提供的 WCAP 会话的最大数目。 |
|
计数器 |
4 |
提供的连接总数目。 |
|
计量器 |
4 |
当前活动连接的数目。 |
|
计量器 |
4 |
WCAP 会话的当前数目。 |
|
计数器 |
4 |
提供的失败连接的总数目。 |
|
计数器 |
4 |
当前 HTTP 服务器提供的成功登录的数目。 |
|
计数器 |
4 |
当前 HTTP 服务器提供的失败登录的数目。 |
下表显示了每个组计划引擎 (GSE) 计数器的名称、类型、大小和说明。
表 E–24 counter.conf 文件中的组计划引擎 (GSE) 计数器
名称 |
类型 |
大小 |
说明 |
---|---|---|---|
时间 |
4 |
上次 GSE 唤醒并处理作业的时间。 |
|
时间 |
4 |
上次 GSE 处理作业的时间。 |
|
计数器 |
4 |
GSE 已处理的作业总数目。 |
|
计数器 |
4 |
活动工作线程的总数目。 |
下表显示了每个验证计数器的名称、类型、大小和说明。
表 E–25 counter.conf 文件中的验证 (authstat) 计数器
名称 |
类型 |
大小 |
说明 |
---|---|---|---|
时间 |
4 |
上次用户登录的时间。 |
|
计数器 |
4 |
提供的成功登录的总数目。 |
|
计数器 |
4 |
提供的失败登录的总数目。 |
下表显示了每个 WCAP 计数器的名称、类型、大小和说明。
表 E–26 counter.conf 文件中的 WCAP (wcapstat) 计数器
名称 |
类型 |
大小 |
说明 |
---|---|---|---|
计数器 |
4 |
WCAP 请求的总数目。 |
下表显示了每个数据库计数器的名称、类型、大小和说明。
表 E–27 counter.conf 文件中的数据库 (dbstat) 计数器
名称 |
类型 |
大小 |
说明 |
---|---|---|---|
计数器 |
4 |
读取数据库的总次数。 |
|
计数器 |
4 |
写入数据库的总次数。 |
|
计数器 |
4 |
删除数据库的总次数。 |
|
时间 |
4 |
上次读取数据库的时间。 |
|
时间 |
4 |
上次写入数据库的时间。 |
|
时间 |
4 |
上次删除数据库的时间。 |
下表显示了每个服务器响应计数器的名称、类型、大小和说明。
表 E–28 counter.conf 文件中的服务器响应计数器
名称 |
类型 |
大小 |
刻度 |
说明 |
---|---|---|---|---|
时间 |
4 |
上次记录统计信息的时间。 |
||
计量器 |
4 |
2 |
服务器的响应时间(以毫秒为单位)。 |
下表显示了每个会话状态计数器的名称、类型、大小和说明。
表 E–29 counter.conf 文件中的会话状态计数器
名称 |
类型 |
大小 |
刻度 |
说明 |
---|---|---|---|---|
计数器 |
4 |
4 |
提供的 HTTP 会话的最大数目。 |
|
计量器 |
4 |
2 |
HTTP 会话的当前数目。 |
Calendar Server 邮件参数中介绍了 Calendar Server 发送的电子邮件消息类型。这些消息的格式由表中所列出的关联格式文件 (.fmt) 决定。这些格式文件位于每个语言环境的特定目录中(如英文为 /en,法文为 /fr),如下所示:
/etc/opt/SUNWics5/config
例如,任务(待办事件)警报消息格式的英文版在下面的文件中指定:
/etc/opt/SUNWics5/config/en/mail_todoalarm.fmt
本节包括以下内容:
下表显示了每个 Calendar Server 邮件参数的消息类型、参数名称、默认格式文件说明以及收件人。
表 E–30 ics.conf 文件中的 Calendar Server 电子邮件格式
消息类型 |
参数 |
格式文件(默认) |
说明 |
收件人 |
---|---|---|---|---|
发布事件 |
宣布事件或对现有事件的更改 |
在通知中列出的收件人 |
||
取消事件 |
宣布取消事件 |
在通知中列出的收件人 |
||
回复事件 |
mail_eventreply.fmt |
回复事件通知。 |
在通知中列出的收件人 |
|
请求事件 |
"mail_eventrequest.fmt" |
订阅事件通知。 |
在通知中列出的收件人 |
|
事件警报 |
即将举行的事件的提醒通知 |
在提醒通知中列出的收件人 |
||
重复性事件通知 |
"mail_eventnotificationrecur .fmt" |
通知重复性事件 |
在通知中列出的收件人 |
|
事件取消通知 |
"mail_eventcancel notification.fmt" |
通知取消的事件 |
在通知中列出的收件人 |
|
重复性事件取消通知 |
"mail_ eventcancelnotification recur.fmt" |
通知取消的重复性事件 |
在通知中列出的收件人 |
|
发布任务 |
宣布任务或对现有任务的更改 |
在通知中列出的收件人 |
||
取消任务 |
宣布取消任务 |
在通知中列出的收件人 |
||
回复任务 |
"mail_todoreply.fmt" |
回复任务通知 |
在通知中列出的收件人 |
|
待办事件请求 |
"mail_todorequest.fmt" |
订阅待办事件通知。 |
在通知中列出的收件人 |
|
任务警报 |
即将举行的任务的提醒通知 |
在提醒通知中列出的收件人 |
Calendar Server 通过将特定事件或任务与格式文件的内容合并起来生成通知消息。可以将事件或任务中的数据字段值输出到消息中。通知消息中也可以包括 MIME 标头行以及关联的特殊值。使用特殊字符序列(格式表示法),可以在消息中包括事件、任务和 MIME 标头的值。格式文件中的行都是由特殊字符序列组成的格式字符串,其中的字符序列会在生成邮件消息时替换为日历数据字段的实际值。特殊字符序列由两个字符组成,第一个字符是百分号 (%),第二个字符代表特定的格式表示法。
以下各节介绍特殊字符序列:
下表显示了事件通知的特殊字符序列的格式代码和含义。
表 E–31 事件通知的特殊字符序列
格式代码 |
含义 |
---|---|
%0 |
本地化格式的开始时间 |
%1 |
本地化格式的结束时间 |
%A |
iCalendar 格式中的 exdates(以分号分隔的 ISO 8601 日期字符串列表,列出要排除的日期) |
%a |
iCalendar 格式中的 rdates(以分号分隔的 ISO 8601 日期字符串列表,列出周期性日期) |
%B |
开始时间(请参见 %Z) |
%b |
以 iCalendar 格式输出开始时间和结束时间。如果开始时间的参数为 value=date,则只输出日期的 month/day/year 部分。如果结束时间和开始时间的 month/day/year 值相同,则仅生成开始时间。 |
%C |
创建时间 |
%c |
事件类 |
%d |
事件说明(请参见 %F) |
%E |
结束时间(请参见 %Z) |
%e |
iCalendar 格式中的例外规则 |
%F |
事件说明- - 换行/iCalendar 格式(请参见 %d) |
%G |
事件的地理位置(包括维度和经度) |
%g |
组织者的电子邮件地址。(不能保证此值的真实性。) |
%K |
以 mailto:url 形式表示的组织者的电子邮件url |
%k |
警报计数 |
%L |
地点 |
%l |
iCalendar 格式中的周期规则 |
%M |
修改时间 |
%N |
新行 |
%n |
与 DTSTAMP 一起使用的当前时间戳 |
%P |
优先级 |
%r |
周期 ID(如果此事件没有重复发生,则为空) |
%S |
事件序列号 |
%s |
汇总 |
%t |
事件状态 |
%U |
唯一事件标识符 |
%Z |
与时间字段代码一起使用,强制以 UTC 时间格式显示时间。(%B 以当地时间显示开始时间,而 %ZB 以 UTC 时间显示开始时间。) |
%% |
显示百分号 (%) |
%(子格式代码) |
指定由代码标识的数据的子格式。(有关详细信息,请参见日期的子格式。) |
可以多种不同的方法格式化日期时间值。使用子格式可以提供附加信息,以说明如何格式化日期时间值。如果不指定子格式,服务器将使用默认格式输出日期。使用子格式字段可以指定要使用的精确格式。
例如,%B 指定在输出字符串中包括事件的开始时间。此默认格式将打印日期、时间、时区以及有关该日期的其他可能的信息。日期值的子格式字符串是 strftime 格式的字符串(请参见日期的特殊字符序列)。如果只需要了解开始时间的年和月,请不要使用 %B,而应使用:%(%m %Y)B。
以下示例:
The event begins: %B%N The event ends: %(%b %d, %Y %I:%M %p)E%N |
生成与以下通知类似的输出:
The event begins Feb 02, 1999 23:30:00 GMT Standard Time The event ends Feb 03, 1999 02:30 AM |
title: %S%N start: %B%N end: %E%N |
生成与以下通知类似的输出:
title: Staff Meeting start: Feb 04, 1999 09:00:00 end: Feb 04, 1999 10:00:00 |
但如果以下两个条件成立,以上示例将生成易误解或不正确的结果:
如果该事件没有截止日期
如果该事件是一个“全天”事件,即开始时间和结束时间在同一天
在这些情况下,最好不要打印结束时间。默认情况下,如果时间戳的属性为 all-day,则只打印年、月和日。此外,如果事件的开始时间有一个 all-day 属性,且事件的结束日期和开始日期为同一天,则会设置一个特殊的条件标记。只应在没有设置特殊条件标记时使用 ? 修饰符打印条件值。
例如,如果将上述示例中的行更改为:
title: %S%N start: %B%N end: %?E%N |
则不会打印“全天”事件的最后一行,因为这种事件的开始日期与结束日期相同。为典型的“全天”事件(如生日或周年纪念日)生成的输出如下:
title: Staff Meeting start: Feb 04, 1999 |
? 标记可与其他修饰符结合使用。例如:
The event ends: %?(%b %d, %Y %I:%M %p)E%N
下表显示了任务通知的特殊字符序列的格式代码和含义。
表 E–32 任务通知的特殊字符序列
格式代码 |
含义 |
---|---|
%A |
iCalendar 格式中的 exdates(以分号分隔的 ISO 8601 日期字符串列表,列出要排除的日期) |
%a |
iCalendar 格式中的 rdates(以分号分隔的 ISO 8601 日期字符串列表,列出周期性日期) |
%B |
开始时间(另请参见 %Z) |
%C |
创建时间 |
%c |
任务类 |
%D |
到期日期和时间 |
%d |
任务说明(另请参见 %F) |
%E |
IMIP 格式的到期日期和时间 |
%e |
iCalendar 格式中的例外规则 |
%F |
任务说明—换行、iCalendar 格式(另请参见 %d) |
%G |
此任务的地理位置(包括维度和经度) |
%g |
组织者的电子邮件地址(不能保证此值的真实性) |
%K |
以 mailto:URL 形式表示的组织者的电子邮件 |
%k |
警报计数 |
%L |
位置 |
%l |
iCalendar 格式中的周期规则 |
%M |
修改时间 |
%N |
新行 |
%n |
"now"(当前时间戳,与 DTSTAMP 一起使用) |
%P |
优先级 |
%r |
周期 ID(如果此任务没有重复发生,则为空) |
%S |
是任务的序列号 |
%s |
摘要 |
%t |
状态 |
%U |
UID |
%Z |
与时间字段代码一起使用,强制以 UTC 时间格式显示时间(%B 以当地时间显示开始时间,而 %ZB 以 UTC 时间显示开始时间) |
%% |
显示 % 字符 |
%(子格式代码) |
指定由代码标识的数据的子格式(有关详细信息,请参见日期的子格式) |
下表显示了日期的特殊字符序列的格式代码和含义。
仅为方便起见,才在本节列出特殊的日期格式代码。Calendar Server 不会重新编写任何代码,只是使用操作系统实现。
格式代码 |
含义 |
---|---|
%a |
缩写的工作日名称 |
%A |
完整的工作日名称 |
%b |
缩写的月份名称 |
%B |
完整的月份名称 |
%c |
语言环境特定的日期和时间表示 |
%d |
以十进制数表示的月份中的日期 (01 - 31) |
%H |
以 24 小时格式表示的小时 (00 - 23) |
%I |
以 12 小时格式表示的小时 (01 - 12) |
%j |
以十进制数表示的一年中的日期 (001 - 366) |
%m |
以十进制数表示的月份 (01 - 12) |
%M |
以十进制数表示的分钟 (00 - 59) |
%p |
以 12 小时格式表示的当前语言环境的 A.M./P.M. 指示器 |
%S |
以十进制数表示的秒 (00 - 59) |
%U |
以十进制数表示的一年中的周,其中星期日作为一周的第一天 (00 - 53) |
%w |
以十进制数表示的工作日(0 - 6;星期日为 0) |
%W |
以十进制数表示的一年中的周,其中星期一作为一周的第一天 (00 - 53) |
%x |
当前语言环境的日期表示 |
%X |
当前语言环境的时间表示 |
%y |
以十进制数表示的不带世纪的年份 (00 - 99) |
%Y |
以十进制数表示的带世纪的年份 |
%Z |
时区名称或缩写,如果时区未知,则无字符 |
%% |
百分号 |
以下示例显示了默认事件提醒通知消息的格式:
1 事件提醒通知 2 ~~MIME 版本: 1.0%N 3 ~~内容类型: text/plain; charset=%s%N 4 ~~内容传输编码: %x%N%N 5 摘要: %s%N 6 开始时间: %(%a, %d %b %Y %I:%M %p)B%N 7 结束时间: (%a, %d %b %Y %I:%M %p)E%N 8 地点: %L%N%N 9 说明: %N%d%N |
本示例中每一行的说明如下:
第 1 行是消息主题。
第 2 行以 ~~ 开头,表明它是一个 MIME 包装行。也就是说,特殊字符序列的替换物与内部 MIME 对象关联,而不是与事件或任务关联。特殊序列 %N 表示换行。主题行不需要特殊的换行序列,而其他各行都需要。
第 3 行也是一个 MIME 标头行。它包含特殊字符序列 %s,该序列将被替换为与电子邮件中的事件或任务相关联的字符集。
第 4 行是最后一个 MIME 行,%x 是此消息所需的内容传输编码字符串。
第 5 行列出了事件摘要,事件摘要是用 %s 调出来的。
第 6 行列出了事件的开始时间。它利用特殊字符序列 %B 的子格式字符串。有关详细信息,请参见日期的子格式。
第 7 行列出了事件的结束时间。
第 8 行列出了事件的位置。
第 9 行列出了事件说明。
下面的样例与以上示例生成的通知消息类似:
自: jsmith@sesta.com (James Smith) 日期: 1999 年 11 月 15 日星期三 19:13:49 到: jsmith@sesta.com 主题: 时间提醒通知 MIME 版本: 1.0 内容类型: text/plain; charset=us-ascii 内容传输编码: 7 位 摘要: smtp_rig 事件 1 开始时间: 1999 年 11 月 16 日星期二 02:00 PM 结束时间: 1999 年 11 月 16 日星期二 03:00 PM 地点: 格林会议室 说明: 这是偶然生成的事件的说明。 |
以下示例显示了更复杂的、由多部分组成的消息。此示例包括一个文本部分和一个 IMIP PUBLISH 部分。
事件发布 ~~MIME 版本: 1.0%N ~~内容类型: multipart/mixed; boundary="%b"%N%N 这是 MIME 格式的多部分消息。%N ~~--%b%N ~~内容类型: text/plain; charset=%s%N ~~内容传输编码: %x%N%N 摘要: %s%N 开始时间: %(%a, %d %b %Y %I:%M %p)B%N 结束时间: %(%a, %d %b %Y %I:%M %p)E%N 地点: %L%N%N 说明: %N%d%N%N ~~--%b%N ~~内容类型: text/calendar; method=%m; component=%c; charset=%s%N ~~内容传输编码: %x%N%N 开始:VCALENDAR%N 时间长度:-//iPlanet/Calendar Hosting Server//EN%N 方法:PUBLISH%N 版本:2.0%N 开始:VEVENT%N 组织者:%K%N 时间戳:%Zn%N 开始时间:%ZB%N 结束时间:%ZE%N 摘要:%s%N UID:%U%N %R %A %a %e %l 序列:%S%N 地点:%L%N GEO:%G%N %F 状态:%t%N 结束:VEVENT%N 结束:VCALENDAR%N ~~--%b-- |