第 7 章   Calendar Server 命令行公用程序


Sun™ ONE Calendar Server 提供了一套命令行管理公用程序，您可从批处理文件、外壳程序以及诸如 Perl 这样的脚本语言调用这些公用程序。如有必要，这些公用程序会使用 ics.conf 配置文件中的默认值。

命令行公用程序位于 server-root/cal/bin 目录下。

本章提供下列信息：

• 运行命令行公用程序
  • 命令行公用程序语法

  • 命令行公用程序的使用规则

• 命令行公用程序的说明（表）

  csattribute	csresource
  csbackup	csrestore
  cscal	csschedule
  cscomponents	csstart
  csdb	csstats
  csexport	csstop
  csimport	cstool
  csplugin	csuser

运行命令行公用程序

---

在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（默认值是 icsuser 和 icsgroup）身份登录或以 root 身份登录，才能运行命令行公用程序。要在 Windows NT 系统上运行命令行公用程序，用户必须拥有全部的管理员权限。

多数情况下，必须定位到公用程序所在的目录 (server-root/cal/bin)。例如：

• 在 Solaris 上：

  /opt/SUNWics5/cal/bin

• 在 Solaris 以外的 UNIX 系统上：

  /opt/iPlanet/CalendarServer5/cal/bin

• 在 Windows NT 系统上：

  c:\Program Files\iPlanet\CalendarServer5\cal\bin

命令行公用程序语法

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 命令。

命令行公用程序的说明

---

下表说明 Calendar Server 命令行公用程序。

表 7-1    Calendar Server 命令行公用程序摘要 

公用程序	说明
csattribute	管理日历用户或资源的 LDAP 属性。
csbackup	备份个别日历、用户和日历数据库。
cscal	管理日历及其属性。
cscomponents	管理日历组件：事件和任务（待办事项）。
csdb	管理日历数据库。
csexport	以 iCalendar (.ics) 或 XML (.xml) 格式导出日历。
csimport	以 iCalendar (.ics) 或 XML (.xml) 格式导入日历。
csplugin	查看、启用或禁用配置的 Calendar Server API (CSAPI) 插件。
csresource	管理日历资源，如会议室和设备。
csrestore	还原个别日历、用户和日历数据库。
csschedule	管理组日程安排引擎 (GSE) 队列中的日程安排项。
csstart	启动 Calendar Server。
csstats	显示 Calendar Server 中的计数器。
csstop	停止 Calendar Server。
cstool	对正在运行的 Calendar Server 实例执行 ping 操作，或刷新 Calendar Server 的配置。
csuser	管理日历用户。

 

csattribute

---

csattribute 公用程序可管理 LDAP 服务器中的 Calendar Server 属性。命令有：

• add－将 LDAP 属性和值添加到指定的目标（用户或资源对象）。

• list－列出目标对象的属性。

• delete－从目标中删除属性。

  
  

  ---

  备注	如果您的站点使用的是 LDAP CLD 插件，请不要使用 csattribute 属性更改 icsDWPHost 属性来指定新的后端主机服务器。修改 icsDWPHost 不会在新的后端主机上创建新日历。有关更多信息，请参阅 “LDAP 日历查找数据库 (CLD) 插件”。

  ---

  
  

要求

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csattribute [-q|-v] -a attribute =value [-t resource | user] add target

csattribute [-q|-v] -a attribute [=value ] [-t resource | user]   delete target

csattribute [-q | -v] [-t resource | user] list target

表 7-2 说明可用于 csattribute 的命令。

表 7-2    csattribute 公用程序命令 

命令	说明
add target	将 LDAP 属性和值添加到指定的目标（用户或源对象）。
list target	列出目标对象的属性。
delete target	从目标中删除属性。
version	显示公用程序的版本。

表 7-3 说明 csattribute 公用程序命令选项。

表 7-3    csattribute 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值为关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值为关闭。
-a attribute =value 或 -a attribute [=value ]	LDAP 属性和值： 使用 -a 选项时需要 attribute。 value 在 -a 选项与 add 命令一起使用时是必需的，而在 -a 选项与 delete 和 list 命令一起使用时是可选的。
-t user | resource	目标的类型（user 或 resource 对象）。默认值为 user。

示例

• 将值为 tchang 的 icsCalendar LDAP 属性添加到用户 ID TChang：

  csattribute -a icsCalendar=tchang add TChang

• 从 TChang 中删除 LDAP 属性 icsCalendar：

  csattribute -a icsCalendar delete TChang

• 显示 TChang 的属性：

  csattribute list TChang

csbackup

---

csbackup 公用程序可备份日历数据库、指定的日历或用户的默认日历。命令有：

• database－备份日历数据库。

• calendar－备份指定的日历。

• defcal－备份用户的默认日历。

• version－显示当前安装的公用程序版本号。

位于指定备份目录的 caldb.conf 版本文件显示已备份数据库的版本号。

有关 csrestore 的信息，请参见 csrestore。

要求

• Calendar Server 可在运行状态或停止状态。

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csbackup [-q|-v] -f database target

csbackup [-q|-v] -c calid calendar target

csbackup [-q|-v] -a userid [-b basedn] defcal target

表 7-4 说明可用于 csbackup 的命令。

表 7-4    csbackup 公用程序命令 

命令	说明
database target	将日历数据库备份到指定的目标数据库目录。默认情况下，目标数据库目录是： server-root/cal/bin/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	显示公用程序的版本。

表 7-5 说明 csbackup 公用程序命令选项。

表 7-5    csbackup 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-a userid	要备份的日历用户 ID。此选项对 defcal 命令是必需的。没有默认值。
-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	准备将用于 Solstice™ Backup™ 或 the Legato Networker™ 备份程序的备份文件。有关更多信息，请参见第 6 章 “备份和还原 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

cscal

---

cscal 公用程序可管理日历及其属性。命令有：

• create－创建日历

• delete－删除日历

• disable－禁用日历

• enable－启用日历

• list－列出日历

• modify－修改日历属性和组日程安排访问控制

• reset－将日历属性重置为默认设置

• version－显示当前安装的公用程序版本号

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

cscal [-q|-v] [-a aces] [-c charset] [-d description] [-g categories]   [-k yes|no] [-l langcode] [-m email] [-n name] [-o owner]   [-y otherowners] create|modify calid

cscal [-q|-v] [-o owner] delete|reset calid

cscal [-q|-v] [-o owner] disable|list [calid]

cscal [-q|-v] [-k yes|no] [-o owner] enable [calid]

表 7-6 说明可用于 cscal 公用程序的命令。

表 7-6    cscal 公用程序命令 

命令	说明
create calid	创建 calid 所指定的日历。 备注：如果您的站点使用了 LDAP CLD 插件，则必须在放置（或将要放置）用户日历的同一后端服务器（由用户的 icsDWPHost LDAP 属性指示）上创建新日历。如果试图在其他后端服务器上创建日历，Calendar Server 将会返回错误。
delete calid	删除 calid 所指定的日历。 如果指定了 -o owner 选项，则会删除所有主要所有者为指定所有者的日历。
enable [calid]	启用 calid 所指定的日历。如果没有指定 calid，则启用所有日历。 如果指定了 -o owner 选项，则会启用所有主要所有者为指定所有者的日历。
disable [calid]	禁用 calid 所指定的日历。如果没有指定 calid ，则禁用所有日历。 如果指定了 -o owner 选项，则会禁用所有主要所有者为指定所有者的日历。
list [calid]	列出 calid 所指定的日历属性。如果没有指定 calid ，则列出所有日历的属性。 如果指定了 -o owner 选项，则会列出所有主要所有者为指定所有者的日历。
modify calid	修改 calid 所指定的日历属性。
reset calid	将 calid 所指定的日历属性重置为默认配置设置。
version	显示公用程序的版本。

表 7-7 说明 cscal 公用程序命令选项。

表 7-7    cscal 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-a [aces]	指定日历的访问控制项 (ACE)。ACE 确定谁可以访问日历以进行组日程安排，以及他们所拥有的权限类型，如创建、删除、读取和写入权限。ACE 字符串或访问控制列表 (ACL) 必须用引号 ("") 括起来。 默认值是 ics.conf 文件中的 calstore.calendar.default.acl 参数。 有关 ACE 格式的详细信息，请参见第 4 章 “管理 Calendar Server 访问控制”。
-c charset	字符集。默认值是没有字符集。
-d description	说明（有关日历用途的可视注释）。默认值是没有说明。
-g category	类别。多个类别必须括在引号 ("") 内并以空格分隔。默认值是没有类别。
-k yes|no	日历是否允许双重预约。例如，yes 表示日历在同一时段内可以安排多个事件。默认值取自 ics.conf 文件中定义的 user.allow.doublebook 设置。
-l langcode	语言代码。默认值是没有语言代码。
-m email	电子邮件地址。默认值是没有电子邮件地址。
-n name	名称。默认值是没有名称。
-o owner	主要所有者。默认设置是日历 ID (calid)，通常与用户 ID 相同。
-y otherowners	其他日历所有者。多个所有者必须括在引号 ("") 内，并以空格分隔。默认值是没有其他所有者。

示例

• 使用默认访问控制设置（由 ics.conf 文件中的 calstore.calendar.default.acl 所定义），创建日历 ID 为 tchang 的日历，并以 TChang 作为主要所有者，其可视名称为 Public_Calendar：

  cscal -o TChang -n Public_Calendar create tchang

• 修改 chang 这个日历，使其可被每个人都读取和写入，且与 sports 类别关联，并由 JSmith 共同拥有：

  cscal -a "@^a^rw^g" -g sports -y JSmith 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

cscomponents

---

cscomponents 公用程序可管理日历组件：事件和任务（待办事项）。命令有：

• delete－删除日历中的事件和任务。

• list－列出日历中的事件和任务。

• version－显示当前安装的公用程序版本号。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

cscomponents [-v|-q] [-e endtime] [-s starttime] [-t event|task]   delete|list calid

表 7-8 说明可用于 cscomponent 公用程序的命令。

表 7-8    cscomponent 公用程序命令 

命令	说明
delete calid	删除具有指定日历 ID 的日历中的事件和任务。
list calid	列出具有指定日历 ID 的日历中的事件和任务。
version	将公用程序的版本输出到屏幕。

表 7-9 说明 cscomponent 公用程序命令选项。

表 7-9    cscomponent 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-e endtime	组件的结束时间。结束时间为 0 表示直到时间结束。默认值为 0。
-s starttime	组件的开始时间。开始时间为 0 表示从时间开始算起。默认值为0。
-t event|task	对何种组件类型（事件或任务）执行操作。默认值是二者。

示例

• 删除日历 ID 为 tchang 的日历中所有 2000 年的事件：

  cscomponents -s 20000101T000000Z -e 20001231T000000Z delete tchang

• 详细列出日历 ID 为 tchang 的日历中所有的事件和任务：

  cscomponents -v list tchang

csdb

---

csdb 公用程序可管理日历数据库（日历、会话和统计信息）。命令有：

• create－创建新的数据库。（如果启动服务器时数据库不存在，则 Calendar Server 会自动创建一个。）

• delete－删除现有的日历数据库。当 Calendar Server 正在运行时，无法删除已打开的数据库。

• list－列出有关数据库的信息。

• check－检查日历数据库以确定是否有任何损坏发生。

• rebuild－重建已损坏的日历数据库。

• recover－恢复已损坏的日历数据库。

• version－显示当前安装的公用程序版本号。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• 使用 create、delete 或 rebuild 命令时必须停止 Calendar Server。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

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|rebuild [dbdir]

表 7-10 说明可用于 csdb 公用程序的命令。

表 7-10    csdb 公用程序命令 

命令	说明
create [dbdir]	在指定的数据库目录中创建数据库。如果没有指定数据库目录，则使用当前目录。如果启动服务器时数据库不存在，则 Calendar Server 会自动创建一个。
delete [dbdir]	删除指定数据库目录中的数据库。如果没有指定数据库目录，则使用当前目录。当 Calendar Server 正在运行时，无法删除已打开的数据库。
list [dbdir]	列出有关指定数据库目录中的数据库信息。如果没有指定数据库目录，则使用当前目录。
recover [dbdir]	尝试恢复指定数据库目录中已损坏的数据库。如果没有指定数据库目录，则使用当前目录。
check [dbdir]	扫描指定数据库目录中的日历数据库，确定是否有任何损坏，并在输出中报告结果。如果没有指定数据库目录，则使用当前目录。
rebuild [dbdir]	在指定数据库目录中扫描日历数据库，确定是否有任何损坏，若有损坏的情形，则会生成一个重建的日历数据库（.db 文件）。 如果没有指定数据库目录，则使用当前目录。
version	显示公用程序的版本。

表 7-11 说明 csdb 公用程序命令选项。

表 7-11    csdb 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-f	强制恢复日历数据库。
-t caldb|sessdb|statdb	指定目标数据库： caldb（日历） sessdb（会话） statdb（统计信息） 备注：如果没有指定 -t 选项，则 csdb 会作用于所有数据库，但 check 和 rebuilt 命令除外，它们只会作用于 caldb（日历）。

示例

• 在当前目录中创建新的、未写入数据的数据库：

  csdb -t caldb create

• 删除当前目录中的数据库：

  csdb -t caldb delete

• 列出有关当前目录中的日历数据库信息：

  csdb -v -t caldb list

• 尝试恢复当前目录中所有已损坏的数据库：

  csdb recover

• 列出有关当前目录中的会话数据库信息：

  csdb -t sessdb list

• 尝试恢复当前目录中已损坏的统计数据库：

  csdb -t statdb recover

csexport

---

csexport 公用程序将日历以 iCalendar (.ics) 或 XML (.xml) 格式导出到文件。命令有：

• calendar－导出指定的日历。

• version－显示当前安装的公用程序版本号。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csexport [-v|-q] -c calid calendar outputfile

表 7-12 说明可用于 csexport 公用程序的命令。

表 7-12    csexport 公用程序命令 

命令	说明
calendar outputfile	将日历导出到指定的输出文件。文件的数据格式由指定的文件扩展名决定： .ics 表示 iCalendar (text/calendar) .xml 表示 XML (text/xml)
version	显示公用程序的版本。

表 7-13 说明 csexport 公用程序命令选项。

表 7-13    csexport 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-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 格式的文件可使用 csimport 公用程序导入日历。命令有：

• calendar－导入指定的日历。

• version－显示当前安装的公用程序版本号。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csimport [-v|-q] -c calid calendar inputfile

表 7-14 说明可用于 csimport 公用程序的命令。

表 7-14    csimport 公用程序命令 

命令	说明
calendar inputfile	从指定的输入文件导入日历。文件的数据格式由文件扩展名决定： .ics 表示 iCalendar (text/calendar) .xml 表示 XML (text/xml)
version	显示公用程序的版本。

表 7-15 说明 csimport 公用程序命令选项。

表 7-15    csimport 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-c calid	要导入日历的日历 ID。此选项对 calendar 命令是必需的。 如果指定的日历 ID 已经存在，则导入的数据会与当前日历合并。没有默认值。 有关更多信息，请参见“日历标识符 (calid)”。

示例

• 从 tchang.ics 文件导入日历 ID 为 tchang 的日历，且为 iCalendar（text/calendar 文件）格式：

  csimport -c tchang calendar tchang.ics

• 从 tchang.xml 文件导入日历 ID 为 tchang 的日历，且为 XML（text/xml 文件）格式：

  csimport -c tchang calendar tchang.xml

csplugin

---

csplugin 可管理为 Calendar Server 所配置的 CSAPI 插件。命令有：

• activate－装入并启动指定的插件。

• deactivate－关闭并禁用指定的插件类型和插件名称。（有关支持的插件类型的说明，请参见表 7-17 中的“-t”选项。）

• list－显示所有支持的插件。

• version－显示当前安装的公用程序版本号。

要求

• 必须在安装 Calendar Server 的机器运行。

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate   activate|deactivate plugin

csplugin [-q|-v] list

表 7-16 说明可用于 csplugin 公用程序的命令。

表 7-16    csplugin 公用程序命令 

命令	说明
activate -t type name	装入并启用指定的插件类型和插件名称。（有关支持的插件类型说明，请参见表 7-17 中的“-t”选项。）
deactivate -t type name	关闭并禁用指定的插件类型和插件名称。（有关支持的插件类型说明，请参见表 7-17 中的“-t”选项。）
list	列出所有支持的插件类型、名称和激活状态。（有关支持的插件类型说明，请参见表 7-17 中的“-t”选项。）
version	显示公用程序的版本。

表 7-17 说明 csplugin 公用程序命令选项。

表 7-17    csplugin 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-r	与 activate 命令一起使用时，会实际将插件上复制到 Calendar Server 的 plugin 目录中。 与 deactivate 命令一起使用时，会从 plugin 目录中删除插件。
-t type	指定以下受到支持的插件类型之一： ac－加强或覆盖默认组日程安排访问控制机制。 attr－加强或覆盖存储和检索用户属性的机制。 auth－加强或覆盖登录身份验证机制。 locate－检索指定的限定 URL 的日历 ID。 lookup－加强或覆盖默认日历查找机制。 xlate－加强或覆盖传入和传出数据的格式转换。

示例

• 列出有关所有支持插件的详细信息，包括配置用于此服务器实例的每个插件类型、名称和激活状态：

  csplugin -v list

• 装入并启用文件名为 mylookup 的 lookup 类型插件：

  csplugin activate -t lookup mylookup

• 禁用文件名为 mylookup 的 lookup 类型插件，并将其由 plugin 目录中删除：

  csplugin deactivate -t lookup mylookup -r

csresource

---

csresource 公用程序可管理存储在 LDAP 服务器和 Calendar Server 数据库中的资源（如会议室或设备）日历。（csresource 公用程序只能用于与资源关联的日历，如果对用户日历发出命令，则会返回错误。）命令有：

• create－为指定的日历 ID (calid) 添加新资源

• delete－移除一个资源或所有资源

• disable－禁用一个资源或所有资源

• enable－启用一个资源或所有资源

• list－显示单个资源或所有资源的列表

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csresource [-q|-v] [-a aces] [-b basedn] -c calid [-d description]   [-k yes|no] [-o owner] [-y otherowners] create name

csresource [-q|-v] [-b basedn] delete|disable|enable [name]

csresource [-q|-v] [-b basedn] [-h server-name] list [name]

表 7-18 说明可用于 csresource 公用程序的命令。

表 7-18    csresource 公用程序命令 

命令	说明
create name	为指定的日历 ID 创建新资源。
delete [name]	删除一个资源，如果未指定资源 name，则会删除所有资源。
enable [name]	启用一个资源，如果未指定资源 name，则会启用所有资源。
disable [name]	禁用一个资源，如果未指定资源 name，则会禁用所有资源。
list [name]	显示单个资源日历，如果未指定资源 name，则会显示所有资源日历。 如果包括 -h server-name 选项，则会显示该后端服务器上指定名称的（或者所有资源日历的）日历属性。

---

备注	如果上述任何命令中的 name 包含空格，则必须使用引号 (" ") 括起来。

---

表 7-19 说明 csresource 公用程序命令选项。

表 7-19    csresource 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-a [aces]	指定日历的访问控制项 (ACE)。ACE 确定谁可以访问日历以进行组日程安排，以及他们所拥有的权限类型，如创建、删除、读取和写入权限。ACE 字符串或访问控制列表 (ACL) 必须用引号 ("") 括起来。 默认值是 ics.conf 文件中的 resource.default.acl 参数。 有关 ACE 格式的信息，请参见第 4 章 “管理 Calendar Server 访问控制”。
-b [basedn]	用于指定资源的 LDAP 基准 DN（辨别名）。 默认值取自 ics.conf 文件中的 local.ugldapbasedn 设置。
-c calid	icsCalendar 属性。此选项对 create 命令是必需的。有关更多信息，请参见“日历标识符 (calid)”。
-d [description]	说明：有关日历用途的可视注释。默认值是没有说明。
-h [server-name]	资源日历所在的后端服务器名称。此选项只适用于 list 命令。
-k yes|no	与资源（如会议室）关联的日历是否允许双重预约。如果是 yes，则表示资源日历在同一时段内可以安排多个事件。 默认值取自 ics.conf 文件中的 resource.allow.doublebook 设置。
-o owner	主要所有者。 默认值取自 ics.conf 文件中的 service.admin.calmaster.userid 设置。
-y otherowners	其他所有者。多个所有者必须括在引号 ("") 内，并以空格分隔。默认值是没有其他所有者。
version [name]	显示公用程序的版本。

示例

• 显示所有资源日历的列表及其 LDAP 属性。

  csresource -v list

• 创建日历 ID (calid) 为 room100 和可视名称（LDAP cn 属性）为 MeetingRoom100 的资源日历：

  csresource -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

---

csrestore 公用程序可还原日历数据库或指定的日历，或者还原使用 csbackup 或 csexport 保存的用户默认日历。命令有：

• database－还原日历数据库。

• calendar－还原指定的日历。

• defcal－还原用户的默认日历。

• version－显示当前安装的公用程序版本号。

位于指定备份目录的 caldb.conf 版本文件显示已备份数据库的版本号。

---

警告	Calendar Server 5.x 版的 csrestore 与 2.x 版的 csrestore 不兼容。请勿试图还原使用 Calendar Server 2.x csrestore 备份的数据，因为可能会发生数据丢失的情形。

---

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• 如果要还原日历数据库，必须停止 Calendar Server。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csrestore [-v|-q] [-f] database inputdir

csrestore [-v|-q] -c calid calendar inputfile

csrestore [-v|-q] -a userid [-b basedn] defcal inputfile

表 7-20 说明可用于 csrestore 公用程序的命令。

表 7-20    csrestore 公用程序命令 

命令	说明
database inputdir	从指定的输入目录或包含备份日历数据库的输入文件还原日历数据库。此操作会改写当前日历数据库中所有以前的内容。
calendar inputfile	从指定的输入文件还原指定的日历 ID。文件的数据格式由文件扩展名决定： .ics 表示 iCalendar (text/calendar)。 .xml 表示 XML (text/xml)。 如果指定的日历 ID 已经存在，则会在还原前清除日历的数据。
defcal inputfile	从指定的输入文件还原指定用户 ID 的默认日历。文件的数据格式由文件扩展名决定： .ics 表示 iCalendar (text/calendar)。 .xml 表示 XML (text/xml)。
version	显示公用程序的版本。

表 7-21 说明 csrestore 公用程序命令选项。

表 7-21    csrestore 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-a userid	要还原的用户 ID。此选项对 defcal 命令是必需的。没有默认值。
-b basedn	用于指定用户 ID 的 LDAP 基准 DN（辨别名）。默认值取自 ics.conf 文件中定义的 local.ugldapbasedn 设置。
-f	强制删除任何现有的数据库文件。
-c calid	要还原的日历 ID。此选项对 calendar 命令是必需的。没有默认值。 有关更多信息，请参见“日历标识符 (calid)”。

示例

• 还原 backupdir 目录中先前用 csbackup 保存的日历数据库：

  csrestore database backupdir

• 针对 backupdir 目录中先前使用 csbackup 或 csexport 保存成 iCalendar（text／calendar 文件）格式的 tchang.ics 文件，还原日历 ID 为 tchang 的日历：

  csrestore -c tchang calendar backupdir/tchang.ics

• 从 backupdir 目录中先前使用 csbackup 保存的日历数据库还原 tchang：

  csrestore -c tchang calendar backupdir

• 针对 backupdir 目录中先前使用 csbackup 或 csexport 保存成 iCalendar（text／calendar 文件）格式的 TChang.ics 文件，还原 TChang 所拥有的默认日历：

  csrestore -a TChang defcal backupdir/TChang.ics

csschedule

---

csschedule 公用程序可管理存储在组日程安排引擎 (GSE) 队列中的日程表项。命令有：

• list－显示 GSE 队列中指定的日历 ID 所请求的项。

• delete－从 GSE 队列中移除指定的日历 ID 所请求的项。

• version－显示当前安装的公用程序版本号。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• 必须停止 Calendar Server。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

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]

表 7-22 说明可用于 csschedule 公用程序的命令。

表 7-22    csschedule 公用程序命令 

命令	说明
list	显示 GSE 队列中指定的日历 ID 所请求的项。
delete	从 GSE 队列中删除指定的日历 ID 所请求的项。
version	显示公用程序的版本。

表 7-23 说明 csschedule 公用程序命令选项。

表 7-23    csschedule 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-c count	要列出的 GSE 队列项数目。例如，如果希望检查队列中的 10 项，请指定 10。
-e endtime	GSE 队列项的结束时间，其中 0 表示直到时间结束。 默认值为 0。
-n sequencenumber	队列中的事件或任务的序列号。
-o offset	日程表时间的偏移数。当同一时间安排了多个项时，偏移数可唯一标识 GSE 队列中的项。
-r rid	事件或待办事项的周期 ID (RID)。RID 是以分号分隔的字符串列表，可识别每个重复的事件或待办事项。
-s starttime	GSE 队列项的开始时间，其中 0 表示从时间开始算起。 默认值为 0。
-t scheduletime	日程表时间，例如： 20001231T103045Z
-u uid	GSE 队列项的唯一标识符 (UID)。

示例

• 详细列出存储在 GSE 队列中的所有项：

  csschedule -v list

• 列出存储在 GSE 队列中的前 10 项：

  csschedule -c 10 list

• 列出 GSE 队列中安排在 2000 年 12 月 31 日的 10:30:45 到 11:30:45 之间的项：

  csschedule -s 20001231T103045Z -e 20001231T113045Z list

• 将 GSE 队列中 tchang 的日历符合以下条件的项列出：安排在 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 的日历符合以下条件的项删除：安排在 2000 年 12 月 31 日 13:30:45，第一个偏移数在 13:30:45 处，唯一标识符为 1111、周期 ID 为 0 且序列号为 0 的项。

  csschedule -v -t 20001231T133045Z -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

csstart

---

---

备注	Calendar Server 所提供的 csstart 和 csstop 公用程序只是为了与早期版本兼容。 建议使用 start-cal 和 stop-cal 命令来启动和停止 Calendar Server。有关更多信息，请参见“启动和停止 Calendar Server”。

---

csstart 公用程序可启动 Calendar Server。命令有：

• check－可确定是否所有的 Calendar Server 服务或指定的服务正在运行。

• list－显示所有 Calendar Server 服务或指定的服务。

• service－启动所有 Calendar Server 服务或指定的服务。

• version－显示当前安装的公用程序版本号。

在 Windows NT 系统上，您也可以从“控制面板”访问“服务”对话框来启动 Calendar Server。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• 必须停止 Calendar Server。

语法

csstart [-q|-v] check|list [servicename]

csstart [-q|-v] [-f] service [servicename]

表 7-24 说明可用于 csstart 公用程序的命令。

表 7-24    cscstart 公用程序命令 

命令	说明
check | list[servicename]	检查指定的 Calendar Server 服务是否正在运行；如果未指定服务名，则会检查是否所有的 Calendar Server 服务都在运行 或者，列出所有的 Calendar Server 服务（或指定的服务）及其会话 ID。 servicename 可以是下列之一： ens－可以由其他 Sun ONE 服务器共享的通用事件注册和通知服务 notify－Calendar Server 通知服务 admin－Calendar Server 管理服务（每台服务器上都需要） dwp－Calendar Server 数据库服务（只在远程数据库配置下才会启动） http－Calendar Server 服务
service [servicename]	启动指定的 Calendar Server 服务；如果未指定服务名，则启动所有服务。Calendar Server 服务应该按以下顺序启动： ens－可以由其他 Sun ONE 服务器共享的通用事件注册和通知服务 notify－Calendar Server 通知服务 admin－Calendar Server 管理服务（每台服务器上都需要） dwp－Calendar Server 数据库服务（只在远程数据库配置下才会启动） http－Calendar Server 服务 有关 Calendar Server 服务的更多信息，请参见以下各节： “Calendar Server 访问控制”。 “启动和停止 Calendar Server”。 “服务配置”。
version	显示公用程序的版本。

表 7-25 说明 csstart 公用程序命令选项。

表 7-25    csstart 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-f	对指定的 Calendar Server 服务（如果未指定服务，则是所有当前运行的服务）强制执行下列操作： 停止（类似于 UNIX 上的 kill -9 命令，或类似从 Windows NT 任务管理器停止服务。如果先前停止失败，请执行此操作）。 清除所有数据库问题。 启动所有服务。 备注：建议使用 stop-cal 和 start-cal 公用程序来停止和启动 Calendar Server。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。

示例

• 使用默认端口并且按默认启动顺序来启动所有本地的 Calendar Server 服务：

  csstart service

• 启动本地的 Calendar Server HTTP 服务：

  csstart service http

• 检查是否所有本地的 Calendar Server 服务皆已启动：

  csstart check

• 列出所有已启动的本地 Calendar Server 服务：

  csstart list

csstats

---

csstats 公用程序可显示 Calendar Server 的统计信息。命令有：

• list －列出有关指定的 Calendar Server 子系统的计数器统计信息。

• version－显示当前安装的公用程序版本号。

有关计数器的更多信息，请参见“计数器配置 (counter.conf) 文件”。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• Calendar Server 可在运行状态或停止状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csstats [-q|v] [-r registry] [-i iterations] [-s delay]] list [subsystem]

表 7-26 说明可用于 csstats 公用程序的命令。

表 7-26    csstats 公用程序命令 

命令	说明
list [subsystem]	列出有关指定的 Calendar Server 子系统的计数器统计信息。如果未指定 subsystem，则会显示有关可用子系统的基本信息： alarm－监视服务警报通知 auth－登录身份验证 db－日历数据库 disk－监视磁盘使用情形 gse－组日程安排引擎 (GSE) http－HTTP 传输 response－服务器响应时间 sess－服务器会话状态 wcap－Web 日历访问协议
Version	显示公用程序的版本。

表 7-27 说明 csstats 公用程序命令选项。

表 7-27    csstats 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-i iterations	重复统计查找的次数。默认值是 1。
-r registry	存储计数器统计信息的文件名称和位置。默认值是：server-root/cal/bin/counter/counter。例如： /opt/SUNWics5/cal/bin/counter/counter
-s delay	显示每次统计查找之前等候的时间（以秒为单位）。默认值是 1 秒。

示例

• 显示有关计数器和可用类型的基本信息：

  csstats list

• 列出有关 HTTP 服务子系统 (hpptstat) 的计数器统计信息：

  csstats list http

• 每隔 10 秒列出一次 WCAP 子系统 (wcapstat) 的计数器统计信息，持续一小时（3600 秒）：

  csstats -i 3600 -s 10 list wcap

csstop

---

---

备注	Calendar Server 所提供的 csstop 和 csstart 公用程序只是为了与早期版本兼容。 建议使用 start-cal 和 stop-cal 命令来启动和停止 Calendar Server。有关更多信息，请参见“启动和停止 Calendar Server”。

---

csstop 公用程序可停止 Calendar Server。命令有：

• service－停止 Calendar Server 的所有服务或指定服务。

• version－显示当前安装的公用程序版本号。

在 Windows NT 系统上，您也可以从“控制面板”访问“服务”对话框来停止 Calendar Server。

要求

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• 必须运行 Calendar Server。

语法

csstop [-q|-v] check | list [servicename]

csstop [-q|-v] [-f] service [servicename]

表 7-28 说明可用于 csstop 公用程序的命令

表 7-28    csstop 公用程序命令 

命令	说明
check | list [servicename]	检查指定的 Calendar Server 服务是否正在运行；如果未指定服务名，则会检查是否所有的服务都在运行。 或者，列出所有的 Calendar Server 服务或指定的服务及其会话 ID。 servicename 可以是下列之一： ens－可由其他 Sun ONE 服务器共享的通用事件注册和通知服务。 notify－Calendar Server 通知服务。 admin－Calendar Server 管理服务（每台服务器上都需要 admin）。 dwp－Calendar Server 数据库服务（只在远程数据库配置下才会启动）。 http－Calendar Server 服务。
service [servicename]	停止指定的 Calendar Server 服务；如果未指定服务名，则停止所有服务。Calendar Server 服务应该按下列顺序启动，按相反的顺序停止： ens－可由其他 Sun ONE 服务器共享的通用事件注册和通知服务。 notify－Calendar Server 通知服务。 admin－Calendar Server 管理服务（每台服务器上都需要 admin）。 dwp－Calendar Server 数据库服务（只在远程数据库配置下才会启动）。 http－Calendar Server 服务。 有关 Calendar Server 服务的更多信息，请参见以下各节： “Calendar Server 访问控制”。 “启动和停止 Calendar Server”。 “服务配置”。
version	显示公用程序的版本。

.

表 7-29 说明 csstop 公用程序命令选项。

表 7-29    csstop 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-f	如果先前停止失败，则可强制 Calendar Server 服务停止（类似于 UNIX 上的 kill -9 命令或类似从 Windows NT 任务管理器停止服务）。 此选项只能与 service 命令一起使用。

示例

• 停止所有本地的 Calendar Server 服务：

  csstop service

• 停止本地的 Calendar Server HTTP 服务：

  csstop service http

• 检查是否所有本地的 Calendar Server 服务皆已停止：

  csstop check

• 列出所有已停止的本地 Calendar Server 服务：

  csstop list

cstool

---

cstool 公用程序可对 Calendar Server、cshttpd 服务或事件通知服务 (ENS) 执行 ping 操作。cstool 也可强制 Calendar Server 或特定的服务刷新其配置。使用的命令为：

• ping－对 Calendar Server、cshttpd 或 ENS 服务执行 ping 操作，以验证指定端口已在侦听中。

• refresh－刷新 Calendar Server 或者特定的服务，以强制其刷新配置设置。

• version－显示当前安装的公用程序版本号。

---

备注	在当前版本中，不要使用 cstool refresh 来刷新配置。应改用 stop-cal 和 start-cal 命令关闭然后重新启动 Calendar Server。 有关更多信息，请参见 “启动和停止 Calendar Server”和“编辑 ics.conf 配置文件”。

---

要求

• 必须运行 Calendar Server。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

cstool [-q|-v] [-h host] [-p port] [-t timeout] ping [http|ens]

cstool [-q|-v] [-h host] refresh [servicename]

表 7-30 说明可用于 cstool 公用程序的命令。

表 7-30    cstool 公用程序命令 

命令	说明
ping [http|ens]	对 cshttpd 或 ENS 服务执行 ping 操作。
refresh [servicename]	强制 Calendar Server 刷新指定服务的配置；如果未指定服务，则会刷新所有 Calendar Server 服务的配置。Calendar Server 服务选项有： admin（csdamind 服务） dwp（csdwpd 服务） http（cshttpd 服务） notify（csnotifyd 服务）
version	显示公用程序的版本。

表 7-31 说明 cstool 公用程序命令选项。

表 7-31    cstool 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-h host	指定运行 Calendar Server 的主机名。默认值取自 ics.conf 文件中的 local.hostname 参数，并在安装时设置。如果访问运行在远程机器上的 Calendar Server，请使用此选项。
-p port	指定服务的端口；如果未指定服务，则会使用在 ics.conf 文件中定义的默认端口值。
-t timeout	等待服务器响应的时间（以秒为单位）。默认值是 120 秒。

示例

• 对 cshttpd 服务执行 ping 操作：

  cstool ping http

• 对主机名为 sesta 的服务器上的 ENS 执行 ping 操作：

  cstool -h sesta ping ens

• 对主机名为 calserver 的机器执行 ping 操作，查看 Calendar Server cshttpd 服务是否在侦听端口 80：

  cstool -p 80 -h calserver -p 80 ping http

• 强制本地 Calendar Server 刷新所有服务的配置：

  cstool refresh

csuser

---

csuser 公用程序可管理存储在 LDAP 目录服务器和 Calendar Server 日历数据库中的日历用户信息。命令有：

• check－检查用户的日程安排功能是否已启用。

• create－创建用户并启用日程安排的功能。

• delete－删除用户。

• disable－禁止用户登录到 Calendar Server。

• enable－允许用户登录到 Calendar Server。

• list－列出用户的日历属性。

• reset－将用户的日历属性重置为默认设置。

  
  

  ---

  备注	在当前版本中，建议您使用目录服务器公用程序或自定义用户配置工具来配置用户 LDAP 属性。 例如，如果您使用的是 iPlanet Directory Server，则使用 ldapsearch 和 ldapmodify 公用程序。有关这些公用程序的信息，请参见以下 Web 站点中的 iPlanet Directory Server 文档： http://docs.sun.com/db/prod/s1dirsrv

  ---

  
  

要求

• Calendar Server 可在运行状态或停止状态。

• 必须在安装 Calendar Server 的机器上运行该公用程序。

• 存储日历用户信息的 LDAP 服务器必须在运行状态。

• 在 UNIX 系统上，必须使用安装时指定运行 Calendar Server 的用户和组（如 icsuser 和 icsgroup）身份登录，或者以 root 身份登录。在 Windows NT 系统上，必须使用拥有系统全部管理员权限的管理员身份登录。

语法

csuser [-q|-v] [-a aces] [-b basedn] [-c calid] -g givenname   [-k yes|no] [-l langcode] -s surname -y userpassword create userid

csuser [-q|-v] [-b basedn] [-h server-name] list [userid]

csuser [-q|-v] [-b basedn]   [check|delete|disable|enable|reset] userid

表 7-32 说明可用于 csuser 公用程序的命令。

表 7-32    csuser 公用程序命令 

命令	说明
check userid	检查指定的用户 ID 是否启用了日程安排功能。
create userid	创建指定的用户 ID 并允许该用户登录到 Calendar Server。
delete userid	删除指定的用户 ID。
disable userid	禁用指定用户 ID 的日程安排功能。该公用程序会将 http 定义为 nswcalDisallowAccess 属性的值。
enable userid	启用指定用户 ID 的日程安排功能。（该公用程序会将指定的日历 ID 添加到 nswcalCALID 属性。）
list [userid]	列出指定用户 ID 的日历属性。如果未指定用户 ID，则会列出所有已启用日程安排功能的用户属性。 如果包括 -h server-name 选项，则会列出该后端服务器上指定用户 ID（或所有已启用日程安排功能的用户）的日历属性。
reset userid	将用户 ID 的所有日历属性重置为默认设置。 备注：重置用户 ID 的日历属性后，所有的日历属性都会从用户的 LDAP 项中移除，包括 icsCalendarUser （对象类）、icsSubscribed、icsCalendarOwned、icsCalendar 及 icsDWPHost（如果用户在 LDAP CLD 设置中）。这样，Calendar Server 管理员将无法代表用户创建日历。 在下列情况中，这些属性会在用户的 LDAP 项中还原： 用户重新登录到 Calendar Server 时，或者 Calendar Server 管理员为用户发出 csuser enable 命令。
version	显示公用程序的版本。

表 7-33 说明 csuser 公用程序命令选项。

表 7-33    csuser 公用程序命令选项 

选项	说明
-v	以详细模式运行：显示有关所执行命令的所有可用信息。默认值是关闭。
-q	以无提示模式运行： 如果操作成功则不显示信息（如果发生错误则显示错误）。 取消显示危险命令的确认提示。 默认值是关闭。
-a [aces]	指定日历的访问控制项 (ACE)。ACE 确定谁可以访问日历以进行组日程安排，以及他们所拥有的权限类型，如创建、删除、读取和写入权限。ACE 字符串或访问控制列表 (ACL) 必须用引号 ("") 括起来。 默认值是 ics.conf 文件中的 calstore.calendar.default.acl 参数。 有关 ACE 格式的详细信息，请参见“服务配置”。
-b [basedn]	指定用户 ID 的 LDAP 基准 DN（辨别名）。 默认值取自 ics.conf 文件中的 local.ugldapbasedn 参数。
-c [calid]	与指定用户 ID 关联的默认日历 ID。此命令不会创建日历。 有关更多信息，请参见“日历标识符 (calid)”。
-g givenname	用户的 LDAP 名字。此选项是必需的。没有默认值。
-h [server-name]	用户日历所在的后端服务器名称。此选项只适用于 list 命令。
-k yes|no	用户日历是否允许双重预约。如果是 yes，则表示用户的日历在同一时段内可以安排多个事件。 默认值取自 ics.conf 文件中定义的 user.allow.doublebook 设置。
-l [langcode]	语言代码。默认值是 ics.conf 中 local.sitelanguage 的值。
-s surname	用户的 LDAP 姓氏。此选项是必需的。没有默认值。
-y userpassword	必需的日历用户口令。没有默认值。

示例

• 检查日历用户 JSmith 是否已启用日程安排的功能（假设现有日历用户有权访问此 Calendar Server 的日历数据）：

  csuser check JSmith

• 创建一个用户 ID 为 JSmith 的 LDAP 用户，其名字为 John，姓氏为 Smith，日历 ID 为 JSmithcal：

  csuser -g John -s Smith -y password -c JSmithcal create JSmith

• 删除日历用户 JSmith：

  csuser delete JSmith

• 禁止日历用户 JSmith 登录到 Calendar Server：

  csuser disable JSmith

  
  

  ---

  备注	此命令会禁止 JSmith 登录到 Calendar Server 访问日历数据，但并不会从日历数据库中删除 JSmith 的数据。但如果 JSmith 当前已登录到 Calendar Server，则 JSmith 仍有权访问日历数据，直到他注销为止。

  ---

  
  

• 启用 JSmith 的日程安排功能（允许现有日历用户 JSmith 登录到 Calendar Server）：

  csuser enable JSmith

• 列出 JSmith 的所有日历属性：

  csuser -v list JSmith

• 列出具有前缀字符串 user 的所有日历用户 ID：

  csuser -v list "user*"

• 将 JSmith 的所有日历属性重置为默认配置设置：

  csuser reset JSmith

• 列出后端服务器 sesta 上 TChang 的所有日历属性：

  csuser -v -h sesta list TChang