Sun Java System Calendar Server 6 2005Q4 管理指南

附录 D Calendar Server 命令行实用程序参考

csattribute	csexport	csrestore
csbackup	csimport	csschedule
cscal	csmonitor	csstats
csclean	csplugin	cstool
cscomponents	cspurge	csuser
csdb	csrename	start-cal
csdomain	csresource	stop-cal

有关每个实用程序的简短说明，请参见命令行实用程序的简短说明。

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 命令行实用程序汇总


实用程序	说明
csattribute	管理日历用户或资源的 LDAP 属性。
csbackup	备份单个日历、用户和日历数据库。
cscal	管理日历及其属性。
csclean	删除状态属性 (inetUserStatus) 已被 Delegated Administrator 标记为“已删除”的 Calendar Server 用户的用户日历和资源日历。
cscomponents	管理日历组件：事件和任务（待办事件）。
csdb	管理日历数据库。
csdomain	管理 LDAP 目录中托管（虚拟）域的 Calendar Server 属性。
csexport	以 iCalendar (.ics) 或 XML (.xml) 格式导出日历。
csimport	以 iCalendar (.ics) 或 XML (.xml) 格式导入日历。
csmonitor	监视日历数据库的 LDAP 连接、日志文件和可用磁盘空间。
csplugin	查看、启用或禁用已配置的 Calendar Server API (CSAPI) 插件。
cspurge	允许手动清除删除日志数据库 (ics50deletelog.db) 中的条目。
csrename	允许重命名用户 ID。将导致整个数据库被重写。
csresource	管理日历资源，例如会议室和设备。
csrestore	恢复单个日历、用户和日历数据库。
csschedule	管理组计划引擎 (GSE) 队列中的计划条目。
csstats	在 Calendar Server 中显示计数器。
cstool	强制回应正在运行的 Calendar Server 实例。
csuser	管理日历用户。
start-cal	启动所有 Calendar Server 进程。
stop-cal	停止所有 Calendar Server 进程。

csattribute

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 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-a` `attribute` `=` `value` 或 `-a` `attribute` [`=` `value` ]	LDAP 属性和值：使用 `-a` 选项时，`attribute` 是必需的。将 `-a` 选项与 add 命令一起使用时，`value` 是必需的；但将 `-a` 选项与 delete 和 list 命令一起使用时，它是可选的。
`-t` `user` \| `resource`	对象（用户对象或资源对象）的类型。默认值为用户。
[-d `domain`]	指定托管（虚拟）域的名称。默认值来自 ics.conf 文件中的 service.defaultdomain 参数。

示例

将值为 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 的本地计算机上运行实用程序。
必须以安装过程中指定的运行 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`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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`	准备要在 Solstice^TM Backup^TM 或 Legato Networker^TM 备份程序中使用的备份文件。有关更多信息，请参见第 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

cscal

cscal 实用程序可以管理日历及其属性。命令包括：

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`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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

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 实用程序命令选项


选项	说明
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-g` `graceperiod`	指定删除用户的日历服务后持续的天数。默认值为 10 天。
`domain`	指定要删除所有用户和资源的日历的域。星号 (`*`) 用于删除全部域中所有用户和资源的所有日历。

示例

移除 sesta.com 中日历服务已被删除至少 5 天的所有用户和资源的日历：
```
csclean -g 5 clean sesta.com
```
移除所有域中日历服务已被删除至少 10 天的所有用户和资源的日历：
```
csclean clean "*"
```

cscomponents

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 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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。
必须以安装过程中指定的运行 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 实用程序命令选项


选项	说明
`-a`	仅适用于 `rebuild` 命令，只重建警报数据库。
`-V`	必须使用 `-a` 传递以重建警报数据库。导致针对所有数据库（包括警报）来运行验证。
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-f`	强制恢复日历数据库。
`-g`	对于 `rebuild` 命令，除了其他日历数据库外，还将重建组计划引擎 (Group Scheduling Engine, GSE) 数据库。
`-t caldb\|sessdb\|statdb`	指定目标数据库组： `caldb`（日历） `sessdb`（会话） `statdb`（统计信息）备注：如果未指定 `-t`，csdb 将对所有数据库组进行操作，但 `check`、`recover` 和 `rebuild` 命令除外，这三个命令仅对 `caldb`（日历）进行操作。

示例

在当前目录中创建一个新的、未经填充的数据库：

csdb -t caldb create
删除当前目录中的数据库：

csdb -t caldb delete
列出当前目录中的日历数据库的信息：

csdb -v -t caldb list
尝试恢复当前目录中所有被损坏的数据库：

csdb recover
列出当前目录中的会话数据库的信息：

csdb -t sessdb list
仅重建警报数据库：

csdb -a -V rebuild

csdomain

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`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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 命令：对于 LDAP Schema 1—指定在其下对所有用户和资源进行创建的节点。例如：`o=node2,o=node1,o=sesta` 对于 LDAP Schema 2—指定为该域创建的节点的名称。例如：`o=west.sesta.com` 如果没有指定节点，将使用域名。
`domain`	对于 add、delete 和 list 命令，指定 LDAP 目录中的现有域。对于 create 命令，为将在 LDAP 目录中创建的新域指定一个唯一的名称。例如：`west.sesta.com`

LDAP 属性和 property 名

下表介绍了应用于 csdomain 实用程序的 LDAP 属性和 property 名。这些属性是 icsCalendarDomain 对象类的一部分。添加或删除值时，必须使用 property 名而不是属性名。

如果使用 csdomain 添加或更新域的 LDAP 属性，必须重新启动 Calendar Server 才能使新值生效。

icsAllowRights 属性：csdomain 实用程序

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		当前发行版中未使用。

icsExtendedDomainPrefs 属性：csdomain 实用程序

下表介绍了可以使用 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`（无默认值）

其他 LDAP 目录属性：csdomain 实用程序

下表介绍了可以使用 csdomain 实用程序设置的其他 LDAP 属性及其属性。

表 D–17 可以使用 csdomain 实用程序设置的其他 LDAP 目录属性


LDAP 属性	property 名	说明
icsAllowedServiceAccess	allowedAccessProtocols	指定是否允许访问 Calendar Server。如果设置为 "http"，则拒绝访问。如果设置为其他值，则允许访问。仅当未设置 icsStatus 属性时，Calendar Server 才能使用该属性。
icsDefaultAccess	userDefaultAcl	指定新创建的用户日历的 ACL。对应的 ics.conf 参数： calstore.calendar.default.acl
icsDomainNames	searchDomainNames	指定查找日历或用户时，该域可以搜索的外部域。对应的 ics.conf 参数：无
icsDWPBackEndHosts	（未定义）	指定未明确提供主机名时，用户的默认后端主机（DNS 名称）。当 Clendar Server 处于 LDAP CLD 模式时使用此属性。
icsStatus	statusCalendarDomain	指定 Calendar Server 的状态：活动—Calendar Server 可以访问。不活动—Calendar Server 不可访问。日历保留在数据库中，Calendar Server LDAP 属性保持不变。已删除—Calendar Server 不可访问。原因是用户被标记为“已删除”。已移除—已从日历数据库中移除日历。如果设置了 icsStatus，其值将覆盖 icsAllowedServiceAccess 属性。如果没有设置 icsStatus，Calendar Server 将使用 icsAllowedServiceAccess 属性。
icsTimezone	timezone	指定默认时区 ID。例如，America/New_York 或 Asia/Tokyo。有关支持的时区，请参阅 timezones.ics 文件。

示例

使用 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

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`	将日历导出至指定的输出文件。文件的数据格式由指定的文件扩展名决定： ..ics 对应 iCalendar (text/calendar) 格式 .xml 对应 XML (text/xml) 格式
`version`	显示实用程序的版本。

下表介绍了 csexport 实用程序命令选项。

表 D–19 csexport 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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

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`	从指定的输入文件导入日历。文件的数据格式由文件扩展名决定： `.ics` 对应 iCalendar (text/calendar) 格式 `.xml` 对应 XML (text/xml) 格式
`version`	显示实用程序的版本。

下表介绍了 csimport 实用程序命令选项。

表 D–21 csimport 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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

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

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 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-r`	与 activate 命令一起使用时，将插件物理复制到 Calendar Server 的 `plugin` 目录中。与 deactivate 命令一起使用时，从 `plugin` 目录中删除插件。
`-t` `type`	指定以下支持的插件类型之一： ac—增加或覆盖默认的组计划访问控制机制。 attr—增加或覆盖用于存储和检索用户属性的机制。 auth—增加或覆盖登录验证机制。 locate—检索指定的限定 URL 的日历 ID。 lookup—增加或覆盖默认日历查找机制。 xlate—增加或覆盖传入数据和传出数据的格式转换。

示例

列出所有支持插件的详细信息，包括为与此服务器实例一起使用而配置的每个插件的类型、名称以及激活状态：

csplugin -v list
装入并启用类型为 lookup，文件名为 mylookup 的插件：

csplugin activate -t lookup mylookup
禁用类型为 lookup，文件名为 mylookup 的插件，然后将其从 plugin 目录中删除：

csplugin deactivate -t lookup mylookup -r

cspurge

cspurge 实用程序，使用该实用程序可以手动清除删除日志数据库 (ics50deletelog.db) 中的条目。

要求

必须在已安装 Calendar Server 的本地计算机上运行实用程序。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组（例如 icsuser 和 icsgroup）身份登录，或以 root 身份登录。

语法

cspurge [-q|-v] 
        -e endtime 
        -s starttime

下表介绍了 cspurge 实用程序命令选项。

表 D–26 cspurge 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-e` `endtime`	指定 GMT 结束时间（另请参阅 UTC 或 Zulu 时间）。其值最大为（小于）指定的时间。默认值为 0，表示在格林威治标准时间的午夜零点结束。
`-s` `starttime`	指定 GMT 开始时间（另请参阅 UTC 或 Zulu 时间）。其值包括（大于或等于）指定的时间。默认值为 0，表示在格林威治标准时间的午夜零点开始。

示例

清理“删除日志”中的所有条目：
```
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

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

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`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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`	指定托管（虚拟）域的名称。默认值来自 ics.conf 文件中的 service.defaultdomain 参数。
`-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`	主要属主。默认值来自 ics.conf 文件中的 service.admin.calmaster.userid。
`-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

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 实用程序命令


命令	说明
`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`	显示实用程序的版本。

下表介绍了 csrestore 实用程序命令选项。

表 D–31 csrestore 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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

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 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-c` `count`	要列出的 GSE 队列条目的数量。例如，如果要检查队列中的十个条目，请指定 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 队列中条目的唯一标识符 (Unique Identifier, UID)。

示例

列出 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

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 实用程序命令


命令	说明
`list` `[subsystem]`	列出某个指定 Calendar Server 子系统的计数器统计信息。如果没有指定子系统，则显示可用子系统的基本信息，包括： `alarm`—服务监视的警报通知 `auth`—登录验证 `db`—日历数据库 `disk`—磁盘使用情况监视 `gse`—组计划引擎 (Group Scheduling Engine, GSE) `http`—HTTP 传输 `response`—服务器响应次数 `sess`—服务器会话状态 `wcap`—Web 日历访问协议
`Version`	显示实用程序的版本。

下表介绍了 csstats 实用程序命令选项。

表 D–35 csstats 实用程序命令选项

选项

说明

-v

在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。

-q

在静默模式下运行：

如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。
抑制破坏性命令的确认提示。

默认值为 off。

-i iterations

重复查找统计信息的次数。默认值为 1。

-r registry

存储计数器统计信息的文件的名称和位置。默认值为：

/opt/SUNWics5/cal/lib/counter/counter

-s delay

显示每条统计信息查找结果之前等待的时间（以秒为单位）。默认值为 1 秒。

示例

显示计数器的基本信息和可用类型：
```
csstats list
```
列出有关 HTTP 服务子系统 (hpptstat) 的计数器统计信息：
```
csstats list http
```
在一小时（3600 秒）内每隔 10 秒列出一次有关 WCAP 子系统 (wcapstat) 的计数器统计信息：
```
csstats -i 3600 -s 10 list wcap
```

cstool

cstool 实用程序用于强制回应以下任一项：

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`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-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

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`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-b basedn`	要用于所有 LDAP 用户的基本 DN。默认值来自 `ics.conf` 文件中定义的 `local.ugldapbasedn` 设置。
`-b basedn`	指定用户的基本 DN。
`-d domain`	指定托管（虚拟）域的名称。默认值来自 `ics.conf` 文件中的 service.defaultdomain 参数。
`-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`	是否允许双重预订用户日历。如果为 yes，则可以为用户日历的同一时段安排多个事件。默认值来自 ics.conf 文件中定义的 user.allow.doublebook 设置。
`-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

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

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。