test

Sun Java System Communications Express 6 2005Q4 관리 설명서

일반적인 문제 해결

이 절에서는 Communications Express 사용자 인터페이스 클라이언트 구성 요소를 설치, 구성, 시작 또는 액세스할 때 발생할 수 있는 문제의 개요를 제공합니다.

다음에서는 Communications Express 구성 요소의 일반적인 여러 문제와 해당 문제의 가능한 원인을 나열합니다.

Communications Express 구성

웹 컨테이너를 다시 시작한 후에도 구성 변경 사항이 반영되지 않습니다.

해당 구성 경로의 파일에 구성 변경 사항이 적용되었는지 확인합니다.

일단 Communications Express 구성이 완료되면 다음 구성 디렉토리가 시스템에 만들어집니다.

변경 사항이 응용 프로그램에 반영되었는지 확인하려면 uwc-deployed-path/WEB-INF/config에서 구성을 변경하십시오.

uwc-deployed-path/ staging/WEB-INF/config와 uwc-basedir /SUNWuwc/WEB-INF/config 같은 다른 두 개의 디렉토리는 구성 중 구성자가 내부적으로 생성하여 사용하는 임시 자리 표시자입니다. 이러한 디렉토리에서 변경하면 응용 프로그램에 반영되지 않습니다.

구성 작업이 실패했습니다.

문제를 해결하려면 uwc-basedir /SUNWuwc/install/uwc-config _TIME-STAMP .log에 있는 로그 파일을 사용합니다.

여기서 TIME-STAMP는 YYYYMMDDhhmmss 형식을 갖는 구성 타임스탬프입니다.

구성 프로그램이 제대로 작동하지 않습니다.

문제를 식별하려면 다음 디버그 모드의 사용으로 디버그 옵션을 활성화하여 구성 프로그램을 호출합니다.

-debug : 일반 디버그 정보를 생성하려면 이 옵션을 사용합니다.

-debugMessage : 오류 및 경고 로그를 생성하려면 이 옵션을 사용합니다.

-debugWarning : 경고 메시지와 오류 메시지 로그를 생성하려면 이 옵션을 생성합니다.

-debugError : 오류 메시지 로그를 생성하려면 이 옵션을 사용합니다. 기본적으로 이 옵션은 사용 가능합니다.

UWC 응용 프로그램 시작에 실패했으며 웹 컨테이너 로그가 예외를 표시합니다.

불완전하거나 잘못된 구성으로 인해 이 오류가 발생했을 수 있습니다.

해결 방법

구성 중 “chown” 명령이 실패했습니다.

해결 방법

구성 프로그램을 실행하여 구성 프로그램의 “웹 컨테이너 사용자 및 그룹” 패널에 올바른 웹 컨테이너 사용자 및 그룹 값을 입력합니다.

인증 후 Access Manager를 활성화하여 Communications Express에 액세스할 때 “이 작업 중에 오류가 발생했습니다.”라는 메시지가 표시됩니다.

해결 방법

uwc-deployed-path/WEB_INF/config/uwcauth.properties의 uwcauth.identity.binddn 및 uwcauth.identity.bindcred 등록 정보가 Access Manager SDK를 설치할 때 제공했던 amAdmin DN의 등록 정보로 설정되어 있는지 확인합니다. uwcauth.properties 파일에서 Access Manager 매개 변수 구성 절을 참조하십시오.

디렉토리 관리자 자격 증명이 Access Manager SSO의 uwcauth.identity.binddn 및 uwcauth.indentity.bindcred에 제공될 수 있지만, 디렉토리 관리자는 Communication Express가 제대로 작동하기 위해 의존하는 도메인별 관련 속성을 얻는 데 필요한 ACL을 갖고 있지 않습니다.

Access Manager SDK 통합에 대한 웹 컨테이너 구성 수정을 지원할 수 없습니다.

구성자는 Access Manager SDK 통합에 대한 웹 컨테이너 구성 수정을 지원하지 않습니다.

해결 방법

Access Manager의 웹 컨테이너 구성을 수정하려면 Access Manager와 함께 제공된 도구를 수동으로 호출합니다.

메시징 SSO가 SSL에서 지원되지 않습니다.

해결 방법

SSL에서 메시징 SSO를 지원하려면 다음 단계를 수행합니다.

ProcedureSSL을 사용하여 메시징 SSO를 활성화하는 방법

단계

  1. SSL 모드에서 Web Server를 구성합니다.

  2. Web Server의 SSL 포트에 대해 Communications Express를 구성합니다.

  3. uwcauth.ssl.enabled=true를 설정합니다.

  4. uwcauth.https.port를 Web Server의 SSL 포트로 설정합니다.

  5. SSL 모드에서 Messaging Server를 활성화합니다.

  6. uwcconfig.properties의 webmail.port를 Messaging Server의 SSL 포트로 설정합니다.

  7. Messaging Server의 비 SSL 포트에 messagingsso.ims.url을 제공합니다.

  8. CMS 루트 CA(Certificate Management Server 루트 인증 기관)를 Web Server와 Messaging Server 모두에 설치합니다.

  9. Web Server를 다시 시작합니다.

  10. local.webmail.sso.ims.verifyurl에 Messaging Server의 비 SSL 포트를 가리키는 값을 제공합니다.

  11. Messaging Server를 다시 시작합니다.

달력 액세스

Communications Express에서 달력에 액세스할 때 “이 작업 중에 오류가 발생했습니다.”라는 메시지가 표시됩니다.

이러한 오류는 하나 이상의 다음과 같은 이유로 인해 발생할 수 있습니다.

Communications Express에서 달력에 액세스할 때 “달력을 사용할 수 없습니다. 보기를 표시할 수 없습니다. 선택된 달력이 존재하지 않거나 해당 달력을 볼 수 있는 권한이 없습니다. 다른 달력을 선택하십시오.”라는 메시지가 표시됩니다.

호스트되지 않는 도메인 설치 시나리오에서 스키마 2에 대해 사용된 commcli를 사용하여 사용자를 지정하면 이 오류가 발생할 수 있습니다. commcli가 사용자 LDAP 항목의 icsCalendar 속성 값에 @domain을 잘못 추가했기 때문에 오류 메시지가 표시됩니다.

해결 방법

호스트되지 않는 도메인 환경에서 commcli를 사용하여 사용자를 지정하려면 commadmin 명령에서 -k legacy 옵션을 사용합니다. 호스트된 도메인 환경에서는 -k hosted 옵션을 사용합니다. -k 옵션이 지정되어 있지 않은 경우 호스트된 도메인 설치로 간주합니다.

예를 들면 다음과 같습니다.

예 6–1 Commcli 지정


./commadmin user create -D admin -w password -X siroe .varrius .com -n siroe.varrius.com -p 85 -d siroe.varrius.com -F test -L user2 -l user2 -W user2 -S mail,cal -k legacy
ok

또는

이미 지정된 사용자에 대한 항목을 제거할 수 없는 경우 \q@domain \q 부분을 icsCalendar, icsSubscribed 및 icsOwned 속성에서 수동으로 제거합니다.

Communications Express에서 도메인의 달력에 대해 검색, 초대 또는 가입하거나 가용성을 검사할 때 “도메인에서 달력을 검색할 수 없습니다.”, “도메인에서 달력을 초대할 수 없습니다.”, “도메인에서 달력에 가입할 수 없습니다.”, “도메인에서 달력의 가용성을 확인할 수 없습니다.” 등과 같은 메시지가 표시됩니다.

해결 방법

달력을 검색, 초대 또는 가입하거나 달력의 가용성을 확인하려면 도메인간 검색을 활성화해야 합니다. Calendar Server 6 2005Q1 관리 설명서의 13장, “도메인간 검색 활성화” 절을 참조하십시오.

기본 이벤트 상태 필터 문제

옵션 달력의 기본 이벤트 상태 필터 창에서는 일, 주 및 월 달력 보기에 표시할 이벤트를 지정합니다. 수락, 미정, 거절, 응답 없음 중 하나를 선택할 수 있습니다.

“수락” 옵션을 이벤트 상태로 선택한 경우 수락한 초대만 일, 주 또는 월 달력 보기에 표시됩니다. 그러나 직접 만든 모든 이벤트는 일, 주 또는 월 달력 보기에 항상 표시됩니다.

옵션 달력 창에서는 기본적으로 “수락”과 “미정”만 선택됩니다. 즉, 사용자는 거절했거나 아직 응답하지 않은 이벤트를 볼 수 없습니다.

해결 방법

일, 주, 월 및 연도 보기에서 모든 이벤트를 보려면 옵션 달력 창에서 수락, 미정, 거절 및 응답 없음 옵션을 모두 선택해야 합니다.

Communications Express에서 2MB보다 큰 파일을 업로드하면 "서버 오류"가 표시됩니다.

이 오류는 업로드된 파일 크기가 2MB보다 클 때 이벤트와 작업을 달력으로 가져오거나 연락처를 주소록으로 가져오는 동안 발생합니다.

기본적으로 Communications Express는 최대 2MB의 파일 데이터를 가져올 수 있습니다. 그러나 업로드 파일 크기 제한을 구성할 수 있습니다.

해결 방법

업로드 파일 크기 제한을 더 큰 값으로 구성합니다.

업로드 파일 크기 제한을 더 큰 값으로 구성하려면 web.xml에서 MultipartFormServletFilter 필터의 다음 init 매개 변수를 구성합니다.

예를 들어, 업로드 파일 크기를 10MB로 늘리려면 아래 설명된 구성 단계를 따릅니다.

Procedure업로드 파일 크기 늘리기

단계

  1. uwc-deployed-path/WEB-INF/web.xml에서 기존 web.xml을 백업합니다.

  2. uwc-deployed-path /WEB-INF/web.xml에서 web.xml 파일을 편집합니다.

  3. 코드 예 5-2에 굵게 표시된 것처럼 web.xml에서 MultipartFormServletFilter에 대한 구성을 입력합니다.


    <web-app\>
..
..
  <filter\>
    <filter-name\>MultipartFormServletFilter</filter-name\>
    <filter-class\>com.sun.uwc.calclient.MultipartFormServletFilter</filter-class\>
    ..
    ..
    <init-param\>
      <param-name\>fileSizeHardLimit</param-name\>
      <param-value\>10485760</param-value\>
      <description\>Ten mega bytes</description\>
    </init-param\>
    <init-param\>
      <param-name\>requestSizeLimit</param-name\>
      <param-value\>10485760</param-value\>
      <description\>Ten mega bytes</description\>
    </init-param\>
    <init-param\>
      <param-name\>fileSizeLimit</param-name\>
      <param-value\>10485760</param-value\>
      <description\>Ten mega bytes</description\>
    </init-param\>
    <init-param\>
      <param-name\>failureRedirectURL</param-name\>
      <param-value\>put your url here</param-value\>
      <description\>Request is redirected to this url when uploaded file size crosses fileSizeHardLimit value</description\>
    </init-param\>
    ..
    ..
  </filter\>
..
..
..
..
</web-app\>

  4. 웹 컨테이너를 다시 시작하여 변경 사항을 적용합니다.

Procedure주소록 액세스

주소록에 액세스하면 “서버 오류”가 발생합니다. Web Server 로그는 “org.apache.xml.utils.WrappedRuntimeException:The output format must have a ’{http://xml.apache.org/xslt}content-handler’ property!”라는 예외를 기록합니다.

JDK Web Server가 JDK 1.4.2 이전 버전을 가리키면 Web Server에서 이 예외가 발생합니다. Communications Express는 XML/XSL 구문 분석을 위해 xalan과 xerces의 최신 버전을 사용합니다. 이 오류는 다음과 같은 경우에 발생할 수 있습니다.

단계

  1. JES 설치 프로그램을 사용하여 배포하지 않은 Web Server 6.1을 사용 중입니다. JDK 1.4.1은 일반적으로 Web Server 6.1과 함께 번들로 제공됩니다.

  2. Java Enterprise System과 함께 제공되는 공유 xalan 및 xerces 구성 요소가 최신 버전이 아닙니다.

    해결 방법

    • JES 설치 프로그램에서 Web Server를 설치하지 않아 오류가 발생하는 경우 server.xml Web Server 구성 파일에서 java 태그의 java_home 속성으로 정의된 웹 컨테이너의 JDK 버전을 수동으로 업그레이드합니다.

      또는

      Java Enterprise System에서 Web Server를 다시 설치하고 설치 프로세스에서 JDK를 자동으로 업그레이드하게 합니다.

    주 –

    이 단계를 수행한 다음 다른 웹 응용 프로그램을 모두 재배포해야 합니다. 사전 조치로 server.xml 파일을 백업합니다.

    • 공유 xalan 및 xerces 구성 요소가 최신 버전이 아니라 오류가 발생하는 경우 xalan.jar 및 xerces.jar의 심볼록 링크를 uwc-deployed-path/WEB-INF/lib에서 제거합니다.

      예를 들면 다음과 같습니다.

      # cd /var/opt/SUNWuwc/WEB-INF/lib

      # rm xalan.jar xercesImpl.jar

      그런 다음 Web Server를 다시 시작합니다.

    Communications Express에서 주소록에 액세스할 때 “이 작업 중에 오류가 발생했습니다.”라는 메시지가 표시됩니다.

    PAB(개인 주소록)의 LDAP 구성이 올바르지 않으면 이 오류가 발생합니다. 주소록 탭에 액세스하면 개인 주소록 저장소 즉, PAB를 위해 구성된 LDAP에 Communications Express가 연결됩니다. 개인 주소록 저장소가 연결을 설정할 수 없는 경우 오류가 표시됩니다.

    해결 방법

  3. WEB-INF/config/ldappstore/db_config.properties에서 LDAP 구성을 확인합니다.

  4. 잘못된 구성 설정을 편집합니다.

  5. Communications Express가 배포된 Web Server를 다시 시작합니다.

    자세한 내용은 db_config.properties 파일에서 회사 디렉토리 매개 변수 구성 절을 참조하십시오.

    검색을 수행하면 회사 디렉토리가 인라인 오류를 표시합니다.

    회사 디렉토리의 LDAP 구성이 제대로 구성되어 있지 않은 경우 이 문제가 발생할 수 있습니다.

    해결 방법

    WEB-INF/config/corp-dir/db_config.properties에서 LDAP의 잘못된 구성을 확인한 다음 수정하여 Communications Express를 다시 시작합니다.

    자세한 내용은 db_config.properties 파일에서 회사 디렉토리 매개 변수 구성 절을 참조하십시오.

    회사 디렉토리의 연락처를 볼 때 보기 창에 오류가 표시됩니다.

    회사 디렉토리의 연락처 항목에 액세스하는 키가 “uid”가 아닌 경우 이 오류가 표시됩니다.

    uid는 Communications Express에서 설정하는 기본값입니다.

    해결 방법

    회사 디렉토리의 연락처에 액세스하려면 키 값이 uwc-deployed-path/WEB-INF/config의 db_config.properties와 xlate-inetorgperson.xml 구성 파일에서 원하는 값으로 설정되어야 합니다.

    파일에서 다음과 같이 변경합니다.

  6. uwc-deployed-path /WEB-INF/config/WEB-INF/config/corp-dir/db_config.properties에서 적절한 키 값을 설정합니다.

  7. uwc-deployed-path/WEB-INF/config/WEB-INF/config/corp-dir/xlate-inetorgperson.xml에서

    entry entryID="db:uid"에 “uid” 대신 적절한 키를 설정합니다.

  8. Communications Express가 배포된 Web Server를 다시 시작합니다.

    자세한 내용은 db_config.properties 파일에서 회사 디렉토리 매개 변수 구성 절을 참조하십시오.

    psRoot 값을 설정할 수 없습니다.

    사용자 기본 설정의 psRoot LDAP 속성이 Addressbook Server 수평 확장성을 위해 사용됩니다. 자세한 내용은 AddressBook Server의 수평 확장성 지원 절을 참조하십시오. 해당 배포에서 Addressbook Server 수평 확장성이 필요하지 않은 경우 이 오류를 무시할 수 있습니다.

    사용자가 Communications Express에 처음으로 로그인하면 psRoot가 자동으로 설정되지만 값이 자동으로 설정되지 않는 경우가 있습니다. 이 오류는 Java Enterprise System Directory Server가 설치되어 있지 않거나 Java Enterprise System Directory Server를 설치한 후 Java Enterprise System에 대해 comm_dssetup.pl을 실행하지 않은 경우에 일반적으로 발생합니다. 따라서, LDAP 스키마가 업데이트되지 않습니다.

    스키마가 업데이트되지 않기 때문에 수평적으로 확장 가능한 Addressbook Server 배포에 psRoot 속성이 필요하더라도 해당 속성을 수동으로 설정할 수 없습니다.

    해결 방법

    psRoot 속성의 설정을 사용하려면 psRoot 속성을 포함하도록 Directory Server를 업데이트합니다. 그렇게 하려면 다음 위치에 있는 ipUser 객체 클래스 정의에 psRoot 속성을 포함시킵니다.

    Directory ServerInstance/ config/schema/99user.ldif

    주 –

    현재 배포에서 Java Enterprise System Directory Server가 설치되어 있지 않거나 Java Enterprise System Directory Server를 설치한 후 Java Enterprise System에 대해 comm_dssetup.pl을 실행하지 않은 경우에만 psRoot 속성을 포함하도록 Directory Server를 업데이트해야 합니다.

메일 액세스

메일 탭을 클릭하면 로그인 페이지가 나타납니다.

Communications Express와 Messaging Server 사이의 구성이 제대로 처리되지 않으면 이 문제가 발생합니다. Messaging Server와 Communications Express를 매끄럽게 작동시키려면 Messaging Server나 Access Manager 단일 사인 온이 활성화되어야 합니다. Communications Express를 시작하기 전에 2 장, Communications Express 개요의 단일 사인 온 구성에서 설명한 지침을 따르십시오.

Communications Express에서 메일에 액세스할 때 “이 작업 중에 오류가 발생했습니다.”라는 메시지가 표시됩니다.

Communications Express의 메일 구성 요소가 배포되지 않았거나 활성화되지 않았지만 Communications Express에 로그인하는 사용자가 메일을 기본 응용 프로그램으로 설정한 경우 이 오류가 발생합니다.

해결 방법

관리자는 사용자 LDAP 항목의 sunUCDefaultApplication 속성 값을 “calendar” 또는 “addressbook”으로 변경해야 합니다.

사용자가 Communications Express를 로그아웃한 후에도 로그인 상태로 남아 있습니다.

Access Manager(이전 명칭은 Identity Server)와 Communications Express가 서로 다른 시스템에 설치되어 있을 때 Access Manager Remote SDK를 Communications Express가 설치된 시스템에 설치하면 이 문제가 발생합니다.

해결 방법

Communications Express가 설치된 시스템에서 AMConfig.properties 파일의 다음 구성 매개 변수를 지정합니다.

com.iplanet.am.notification.url=url-to-access-web-container-of-CommunicationsExpress /servlet/com.iplanet.services.comm.server.PLLRequestServlet

주 –

AMConfig.properties 파일은 IS-SDK-BASEDIR/SUNWam/lib에서 찾을 수 있습니다.

메일에서 주소록 기능에 액세스할 때 다음 문제가 발생할 수 있습니다.

Communications Express와 Messenger Express(MEM)가 브라우저의 Javascript를 사용하여 상호 작용하게 하려면 같은 호스트에 배포해야 합니다.

Access Manager를 사용하여 인증

유효한 사용자 아이디와 비밀번호를 입력한 후에도 인증할 수 없습니다.

다음과 같은 이유로 인증에 실패할 수 있습니다.