Crystal Report JRC(Java Reporting Component) 런타임 구성

ClearQuest Reporting에 Crystal Reports용 ClearQuest 보고서 서버를 사용하려면 WebSphere Application Server에 지원되는 버전의 Crystal Reports JRC(Java Reporting Component)를 설치 및 구성하십시오.

시작하기 전에

JRC(Java Reporting Component) 런타임을 이미 설치한 경우 이 구성 단계를 수행하기 전에 기존 버전을 제거하십시오. Crystal Reports JRC 런타임 제거을 참조하십시오.

이 태스크 정보

ClearQuest에서 지원되는 버전의 Crystal Reports JRC(Java Reporting Component) 런타임 버전 및 다운로드 위치에 대한 정보는 기술 노트 1216371을 참조하십시오.

이 지시사항은 다음 변수를 참조합니다.

%CLEARQUEST_HOME%\cqweb\cqwebprofile
Windows에서 이 변수는 ClearQuest 웹 애플리케이션이 배치된 WebSphere 프로파일 디렉토리의 기본 경로를 나타냅니다. CLEARQUEST_HOME은 ClearQuest가 설치된 디렉토리입니다.
$CLEARQUEST_HOME/cqweb/cqwebprofile/
Linux 및 UNIX에서 이 변수는 ClearQuest 웹 애플리케이션이 배치된 WebSphere 프로파일 디렉토리의 기본 경로를 나타냅니다. CLEARQUEST_HOME은 ClearQuest가 설치된 디렉토리입니다.
참고: 다음 지시사항에서 JRC 런타임의 설치 디렉토리는 이 기본 위치에 있는 새 WebSphere 프로파일에 설치되는 ClearQuest를 기반으로 합니다.
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
ClearQuest가 기존 WebSphere 애플리케이션 프로파일에 설치된 경우 이 경로가 다를 수 있으며 JRC 파일을 복사하기 전에 지시사항의 경로를 업데이트해야 합니다. 검사할 또 다른 공통 위치는 다음 디렉토리입니다.
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war.
ClearQuest가 Solaris 플랫폼에서 호스팅되는 경우 기본 WebSphere Application Server 셀 디렉토리는 <srv>Node01Cell입니다. Windows, Unix 및 Linux 플랫폼에서 기본값은 dfltCell입니다.

프로시저

  1. ClearQuest Reporting 요구사항을 충족하는 Crystal Reports JRC(Java Reporting Component) 아카이브 파일을 다운로드하십시오. 기술 노트 1216371을 참조하십시오.
  2. Crystal Reports JRC를 웹 애플리케이션에 복사하십시오.
    Windows에서
    일괄처리 파일을 실행하여 JRC를 웹 애플리케이션에 복사하십시오.

    Crystal Reports JRC 버전 11.8.x를 실행 중인 경우 configureJRC.bat를 실행하십시오. JRC 버전 12.2.x의 경우 configureJRC12.bat를 실행하십시오.

    1. 명령 프롬프트에서 ClearQuest 일괄처리 파일이 설치된 디렉토리로 이동하십시오.
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Crystal Reports JRC 런타임 아카이브 파일을 이 디렉토리에 복사하십시오.
    3. 배치 중인 런타임 버전에 따라 다음 명령 중 하나를 실행하십시오.
      configureJRC JRC_runtime_file.zip
      configureJRC12 JRC_runtime_file.zip
    Unix에서
    Crystal Reports JRC, 버전 11.8.x를 사용 중인 경우 쉘 스크립트 configureJRC.sh를 실행하십시오. Crystal Reports JRC, 버전 12.2.x를 사용 중인 경우 configureJRC12.sh 스크립트를 실행하십시오.
    1. UNIX 콘솔 창을 열고 ClearQuest 쉘 스크립트가 설치된 디렉토리로 이동하십시오.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. Crystal Reports JRC 런타임 아카이브 파일을 이 디렉토리로 복사하십시오.
    3. 실행할 스크립트 버전에 대한 권한을 설정하십시오.
      chmod u+x ./configureJRC.shchmod u+x ./configureJRC12.sh
    4. 복사 중인 JRC 버전에 해당하는 명령을 실행하십시오.
      ./configureJRC.sh JRC_runtime_file.zip
      ./configureJRC12.sh JRC_runtime_file.zip
  3. 변경사항을 적용하려면 IBM WebSphere Application Server를 중지한 후 다시 시작하십시오.
    참고: ClearQuest가 기존 WebSphere 프로파일에 설치된 경우 이 지시사항의 디렉토리가 다를 수 있습니다.
    Windows의 경우:
    1. 시작>제어판>관리 도구>서비스를 클릭하십시오.
    2. 서비스 분할창에서 IBM WebSphere Application Server v7.0 - %CLEARQUEST_HOME%\cqweb\cqwebprofile을 마우스 오른쪽 단추로 클릭하십시오.
    3. 중지를 클릭하십시오.
    4. 서비스가 중지된 후 서버 이름을 마우스 오른쪽 단추로 클릭한 후 시작을 클릭하여 서버를 다시 시작하십시오.
    UNIX 시스템 및 Linux의 경우:
    1. UNIX 콘솔 창에서 ClearQuest 서버 컴포넌트가 설치된 WebSphere 프로파일의 bin 디렉토리로 이동하십시오.
      참고: ClearQuest가 기존 WebSphere 프로파일에 설치된 경우 이 지시사항의 디렉토리가 다를 수 있습니다.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/bin
    2. 기본 프로파일을 시작 및 중지하려면 다음 명령을 실행하십시오.
      ./stopServer.sh server1
      ./startServer.sh server1
  4. Crystal Reports용 ClearQuest 보고서 서버가 제대로 구성되었는지 확인하려면 브라우저 창을 열고 다음 URL로 이동하십시오. http://localhost:<port>/cqwebreport/CRInvoker 여기서 <port>는 애플리케이션을 배치할 프로파일에 정의된 포트입니다. 기본 ClearQuest 프로파일은 12080 포트를 사용합니다. 기본 WebSphere Application Server 프로파일은 9080 포트를 사용합니다.
    서버가 올바르게 구성되면 다음 메시지가 표시됩니다.
    보고서 문서가 만기되었습니다. 
  5. 다음 상황에서는 추가 구성 단계가 필요합니다.
    • ClearQuest 스키마에서 데이터베이스 필드 이름이 변경되었습니다.
    • ClearQuest 표시 필드 이름이 데이터베이스 필드 이름과 일치하지 않습니다.
    • ClearQuest 표시 필드 이름이 30자를 초과합니다.
    기술 노트 1419660을 참조하십시오.

피드백