test

Sun Java System Communications Express 6.3 관리 설명서

문제 식별 및 문제 해결

Communications Express는 여러 독립형 제품을 사용하는 통합 웹 기반 통신 클라이언트를 제공합니다. 이로 인해 사용 중에 문제가 발생해 문제 해결이 필요할 수 있습니다.

문제의 원인을 확인하려면 문제를 제기하기 전에 먼저 다음 일반적인 문제 해결 방법을 사용하십시오.

ProcedureCommunications Express 문제를 해결하는 방법

  1. 제품을 구성할 때 2 장, Communications Express 설치 및 구성에 설명된 단계를 수행했는지 여부를 확인합니다.

  2. 자세한 오류 로그를 보고 오류 원인을 확인하려면 Communications Express 로그를 사용합니다.

    로깅 사용을 위한 단계는 로그 파일 절을 참조하십시오.

  3. 구성 요소 로그에서 보고된 오류 및 예외를 확인합니다.

    로그 파일은 Communications Express 설치, 구성 및 실행 중 발생하는 오류 목록을 유지 관리합니다.

일반적으로 발생하는 문제 해결

이 절에서는 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 : 오류 메시지 로그를 생성하려면 이 옵션을 사용합니다. 이 옵션은 기본적으로 활성화되어 있습니다.

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

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

해결 방법

구성 중 “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에 제공될 수 있지만, 디렉토리 관리자는 Communications Express가 제대로 작동하기 위해 사용하는 도메인별 속성을 얻는 데 필요한 ACL을 갖고 있지 않습니다.

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

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

해결 방법

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

달력 액세스

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

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

Communications Express에서 달력에 액세스할 때 "달력을 사용할 수 없습니다. 보기를 표시할 수 없습니다. 선택한 달력이 삭제되었거나, 존재하지 않거나, 선택한 달력을 볼 수 있는 권한이 없습니다.다른 달력을 선택하십시오”라는 메시지가 나타납니다.

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

해결 방법

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

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

예 5–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 
-Wuser2 -S mail,cal -k legacy
ok

또는

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

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

해결 방법

달력을 검색, 초대 또는 가입하거나 달력의 가용성을 확인하려면 도메인간 검색을 활성화해야 합니다. Sun Java System Calendar Server 6.3 Administration Guide에 있는 "도메인 간 검색 활성화" 절을 참조하십시오.

기본 이벤트 상태 필터 문제

옵션 달력의 기본 이벤트 상태 필터 창에서는 일, 주 및 월 달력 보기에 표시할 이벤트를 지정합니다. 다음 옵션을 사용할 수 있습니다. .

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

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

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

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

해결 방법

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

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

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

Procedure업로드 파일 크기를 늘리는 방법

  1. uwc-deployed-path/WEB-INF/에서 기존 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. 웹 컨테이너를 다시 시작하여 변경 사항을 적용합니다.

주소록 액세스

주소록에 액세스하면 “서버 오류”가 발생합니다. Web Server 로그는 “org.apache.xml.utils.WrappedRuntimeException:출력 형식에는 '{http://xml.apache.org/xslt}content-handler' property!"가 있어야 합니다.

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

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

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

해결 방법

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

    이 파일에서 잘못된 구성 설정을 편집합니다.

  2. 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에서 설정하는 기본값입니다.

해결 방법

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

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

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

    uwc-deployed-path/WEB-INF/config/WEB-INF/config/corp-dir/xlate-inetorgperson.xml의 entry entryID="db:uid"에서 uid에 적절한 키를 설정합니다.

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

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

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

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

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

스키마가 업데이트되지 않기 때문에 수평적으로 확장 가능한 Address Book 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 또는 Access Manager 단일 사인 온을 활성화해야 합니다. Communications Express를 시작하기 전에 1 장, Communications Express 개요의 단일 사인 온 구성에서 설명한 지침을 따르십시오.

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

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

해결 방법

관리자는 사용자의 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에서 찾을 수 있습니다.

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

JES4에서 Communications Suite Release 5로 업그레이드한 후에 메일 탭이 나타나지 않습니다.

Messaging Server 구성 유틸리티 매개 변수 local.webmail.sso.uwcenabled가 1로 설정되어 있는지 확인합니다. Messaging Server에 제공되는 configutil 도구에서 다음 명령을 실행하여 이 매개 변수 값을 확인해야 합니다.

<msg-svr-base>/sbin/configutil | grep local.webmail.sso.uwcenabled

Access Manager를 사용하여 인증

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

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