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에 사용하려면 다음을 수행하십시오.
- pureQuery JAR 파일 pdq.jar 및 pdqmgmt.jar을
DB2 Universal Driver Provider
CLASSPATH에 추가하십시오.
관리 콘솔에서 다음 단계를 수행하십시오.
- pureQuery Runtime JAR 파일의 파일 시스템 경로를 가리킬
WebSphere 환경 변수를 작성하십시오.
을
선택하십시오.
표 1. pureQuery Runtime에 대한 WebSphere
환경 변수WebSphere
환경 변수 |
값 |
PDQ_JAR_PATH |
C:\PureQueryRuntime |
- pureQuery Runtime JAR 파일의 위치를 DB2 Universal
Driver JDBC 프로바이더의 CLASSPATH에 추가하십시오.
를 선택하십시오. 일반 등록 정보
패널에서 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이 제대로 작동하지 않습니다.
- 변경을 수행한 후 WebSphere
설정을 저장하십시오.
- JAR 파일이 올바른 위치에 있는지 검증하십시오.
관리 콘솔에서
를
선택하십시오. 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
. . .
- 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
...
- 응용프로그램 서버(AS)를 다시 시작하십시오.
결과
WebSphere의
CLASSPATH 설정을 변경해서 DB2 Universal Driver
Provider를 사용하는 웹 응용프로그램에 pureQuery 클라이언트 최적화가 사용됩니다.