Sun Java System Calendar Server 6 2005Q4 관리 설명서

12장 Calendar Server 관리

이 장과 Messaging Server가 만든 도메인 사용 이후에 나오는 장들은 Calendar Server의 관리 방법을 설명하며 다음 절로 구성되어 있습니다.

Delegated Administrator 유틸리티(이전 User Management 유틸리티) 또는 Calendar Server 명령줄 유틸리티를 실행하거나 ics.conf 구성 파일을 편집하여 Calendar Server를 관리할 수 있습니다.

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

자세한 내용은 부록 D, Calendar Server 명령줄 유틸리티 참조 를 참조하십시오.


주 –

추가 관리 항목에 대해서는 별도의 장에서 설명합니다. 별도의 장은 다음 내용으로 구성되어 있습니다.


Calendar Server 시작 및 중지

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

start-cal 및 stop-cal 정보

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


주 –

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


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

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

  2. csnotifyd— 알림 서비스

  3. csadmind— 관리 서비스

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

  5. cshttpd— HTTP 서비스

  6. csstored— 자동 백업 서비스

이러한 서비스에 대한 설명을 보려면 Calendar Server 서비스를 참조하십시오.

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

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

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

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


    ./start-cal

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

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

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

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


    ./stop-cal

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

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

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

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

자동 백업에 대한 정보와 csstored 구성 지침을 보려면 10 장, 자동 백업 구성(csstored)을 참조하십시오.

다음은 자동 백업을 활성화 및 비활성화하기 위한 태스크 목록입니다.

Procedure핫 백업을 활성화하려면

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

    cd /etc/opt/SUNWics5/config

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

    caldb.berkeleydb.hotbackup.enable="yes"

  3. 핫 백업 디렉토리에 대한 디렉토리 경로를 지정합니다.

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

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

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

    cal_svr_base/SUNWics5/cal/sbin/start-cal

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

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

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

    cd /etc/opt/SUNWics5/config

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

    caldb.berkeleydb.archive.enable=”yes”

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

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

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

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

    cal_svr_base/SUNWics5/cal/sbin/start-cal

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

Procedure핫 백업을 비활성화하려면

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

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

    cd /etc/opt/SUNWics5/config

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

    caldb.berkeleydb.hotbackup.enable="no"

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

    cal_svr_base/SUNWics5/cal/sbin/start-cal

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

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

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

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

    cd /etc/opt/SUNWics5/config

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

    caldb.berkeleydb.archive.enable="no"

  3. 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 유틸리티 listlist 명령을 사용합니다.

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


csschedule list

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


csschedule -c 10 list

GSE 대기열에서 calidHoliday_Schedule인 모든 항목을 나열하려면 다음 명령을 사용합니다.


csschedule -v list Holiday_Schedule

GSE 대기열의 항목 삭제

GSE 대기열에서 항목을 삭제하려면 csschedule 유틸리티 delete 명령을 사용합니다.

예를 들어, GSE 대기열의 모든 항목을 삭제하려면 다음 명령을 사용합니다.

csschedule -v delete

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

csschedule -v -t 20011130T133045Z -o 1 -u 1111 -r 0 -n 0 delete calA

Calendar Server 모니터링

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

이 절은 다음 내용으로 구성되어 있습니다.

csmonitor 정보

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

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

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

csmonitor 유틸리티에 대한 자세한 내용은 부록 D, Calendar Server 명령줄 유틸리티 참조 를 참조하십시오.

Procedurecsmonitor를 구성하려면

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

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

  3. 이전 ics.conf 파일을 복사하고 이름을 바꿔 저장합니다.

  4. 다음 표에 표시된 ics.conf 매개 변수 중 하나 이상을 편집하십시오.

    매개 변수 

    설명 및 기본값 

    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로 저장하고 현재 로그를 재설정합니다. 기본값은 “2097152” 입니다.

    service.monitor.dbglevel

    디버그 수준을 지정합니다. 범위는 0-5이며 이 값이 클수록 csmonitor는 더 정밀하고 상세한 메시지를 보냅니다. 기본값은 “0”이며 로깅을 지정하지 않습니다. 값 “5”는 디버그 로깅을 나타냅니다.

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

  6. Calendar Server를 다시 시작합니다.

    cal_svr_base /SUNWics5/cal/sbin/start-cal

카운터 통계 나열

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

Calendar Server 카운터 통계에 대한 자세한 내용은 부록 E, Calendar Server 구성 매개 변수 를 참조하십시오.

모니터링을 위한 cstool 사용

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

cstool 사용에 대한 자세한 내용은 부록 D, Calendar Server 명령줄 유틸리티 참조 를 참조하십시오.

Calendar Server 로그 파일 사용

각 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 로그 파일은 다음 기본 디렉토리에 저장됩니다.

/var/opt/SUNWics5/logs

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

admin.log.8.1083013284 http.log.8.1083013284

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

심각도 수준 

의미 

CRITICAL 

심각한 조건 

ERROR 

오류 조건 

WARNING 

경고 조건 

NOTICE 

정상. 통보 조건각 달력 서비스의 기본 보고 수준입니다. 

INFORMATION 

참조용 

DEBUG 

디버그 수준 메시지 

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

ics.conf 로그 설정에 대한 자세한 내용은 부록 E, Calendar Server 구성 매개 변수 를 참조하십시오.

CLD 캐시 지우기

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

CLD 캐시를 지우는 이유

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

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

ProcedureCLD 캐시를 지우려면

단계
  1. Calendar Server를 중지합니다.

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

  3. Calendar Server를 다시 시작합니다.

서버 이름 변경

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

익명 액세스 구성

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


주 –

Communications Express는 익명 로그인으로 쓰기 및 읽기가 모두 가능해질 것으로 예상합니다. Communications Express를 위한 구성을 참조하십시오.


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

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

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

  3. 이전 ics.conf 파일을 복사하고 이름을 바꿔 저장합니다.

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

    매개 변수 

    설명 및 기본값 

    service.http.allowanonymouslogin

    필요한 경우 이 매개 변수를 “yes”로 설정하여 익명 액세스(로그인)를 가능하게 합니다. 기본값은 “yes”입니다.

    service.calendarsearch.ldap

    보안상 익명 로그인이 가능하게 한 상태에서 이 매개 변수를 “no”(기본값)로 설정하여 달력 검색을 수행할 때 LDAP를 통한 검색을 사용 불가능하게 할 수 있습니다.


    주 –

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


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

  6. Calendar Server를 다시 시작합니다.

    cal_svr_base /SUNWics5/cal/sbin/start-cal

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

단계
  1. 구성을 변경할 수 있는 권한을 가진 관리자로 로그인합니다.

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

  3. 이전 ics.conf 파일을 복사하고 이름을 바꿔 저장합니다.

  4. 다음 표에 표시된 ics.conf 매개 변수 중 하나 이상을 편집하십시오.

    매개 변수 

    설명 및 기본값 

    service.wcap.anonymous.

    allowpubliccalendarwrite

    익명 액세스 사용자의 공용 달력에 쓰기를 가능/사용 불가능하게 합니다. 값을 기본값인 “yes”로 설정하여 액세스를 가능하게 합니다.

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

  6. Calendar Server를 다시 시작합니다.

    cal_svr_base /SUNWics5/cal/sbin/start-cal

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

Communications Express에 대해 프록시 관리자 로그인(프록시 인증)을 활성화해야 합니다. Communications Express에 대한 프록시 인증 구성에 대한 자세한 내용은 Communications Express를 위한 구성을 참조하십시오.

그러나 Communications Express를 사용하지 않는 경우에도 프록시 인증을 가능하게 할 수 있습니다. 이 절에서는 Communications Express를 사용하지 않고 프로시 인증을 활성화하는 절차를 설명합니다.

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

단계
  1. 구성을 변경할 수 있는 권한을 가진 관리자로 로그인합니다.

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

  3. 이전 ics.conf 파일을 복사하고 이름을 바꿔 저장합니다.

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

    service.http.allowadminproxy = "yes"

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

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

Procedure프록시 인증이 작동하는지 검증하려면

단계

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

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

    여기서,

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

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

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

      • admin-passwordadmin-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-calstart-cal 명령을 사용합니다. 자세한 내용은 Calendar Server 시작 및 중지를 참조하십시오.