12장 Calendar Server 관리

이번 장 및 III부에서 이어지는 장들은 Calendar Server의 관리 방법에 대해 설명하며 다음 내용으로 구성되어 있습니다.

Delegated Administrator 유틸리티(이전의 사용자 관리 유틸리티)나 Calendar Server 명령줄 유틸리티를 실행하고 ics.conf 구성 파일을 편집하여 Calendar Server를 관리합니다.

명령줄 유틸리티를 실행하려면 Calendar Server가 실행되고 있는 시스템에 대해 관리 권한을 가진 사용자로 로그인해야 합니다.


주	추가 관리 항목에 대해서는 별도의 장에서 설명합니다. 그 중에는 다음 내용이 포함됩니다. 13장, "호스트된 도메인 관리" 14장, "사용자 및 자원 관리" 15장, "달력 관리" 16장, "csdb를 사용하여 Calendar Server 데이터베이스 관리" 17장, "Calendar Server 데이터 백업 및 복원" 18장, "삭제 로그 데이터베이스 관리" 19장, "Calendar Server 표준 시간대 관리" 20장, "Instant Messaging 팝업 미리 알림 사용" 21장, "Calender Server 성능 조정" 22장, "문제 해결"

Calendar Server 시작 및 중지

이 절에서는 start-cal 및 stop-cal 사용 방법에 대해 설명하며, 다음 내용으로 구성되어 있습니다.

start-cal 및 stop-cal 정보

start-cal을 사용하여 Calendar Server를 시작하려면

stop-cal을 사용하여 Calendar Server를 중지하려면

start-cal 및 stop-cal 정보

start-cal 및 stop-cal 명령을 사용하여 Calendar Server를 시작하고 중지할 수 있습니다. start-cal 및 stop-cal 유틸리티는 cal_svr_base/SUNWics5/cal/sbin 디렉토리에 있습니다. Calendar Server가 설치된 로컬 시스템에서 이러한 유틸리티들을 실행해야 합니다.


주	Calendar Server는 이전 릴리스와의 호환성을 위해서만 csstart 및 csstop 유틸리티를 제공합니다. 가능한 경우 Calendar Server 시작과 중지에는 start-cal 및 stop-cal 유틸리티를 사용하는 것이 좋습니다.

start-cal 유틸리티는 다음 순서대로 Calendar Server 서비스를 시작합니다.

enpd — ENS(이벤트 알림 서비스)

csnotifyd — 알림 서비스

csadmind — 관리 서비스

csdwpd — 원격 Calendar Server 데이터베이스 구성에서만 시작되는 분산 데이터베이스 서비스인 DWP(데이터베이스 와이어 프로토콜) 서비스

cshttpd — HTTP 서비스

csstored — 자동 백업 서비스

이 서비스에 대한 자세한 설명은 "Calendar Server 서비스"를 참조하십시오.

start-cal을 사용하여 Calendar Server를 시작하려면

시스템에 관리 권한이 있는 사용자로 로그인합니다.

cal_svr_base/SUNWics5/cal/sbin 디렉토리로 변경합니다.

다음을 사용하여 Calendar Server를 시작합니다.

./start-cal

stop-cal을 사용하여 Calendar Server를 중지하려면

Calendar Server가 실행되고 있는 시스템에 대한 관리 권한이 있는 사용자로 로그인합니다.

cal_svr_base/SUNWics5/cal/sbin 디렉토리로 변경합니다.

다음을 사용하여 Calendar Server를 중지합니다.

./stop-cal

자동 백업 활성화 또는 비활성화

자동 백업은 start-cal을 실행하면 자동으로 시작되는 csstored 프로세스에서 관리됩니다. 하지만 원하는 대로 자동 백업을 활성화/비활성화할 수 있습니다. 기본값은 자동 백업 비활성화입니다. csstored 프로세스는 자동 백업이 비활성화된 경우에도 실행됩니다.

자동 백업에는 핫 백업과 아카이브 백업의 두 가지 종류가 있습니다. 두 백업을 각각 활성화/비활성화할 수 있습니다.

start-cal을 실행하기 전에 csstored 프로세스를 구성해야 합니다. 그렇지 않으면 csstored를 구성하지 않았다는 오류 메시지를 받게 됩니다. 이후 csstored가 구성될 때까지 24시간마다 동일한 메시지를 받게 됩니다.

핫 백업을 활성화하려면

명령줄에서 ics.conf가 있는 디렉토리로 변경합니다.

cd /etc/opt/SUNWics5/config

다음 ics.conf 매개 변수를 "yes"로 설정하여 핫 백업을 활성화합니다.

caldb.berkeleydb.hotbackup.enable="yes"

핫 백업 디렉토리의 디렉토리 경로를 지정합니다.

caldb.berkeleydb.hotbackup.path=/var/opt/SUNWics5/hotbackup_directory

기본값은 현재 디렉토리입니다.

ics.conf 파일 편집이 완료되면 Calendar Server를 다시 시작합니다.

cal_svr_base/SUNWics5/cal/sbin/start-cal

ics.conf 파일을 편집하기 위해 달력 서비스를 중지할 필요는 없지만 변경 내용을 적용하려면 서비스를 다시 시작해야 합니다.

아카이브 백업을 활성화하려면

명령줄에서 ics.conf가 있는 디렉토리로 변경합니다.

cd /etc/opt/SUNWics5/config

다음 ics.conf 매개 변수를 "yes"로 설정하여 아카이브 백업을 활성화합니다.

caldb.berkeleydb.archive.enable="yes"

아카이브 백업 디렉토리의 디렉토리 경로를 지정합니다.

caldb.berkeleydb.archive.path=/var/opt/SUNWics5/hotbackup_directory

기본값은 현재 디렉토리입니다.

ics.conf 파일 편집이 완료되면 Calendar Server를 다시 시작합니다.

cal_svr_base/SUNWics5/cal/sbin/start-cal

ics.conf 파일을 편집하기 위해 달력 서비스를 중지할 필요는 없지만 변경 내용을 적용하려면 서비스를 다시 시작해야 합니다.

핫 백업을 비활성화하려면

백업은 기본적으로 비활성화되어 있습니다. 이전에 활성화한 백업을 비활성화하려면 다음 단계를 수행합니다.

명령줄에서 ics.conf가 있는 디렉토리로 변경합니다.

cd /etc/opt/SUNWics5/config

다음 ics.conf 매개 변수를 "no"로 설정하여 핫 백업을 비활성화합니다.

caldb.berkeleydb.hotbackup.enable="no"

ics.conf 파일 편집이 완료되면 Calendar Server를 다시 시작합니다.

cal_svr_base/SUNWics5/cal/sbin/start-cal

ics.conf 파일을 편집하기 위해 달력 서비스를 중지할 필요는 없지만 변경 내용을 적용하려면 서비스를 다시 시작해야 합니다.

아카이브 백업을 비활성화하려면

백업은 기본적으로 비활성화되어 있습니다. 이전에 활성화된 백업을 비활성화하려면 다음 단계를 수행합니다.

명령줄에서 ics.conf가 있는 디렉토리로 변경합니다.

cd /etc/opt/SUNWics5/config

다음 ics.conf 매개 변수를 "no"로 설정하여 아카이브 백업을 비활성화합니다.

caldb.berkeleydb.archive.enable="no"

ics.conf 파일 편집이 완료되면 Calendar Server를 다시 시작합니다.

cal_svr_base/SUNWics5/cal/sbin/start-cal

ics.conf 파일을 편집하기 위해 달력 서비스를 중지할 필요는 없지만 변경 내용을 적용하려면 서비스를 다시 시작해야 합니다.

그룹 예약 엔진 대기열 관리

그룹 예약 엔진(GSE)에는 구성 요소 데이터베이스의 업데이트에 사용되는 이벤트 대기열이 있습니다. 관리자는 시간 초과 값을 변경하여 Calendar Server에서 대기열을 스캔하는 시간 간격을 조정할 수 있습니다. 필요한 경우에는 대기열에 있는 이벤트를 나열하거나 특정 이벤트를 삭제할 수도 있습니다.

GSE 정보

GSE에서는 Calendar Server 사용자가 이벤트를 만들고 다른 참가자를 초대할 수 있습니다. 참석자가 같은 Calendar Server에 있을 경우 참석자의 달력에 이벤트가 예약됩니다. 같은 Calendar Server에 있지 않으면 전자 메일을 통해 초대가 보내집니다. 그러고 나면 참가자가 초대를 승인 또는 거부하고 GSE에서 응답으로 이벤트를 업데이트할 수 있습니다.

GSE 대기열 정보

실제로 GSE 대기열은 GSE에서 관리하는 별도의 데이터베이스입니다. Calendar Server에서는 대기열을 스캔하여 구성 요소 데이터베이스에 필요한 업데이트를 찾습니다.

이 스캔의 빈도를 조정하면 Calendar Server를 조정할 수 있습니다. ics.conf 파일에서 gse.belowthresholdtimeout의 시간 초과 값을 변경하면 됩니다. 21장, "Calender Server 성능 조정"을 참조하십시오.

GSE 대기열 항목은 csschedule을 사용하여 관리(나열 및 삭제)할 수 있습니다. Calendar Server가 설치된 로컬 시스템에서 csschedule을 실행해야 합니다.

GSE 대기열의 항목을 나열하려면

GSE 대기열의 항목을 나열하려면 csschedule 유틸리티 list 명령을 사용합니다. 예를 들어, GSE 대기열의 모든 항목을 나열하려면 다음 명령을 사용합니다.

GSE 대기열에 저장된 처음 10개 항목을 나열하려면 다음 명령을 사용합니다.

To list all entries in the GSE queue for a calendar with the calid Holiday_Schedule:

GSE 대기열의 항목을 삭제하려면

GSE 대기열에서 항목을 삭제하려면 csschedule 유틸리티 delete 명령을 사용합니다. 예를 들어, GSE 대기열의 모든 항목을 삭제하려면 다음 명령을 사용합니다.

GSE 대기열에서 calA 달력에 대해 처음 예약 시간이 11/30/2001의 13:30:45, 오프셋 번호가 1, 고유 아이디가 1111, 반복 아이디가 0, 그리고 시퀀스 번호가 0인 항목을 삭제하려면 다음 명령을 사용합니다.

Calendar Server 모니터링

일상 작업 과정에서 시스템 작업을 모니터할 수 있습니다. csmonitor, csstats, cstool 등과 같은 몇 가지 유틸리티 도구를 사용하여 Calendar Server 작업을 모니터할 수 있습니다. 또한 시스템 사용을 모니터하는 데 도움되는 많은 로그 파일을 설정할 수 있습니다.

Calendar Server 로그 파일 사용

csmonitor 정보

이 Calendar Server 유틸리티는 bash가 필요한 쉘 스크립트입니다. 이 유틸리티는 호출되면 다음과 같은 기능을 수행합니다.

ics.conf 파일에 지정된 로그 수준에 따라 csadmind, csnotifyd, cshttpd, enpd 등과 같은 프로세스를 모니터하고 기록합니다.

cshttpd가 명령을 적용 중인지 확인합니다.

시스템에 LDAP 연결이 있는지 확인합니다.

순환 로깅이 사용 가능한 경우 트랜잭션 파일이 두 개 이상 있는지 확인한 다음 그렇다면 전자 메일 경고를 보냅니다.

달력 데이터베이스에서 작업을 제대로 수행하는 데 충분한 디스크 공간이 있는지 확인합니다.

이 유틸리티는 오류가 발생할 경우 해당 오류를 기록하고 ics.conf 매개 변수 service.monitor.emailaddress.to에 지정된 관리자에게 전자 메일로 알립니다.

디버깅을 위해 매우 짧은 간격으로 연속 루프에서 실행하도록 모니터를 구성할 수 있습니다. 그렇게 하려면 많은 시스템 자원이 필요하기 때문에 일반 작업 중에는 이 모드에서 유틸리티를 실행하지 않습니다.

일반 환경에서 csmonitor를 사용하려면 선택한 간격으로 실행하도록 유틸리티를 설정해야 합니다.

csmonitor를 구성하려면

구성 변경 권한이 있는 관리자로 로그인합니다.

/etc/opt/SUNWics5/cal/config 디렉토리로 변경합니다.

이전 ics.conf 파일을 복사하고 이름을 변경한 다음 저장합니다.

표 12-1에 표시된 ics.conf 매개 변수 중 하나 이상을 편집합니다.

표 12-1 ics.conf 파일의 csmonitor 유틸리티 구성 매개 변수
매개 변수	설명 및 기본값
service.monitor.continuous	csmonitor가 지속적으로 루프해야 하는지 여부를 지정합니다. "0" – 연속 루프를 수행하지 않습니다(기본값). "1" – 연속 루프를 수행합니다. csmonitor가 자동으로 실행되게 하려면 이 매개 변수를 "1"로 설정합니다.
service.monitor.loopsdelay	두 모니터링 루프 사이의 지연 시간을 초 단위로 지정합니다. 기본값은 "60"초입니다. 디버깅을 위해서는 간격을 짧게 설정하고 작업을 위해서는 간격을 길게 설정하는 것이 좋습니다.
service.monitor.emailaddress.from	csmonitor가 메시지를 보내는 전자 메일 주소를 지정합니다. 지정된 기본값은 없습니다.
service.monitor.emailaddress.to	csmonitor가 보내는 메시지를 받을 전자 메일 주소를 지정합니다. 지정된 기본값은 없습니다.
service.monitor.csdb.logthreshold	달력 데이터베이스(csdb)를 모니터합니다. 최대 디스크 점유를 위한 총 디스크 공간의 백분율로 임계값을 지정합니다. csdb 디렉토리의 디스크 점유율이 이 값을 초과하는 경우 경고 전자 메일 메시지를 보냅니다. 기본값은 "90"입니다.
logfile.monitor.logname	csmonitor 로그 파일 이름을 지정합니다. 기본값은 "csmonitor.log"입니다.
logfile.monitor.maxlogfilesize	최대 로그 파일 크기를 지정합니다. 로그 파일이 이 크기를 초과하면 csmonitor는 해당 로그를 csmonitor.log.timestamp로 저장하고 현재 로그를 재설정합니다. 기본값은 "20971520"입니다.
service.monitor.dbglevel	디버그 수준을 지정합니다. 범위는 0-5이며 이 값이 클수록 csmonitor는 더 정밀하고 상세한 메시지를 보냅니다. 기본값은 "0"이며 로깅을 지정하지 않습니다. 값 "5"는 디버그 로깅을 나타냅니다.

파일을 ics.conf로 저장합니다.

Calendar Server를 다시 시작합니다.

cal_svr_base/SUNWics5/cal/sbin/start-cal

카운터 통계 나열

csstats 유틸리티는 달력 구성(counter.conf) 파일에 정의된 카운터 객체의 통계 정보를 표시합니다. httpstat, authstat, wcapstat 또는 dbstat와 같은 카운터 객체는 다음과 같이 Calendar Server에 대한 정보를 표시합니다.

최대 동시 연결 수 및 전체 연결 수

전체 성공/실패한 로그인 및 연결 수

데이터베이스 읽기, 쓰기 및 삭제 수

모니터링을 위한 cstool 사용

Calendar Server가 설치되는 시스템과 다음 서비스를 핑할 수 있습니다.

cshttpd

csadmind

enpd

Calendar Server 로그 파일 사용

각 Calendar Server 서비스는 자체 로그 파일에 상태 정보를 기록합니다. 표 12-2와 같이 각 로그 파일은 해당 서비스 이름을 따라 명명됩니다.

표 12-2 Calendar Server 로그 파일
서비스 이름	로그 파일 이름
관리 서비스(csadmind)	admin.log
분산 데이터베이스 서비스(csdwpd)	dwp.log
HTTP 서비스(cshttpd)	http.log
알림 서비스(csnotifyd)	notify.log
단일 사인 온 로그	am_sso.log
시작 명령 로그	start.log
정지 명령 로그	stop.log
저장 명령 로그	store.log

각 로그 파일은 고유한 번호로 식별되는 새 로그 파일로 롤오버됩니다. 예를 들면 다음과 같습니다.

Calendar Server는 표 12-3의 설명처럼 로그 파일에 보고된 이벤트에 대해 6가지 심각도 수준을 제공합니다. ics.conf 매개 변수 logfile.loglevel을 수정하여 Calendar Server가 로그 파일에 보고하는 이벤트의 심각도 수준을 지정할 수 있습니다.

표 12-3 Calendar Server 로그 오류 심각도 수준
심각도 수준	의미
CRITICAL	심각한 조건
ERROR	오류 조건
WARNING	경고 조건
NOTICE	정상적이지만 통보 조건. 각 달력 서비스의 기본 보고 수준입니다.
INFORMATION	참조용
DEBUG	디버그 수준 메시지

로그 이벤트는 타임스탬프, 서버 호스트 이름, 심각도 수준, 프로세스 이름(프로세스 아이디), 이벤트 유형, 우선 순위 및 설명을 보여 주는 하나의 행으로 표시됩니다.

CLD 캐시 지우기

CLD 캐시를 활성화한 경우 가끔씩 캐시를 지워야 합니다. 이 절은 다음 내용으로 구성되어 있습니다.

캐시를 지우는 이유

CLD 캐시를 지우려면

캐시를 지우는 이유

CLD 캐시는 다음과 같은 다양한 이유로 시스템 구성과 동기화되지 않을 수 있습니다.

서버를 추가, 삭제 또는 이름 변경한 경우

서버를 구성의 한 기능에서 다른 기능으로 이동한 경우

하나 이상의 달력을 다른 백엔드 서버로 이동한 경우

위와 같은 경우에 CLD 캐시를 새로 고치려면 CLD 캐시를 지워야 합니다.

CLD 캐시를 지우려면

Calendar Server를 중지합니다.

/var/opt/SUNWics5/csdb/cld_cache 디렉토리의 모든 파일을 지우되 cld_cache 디렉토리 자체는 제거하지 않습니다.

Calendar Server를 다시 시작합니다.

서버 이름 변경

구성에서 서버 이름을 추가, 삭제 또는 변경한 경우 오류 방지를 위해 다음과 같은 몇 가지 "작업 관리" 단계를 수행해야 합니다.

CLD 캐시 지우기

이전 서버를 제거한 경우 해당 서버가 표시된 ics.conf 매개 변수에서 서버를 삭제합니다.

익명 액세스 구성

익명 액세스는 인증이 필요하지 않은 특수 로그인입니다. 익명 로그인을 사용 가능하게 하면 공용 달력에 대한 읽기 및 쓰기 액세스가 기본적으로 사용 가능해집니다. 공용 달력에 대한 쓰기 액세스를 거부할 수 있습니다. 이 절은 다음 내용으로 구성되어 있습니다.

익명 액세스를 활성화하려면

익명 사용자가 공용 달력에 쓸 수 없게 하려면



주	Communications Express는 익명 로그인으로 쓰기 및 읽기가 모두 가능해질 것으로 예상합니다. Communications Express를 지원하도록 Calendar Server를 구성하려면을 참조하십시오.

익명 액세스를 활성화하려면

구성 변경 권한이 있는 관리자로 로그인합니다.

/etc/opt/SUNWics5/cal/config 디렉토리로 변경합니다.

이전 ics.conf 파일을 복사하고 이름을 변경한 다음 저장합니다.

익명 액세스를 활성화하도록 ics.conf에서 다음 매개 변수를 편집합니다.

표 12-4 익명 액세스를 활성화하는 데 사용되는 ics.conf 매개 변수
매개 변수	설명 및 기본값
service.http.allowanonymous 로그인	필요한 경우 이 매개 변수를 "yes"로 설정하여 익명 액세스(로그인)를 가능하게 합니다. 기본값은 "yes"입니다.
service.calendarsearch.ldap	보안상 익명 로그인이 가능한 상태에서 이 매개 변수를 "no"(기본값)로 설정하여 달력 검색을 수행할 때 LDAP를 통한 검색이 불가능하게 할 수 있습니다.



주	Communications Express는 service.calendarsearch.ldap 매개 변수의 값이 "no"일 것으로 기대합니다. 이는 DWP 환경에서 최적의 성능을 위한 시스템 조정 지침과 충돌합니다(데이터베이스가 여러 백엔드에 분산됨). DWP 환경의 달력 검색 성능 향상을 참조하십시오.

파일을 ics.conf로 저장합니다.

Calendar Server를 다시 시작합니다.

cal_svr_base/SUNWics5/cal/sbin/start-cal

익명 사용자가 공용 달력에 쓸 수 없게 하려면

구성 변경 권한이 있는 관리자로 로그인합니다.

/etc/opt/SUNWics5/cal/config 디렉토리로 변경합니다.

이전 ics.conf 파일을 복사하고 이름을 변경한 다음 저장합니다.

다음 ics.conf 매개 변수를 표 12-5에 표시된 대로 편집합니다

표 12-5 익명 사용자의 공용 달력 쓰기를 비활성화하는 데 사용되는 ics.conf 매개 변수
매개 변수	설명 및 기본값
service.wcap.anonymous.allow publiccalendarwrite	익명 액세스 사용자의 공용 달력에 쓰기를 가능/사용 불가능하게 합니다. 값을 "yes"(기본값)로 설정하여 액세스를 사용 가능하게 합니다.

파일을 ics.conf로 저장합니다.

Calendar Server를 다시 시작합니다.

cal_svr_base/SUNWics5/cal/sbin/start-cal

프록시 관리자 로그인 활성화

Communications Express를 구현하려면 프록시 관리자 로그인(프록시 인증)을 활성화해야 합니다. Communications Express를 사용하지 않는 경우에도 프록시 인증을 가능하게 할 수 있습니다. 이 절에서는 첫 번째 항목에 대해 설명합니다.

Communications Express를 사용하지 않고 프록시 인증을 활성화하려면

Communications Express를 지원하도록 Calendar Server를 구성하려면

Communications Express를 사용하지 않고 프록시 인증을 활성화하려면

다음 매개 변수를 설정하여 ics.conf 파일을 편집합니다.

service.http.allowadminproxy = "yes"

새 값을 적용하려면 Calendar Server를 다시 시작합니다.

다음 WCAP 명령을 사용하여 관리자 프록시 로그인이 제대로 작동하는지 확인합니다.

http://server[:port]/login.wcap?user=admin-user&password=admin-password
&proxyaut h=calendar-user

여기서,

server – Calendar Server가 실행 중인 서버의 이름입니다.

port – Calendar Server 포트 번호입니다. 기본 포트는 80입니다.

admin-user – Calendar Server 관리자입니다. 예를 들어, calmaster입니다.

admin-password – admin-user의 비밀번호입니다.

calendar-user – Calendar Server 사용자의 calid입니다.

명령이 성공하면 Calendar Server는 calendar-user의 달력을 표시합니다. 문제가 발생할 경우 Calendar Server는 "Unauthorized"라는 메시지를 표시합니다. 다음이 원인이 될 수 있습니다.

admin – user에게 Calendar Server 관리자 권한이 없습니다.

admin – password가 올바르지 않습니다.

calendar – user가 유효한 Calendar Server 사용자가 아닙니다.

Calendar Server 구성 새로 고침

현재 릴리스에서는 cstool refresh 명령을 사용하여 구성을 새로 고치지 마십시오. 그 대신 stop-cal 및 start-cal 명령을 사용합니다. 자세한 내용은 Calendar Server 시작 및 중지를 참조하십시오.

이전 Calendar Express UI 해제

새 Communications Express UI를 설치한 경우에는 이전 Calendar Express UI를 해제하지 않아도 됩니다. 그러나 이전 Calendar Express UI를 해제하려면 default.html 파일의 이름을 변경해야 합니다.

default.html 파일은 다음 디렉토리에 있습니다.
/opt/SUNWics5/cal/html

이전 목차 색인 다음
Sun Java System Calendar Server 6 2005Q1 관리 설명서