* 개요

오즈 서버에서 DB에 연결하려면 다음 작업을 해야 합니다.

  1. DB 연결정보 설정

  2. JDBC 드라이버 파일 업로드

  3. Java 버전 확인

* 상세 설명

오즈 서버에서 DB연결하는 방법입니다.

오즈 서버가 WAS (Tomcat, Jeus, WebLogic 등) 에 설치된 경우입니다.

다음 경로에 db.properties 파일을 생성합니다.

예)

Windows : C:\Tomcat8.5\webapps\oz80\WEB-INF\conf\db.properties

Linux : /usr/tomcat/oz80/WEB-INF/conf/db.properties

(db.properties 예시)

# oracle example TestOracle.vendor=oracle TestOracle.serverAddress=123.11.22.33 TestOracle.portNo=1521 TestOracle.sid=ORCL TestOracle.user=scott TestOracle.password=tiger TestOracle.maxconns=20 TestOracle.initconns=5 TestOracle.timeout=5 TestOracle.doConnectionCheck=true TestOracle.testQueryString=select sysdate from dual   # mssql example TestMssql.vendor=mssql2008 TestMssql.serverAddress=123.11.22.33 TestMssql.portNo=1433 TestMssql.dbName=northwind TestMssql.user=sa TestMssql.password=sapw TestMssql.maxconns=20 TestMssql.initconns=5 TestMssql.timeout=5 TestMssql.doConnectionCheck=true TestMssql.testQueryString=select 1   # tibero example TestTibero.vendor=user TestTibero.driver=com.tmax.tibero.jdbc.TbDriver TestTibero.url=jdbc:tibero:thin:@123.11.22.33:포트:tibero TestTibero.props=user=유저;password=암호 TestTibero.user=유저 TestTibero.maxconns=20 TestTibero.initconns=5 TestTibero.timeout=5 TestTibero.doConnectionCheck=true TestTibero.testQueryString=select 1

* oz80/WEB-INF/conf/sample/ 폴더에 db.properties 예제 파일이 있습니다.

* vendor는 dbconfig.xml의 <VENDOR NAME=".."> 에 설정된 값을 지정해야 합니다.

명시되지 않은 경우 vendor=user로 하고 driver, url을 직접 지정할 수 있습니다.

* WAS의 datasource를 이용하여 연결하려면 다음 기술문서를 참고하시기 바랍니다.

http://oztn.net/kb/article/kbserver/119131426198800

2. JDBC 드라이버 파일 업로드

JDBC 드라이버는 oz80/WEB-INF/UniversalDriver 폴더에 일부 제공됩니다.

db연결이 안되면 DB버전에 맞는 JDBC 드라이버를 사용하셔야 합니다.

JDBC 드라이버는 DBMS 벤더사에서 제공합니다.

DB	JDBC 드라이버
Oracle 8	classes12.zip  (기본제공)
Oracle 11.2	ojdbc5.jar 또는 ojdbc6.jar
Oracle 12.1	ojdbc6.jar 또는 ojdbc7.jar
Oracle 12.2	ojdbc8.jar
Oracle 19.7	ojdbc8.jar
Mssql 2000	msbase.jar, mssqlserver.jar, msutil.jar  (기본제공)
Mssql 2008	sqljdbc.jar  (기본제공)

WEB-INF/lib/ 폴더에 jdbc 드라이버 파일을 업로드합니다.

WEB-INF/lib/ 의 .jar 확장자는 WAS 구동시 자동으로 로딩되어 별도로 클래스패스를 잡아주지 않아도 됩니다.

예)

- oracle 19 : oz80/WEB-INF/lib/ojdbc8.jar

- mssql2000 : oz80/WEB-INF/lib/msbase.jar, mssqlserver.jar, msutil.jar 

- mssql2008 : oz80/WEB-INF/lib/sqljdbc.jar

-> 단, 같은 DB벤더의 다른 버전 드라이버는 삭제하셔야 합니다.

    예를 들어, oracle19c에 연결하기 위해 lib에 ojdbc8.jar를 넣는 경우 classes12.zip이나 다른 버전 odjbc~.jar를 삭제해야 합니다.

    mssql2008에 연결하기 위해 lib에 sqljdbc.jar를 넣는 경우 하위 버전의 msbase.jar, mssqlserver.jar, msutil.jar  을 삭제해야 합니다.

3. Java 버전 확인

JDBC 드라이버에 맞는 java 버전을 설정해야 합니다.

오라클의 경우 ojdbc 뒤의 숫자는 지원되는 java 버전입니다. ojdbc6.jar는 java1.6, ojdbc8.jar는 java1.8 이상에서 동작됩니다.

오즈 서버는 WAS(Tomcat, Jeus, WebLogic 등) 위에서 실행되기 때문에

WAS를 구동된 java가 JDBC 드라이버가 지원되는 java 버전(또는 그 이상)이어야 합니다.

4. DB 연결

위와 같이 작업이 되면 오즈 서버를 재시작 (WAS 재구동) 합니다.

보고서를 실행하여 데이터가 정상적으로 조회되는지 확인합니다.

oz80/WEB-INF/logs/server.log 로그 파일에 오즈 서버 구동시 데이터베이스 커넥션 풀이 생성되는 과정이 기록됩니다.

(정상인 경우)

2022-05-19 10:47:37,815 [http-nio-80-exec-1] INFO  ConnectionPool - Start initialize... 2022-05-19 10:47:37,820 [http-nio-80-exec-1] INFO  ConnectionPool-TestMssql - Loading properties is done. 2022-05-19 10:47:37,831 [http-nio-80-exec-1] DEBUG ConnectionPool-TestMssql - loading driver: 'com.microsoft.sqlserver.jdbc.SQLServerDriver' 2022-05-19 10:47:37,832 [http-nio-80-exec-1] DEBUG ConnectionPool-TestMssql - newConnectionByURL.... url: jdbc:sqlserver://123.11.22.33:1433;DatabaseName=northwind 2022-05-19 10:47:37,835 [http-nio-80-exec-1] DEBUG ConnectionPool-TestMssql - com.microsoft.sqlserver.jdbc.SQLServerDriver is acceptsURL :true 2022-05-19 10:47:38,329 [http-nio-80-exec-1] INFO  ConnectionPool-TestMssql - Opened a new connection by URL. 2022-05-19 10:47:38,331 [http-nio-80-exec-1] DEBUG ConnectionPool-TestMssql - Total connections: 1 Available: 1 Checked-out: 0 2022-05-19 10:47:38,332 [http-nio-80-exec-1] DEBUG ConnectionPool-TestMssql - newConnectionByURL.... url: jdbc:sqlserver://123.11.22.33:1433;DatabaseName=northwind 2022-05-19 10:47:38,334 [http-nio-80-exec-1] DEBUG ConnectionPool-TestMssql - com.microsoft.sqlserver.jdbc.SQLServerDriver is acceptsURL :true 2022-05-19 10:47:38,348 [http-nio-80-exec-1] INFO  ConnectionPool-TestMssql - Opened a new connection by URL. 2022-05-19 10:47:38,349 [http-nio-80-exec-1] DEBUG ConnectionPool-TestMssql - Total connections: 2 Available: 2 Checked-out: 0 2022-05-19 10:47:59,709 [http-nio-80-exec-1] INFO  ConnectionPool - End initialize. ... 2022-05-19 10:48:03,803 [http-nio-80-exec-1] DEBUG server - OS Name            : Windows 10 2022-05-19 10:48:03,805 [http-nio-80-exec-1] DEBUG server - OS Version         : 10.0 2022-05-19 10:48:03,806 [http-nio-80-exec-1] DEBUG server - Java Vendor        : Oracle Corporation 2022-05-19 10:48:03,806 [http-nio-80-exec-1] DEBUG server - Java Version       : 1.8.0_111 ... 2022-05-19 10:48:03,809 [http-nio-80-exec-1] INFO  server -    OZ Server                : 8.0.0101.20220330 20:00.00 2022-05-19 10:48:03,815 [http-nio-80-exec-1] INFO  server -    License expiration date  : 2022-06-15 ... 2022-05-19 10:48:03,817 [http-nio-80-exec-1] INFO  server - OZ Servlet is ready up.

(에러난 경우)

2022-05-19 10:47:37,815 [http-nio-80-exec-1] INFO  ConnectionPool - Start initialize... 2022-04-18 17:06:27,262 [http-nio-80-exec-2] INFO  ConnectionPool-TestOracle - Loading properties is done. 2022-04-18 17:06:27,299 [http-nio-80-exec-2] DEBUG ConnectionPool-TestOracle - loading driver: 'oracle.jdbc.driver.OracleDriver' 2022-04-18 17:06:27,300 [http-nio-80-exec-2] DEBUG ConnectionPool-TestOracle - newConnectionByURL.... url: jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS...=(SID=ORCL))) 2022-04-18 17:06:27,302 [http-nio-80-exec-2] DEBUG ConnectionPool-TestOracle - oracle.jdbc.driver.OracleDriver is acceptsURL :true 2022-04-18 17:06:48,464 [http-nio-80-exec-2] ERROR ConnectionPool-TestOracle - Fail to connect. error 2022-05-19 10:47:59,709 [http-nio-80-exec-1] INFO  ConnectionPool - End initialize. ... 2022-05-19 10:48:03,803 [http-nio-80-exec-1] DEBUG server - OS Name            : Windows 10 2022-05-19 10:48:03,805 [http-nio-80-exec-1] DEBUG server - OS Version         : 10.0 2022-05-19 10:48:03,806 [http-nio-80-exec-1] DEBUG server - Java Vendor        : Oracle Corporation 2022-05-19 10:48:03,806 [http-nio-80-exec-1] DEBUG server - Java Version       : 1.8.0_111 ... 2022-05-19 10:48:03,809 [http-nio-80-exec-1] INFO  server -    OZ Server                : 8.0.0101.20220330 20:00.00 2022-05-19 10:48:03,815 [http-nio-80-exec-1] INFO  server -    License expiration date  : 2022-06-15 ... 2022-05-19 10:48:03,817 [http-nio-80-exec-1] INFO  server - OZ Servlet is ready up.

* 참고 사항

오라클 JDBC 드라이버 다운로드 :

https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html

* 첨부자료 설명

> '오즈 - DB 연결 방법.docx' : 본문 내용을 doc로 작성한 문서입니다.