Sun ONE Calendar Server 6.0 管理员指南 |
第 11 章
Calendar Server 命令行实用程序Sun ONE Calendar Server 提供了一组命令行管理实用程序,用户可在批处理命令、Shell 和脚本程序(例如 Perl)中调用这些实用程序。必要时,这些实用程序将使用 ics.conf 配置文件中的默认值。命令行实用程序位于以下目录中:
cal_svr_base/opt/SUNWics5/cal/sbin
本章提供了以下信息:
csattribute | csbackup | cscal | csclean | cscomponents | csdb
csdomain | csexport | csimport | csmonitor | csplugin | cspurge
csresource | csrestore | csschedule | csstart | csstats | csstop
csstored.pl | cstool | csuser | start-cal | stop-cal
运行命令行实用程序在 Solaris 系统上,要运行命令行实用程序,请以安装过程中指定运行 Calendar Server 的用户和组(默认值为 icsuser 和 icsgroup)身份登录,或以 root 用户身份登录。在大多数情况下,必须转到实用程序所在的目录。例如,在 Solaris 系统上,为 cal_svr_base/opt/SUNWics5/cal/sbin 目录。
命令行实用程序的语法
Calendar Server 命令行实用程序使用以下语法:
其中:
utility 是实用程序的可执行名称,例如 cscal 或 csuser。
option 决定命令要执行的操作。选项以小写字母表示,前面带有连字符 (-),例如 -d。括号 ([]) 内的选项为可选选项。如果表明是可选选项,则可以同时使用两个或多个选项。
value 进一步限制 option 指定的操作,例如随 -d 选项一起使用的说明。括号 ([]) 内的值为可选值。包含空格的值必须括在双引号 (" ") 中。多个值必须括在双引号 (" ") 中,值与值之间必须用空格隔开,除非另有说明(例如使用分号分隔的列表)。
command 是实用程序执行的操作,例如 list 或 create。命令之间用竖线 (|) 隔开,表示可以使用任意一条命令,但不可以同时使用所有命令。
target 是命令执行的对象,例如日历 ID 或用户 ID。
命令行实用程序使用规则
以下规则是命令行实用程序的一般使用规则:
脚本中的返回码
如果从脚本中运行命令行实用程序,运行成功时将返回“0”,运行失败时将返回“-1”。
命令行实用程序列表表 11-1 列出了 Calendar Server 命令行实用程序。
csattributecsattribute 实用程序用于管理 LDAP 服务器中的 Calendar Server 属性。命令包括:
- add,用于将 LDAP 属性和值添加到指定的目标(用户对象或资源对象)。
- list,用于列出目标对象的属性。
- delete,用于从目标中删除属性。
注 如果您的站点正在使用 LDAP CLD 插件,请不要通过使用 csattribute 修改 icsDWPHost 属性来指定新的后端主机服务器。修改 icsDWPHost 并不会在新的后端主机上创建新日历。有关详细信息,请参阅配置 LDAP 日历查找数据库 (CLD) 插件。
要求
语法
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
表 11-2 介绍了 csattribute 实用程序可用的命令。
表 11-2 csattribute 实用程序命令
命令
说明
add target
将 LDAP 属性和值添加到指定的目标(用户对象或资源对象)。
list target
列出目标对象的属性。
delete target
从目标中删除属性。
version
显示实用程序的版本。
表 11-3 介绍了 csattribute 实用程序命令选项。
表 11-3 csattribute 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-a attribute =value
或
-a attribute [=value ]
LDAP 属性和值:
-t user | resource
对象(用户对象或资源对象)的类型。默认值为用户。
[-d domain]
指定托管(虚拟)域的名称。默认值来自 ics.conf 文件中的 service.defaultdomain 参数。
示例
csbackupcsbackup 实用程序用于备份日历数据库、指定日历或用户的默认日历。命令包括:
位于指定备份目录中的 caldb.conf 版本文件显示了已备份的数据库的版本号。
有关 csrestore 的信息,请参阅 csrestore。
要求
语法
csbackup [-q|-v] -f database target
csbackup [-q|-v] -c calid calendar target
csbackup [-q|-v] -a userid [-b basedn] defcal target
表 11-4 介绍了 csbackup 实用程序可用的命令。
表 11-4 csbackup 实用程序命令
命令
说明
database target
将日历数据库备份到指定的目标数据库目录。默认情况下,目标数据库目录为:
cal_svr_base/opt/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
显示实用程序的版本。
表 11-5 介绍了 csbackup 实用程序命令选项。
表 11-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 Backup 或 Legato Networker 备份程序中使用的备份文件。有关详细信息,请参阅第 6 章“备份和恢复 Calendar Server 数据”。
示例
cscalcscal 实用程序用于管理日历及其特性。命令包括:
要求
语法
cscal [-q|-v] [-a aces] [-c charset] [-d description] [-g categories]
[-k yes|no] [-l langcode] [-m email] [-n name] [-o owner]
[-y otherowners] create|modify calid
cscal [-q|-v] [-o owner] [-O] delete|reset calid
cscal [-q|-v] [-o owner] [-O] disable|list [calid]
cscal [-q|-v] [-k yes|no] [-o owner] [-O] enable [calid]
表 11-6 介绍了 cscal 实用程序可用的命令。
表 11-6 cscal 实用程序命令
命令
说明
create calid
创建由 calid 指定的日历。
注意:如果您的站点正在使用 LDAP CLD 插件,则必须在用户的日历所驻留(或将要驻留)的同一后端服务器上创建新日历,正如用户的 icsDWPHost LDAP 属性所说明的那样。如果试图在不同的后端服务器上创建日历,Calendar Server 将返回一条错误信息。
delete calid
删除由 calid 指定的日历。
如果指定了 -o owner 选项,将删除主要属主为此指定属主的所有日历。
enable [calid]
启用由 calid 指定的日历。如果没有指定 calid,将启用所有日历。
如果指定了 -o owner 选项,将启用主要属主为此指定属主的所有日历。
disable [calid]
禁用由 calid 指定的日历。如果没有指定 calid,将禁用所有日历。
如果指定了 -o owner 选项,将禁用主要属主为此指定属主的所有日历。
list [calid]
列出由 calid 指定的日历的特性。如果没有指定 calid,将列出所有日历的特性。
如果指定了 -o owner 选项,将列出主要属主为此指定属主的所有日历。
modify calid
修改由 calid 指定的日历的特性。
reset calid
将由 calid 指定的日历的特性重置为默认的配置设置。
version
显示实用程序的版本。
表 11-7 介绍了 cscal 实用程序命令选项。
表 11-7 cscal 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-a [aces]
指定日历的访问控制条目 (ACE)。ACE 决定哪些用户可以访问日历的组计划功能,以及这些用户拥有哪些类型的权限,例如创建、删除、读和写权限。ACE 字符串或访问控制列表 (ACL) 必须括在双引号 (" ") 中。
默认值来自 ics.conf 文件中的 calstore.calendar.default.acl 参数。
有关 ACE 格式的详细信息,请参阅第 4 章“管理 Calendar Server 访问控制”。
-c charset
字符集。默认情况下无字符集。
-d description
说明(有关日历用途的可视注释)。默认无说明。
-g category
类别。多个类别必须括在双引号 (" ") 中,类别之间用空格隔开。默认情况下无类别。
-k yes|no
指定用户日历是否允许双重预定。例如,yes 表示可以为日历中的同一时段预定多个事件。
如果忽略 -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
其他日历属主。多个属主必须括在双引号 (" ") 中,属主之间用空格隔开。默认情况下无其他属主。
示例
cscleancsclean 实用程序用于移除状态属性 (inetUserStatus) 已被 Sun ONE Identity Server commadmin 实用程序标记为“已删除”的 Calendar Server 用户的用户日历和资源日历。
删除 Calendar Server 用户包括以下步骤:
有关 commadmin 实用程序的信息,请参阅《Sun ONE Messaging and Collaboration 1.0 User Management Utility Installation and Reference Guide》。
Sun ONE Messaging Server 使用类似的实用程序 msuerpurge 从消息存储中移除用户。有关 msuserpurge 实用程序的信息,请参阅《Sun ONE Messaging Server 6.0 Reference Manual》。
要求
语法
表 11-8 介绍了 csclean 实用程序命令选项。
表 11-8 csclean 实用程序命令选项
选项
说明
-q
在清静模式下运行:
默认值为 off。
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-g graceperiod
指定删除用户的日历服务后持续的天数。
默认值为 10 天。
示例
cscomponentscscomponents 实用程序用于管理日历组件:事件和任务(待办事件)。命令包括:
要求
语法
表 11-9 介绍了 cscomponents 实用程序可用的命令。
表 11-9 cscomponents 实用程序命令
命令
说明
delete calid
删除具有指定日历 ID 的日历中的事件和任务。
list calid
列出具有指定日历 ID 的日历中的事件和任务。
version
在屏幕上显示实用程序的版本。
表 11-10 介绍了 cscomponent 实用程序命令选项。
表 11-10 cscomponent 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-e endtime
组件的结束时间。结束时间为 0 表示在格林威治标准时间的午夜零点结束。默认值为 0。
-s starttime
组件的启动时间。开始时间为 0 表示在格林威治标准时间的午夜零点启动。默认值为 0。
-t event|task
对其执行操作的组件类型(事件或任务)。默认值为事件和任务。
示例
csdbcsdb 实用程序用于管理日历数据库(日历、会话和统计信息)。命令包括:
要求
语法
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 [-g] [dbdir [dstdir]]
表 11-11 介绍了 csdb 实用程序可用的命令。
表 11-11 csdb 实用程序命令
命令
说明
create [dbdir]
在指定的数据库目录中创建数据库。如果未指定数据库目录,将使用当前目录。如果启动服务器时数据库不存在,Calendar Server 将自动创建一个数据库。
delete [dbdir]
删除指定数据库目录中的数据库。如果未指定数据库目录,将使用当前目录。不能删除打开的数据库(当 Calendar Server 正在运行时)。
list [dbdir]
列出指定数据库目录中的数据库的信息。如果未指定数据库目录,将使用当前目录。
recover [dbdir]
尝试恢复指定数据库目录中已损坏的数据库。如果未指定数据库目录,将使用当前目录。
check [dbdir]
扫描指定数据库目录中的日历数据库以确定数据库是否被损坏,并在输出中报告扫描结果。如果未指定数据库目录,将使用当前目录。
rebuild [-g] [dbdir [dstdir]]
扫描指定数据库目录中的日历数据库以确定数据库是否被损坏,如果损坏,则重建一个日历数据库(.db 文件)。如果未指定数据库目录,将使用当前目录。
除了其他日历数据库外,-g 选项还将重建组计划引擎 (GSE) 数据库,dstdir 用于指定可选的目标目录。
version
显示实用程序的版本。
表 11-12 介绍了 csdb 实用程序命令选项。
表 11-12 csdb 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-f
强制恢复日历数据库。
-g
对于 rebuild 命令,除了其他日历数据库外,还将重建组计划引擎 (GSE) 数据库。
-t caldb|sessdb|statdb
指定目标数据库:
注意:如果没有指定 -t,csdb 将对所有数据库进行操作,但 check 和 rebuild 命令除外,这两个命令仅对 caldb(日历)进行操作。
示例
csdomaincsdomain 实用程序用于管理 LDAP 目录中的托管(虚拟)域的 Calendar Server 属性。这些属性是 icsCalendarDomain 对象类的一部分。命令包括:
要求
语法
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
表 11-13 介绍了 csdomain 实用程序可用的命令。
表 11-13 csdomain 实用程序命令
命令
说明
create
在 LDAP 目录中创建新的托管域。然后,在目录中的此条目下创建域的所有 Calendar Server 用户和资源。
add
在 LDAP 目录中为特定域添加 Calendar Server 属性及其关联值。如果使用 csdomain 添加或更新域的 LDAP 属性,必须重新启动 Calendar Server 才能使新值生效。
delete
从 LDAP 目录中删除某个特定托管域的 Calendar Server 属性,或删除整个域的所有 LDAP 条目。
list
列出 LDAP 目录中某个特定域的 Calendar Server 属性。
version
显示实用程序的版本。
表 11-14 介绍了 csdomain 实用程序命令选项。
表 11-14 csdomain 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-a attr[=value]
指定 LDAP 属性的特性名及其可选值。
有关这些属性和特性名的列表,请参阅 LDAP 属性和特性名。
-f filename
指定包含 Calendar Server LDAP 目录的特性名及其关联值的文本文件。例如:
createLowerCase="yes"
filterPrivateEvents="no"
fbIncludeDefCal="no"
subIncludeDefCal="no"
uiProxyUrl="https://proxyserver"-n node
按照如下说明应用到 create 命令:
如果没有指定节点,将使用域名。
domain
对于 add、delete 和 list 命令,指定 LDAP 目录中的现有域。
对于 create 命令,为将在 LDAP 目录中创建的新域指定一个唯一的名称。
例如:west.sesta.com
LDAP 属性和特性名
下表介绍了应用于 csdomain 实用程序的 LDAP 属性和特性名。这些属性是 icsCalendarDomain 对象类的一部分。添加或删除值时,必须使用特性名而不是属性名。
如果使用 csdomain 添加或更新域的 LDAP 属性,必须重新启动 Calendar Server 才能使新值生效。
icsAllowRights 属性:csdomain 实用程序
表 11-15 介绍了可以使用 csdomain 实用程序设置的 icsAllowRights 属性和特性。属性是一个 32 位的数字字符串,字符串中的每一位都对应于一种特定的用户权限。(在当前发行版中,一些位没有使用,默认情况下被设置为零。)如果设置了与某种特定权限对应的位(值 = 1),则不允许该权限。如果该位没有设置(值 = 0),则允许该权限。
icsAllowRights 属性中的每个特性都有一个对应的 ics.conf 参数。如果某个特性没有设置(值 = 0),或不存在 (service.virtualdomain.support = "no"),Calendar Server 将使用对应的 ics.conf 参数作为默认值。
icsAllowRights 的值是一个数字字符串,而不是一个整数。要在按位进行的操作中以编程方式使用 icsAllowRights,必须首先将其字符串值转换为整数。
表 11-15 icsAllowRights LDAP 目录属性和特性
位
特性名
说明
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
如果设置(第 15 位 = 1),则不允许用户使用 WCAP set_userprefs 命令来设置用户的默认日历 ID (nswccalid)。
对应的 ics.conf 参数:
service.wcap.allowsetprefs.nswccalid
16-31
无
当前发行版中未使用。
icsExtendedDomainPrefs 属性:csdomain 实用程序
表 11-16 介绍了可以使用 csdomain 实用程序设置的 icsExtendedDomainPrefs 属性和特性。每一个特性都有一个对应的 ics.conf 参数。如果某个特性没有设置(值 = 0),或不存在 (service.virtualdomain.support = "no"),Calendar Server 将使用对应的 ics.conf 参数作为默认值。
表 11-16 icsExtendedDomainPrefs LDAP 目录属性
特性名
说明
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,Calendar Express 将显示并使用“每人”访问控制列表 (ACL);如果指定 no,则不显示和使用。
对应的 ics.conf 参数:
ui.allow.anyone(默认值 = yes)
uiAllowDomain
如果指定 yes,Calendar Express 将显示并使用此域的访问控制列表 (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 实用程序
表 11-17 介绍了可以使用 csdomain 实用程序设置的其他 LDAP 属性和特性。
表 11-17 可以使用 csdomain 实用程序设置的其他 LDAP 目录属性
LDAP 属性
特性名
说明
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 的状态:
如果设置了 icsStatus,其值将覆盖 icsAllowedServiceAccess 属性。
如果没有设置 icsStatus,Calendar Server 将使用 icsAllowedServiceAccess 属性。
icsTimezone
timezone
指定导入文件时使用的时区 ID。例如,America/New_York 或 Asia/Tokyo。
有关支持的时区,请参阅 timezones.ics 文件。
示例
csexportcsexport 实用程序用于将日历以 iCalendar (.ics) 或 XML (.xml) 格式导出到文件。命令包括:
要求
语法
表 11-18 介绍了 csexport 实用程序可用的命令。
表 11-18 csexport 实用程序命令
命令
说明
calendar outputfile
将日历导出至指定的输出文件。文件的数据格式由指定的文件扩展名决定:
version
显示实用程序的版本。
表 11-19 介绍了 csexport 实用程序命令选项。
表 11-19 csexport 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-c calid
要导出的日历的日历 ID。运行 calendar 命令时,此选项是必需的。无默认值。
示例
csimportcsimport 实用程序以 iCalendar (ics) 或 XML 格式从使用 csexport 实用程序保存的文件中导入日历。命令包括:
要求
语法
表 11-20 介绍了 csimport 实用程序可用的命令。
表 11-21 介绍了 csimport 实用程序命令选项。
表 11-21 csimport 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-c calid
要导入的日历的日历 ID。运行 calendar 命令时,此选项是必需的。
如果指定的日历 ID 已经存在,导入的数据将与当前日历合并。无默认值。
有关详细信息,请参阅日历标识符 (calid)。
示例
csmonitorcsmonitor 实用程序是执行以下监视功能的脚本:
语法
表 11-22 介绍了 csmonitor 实用程序可用的命令。
表 11-23 csmonitor。
表 11-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。
csplugincsplugin 用于管理为 Calendar Server 安装配置的 CSAPI 插件。命令包括:
- activate,用于装入并启动指定插件。
- deactivate,用于关闭并禁用指定的插件类型和插件名称。(有关支持的插件类型的说明,请参阅表 11-25 中的“-t”选项。)
- list,用于显示所有支持的插件。
- version,用于显示当前安装的实用程序的版本号。
要求
语法
csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate
activate|deactivate plugin
csplugin [-q|-v] list
表 11-24 介绍了 csplugin 实用程序可用的命令。
表 11-24 csplugin 实用程序命令
命令
说明
activate -t type name
装入并启用指定的插件类型和插件名称。(有关支持的插件类型的说明,请参阅表 11-25 中的“-t”选项。)
deactivate -t type name
关闭并禁用指定的插件类型和插件名称。(有关支持的插件类型的说明,请参阅表 11-25 中的“-t”选项。)
list
列出所有支持的插件类型、名称和活动状态。(有关支持的插件类型的说明,请参阅表 11-25 中的“-t”选项。)
version
显示实用程序的版本。
表 11-25 介绍了 csplugin 实用程序命令选项。
表 11-25 csplugin 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-r
与 activate 命令一起使用时,将插件物理复制到 Calendar Server 的 plugin 目录中。
与 deactivate 命令一起使用时,从 plugin 目录中删除插件。
-t type
指定以下支持的插件类型之一:
示例
cspurgecspurge 实用程序允许手动清理“Delete Log”数据库 (ics50deletelog.db) 中的条目。
要求
语法
表 11-26 介绍了 cspurge 实用程序命令选项。
表 11-26 cspurge 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-e endtime
指定 GMT 结束时间(另请参阅 UTC 或 Zulu 时间)。其值最大为(小于)指定的时间。
默认值为 0,表示在格林威治标准时间的午夜零点结束。
-s starttime
指定 GMT 开始时间(另请参阅 UTC 或 Zulu 时间)。其值包括(大于或等于)指定的时间。
默认值为 0,表示在格林威治标准时间的午夜零点开始。
示例
csresourcecsresource 实用程序用于管理存储在 LDAP 服务器和 Calendar Server 数据库中的资源(例如会议室或设备)日历。(csresource 实用程序仅对与资源关联的日历可用,如果将其用于用户日历,将返回错误。)命令包括:
要求
语法
csresource [-q|-v] [-a aces] [-b basedn] [-d domain] [-t description] [-k yes|no] [-o owner] [-y otherowners] -m email -c calid create name
csresource [-q|-v] [-b basedn] [-d domain]
delete|disable|enable [name]
csresource [-q|-v] [-b basedn] [-d domain] [-h host] list [name]
表 11-27 介绍了 csresource 实用程序可用的命令。
表 11-27 csresource 实用程序命令
命令
说明
create name
为指定日历 ID 的日历创建新资源。
delete [name]
删除一项资源,如果没有指定资源名称 (name),则删除所有资源。
enable [name]
启用一项资源,如果没有指定资源名称 (name),则启用所有资源。
disable [name]
禁用一项资源,如果没有指定资源名称 (name),则禁用所有资源。
list [name]
显示单个资源日历,如果没有指定资源名称 (name),则显示所有资源日历。
如果包含 -h host 选项,则显示该后端服务器上具有指定名称的资源日历(或所有资源日历)的日历属性。
表 11-28 介绍了 csresource 实用程序命令选项。
表 11-28 csresource 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-a [aces]
指定日历的访问控制条目 (ACE)。ACE 决定哪些用户可以访问日历的组计划功能,以及这些用户拥有哪些类型的权限,例如创建、删除、读和写权限。ACE 字符串或访问控制列表 (ACL) 必须括在双引号 (" ") 中。
默认值来自 ics.conf 文件中的 resource.default.acl 参数。
有关 ACE 格式的信息,请参阅第 4 章“管理 Calendar Server 访问控制”。
-b [basedn]
要用于指定资源的 LDAP 基本 DN(独特的名称)。默认值来自 ics.conf 文件的 local.ugldapbasedn 参数。
-c calid
icsCalendar 属性。运行 create 命令时,此选项是必需的。有关详细信息,请参阅日历标识符 (calid)。
-d 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 [name]
显示实用程序的版本。
示例
csrestorecsrestore 实用程序用于恢复日历数据库,例如指定日历或者使用 csbackup 或 csexport 保存的用户的默认日历。命令包括:
位于指定备份目录中的 caldb.conf 版本文件显示了已备份的数据库的版本号。
注意 Calendar Server 6.x csrestore 与 csrestore 的 2.x 版本不兼容。请不要尝试恢复使用 Calendar Server 2.x csrestore 备份的数据,否则可能会导致数据丢失。
要求
语法
csrestore [-v|-q] [-f] database inputdir
csrestore [-v|-q] -c calid calendar inputfile
csrestore [-v|-q] -a userid [-b basedn] defcal inputfile
表 11-29 介绍了 csrestore 实用程序可用的命令。
表 11-29 csrestore 实用程序命令
命令
说明
database inputdir
从包含备份日历数据库的指定输入目录或输入文件中恢复日历数据库。此操作将覆写当前日历数据库的所有旧内容。
calendar inputfile
从指定的输入文件恢复具有指定日历 ID 的日历。文件的数据格式由文件扩展名决定:
如果具有指定日历 ID 的日历已经存在,将在恢复之前清除其数据。
defcal inputfile
从指定的输入文件中恢复具有指定用户 ID 的默认日历。文件的数据格式由文件扩展名决定:
version
显示实用程序的版本。
表 11-30 介绍了 csrestore 实用程序命令选项。
表 11-30 csrestore 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-a userid
要恢复的用户 ID。使用默认选项时,此选项是必需的。无默认值。
-b basedn
要用于指定用户 ID 的 LDAP 基本 DN(独特的名称)。默认值来自 ics.conf 文件中定义的 local.ugldapbasedn 设置。
-f
强制删除现有的数据库文件。
-c calid
要恢复的日历 ID。运行 calendar 命令时,此选项是必需的。无默认值。
有关详细信息,请参阅日历标识符 (calid)。
示例
csschedulecsschedule 实用程序用于管理存储在组计划引擎 (GSE) 队列中的计划条目。命令包括:
要求
语法
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]
表 11-31 介绍了 csschedule 实用程序可用的命令。
表 11-31 csschedule 实用程序命令
命令
说明
list
显示指定日历 ID 请求的 GSE 队列中的条目。
delete
从指定日历 ID 请求的 GSE 队列中删除一个条目。
version
显示实用程序的版本。
表 11-32 介绍了 csschedule 实用程序命令选项。
表 11-32 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 队列中条目的唯一标识符 (UID)。
示例
csstart
注 Calendar Server 提供了 csstart 和 csstop 实用程序只是为了与早期版本兼容。
建议使用 start-cal 和 stop-cal 实用程序来启动和停止 Calendar Server。有关详细信息,请参阅启动和停止 Calendar Server。
csstart 实用程序用于启动 Calendar Server。命令包括:
要求
语法
表 11-33 介绍了 csstart 实用程序可用的命令。
表 11-33 csstart 实用程序命令
命令
说明
check | list
[servicename]检查某个指定的 Calendar Server 服务是否正在运行,如果没有指定服务名称,则检查所有 Calendar Server 服务是否正在运行。
或者列出所有 Calendar Server 服务(或某个指定的服务)及其会话 ID。
servicename 可以是以下服务之一:
service [servicename]
启动指定的 Calendar Server 服务,如果没有指定服务名,则启动该服务器的所有服务。应按以下顺序启动 Calendar Server 服务:
1. ens — 一般事件登记和通知服务,可由其他 Sun ONE 服务器共享
2. notify — Calendar Server 通知服务
3. admin — Calendar Server 管理服务(每台服务器计算机都需要)
4. dwp — Calendar Server 数据库服务(仅随远程数据库配置一起启动)
5. http — Calendar Server HTTP 服务
有关 Calendar Server 服务的详细信息,请参见以下各节:
version
显示实用程序的版本。
表 11-34 介绍了 csstart 实用程序命令选项。
表 11-34 csstart 实用程序命令选项
选项 说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-f
强制对某个指定的 Calendar Server 服务(如果没有指定服务,则对所有当前正在运行的服务)执行以下操作:
1. 停止(类似于 kill -9 命令)。
2. 清除任何数据库问题。
3. 启动所有服务。
注意:建议使用 stop-cal 和 start-cal 实用程序来停止和启动 Calendar Server。
-q
在清静模式下运行:
默认值为 off。
示例
csstatscsstats 实用程序用于显示 Calendar Server 统计信息。命令包括:
有关计数器的详细信息,请参阅计数器配置文件 (counter.conf)。
要求
语法
表 11-35 介绍了 csstats 实用程序可用的命令。
表 11-35 csstats 实用程序命令
命令
说明
list [subsystem]
列出某个指定 Calendar Server 子系统的计数器统计信息。如果没有指定子系统,则显示可用子系统的基本信息,包括:
version
显示实用程序的版本。
表 11-36 介绍了 csstats 实用程序命令选项。
表 11-36 csstats 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-i iterations
重复查找统计信息的次数。默认值为 1。
-r registry
存储计数器统计信息的文件的名称和位置。默认值为:
/opt/SUNWics5/cal/lib/counter/counter
-s delay
显示每条统计信息查找结果之前等待的时间(以秒为单位)。默认值为 1 秒。
示例
csstop
注 Calendar Server 提供了 csstop 和 csstart 实用程序只是为了与其早期版本兼容。
建议使用 start-cal 和 stop-cal 实用程序启动和停止 Calendar Server。有关详细信息,请参阅启动和停止 Calendar Server。
csstop 实用程序用于停止 Calendar Server。命令包括:
要求
语法
表 11-37 介绍了 csstop 实用程序可用的命令。
表 11-37 csstop 实用程序命令
命令
说明
check | list
[servicename]检查某个指定的 Calendar Server 服务是否正在运行,如果没有指定服务名称,则检查所有服务是否正在运行。
或者列出所有 Calendar Server 服务或某个指定的服务及其会话 ID。servicename 可以是以下服务之一:
service [servicename]
停止指定的 Calendar Server 服务,如果没有指定服务名,则停止该服务器的所有服务。应按以下顺序启动 Calendar Server 服务,并按相反顺序停止:
1. ens — 一般事件登记和通知服务,可由其他 Sun ONE 服务器共享。
2. notify — Calendar Server 通知服务。
3. admin — Calendar Server 管理服务(每台服务器计算机都需要)。
4. dwp — Calendar Server 数据库服务(仅随远程数据库配置一起启动)。
5. http — Calendar Server HTTP 服务。
有关 Calendar Server 服务的详细信息,请参见以下各节:
- Calendar Server 访问控制
- 服务配置.
version
显示实用程序的版本。
.
表 11-38 介绍了 csstop 实用程序命令选项。
表 11-38 csstop 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-f
强制停止某个 Calendar Server 服务(如果上述尝试失败,则类似于 kill -9 命令)。
此选项只能与 service 命令一起使用。
示例
csstored.plcsstored.pl 实用程序是一个 Perl 脚本,用于为日历数据库和日志文件执行以下联机或“紧急”归档操作:
有关 Berkeley 数据库实用程序的文档,请访问 Sleepycat Software 公司的 Web 站点:
http://www.sleepycat.com/docs/utility/index.html
要求
语法
表 11-39 介绍了 ics.conf 文件中供 csstored.pl 实用程序使用的参数:
表 11-39 ics.conf 文件中供 csstored.pl 实用程序使用的参数
参数
说明
caldb.berkeleydb.homedir.path
指定存储日历数据库文件的目录路径。
默认值为“.”,该值指定以下目录:
cal_svr_base/var/opt/SUNWics5/csdb
caldb.berkeleydb.archive.path
指定日历数据库归档目录的路径。无默认值。
要运行 csstored.pl,请指定不同于日历数据库目录和“紧急”备份目录的路径。
caldb.berkeleydb.hotbackup.path
指定“紧急”备份目录的路径。无默认值。
要运行 csstored.pl,请指定不同于日历数据库目录和归档目录的路径。
caldb.berkeleydb.archive.enable
启用 (yes) 或禁用 (no) 日历数据库的归档操作。
默认值为 no。
要运行 csstored.pl,请将此参数设置为 yes。
caldb.berkeleydb.hotbackup.enable
启用 (yes) 或禁用 (no) 日历数据库的“紧急”备份操作。
默认值为 no。
要运行 csstored.pl,请将此参数设置为 yes。
caldb.berkeleydb.circularlogging
指定同步数据库检查点文件的事务后,是否(yes 或 no)移除这些文件。
默认值为 yes。
要运行 csstored.pl,请将此参数设置为 no。
caldb.berkeleydb.archive.interval
以秒为单位,指定归档日历数据库的时间间隔。
默认值为 120 秒。
cstoolcstool 实用程序用于强制回应 Calendar Server 或 cshttpd 服务/事件通知服务 (ENS)。cstool 还用于强制刷新 Calendar Server 或特定服务的配置。命令包括:
注 在当前发行版中,请不要使用 cstool refresh 来刷新配置。而应使用 stop-cal 和 start-cal 实用程序先停止 Calendar Server,然后重新启动。
有关详细信息,请参阅启动和停止 Calendar Server 和编辑 ics.conf 配置文件。
要求
语法
cstool [-q|-v] [-h host] [-p port] [-t timeout] ping [http|ens]
cstool [-q|-v] [-h host] refresh [servicename]
表 11-40 介绍了 cstool 实用程序可用的命令。
表 11-40 cstool 实用程序命令
命令
说明
ping [http|ens]
强制回应 cshttpd 或 ENS 服务。
refresh [servicename]
强制 Calendar Server 刷新指定服务的配置,如果没有指定服务,则刷新所有 Calendar Server 服务的配置。Calendar Server 服务选项如下:
version
显示实用程序的版本。
表 11-41 介绍了 cstool 实用程序命令选项。
表 11-41 cstool 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-h host
指定运行 Calendar Server 的计算机的主机名。默认值为安装时设置的主机名,来自 ics.conf 文件中的 local.hostname 参数。访问远程计算机上运行的 Calendar Server 时,请使用此选项。
-p port
指定服务的端口,如果没有指定服务,则使用 ics.conf 文件中定义的端口默认值。
-t timeout
等待服务器响应的时间(以秒为单位)。默认值为 120 秒。
示例
csusercsuser 实用程序用于管理存储在 LDAP 目录服务器和 Calendar Server 日历数据库中的日历用户信息。命令包括:
如果使用 Sun ONE Directory Server,那么还可以使用 ldapsearch 和 ldapmodify 实用程序。有关这两个实用程序的信息,请参阅以下 Web 站点上的 Sun ONE Directory Server 文档:
http://docs.sun.com/coll/S1_DirectoryServer_52
要求
语法
csuser [-q|-v] [-a aces] [-b basedn] -m email [-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
表 11-42 介绍了 csuser 实用程序可用的命令。
表 11-42 csuser 实用程序命令
命令
说明
check userid
检查是否已允许指定的用户 ID 执行日历操作。
create userid
创建指定的用户 ID,并允许该用户登录 Calendar Server。
delete userid
删除指定的用户 ID。
disable userid
禁用指定的用户 ID 执行日历操作。实用程序将 http 定义为 nswcalDisallowAccess 属性的值。
enable userid
允许指定的用户 ID 执行日历操作。(实用程序会将指定的日历 ID 添加到 nswcalCALID 属性中。)
list [userid]
列出指定用户 ID 的日历属性,如果没有指定用户 ID,则列出所有已启用用户的日历属性。
如果包含 -h server-name 选项,则列出该后端服务器上指定用户 ID(或所有已启用用户)的日历属性。
reset userid
将某个用户 ID 的所有日历属性重置为其默认设置。
注意:重置用户 ID 的日历属性后,将移除用户 LDAP 条目中的所有日历属性,包括 icsCalendarUser(对象类)、icsSubscribed、icsCalendarOwned、icsCalendar 和 icsDWPHost(如果该用户处于 LDAP CLD 设置中)。Calendar Server 管理员将不能再以该用户的名义创建日历。
Calendar Server 管理员对用户发出 csuser enable 命令后,这些属性将存储在该用户的 LDAP 条目中。
version
显示实用程序的版本。
表 11-43 介绍了 csuser 实用程序命令选项。
表 11-43 csuser 实用程序命令选项
选项
说明
-v
在繁絮模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。
-q
在清静模式下运行:
默认值为 off。
-d domain
指定托管(虚拟)域的名称。默认值来自 ics.conf 文件中的 service.defaultdomain 参数。
-a [aces]
指定日历的访问控制条目 (ACE)。ACE 决定哪些用户可以访问日历的组计划功能,以及这些用户拥有哪些类型的权限,例如创建、删除、读和写权限。ACE 字符串或访问控制列表 (ACL) 必须括在双引号 (" ") 中。
默认值为:
@@o^a^r^g;@@o^c^wdeic^g;@^a^sf^g;@^c^^g;@^p^r^g
有关 ACE 格式的详细信息,请参阅服务配置。
-b [basedn]
指定用户 ID 的 LDAP 基本 DN(独特的名称)。
默认值来自 ics.conf 文件的 local.ugldapbasedn 参数。
-c [calid]
与指定用户 ID 关联的默认日历的日历 ID。默认值为用户 ID。此选项对 create 命令无效。
有关详细信息,请参阅日历标识符 (calid)。
-f filename
用于为需要密码的选项(-y 参数)指定密码的文件的名称。如果从脚本运行 csuser,建议在 filename 中指定密码,以增加安全性。
-g givenname
用户的 LDAP 名。此选项是必需的。无默认值。
-h host
指定用户日历所在的后端服务器的名称。此选项仅适用于 list 命令。
-k yes|no
指定用户日历是否允许双重预定。如果指定为 yes,则可以为用户日历的同一时段预定多个事件。
默认值来自 ics.conf 文件中定义的设置 user.allow.doublebook。
-l [langcode]
语言代码。默认值来自 ics.conf 文件中 local.sitelanguage。
-m email
指定用户的 LDAP mail 属性(主要电子邮件地址)。
-s surname
用户的 LDAP 姓。此选项是必需的。无默认值。
-y userpassword
所需的日历用户的密码。无默认值。
示例
start-calstart-cal 实用程序按以下顺序启动 Calendar Server 服务:
要求
语法
示例
./start-cal
有关详细信息,请参阅启动和停止 Calendar Server。
stop-calstop-cal 实用程序用于停止所有 Calendar Server 服务。
要求
语法
示例
./stop-cal
有关详细信息,请参阅启动和停止 Calendar Server。