Windows 상에 포시에스(FORCS)의 OZ Report Server를 설치한 후에 필요한 OZ Server 환경 설정을 정리한다.

• 
  
  기본 정보
  
  
  
  
  • 
    
    오즈 서버를 호스트하는 서버 OS는 Windows Server 2003 이다.
    
    
  • 
    
    오즈홈(OZ Home) 디렉토리는 C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0이다.
    
    
  • 
    
    오즈 레포트 리파지토리 루트(Repository Root) 디렉토리는 C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\repository_files이다.
    
    
  • 
    
    오즈 서버는 Daemon Type으로 서비스되며 공개 포트는 8003번이다.
    
  
  
• 
  
  작업 내역
  
  
  
  
  • 
    
    오즈 레포트가 Database, Sybase ASE(Adaptive Server Enterprise) v15 버전과 연동할 수 있도록 JDBC Connection Pool 환경을 설정한다.
    
    
  • 
    
    오즈의 기본으로 사용하는 JRE(Java Runtime Environment) 1.3.1 버전을 1.5 버전으로 업그레이드 한다.
    
    
  • 
    
    오즈 리포트 뷰어(OZ Report Viewer) ActiveX 컨트롤을 클라이언트에 배포하기 위하여 IIS에 가상디렉토리를 등록한다.
    
    
  • 
    
    디자인한 오즈 레포트를 쉽게 배포할 수 있도록 FTP를 설정한다.

Sybase ASE 15 버전에 최적화된 드라이버인 jConnect™ for JDBC™ Version 6.05를 사용하기 위해 다음 디렉토리에 드라이버 파일(jconn3.jar)을 복사한다.

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\UniversalDriver\jconn3.jar

db.properties를 다음과 같이 편집하여 필요한 Connection Pool을 생성하도록다. db.properties 파일은 다음 경로에 있다.

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\conf\db.properties

db.properties

###

###    DataBase Connection Pool Properties

###    Last Modified : Tue Dec 04 15:33:18 KST 2007

###

#

#  PKS Connection Pool

#

pks_cp.vendor=USER

#    for Custom JDBC Driver

pks_cp.driver=com.sybase.jdbc3.jdbc.SybDriver

pks_cp.url=jdbc:sybase:Tds:127.0.0.1:3000/pks?CHARSET=eucksc

pks_cp.props=user=kyungseo;password=kyungseo;CHARSET=eucksc

pks_cp.serverAddress=

pks_cp.portNo=0

pks_cp.serverName=

pks_cp.dbName=

pks_cp.user=kyungseo

pks_cp.password=kyungseo

pks_cp.maxconns=20

pks_cp.initconns=1

pks_cp.timeout=5

pks_cp.initSqls=

pks_cp.closeSqls=

pks_cp.doConnectionCheck=false

pks_cp.testQueryString=

pks_cp.sessionQuery=
###    End.

pks_cp 이외의 커넥션풀이 필요하다면 pks_cp 항목을 복사하여 append하면 된다.
참고로 jconn3.jar를 사용할 때 RDBMS별 db.properties 설정방법 과는 차이가 있음에 주의한다. eucksc를 파라미터로 넘겨줘야 한글이 잘 된다.

OZ의 커넥션풀(Connection Pool)에서 사용하게될 JDBC 드라이버인 JConnect 6 버전은 1.4 이상의 자바 버전을 요구하는데, OZ 4.0에 포함된 기본 자바 런타임은 1.3.1 버전이다. 여기서는 J2SE 5.0 Update 12 (1.5.0_12) 버전을 설치하도록 한다. 설치 기본 디렉토리는 다음과 같다.

C:\Program Files\Java\jdk1.5.0_12

C:\Program Files\Java\jre1.5.0_12

이와 관련하여 다음 두 파일의 내용을 수정하여야한다.

• 
  
  C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\bin\ozcntrl.bat
  
  
• 
  
  C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\bin\OZServerInstallService.bat

파일을 편집하여 다음과 같이 JAVA_HOME을 변경하도록 한다.

set JAVA_HOME=”C:\Program Files\Java\jre1.5.0_12″

또한 다음과 같이 Sybase JDBC 드라이버(jconn3.jar)를 등록하여야한다.

rem ———————————–

rem   JDBC Driver for Syabse

rem ———————————–

set OZLIB=%OZLIB%;%OZJLIBALL%\jconn2.jar

set OZLIB=%OZLIB%;%OZJLIBALL%\jconn3.jar

jconn2.jar는 OZ에 기본적으로 포함되어 있는 jConnect 5.5버전이다.

파일을 편집하여 JRE PATH를 다음과 같이 변경하도록 한다.

rem —————————————————–

rem        JRE PATH

rem

rem ex) set JRE_PATH=C:\Program Files\Forcs\OZ XStudio\jre1.4.2\bin\client\jvm.dll

rem ————————————————–

set JRE_PATH=C:\Program Files\Java\jre1.5.0_12\bin\client\jvm.dll

또한 다음과 같이 Sybase JDBC 드라이버(jconn3.jar)를 등록하여야한다.

rem —————————————————–

rem   JDBC Driver for Syabse

rem —————————————————–

set OZLIB=%OZLIB%;%OZJLIBALL%\jconn2.jar

set OZLIB=%OZLIB%;%OZJLIBALL%\jconn3.jar

jconn2.jar는 OZ에 기본적으로 포함되어 있는 jConnect 5.5버전이다.

OZ 리포트 뷰어를 IIS의 어플리케이션으로 등록하여 다운로드 할 수 있도록 한다. 그러기 위해서 다음의 절차를 따른다.

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Report Viewer 4.0\ztransferx.js

var ZTransferXObjectElement = document.createElement(
    ‘<OBJECT width = “0″ height = “0″ ID=”ZTransferX” 
        CLASSID=”CLSID:C7C7225A-9476-47AC-B0B0-FF3B79D55E67″ 
        codebase=”http://xxx.xxx.xxx.xxx/ozrviewer/ZTransferX.cab#version=2,1,1,6″>
        </OBJECT>’);

var ZTransferXParamElement1 = document.createElement(
    ‘<PARAM NAME=”download.Server” VALUE=”http://xxx.xxx.xxx.xxx/ozrviewer/”>’);

var ZTransferXParamElement2 = document.createElement(
    ‘<PARAM NAME=”download.Port” VALUE=”80″>’);

var ZTransferXParamElement3 = document.createElement(
    ‘<PARAM NAME=”download.Instruction” VALUE=”ozrviewer.idf”>’);

var ZTransferXParamElement4 = document.createElement(
    ‘<PARAM NAME=”install.Base” VALUE=”<PROGRAMS>/Forcs”>’);

var ZTransferXParamElement5 = document.createElement(
    ‘<PARAM NAME=”install.Namespace” VALUE=”ozrviewer”>’);

ZTransferXObjectElement.appendChild(ZTransferXParamElement1);

ZTransferXObjectElement.appendChild(ZTransferXParamElement2);

ZTransferXObjectElement.appendChild(ZTransferXParamElement3);

ZTransferXObjectElement.appendChild(ZTransferXParamElement4);

ZTransferXObjectElement.appendChild(ZTransferXParamElement5);
OZEmbedControlLocation.appendChild(ZTransferXObjectElement);

OZ Report viewer 4.0 디렉토리를 가상디렉토리로 등록하기위해 속성창을 연다.

웹 공유 탭의 이 폴더를 공유함을 선택한다.

ozrviewer, OZViewer 등과 같이 원하는 별칭을 입력하고 확인 버튼을 클릭한다.

확인 버튼을 클릭한다.

인터넷 정보 서비스(IIS) 관리 콘솔을 열고 등록한 가상디렉토리의 속성창을 연다.

디렉토리 보안 탭의 편집 버튼을 클릭한다.

익명 액세스 가능을 체크하고 확인 버튼을 클릭한다.

HTTP 헤더 탭을 클릭하고 MIME 형식 버튼을 클릭한다.

새형식 버튼을 눌러 다음 항목들을 등록하도록 한다.

• 
  
  확장명 : zip, 컨텐트 형식 : application/zip
  
  
• 
  
  확장명 : cab, 컨텐트 형식 : application/cab
  
  
• 
  
  확장명 : message, 컨텐트 형식 : text/message
  
  
• 
  
  확장명 : idf, 컨텐트 형식 : text/idf

적용 및 확인 버튼을 눌러 속성을 반영한 후, 사이트를 재시작한다. 그리고 다음 URL로 접속하여 OZ 리포트 뷰어가 제대로 설치되는지 확인한다.

• 
  
  뷰어 설치 (http://129.100.180.112/ozrviewer/install.html)

참고로 위 설정에서 OZ Viewer 파일들에 대해서 MIME TYPE을 설정이 되어 있지 않을 경우, 뷰어 설치 시 다음과 같은 “idf file is missing!” 에러를 만나게 된다.

리포트 배포를 용이하게 하기 위해서 IIS에 아래와 같은 설정으로 FTP 사이트를 등록한다. 아래의 홈 디렉토리는 오즈의 리파지토리 루트(Repository Root) 디렉토리와 동일하다. 그림은 생략한다.

• 
  
  IP: xxx.xxx.xxx.xxx
  
  
• 
  
  Port: 21
  
  
• 
  
  익명 연결 허용
  
  
• 
  
  홈 디렉터리: C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\repository_files

서비스를 재등록하고 서버를 다시 시작하기 위해 아래의 절차를 따른다.



CMD 창을 열고 다음과 같이 명령을 실행하여 OZ 서버를 중지한다.

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\bin\ozstop.bat


CMD 창에서 다음과 같이 명령을 실행한다.

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\bin>OZServerUninstallService.bat

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\bin>OZServiceSV.exe //DS//OZServer

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\bin>OZServerInstallService.bat


CMD 창에서 다음과 같이 명령을 실행하여 OZ 서버를 시작한다.

C:\Program Files\FORCS\OZ XStudio 4.0\OZ Server 4.0\bin\ozstart.bat