각 유틸리티에 대한 간단한 설명을 보려면 명령줄 유틸리티에 대한 간단한 설명을 참조하십시오.
Calendar Server는 Access Manager와 함께 제공되는 Delegated Administrator에 포함되지 않는 명령줄 유틸리티를 제공합니다.
이러한 Calendar Server 유틸리티는 일괄 처리나 쉘, 그리고 Perl과 같은 스크립트 프로그램에서 실행할 수 있습니다. 이 유틸리티 중 일부(csuser, csresource 및 csdomain)는 Delegated Administrator 유틸리티로 대체되었지만 나머지는 스키마 2 환경에서도 계속 사용되고 있습니다. 스키마 1의 경우 csuser, csresource 및 csdomain을 계속 사용해야 하며 Delegated Administrator를 사용하면 안 됩니다.
필요한 경우 이러한 유틸리티에는 ics.conf 구성 파일의 기본값이 사용됩니다.
명령줄 유틸리티는 다음 디렉토리에 있습니다. cal_svr_base/SUNWics5/cal/sbin
전체 경로가 지정되면 어느 디렉토리에서도 실행할 수 있는 start-cal 및 stop-cal를 제외하고 모든 유틸리티는 sbin 디렉토리에서 시작해야 합니다.
관리 도구의 오류 메시지는 csdb 디렉토리에 있는 admin.log 파일에 기록됩니다.
이 장은 다음 내용으로 구성됩니다.
Calendar Server가 실행 중인 사용자 및 그룹으로 로그인하거나 root로 로그인하여 명령줄 유틸리티를 실행합니다. 설치 중에 지정되는 기본값은 icsuser와 icsgroup입니다.
예를 들어, Calendar Server 기본 디렉토리가 cal_svr_base 이고 cscal 유틸리티 list 명령을 실행하려면 로그인한 후에 다음을 실행합니다.
cd cal_svr_base/SUNWics5/cal/sbin ./cscal list
Calendar Server 명령줄 유틸리티는 다음 구문을 사용합니다.
utility [ -option [value]] command [target]
여기서,
utility는 cscal이나 csuser와 같은 실행 가능 유틸리티의 이름입니다.
option은 명령이 수행할 작업을 결정합니다. option은 소문자로 표기하며 -d와 같이 앞에 하이픈(-)을 붙입니다. 대괄호([]) 안의 옵션은 선택 항목입니다. 동시에 둘 이상의 옵션을 사용할 수 있습니다.
value는 -d 옵션과 함께 사용되는 설명과 같이 option에 의해 지정된 작업을 더 한정시켜 줍니다. 대괄호([]) 안의 값은 선택 항목입니다. 공백이 포함된 값은 큰따옴표(" ")로 묶어야 합니다. 값이 여러 개인 경우에는 모두 큰따옴표("") 안에 넣어야 하며 각 값은 세미콜론 구분 목록 사용과 같이 달리 지정된 경우가 아니면 공백을 사용하여 구분해야 합니다.
command는 list 또는 create와 같은 유틸리티가 수행하는 작업입니다. 세로 막대(|)를 사용하여 구분한 경우에는 두 가지 명령을 함께 사용할 수 없으며 둘 중 어느 하나를 동시에 사용할 수 있다는 것을 나타냅니다.
target은 달력 아이디나 사용자 아이디처럼 명령이 적용되는 객체입니다.
다음 규칙은 명령줄 유틸리티의 일반적인 사용 지침입니다.
유틸리티 이름만 지정하면 모든 명령, 옵션 및 몇 가지 예가 나열됩니다.
필요한 비밀번호를 지정하지 않으면 비밀번호를 지정하라는 메시지가 표시됩니다.
각 유틸리티마다 -v(세부 정보 표시) 및-q(quiet) 옵션을 사용할 수 있습니다.
데이터 손실을 초래할 수 있는 위험이 있는 명령일 경우에는 명령을 실행하기 전에 유틸리티에서 확인 메시지가 표시됩니다. 데이터 손실 위험이 있는 명령으로는 달력을 삭제할 위험이 있는 cscal, 사용자를 삭제할 위험이 있는 csuser 등이 있습니다. 그러나 -q(quiet) 옵션을 사용하는 경우에는 확인 메시지가 표시되지 않습니다.
각 유틸리티마다 version 명령을 사용할 수 있습니다.
명령줄 유틸리티를 스크립트에서 실행할 경우 성공적으로 실행되면 “0”이, 그렇지 않으면 “-1”이 반환됩니다.
다음 표에는 Calendar Server 명령줄 유틸리티에 대한 간단한 설명이 나와 있습니다.
표 D–1 Calendar Server 명령줄 유틸리티 요약
유틸리티 |
설명 |
---|---|
달력 사용자 또는 자원의 LDAP 속성을 관리합니다. |
|
각 달력, 사용자 및 달력 데이터베이스를 백업합니다. |
|
달력 및 달력의 등록 정보를 관리합니다. |
|
Delegated Administrator에 의해 상태 속성(inetUserStatus)이 “삭제됨”으로 표시된 Calendar Server 사용자의 사용자 및 자원 달력을 제거합니다. |
|
다음의 달력 구성 요소를 관리합니다. 이벤트 및 태스크(작업) |
|
달력 데이터베이스를 관리합니다. |
|
호스트된(가상) 도메인을 위한 LDAP 디렉토리의 Calendar Server 속성을 관리합니다. |
|
달력을 iCalendar(.ics) 또는 XML(.xml) 형식으로 내보냅니다. |
|
달력을 iCalendar(.ics) 또는 XML(.xml) 형식으로 가져옵니다. |
|
LDAP 연결, 로그 파일 및 달력 데이터베이스를 위해 사용할 수 있는 디스크 공간을 모니터링합니다. |
|
구성된 Calendar Server API(CSAPI) 플러그 인을 보거나 활성화 또는 비활성화합니다. |
|
삭제 로그 데이터베이스의 항목을 수동으로 제거할 수 있도록 합니다(ics50deletelog.db). |
|
사용자 아이디의 변경을 허용합니다. 데이터베이스 전체를 다시 써야 합니다. |
|
회의실 및 장비와 같은 달력 자원을 관리합니다. |
|
각 달력, 사용자 및 달력 데이터베이스를 복구합니다. |
|
그룹 예약 엔진(GSE) 대기열의 예약 항목을 관리합니다. |
|
Calendar Server의 카운터를 표시합니다. |
|
실행 중인 Calendar Server 인스턴스를 핑합니다. |
|
달력 사용자를 관리합니다. |
|
모든 Calendar Server 프로세스를 시작합니다. |
|
모든 Calendar Server 프로세스를 중지합니다. |
csattribute 유틸리티는 Calendar Server 사용자 또는 자원 LDAP 항목 속성을 관리합니다. 명령은 다음과 같습니다.
add 명령은 LDAP 속성 및 값을 지정된 대상(사용자 또는 자원 객체)에 추가합니다.
list 명령은 대상 객체의 속성을 나열합니다.
delete 명령은 속성을 대상에서 삭제합니다.
LDAP CLD 플러그 인을 사용하는 사이트인 경우에는 새 백엔드 호스트 서버를 지정할 때 csattribute 를 사용하여 icsDWPHost 속성을 변경하지 마십시오. icsDWPHost를 수정하면 새 백엔드 호스트에 새 달력이 만들어지지 않습니다. 자세한 내용은 6 장, 여러 시스템에서 달력 데이터베이스 배포 구성을 참조하십시오.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정된 Calendar Server가 실행되고 있는 사용자나 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태여야 합니다.
csattribute [-q|-v] -a attribute=value [-t resource | user] [-d domain] add target csattribute [-q|-v] -a attribute[=value] [-t resource | user] [-d domain] delete target csattribute [-q | -v] [-t resource | user] [-d domain] list target |
다음 표에서는 csattribute에 사용할 수 있는 명령을 보여 줍니다.
표 D–2 csattribute 유틸리티 명령
명령 |
설명 |
---|---|
add target |
LDAP 속성 및 값을 지정된 대상(사용자 또는 자원 객체)에 추가합니다. |
list target |
대상 객체의 속성을 나열합니다. |
delete target |
속성을 대상에서 삭제합니다. |
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csattribute 유틸리티 명령 옵션에 대해 설명합니다.
표 D–3 csattribute 유틸리티 명령 옵션
값이 tchang인 icsCalendar LDAP 속성을 사용자 아이디 tchang에 추가합니다.
csattribute -a icsCalendar=tchang add tchang
tchang에서 LDAP 속성 icsCalendar를 삭제합니다.
csattribute -a icsCalendar delete tchang
tchang의 속성을 표시합니다.
csattribute list tchang
csbackup 유틸리티는 달력 데이터베이스, 지정된 달력 또는 사용자의 기본 달력을 백업합니다. 명령은 다음과 같습니다.
database 명령은 달력 데이터베이스를 백업합니다.
calendar 명령은 지정된 달력을 백업합니다.
defcal 명령을 사용자의 기본 달력을 백업합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
지정된 백업 디렉토리에 있는 caldb.conf 버전 파일은 백업된 데이터베이스의 버전 번호를 표시합니다.
csrestore에 대한 자세한 내용은 csrestore를 참조하십시오.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csbackup [-q|-v] -f database target csbackup [-q|-v] -c calid calendar target csbackup [-q|-v] -a userid [-b basedn] defcal target |
다음 표에서는 csbackup에 사용할 수 있는 명령을 보여 줍니다.
표 D–4 csbackup 유틸리티 명령
명령 |
설명 |
---|---|
database target |
달력 데이터베이스를 지정된 대상 데이터베이스 디렉토리에 백업합니다. 기본적으로 대상 데이터베이스 디렉토리는 다음과 같습니다. cal_svr_base/SUNWics5/cal/sbin /target-directory 대상 데이터베이스 디렉토리만 지정할 경우에는 디렉토리 이름 앞에 슬래시(/)를 포함시키지 마십시오. 예를 들면 다음과 같습니다. csbackup database backupdir 주: 대상 백업 디렉토리가 이미 존재하고 -f 옵션을 지정하지 않은 경우 csbackup 유틸리티는 실패합니다. 예를 들어, backupdir이 존재한다면 그 디렉토리가 비어 있더라도 다음 명령은 실패합니다. csbackup database backupdir 따라서 이미 존재하는 대상 백업 디렉토리를 지정할 경우 -f 옵션을 포함시켜 csbackup을 실행합니다. 또한 존재하지 않는 대상 백업 디렉토리를 지정하고 csbackup이 해당 디렉토리를 만들게 할 수 있습니다. |
calendar calid target |
지정된 달력 아이디를 지정된 대상 출력 파일에 백업합니다. 파일의 데이터 형식은 파일 확장명이 .ics이면 text/calendar이고 .xml이면 text/xml입니다. |
defcal userid target |
지정된 사용자 아이디의 기본 달력을 지정된 대상 파일에 백업합니다. 파일의 데이터 형식은 파일 확장명이 .ics이면 text/calendar이고 .xml이면 text/xml입니다. |
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csbackup 유틸리티 명령 옵션에 대해 설명합니다.
표 D–5 csbackup 유틸리티 명령 옵션
옵션 |
설명 |
---|---|
-v |
세부 정보 표시 모드로 실행합니다. 수행되는 명령에 대한 사용 가능한 모든 정보를 표시합니다. 기본값은 off입니다. |
-q |
quiet 모드로 실행합니다.
|
-a userid |
백업할 달력 사용자의 사용자 아이디입니다. 이 옵션은 기본 옵션으로 필수 사항입니다. 기본값은 없습니다. |
-b basedn |
이 사용자에 사용할 기본 DN입니다. 기본값은 ics.conf 파일에 정의된 setting local.ugldapbasedn에서 가져옵니다. 기본 DN(고유 이름)은 검색이 실행되는 시작점으로 사용되는 LDAP 디렉토리 내의 항목입니다. 예를 들어, ou=people, o=sesta.com을 기본 DN으로 지정하면 Calendar Server에서 실행되는 모든 LDAP 검색 작업은 o=sesta.com 디렉토리 트리에서 ou=people 하위 트리만 조사합니다. |
-c calid |
백업할 달력 아이디입니다. 이 옵션은 calendar 명령의 필수 옵션입니다. 기본값은 없습니다. 자세한 내용은 달력 고유 아이디(calid) 만들기를 참조하십시오. |
-f |
기존 백업 파일을 강제 삭제합니다. 현재 릴리스에서는 백업 대상 디렉토리가 이미 존재하면 그 디렉토리가 비어 있더라도 -f 옵션을 포함시켜야 합니다. |
-l |
SolsticeTM BackupTM 또는 Legato NetworkerTM 백업 프로그램과 함께 사용하기 위해 백업 파일을 준비합니다. 자세한 내용은 17 장, Calendar Server 데이터 백업 및 복원 을 참조하십시오. |
달력 데이터베이스를 backupdir이라는 이름의 디렉토리에 백업합니다.
csbackup database backupdir
달력 아이디가 tchang인 달력을 tchang.ics 파일에 text/calendar 형식으로 백업합니다.
csbackup -c tchang calendar tchang.ics
tchang의 기본 달력을 tchang.xml 파일에 text/xml 형식으로 백업합니다.
csbackup -a tchang defcal tchang.xml
cscal 유틸리티는 달력 및 해당 등록 정보를 관리합니다. 명령은 다음과 같습니다.
create 명령은 달력을 만듭니다.
delete 명령은 달력을 삭제합니다.
disable 명령은 달력을 비활성화합니다.
enable 명령은 달력을 활성화합니다.
list 명령은 달력을 나열합니다.
modify 명령은 달력 등록 정보 및 그룹 예약 액세스 제어를 수정합니다.
reset 명령은 달력 등록 정보를 기본 설정으로 재설정합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
cscal [-q|-v] [-a aces] [-c charset] [-d description] [-g categories] [-k yes|no] [-l langcode] [-m email] [-n name] [-o owner’s uid] [-y otherowners] create|modify calid cscal [-q|-v] [-o owner’s uid] [-O] delete|reset calid cscal [-q|-v] [-o owner’s uid] [-O] disable|list [calid] cscal [-q|-v] [-k yes|no] [-o owner’s uid] [-O] enable [calid] |
cscal은 -o(소유자의 uid) 입력 시 대소문자를 확인하지 않지만 검색은 대소문자를 구분하지 않습니다.
다음 표에서는 cscal 유틸리티에 사용할 수 있는 명령을 보여 줍니다.
표 D–6 cscal 유틸리티 명령
명령 |
설명 |
---|---|
create 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 |
quiet 모드로 실행합니다.
|
-a [aces] |
지정된 달력에 대한 액세스 제어 항목(ACE)입니다. ACE는 그룹 예약 달력에 액세스할 수 있는 사용자와 만들기, 삭제, 읽기, 쓰기 권한 등의 보유 권한 유형을 결정합니다. ACE 문자열이나 액세스 제어 목록(ACL)은 큰따옴표(" ")로 묶어야 합니다. 기본값은 ics.conf 파일의 calstore.calendar.default.acl 매개 변수입니다. ACE 형식에 대한 자세한 내용은 달력 액세스 제어를 참조하십시오. |
-c charset |
문자 세트기본값은 문자 세트가 없는 것입니다. |
-d description |
달력의 목적에 대해 볼 수 있는 설명입니다. 기본적으로 설명이 없습니다. |
-g category |
범주. 여러 범주는 큰따옴표("")로 묶어야 하며 공백을 사용하여 구분합니다. 기본값은 범주가 없는 것입니다. |
-k yes|no |
사용자 달력에 대해 이중 예약이 허용되는지 여부를 지정합니다. 예를 들어, yes는 같은 시간에 둘 이상의 이벤트가 달력에 예약되어 있을 수 있다는 것을 의미합니다. -k 옵션을 생략하면 파일의 user.allow.doublebook 매개 변수에서 기본값을 가져옵니다. 그러나 user.allow.doublebook 매개 변수는 달력이 만들어질 때만 사용됩니다. 달력이 만들어진 후 Calendar Server에서는 달력 등록 정보 데이터베이스 ics50calprops.db를 검사하여 이중 예약이 허용되는지 확인합니다. 달력에 대한 이중 예약을 허용 또는 금지하도록 달력 등록 정보를 변경해야 할 경우에는 cscal을 -k 옵션과 함께 다시 실행합니다. |
-l langcode |
언어 코드. 기본값은 언어 코드가 없는 것입니다. |
-m email |
전자 메일 주소. 기본값은 전자 메일 주소가 없는 것입니다. |
-n name |
이름. 기본값은 이름이 없는 것입니다. |
-o owner |
주 소유자. 기본 설정은 달력 아이디이며 일반적으로 사용자 아이디와 동일합니다. |
-O |
주 소유자의 모든 달력을 지정합니다. 기본값은 이름이 지정된 달력만입니다. |
-y otherowners |
다른 달력 소유자. 여러 명의 소유자는 큰따옴표("")로 묶고 공백으로 구분해야 합니다. 기본값은 다른 소유자가 없는 것입니다. |
ics.conf 파일에 calstore.calendar.default.acl로 정의된 기본 액세스 제어 설정을 사용하여 달력 아이디가 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
달력 아이디가 tchang인 달력을 비활성화합니다. 사용자는 사용자 인터페이스를 사용하여 이 달력을 읽거나, 달력에 쓰거나 또는 달력을 찾을 수 없게 됩니다.
cscal disable tchang
달력 아이디가 tchang인 달력을 활성화합니다. 사용자 인터페이스를 사용하여 읽거나 쓸 수 있으나 이중 예약은 허용되지 않습니다.
cscal -k no enable tchang
tchang의 등록 정보를 나열합니다.
cscal list tchang
tchang의 모든 등록 정보를 나열합니다.
cscal -v list tchang
데이터베이스에 있는 모든 달력을 나열합니다.
cscal list
달력 아이디가 tchang인 달력을 기본 구성 설정으로 재설정합니다.
cscal reset tchang
달력 아이디가 tchang인 달력에서 설명을 제거합니다.
cscal -d "" modify tchang
달력 아이디가 tchang인 달력에서 모든 범주를 제거합니다.
cscal -g "" modify tchang
달력 아이디가 tchang인 달력에서 다른 소유자를 제거합니다.
cscal -y "" modify tchang
달력 데이터베이스에서 tchang을 삭제합니다.
cscal delete tchang
주 소유자가 tchang인 모든 달력을 달력 데이터베이스에서 삭제합니다.
cscal -o tchang delete
csclean 유틸리티는 Schema 2 호스트된 도메인 모드에서만 작동합니다. 이 유틸리티는 Delegated Administrator에 의해 상태 속성( icsStatus)이 “삭제됨”으로 표시된 사용자의 사용자 및 자원 달력을 제거합니다.
Schema 1 및 호스트되지 않은 도메인 모드에서는 csuser 및 cscal을 사용하여 삭제된 사용자의 달력을 모두 제거합니다.
스키마 2 호스트된 도메인을 사용해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
Calendar Server가 설치된 시스템에서 csclean 유틸리티를 로컬로 실행해야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태여야 합니다.
csclean [-q | -v] [-g graceperiod] clean domain |
다음 표에서는 csclean 유틸리티 명령 옵션에 대해 설명합니다.
표 D–8 csclean 유틸리티 명령 옵션
sesta.com에서 달력 서비스가 삭제된 지 최소한 5일이 경과한 모든 사용자 및 자원의 달력을 제거합니다.
csclean -g 5 clean sesta.com
모든 도메인에서 달력 서비스가 삭제된 지 최소한 10일이 경과한 모든 사용자와 자원 의 달력을 제거합니다.
csclean clean "*"
cscomponents 유틸리티는 달력 구성 요소를 관리합니다. 이벤트 및 태스크(작업)명령은 다음과 같습니다.
delete 명령은 달력의 이벤트 및 태스크를 삭제합니다.
list 명령은 달력의 이벤트 및 태스크를 나열합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
cscomponents [-v|-q] [-e endtime] [-s starttime] [-t event|task] delete|list calid |
다음 표에서는 cscomponents 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–9 cscomponents 유틸리티 명령
명령 |
설명 |
---|---|
delete calid |
지정된 달력 아이디를 가진 달력의 이벤트 및 태스크를 삭제합니다. |
list calid |
지정된 달력 아이디를 가진 달력의 이벤트 및 태스크를 나열합니다. |
version |
유틸리티의 버전을 화면에 표시합니다. |
다음 표에서는 cscomponents 유틸리티 명령 옵션에 대해 설명합니다.
표 D–10 cscomponents 유틸리티 명령 옵션
달력 아이디가 tchang인 달력의 모든 2000년 이벤트를 삭제합니다.
cscomponents -s 20000101T000000Z -e 20001231T000000Z delete tchang
달력 아이디가tchang인 달력의 모든 이벤트와 작업을 세부 정보와 함께 나열합니다.
cscomponents -v list tchang
csdb 유틸리티는 달력 데이터베이스(calendar, session, statistics)를 관리합니다. 명령은 다음과 같습니다.
create 명령은 새 데이터베이스를 만듭니다. (서버가 시작될 때 데이터베이스가 존재하지 않으면 Calendar Server에서 자동으로 생성됩니다.)
delete 명령은 기존 달력 데이터베이스를 삭제합니다. 데이터베이스는 열려 있는 동안, 즉 Calendar Server가 실행되는 경우에는 삭제할 수 없습니다.
list 명령은 데이터베이스에 대한 정보를 나열합니다.
check 명령은 달력 데이터베이스의 손상 여부를 확인합니다.
rebuild 명령은 손상된 달력 데이터베이스를 재구축합니다.
recover 명령은 손상된 달력 데이터베이스를 복구합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
create, delete 또는 rebuild 명령을 실행하려면 Calendar Server를 중지해야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csdb [-q|-v] [-t caldb|sessdb|statdb] create|delete [dbdir] csdb [-q|-v] [-t caldb|sessdb|statdb] list [dbdir] csdb [-q|-v] [-f] [-t caldb|sessdb|statdb] recover [dbdir] csdb check [dbdir] csdb rebuild [-a, -V] [-g] [dbdir [dstdir]] |
다음 표에서는 csdb 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–11 csdb 유틸리티 명령
명령 |
설명 |
---|---|
create [dbdir] |
지정된 데이터베이스 디렉토리에 데이터베이스를 만듭니다. 데이터베이스 디렉토리가 지정되지 않은 경우에는 현재 디렉토리가 사용됩니다. 서버가 시작될 때 데이터베이스가 존재하지 않는 경우에는 Calendar Server에서 자동으로 데이터베이스를 만듭니다. |
delete [dbdir] |
지정된 데이터베이스 디렉토리의 데이터베이스를 삭제합니다. 데이터베이스 디렉토리가 지정되지 않은 경우에는 현재 디렉토리가 사용됩니다. 데이터베이스는 열려 있는 동안, 즉 Calendar Server가 실행되는 경우에는 삭제할 수 없습니다. |
list [dbdir] |
지정된 데이터베이스 디렉토리에 있는 데이터베이스에 대한 정보를 나열합니다. 데이터베이스 디렉토리가 지정되지 않은 경우에는 현재 디렉토리가 사용됩니다. |
recover [dbdir] |
지정된 데이터베이스 디렉토리에서 손상된 달력 데이터베이스를 복구하려고 시도합니다. 데이터베이스 디렉토리가 지정되지 않은 경우에는 현재 디렉토리가 사용됩니다. 세션 또는 통계 데이터베이스에 대해서는 구현되지 않습니다. |
check [dbdir] |
지정된 데이터베이스 디렉토리의 달력 데이터베이스를 검사하여 손상 여부를 확인하고 결과를 출력에 보고합니다. 데이터베이스 디렉토리가 지정되지 않은 경우에는 현재 디렉토리가 사용됩니다. |
rebuild [dbdir [dstdir]] |
지정된 데이터베이스 디렉토리에서 모든 달력 데이터베이스를 검사하여 손상 여부를 확인하고 달력 데이터베이스 파일(.db 파일)을 다시 만듭니다. 데이터베이스 디렉토리가 지정되지 않은 경우에는 현재 디렉토리가 사용됩니다. 데이터베이스가 다시 만들어졌으면 db_verify가 실행됩니다. dstdir은 선택적 대상 디렉토리를 지정합니다. |
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csdb 유틸리티 명령 옵션에 대해 설명합니다.
표 D–12 csdb 유틸리티 명령 옵션
채워넣지 않은 새 데이터베이스를 현재 디렉토리에 만듭니다.
csdb -t caldb create
현재 디렉토리에서 데이터베이스를 삭제합니다.
csdb -t caldb delete
현재 디렉토리에 있는 달력 데이터베이스에 대한 정보를 나열합니다.
csdb -v -t caldb list
현재 디렉토리의 모든 손상된 데이터베이스를 복구하려고 시도합니다.
csdb recover
현재 디렉토리에 있는 세션 데이터베이스에 대한 정보를 나열합니다.
csdb -t sessdb list
경보 데이터베이스만 재구축합니다.
csdb -a -V rebuild
csdomain 유틸리티는 호스트된(가상) 도메인을 위한 LDAP 디렉토리의 Calendar Server 속성을 관리합니다. 이러한 속성은 icsCalendarDomain 객체 클래스의 일부입니다. 명령은 다음과 같습니다.
create 명령은 LDAP 디렉토리에 새 호스트된 도메인을 만듭니다.
add 명령은 특정 호스트된 도메인의 LDAP 디렉토리에 Calendar Server 속성과 관련 값을 추가합니다.
delete 명령은 특정 호스트된 도메인의 LDAP 디렉토리에 있는 Calendar Server 속성을 삭제하거나 호스트된 도메인 전체를 삭제합니다.
list 명령은 특정 호스트된 도메인의 LDAP 디렉토리에 있는 Calendar Server 속성을 나열합니다.
csdomain 유틸리티를 실행하려면 호스트된(가상) 도메인 모드에 있어야 합니다. 즉, ics.conf 파일에 다음 매개 변수가 설정되어 있어야 합니다.
service.virtualdomain.support를 “yes”로 설정해야 합니다.
local.schemaversion을 LDAP 스키마의 버전(“1” , “1.5” 또는 “2”)으로 설정해야 합니다.
local.schemaversion = “1” 또는 “1.5” 인 경우 service.dcroot를 LDAP 디렉토리에 있는 DC 트리의 루트 접미어로 설정해야 합니다.
local.schemaversion = “2”인 경우 service.schema2root를 모든 도메인이 있는 루트 접미어로 설정해야 합니다.
csdomain을 사용하여 조직 트리 노드를 추가하기 전에 11 장, 호스트된 도메인 설정의 지침을 따라야 합니다.
Calendar Server가 설치된 시스템에서 csdomain 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csdomain [-q | -v] -n node create domain csdomain [-q | -v] {-a attr[=value] | -f filename} add domain csdomain [-q | -v] [-a attr | -f filename] delete domain csdomain [-q | -v] list domain |
다음 표에서는 csdomain 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–13 csdomain 유틸리티 명령
명령 |
설명 |
---|---|
create |
LDAP 디렉토리에 새 호스트된 도메인을 만듭니다. 그런 다음 디렉토리의 이 항목 아래에 도메인을 위한 모든 Calendar Server 사용자와 자원이 만들 어집니다. |
add |
Calendar Server 속성과 관련 값을 특정 도메인을 위한 LDAP 디렉토리에 추가합니다. csdomain을 사용하여 도메인 LDAP 속성을 추가하거나 업데이트하는 경우에는 Calendar Server를 다시 시작해야 새로운 값이 적용됩니다. |
delete |
특정 호스트된 도메인을 위한 LDAP 디렉토리의 Calendar Server 속성을 삭제하거나 전체 도메인을 위한 모든 LDAP 항목을 삭제합니다. |
list |
특정 도메인을 위한 LDAP 디렉토리의 Calendar Server 속성을 표시합니다. |
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csdomain 유틸리티 명령 옵션에 대해 설명합니다.
표 D–14 csdomain 유틸리티 명령 옵션
옵션 |
설명 |
---|---|
-v |
세부 정보 표시 모드로 실행합니다. 수행되는 명령에 대해 사용 가능한 모든 정보를 표시합니다. 기본값은 off입니다. |
-q |
quiet 모드로 실행합니다.
|
-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 |
다음 표에서는 csdomain 유틸리티에 적용되는 LDAP 속성 및 등록 정보 이름에 대해 설명합니다. 이러한 속성은 icsCalendarDomain 객체 클래스의 일부입니다. 값을 추가하거나 삭제할 때는 속성 이름이 아닌 등록 정보 이름을 사용해야 합니다.
csdomain을 사용하여 도메인 LDAP 속성을 추가하거나 업데이트하는 경우에는 Calendar Server를 다시 시작해야 새로운 값이 적용됩니다.
LDAP 속성 및 등록 정보 이름에서는 csdomain 유틸리티로 설정할 수 있는 icsAllowRights 속성 및 등록 정보에 대해 설명합니다. 이 속성은 각 비트가 특정 사용자 권한에 해당하는 32비트 숫자 문자열입니다. (현재 릴리스에서 사용되지 않는 일부 비트는 기본적으로 0으로 설정됩니다.)특정 권한에 해당되는 비트가 설정되면(값=1) 그 권한은 허용되지 않습니다. 비트가 설정되지 않으면(값=0) 그 권한은 허용됩니다.
icsAllowRights 속성의 각 등록 정보에 해당하는 ics.conf 매개 변수가 있습니다. 등록 정보가 설정되어 있지 않거나(값 = 0) 없는 경우(service.virtualdomain.support = “no”) Calendar Server는 해당 ics.conf 매개 변수를 기본값으로 사용합니다.
icsAllowRights 값은 숫자 문자열이며 정수가 아닙니다. icsAllowRights를 프로그램에서 비트 연산에 사용하려면 먼저 문자열 값을 정수로 변환해야 합니다.
표 D–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 명령을 사용하여 sn(surname) 속성을 설정할 수 없습니다. 해당 ics.conf 매개 변수는 다음과 같습니다. service.wcap.allowsetprefs.sn |
15–31 |
현재 릴리스에서는 사용되지 않습니다. |
다음 표에서는 csdomain 유틸리티를 사용하여 설정할 수 있는 icsExtendedDomainPrefs 속성 및 등록 정보에 대해 설명합니다. 각 등록 정보에는 해당하는 ics.conf 매개 변수가 있습니다. 등록 정보가 설정되어 있지 않거나(값 = 0) 없는 경우(service.virtualdomain.support=“no”) Calendar Server는 해당 ics.conf 매개 변수를 기본값으로 사용합니다.
표 D–16 icsExtendedDomainPrefs LDAP 디렉토리 속성
등록 정보 이름 |
설명 |
---|---|
allowProxyLogin |
프록시 로그인 허용 여부를 "yes" 또는 "no"로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. service.http.allowadminproxy(기본값 = "no") |
calmasterAccessOverride |
Calendar Server 관리자가 액세스 제어를 무시할 수 있는지 여부를 "yes" 또는 "no"로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. service.admin.calmaster.overrides.accesscontrol(기본값 = "no") |
calmasterCred |
Calendar Server 도메인 관리자로 지정된 사용자 아이디의 비밀번호인 ASCII 문자열을 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. service.admin.calmaster.cred(기본값 없음) |
calmasterUid |
Calendar Server 도메인 관리자로 지정된 사람의 사용자 아이디인 ASCII 문자열을 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. service.admin.calmaster.userid(기본값 없음) |
createLowercase |
새 달력을 만들거나 달력을 검색할 때 Calendar Server가 달력 아이디(calid)를 소문자로 변환하는지 여부를 "yes" 또는 "no"로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. calstore.calendar.create.lowercase(기본값 = "no") |
domainAccess |
도메인을 위한 액세스 제어 목록(ACL)을 지정합니다. ACL에 대한 자세한 내용은 액세스 제어 목록(ACL)을 참조하십시오. 이 ACL은 도메인간 검색에 사용됩니다. 자세한 내용은 도메인간 검색을 참조하십시오. |
fbIncludeDefCal |
사용자의 기본 달력을 사용자의 사용 가능/사용 중 달력 목록에 포함할 것인지 여부를 "yes" 또는 "no"로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. calstore.freebusy.include.defaultcalendar(기본값 = "yes") |
filterPrivateEvents |
Calendar Server가 개인 및 시간 및 날짜만(비밀) 이벤트 및 태스크를 필터링(인식)할 것인지 여부를 "yes" 또는 "no"로 지정합니다. "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 |
브라우저가 지정된 도메인의 서버에만 쿠키를 보내도록 지정합니다. 값은 마침표(.)로 시작해야 합니다. 예를 들면 다음과 같습니다. ".sesta.com" 해당 ics.conf 매개 변수는 다음과 같습니다. sso.cookiedomain(기본값은 현재 도메인) |
ssoUserDomain |
사용된 도메인을 사용자의 SSO 인증의 일부로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. sso.userdomain(기본값 없음) |
subIncludeDefCal |
사용자의 기본 달력이 사용자가 가입한 달력 목록에 포함되는지 여부를 "yes" 또는 "no"로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. calstore.subscribed.include.defaultcalendar(기본값 = "yes") |
uiAllowAnyone |
사용자 인터페이스가 "모든 사용자" 액세스 제어 목록(ACL)을 표시하고 사용하는지 여부를 "yes" 또는 "no"로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. ui.allow.anyone(기본값 = "yes") |
uiAllowDomain |
사용자 인터페이스가 이 도메인에 대해 "모든 사용자" 액세스 제어 목록(ACL)을 표시하고 사용하는지 여부를 "yes" 또는 "no"로 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. ui.allow.domain(기본값 = "no") |
uiBaseUrl |
기본 서버 주소를 위한 URL을 지정합니다. 예를 들면 다음과 같습니다. "https://proxyserver" 해당 ics.conf 매개 변수는 다음과 같습니다. ui.base.url(기본값 없음) |
uiConfigFile |
Calendar Server가 사용자 인터페이스를 숨기도록 허용하는 시작 시에 읽을 수 있는 선택적 xml 기반 구성 파일을 지정합니다. 해당 ics.conf 매개 변수는 다음과 같습니다. ui.config.file(기본값 없음) |
uiProxyURL |
HTML UI JavaScript 파일에서 미리 결정한 프록시 서버 주소 URL을 지정합니다. 예를 들면 다음과 같습니다. "https://web_portal.sesta.com/" 해당 ics.conf 매개 변수는 다음과 같습니다. ui.proxyaddress.url(기본값 없음) |
다음 표에서는 csdomain 유틸리티를 사용하여 설정할 수 있는 그 밖의 LDAP 속성 및 등록 정보에 대해 설명합니다.
표 D–17 csdomain 유틸리티를 위한 기타 LDAP 디렉토리 속성
LDAP 스키마 1을 사용하는 west.sesta.com이라는 새 호스트된 도메인을 만듭니다.
csdomain -v -n o=nodewest,o=sesta create west.sesta.com
LDAP 스키마 2를 사용하는 east.sesta.com이라는 새 호스트된 도메인을 만듭니다.
csdomain -v -n nodeeast create east.sesta.com
west.sesta.com이라는 호스트된 도메인을 위한 Calendar Server LDAP 속성 목록을 표시합니다.
csdomain -v list west.sesta.com
west.sesta.com이라는 호스트된 도메인을 위한 표준 시간대를 America/New_York으로 설정합니다.
csdomain -v -a timezone=America/New_York add west.sesta.com
csexport 유틸리티는 달력을 iCalendar(.ics) 또는 XML(.xml) 형식으로 파일로 내보냅니다. 명령은 다음과 같습니다.
calendarr 명령은 지정된 달력을 내보냅니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csexport [-v|-q] -c calid calendar outputfile |
다음 표에서는 csexport 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–18 csexport 유틸리티 명령
명령 |
설명 |
---|---|
calendar outputfile |
달력을 지정된 출력 파일로 내보냅니다. 파일의 데이터 형식은 지정된 파일 이름 확장자에 의해 결정됩니다.
|
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csexport 유틸리티 명령 옵션에 대해 설명합니다.
표 D–19 csexport 유틸리티 명령 옵션
달력 아이디가 tchang인 iCalendar(text/calendar) 형식의 달력을 tchang.ics라는 이름의 파일로 내보냅니다.
csexport -c tchang calendar tchang.ics
달력 아이디가 tchang인 XML(text/xml) 형식의 달력을 tchang.xml이라는 이름의 파일로 내보냅니다.
csexport -c tchang calendar tchang.xml
csimport 유틸리티는 csexport 유틸리티를 사용하여 내보낸 달력을 iCalendar(ics) 또는 XML 형식으로 파일에서 가져옵니다. 명령은 다음과 같습니다.
calendar 명령은 지정된 달력을 가져옵니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
달력 구성 요소를 가져오기 위한 날짜 계산은 해당 구성 요소의 X-NSCP-DTSTART-TZID에서 지정한 표준 시간대를 사용합니다. 지정한 표준 시간대가 없다면 ics.conf에 있는 서버 표준 시간대가 사용됩니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csimport [-v|-q] -c calid calendar inputfile |
다음 표에서는 csimport 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–20 csimport 유틸리티 명령
명령 |
설명 |
---|---|
calendar inputfile |
지정된 입력 파일에서 달력을 가져옵니다. 파일의 데이터 형식은 파일 이름 확장자에 의해 결정됩니다.
|
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csimport 유틸리티 명령 옵션에 대해 설명합니다.
표 D–21 csimport 유틸리티 명령 옵션
옵션 |
설명 |
---|---|
-v |
세부 정보 표시 모드로 실행합니다. 수행되는 명령에 대해 사용 가능한 모든 정보를 표시합니다. 기본값은 off입니다. |
-q |
quiet 모드로 실행합니다.
|
-c calid |
가져올 달력의 달력 아이디. 이 옵션은 calendar 명령의 필수 옵션입니다. 지정된 달력 아이디가 이미 존재하는 경우에는 가져온 데이터를 현재 달력에 병합합니다. 기본값은 없습니다. 자세한 내용은 달력 고유 아이디(calid) 만들기를 참조하십시오. |
달력 아이디가 tchang인 달력을 tchang.ics 파일에서 가져오며 다음 iCalendar(text/calendar 파일) 형식이 예상됩니다.
csimport -c tchang calendar tchang.ics
달력 아이디가 tchang인 달력을 tchang.xml 파일에서 가져오며 다음 XML(text/xml 파일) 형식이 예상됩니다.
csimport -c tchang calendar tchang.xml
csmonitor 유틸리티는 다음과 같은 모니터링 기능을 수행하는 스크립트입니다.
특정 ics.conf 매개 변수에 따라 LDAP 연결을 확인합니다.
트랜잭션 로그 파일을 확인하고 두 개 이상의 파일이 있으면 csmonitor 유틸리티가 전자 메일로 경고를 보냅니다.
달력 데이터베이스를 위해 사용할 수 있는 디스크 공간을 확인합니다.
Calendar Server 서비스가 실행되는지 확인합니다.
csmonitor [ -k | -c | -help] |
다음 표에서는 csmonitor 유틸리티에 대한 명령을 보여 줍니다.
표 D–22 csmonitor 유틸리티 명령 옵션
매개 변수 |
설명 |
---|---|
-k |
csmonitor를 중지합니다. |
-c |
csmonitor 로그를 백업한 다음 제거합니다. |
-help |
csmonitor 사용법을 표시합니다. |
다음 표에서는 csmonitor에 대해 설명합니다.
표 D–23 csmonitor 구성 매개 변수
매개 변수 |
설명 |
---|---|
service.monitor.continuous |
csmonitor가 지속적으로 루프해야 하는지 여부를 지정합니다. "0" – 연속 루프를 수행하지 않습니다. "1" – 연속 루프를 수행합니다. 기본값은 "0"입니다. |
service.monitor.loopsdelay |
두 모니터링 루프 사이의 지연 시간을 초 단위로 지정합니다. 기본값은 "60"입니다. |
service.monitor.emailaddress.from |
csmonitor가 메시지를 보내는 전자 메일 주소를 지정합니다. 기본적으로 지정된 주소가 없습니다. |
service.monitor.emailaddress.to |
csmonitor가 보내는 메시지를 받을 전자 메일 주소를 지정합니다. 기본적으로 지정된 주소가 없습니다. |
service.monitor.csdb.logthreshold |
정상으로 간주되는 최대 디스크 점유를 위한 총 디스크 공간의 백분율로 임계값을 지정합니다. 달력 데이터베이스(csdb 디렉토리)가 상주하는 디스크에서 점유율이 이 값을 초과하는 경우 csmonitor는 경고 전자 메일 메시지를 보냅니다. 기본값은 "90"입니다. |
logfile.monitor.logname |
csmonitor 로그 파일 이름을 지정합니다. 기본값은 "csmonitor.log"입니다. |
logfile.monitor.maxlogfilesize |
최대 로그 파일 크기를 지정합니다. 로그 파일이 이 크기를 초과하면 csmonitor 는 해당 로그를 csmonitor.log. timestamp로 저장하고 로그를 재설정합니다. 기본값은 "2097152"입니다. |
service.monitor.dbglevel |
디버그 수준을 지정합니다. 이 값이 클수록 csmonitor는 보다 정확하고 보다 자세한 메시지를 보냅니다. 기본값은 "0"입니다. |
csplugin은 Calendar Server 설치에 대해 구성된 CSAPI 플러그 인을 관리합니다. 명령은 다음과 같습니다.
activate 명령은 지정된 플러그 인을 로드하고 시작합니다.
deactivate 명령은 지정된 플러그 인 유형 및 이름을 종료하고 비활성화합니다. (지원되는 플러그 인 유형에 대한 설명을 보려면 표 D–25에서-t 옵션을 참조하십시오.)
list 명령은 모든 지원되는 플러그 인을 표시합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
반드시 Calendar Server가 설치된 로컬 시스템에서 실행되어야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate activate|deactivate plugin csplugin [-q|-v] list |
다음 표에서는 csplugin 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–24 csplugin 유틸리티 명령
명령 |
설명 |
---|---|
activate -t type name |
지정된 플러그 인 유형과 이름을 로드하고 활성화합니다. (지원되는 플러그 인 유형에 대한 설명을 보려면 표 D–25에서 -t 옵션을 참조하십시오.) |
deactivate -t type name |
지원되는 플러그 인 유형 및 이름을 종료하고 비활성화합니다. (지원되는 플러그 인 유형에 대한 설명을 보려면 표 D–25에서 -t 옵션을 참조하십시오.) |
list |
모든 지원되는 플러그 인 유형 이름 및 상태를 나열합니다. (지원되는 플러그 인 유형에 대한 설명을 보려면 표 D–25에서 -t 옵션을 참조하십시오.) |
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csplugin 유틸리티 명령 옵션에 대해 설명합니다.
표 D–25 csplugin 유틸리티 명령 옵션
이 서버 인스턴스와 함께 사용하기 위해 구성한 각 플러그 인의 유형, 이름 및 상태를 비롯하여 지원되는 모든 플러그 인에 대한 세부 정보를 나열합니다.
csplugin -v list
mylookup이라는 이름의 파일이 있는 lookup 유형의 플러그 인을 로드하고 활성화합니다.
csplugin activate -t lookup mylookup
mylookup이라는 이름의 파일이 있는 lookup 유형의 플러그 인을 비활성화한 다음 plugin 디렉토리에서 삭제합니다.
csplugin deactivate -t lookup mylookup -r
cspurge 유틸리티는 삭제 로그 데이터베이스(ics50deletelog.db)의 항목을 수동으로 제거할 수 있도록 합니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
cspurge [-q|-v] -e endtime -s starttime |
다음 표에서는 cspurge 유틸리티 명령 옵션에 대해 설명합니다.
표 D–26 cspurge 유틸리티 명령 옵션
다음과 같이 삭제 로그의 모든 항목을 제거합니다.
cspurge -v -e 0 -s 0
2003년 7월 1일부터 7월 31일까지의 모든 항목을 제거합니다.
cspurge -v -e 20030731T235959Z -s 20030701T120000Z
2003년 9월 30일까지의 모든 항목을 제거합니다.
cspurge -v -e 20031030T235959Z -s 0
csrename 유틸리티는 하나 이상의 달력 사용자의 이름을 바꿀 수 있도록 합니다. 이 유틸리티는 다음과 같이 달력 사용자의 이름을 바꿉니다.
달력 데이터베이스 파일–달력 데이터베이스 파일에서 사용자(사용자 아이디)의 이름을 바꾼 후 새 데이터베이스 파일을 대상 디렉토리에 씁니다. 기존 달력 데이터베이스 파일은 수정되지 않습니다.
LDAP 디렉토리 서버–Calendar Server LDAP 속성(“ics” 접미어가 붙은 속성)의 사용자 아이디를 변환합니다. LDAP 디렉토리 서버가 현재 위치에서 수정됩니다.
csrename 유틸리티는 다음 디렉토리에 있습니다.
cal_svr_base/SUNWics5/cal/sbin
csrename을 실행하기 전에 먼저 다음을 수행해야 합니다.
변환할 사용자의 입력 매핑 파일(-m 옵션)을 만듭니다.
필요하다면 LDAP 디렉토리 서버에서 새 사용자를 만듭니다.
Calendar Server를 중지합니다.
csrename을 실행하려면 icsuser(또는 구성 중에 지정된 Calendar Server 런타임 사용자 아이디)로 로그인해야 합니다. csrename를 수퍼유저(root)로 실행하는 경우에는 새 데이터베이스 파일에 대한 권한을 재설정해야 할 수도 있습니다. LDAP 디렉토리 서버 속성을 수정하려면 해당 디렉토리에 대한 관리 권한도 있어야 합니다.
Calendar Server 설치가 프런트엔드/백엔드 서버 구성인 경우에는 각 백엔드 서버에서 csrename을 실행해야 합니다.
다음 구문을 사용하여 csrename을 실행합니다.
csrename [-t DestinationDB] [-c ConfigFile] [-e ErrorFile] -m MappingFile rename [DB|LDAP] |
표에는 이 유틸리티의 옵션과 각 옵션에 대한 설명이 나열되어 있습니다.
표 D–27 csrename 옵션
옵션 |
설명 |
---|---|
-t DestinationDB |
csrename에서 변환된 사용자 아이디로 새 데이터베이스를 생성하는 대상 디렉토리를 지정합니다. 기본값은 MigratedDB입니다. csrename이 완료된 후 ics.conf 파일의 caldb.berkeleydb.homedir.path 매개 변수는 해당 대상 데이터베이스를 가리켜야 합니다. caldb.berkeleydb.homedir.path가 해당 대상 데이터베이스 디렉토리를 가리키도록 재설정하거나 대상 데이터베이스 파일을 매개 변수에서 지정한 디렉토리로 이동합니다. |
-c ConfigFile |
Calendar Server 구성 파일을 지정하는 입력 매개 변수입니다. 기본값은 ics.conf 파일입니다. csrename은 구성 파일의 caldb.berkeleydb.homedir.path 매개 변수를 사용하여 입력 달력 데이터베이스의 위치를 결정합니다. 달력 데이터베이스의 기본 위치는 /var/opt/SUNWics5/csdb입니다. |
-e ErrorFile |
csrename에서 해결할 수 없는 모든 오류 또는 데이터베이스 항목을 쓰는 파일입니다. 기본값은 MigrateError입니다. |
-m MappingFile |
입력 매핑 파일을 지정합니다. 기본값은 MigrateMapping입니다. 입력 매핑 파일은 기존 사용자 아이디를 새 사용자 아이디에 매핑하는 텍스트 파일입니다. csrename을 실행하기 전에 매핑 파일을 만들어야 합니다. 기존 값과 새 값 사이에 공백을 사용하여 각 행마다 하나씩 항목을 지정합니다. 예를 들면 다음과 같습니다. tchang tc897675 jsmith js963123 bkamdar bk548769 결과를 감사할 때 수행되지 않은 이름 바꾸기가 하나 이상 있는 것이 발견되면 빠진 이름만 넣은 새 매핑 파일을 만들고 csrename을 다시 실행하면 오류를 수정할 수 있습니다. |
DB|LDAP |
업데이트되는 데이터베이스를 지정합니다. DB는 새 달력 데이터베이스에서만 사용자 아이디를 변환합니다(기본값). LDAP는 새 달력 데이터베이스와 LDAP 디렉토리 서버 속성 둘 다에서 사용자 아이디를 변환합니다. |
DBMapFile이라는 매핑 파일을 기반으로 사용자 아이디를 변경하고 newcalDB 라는 대상 디렉토리에 새 달력 데이터베이스를 만듭니다.
csrename -t newcalDB -m DBMapFile rename DB
NewNames라는 매핑 파일의 값을 기반으로 사용자 아이디를 변경하고, NewDB라는 대상 디렉토리에 새 달력 데이터베이스를 만들고, LDAP 디렉토리 서버의 Calendar Server 속성을 수정합니다.
csrename -t NewDB -m NewNames rename LDAP
csresource 유틸리티는 회의실 또는 장비와 같은 자원에 대한 LDAP 항목 및 달력을 만들고 관리합니다. (csresource 유틸리티는 자원과 관련된 달력에 대해서만 사용할 수 있으며 사용자의 달력에 대해 실행하면 오류를 반환합니다. 명령은 다음과 같습니다.
create 명령은 지정된 달력 아이디(calid)를 위한 새 자원을 추가합니다.
delete 명령은 한 자원 또는 모든 자원을 제거합니다.
disable 명령은 한 자원 또는 모든 자원을 비활성화합니다.
enable 명령은 한 자원 또는 모든 자원을 활성화합니다.
list 명령은 단일 자원 또는 모든 자원 목록을 표시합니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csresource [-q|-v] [-a aces] [-b basedn] [-d domain] [-t description] [-k yes|no] [-o owner] [-y otherowners] -m email -c calid create common_name csresource [-q|-v] [-b basedn] [-d domain] delete|disable|enable [common_name] csresource [-q|-v] [-b basedn] [-d domain] [-h host] list [common_name] |
다음 표에서는 csresource 유틸리티에 사용할 수 있는 명령을 보여 줍니다.
표 D–28 csresource 유틸리티 명령
명령 |
설명 |
---|---|
create common_name |
지정된 달력 아이디를 위한 새 자원을 만듭니다. |
delete [common_name] |
하나의 자원을 삭제하거나, 자원 common_name이 지정되지 않은 경우 모든 자원을 삭제합니다. |
enable [common_name] |
하나의 자원을 활성화하거나, 자원 common_name이 지정되지 않은 경우 모든 자원을 활성화합니다. |
disable [common_name] |
하나의 자원을 비활성화하거나, 자원 common_name이 지정되지 않은 경우 모든 자원을 비활성화합니다. |
list [common_name] |
단일 자원을 표시하거나, 자원 name이 지정되지 않은 경우에는 모든 자원을 표시합니다. -h host 옵션이 포함된 경우에는 그 백엔드 서버 상의 지정된 이름(또는 모든 자원 달력)의 달력 속성을 표시합니다. |
위의 명령 중 name에 공백이 있는 경우에는 큰따옴표(" ")로 묶어야 합니다.
다음 표에서는 csresource 유틸리티 명령 옵션에 대해 설명합니다.
표 D–29 csresource 유틸리티 명령 옵션
옵션 |
설명 |
---|---|
-v |
세부 정보 표시 모드로 실행합니다. 수행되는 명령에 대해 사용 가능한 모든 정보를 표시합니다. 기본값은 off입니다. |
-q |
quiet 모드로 실행합니다.
|
-a [aces] |
지정된 달력에 대한 액세스 제어 항목(ACE)입니다. ACE는 그룹 예약 달력에 액세스할 수 있는 사용자와 만들기, 삭제, 읽기, 쓰기 권한 등의 보유 권한 유형을 결정합니다. ACE 문자열이나 액세스 제어 목록(ACL)은 큰따옴표("")로 묶어야 합니다. 기본값은 resource.default입니다.ics.conf 파일의 acl 매개 변수입니다. ACE 형식에 대한 자세한 내용은 달력 액세스 제어를 참조하십시오. |
-b [basedn] |
지정된 자원에 사용할 LDAP 기본 DN(고유 이름)입니다. 기본값은 ics.conf 파일의 local.ugldapbasedn 매개 변수에서 가져옵니다. |
-c calid |
icsCalendar 속성입니다. 이 옵션은 create 명령의 필수 옵션입니다. 자세한 내용은 달력 고유 아이디(calid) 만들기를 참조하십시오. |
-d domain |
호스트된(가상) 도메인의 이름을 지정합니다. 기본값은 ics.conf 파일의 service.defaultdomain 매개 변수에서 가져옵니다. |
-t [description] |
달력의 목적에 대해 볼 수 있는 설명을 지정합니다. 기본적으로 설명이 없습니다. |
-h host |
자원 달력이 상주하는 백엔드 서버의 이름을 지정합니다. 이 옵션은 list 명령에만 적용됩니다. |
-k yes|no |
회의실과 같은 자원과 관련된 달력에 대해 이중 예약이 허용되는지 여부를 지정합니다. 예를 들어, yes는 같은 시간에 자원 달력에 둘 이상의 이벤트가 예정될 수 있다는 것을 의미합니다. -k 옵션을 생략하면 ics.conf 파일의 resource.allow.doublebook 매개 변수에서 기본값을 가져옵니다. 그러나 resource.allow.doublebook 매개 변수는 달력이 만들어진 때만 사용됩니다. 달력이 만들어진 후 Calendar Server에서는 달력 등록 정보 데이터베이스(ics50calprops.db)를 검사하여 이중 예약이 허용되는지 확인합니다. 달력에 대한 이중 예약을 허용 또는 금지하도록 달력 등록 정보를 변경해야 할 경우에는 csresource를 -k 옵션과 함께 다시 실행합니다. |
-m email |
자원을 위한 LDAP 메일 속성(기본 전자 메일 주소)을 지정합니다. |
-o owner |
주 소유자. |
-y otherowners |
다른 소유자. 여러 명의 소유자는 큰따옴표( " ")로 묶고 공백으로 구분해야 합니다. 기본값은 다른 소유자가 없는 것입니다. |
version |
유틸리티의 버전을 표시합니다. |
모든 자원 달력 및 LDAP 속성 목록을 표시합니다.
csresource -v list
달력 아이디(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
표시 가능 이름이 MeetingRoom100인 자원 달력의 LDAP 속성을 백엔드 서버 sesta에 표시합니다.
csresource -v -h sesta list MeetingRoom100
csrestore 유틸리티는 csbackup 또는 csexport 유틸리티를 사용하여 저장한 달력 데이터베이스, 지정된 달력 또는 사용자의 기본 달력을 복원합니다. 명령은 다음과 같습니다.
database 명령은 달력 데이터베이스를 복구합니다.
calendar 명령은 지정된 달력을 복원합니다.
defcal 명령은 사용자의 기본 달력을 복원합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
지정된 백업 디렉토리에 있는 caldb.conf 버전 파일은 백업된 데이터베이스의 버전 번호를 표시합니다.
Calendar Server 6 csrestore 유틸리티는 csrestore 2 버전과 호환될 수 없습니다. 데이터가 손상될 수 있기 때문에 Calendar Server 2 csrestore를 사용하여 백업한 데이터는 복구하지 마십시오.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
달력 데이터베이스를 복구할 경우 Calendar Server는 중지되어 있어야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csrestore [-v|-q] [-f] database inputdir csrestore [-v|-q] -c calid calendar inputfile csrestore [-v|-q] -a userid [-b basedn] defcal inputfile |
다음 표에서는 csrestore 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–30 csrestore 유틸리티 명령
다음 표에서는 csrestore 유틸리티 명령 옵션에 대해 설명합니다.
표 D–31 csrestore 유틸리티 명령 옵션
옵션 |
설명 |
---|---|
-v |
세부 정보 표시 모드로 실행합니다. 수행되는 명령에 대해 사용 가능한 모든 정보를 표시합니다. 기본값은 off입니다. |
-q |
quiet 모드로 실행합니다.
|
-a userid |
복구할 사용자 아이디입니다. 이 옵션은 기본 옵션과 함께 필수 옵션입니다. 기본값은 없습니다. |
-b basedn |
지정된 사용자 아이디에 사용할 LDAP 기본 DN(고유 이름)입니다. 기본값은 ics.conf 파일에 정의된 setting local.ugldapbasedn에서 가져옵니다. |
-f |
기존 데이터베이스 파일을 강제 삭제합니다. |
-c calid |
복구할 달력 아이디입니다. 이 옵션은 calendar 명령의 필수 옵션입니다. 기본값은 없습니다. 자세한 내용은 달력 고유 아이디(calid) 만들기를 참조하십시오. |
이전에 csbackup 유틸리티를 사용하여 저장했던 backupdir 디렉토리에 저장된 달력 데이터베이스를 복원합니다.
csrestore database backupdir
이전에 csbackup 또는 csexport 유틸리티를 사용하여 iCalendar(텍스트/달력 파일) 형식으로 저장한 backupdir 디렉토리에 있는 tchang.ics 파일에서 달력 아이디가 tchang인 달력을 복원합니다.
csrestore -c tchang calendar backupdir/tchang.ics
이전에 csbackup을 사용하여 저장한 backupdir의 달력 데이터베이스에서 tchang를 복구합니다.
csrestore -c tchang calendar backupdir
이전에 csbackup 또는 csexport 유틸리티를 사용하여 iCalendar(텍스트/달력 파일) 형식으로 저장한 backupdir 디렉토리에 있는 tchang.ics 파일에서 tchang이 소유한 기본 달력을 복원합니다.
csrestore -a tchang defcal backupdir/tchang.ics
csschedule 유틸리티는 그룹 예약 엔진(GSE) 대기열에 저장된 일정 항목을 관리합니다. 명령은 다음과 같습니다.
list 명령은 지정된 달력 아이디에 의해 요청된 GSE 대기열에 포함된 항목을 표시합니다.
delete 명령은 지정된 달력 아이디에 의해 요청된 GSE 대기열에서 항목을 삭제합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server를 중지해야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csschedule [-q|-v] [-c count] [-e endtime] [-s starttime] [-t scheduletime -o offset] [-u uid] list [calid] csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber -r rid] list [calid] csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber -r rid] delete [calid] csschedule [-q|-v] [-s starttime] [-e endtime] delete [calid] |
다음 표에서는 csschedule 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–32 csschedule 유틸리티 명령
명령 |
설명 |
---|---|
list |
지정된 달력 아이디에 의해 요청된 GSE 대기열에 포함된 항목을 표시합니다. |
delete |
지정된 달력 아이디에 의해 요청된 GSE 대기열에서 항목을 삭제합니다. |
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csschedule 유틸리티 명령 옵션에 대해 설명합니다.
표 D–33 csschedule 유틸리티 명령 옵션
GSE 대기열에 저장된 모든 항목을 상세히 나열합니다.
csschedule -v list
GSE 대기열에 저장된 처음 10개의 항목을 나열합니다.
csschedule -c 10 list
12/31/2000 10:30:45에서 11:30:45 사이에 예약된 GSE 대기열의 항목을 나열합니다.
csschedule -s 20001231T103045Z -e 20001231T113045Z list
12/31/2000 10:30:45에 예약되고 그 시간의 오프셋 숫자가 2이며 고유 아이디가 1111, 반복 아이디가 0, 시퀀스 번호가 0인 tchang 달력을 위한 GSE 대기열 항목을 나열합니다.
csschedule -v -t 20001231T103045Z -o 2 -u 1111 -r 0 -n 0 list tchang
12/31/2000 10:30:45에 예약되고 그 시간의 오프셋 숫자가 1이며 고유 아이디가 1111, 반복 아이디가 0, 시퀀스 번호가 0인 tchang 달력을 위한 GSE 대기열 항목을 삭제합니다.
csschedule -v -t 20001231T103045Z -o 1 -u 1111 -r 0 -n 0 delete tchang
12/31/2000 10:30:45에서 16:30:45 사이의 GSE 대기열 항목을 삭제합니다.
csschedule -v -s 20001231T103045Z -e 20001231T163045Z delete
GSE 대기열의 모든 항목을 삭제합니다.
csschedule -v delete
csstats 유틸리티는 Calendar Server 통계를 표시합니다. 명령은 다음과 같습니다.
list 명령은 지정된 Calendar Server 하위 시스템에 관한 카운터 통계를 나열합니다.
version 명령은 현재 설치된 유틸리티의 버전 번호를 표시합니다.
카운터에 대한 자세한 내용은 카운터 구성(counter.conf) 파일을 참조하십시오.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태여야 합니다.
csstats [-q|v] [-r registry] [-i iterations] [-s delay] list [subsystem] |
다음 표에서는 csstats 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–34 csstats 유틸리티 명령
다음 표에서는 csstats 유틸리티 명령 옵션에 대해 설명합니다.
표 D–35 csstats 유틸리티 명령 옵션
카운터에 대한 기본 정보와 어떤 유형을 사용할 수 있는지 표시합니다.
csstats list
HTTP 서비스 하위 시스템( hpptstat)에 관한 카운터 통계를 나열합니다.
csstats list http
WCAP 하위 시스템(wcapstat )에 관한 카운터 통계를 한 시간(3600초) 동안 매 10초마다 나열합니다.
csstats -i 3600 -s 10 list wcap
cstool 유틸리티는 다음 중 하나를 핑할 수 있습니다.
HTTP 프로세스 cshttpd
관리 서비스 csadmind
이벤트 알림 서비스(ENS) 프로세스 enpd
cstool 유틸리티는 버전 번호도 표시할 수 있습니다.
cstool은 다음 프로세스의 핑에는 사용할 수 없습니다.
알림 프로세스 csnotifyd
DWP 프로세스 csdwpd
구성을 새로 고치려면 stop-cal을 사용한 후 start-cal을 사용하여 Calendar Server를 정지했다가 다시 시작합니다.
구성을 새로 고치기 위해 cstool을 사용하지 마십시오. 그러면 예측할 수 없는 부정적인 결과가 나타날 수 있습니다.
자세한 내용은 Calendar Server 시작 및 중지를 참조하십시오.
Calendar Server가 실행되고 있어야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
cstool [-q|-v] [-h host] [-p port] [-t timeout] ping [http|ens] cstool [-q|-v] [-h host] version |
다음 표에서는 cstool 명령 및 해당 매개 변수에 대해 설명합니다.
표 D–36 cstool 유틸리티 명령
명령 |
매개 변수 |
설명 |
---|---|---|
ping |
[http|admin |ens] 어느 매개 변수도 지정되지 않음 |
cshttpd 프로세스, csadmind 프로세스 또는 ENS 프로세스(enpd)를 핑합니다. Calendar Server가 있는 서버를 핑합니다. |
version |
없음 |
유틸리티의 버전을 표시합니다. |
다음 표에서는 cstool 유틸리티 옵션에 대해 설명합니다.
표 D–37 cstool 유틸리티 명령 옵션
옵션 |
설명 |
---|---|
-v |
세부 정보 표시 모드로 실행합니다. 수행되는 명령에 대해 사용 가능한 모든 정보를 표시합니다. 기본값은 off입니다. |
-q |
quiet 모드로 실행합니다.
|
-h host |
Calendar Server가 실행 중인 시스템의 호스트 이름을 지정합니다. 기본값은 설치 시에 설정되며 ics.conf 파일의 local.hostname 매개 변수에서 가져옵니다. 원격 시스템에서 실행되고 있는 Calendar Server에 액세스하는 경우에는 이 옵션을 사용하십 시오. |
-p port |
지정된 서비스의 포트. 지정된 서비스가 없는 경우에는 ics.conf 파일에 정의된 포트의 기본값을 사용합니다. |
-t timeout |
서버에서 응답할 때까지 기다리는 시간의 길이(초 단위)입니다. 기본값은 120초입니다. |
cshttpd 서비스를 핑합니다.
cstool ping http
호스트 이름이 sesta인 서버의 ENS를 핑합니다.
cstool -h sesta ping ens
호스트 이름이 calserver인 시스템을 핑하여 Calendar Server cshttpd 서비스가 포트 80에서 수신되고 있는지 확인합니다.
cstool -p 80 -h calserver -p 80 ping http
로컬 Calendar Server가 모든 서비스의 구성을 새로 고치도록 합니다.
cstool refresh
csuser 유틸리티는 LDAP 디렉토리 서버 및 Calendar Server 달력 데이터베이스에 저장된 달력 사용자 정보를 관리합니다. 명령은 다음과 같습니다.
check 명령은 사용자가 달력을 사용할 수 있는지 확인합니다.
create 명령은 달력을 위한 사용자를 만들고 달력을 사용할 수 있도록 합니다.
이 유틸리티는 Communications Express에서 필요한 주소록에 대해 사용자를 활성화하지 않습니다. 이 작업은 ldapmodify 를 사용하여 수동으로 수행해야 합니다.
delete 명령은 사용자 및 사용자의 기본 달력을 삭제합니다.
호스트되지 않은 도메인 모드에 있는 경우에 사용자를 삭제하려면 이 명령을 사용해야 합니다. 하지만, 사용자가 소유한 다른 달력은 삭제되지 않습니다. 삭제된 사용자의 다른 달력을 제거하려면 cscal을 사용합니다.
disable 명령은 Calendar Server에 사용자가 로그인할 수 없도록 비활성화합니다.
enable 명령은 사용자가 Calendar Server에 로그인할 수 있도록 활성화합니다.
list 명령은 사용자의 달력 속성을 나열합니다.
reset 명령은 사용자의 달력 속성을 기본 설정으로 재설정합니다.
Directory Server를 사용하는 경우에는 ldapsearch 및 ldapmodify 유틸리티도 사용할 수 있습니다. 이러한 유틸리티에 대한 자세한 내용은 다음 웹 사이트의 Directory Server 설명서를 참조하십시오.
http://docs.sun.com/coll/1316.1 및 http://docs.sun.com/coll/1404.1
Calendar Server는 실행 중이거나 중지되어 있을 수 있습니다.
Calendar Server가 설치된 시스템에서 유틸리티를 로컬로 실행해야 합니다.
달력 사용자 정보를 저장하는 LDAP 서버가 실행되고 있어야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
csuser [-q|-v] [-a aces] [-b basedn] -m email address [-d domain] -f filename -g givenname [-k yes|no] [-l langcode] -s surname -y userpassword create userid csuser [-q|-v] [-b basedn] [-d domain] [-h host] list [userid] csuser [-q|-v] [-b basedn] [-d domain] [check|delete|disable|enable|reset] userid |
다음 표에서는 csuser 유틸리티에 대해 사용 가능한 명령을 보여 줍니다.
표 D–38 csuser 유틸리티 명령
명령 |
설명 |
---|---|
check userid |
지정된 사용자 아이디가 달력을 사용할 수 있도록 활성화되어 있는지 확인합니다. |
create userid |
지정된 사용자 아이디를 만들고 Calendar Server에 로그인할 수 있도록 이 사용자를 활성화합니다. |
delete userid |
지정된 사용자 아이디를 삭제합니다. |
disable userid |
지정된 사용자 아이디를 달력을 사용할 수 없도록 비활성화합니다. 이 유틸리티는 http를 icsAllowedServiceAccess 속성의 값으로 정의합니다. |
enable userid |
지정된 사용자 아이디를 달력을 사용할 수 있도록 활성화합니다. |
list [userid] |
지정된 사용자 아이디에 대한 달력 속성을 나열합니다. 사용자 아이디를 지정하지 않으면 활성화된 모든 사용자에 대한 속성을 나열합니다. -hserver-name 옵션이 포함된 경우에는 그 백엔드 서버의 지정된 사용자 아이디(또는 모든 활성화된 사용자)의 달력 속성을 나열합니다. |
reset userid |
사용자 아이디를 위한 모든 달력 속성을 기본 설정으로 재설정합니다. 주: 사용자 아이디를 위한 달력 속성을 재설정한 후 모든 달력 속성은 icsCalendarUser(객체 클래스), icsSubscribed, icsCalendarOwned, icsCalendar 및 icsDWPHost(사용자가 LDAP CLD 설정에 있는 경우)를 포함한 사용자의 LDAP 항목에서 제거됩니다. 그 후에는 Calendar Server 관리자가 사용자 대신 달력을 만들 수 없습니다. 이 속성들은 Calendar Server 관리자가 사용자에 대해 csuser enable 명령을 실행하면 사용자의 LDAP 항목에 복구됩니다. |
version |
유틸리티의 버전을 표시합니다. |
다음 표에서는 csuser 유틸리티 명령 옵션에 대해 설명합니다.
표 D–39 csuser 유틸리티 명령 옵션
옵션 |
설명 |
---|---|
-v |
세부 정보 표시 모드로 실행합니다. 수행되는 명령에 대해 사용 가능한 모든 정보를 표시합니다. 기본값은 off입니다. |
-q |
quiet 모드로 실행합니다.
|
-b basedn |
모든 LDAP 사용자에 사용할 기본 DN입니다. 기본값은 ics.conf 파일에 정의된 설정 local.ugldapbasedn에서 가져옵니다. |
-b basedn |
사용자에 대한 기본 DN을 지정합니다. |
-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 형식에 대한 자세한 내용은 서비스 구성을 참조하십시오. |
-f filename |
비밀번호( -y 매개 변수)가 필요한 옵션을 위해 비밀번호를 지정할 파일 이름입니다. 스크립트에서 csuser를 실행하는 경우에 보안을 강화하려면 파일 이름에 비밀번호를 지정합니다. |
-g givenname |
사용자의 LDAP 이름입니다. 이 옵션은 필수 옵션입니다. 기본값은 없습니다. |
-h host |
사용자의 달력이 상주하는 백엔드 서버의 이름을 지정합니다. 이 옵션은 list 명령에만 적용됩니다. |
-p port |
LDAP 서버가 수신하는 포트 번호입니다. 기본값은 ics.conf 파일에 정의된 설정 local.ugldapport에서 가져옵니다. |
-k yes|no |
사용자 달력에 대해 이중 예약이 허용되는지 여부입니다. yes이면 사용자의 달력에 같은 시간에 둘 이상의 이벤트가 예약될 수 있습니다. |
-l [langcode] |
언어 코드. 기본값은 ics.conf 파일의 local.sitelanguage 값입니다. |
-m email address |
사용자를 위한 LDAP 메일 속성(주 전자 메일 주소)을 지정합니다. |
-s surname |
사용자의 LDAP 성입니다. 이 옵션은 필수 옵션입니다. 기본값은 없습니다. |
-u adminDN |
사용자 인증 정보가 저장되어 있는 LDAP 서버에 대한 관리 권한이 있는 사람의 LDAP 고유 이름(DN)입니다. 기본값은 ics.conf 파일에 정의된 구성 설정 local.enduseradmindn에서 가져옵니다. |
-w password |
-u 옵션으로 지정한 LDAP 관리자 DN에 대한 비밀번호입니다. 기본값은 ics.conf 파일에 정의된 구성 설정 local.enduseradmincred에서 가져옵니다. 이 옵션은 -u 옵션을 사용할 경우에는 필수입니다. |
-y userpassword |
필요한 달력 사용자의 비밀번호입니다. 기본값은 없습니다. |
달력 사용자 jsmith@sesta.com이 달력을 사용할 수 있도록 활성화되어 있는지 확인합니다(기존 달력 사용자가 이 Calendar Server의 달력 데이터에 액세스할 권한이 있는 경우).
csuser check jsmith@sesta.com
사용자 아이디가 jsmith@sesta.com이고 이름이 John, 성이 Smith, 전자 메일 주소가 jsmith@sesta.com, 도메인이 sesta.com인 LDAP 사용자를 만듭니다.
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가 접두어로 붙은 모든 달력 사용자 아이디를 나열합니다.
csuser -v list "user*"
jsmith@sesta.com의 모든 달력 속성을 기본 구성 설정으로 재설정합니다.
csuser reset jsmith@sesta.com
백엔드 서버 sesta에서 tchang의 모든 달력 속성을 나열합니다.
csuser -v -h sesta list tchang
start-cal 유틸리티는 다음 순서로 Calendar Server 서비스를 시작합니다.
enpd— 이벤트 알림 서비스(ENS)
csnotifyd— 알림 서비스
csadmind— 관리 서비스
csdwpd— 원격 Calendar Server 데이터베이스 구성으로만 시작되는 분산 데이터베이스 서비스인 DWP(데이터베이스 와이어 프로토콜) 서비스
cshttpd— HTTP 서비스
Calendar Server가 설치된 시스템에서 start-cal 유틸리티를 로컬로 실행해야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
start-cal |
cal_svr_base/SUNWics5/cal/sbin/start-cal
자세한 내용은 Calendar Server 시작 및 중지를 참조하십시오.
stop-cal 유틸리티는 모든 Calendar Server 서비스를 중지합니다.
Calendar Server가 설치된 시스템에서 stop-cal 유틸리티를 로컬로 실행해야 합니다.
설치 중에 지정한 Calendar Server가 실행되고 있는 사용자와 그룹(icsuser, icsgroup 등) 또는 root로 로그인된 상태이어야 합니다.
stop-cal |
cal_svr_base/SUNWics5/cal/sbin/stop-cal
자세한 내용은 Calendar Server 시작 및 중지를 참조하십시오.