有关每个实用程序的简短说明,请参见命令行实用程序的简短说明。
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。