시나리오: WebSphere Application Server에 pureQuery Runtime 사용

pureQuery Runtime을 설치한 후, WebSphere® 애플리케이션에 pureQuery 클라이언트 최적화를 사용할 수 있도록 pureQuery JAR 파일의 위치로 WebSphere Application Server를 구성해야 합니다.

시작하기 전에

시나리오에서는 다음 구성을 가정합니다.
  • WebSphere Application Server가 설치되어 있으며 IBM® Data Server Driver for JDBC and SQLJ에 대한 JDBC Provider가 정의되어 있습니다.

    TestStaticProfileEAR이라는 단순 웹 애플리케이션이 WebSphere Application Server에서 실행 중입니다.

  • WebSphere Application Server에 액세스할 수 있는 위치에 pureQuery Runtime이 설치되어 있습니다.

    pureQuery Runtime 파일이 C:\PureQueryRuntime 디렉토리에 설치되어 있고 설치 프로세스가 환경 변수 PDQ_JAR_PATH를 작성했습니다.

    pureQuery Runtime 설치에 대한 정보는 Linux®, UNIX® 및 Windows®용 Optim™ pureQuery Runtime 설치를 참조하십시오.

이 태스크 정보

pureQuery Runtime JAR 파일을 WebSphere Application Server 클래스 로더에 사용 가능하게 하려면 pureQuery Runtime을 WebSphere 시스템에 설치합니다. WebSphere 환경에서는 pureQuery JAR 파일 pdq.jar 및 pdqmgmt.jar을 DB2® Universal Driver Provider CLASSPATH에 둡니다. 다음 단계는 WebSphere Application Server 버전 6.1의 관리 콘솔에서 수행됩니다.

이 태스크는 WebSphere Application Server에서 실행하는 하나의 WEB 모듈이 있는 단순 웹 애플리케이션에 대한 것입니다. EJB 모듈을 포함한 여러 모듈로 이루어진 애플리케이션에 대해서 유사한 단계 세트를 사용합니다.

프로시저

pureQuery Runtime을 WebSphere Application Server에 사용하려면 다음을 수행하십시오.

  1. pureQuery JAR 파일 pdq.jar 및 pdqmgmt.jar을 DB2 Universal Driver Provider CLASSPATH에 추가하십시오.

    관리 콘솔에서 다음 단계를 수행하십시오.

    1. pureQuery Runtime JAR 파일의 파일 시스템 경로를 가리킬 WebSphere 환경 변수를 작성하십시오.
      자원 > 자원 환경을 선택하십시오.
      표 1. pureQuery Runtime에 대한 WebSphere 환경 변수
      WebSphere 환경 변수
      PDQ_JAR_PATH C:\PureQueryRuntime
    2. pureQuery Runtime JAR 파일의 위치를 DB2 Universal Driver JDBC 프로바이더의 CLASSPATH에 추가하십시오.

      자원 > JDBC 프로바이더 > DB2 Universal Driver Provider를 선택하십시오. 일반 특성 패널에서 pureQuery Runtime JAR 파일에 대한 경로를 클래스 경로 분할 영역의 드라이버 JAR 파일 다음에 추가하십시오.

      클래스 경로에는 DB2 JDBC JAR 파일과 pureQuery Runtime JAR 파일이 모두 포함되어 있습니다.
      ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar
      ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar
      ${PDQ_JAR_PATH}/pdq.jar
      ${PDQ_JAR_PATH}/pdqmgmt.jar
      중요사항: pureQuery Runtime JAR 파일은 JDBC 프로바이더 경로와 동일한 CLASSPATH에 있어야 합니다. pureQuery Runtime은 JDBC 드라이버와 작동합니다. JDBC 드라이버 JAR 파일을 로드하는 클래스 로더는 pureQuery Runtime JAR 파일도 로드해야 합니다. pureQuery Runtime JAR에 대한 경로가 다른 CLASSPATH에 있으면 pureQuery Runtime이 제대로 작동하지 않습니다.
    3. 변경을 수행한 후 WebSphere 설정을 저장하십시오.
  2. JAR 파일이 올바른 위치에 있는지 검증하십시오.

    관리 콘솔에서 문제점 해결 > ClassLoader 표시기를 선택하십시오. pureQuery Runtime JAR 파일이 다음 목록과 유사한 파일 목록에 표시됩니다.

    . . .
    
    file:/C:/SQLLIB/java/db2jcc.jar
    file:C:/SQLLIB/java/db2jcc_license_cisuz.jar
    file:/C:/PureQueryRuntime/pdq.jar
    file:/C:/PureQueryRuntime/pdqmgmt.jar
    . . .
  3. pureQuery DataVersion 유틸리티를 실행하여 pureQuery Runtime이 WebSphere 환경에 제대로 설치되었는지 검증하십시오.

    명령 창에서 다음과 유사한 명령을 실행하십시오.

    java -cp "C:/PureQueryRuntime/pdq.jar; C:/PureQueryRuntime/pdqmgmt.jar; 
     C:/SQLLIB/java/db2jcc.jar; C:/SQLLIB/java/db2jcc_license_cisuz.jar"
     com.ibm.pdq.tools.DataVersion -configuration -url url -username <user> -password pass 

    명령의 -cp 옵션에서, C:/PureQueryRuntime 경로를 WebSphere 환경 변수 ${PDQ_JAR_PATH}에 정의된 경로로 대체하고 C:/SQLLIB/java 경로를 WebSphere 환경 변수 {UNIVERSAL_JDBC_DRIVER_PATH}에 정의된 경로로 대체하십시오. 적절한 값으로 설정된 쉘 환경 변수를 작성할 수도 있습니다. 이 변수는 pureQuery Runtime JAR 파일 및 IBM Data Server Driver for JDBC and SQLJ JAR 파일의 위치를 가리킵니다.

    다음 텍스트는 pureQuery DataVersion 유틸리티의 샘플 출력입니다.

    pureQuery Features: 
     pureQuery Base Function: Activated
     pureQuery runtime: Activated
     Extended Insight Monitor Server: Activated
    Global pureQuery properties in effect
    Note: These  be overridden by connection-specific settings:
    pdq.allowDynamicSQL=true
    pdq.captureMode=OFF
    pdq.captureStatementBatchSQL=ON
    pdq.capturedOnly=false
    pdq.cmx.controllerDiscoveryInterval=-1
    pdq.cmx.controllerDiscoveryPort=50000
    pdq.cmx.controllerURL=
    pdq.cmx.dataSourceLookupInterval=20
    pdq.cmx.multicastTimeToLive=10
    pdq.enableDynamicSQLReplacement=false
    pdq.executionMode=DYNAMIC
    pdq.maxNonParmSQL=-1
    pdq.maxResultRows=
    pdq.maxStackTracesCaptured=5
    pdq.outputPureQueryXml=
    pdq.packagePrefixExclusions=
    pdq.pureQueryXml=
    pdq.queryTimeoutInSeconds=
    pdq.sqlLiteralSubstitution=NOT_SET
    pdq.stackTraceDepth=10
    pdq.traceFile=pdq.log
    pdq.traceLevel=OFF 
    ...
  4. 애플리케이션 서버(AS)를 다시 시작하십시오.

결과

WebSphere의 CLASSPATH 설정을 변경해서 DB2 Universal Driver Provider를 사용하는 웹 애플리케이션에 pureQuery 클라이언트 최적화가 사용됩니다.


피드백