Sun Java System Calendar Server 6.3 管理指南

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

D.3 csattribute	D.10 `csexport`	D.17 `csschedule`
D.4 `csbackup`	D.11 `csimport`	D.18 `csstats`
D.5 `cscal`	D.12 csplugin	D.19 `csuser`
D.6 `csclean`	D.13 `cspurge`	D.20 `start-cal`
D.7 `cscomponents`	D.14 `csrename`	D.21 `stop-cal`
D.8 `csdb`	D.15 `csresource`
D.9 `csdomain`	D.16 `csrestore`

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

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 文件中。

本章提供了以下信息：

D.1 运行命令行实用程序

D.1 运行命令行实用程序

以运行 Calendar Server 的用户和组身份或以 root 身份登录时，运行命令行实用程序。这将在安装过程中指定，默认为 icsuser 和 icsgroup。

例如，如果 Calendar Server 基目录为 cal-svr-base，要运行 cscal 实用程序的 list 命令，应在登录后执行以下命令：

cd cal-svr-base/SUNWics5/cal/sbin
./cscal list

D.1.1 命令行实用程序的语法

Calendar Server 命令行实用程序使用以下语法：

utility [ -option [value]] command [target]

其中：

utility 是可执行实用程序的名称，例如 cscal 或 csuser。

option 决定命令要执行的操作。选项以小写字母表示，前面带有连字符 (-)，例如 -d。括号 ([]) 内的选项为可选选项。如果表明是可选选项，则可以同时使用两个或多个选项。

value 进一步限制了 option 指定的操作，例如随 -d 选项一起使用的说明。括号 ([]) 内的值为可选值。包含空格的值必须括在双引号 (" ") 中。多个值必须括在双引号 (" ") 中，值与值之间必须用空格隔开，除非另有说明（例如使用分号分隔的列表）。

command 是实用程序执行的操作，例如 list 或 create。命令之间用竖线 (|) 隔开，表示可以使用任意一条命令，但不能同时使用这两条命令。

target 是命令执行的对象，例如日历 ID 或用户 ID。

D.1.2 命令行实用程序使用规则

以下规则是命令行实用程序的一般使用准则：

如果只指定实用程序名称，它将列出所有命令、选项和多个示例。
如果不指定必需的密码，实用程序将提示您输入密码。
-v（详细）和 -q（静默）选项可用于所有实用程序。
如果某个命令具有破坏性（即，可能会导致数据丢失），实用程序将在执行该命令之前提示用户进行确认。举例而言，cscal 和 csuser 就是具有破坏性的命令，前者可以删除日历，后者可以删除用户。但 -q（静默）选项可以禁用确认提示。
version 命令可用于所有实用程序。

D.1.3 脚本中的返回码

如果从脚本中运行命令行实用程序，则实用程序运行成功时，返回码为 "0"，运行失败时返回码为 "-1"。

D.2 命令行实用程序的简短说明

下表给出了 Calendar Server 命令行实用程序的简短说明。

表 D–1 Calendar Server 命令行实用程序汇总


实用程序	说明
D.3 csattribute	管理 Schema 版本 1 的日历用户或资源的 LDAP 属性。
D.4 `csbackup`	备份单个日历、用户和日历数据库。
D.5 `cscal`	管理日历及其属性。
D.6 `csclean`	删除状态属性 (inetUserStatus) 已被 Delegated Administrator 标记为“已删除”的 Calendar Server 用户的用户日历和资源日历。
D.7 `cscomponents`	管理日历组件：事件和任务（待办事项）。
D.8 `csdb`	管理日历数据库。
D.9 `csdomain`	管理 Schema 版本 1 的域 LDAP 条目中的 Calendar Server 属性。
D.10 `csexport`	以 iCalendar (.ics) 或 XML (`.xml`) 格式导出日历。
D.11 `csimport`	以 iCalendar (.ics) 或 XML (`.xml`) 格式导出日历。
D.13 `cspurge`	允许手动清除“删除日志”数据库 (`ics50deletelog.db`) 中的条目。
D.14 `csrename`	允许重命名用户 ID。将导致整个数据库被重写。
D.15 `csresource`	管理日历资源，例如会议室和设备。
D.16 `csrestore`	恢复单个日历、用户和日历数据库。
D.17 `csschedule`	管理组调度引擎 (Group Scheduling Engine, GSE) 队列中的计划条目。
D.18 `csstats`	在 Calendar Server 中显示计数器。
D.19 `csuser`	管理 Schema 版本 1 的日历用户。
D.20 `start-cal`	启动所有 Calendar Server 进程。
D.21 `stop-cal`	停止所有 Calendar Server 进程。

D.3 csattribute

csattribute 实用程序仅在 Schema 版本 1 模式下起作用。它管理 Calendar Server 用户或资源 LDAP 条目属性。命令包括：

add，用于将 LDAP 属性和值添加到指定的目标（用户对象或资源对象）。
list，用于列出目标对象的属性。
delete，用于从目标中删除属性。

注 –

如果您的站点正在使用 LDAP CLD 插件，请勿在尝试指定新的后端主机服务器时使用 csattribute 来更改 icsDWPHost 属性。修改 icsDWPHost 并不会在新后端主机上创建新日历。有关更多信息，参见第 5 章，在 Calendar Server 版本 6.3 中配置跨多个计算机的日历数据库分发。

D.3.1 要求

必须使用 Schema 版本 1。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户或组（例如 icsuser 和 icsgroup）身份登录，或以 root 身份登录。

D.3.2 语法

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` 参数。

D.3.3 示例

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

csattribute - a icsCalendar=tchang add tchang
从 tchang 中删除 LDAP 属性 icsCalendar：

csattribute -a icsCalendar delete tchang
显示 tchang 的属性：

csattribute list tchang

D.4 `csbackup`

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

database，用于备份日历数据库。
calendar，用于备份指定日历。
defcal，用于备份用户的默认日历。
version，用于显示当前安装的实用程序的版本号。

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

有关 csrestore 的信息，参见 D.16 csrestore。

D.4.1 要求

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

D.4.2 语法

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` 文件中定义的设置 `service.schema2root`。基本 DN（标识名）为 LDAP 目录中的项，搜索将从此处开始。例如，如果您指定基本 DN 为 `ou=people, o=sesta.com`，则由 Calendar Server 执行的所有 LDAP 搜索操作仅检查 `o=sesta.com` 目录树中的 `ou=people` 子树。
`-c calid`	要备份的日历 ID。运行 `calendar` 命令时，此选项是必需的。无默认值。有关更多信息，请参见15.2 创建日历的唯一标识符 (calid)。
`-f`	强制删除现有的备份文件。在当前发行版中，如果备份目标目录已经存在，则必须包含选项 `-f`，即使该目录为空。
`-l`	准备要在 Solstice^TM Backup^TM 或 Legato Networker^TM 备份程序中使用的备份文件。有关更多信息，参见第 17 章，备份和恢复 Calendar Server 数据。

D.4.3 示例

将日历数据库备份到名为 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

D.5 `cscal`

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

create，用于创建日历
delete，用于删除日历
disable，用于禁用日历
enable，用于启用日历
list，用于列出日历
modify，用于修改日历属性和组调度访问控制
reset，用于将日历属性重置为默认设置
version，用于显示当前安装的实用程序的版本号

D.5.1 要求

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

D.5.2 语法

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 格式的详细信息，参见 1.8 Calendar Server 版本 6.3 的访问控制。
`-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`	（小写字母 o）主要所有者。默认设置为主要所有者的唯一 ID (`uid`)。
`-O`	（大写字母 O）指定主要所有者的所有日历。默认情况下只有指定的日历。
`-y otherowners`	其他日历所有者。多个所有者必须括在双引号 (`""`) 中，所有者之间用空格隔开。默认情况下无其他所有者。

D.5.3 在后端服务器上创建日历时可能发生的问题

如果尝试在指定的后端服务器上创建日历，则会看到以下错误消息：无效的 DWP 主机服务器。它意味着以下两种情况之一：服务器配置不正确，或者已将日历所有者分配给另一后端服务器。

D.5.3.1 后端服务器配置不正确

查看出现问题的后端服务器的 ics.conf 文件。确认是否存在以下设置：

service.dwp.enable = "yes"
caldb.cld.type = "directory"
local.hostname = "back-end hostname"

D.5.3.2 将日历所有者分配给了另一后端服务器

查看用户的 LDAP 条目，看看是否存在 icsDWPHost 属性。icsDWPHost 的值必须与您正在尝试在其上创建日历的后端服务器名称相同。不能在另一后端服务器上为该用户创建日历。

D.5.4 示例

使用默认访问控制设置（如 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

D.6 `csclean`

csclean 实用程序仅在 Schema 版本 2 模式下起作用。它将删除状态属性 (icsStatus) 已被 Delegated Administrator 标记为“已删除”的用户的用户日历和资源日历。

对于 Schema 版本 1，使用 csuser 和 cscal 来删除已删除用户的所有日历。

D.6.1 要求

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

D.6.2 语法

csclean [-q | -v] 
        [-g graceperiod]
        clean domain

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

表 D–8 csclean 实用程序命令选项


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

D.6.3 示例

删除 sesta.com 中日历服务已被删除至少 5 天的所有用户和资源的日历：

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

csclean clean "*"

D.7 `cscomponents`

cscomponents 实用程序管理日历组件：事件和任务（待办事项）。命令包括：

delete，用于删除日历中的事件和任务。
list，用于列出日历中的事件和任务。
version，用于显示当前安装的实用程序的版本号。

D.7.1 要求

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

D.7.2 语法

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`	对其执行操作的组件类型（事件或任务）。默认值为事件和任务。

D.7.3 示例

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

cscomponents -s 20000101T000000Z -e 20001231T000000Z delete tchang
列出日历 ID 为 tchang 的日历中所有事件和任务的详细信息：

cscomponents -v list tchang

D.8 `csdb`

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

create，用于创建新数据库。（如果启动服务器时数据库不存在，Calendar Server 将自动创建一个数据库。）
delete，用于删除现有的日历数据库。不能删除打开的数据库（当 Calendar Server 正在运行时）。
list，用于列出有关数据库的信息。
check，用于检查日历数据库以确定数据库是否被损坏。
rebuild，用于重建已损坏的日历数据库。
recover，用于恢复已损坏的日历数据库。
version，用于显示当前安装的实用程序的版本号。

D.8.1 要求

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

D.8.2 语法

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`（日历）进行操作。

D.8.3 示例

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

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

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

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

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

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

csdb -a -V rebuild

D.9 `csdomain`

csdomain 实用程序可管理域 LDAP 条目中的 Calendar Server 属性。这些属性是 icsCalendarDomain 对象类的一部分。命令包括：

create，用于在 LDAP 目录中创建新的域条目。
add，用于在域条目中添加 Calendar Server 属性及其关联值。
delete，用于删除域条目中的 Calendar Server 属性，或删除整个域。
list，用于列出域 LDAP 条目中的 Calendar Server 属性。

D.9.1 要求

要运行 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 添加结构树节点之前，必须已阅读第 10 章，设置多域 Calendar Server 6.3 环境中的说明。
  必须在已安装 Calendar Server 的本地计算机上运行 csdomain。
Calendar Server 可以正在运行或已经停止。
必须以安装过程中指定的运行 Calendar Server 的用户和组（例如 icsuser 和 icsgroup）身份登录，或以 root 身份登录。

D.9.2 语法

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 目录中创建新域。
`add`	在域 LDAP 条目中添加 Calendar Server 属性及其关联值。如果使用 `csdomain` 添加或更新域属性，必须重新启动 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 名及其可选值。有关这些属性和 property 名的列表的信息，参见 D.9.3 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`

D.9.3 LDAP 属性和 property 名

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

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

D.9.3.1 `icsAllowRights` 属性：`csdomain` 实用程序

D.9.3 LDAP 属性和 property 名介绍了可以使用 csdomain 实用程序设置的 icsAllowRights 属性及其 property。属性是一个 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` 命令来设置通用名称 (Common Name, 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		当前发行版中未使用。

D.9.3.2 `icsExtendedDomainPrefs` 属性：`csdomain` 实用程序

下表介绍了可以使用 csdomain 实用程序设置的 icsExtendedDomainPrefs 属性及其 property。每个属性都有一个对应的 ics.conf 参数。如果某个属性没有设置（例如，值 = 0 或 service.virtualdomain.support = "no"）或不存在，则 Calendar Server 将使用对应的 ics.conf 参数作为默认值。

表 D–16 icsExtendedDomainPrefs LDAP 目录属性


property 名	说明
`allowProxyLogin`	指定 `"yes"`（允许代理登录）或 `"no"`（不允许代理登录）。对应的 `ics.conf` 参数： `service.http.allowadminproxy`（默认值 = `"yes"`）
`calmasterAccessOverride`	指定 `"yes"`（允许 Calendar Server 管理员覆盖访问控制）或 `"no"`（不允许 Calendar Server 管理员覆盖访问控制）。对应的 `ics.conf` 参数： `service.admin.calmaster.overrides.accesscontrol`（默认值 = `"no"`）
`calmasterCred`	指定一个 ASCII 字符串，该字符串是指定为 Calendar Server 域管理员的用户 ID 的密码。对应的 `ics.conf` 参数： `service.siteadmin.cred`（无默认值）
`calmasterUid`	指定一个 ASCII 字符串，该字符串是指定为 Calendar Server 域管理员的用户的用户 ID。对应的 `ics.conf` 参数： `service.siteadmin.userid`（无默认值）
`createLowercase`	如果指定 yes，创建新日历或搜索日历时 Calendar Server 会将日历 ID (calid) 转换为小写；如果指定 no，则不进行转换。对应的 `ics.conf` 参数： `calstore.calendar.create.lowercase`（默认值 = "no"）
`domainAccess`	指定域的访问控制列表 (ACL)。有关 ACL 的信息，参见 1.8.3 Calendar Server 版本 6.3 的访问控制列表 (Access Control List, ACL)。此 ACL 用于交叉域搜索。有关详细信息，参见 11.2 在 Calendar Server 6.3 系统中执行交叉域搜索。注意 – 仅允许单个 `domainAccess` 实例。但是，如果存在重复，系统并不会发出警告。只要更改值，必须确保只有一个实例。
`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`（无默认值）

D.9.3.3 其他 LDAP 目录属性：`csdomain` 实用程序

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

表 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` 文件。

D.9.4 示例

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

D.10 `csexport`

csexport 实用程序将日历以 iCalendar (.ics) 或 XML (.xml) 格式导出至某个文件。命令包括：

calendar，用于导出指定日历。
version，用于显示当前安装的实用程序的版本号。

D.10.1 要求

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

D.10.2 语法

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 命令时，此选项是必需的。无默认值。

D.10.3 示例

以 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

D.11 `csimport`

csimport 实用程序可从 csexport 实用程序保存的 iCalendar (ics) 或 XML 格式的文件中导入日历。命令包括：

calendar –用于导入指定日历。
version –用于显示当前安装的实用程序的版本号。

导入日历组件时使用与该组件相关联的 X-NSCP-DTSTART-TZID 中指定的时区来计算日期。如果不存在这样的时区，则使用在 ics.conf 中找到的服务器时区。

D.11.1 要求

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

D.11.2 语法

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 已经存在，导入的数据将与当前日历合并。无默认值。有关更多信息，请参见15.2 创建日历的唯一标识符 (calid)。

D.11.3 示例

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

csimport -c tchang calendar tchang.ics
从格式为 XML（text/xml 文件）的文件 tchang.xml 中导入日历 ID 为 tchang 的日历：

csimport -c tchang calendar tchang.xml

D.12 csplugin

csplugin 用于管理为 Calendar Server 安装配置的 CSAPI 插件。命令包括：

activate，用于装入并启动指定插件。
deactivate，用于关闭并禁用指定的插件类型和插件名称。（有关支持的插件类型的说明，参见表 D–23 中的 -t 选项。）
list，用于显示所有支持的插件。
version，用于显示当前安装的实用程序的版本号。

D.12.1 要求

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

D.12.2 语法

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

csplugin [-q|-v] list

下表介绍了可用于 csplugin 实用程序的命令。

表 D–22 csplugin 实用程序命令


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

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

表 D–23 csplugin 实用程序命令选项


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

D.12.3 示例

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

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

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

csplugin deactivate -t lookup mylookup -r

D.13 `cspurge`

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

D.13.1 要求

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

D.13.2 语法

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

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

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


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

D.13.3 示例

清理“删除日志”中的所有条目：

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

D.14 `csrename`

csrename 实用程序允许重命名一个或多个日历用户。此实用程序按以下方式重命名日历用户：

日历数据库文件–重命名日历数据库文件中的用户（用户 ID），然后将新数据库文件写入目标目录。不修改现有的日历数据库文件。
LDAP Directory Server–转换 Calendar Server LDAP 属性（即，带有 "ics" 前缀的属性）中的用户 ID。适当修改 LDAP Directory Server 。

csrename 实用程序位于以下目录中：

cal-svr-base /SUNWics5/cal/sbin

D.14.1 要求

运行 csrename 前，您必须先：

为要转换的用户创建输入映射文件（-m 选项）。
创建 LDAP Directory Server 中的所有新用户（如果需要）。
停止 Calendar Server。

要运行 csrename，必须以 icsuser（或在配置过程中指定的 Calendar Server 运行时用户 ID）身份登录。如果您以超级用户 (root) 身份运行 csrename，则可能需要重置对新数据库文件的权限。要修改 LDAP Directory Server 属性，您还必须具有该目录的管理权限。

如果 Calendar Server 安装具有前端/后端服务器配置，则必须在每个后端服务器上运行 csrename。

D.14.2 语法

使用以下语法来运行 csrename：

csrename [-t DestinationDB] 
         [-c ConfigFile]
         [-e ErrorFile] 
          -m MappingFile 
         rename [DB|LDAP]

该表列出了此实用程序的选项以及对每个选项的说明：

表 D–25 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。

D.14.3 示例

根据名为 DBMapFile 的映射文件来重命名用户，并在名为 newcalDB 的目标目录中创建新的日历数据库：

csrename -t newcalDB -m DBMapFile rename DB
根据名为 NewNames 的映射文件中的值重命名用户，在名为 NewDB 的目标目录中创建新的日历数据库，并修改 LDAP Directory Server 中的 Calendar Server 属性：

csrename -t NewDB -m NewNames rename LDAP

D.15 `csresource`

csresource 实用程序为资源（如会议室或设备）创建并管理 LDAP 条目和日历。（csresource 实用程序仅对与资源关联的日历可用，如果将其用于用户日历，将返回错误。）命令包括：

create，用于在指定日历 ID (calid) 中添加新资源
delete，用于移除一项资源或所有资源
disable，用于禁用一项资源或所有资源
enable，用于启用一项资源或所有资源
list，用于显示单项资源或所有资源的列表

D.15.1 要求

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

D.15.2 语法

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


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-a [aces]`	指定日历的访问控制条目 (Access Control Entries, ACE)。ACE 决定可以访问组调度日历的人员以及他们拥有的权限类型，例如创建、删除、读取和写入权限。ACE 字符串或存取控制表 (Access Control List, ACL) 必须括在双引号 (`" "`) 中。默认值来自 `ics.conf` 文件中的 `resource.default.acl` 参数。有关 ACE 格式的信息，请参见15.4 日历访问控制。
`-b [basedn]`	要用于指定资源的 LDAP 基本 DN（distinguished name，标识名）。默认值来自 `ics.conf` 文件中的 `local.ugldapbasedn` 参数。
`-c calid`	`icsCalendar` 属性。运行 create 命令时，此选项是必需的。有关更多信息，请参见15.2 创建日历的唯一标识符 (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.siteadmin.userid`。
`-y otherowners`	其他所有者。多个所有者必须括在双引号 (`" "`) 中，所有者之间用空格隔开。默认情况下无其他所有者。
`version`	显示实用程序的版本。

D.15.3 示例

显示所有资源日历及其 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

D.16 `csrestore`

csrestore 实用程序恢复使用 csbackup 或 csexport 保存的日历数据库、指定日历或用户的默认日历。命令包括：

database，用于恢复日历数据库。
calendar，用于恢复指定日历。
defcal，用于恢复用户的默认日历。
version，用于显示当前安装的实用程序的版本号。

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

注意 –

Calendar Server 版本 6.3 的 csrestore 实用程序与 Calendar Server 版本 2 的 csrestore 实用程序不兼容。请勿尝试恢复使用版本 2 中的 csrestore 备份的数据，否则可能会导致数据丢失。

D.16.1 要求

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

注 –

csrestore 不会处理用户 LDAP 条目、订阅的或自身的日历。需对用户 LDAP 条目执行手动操作以根据多值属性 icsSubscribed 恢复个人日历。

D.16.2 语法

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

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

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

下表介绍了可用于 csrestore 实用程序的命令。

表 D–28 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–29 csrestore 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-a userid`	要恢复的用户 ID。使用默认选项时，此选项是必需的。无默认值。
`-b basedn`	要用于指定用户 ID 的 LDAP 基本标识名 (Distinguished Name, DN)。默认值来自 `ics.conf` 文件中定义的 `local.ugldapbasedn` 设置。
`-f`	强制删除现有的数据库文件。
`-c` `calid`	要恢复的日历 ID。运行 `calendar` 命令时，此选项是必需的。无默认值。有关更多信息，请参见15.2 创建日历的唯一标识符 (calid)。

D.16.3 示例

恢复以前使用 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

D.17 `csschedule`

csschedule 实用程序管理组调度引擎 (Group Scheduling Engine, GSE) 队列中存储的计划条目。命令包括：

list，用于显示指定日历 ID 请求的 GSE 队列中的条目。
delete，用于从指定日历 ID 请求的 GSE 队列中删除一个条目。
version，用于显示当前安装的实用程序的版本号。

D.17.1 要求

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

D.17.2 语法

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


命令	说明
`list`	显示指定日历 ID 请求的 GSE 队列中的条目。
`delete`	从指定日历 ID 请求的 GSE 队列中删除一个条目。
`version`	显示实用程序的版本。

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

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


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-c count`	要列出的 GSE 队列条目的数量。例如，如果要检查队列中的十个条目，请指定 10。
`-e endtime`	GSE 队列中条目的结束时间，其中 0 表示在格林威治标准时间的午夜零点结束。默认值为 0。
`-n sequencenumber`	事件或任务在队列中的序列号。
`-o offset`	计划时间的偏移数。当同一时间有多个计划条目时，偏移数可以唯一标识 GSE 队列中的条目。
`-r rid`	事件或待办事项的周期 ID (Recurrence ID, RID)。RID 是用分号分隔的字符串列表，用于标识重复性事件或待办事项的每次事件。
`-s starttime`	GSE 队列中条目的开始时间，其中 0 表示在格林威治标准时间的午夜零点开始。默认值为 0。
`-t scheduletime`	计划时间，例如：`20001231T103045Z`
`-u uid`	GSE 队列中条目的唯一标识符 (Unique Identifier, UID)。

D.17.3 示例

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

D.18 `csstats`

csstats 实用程序显示了 Calendar Server 统计信息。命令包括：

list，用于列出指定 Calendar Server 子系统的计数器统计信息。
version，用于显示当前安装的实用程序的版本号。

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

D.18.1 要求

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

D.18.2 语法

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

下表介绍了可用于 csstats 实用程序的命令。

表 D–32 csstats 实用程序命令


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

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

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


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-i` iterations	重复查找统计信息的次数。默认值为 1。
`-r` registry	存储计数器统计信息的文件的名称和位置。默认值为： `/opt/SUNWics5/cal/lib/counter/counter`
`-s` delay	显示每条统计信息查找结果之前等待的时间（以秒为单位）。默认值为 1 秒。

D.18.3 示例

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

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

csstats list http
在一小时（3600 秒）内每隔 10 秒列出一次有关 WCAP 子系统 (wcapstat) 的计数器统计信息：

csstats -i 3600 - s 10 list wcap

D.19 `csuser`

csuser 实用程序仅在 Schema 版本 1 模式下起作用。它管理日历用户的 LDAP 条目以及用户的默认日历。命令包括：

check，用于检查是否允许用户执行日历操作。
create，用于允许用户执行日历操作。

注 –

此实用程序无法使用户获得 Communications Express 要求的通讯录。这必须使用 ldapmodify 手动完成。

delete，用于删除用户及其默认日历。

提示 –
如果用户拥有其他日历，此命令不会删除它们。使用 cscal 来删除已删除用户的其他日历。
disable，用于禁止用户登录 Calendar Server。
enable，用于允许用户登录 Calendar Server。
list，用于列出用户的日历属性。
reset，用于从 LDAP 条目中删除所有日历属性，包括 icsCalendarUser（对象类）、icsSubscribed、icsCalendarOwned、icsCalendar 以及 icsDWPHost（如果用户使用 LDAP CLD 设置）。

提示 –
发出此命令后，用户将不再能使用日历服务。如果要重新允许用户使用日历服务，需发出 csuser enable 命令。

如果使用 Directory Server，您还可以使用 ldapsearch 和 ldapmodify 实用程序。有关这两个实用程序的信息，请参阅以下 Web 站点上的 Directory Server 文档：

http://docs.sun.com/coll/1316.2

D.19.1 要求

必须使用 Schema 版本 1。
Calendar Server 可以正在运行或已经停止。
必须在已安装 Calendar Server 的本地计算机上运行实用程序。
存储日历用户信息的 LDAP 服务器必须正在运行。
必须以安装过程中指定的运行 Calendar Server 的用户和组（例如 icsuser 和 icsgroup）身份登录，或以 root 身份登录。

D.19.2 语法

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


命令	说明
`check userid`	检查是否已允许指定的用户 ID 执行日历操作。
`create userid`	创建指定的用户 ID，并允许该用户登录 Calendar Server。
`delete userid`	删除指定的用户 ID。
`disable userid`	通过向用户的 LDAP 条目添加 `icsAllowedServiceAcess="http"` 来禁止指定用户 ID 执行日历操作。
`enable userid`	通过从用户的 LDAP 条目中删除 `icsAllowedServiceAcess="http"` 来允许指定用户 ID 执行日历操作。
`list [userid]`	列出指定用户 ID 的日历属性。如果未指定用户 ID，则列出所有已启用用户的属性。如果包含`- h server-name` 选项，则列出该后端服务器上指定用户 ID（或所有已启用用户）的日历属性。
`reset userid`	将某个用户 ID 的所有日历属性重置为其默认设置。备注：重置用户 ID 的日历属性后，将删除用户的 LDAP 条目中的所有日历属性，包括 `icsCalendarUser`（对象类）、`icsSubscribed`、`icsCalendarOwned`、`icsCalendar` 以及 `icsDWPHost`（如果该用户使用 LDAP CLD 设置）。Calendar Server 管理员随后将不能代表该用户创建日历。 Calendar Server 管理员对用户发出 `csuser` enable 命令后，这些属性将在该用户的 LDAP 条目中恢复。
`version`	显示实用程序的版本。

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

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


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-b basedn`	要用于所有 LDAP 用户的基本 DN。默认值来自 `ics.conf` 文件中定义的 `local.ugldapbasedn` 设置。
`-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 格式的详细信息，参见 E.2.9 Calendar Server 服务配置。
`-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 姓。此选项是必需的。无默认值。

D.19.3 示例

检查是否已允许日历用户 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

D.20 `start-cal`

start-cal 实用程序用于按照以下顺序启动 Calendar Server 服务：

watcher —监视 Calendar Server 守护进程
enpd —事件通知服务 (Event Notification Service, ENS)
csstored —执行数据库的维护和备份操作
csnotifyd —通知服务
csadmind —管理服务
csdwpd —数据库有线协议 (Database Wire Protocol, DWP) 服务，它是只能通过远程 Calendar Server 数据库配置启动的分布式数据库服务
cshttpd —HTTP 服务

D.20.1 要求

必须在已安装 Calendar Server 的本地计算机上运行 start-cal。
必须以 root 身份登录。

D.20.2 语法

start-cal

D.20.3 示例

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

有关详细信息，参见12.1 启动和停止 Calendar Server 6.3 进程。

D.21 `stop-cal`

stop-cal 实用程序用于停止所有 Calendar Server 服务。

D.21.1 要求

必须在已安装 Calendar Server 的本地计算机上运行 stop-cal。
必须以 root 身份登录。

D.21.2 语法

stop-cal

D.21.3 示例

cal-svr-base/SUNWics5/cal/sbin/stop-cal

有关详细信息，参见12.1 启动和停止 Calendar Server 6.3 进程。

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

D.1 运行命令行实用程序

D.1.1 命令行实用程序的语法

D.1.2 命令行实用程序使用规则

D.1.3 脚本中的返回码

D.2 命令行实用程序的简短说明

D.3 csattribute

D.3.1 要求

D.3.2 语法

D.3.3 示例

D.4 csbackup

D.4.1 要求

D.4.2 语法

D.4.3 示例

D.5 cscal

D.5.1 要求

D.5.2 语法

D.5.3 在后端服务器上创建日历时可能发生的问题

D.5.3.1 后端服务器配置不正确

D.5.3.2 将日历所有者分配给了另一后端服务器

D.5.4 示例

D.6 csclean

D.6.1 要求

D.6.2 语法

D.6.3 示例

D.7 cscomponents

D.7.1 要求

D.7.2 语法

D.7.3 示例

D.8 csdb

D.8.1 要求

D.8.2 语法

D.8.3 示例

D.9 csdomain

D.9.1 要求

D.9.2 语法

D.9.3 LDAP 属性和 property 名

D.9.3.1 icsAllowRights 属性：csdomain 实用程序

D.9.3.2 icsExtendedDomainPrefs 属性：csdomain 实用程序

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

D.9.4 示例

D.10 csexport

D.10.1 要求

D.10.2 语法

D.10.3 示例

D.11 csimport

D.11.1 要求

D.11.2 语法

D.11.3 示例

D.12 csplugin

D.12.1 要求

D.12.2 语法

D.12.3 示例

D.13 cspurge

D.13.1 要求

D.13.2 语法

D.13.3 示例

D.14 csrename

D.14.1 要求

D.14.2 语法

D.14.3 示例

D.15 csresource

D.15.1 要求

D.15.2 语法

D.15.3 示例

D.16 csrestore

D.16.1 要求

D.16.2 语法

D.16.3 示例

D.17 csschedule

D.17.1 要求

D.17.2 语法

D.17.3 示例

D.18 csstats

D.18.1 要求

D.18.2 语法

D.18.3 示例

D.19 csuser

D.19.1 要求

D.19.2 语法

D.4 `csbackup`

D.5 `cscal`

D.6 `csclean`

D.7 `cscomponents`

D.8 `csdb`

D.9 `csdomain`

D.9.3.1 `icsAllowRights` 属性：`csdomain` 实用程序

D.9.3.2 `icsExtendedDomainPrefs` 属性：`csdomain` 实用程序

D.9.3.3 其他 LDAP 目录属性：`csdomain` 实用程序

D.10 `csexport`

D.11 `csimport`

D.13 `cspurge`

D.14 `csrename`

D.15 `csresource`

D.16 `csrestore`

D.17 `csschedule`

D.18 `csstats`

D.19 `csuser`

D.20 `start-cal`

D.21 `stop-cal`