上一章 目录 索引 下一章 |
Sun ONE Calendar Server 管理员指南 |
第 7 章 Calendar Server 命令行公用程序
Sun ONE Calendar Server 提供了一套命令行管理公用程序,您可从批处理文件、外壳程序以及诸如 Perl 这样的脚本语言调用这些公用程序。如有必要,这些公用程序会使用 ics.conf 配置文件中的默认值。
命令行公用程序位于 server-root/cal/bin 目录下。
运行命令行公用程序
命令行公用程序的说明(表)
csattribute
csresource
csbackup
csrestore
cscal
csschedule
cscomponents
csstart
csdb
csstats
csexport
csstop
csimport
cstool
csplugin
csuser
运行命令行公用程序
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(默认值是 icsuser 和 icsgroup)身份登录或以 root 身份登录,才能运行命令行公用程序。要在 Windows NT 系统上运行命令行公用程序,用户必须拥有全部的管理员权限。
多数情况下,必须定位到公用程序所在的目录 (server-root/cal/bin)。例如:
在 Solaris 上:
/opt/SUNWics5/cal/bin
在 Solaris 以外的 UNIX 系统上:
/opt/iPlanet/CalendarServer5/cal/bin
在 Windows NT 系统上:
c:\Program Files\iPlanet\CalendarServer5\cal\bin
命令行公用程序语法
Calendar Server 命令行公用程序使用以下语法:
utility [ -option [ value ] ] command [ target ]
utility 是公用程序的可执行文件名,例如 cscal 或 csuser。
option 确定命令所执行的操作。选项为小写,并以连字符 (-) 开头,例如 -d。方括号 ([]) 中的选项是可选的。若有指明,您可以同时使用两个或多个选项。
value 进一步限定由 option 指定的操作,例如使用 -d 选项进行说明。方括号 ([]) 中的值表示它是可选值。包含空格的值必须括在引号 (" ") 中。多个值必须括在引号 ("") 中,且每个值必须由空格分隔,除非另外指明(例如在某些情况下使用分号分隔列表)。
command 是公用程序执行的一种操作,例如 list 或 create。由垂直条 (|) 分隔的命令指出同时间可使用的其中一种(而不是所有)命令。
target 是命令产生作用的对象,如日历 ID 或用户 ID。
命令行公用程序的使用规则
以下规则是命令行公用程序的一般使用原则:
如果您没有指定命令,则公用程序会列出所有选项和命令以及示例。
如果是危险命令(即可能导致数据丢失的命令),则公用程序在执行命令前会提示您确认。危险命令的示例有 cscal(可删除日历)和 csuser(可删除用户)。但是 -q(无提示)选项会禁用确认提示。
命令行公用程序的说明
下表说明 Calendar Server 命令行公用程序。
表 7-1    Calendar Server 命令行公用程序摘要
公用程序
说明
对正在运行的 Calendar Server 实例执行 ping 操作,或刷新 Calendar Server 的配置。
csattribute
csattribute 公用程序可管理 LDAP 服务器中的 Calendar Server 属性。命令有:
add-将 LDAP 属性和值添加到指定的目标(用户或资源对象)。
备注 如果您的站点使用的是 LDAP CLD 插件,请不要使用 csattribute 属性更改 icsDWPHost 属性来指定新的后端主机服务器。修改 icsDWPHost 不会在新的后端主机上创建新日历。有关更多信息,请参阅 “LDAP 日历查找数据库 (CLD) 插件”。
要求
Calendar Server 可在运行状态或停止状态。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
表 7-2 说明可用于 csattribute 的命令。
表 7-2    csattribute 公用程序命令
命令
说明
表 7-3 说明 csattribute 公用程序命令选项。
表 7-3    csattribute 公用程序命令选项
选项
说明
将值为 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 公用程序可备份日历数据库、指定的日历或用户的默认日历。命令有:
位于指定备份目录的 caldb.conf 版本文件显示已备份数据库的版本号。
有关 csrestore 的信息,请参见 csrestore。
Calendar Server 可在运行状态或停止状态。
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
csbackup [-q|-v] -f database target
csbackup [-q|-v] -c calid calendar target
csbackup [-q|-v] -a userid [-b basedn] defcal target
表 7-4 说明可用于 csbackup 的命令。
表 7-5 说明 csbackup 公用程序命令选项。
表 7-5    csbackup 公用程序命令选项
选项
说明
用于此用户的基准 DN。默认值取自 ics.conf 文件中定义的 local.ugldapbasedn 设置。
例如,如果您指定的基准 DN 为 ou=people, o=sesta.com,则由 Calendar Server 执行的所有 LDAP 搜索操作将只检查 o=sesta.com 目录树中的 ou=people 子树。
要备份的日历 ID。此选项对 calendar 命令是必需的。没有默认值。
有关更多信息,请参见“日历标识符 (calid)”。
准备将用于 Solstice Backup 或 the Legato Networker 备份程序的备份文件。有关更多信息,请参见第 6 章 “备份和还原 Calendar Server 数据”。
将日历数据库备份到名为 backupdir 的目录:
csbackup database backupdir
将日历 ID 为 tchang 的日历以 text/calendar 格式备份到文件 tchang.ics:
csbackup -c tchang calendar tchang.ics
将 tchang 的默认日历以 text/xml 格式备份到文件 tchang.xml:
csbackup -a tchang defcal tchang.xml
cscal
cscal 公用程序可管理日历及其属性。命令有:
create-创建日历
要求
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
表 7-6 说明可用于 cscal 公用程序的命令。
命令
说明
备注:如果您的站点使用了 LDAP CLD 插件,则必须在放置(或将要放置)用户日历的同一后端服务器(由用户的 icsDWPHost LDAP 属性指示)上创建新日历。如果试图在其他后端服务器上创建日历,Calendar Server 将会返回错误。
表 7-7 说明 cscal 公用程序命令选项。
表 7-7    cscal 公用程序命令选项
选项
说明
指定日历的访问控制项 (ACE)。ACE 确定谁可以访问日历以进行组日程安排,以及他们所拥有的权限类型,如创建、删除、读取和写入权限。ACE 字符串或访问控制列表 (ACL) 必须用引号 ("") 括起来。
默认值是 ics.conf 文件中的 calstore.calendar.default.acl 参数。
有关 ACE 格式的详细信息,请参见第 4 章 “管理 Calendar Server 访问控制”。
日历是否允许双重预约。例如,yes 表示日历在同一时段内可以安排多个事件。默认值取自 ics.conf 文件中定义的 user.allow.doublebook 设置。
使用默认访问控制设置(由 ics.conf 文件中的 calstore.calendar.default.acl 所定义),创建日历 ID 为 tchang 的日历,并以 TChang 作为主要所有者,其可视名称为 Public_Calendar:
cscal -o TChang -n Public_Calendar create tchang
修改 chang 这个日历,使其可被每个人都读取和写入,且与 sports 类别关联,并由 JSmith 共同拥有:
cscal -a "@^a^rw^g" -g sports -y JSmith modify tchang
禁用日历 ID 为 tchang 的日历(用户将不能使用用户界面对其进行读取、写入或定位等操作):
cscal disable tchang
启用日历 ID 为 tchang 的日历(允许用户使用用户界面对其进行读取或写入等操作),但不允许双重预约:
cscal -k no enable tchang
列出 tchang 的属性:
cscal list tchang
列出 tchang 的所有属性:
cscal -v list tchang
列出数据库中的所有日历:
cscal list
将日历 ID 为 tchang 的日历重置为默认配置设置:
cscal reset tchang
从日历 ID 为 tchang 的日历中移除说明:
cscal -d "" modify tchang
从日历 ID 为 tchang 的日历中移除所有类别:
cscal -g "" modify tchang
从日历 ID 为 tchang 的日历中移除其他所有者:
cscal -y "" modify tchang
从日历数据库中删除 tchang:
cscal delete tchang
从日历数据库中删除所有主要所有者是 TChang 的日历:
cscal -o TChang delete
cscomponents
cscomponents 公用程序可管理日历组件:事件和任务(待办事项)。命令有:
要求
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
cscomponents [-v|-q] [-e endtime] [-s starttime] [-t event|task]
delete|list calid
表 7-8 说明可用于 cscomponent 公用程序的命令。
表 7-8    cscomponent 公用程序命令
命令
说明
表 7-9 说明 cscomponent 公用程序命令选项。
表 7-9    cscomponent 公用程序命令选项
选项
说明
删除日历 ID 为 tchang 的日历中所有 2000 年的事件:
cscomponents -s 20000101T000000Z -e 20001231T000000Z delete tchang
详细列出日历 ID 为 tchang 的日历中所有的事件和任务:
cscomponents -v list tchang
csdb
csdb 公用程序可管理日历数据库(日历、会话和统计信息)。命令有:
create-创建新的数据库。(如果启动服务器时数据库不存在,则 Calendar Server 会自动创建一个。)
要求
必须在安装 Calendar Server 的机器上运行该公用程序。
使用 create、delete 或 rebuild 命令时必须停止 Calendar Server。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
csdb [-q|-v] [-t caldb|sessdb|statdb] create|delete [dbdir] csdb [-q|-v] [-t caldb|sessdb|statdb] list [dbdir] csdb [-q|-v] [-f] [-t caldb|sessdb|statdb] recover [dbdir] csdb check|rebuild [dbdir]
表 7-10 说明可用于 csdb 公用程序的命令。
表 7-11 说明 csdb 公用程序命令选项。
表 7-11    csdb 公用程序命令选项
选项
说明
备注:如果没有指定 -t 选项,则 csdb 会作用于所有数据库,但 check 和 rebuilt 命令除外,它们只会作用于 caldb(日历)。
在当前目录中创建新的、未写入数据的数据库:
csdb -t caldb create
删除当前目录中的数据库:
csdb -t caldb delete
列出有关当前目录中的日历数据库信息:
csdb -v -t caldb list
尝试恢复当前目录中所有已损坏的数据库:
csdb recover
列出有关当前目录中的会话数据库信息:
csdb -t sessdb list
尝试恢复当前目录中已损坏的统计数据库:
csdb -t statdb recover
csexport
csexport 公用程序将日历以 iCalendar (.ics) 或 XML (.xml) 格式导出到文件。命令有:
要求
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
csexport [-v|-q] -c calid calendar outputfile
表 7-12 说明可用于 csexport 公用程序的命令。
表 7-12    csexport 公用程序命令
命令
说明
将日历导出到指定的输出文件。文件的数据格式由指定的文件扩展名决定:
表 7-13 说明 csexport 公用程序命令选项。
表 7-13    csexport 公用程序命令选项
选项
说明
以 iCalendar (text/calendar) 格式将日历 ID 为 tchang 的日历导出到名为 tchang.ics 的文件:
csexport -c tchang calendar tchang.ics
以 XML (text/xml) 格式将日历 ID 为 tchang 的日历导出到名为 tchang.xml 的文件:
csexport -c tchang calendar tchang.xml
csimport
由 csexport 公用程序所保存的 iCalendar (ics) 或 XML 格式的文件可使用 csimport 公用程序导入日历。命令有:
要求
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
csimport [-v|-q] -c calid calendar inputfile
表 7-14 说明可用于 csimport 公用程序的命令。
表 7-14    csimport 公用程序命令
命令
说明
表 7-15 说明 csimport 公用程序命令选项。
表 7-15    csimport 公用程序命令选项
选项
说明
要导入日历的日历 ID。此选项对 calendar 命令是必需的。
如果指定的日历 ID 已经存在,则导入的数据会与当前日历合并。没有默认值。
有关更多信息,请参见“日历标识符 (calid)”。
从 tchang.ics 文件导入日历 ID 为 tchang 的日历,且为 iCalendar(text/calendar 文件)格式:
csimport -c tchang calendar tchang.ics
从 tchang.xml 文件导入日历 ID 为 tchang 的日历,且为 XML(text/xml 文件)格式:
csimport -c tchang calendar tchang.xml
csplugin
csplugin 可管理为 Calendar Server 所配置的 CSAPI 插件。命令有:
要求
必须在安装 Calendar Server 的机器运行。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate
activate|deactivate plugin
csplugin [-q|-v] list
表 7-16 说明可用于 csplugin 公用程序的命令。
表 7-16    csplugin 公用程序命令
命令
说明
装入并启用指定的插件类型和插件名称。(有关支持的插件类型说明,请参见表 7-17 中的“-t”选项。)
关闭并禁用指定的插件类型和插件名称。(有关支持的插件类型说明,请参见表 7-17 中的“-t”选项。)
列出所有支持的插件类型、名称和激活状态。(有关支持的插件类型说明,请参见表 7-17 中的“-t”选项。)
表 7-17 说明 csplugin 公用程序命令选项。
表 7-17    csplugin 公用程序命令选项
选项
说明
列出有关所有支持插件的详细信息,包括配置用于此服务器实例的每个插件类型、名称和激活状态:
csplugin -v list
装入并启用文件名为 mylookup 的 lookup 类型插件:
csplugin activate -t lookup mylookup
禁用文件名为 mylookup 的 lookup 类型插件,并将其由 plugin 目录中删除:
csplugin deactivate -t lookup mylookup -r
csresource
csresource 公用程序可管理存储在 LDAP 服务器和 Calendar Server 数据库中的资源(如会议室或设备)日历。(csresource 公用程序只能用于与资源关联的日历,如果对用户日历发出命令,则会返回错误。)命令有:
create-为指定的日历 ID (calid) 添加新资源
要求
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
表 7-18 说明可用于 csresource 公用程序的命令。
表 7-18    csresource 公用程序命令
命令
说明
备注 如果上述任何命令中的 name 包含空格,则必须使用引号 (" ") 括起来。
表 7-19 说明 csresource 公用程序命令选项。
表 7-19    csresource 公用程序命令选项
选项
说明
指定日历的访问控制项 (ACE)。ACE 确定谁可以访问日历以进行组日程安排,以及他们所拥有的权限类型,如创建、删除、读取和写入权限。ACE 字符串或访问控制列表 (ACL) 必须用引号 ("") 括起来。
默认值是 ics.conf 文件中的 resource.default.acl 参数。
有关 ACE 格式的信息,请参见第 4 章 “管理 Calendar Server 访问控制”。
icsCalendar 属性。此选项对 create 命令是必需的。有关更多信息,请参见“日历标识符 (calid)”。
显示所有资源日历的列表及其 LDAP 属性。
csresource -v list
创建日历 ID (calid) 为 room100 和可视名称(LDAP cn 属性)为 MeetingRoom100 的资源日历:
csresource -c room100 create MeetingRoom100
显示可视名称为 MeetingRoom100 的资源日历的 LDAP 属性:
csresource -v list MeetingRoom100
禁用可视名称为 MeetingRoom100 的资源日历:
csresource disable MeetingRoom100
启用可视名称为 MeetingRoom100 的资源日历,并允许双重预约:
csresource -k yes enable MeetingRoom100
删除可视名称为 MeetingRoom100 的资源日历:
csresource delete MeetingRoom100
显示后端服务器 sesta 上可视名称为 MeetingRoom100 的资源日历的 LDAP 属性:
csresource -v -h sesta list MeetingRoom100
csrestore
csrestore 公用程序可还原日历数据库或指定的日历,或者还原使用 csbackup 或 csexport 保存的用户默认日历。命令有:
位于指定备份目录的 caldb.conf 版本文件显示已备份数据库的版本号。
Calendar Server 5.x 版的 csrestore 与 2.x 版的 csrestore 不兼容。请勿试图还原使用 Calendar Server 2.x csrestore 备份的数据,因为可能会发生数据丢失的情形。
必须在安装 Calendar Server 的机器上运行该公用程序。
如果要还原日历数据库,必须停止 Calendar Server。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
csrestore [-v|-q] [-f] database inputdir
csrestore [-v|-q] -c calid calendar inputfile
csrestore [-v|-q] -a userid [-b basedn] defcal inputfile
表 7-20 说明可用于 csrestore 公用程序的命令。
表 7-20    csrestore 公用程序命令
命令
说明
从指定的输入文件还原指定的日历 ID。文件的数据格式由文件扩展名决定:
从指定的输入文件还原指定用户 ID 的默认日历。文件的数据格式由文件扩展名决定:
表 7-21 说明 csrestore 公用程序命令选项。
表 7-21    csrestore 公用程序命令选项
选项
说明
用于指定用户 ID 的 LDAP 基准 DN(辨别名)。默认值取自 ics.conf 文件中定义的 local.ugldapbasedn 设置。
要还原的日历 ID。此选项对 calendar 命令是必需的。没有默认值。
有关更多信息,请参见“日历标识符 (calid)”。
还原 backupdir 目录中先前用 csbackup 保存的日历数据库:
csrestore database backupdir
针对 backupdir 目录中先前使用 csbackup 或 csexport 保存成 iCalendar(text/calendar 文件)格式的 tchang.ics 文件,还原日历 ID 为 tchang 的日历:
csrestore -c tchang calendar backupdir/tchang.ics
从 backupdir 目录中先前使用 csbackup 保存的日历数据库还原 tchang:
csrestore -c tchang calendar backupdir
针对 backupdir 目录中先前使用 csbackup 或 csexport 保存成 iCalendar(text/calendar 文件)格式的 TChang.ics 文件,还原 TChang 所拥有的默认日历:
csrestore -a TChang defcal backupdir/TChang.ics
csschedule
csschedule 公用程序可管理存储在组日程安排引擎 (GSE) 队列中的日程表项。命令有:
要求
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
表 7-22 说明可用于 csschedule 公用程序的命令。
表 7-22    csschedule 公用程序命令
命令
说明
表 7-23 说明 csschedule 公用程序命令选项。
表 7-23    csschedule 公用程序命令选项
选项
说明 事件或待办事项的周期 ID (RID)。RID 是以分号分隔的字符串列表,可识别每个重复的事件或待办事项。
详细列出存储在 GSE 队列中的所有项:
csschedule -v list
列出存储在 GSE 队列中的前 10 项:
csschedule -c 10 list
列出 GSE 队列中安排在 2000 年 12 月 31 日的 10:30:45 到 11:30:45 之间的项:
csschedule -s 20001231T103045Z -e 20001231T113045Z list
将 GSE 队列中 tchang 的日历符合以下条件的项列出:安排在 2000 年 12 月 31 日 10:30:45、偏移数为 2、唯一标识符为 1111、周期 ID 为 0 且序列号为 0 的项。
csschedule -v -t 20001231T103045Z -o 2 -u 1111 -r 0 -n 0 list tchang
将 GSE 队列中 tchang 的日历符合以下条件的项删除:安排在 2000 年 12 月 31 日 13:30:45,第一个偏移数在 13:30:45 处,唯一标识符为 1111、周期 ID 为 0 且序列号为 0 的项。
csschedule -v -t 20001231T133045Z -o 1 -u 1111 -r 0 -n 0 delete tchang
删除 GSE 中安排在 2000 年 12 月 31 日 10:30:45 和 16:30:45 之间的项:
csschedule -v -s 20001231T103045Z -e 20001231T163045Z delete
删除 GSE 队列中的所有项:
csschedule -v delete
csstart
备注 Calendar Server 所提供的 csstart 和 csstop 公用程序只是为了与早期版本兼容。
建议使用 start-cal 和 stop-cal 命令来启动和停止 Calendar Server。有关更多信息,请参见“启动和停止 Calendar Server”。
csstart 公用程序可启动 Calendar Server。命令有:
check-可确定是否所有的 Calendar Server 服务或指定的服务正在运行。
list-显示所有 Calendar Server 服务或指定的服务。 在 Windows NT 系统上,您也可以从“控制面板”访问“服务”对话框来启动 Calendar Server。
语法
csstart [-q|-v] check|list [servicename]
csstart [-q|-v] [-f] service [servicename]
表 7-24 说明可用于 csstart 公用程序的命令。
表 7-24    cscstart 公用程序命令
命令
说明
检查指定的 Calendar Server 服务是否正在运行;如果未指定服务名,则会检查是否所有的 Calendar Server 服务都在运行 启动指定的 Calendar Server 服务;如果未指定服务名,则启动所有服务。Calendar Server 服务应该按以下顺序启动:
表 7-25 说明 csstart 公用程序命令选项。
表 7-25    csstart 公用程序命令选项
选项
说明
使用默认端口并且按默认启动顺序来启动所有本地的 Calendar Server 服务:
csstart service
启动本地的 Calendar Server HTTP 服务:
csstart service http
检查是否所有本地的 Calendar Server 服务皆已启动:
csstart check
列出所有已启动的本地 Calendar Server 服务:
csstart list
csstats
csstats 公用程序可显示 Calendar Server 的统计信息。命令有:
有关计数器的更多信息,请参见“计数器配置 (counter.conf) 文件”。
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
csstats [-q|v] [-r registry] [-i iterations] [-s delay]] list [subsystem]
表 7-26 说明可用于 csstats 公用程序的命令。
表 7-26    csstats 公用程序命令
命令
说明
列出有关指定的 Calendar Server 子系统的计数器统计信息。如果未指定 subsystem,则会显示有关可用子系统的基本信息:
表 7-27 说明 csstats 公用程序命令选项。
表 7-27    csstats 公用程序命令选项
选项
说明
存储计数器统计信息的文件名称和位置。默认值是:server-root/cal/bin/counter/counter。例如: /opt/SUNWics5/cal/bin/counter/counter
显示有关计数器和可用类型的基本信息:
csstats list
列出有关 HTTP 服务子系统 (hpptstat) 的计数器统计信息:
csstats list http
每隔 10 秒列出一次 WCAP 子系统 (wcapstat) 的计数器统计信息,持续一小时(3600 秒):
csstats -i 3600 -s 10 list wcap
csstop
备注 Calendar Server 所提供的 csstop 和 csstart 公用程序只是为了与早期版本兼容。
建议使用 start-cal 和 stop-cal 命令来启动和停止 Calendar Server。有关更多信息,请参见“启动和停止 Calendar Server”。
csstop 公用程序可停止 Calendar Server。命令有:
在 Windows NT 系统上,您也可以从“控制面板”访问“服务”对话框来停止 Calendar Server。
语法
csstop [-q|-v] check | list [servicename]
csstop [-q|-v] [-f] service [servicename]
表 7-28 说明可用于 csstop 公用程序的命令
表 7-28    csstop 公用程序命令
命令
说明
检查指定的 Calendar Server 服务是否正在运行;如果未指定服务名,则会检查是否所有的服务都在运行。 停止指定的 Calendar Server 服务;如果未指定服务名,则停止所有服务。Calendar Server 服务应该按下列顺序启动,按相反的顺序停止:
.
表 7-29 说明 csstop 公用程序命令选项。
表 7-29    csstop 公用程序命令选项
选项
说明
如果先前停止失败,则可强制 Calendar Server 服务停止(类似于 UNIX 上的 kill -9 命令或类似从 Windows NT 任务管理器停止服务)。
停止所有本地的 Calendar Server 服务:
csstop service
停止本地的 Calendar Server HTTP 服务:
csstop service http
检查是否所有本地的 Calendar Server 服务皆已停止:
csstop check
列出所有已停止的本地 Calendar Server 服务:
csstop list
cstool
cstool 公用程序可对 Calendar Server、cshttpd 服务或事件通知服务 (ENS) 执行 ping 操作。cstool 也可强制 Calendar Server 或特定的服务刷新其配置。使用的命令为:
ping-对 Calendar Server、cshttpd 或 ENS 服务执行 ping 操作,以验证指定端口已在侦听中。
备注 在当前版本中,不要使用 cstool refresh 来刷新配置。应改用 stop-cal 和 start-cal 命令关闭然后重新启动 Calendar Server。
有关更多信息,请参见 “启动和停止 Calendar Server”和“编辑 ics.conf 配置文件”。
必须运行 Calendar Server。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
cstool [-q|-v] [-h host] [-p port] [-t timeout] ping [http|ens]
cstool [-q|-v] [-h host] refresh [servicename]
表 7-30 说明可用于 cstool 公用程序的命令。
表 7-30    cstool 公用程序命令
命令
说明
强制 Calendar Server 刷新指定服务的配置;如果未指定服务,则会刷新所有 Calendar Server 服务的配置。Calendar Server 服务选项有:
表 7-31 说明 cstool 公用程序命令选项。
表 7-31    cstool 公用程序命令选项
选项
说明
指定运行 Calendar Server 的主机名。默认值取自 ics.conf 文件中的 local.hostname 参数,并在安装时设置。如果访问运行在远程机器上的 Calendar Server,请使用此选项。
对 cshttpd 服务执行 ping 操作:
cstool ping http
对主机名为 sesta 的服务器上的 ENS 执行 ping 操作:
cstool -h sesta ping ens
对主机名为 calserver 的机器执行 ping 操作,查看 Calendar Server cshttpd 服务是否在侦听端口 80:
cstool -p 80 -h calserver -p 80 ping http
强制本地 Calendar Server 刷新所有服务的配置:
cstool refresh
csuser
csuser 公用程序可管理存储在 LDAP 目录服务器和 Calendar Server 日历数据库中的日历用户信息。命令有:
check-检查用户的日程安排功能是否已启用。
disable-禁止用户登录到 Calendar Server。
enable-允许用户登录到 Calendar Server。
备注 在当前版本中,建议您使用目录服务器公用程序或自定义用户配置工具来配置用户 LDAP 属性。
例如,如果您使用的是 iPlanet Directory Server,则使用 ldapsearch 和 ldapmodify 公用程序。有关这些公用程序的信息,请参见以下 Web 站点中的 iPlanet Directory Server 文档:
要求
Calendar Server 可在运行状态或停止状态。
必须在安装 Calendar Server 的机器上运行该公用程序。
在 UNIX 系统上,必须使用安装时指定运行 Calendar Server 的用户和组(如 icsuser 和 icsgroup)身份登录,或者以 root 身份登录。在 Windows NT 系统上,必须使用拥有系统全部管理员权限的管理员身份登录。
语法
表 7-32 说明可用于 csuser 公用程序的命令。
表 7-33 说明 csuser 公用程序命令选项。
表 7-33    csuser 公用程序命令选项
选项
说明
指定日历的访问控制项 (ACE)。ACE 确定谁可以访问日历以进行组日程安排,以及他们所拥有的权限类型,如创建、删除、读取和写入权限。ACE 字符串或访问控制列表 (ACL) 必须用引号 ("") 括起来。
默认值是 ics.conf 文件中的 calstore.calendar.default.acl 参数。
有关 ACE 格式的详细信息,请参见“服务配置”。
与指定用户 ID 关联的默认日历 ID。此命令不会创建日历。
有关更多信息,请参见“日历标识符 (calid)”。
检查日历用户 JSmith 是否已启用日程安排的功能(假设现有日历用户有权访问此 Calendar Server 的日历数据):
csuser check JSmith
创建一个用户 ID 为 JSmith 的 LDAP 用户,其名字为 John,姓氏为 Smith,日历 ID 为 JSmithcal:
csuser -g John -s Smith -y password -c JSmithcal create JSmith
删除日历用户 JSmith:
csuser delete JSmith
禁止日历用户 JSmith 登录到 Calendar Server:
csuser disable JSmith
备注 此命令会禁止 JSmith 登录到 Calendar Server 访问日历数据,但并不会从日历数据库中删除 JSmith 的数据。但如果 JSmith 当前已登录到 Calendar Server,则 JSmith 仍有权访问日历数据,直到他注销为止。
启用 JSmith 的日程安排功能(允许现有日历用户 JSmith 登录到 Calendar Server):
csuser enable JSmith
列出 JSmith 的所有日历属性:
csuser -v list JSmith
列出具有前缀字符串 user 的所有日历用户 ID:
csuser -v list "user*"
将 JSmith 的所有日历属性重置为默认配置设置:
csuser reset JSmith
列出后端服务器 sesta 上 TChang 的所有日历属性:
csuser -v -h sesta list TChang
上一章 目录 索引 下一章
版权所有 2002 Sun Microsystems, Inc. 全权所有。
更新日期 2002 年 8 月 30 日