Sun Java System Calendar Server 6.3 管理指南

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