목 차 Ⅰ. 시작하기전에 4 본매뉴얼의목적.. 5 본매뉴얼구성..... 5 매뉴얼로드맵...... 6 Ⅱ. 오즈엔터프라이즈서버소개... 7 오즈엔터프라이즈서버개요...... 8 오즈엔터프라이즈서버특징... 8 오즈엔터프라이즈서버아키텍처.... 10 Ⅲ. 오즈엔터프라이즈서버설치및실행..... 11 시스템요구사항... 12 오즈엔터프라이즈서버설치.. 12 서버세팅..... 13 오즈엔터프라이즈서버데몬구동...... 24 Windows에서오즈엔터프라이즈서버서비스등록하기.. 25 서블릿타입으로오즈엔터프라이즈서버구동...... 27 제거........ 27 Ⅳ. 오즈엔터프라이즈서버설정...... 28 ozserver.properties.... 29 log.properties.......... 30 db.properties..... 38 rpmtmngr.properties...... 42 srmngr.properties.... 43 cachemngr.properties...... 44 FORCS Co., LTD 1
monitor.properties..... 45 xml.properties...... 46 Ⅴ. 서블릿엔진과의연동.. 47 개요..... 48 WAS에대한일반적인서블릿연동절차..... 49 웹로직과의연동.... 55 WebSphere와의연동.. 60 SilverStream과의연동.... 76 Apache Jserv와의연동..... 82 Tomcat과의연동.... 84 Resin과의연동..... 85 Inprise Application Server와의연동.... 87 Ⅵ. 오즈스케줄러소개.. 92 오즈스케줄러서버개요... 93 오즈스케줄러아키텍처.... 95 Ⅶ. 오즈스케줄러설치및실행.... 96 시스템요구사항... 97 오즈스케줄러설치.... 97 오즈스케줄러서버의파일구조....... 97 서버세팅..... 98 서버구동...... 105 Ⅷ. 오즈엔터프라이즈매니저 106 설치및환경설정... 107 운영.. 109 2 FORCS Co., LTD
Ⅸ. 오즈컨트롤명령어... 139 오즈엔터프라이즈서버 Shell Command.... 140 오즈스케줄러 Shell Command...... 156 Ⅹ. 서버 API. 166 Class Cache.... 168 Class Connection.... 175 Class Log....... 182 Class Program.... 185 Class Publisher..... 192 Class Report.... 197 Class Schedule...... 203 Class Scheduler...... 210 Class Service...... 230 Class Viewer....... 239 FORCS Co., LTD 3
Ⅰ. 시작하기전에 본매뉴얼의목적 본매뉴얼구성 매뉴얼로드맵 4 FORCS Co., LTD
본매뉴얼의목적 본매뉴얼은오즈엔터프라이즈서버의모든구성요소에대한정보를제공합니다. 오 즈엔터프라이즈서버설정및이용에관한기술적인정보를상세히설명합니다. 본매뉴얼구성 본매뉴얼의구성과각장의내용은다음과같습니다. 오즈엔터프라이즈서버 오즈엔터프라이즈서버에대한개요, 특성, 기능및아키텍처를설명합니다. 오즈엔터프라이즈서버설치및실행 오즈엔터프라이즈서버의설치와실행과정을설명합니다. 오즈엔터프라이즈서버설정 각서버환경설정파일에대한상세한설명과예를보여줍니다. 서블릿엔진과의연동 오즈엔터프라이즈서버와서블릿엔진과의연동에관해설명합니다. 오즈스케줄러소개 오즈스케줄러에대해전반적으로설명합니다. 오즈스케줄러설치및실행 오즈스케줄러의설치와실행에관해설명합니다. 오즈엔터프라이즈매니저 오즈엔터프라이즈매니저의환경설정과운영에대해설명합니다. FORCS Co., LTD 5
오즈컨트롤명령어오즈엔터프라이즈서버, 오즈스케줄러의모든기능을윈도우의명령어프롬프트창또는유닉스의 Shell Command 창에서컨트롤할수있는방법에대해설명합니다. 서버 API 오즈서버및스케줄러와관련된정보조회, 실시간환경설정변경기능등을사용자애플리케이션에서직접제어할수있는서버 API(Application Program Interface) 에대해설명합니다. 매뉴얼로드맵 보고서개발자와웹애플리케이션개발자, 시스템관리자가알아야할내용을전달하 기위해다음과같은매뉴얼을제공합니다. 구분 Report Developer Web Application Developer Server Administrator Getting Started User Reference User Guide Viewer Guide Server Administrator Guide 구성내용오즈소개와간단한보고서작성을통해오즈의개념을설명합니다. 오즈디자이너의각컴포넌트를자세히설명합니다. 보고서작성방법과디자이너사용방법, 작성된보고서를웹에배포하는방법을설명합니다. 웹에배포한보고서가사용자애플리케이션과연동할수있도록다양한옵션을설명합니다. 서버관리자가오즈서버소프트웨어를설치ᆞ 관리ᆞ운영할수있도록오즈서버의특성을설명합니다. 6 FORCS Co., LTD
Ⅱ. 오즈엔터프라이즈서버소개 오즈엔터프라이즈서버개요 오즈엔터프라이즈서버특징 오즈엔터프라이즈서버아키텍처 FORCS Co., LTD 7
오즈엔터프라이즈서버개요 오즈엔터프라이즈서버는보고서폼관리및클라이언트의요청에따른보고서데이터셋생성및폼과데이터셋의전송을수행하는고성능다중스레드서버엔진입니다. 오즈엔터프라이즈서버특징 특징 우수한이식성과확장성 순수 JAVA/XML 기술로개발, 어떤 DB와도연동가능 JVM (Java Virtual Machine) 이탑재된모든운영체제환경지원 다양한서드파티애플리케이션 (ERP, Web Application Server등 ) 과통합환경제공 고성능서버아키텍처 서버와클라이언트간분산처리를통해다중사용자환경에서최적의성능보장 효과적인서버운영관리 - 엔터프라이즈매니저를통한 one-point 통합관리 - 실시간모니터링및서버설정 - 분산원격테스트및디버깅 고성능리포팅엔진 DB Pooling, 멀티스레드, 스레드재사용, 보고서별캐시설정, 디스크 / 메모리혼용캐시기능등다양한성능향상기법을도입하여다수사용자의동시접속환경에서도최적의성능을보장합니다. 유연한데이터처리별도의 CGI 코딩없이데이터베이스와연동할수있으며 Non-DB 데이터연동을위해 UDS(User Data Source) 를제공합니다. 8 FORCS Co., LTD
Note UDS(User Data Source) 오즈는 JDBC 및 ODBC를통한데이터베이스외에도 Non-DB 데이터소스연동을위해 UDS(User Data Source) 인터페이스를제공합니다. UDS는일반텍스트데이터는물론 XML, EJB, Legacy Data 등사용자애플리케이션에서넘겨주는어떠한형태의데이터도오즈의데이터로활용할수있어기업의모든데이터소스를지원하면서일관성있게보고서를작성할수있게합니다. 데이터보안및인증보고서의데이터를담고있는데이터모듈파일의위 / 변조방지기능이있어, 공문서나인증서등의서비스에유용하게적용될수있습니다. 또한사용자및그룹별로계층적보안을적용하고인가된사용자만이접근가능하도록통제할수있어보안유지에편리합니다. FORCS Co., LTD 9
오즈엔터프라이즈서버아키텍처 UDS UDS를이용한 Non-database Source의이용 JDBC/ODBC JDBC/ODBC를이용하여데이터베이스에연결 Report Manager 사용자또는사용자그룹보고서관리수행 Log Manager 오즈서버의실행결과를로깅하고, NT Event와 Unix Syslog로전송 Schedule Manager 오즈스케줄러서버가생성한 Result Data에대한관리수행 Cache Manager 자주요청하는 Result Dataset의 Caching 처리 Monitor 서버프로세스의운영상황을모니터링하여관련통계현황표작성 10 FORCS Co., LTD
Ⅲ. 오즈엔터프라이즈서버설치및실행 시스템요구사항오즈엔터프라이즈서버설치서버세팅오즈엔터프라이즈서버데몬구동 Windows에서오즈엔터프라이즈서버데몬서비스등록서블릿타입으로오즈엔터프라이즈서버구동제거 FORCS Co., LTD 11
시스템요구사항 오즈엔터프라이즈서버운영을위한시스템요구사항 플랫폼 Web Server DBMS JRE(Java Runtime Environment) 1.1.X 이상을지원하는모든운영체제 - Windows NT/2000, Linux, HP-UX, Solaris, AIX, Unixware, Mainframe 등 Microsoft IIS(Internet Information Server), Web Server Apache, NCSE, CERN, Netscape Enterprise Server 등모든웹서버 Web Application WebLogic, WebSphere, Oracle ias(internet Server Application Server) 등모든 WAS Oracle, Informix, Sybase, MS-SQL Server, DBII 등 ODBC/JDBC를지원하는모든상용 DBMS 오즈엔터프라이즈서버설치 Windows 환경에서는오즈제품 CD [Server] 폴더의 setup.exe를실행하여자동설치할수있습니다. UNIX 환경에서는설치를위해자동설치쉘스크립트 (ozinstall.sh) 를제공합니다. 12 FORCS Co., LTD
서버세팅 License 파일설치오즈서버라이센스는 ozlicense.xml 파일형태로발급되며이파일을오즈엔터프라이즈서버의 [License] 디렉토리에복사함으로써설치됩니다. 각 License 파일에는 License 유효기간, 서버 IP 주소, 운영체계종류가들어있습니다. 오즈엔터프라이즈서버를운영하던중 IP 주소가변경되는경우 License 파일을재발급받아야합니다. ozcntrl.bat / ozcntrl.sh ozcntrl.bat/ozcntrl.sh에서는 JRE 설치디렉토리및서버를운영하기위한각종클래스라이브러리를설정합니다. 기본적으로 Windows 환경의경우자체 JVM 을내장하여이를이용하고있으며, UNIX 환경의경우 ozinstall.sh를이용하여서버를설치하면서 JVM의 Path를지정하게됩니다. 'MAX_MEMORY/MIN_MEMORY' 는자바의옵션으로 JVM이사용할수있는최대 / 최소메모리를설정하며, 그외기타자바옵션은 JAVA_OPTION에서설정할수있습니다. 해당운영체계의 JAVA_OPTION에서자세한옵션사항을참조하여서버성능에도움이되는옵션사용을권장합니다. ozcntrl.bat 파일 @echo off rem ----------------------------------------------------- rem rem OZ Control(OZA SHELL) rem rem rem This script file written and tested under Windows 2000 rem rem User should set following variables: rem rem JAVA_HOME - Determines the version of Java used to start rem OZ Server. This variable must point to the rem root directory of a JDK or JRE installation. rem for an up-to-date list of supported JVMs your platform. rem USER_CLASSPATH - Use this variable to append jar files or directories to rem the OZLIB. FORCS Co., LTD 13
rem MAX_MEMORY - Maximum memory used by OZ Server. (The unit is mega-byte.) rem MIN_MEMORY - Minimum memory used by OZ Server. (The unit is megabyte.) rem rem ----------------------------------------------------- rem ----------------------------------- rem Set user-defined variables rem ----------------------------------- set JAVA_HOME=..\jre set USER_CLASSPATH= set MAX_MEMORY=128 set MIN_MEMORY=128 set JAVA_OPTION= set OZSERVER_HOME=.. set OZLIB=%OZSERVER_HOME%\conf\ set OZLIB=%OZLIB%;%OZSERVER_HOME%\bin\ozserver25.jar set OZLIB=%OZLIB%;%OZSERVER_HOME%\bin\ozcommon25.jar set OZLIB=%OZLIB%;%OZSERVER_HOME%\bin\ozcntrl25.jar rem ----------------------------------- rem for User Data Set classes rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\uds\ set OZLIB=%OZLIB%;%OZSERVER_HOME%\uds\sample\ rem ----------------------------------- rem Library for Logging rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\log4j.jar rem ----------------------------------- rem Library for XML rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\jaxp.jar set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\parser.jar set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\crimson.jar set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\xerces.jar 14 FORCS Co., LTD
rem ----------------------------------- rem JDBC Driver for Oracle rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\classes12.zip rem If your version of oracle is 7 and rem its character set is KOREAN(KSC5601), rem then delete 'rem' of next line rem set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\ijava.jar rem ----------------------------------- rem JDBC Driver for Informix rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\ifxjdbc.jar rem ----------------------------------- rem JDBC Driver for Syabse rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\jconn2.jar rem ----------------------------------- rem JDBC Driver for MSSQL rem ----------------------------------- rem set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\Opta2000.jar set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\jkjdbc.jar rem ----------------------------------- rem JDBC Driver for IBM DB2 rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\db2java.zip rem ----------------------------------- rem JDBC Driver for Uni-SQL rem ----------------------------------- set OZLIB=%OZLIB%;%OZSERVER_HOME%\lib\unisql10.jar rem ----------------------------------- rem USER_CLASSPATH rem ----------------------------------- set OZLIB=%OZLIB%;%USER_CLASSPATH% FORCS Co., LTD 15
if not "%1" == "-start" goto notstart set JAVA_OPTION= %JAVA_OPTION% -Xms%MIN_MEMORY%m - Xmx%MAX_MEMORY%m :notstart %JAVA_HOME%\bin\java %JAVA_OPTION% -cp %OZLIB% oz.admin.shell.server.ozashell %1 %2 %3 %4 %5 %6 %7 %8 %9 %JAVA_HOME%\bin\java -cp %OZLIB% oz.admin.shell.server.ozashell %1 %2 %3 %4 %5 %6 %7 %8 %9 ozcntrl.sh 파일 #!/bin/sh #----------------------------------------------------- # # OZ Control. # # This script file written and tested under HP-UX # # User should set following variables: # # JAVA_HOME - Determines the version of Java used to start # OZ Server. This variable must point to the # root directory of a JDK or JRE installation. # for an up-to-date list of supported JVMs your platform. # USER_CLASSPATH - Use this variable to append jar files or directories to # the OZLIB. # MAX_MEMORY - Maximum memory used by OZ Server. (The unit is megabyte.) # MIN_MEMORY - Minimum memory used by OZ Server. (The unit is mega-byte.) # JAVA_OPTIONS - On some platforms, certain java command-line options are # recommended when running OZ Server. # #----------------------------------------------------- # ----------------------------------- # Set user-defined variables # ----------------------------------- JAVA_HOME= USER_CLASSPATH= MAX_MEMORY=128 MIN_MEMORY=128 JAVA_OPTION= 16 FORCS Co., LTD
OZSERVER_HOME=.. OZLIB=.:$OZSERVER_HOME/conf OZLIB=$OZLIB:$OZSERVER_HOME/bin/ozserver25.jar OZLIB=$OZLIB:$OZSERVER_HOME/bin/ozcommon25.jar OZLIB=$OZLIB:$OZSERVER_HOME/bin/ozcntrl25.jar # ----------------------------------- # for User Data Set classes # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/uds # ----------------------------------- # Library for Logging # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/lib/log4j.jar # ----------------------------------- # Library for XML # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/lib/jaxp.jar OZLIB=$OZLIB:$OZSERVER_HOME/lib/parser.jar OZLIB=$OZLIB:$OZSERVER_HOME/lib/crimson.jar OZLIB=$OZLIB:$OZSERVER_HOME/lib/xerces.jar # ----------------------------------- # JDBC Driver for Oracle # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/lib/classes12.zip # If your version of oracle is 7 and # its character set is KOREAN(KSC5601), # then delete '#' of next line # OZLIB=$OZLIB:$OZSERVER_HOME/lib/ijava.jar # ----------------------------------- # JDBC Driver for Informix # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/lib/ifxjdbc.jar # ----------------------------------- # JDBC Driver for Sybase # ----------------------------------- FORCS Co., LTD 17
OZLIB=$OZLIB:$OZSERVER_HOME/lib/jconn2.jar # ----------------------------------- # JDBC Driver for MSSQL # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/lib/jkjdbc.jar # ----------------------------------- # JDBC Driver for IBM DB2 # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/lib/db2java.zip # ----------------------------------- # JDBC Driver for Uni-SQL # ----------------------------------- OZLIB=$OZLIB:$OZSERVER_HOME/lib/unisql10.jar # ----------------------------------- # USER CLASSPAATH # ----------------------------------- if [ "$USER_CLASSPATH"!= "" ]; then OZLIB=$OZLIB:$USER_CLASSPATH fi if [ "$1"!= "-start" ]; then JAVA_OPTION= else # JAVA_OPTION="$JAVA_OPTION -Xms$MIN_MEMORYm - Xmx$MAX_MEMORYm" JAVA_OPTION="$JAVA_OPTION -Xms$MIN_MEMORY"m JAVA_OPTION="$JAVA_OPTION -Xmx$MAX_MEMORY"m fi $JAVA_HOME/bin/java $JAVA_OPTION -cp $OZLIB oz.admin.shell.server.ozashell $1 $2 $3 $4 $5 $6 $7 $8 $9 ozcntrl에서는오즈서버를구동하기위한가장기본적인설정만하고있으며그외서버가사용할데이터베이스등기타자세한설정에대해서는본메뉴얼의 "Ⅳ. 오즈엔터프라이즈서버설정 " 을참조하시기바랍니다. 18 FORCS Co., LTD
ozcntrl.bat/ozcntrl.sh는오즈서버의구동 종료이외에도여러가지오즈의컨트롤을가능하게하는명령어입니다. ozcntrl.bat/ozcntrl.sh에대한자세한내용은본매뉴얼의 Ⅸ. 오즈컨트롤명령어 를참조하시기바랍니다. 오즈엔터프라이즈서버디렉토리오즈엔터프라이즈서버설치후다음과같은형태의디렉토리와파일들이시스템에설치됩니다. UNIX와 Windows 계열에따른큰차이는없으나데몬과서블릿타입에따라서는다른폴더구조를가집니다. Windows용의경우 JRE라는디렉토리에자체 JRE를탑재하고있습니다. 오즈엔터프라이즈서버데몬타입파일구조 [ 디렉토리 ] [ 디렉토리 ]/ 파일설명 [bin] chk_version.bat chk_version.sh ozcntrl.bat ozcntrl.sh ozcntrl25.jar ozcommon25.jar ozserver25.jar OZService.exe ozstart.bat ozstart.`1sh ozstop.bat ozstop.sh 윈도우 (.bat) / 유닉스 (.sh) 용엔터프라이즈오즈서버버전체크유틸리티오즈엔터프라이즈서버 Control 파일 Command line에서오즈엔터프라이즈서버를관리하기위한클래스라이브러리오즈공용클래스라이브러리서버메인클래스라이브러리 Windows에서오즈엔터프라이즈서버를서비스로등록해주는유틸리티오즈엔터프라이즈서버를구동시키는파일오즈엔터프라이즈서버를종료시키는파일 [cache] 캐시된데이터가저장되는장소 [cif] userinfo.cif groupinfo.cif usersdm.cif user와 pwd를암호화하여저장한파일 user와 user가엑세스할수있는그룹사용자정의스케줄된 DM 파일과그 DM 파일의리포트가속한그룹 FORCS Co., LTD 19
[ 디렉토리 ] [ 디렉토리 ]/ 파일설명 cachemngr.properties db.properties log.properties monitor.properties ozserver.properties rptmngr.properties srmngr.properties xml.properties Cache 관련설정파일 DB 연결설정파일 Log 설정파일 Monitor 설정파일오즈서버기본설정파일 Report Manager 설정파일 Scheduler manager 설정파일 XML 파서설정 properties 파일 [conf] db.properties.db2 db.properties.informix [SAMPLE] db.properties.mssql db.properties.odbc db.properties.oracle db.properties.sybase db.properties.unisql db.properties.user db.properties.weblogic db.properties.websphere db.properties 에대한각 DBMS 별샘플파일 [lib] classes12.zip crimson.jar db2java.jar Ifxjdbc.jar ijava.jar jaxp.jar jconn2.jar Oracle jdbc 라이브러리파일 XML 크림손파서라이브러리파일 DB2 연결을위한 JDBC 라이브러리 Infomix 연결을위한 JDBC 라이브러리 Oracle 7.x 버전대사용시나타나는한글문제처리를위한 JDBC XML 파싱라이브러리 Sybase 연결을위한 JDBC 라이브러리 20 FORCS Co., LTD
[ 디렉토리 ] [ 디렉토리 ]/ 파일설명 [lib] - 계속 jkjdbc.jar jt400.jar log4j.jar nteventlogappender.dll parser.jar unisqljdbc10.jar xerces.jar MS-SQL 연결을위한 JDBC 라이브러리 DB2 AS400용 JDBC 드라이버 Log 사용에대한라이브러리파일 Windows NT에 Event 로그로남기기위한 dll 파일 XML 파서라이브러리파일 Unisql 연결을위한 JDBC 라이브러리 XML Xerces 파서라이브러리파일 [license] ozlicense.xml 오즈엔터프라이즈서버라이센스파일 [logs] [reports] monitor.log server.log 리포트저장디렉토리 Monitor 로그파일 서버로그파일 [scheduled] [uds] [userscheduled Result] Scheduler에의해생성된 sdm 파일이저장되는곳 - 오즈서버에의해사용됨 UDS 이용의경우 UDS 관련라이브러리가위치하는폴더 Scheduler에의해생성된 sdm 파일이저장됨 - 사용자설정에의해저장되며, 사용자가직접사용 오즈엔터프라이즈서버서블릿타입파일구조 [ 디렉토리 ] [ 디렉토리 ]/ 파일설명 [bin] chk_version.bat chk_version.sh ozcntrl.bat ozcntrl.sh ozcntrl25.jar 버전체크유틸리티오즈엔터프라이즈서버 Control 파일 Command line에서오즈엔터프라이즈서버를관리하기위한클래스라이브러리 [Cache] Cash 된데이터가저장되는장소 userinfo.cif user 와 pwd 를암호화하여저장한파일 [Cif] groupinfo.cif usersdm.cif user 와 user 가엑세스할수있는그룹 사용자정의스케줄된 sdm 파일과그 sdm 파일의리포트가속한그룹 FORCS Co., LTD 21
[ 디렉토리 ] [ 디렉토리 ]/ 파일설명 cachemngr.properties db.properties log.properties monitor.properties rptmngr.properties srmngr.properties xml.properties Cache 관련 properties 파일 DB 설정 properties 파일 Log 설정 properties 파일 Monitor 설정 properties 파일 Report Manager 설정파일 Scheduled Result manager 설정파일 XML 파서설정 properties 파일 [Conf] db.properties.db2 db.properties.informix [SAMPLE] db.properties.mssql db.properties.odbc db.properties.oracle db.properties.sybase db.properties.unisql db.properties.user db.properties.weblogic db.properties.websphere db.properties.[dbms- NAME] 각 DBMS 별세팅파일 [license] ozlicense.xml 오즈엔터프라이즈서버라이센스파일 [logs] [Reports] monitor.log server.log 리포트저장디렉토리 모니터로그파일 서버로그파일 [Scheduled] Scheduler 에의해생성된 sdm 파일이저장되는곳 [SilverStream] servlet.java servlet.xml SilverStream (Web Application Server 연 동을할경우이용할파일들 ) [Uds] [UserSchedul ed Result] UDS 관련라이브러리및샘플파일 사용자설정에의해 Scheduling 시생성된 sdm 파일이저장되는곳 (.sdm) 22 FORCS Co., LTD
[ 디렉토리 ] [ 디렉토리 ]/ 파일설명 web.xml nteventlogappender.dll 오즈서블릿에 URL을맵핑하는파일오즈로그를 NT의 Event Log로등록시키기위한 dll 파일 오즈엔터프라이즈서버설치시 helloworld.class 사용할수있는테스트용자바클 classes 래스 ozserver.properties classes111.zip 오즈엔터프라이즈서버메인 properties 파일 Oracle JDBC 드라이버파일 (JDK 1.1.x 용 ) Oracle jdbc 라이브러리파일 classes12.zip (jdk 1.2.x 이상용 ) [WEB-INF] crimson.jar db2java.zip ifxjdbc.jar (ozcntrl.bar/ozcntrl.sh 참고 ) XML 크림손파서라이브러리파일 (xml.properties 파일참고 ) DB2 연결을위한 JDBC 라이브러리 (ozcntrl.bat/ozcntrl.sh 참고 ) Infomix 연결을위한 JDBC 라이브러리 (ozcntrl.bat/sh 참고 ) lib Oracle 7 버전대사용을위한 ijave 라이브러리파일 ijava.jar Oracel 7 버전대에서 chracter set 이 KSC5601 일때이용 (ozcntrl.bar/ozcntrl.sh 참고 ) jaxp.jar jconn2.jar jkjdbc.jar jt400.jar XML 파싱라이브러리 (xml.properties 참고 ) Sybase 연결을위한 JDBC 라이브러리 (ozcntrl.bat/sh 참고 ) MS-SQL 연결을위한 JDBC 라이브러리 (ozcntrl.bat/sh 참고 ) DB2 AS400용 JDBC 드라이버 FORCS Co., LTD 23
[ 디렉토리 ] [ 디렉토리 ]/ 파일설명 log4j.jar Log 사용에대한라이브러리파일 (ozcntrl.bar/ozcntrl.sh 참고 ) nteventlogappender.dll 오즈로그를 NT의 Event Log로등록시키기위한 dll 파일 ozcommon25.jar 오즈공용클래스라이브러리 ozserver25.jar Server 메인클래스라이브러리 [WEB-INF] - 계속 lib - 계속 parser.jar readme.txt XML 파서라이브러리파일 (xml.properties 파일참고 ) Lib 폴더에있는라이브러리들의정보 servlet.jar unisqljdbc10.jar Unisql 연결을위한 JDBC 라이브러리 (ozcntrl.bat/sh 참고 ) xerces.jar XML Xerces 파서라이브러리파일 (xml.properties 파일참고 ) xml4j.jar XML 파서라이브러리 오즈엔터프라이즈서버데몬구동 ( 독립구동서버 ) 오즈엔터프라이즈서버구동 Windows 환경에서오즈서버를구동시키기위해서는설치시생성된오즈서버아이콘을더블클릭합니다. 이아이콘은오즈엔터프라이즈서버의 [bin] 디렉토리아래에위치한 ozstart.bat를작동시킵니다. 오즈엔터프라이즈서버를종료하기위해서는 ozstop.bat을실행합니다. UNIX 시스템의경우는오즈엔터프라이즈서버의 [bin] 디렉토리아래에있는 ozstart.sh 파일을이용하여서버를구동하고서버를종료하기위해서는 ozstop.sh을실행합니다. 24 FORCS Co., LTD
ozstart.bat / ozstart.sh ozstart.bat 파일과 ozstart.sh 파일은각 Windows와 UNIX에서오즈엔터프라이즈서버를구동시키는파일입니다. 이파일들은 ozcntrl.bat와 ozcntrl.sh를실행시키는역할을합니다. ozstart.bat 파일 @echo off rem ----------------------------------------------------- rem rem OZ Server Start-up File rem rem This batch file written and tested under Windows 2000 rem check your path indicate <JAVA_HOME>\bin rem rem ----------------------------------------------------- ozcntrl.bat -start %1 ozstart.sh 파일 # ----------------------------------------------------- # # OZ Server Start-up File # # This batch file written and tested under UNIX(HP-UX) System # check your path indicate <JAVA_HOME>/bin # # -----------------------------------------------------./ozcntrl.sh -start Windows 에서오즈엔터프라이즈서버서비스등록하기 사용자는오즈엔터프라이즈서버를시스템에서자동으로구동 정지시키기위해 Windows 서비스로등록해야합니다. Windows 서비스등록은다음과같습니다. FORCS Co., LTD 25
명령어프롬프트에서 { 오즈의홈디렉토리 }\bin\ozservice.exe /install 을실행합니다. 다음으로 [ 제어판 ] - [ 관리도구 ] - [ 서비스 ] 로들어가면오즈서버가등록된것을확인할수있습니다. OZServer를선택하여서비스시작아이콘을클릭하면수동으로서버를구동할수있습니다. 서버구동방식을수동에서자동으로바꾸려면 [ 시작유형 ] 에서바꿔주면됩니다. 26 FORCS Co., LTD
오즈엔터프라이즈서버를중지시키기위해서는 OZServer 서비스를선택한후 [ 서비스중지 ] 아이콘을클릭합니다. 오즈서버서비스는서버를실행시킬때같은디렉토리안에있는 ozstart.bat 를실행시킵니다. 실행중인서버를중지시킬때는디렉토리안에있는 ozstop.bat를실행시킵니다. ozstart.bat와 ozstop.bat는 OZService.exe와같은디렉토리안에있어야하며배치파일의이름을변경하면안됩니다. NT 서비스로등록하면로그는콘솔로는볼수없습니다. (log 파일로가능 ) 로그를콘솔로남기려면 NT 서비스로등록하지말고시작프로그램에등록시켜줍니다. 서블릿타입으로오즈엔터프라이즈서버구동 (Running with Third Party s Servlet-enabled Web Server) 오즈엔터프라이즈서버의서블릿타입의경우서블릿엔진또는 WAS에먼저등록되어있어야합니다. 오즈엔터프라이즈서버를 WAS에등록하는방법은본매뉴얼 Ⅴ. 서블릿엔진과의연동 WAS에대한일반적인서블릿연동절차 를참조하시기바랍니다. 등록이완료된후오즈서버는 WAS 또는서블릿엔진에의해자동실행됩니다. 제거 Windows 환경에서는인스톨프로그램과함께배포되는 uninstall 프로그램을이용하여오즈서버를제거할수있습니다. UNIX 환경에서는데몬타입과서블릿타입모두해당오즈엔터프라이즈서버디렉토리를삭제함으로써안전하게제거할수있습니다. FORCS Co., LTD 27
Ⅳ. 오즈엔터프라이즈서버설정 ozserver.properties log.properties db.properties rpmtmngr.properties srmngr.properties cachemngr.properties monitor.properties xml.properties 28 FORCS Co., LTD
오즈는다양한환경파일을통해오즈엔터프라이즈서버의운영환경을설정및제어합니다. 이장에서는각환경파일에대한위치와역할, 설정방법을소개합니다. ozserver.properties 위치 [Daemon] {OZ_HOME}\bin\ozserver.properties [Servlet] {OZ_HOME}\WEB-INF\classes\ozserver.properties 역할오즈서버와관련된통신포트설정및서버가사용하는각종환경파일에대한경로를지정합니다. 이파일의내용이변경되면반드시서버를재구동해야합니다. ozserver.properties #------------------------------------------- # Main configuration of ozserver/ozservlet #------------------------------------------- server.portnumber=8002 #server.portnumber 는데몬에서만존재. path.oz.server.home=.. path.license.file=%oz_home%/license/ozlicense.xml path.xml.properties.file=%oz_home%/conf/xml.properties path.log.properties.file=%oz_home%/conf/log.properties path.authorization.policy.file=%oz_home%/conf/user.policy path.connpool.properties.file=%oz_home%/conf/db.properties path.report.properties.file=%oz_home%/conf/rptmngr.properties path.schedule.properties.file=%oz_home%/conf/srmngr.properties path.cache.properties.file=%oz_home%/conf/cachemngr.properties path.monitor.properties.file=%oz_home%/conf/monitor.properties FORCS Co., LTD 29
%OZ_HOME% 은오즈서버홈디렉토리를가르키는내부변수로서 ozserver.properties 파일내의 path.oz.server.home 항목에지정한경로를가지고있습니다. ozserver.properties 파일의항목과값에대한설명 ozserver.properties 구성내역 변수 path.oz.server.home server.portnumber path.license.file path.xml.properties.file path.log.properties.file path.authorization.policy.file path.connpool.properties.file path.report.properties.file path.sedule.properties.file path.cache.prpperties.file path.monitor.properties.file 설명오즈서버홈디렉토리경로지정서버가사용할 TCP/IP 포트값설정기본값 : 8002 ( 데몬타입인경우만사용 ) 라이센스파일경로지정 xml.properties 파일경로지정 log.properties 파일경로지정 user.policy 파일경로지정 db.properties 파일경로지정 rpmtmngr.properties 파일경로지정 srmngr.properties 파일경로지정 cachemngr.properties 파일경로지정 monitor.properties 파일경로지정 log.properties 위치 [Daemon/Servlet] {OZ_HOME}\conf\log.properties 역할 오즈서버관련 log의기록형태와방법들을설정하는파일입니다. 지원되는 log의형태에는 Console( 화면 ), Rolling File, NT Event, UNIX Syslog가있습니다. 30 FORCS Co., LTD
Log.properties #------------------------------------------- # configuraion of OZ logging system #------------------------------------------- # # Set Prioritylog level # # DEBUG, INFO, ERROR Priority=DEBUG # # appender CONSOLE # Console 로로그를뿌립니다. # CONSOLE.Type=Stdout CONSOLE.Layout=%r [%t] %p %c{1} %x - %m%n CONSOLE.Async=false # # appender ROLLING_FILE # File 로로그를뿌립니다. # 로그파일의최대크기는 MaxFileSize 로지정합니다. # 로그파일의크기가그이상을넘어가면이파일을백업한후 # 새로운로그파일로로그를뿌립니다. # 최대백업파일의갯수는 MaxBackupIndex 로지정합니다. # # Layout : 로그메시지포맷 # Append : 기존의로그파일에덧붙여서로그를남길지여부를결정 # ImmediateFlush : 로그가발생했을때그즉시로그를파일에기록할지여부를결정 # false이면어느정도까지메모리버퍼에쌓아둔후한꺼번에파일에기록하므로속도향상을기대할수있습니다. # ROLLING_FILE.Type=RollingFile ROLLING_FILE.Layout=%d{ISO8601} [%t] %-5p %c{1} %x - %m%n ROLLING_FILE.File=%OZ_HOME%/logs/server.log ROLLING_FILE.Append=true ROLLING_FILE.MaxBackupIndex=5 ROLLING_FILE.MaxFileSize=1MB FORCS Co., LTD 31
ROLLING_FILE.ImmediateFlush=true # # appender NT Event # NT 이벤트로로그를뿌린다. # #NT_EVENT.Type=NTEvent #NT_EVENT.Layout=%r %p %c{1} - %m%n #NT_EVENT.Threshold=ERROR # # appender syslog # Unix syslog 로로그를뿌립니다. # #SYSLOG.Type=Syslog #SYSLOG.Layout=[OZ] %r %p %c{1} - %m #SYSLOG.Threshold=ERROR #SYSLOG.SyslogHost=211.116.251.7 #SYSLOG.Facility=USER #SYSLOG.FacilityPrinting=false 32 FORCS Co., LTD
log.properties 파일의항목과값에대한설명 log.properties 파일은 Set Prioritylog Level, Appender CONSOLE, Appender ROLLING_FILE, Appender NT Event, 그리고 Appender syslog 등다섯가지설정영역으로구성되어있습니다. log.properties 구성내역설명 log 의 Level 을설정 [ERROR] log level 중낮은단계이며, 실제로 Error 상황에서만 Error Message를 log에기록합니다. Set Prioritylog level 부분 priority CONSOLE.Type [INFO] [ERROR] level에서의 log 출력과함께서버의트랜잭션정보를 log 에기록합니다. [DEBUG] [INFO] 및 [ERROR] level에서의 log 출력과함께기타전반적인서버동작정보를 log에기록합니다. Appender 형태를정의합니다. 콘솔에로그를출력할경우에해당하며, stdout 을설정합니다. 로깅시표시되는형식을정의합니 Appender CONSOLE CONSOLE.Layout CONSOLE.Async 다. 정의문자에따라다르게설정되며각정의문자는표 [Log Layout] 을참조하십시오. 콘솔에로그를출력할때버퍼링여부를설정합니다. True일경우버퍼링을하지않고바로콘솔에출력하고, False일경우버퍼링을하여성능을향상시킬수있습니다. FORCS Co., LTD 33
설명 ROLLING_FILE ROLLING_FILE. Type ROLLING_FILE. Layout ROLLING_FILE. File ROLLING_FILE. Append ROLLING_FILE. MaxBackupIndex Rolling File에로그를기록할경우에해당하며 RollingFile 을설정합니다. Log 파일의표시형식을정의합니다. 표 [Log Layout] 을참조하십시오. Log 파일의경로와이름을지정합니다. Log가생길때마다로그파일에추가할지를설정합니다. True 값이면추가합니다. Backup 될로그파일의최대개수를정의합니다. 최대파일의개수가초과될시에는가장오래된파일이삭 Appender - 계속 제되고새로운파일이생 깁니다. ROLLING_FILE. MaxFilesize ROLLING_FILE. ImmediateFlush 로그파일의사이즈를지정합니다. 버퍼에있는로그를바로기록할것인지를설정합니다. Log를 Windows NT의 Event로등록하고자할경우 Lib 폴더밑에있는 NTEventLog Appender.dll 파일을 WINNT\SYSTEM32 디렉토리로이동하여야합니다. NT Event NT_Event.Type NT_Event.Layout Log를 NT Event로보낼경우에해당하며 NTEvent 를설정합니다. 로그표시형식을정의합니다. 표 [Log Layout] 을참조하십시오. 34 FORCS Co., LTD
설명 Prioritylog level 에따라이벤트 로보내는내용을필터링할 NT_Event.Threshold 때사용합니다. 현재설정한 Prioritylog level 보다낮은단계 의값만지정할수있습니다. ERROR/INFO/DEBUG Log 를 Unix 의 Syslog 로보낼 SYSLOG.Type 경우에해당하며 Syslog 를 설정합니다. SYSLOG.Layout 표시형식을정의합니다. 표 [Log Layout] 을참조하십시오. Appender - 계속 syslog SYSLOG.Threshold SYSLOG.SyslogHost SYSLOG.Facility SYSLOG.FacilityPrinting Priorityloy level에따라 Syslog 로보내는내용을필터링할때사용합니다. 현재설정한 Prioritylog level보다낮은단계의값만지정할수있습니다. ERROR/INFO/DEBUG Syslog로보낼 Unix 호스트의 IP를설정합니다. Syslog 로메시지를보낼때해당메시지가발생하는장소를설정합니다. KERN, USER, MAIL, DAEMON, AUTH, SYSLOG, LPR, NEWS, UUCP, CRON, ;AUTHPRIV, FTP, LOCAL1, LOCAL2, LOCAL3, LOCAL4, LOCAL5, LOCAL6, LOCAL7. True 값이면 log Message 에 Facility 이름을추가합니다. FORCS Co., LTD 35
Log Layout Character 설명 OZServer 의내부 module 에따른 category name 을출력합니다. Category name 은다단계의계층을이루고있는데 %c{2} 처럼출 c 력단계를지정할수도있습니다. 예 ) %c oz.server.servlet %c{1} servlet %c{2} server.servlet 날짜를출력해줍니다. 사용자가패턴을넣어주는방식과 log4j 에서설정해놓은 패턴 (ABSOLUTE, DATE, ISO8601) 을사용하는방식이있습니다. 설정된패턴사용을권장합니다. d [Example] [ %d{dd MM yyyy HH:mm:ss,SSS} ] [ 18 04 2001 18:39:29,777 ] main INFO ozserver - OZServer... [Example] [ %d{iso8601} ] [ 2001-04-18 18:39:29,777 ]main INFO ozserver - OZServer... log message 를발생시키는 OZServer 내부로직의해당 m event 에서 event 자체에할당한이름을출력해줍니다. 예 ) %d{iso8601} [%t] %-5p %c{1} %x-%m 2002-08-16 09:56:23,203[Handler 1] INFO MessageHandler n C 언어의 \n 같은개행문자입니다. New Line 으로 log 의커서를 옮겨줍니다. message 의 log level 값 (INFO, DEBUG, ERROR 등 ) 을출력해 줍니다. 아래예에서 %p 사이에들어간 5 는 5 칸의공간을 p 차지하고왼쪽으로정렬해출력하라는의미입니다. 예 ) %d{iso8601} [%t] %-5p %c{1} %x-%m 2002-08-16 09:56:23,203[Handler 1] INFO MessageHandler 오즈서버가시작된시간을기준으로경과된시간을 millisecond r 단위로연결된 event 에출력시켜줍니다. [Example] [%r] [2994] main INFO oz.server - OZServer... 36 FORCS Co., LTD
Character 설명 Thread 이름을연결된 event 에출력합니다. t [Example] [%t] 59485 [Thread-2] INFO oz.server - Received a message % % 기호를넣고싶을때사용합니다. [Example] %% Log 파일 Date Format Symbol Meaning Presentation Example G Era designator Text AD y Year Number 2001 M Month Text & Number May & 05 d Day Number 05 h Hour in am/pm (1~12) Number 12 H Hour in day (0~23) Number 0 m Minute Number 30 s Second Number 55 S Millisecond Number 978 E Day in week Text Tuesday D Day in year Number 189 F Day of week in month Number 2 (2nd ) w Week in year Number 27 W Week in month Number 2 a Am/pm marker Text PM k Hour in day (1~24) Number 24 K Hour in am/pm (0~11) Number 0 z Time zone Text Pacific Standard Time Escape for text Delimiter Single quote sign Literal 예 ) yyyy.mm.dd G at hh:mm:ss z 2001.04.24 AD at 18:25:30 PDT EEE, MMM d, yy Wed, July 10, 96 h:mm a 12:08 PM FORCS Co., LTD 37
<NT Event 에오즈서버로그가등록된예 > db.properties 위치 [Daemon/Servlet] {OZ_HOME}\conf\db.properties 역할오즈서버가사용할데이터베이스의연결정보를설정하는파일로복수개의연결정보를설정할수있습니다. 오즈서버는서버성능향상을위해서버시작시에 db연결 pool을생성하고, 이를공유하여사용할수있도록하는 DB connection pool을지원합니다. 각연결정보는다음과같은형태로설정됩니다. aliasename.filedname = value aliasename : 여러개의데이터베이스연결정보를구분하기위해데이터베이스별로사용자가임의로부여 filedname : 데이터베이스연결에필요한항목명 38 FORCS Co., LTD
db.properties 파일의내용 Filed Name vendor driver url props dsn useijava serveraddress portno sid servername dbname user password maxconns Initconns timeout loglevel Value DBMS 종류설정 odbc, oracle, informix, sybase. ms-sql 등으로설정 JDBC 드라이버의클래스명 JDBC 드라이버의 connection url String JDBC 드라이버의 connection property String ODBC 의데이터베이스소스명 Oracle 7.x 에서한글 Character Set 을사용할경우에만 true 데이터베이스가설치된서버의주소데이터베이스통신포트번호 Oracle 데이터베이스의 SID 데이터베이스서버명데이터베이스명사용자명사용자패스워드오즈서버가가질수있는최대 DB Connnection 수오즈서버의초기 DB Connection 수 Maxconns 를초과할시사용중인 Connnection 이반환되기를기다리는최대시간 ( 단위 : 초 ) debug/info LOGGING Level 각 DBMS 별 db.properties 설정예제파일 Oracle 데이터베이스예제 oracle_example.vendor=oracle oracle_example.serveraddress=211.116.251.7 oracle_example.portno=1521 oracle_example.sid=orcl oracle_example.user=oz oracle_example.password=oz oracle_example.maxconns=20 oracle_example.initconns=5 oracle_example.timeout=5 FORCS Co., LTD 39
Informix 데이터베이스예제 informix_example.vendor=informix informix_example.serveraddress=211.116.251.7 informix_example portno=1526 informix_example.servername=ozserver informix_example.dbname=sysutils informix_example.user=informix informix_example.password=informix informix_example.maxconns=20 informix_example.initconns=5 informix_example.timeout=5 MS-SQL Server 데이터베이스예제 mssql_example.vendor=mssql mssql_example.serveraddress=211.116.251.7 mssql_example.portno=1433 mssql_example.dbname=newintra mssql_example.user=sa mssql_example.password= mssql_example.maxconns=20 mssql_example.initconns=5 mssql_example.timeout=5 ODBC 예제 odbc_example.vendor=odbc odbc_example.dsn=odbc_example odbc_example.user= odbc_example.password= odbc_example.maxconns=5 odbc_example.initconns=2 odbc_example.timeout=5 db2 예제 db2_example.vendor=db2 db2_example.serveraddress=211.116.251.7 db2_example.portno=1344 db2_example.subprotocol=db2 db2_example.dbname=db2 db2_example.user=db2admin db2_example.maxconns=20 db2_example.initconns=5 db2_example.timeout=5 40 FORCS Co., LTD
sybase 예제 Sybase_example.vendor=sybase Sybase_example.serverAddress=211.116.251.7 Sybase_example.dbName=master Sybase_example.portNo=2343 Sybase_example.user=sa Sybase_example.password=sybase Sybase_example.maxconns=20 Sybase_example.initconns=5 Sybase_example.timeout=5 unisql 예제 unisql_example.vendor=unisql unisql_example.serveraddress=211.116.251.7 unisql_example.dbname=demodb unisql_example.portno=44300 unisql_example.user= unisql_example.password= unisql_example.maxconns=20 unisql_example.initconns=5 unisql_example.timeout=5 User Custom DBMS 예제 - MySQL user_example.vendor=user user_example.driver=org.gjt.mm.mysql.driver user_example.url=jdbc:mysql://ip/test user_example.props=user=oz;password=oz user_example.user=oz user_example.maxconns=5 user_example.initconns=1 user_example.timeout=5 user_example.loglevel=info websphere dbpool 예제 Websphere_example.vendor=oracle Websphere_example.serverAddress=211.116.251.7 Websphere_example.portNo=1521 Websphere_example.sid=forcs815 Websphere_example.user=scott Websphere_example.password=tiger Websphere_example.maxconns=5 Websphere_example.initconns=0 Websphere_example.timeout=5 FORCS Co., LTD 41
Websphere_example.driver=com.forcs.belle.WSJDBCDriver Websphere_example.url=forcs:websphere:jdbc/<websphere_data_source_name>:<us er>:<pass> weblogic dbpool 예제 weblogic_exmaple.vendor=oracle weblogic_exmaple.serveraddress=211.116.251.7 weblogic_exmaple.portno=1521 weblogic_exmaple.sid=forcs815 weblogic_exmaple.user=scott weblogic_exmaple.password=tiger weblogic_exmaple.maxconns=5 weblogic_exmaple.initconns=0 weblogic_exmaple.timeout=5 weblogic_exmaple.driver=weblogic.jdbc.pool.driver weblogic_exmaple.url=jdbc:weblogic:pool:<weblogic_pool_name> Jeus dbpool 예제 Jeus_example.vendor=oracle Jeus_example.serverAddress=211.116.251.7 Jeus_example.portNo=1521 Jeus_example.sid=ora9i Jeus_example.user=scott Jeus_example.password=tiger Jeus_example.maxconns=5 Jeus_example.initconns=0 Jeus_example.timeout=5 Jeus_example.driver=Jeus.jdbc.pool.Driver Jeus_example url=jdbc:jeus:pooljeuspool rpmtmngr.properties 위치 [Daemon/Servlet] {OZ_HOME}\conf\rpmtmngr.propeties 역할 오즈서버에보고서폼파일 ( 확장자 xml) 을저장하는루트디렉토리를설정합니다. 기본값은 {OZ_HOME}\reports 입니다. 42 FORCS Co., LTD
Rptmngr.properties #------------------------------------------- # Configuration of Report Manager #------------------------------------------- # # The root directory that reports are stored. # RepositoryPath=%OZ_HOME%/reports srmngr.properties 위치 [Daemon/Servlet] {OZ_HOME}\conf\srmngr.properties 역할스케줄러에의해생성된결과데이터파일을저장할디렉토리를지정합니다. Repository path에저장된파일은시스템에서자동으로사용되며, RepositoryPath User에저장된파일은사용자가임의로사용할수있도록되어있습니다. srmngr.properties 파일 #------------------------------------------- # Configuration of Schedule Manager #------------------------------------------- # # The root directory that user-defined scheduled data modules are stored. # RepositoryPathUser=%OZ_HOME%/UserScheduledResult # # The path that scheduled data modules are stored. # RepositoryPath=%OZ_HOME%/scheduled FORCS Co., LTD 43
cachemngr.properties 위치 [Daemon/Servlet] {OZ_HOME}\conf\cachemngr.propeties 역할캐시매니저와관련된정보를설정합니다. 동시사용자가많은경우설정된시간동안데이터모듈을메모리에저장하여연속적으로같은내용의보고서요청시캐시안에있는데이터모듈을리턴하게됩니다. cachemngr.properties #------------------------------------------- # Configuration of Cache Manager #------------------------------------------- # # Is cache manager available? # Active=false # # If the percentage of currently available memory is lower than below value, cached data modules will be stored to file. # FreeMemoryPercentage=20 # # Default caching time out to be applied to reports that not specified caching time out. # DefaultTimeOut=900 # # The path that cache data modules are stored. # RepositoryPath=%OZ_HOME%/cache Active : true/false 값을가지며캐시의실행유무를설정합니다. FreeMemoryPercentage : 메모리용량이지정한수치의퍼센트보다적으면디스크에캐싱합니다. 44 FORCS Co., LTD
DefaultTimeOut : 데이터모듈이캐시에보존되는시간 ( 단위 : 초 ) 을설정합니다. Repositorypath : 디스크에캐싱할때데이터모듈이저장되는장소의경로입니다. monitor.properties 위치 [Daemon/Servlet] {OZ_HOME}\conf\monitor.properties 역할 오즈서버트랜잭션관련로그정보설정파일입니다. monitor.properties #------------------------------------------- # configuration of OZ Transaction Monitor log #------------------------------------------- # # OZ 2.5 에서는트랜잭션에관한간단한통계정보를로그로남길수있는기능을제공한다. # 이파일은그에대한설정들을지정한다. # # # Whether log or not # log.active=true # # logging file name # log.filename=%oz_home%/logs/monitor.log # # log interval. The unit is hour # log.interval=1 FORCS Co., LTD 45
xml.properties 위치 [Daemon/Servlet] {OZ_HOME}\conf\cachemngr.propeties 역할 오즈에서사용할 xml 파서에대한정보를설정합니다. xml.properties #----------------------------------------------- # Configuration of XML parser used by OZ Server #----------------------------------------------- sax.parser=sun dom.parser=sun ################################################ # # parser List # - followings are able to used in SAX and DOM # ---------------------------------------------- # # SUN : parser.jar # CRIMSON : crimson.jar # XERCES : xerces.jar OZ에서사용하는 XML Parser를지정합니다. XML Parser에는 SAX, DOM 두가지종류가있는데, SAX는 OZ Form을로드하는데, DOM은 License 파일과, XMLSet을읽어들이는데이용됩니다. 지정한파서의 jar파일이클래스패스에설정되어있어야합니다. 일반적으로 SUN 파서가가장빠른속도를보여주기때문에 SUN을사용할것을권장합니다. 기존의시스템가령 WAS에서 CRIMSON을사용하고있을경우, SUN 파서와충돌이나는경우가있으므로그럴경우 CRIMSON을사용합니다. IBM의 JVM을사용할경우는 XERCES의사용을권장합니다. XMLSet에서사용하는 XML 문서에, Entity가사용되었을경우, SUN 파서는 Entity처리를정확히수행하지못하는경우가있으므로 dom.parser의값으로 CRIMSON이나 XERCES를사용해야합니다. 46 FORCS Co., LTD
Ⅴ. 서블릿엔진과의연동 개요 WAS에대한일반적인서블릿연동절차웹로직과의연동 WebSphere와의연동 SilverStream과의연동 Apache Jserv1.1과의연동 Tomcat와의연동 Resin과의연동 Inprise Application Server와의연동 FORCS Co., LTD 47
개요 오즈엔터프라이즈서버서블릿타입은웹애플리케이션서버와연동하여설정할수있습니다. 독자적으로구동되는데몬과는달리서블릿타입은 WAS와결합하여 WAS의하나의애플리케이션으로등록되어사용됩니다. 오즈엔터프라이즈서버서블릿제품은다음과같은특성을가집니다. 1. WAS가이용하는포트를그대로이용하게됨으로오즈엔터프라이즈서버를이용하기위한별도의 TCP 포트 ( 데몬제품의경우포트번호 8001번 ) 가필요없습니다. HTTP 프로토콜을이용하기때문에보안상의문제등으로 TCP 포트에제약이많은곳에유용합니다. 2. WAS가이용하는 DB Pooling을이용할수있습니다. WAS가이용하는 DB Pooling을오즈엔터프라이즈서버가이용함으로써데이터베이스접속에대한시스템의부담을줄일수있습니다. 오즈엔터프라이즈서블릿제품은데몬제품과는달리설치이후반드시서블릿과의연동절차를걸쳐야합니다. 서블릿과의연동이후오즈엔터프라이즈서버는 WAS 와하나로작동하게됩니다. 예를들어 WAS가시작되면오즈엔터프라이즈서버도자동으로구동되며, WAS가종료되면오즈엔터프라이즈서버도종료됩니다. 48 FORCS Co., LTD
WAS 에대한일반적인서블릿연동절차 오즈엔터프라이즈서버서블릿제품과 WAS를연동하기위해서는다음의절차를거쳐야합니다. Step 1 서블릿클래스등록 Step 2 URL Path 설정 Step 3 오즈라이브러리 Classpath 설정 Step 4 ozserver.properties 파일 path 설정 각 Step에는여러 Case가존재하게됩니다. 해당 WAS에따라알맞은 Case를참고하십시오. Step 1 서블릿클래스등록 case1 : 오즈서블릿은 WAS의웹애플리케이션으로등록가장일반적인방법으로오즈엔터프라이즈서버의 WEB-INF 디렉토리가있는 path를 WAS에등록합니다. WAS에따라 User Interface를웹상에서제공되는경우제공되는웹콘솔을이용하여등록이가능하며, 제공되지않는경우설정파일을직접편집합니다. case2 : WAR 파일이용 WEB-INF 디렉토리를포함한 ozservlet 디렉토리를통째로묶은 FORCS Co., LTD 49
war 파일을만든후 WAS의 servlet configuration file에만든 war 파일에대한정보를설정합니다. 콘솔등에서 User Interface를제공하는 WAS의경우 User Interface를이용하여 war 파일에대한정보를입력하게됩니다. ( 이방법은서블릿배포및등록이나서블릿이대형화되면서잘쓰이지않고있습니다.) case3 : 서블릿실행 java class 등록실행할서블릿의 package 및 class 이름 (oz.server.ozservlet) 을등록합니다. 이경우 OZServlet 관련 jar 라이브러리들이 WAS 실행시 classpath로잡혀있어야합니다. Step 2 URL Path 설정 case1 : 오즈엔터프라이즈서버의 WEB-INF/web.xml 수정서블릿에 URL을맵핑하는표준적인방법입니다. web.xml 파일을열어 url-pattern 항목에할당할 url을입력합니다. case2 : 기타 WAS의서블릿설정파일이나 url 관련메뉴를찾아설정해줍니다. Step 3 오즈라이브러리 Classpath 설정 case1 : WEB-INF/classes, WEB-INF/lib 자동설정 WAR 파일또는 WEB-INF 디렉토리를등록한경우자동으로필요한라이브러리들이 classpath에등록됩니다. case2 : WAS 실행 classpath에등록 Servlet java class를직접등록한경우또는 WEB-INF나 WAR 파일을통해설치할수없는경우직접 WAS 구동시에 classpath를잡아주어야합니다. WAS 실행 shell script나전역환경변수를수정하여오즈서블릿에필요한라이브러리들을 classpath에추가합니다. 50 FORCS Co., LTD
case3 : 기타 WAS의 configuration 파일에서블릿용라이브러리를따로설정하는경우그곳에라이브러리들의 path를입력해줍니다. Step 4 ozserver.properties 파일 path 설정 case 1 : WEB-INF/web.xml 수정 init-param 태그를 OZSERVER_HOME으로하고 value에 ozserver home의절대경로를입력해줍니다. case2 : init parameter 직접등록 WAS의설정파일이나설정메뉴에서 init parameter를설정하는곳을찾아태그이름을 OZSERVER_HOME으로하고 value에 ozserver home의절대경로를입력해줍니다. case 3 : classpath에등록 WAS에정의된 classpath에 ozserver.properties 파일을위치시킵니다. ( 일반적으로오즈서블릿홈디렉토리아래의 WEB-INF/ classes 디렉토리를사용합니다. ) case 4 : servlet 실행홈을통해등록등록된오즈서블릿의 URL에접속을시도하였을때 ozserver.properties 파일을찾지못할경우 stdout 출력로그또는웹브라우저에서블릿실행홈에대한절대경로를출력해줍니다. 그위치에 ozserver.properties 파일을복사해둡니다. Case1부터 Case4까지의방법중해당 WAS에알맞은방법을선택하여등록해주고, 알맞은 WAS 방법을찾지못했을경우 Case1부터 Case4까지순서대로세팅해봅니다. FORCS Co., LTD 51
Web.xml 파일 <?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd"> <web-app> <servlet> <servlet-name> httpserver </servlet-name> <servlet-class> oz.server.ozservlet </servlet-class> </servlet> <servlet> <servlet-name> ozhello </servlet-name> <servlet-class> HelloWorld </servlet-class> </servlet> <servlet-mapping> <servlet-name> httpserver </servlet-name> <url-pattern> /server </url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name> httpserver </servlet-name> <url-pattern> /server/* </url-pattern> 52 FORCS Co., LTD
<init-param> <param-name> OZSERVER_HOME </param-name> <param-value>d:\oz\servlet2.5</param-value> <description> set ozserver home path </description> </init-param> </servlet-mapping> <servlet-mapping> <servlet-name> ozhello </servlet-name> <url-pattern> /hello </url-pattern> </servlet-mapping> </web-app> 위와같이배포되는 web.xml 파일은별다른설정없이그대로사용할수있습니다. 위의설정을이용하여오즈엔터프라이즈서버로접근할경우웹브라우저에서 http:// 서버URL/oz/server 를입력하게되면해당오즈엔터프라이즈서버서블릿의버전정보와세부사항이나와있는화면이나타납니다. (URL에서오즈는 WAS에오즈서블릿등록시설정해준오즈 URL Path입니다.) ************************************************* OZ Servlet 2.5.1905.16.30 copyright. FORCS Co., Ltd. ************************************************* --- OZ Version Info ----------------------------------------- OZ Servlet : 2.5.1905.16.30 FORCS Co., LTD 53
OZ Common Protocol Release : 2.5.1905.13.17 Protocol : 2007 OZ DataModule Release : 2.5.1905.16.01 Streaming Protocol : 1910 System Information OS Name : Windows 2000 Version : 5.0 Java Vendor : Sun Microsystems Inc. Version : 1.3.1 Class Version : 1.3.1 Servlet Container : WebLogic WebLogic Server 6.1 07/23/2001 22:31:20 #129251 Running Path : D:\Program Files\FORCS\OZServlet25\. Ciper Suite : null Certificates : null Session : null 최상부의 OZ Servlet 2.5.1905.16.30을보면이서블릿버전이 2.5 이며세부버전정보가 1905.16.30 임을확인할수있습니다. 아래단락의 OZ Version Info 부분에서는 OZ Servlet 버전이 2.5.1905.16.0, OZ Common Protocol의 Release 버전이 2.5.1905.13.17, Protocol이 2007 임이나타납니다. OZ DataModule의경우 Release 버전 2.5.1905.16.01과 Streaming protocol이 1910이란것이나타납니다. 마지막단락부 System Information에는해당시스템에대한정보가나타납니다. 해당 OS 종류 (Windows 2000 / Solaris / AIX / HP-UX 등 ) 와해당 OS의버전, JAVA Vendor, JAVA Version, Class version, Servlet Container(WAS 정보 ) 가나타나며, Running path 부분에는현재오즈엔터프라이즈서버가설치된곳의경로가나타납니다. 54 FORCS Co., LTD
웹로직과의연동 웹로직 6.1 이전 웹애플리케이션이등록될파일이름 : weblogic.properties 웹애플리케이션이등록될형식 : #### OZ Servlet weblogic.httpd.webapp.oz=c:/program files/oz/ 웹로직의 weblogic.properties 파일을열어 weblogic.httpd.webapp.oz= 라고입력한후, 오즈가위치한곳의경로를입력합니다. 데이터베이스의설정오즈서블릿의자체 DB Pooling을사용할경우오즈서버데몬버전에서와같은방법으로오즈의 db.properties 파일을설정합니다. 반면, 웹로직의 DB Pooling을상속받아사용하기위해서는 weblogic.properties에서웹로직이정의한 connection Pool을찾아해당 Pool의이름을오즈의 db.properties 파일에서정의하여사용하면됩니다. weblogic.properties 파일의 DB Pool 정보 웹로직 6.1 이상에서는웹로직 admin console에서 DB Pool을설정합니다. weblogic.jdbc.connectionpool.oracle_thin=\ url=jdbc:oracle:thin:@211.116.251.7:1521:forcs815,\ driver=oracle.jdbc.driver.oracledriver,\ initialcapacity=1,\ maxcapacity=2,\ capacityincrement=1,\ props=user=scott;password=tiger weblogic.allow.reserve.weblogic.jdbc.connectionpool.oracle_thin=everyone weblogic.jdbc.connectionpool.oracle_thin=\ oracle_thin 이웹로직에서사용하는 thin 드라이버의 connection pool 이름입니다. 그이후의모든정보는 thin 드라이버를사용하기위해기술해야할기본적인항목들입니다. 마지막라인이있는지반드시확인합니다. 만일없거나 everyone 으로설정되어있지않으면, 웹로직룰에따라오즈서블릿이해당 connection pool을이용할수있도록권한을설정해줍 FORCS Co., LTD 55
니다. 웹로직에설정된오라클 DB Pool을사용할때오즈의 db.properties 파일은다음과같이설정합니다. oacle1.vendor=user oracle1.driver=weblogic.jdbc20.pool.driver oracle1.url=jdbc:weblogic:pool:oracle_thin oracle1.serveraddress=211.116.251.7 oracle1.portno=1521 oracle1.sid=forcs815 oracle1.user=scott oracle1.password=tiger oracle1.maxconns=5 oracle1.initconns=0 oracle1.timeout=5 oracle1.loglevel=debug initconns는반드시 0으로설정합니다. 설치후에는확인작업을수행합니다. 과정은다음과같습니다. db.properties를세팅할때에는현재웹로직에서사용하는드라이버가 JDBC 2.0과호환되는지를반드시확인해야합니다. Oracle의경우에는 JDBC 드라이버중 classes111.zip은 JDBC 2.0과호환되지않으며, classes12.zip이나 classes12_01.zip 등이 JDBC 2.0과호환됩니다. 이와관련된부문은 startweblogic.sh/startweblogic.cmd 에서확인할수있습니다. 모든환경설정이끝나면웹로직을재실행합니다. 인터넷브라우저를통해다음의 URL로확인할수있습니다. http://weblogic-ip:7001/oz/server 7001 : 웹로직에서설정한 Port Number /oz : weblogic.properties에서정의한오즈의 url path /server : 오즈의 web.xml에서정의된오즈서블릿의 url pattern 56 FORCS Co., LTD
웹로직 6.1 이상 웹로직 6.1의경우웹로직에서지원하는콘솔을이용하여오즈엔터프라이즈서버를등록합니다. 환경설정절차웹로직서버를실행시킵니다. 웹로직서버콘솔을실행시킵니다. [Web Application] 을선택하여오즈를등록합니다. FORCS Co., LTD 57
[configure a new Web Application] 을선택합니다. 예를들어오즈서블릿메인디렉토리를 D:/servlet2 로, 이름은 oz 로등록하고자한다면 [Configuration] [General] 탭에서각란에다음과같이입력합니다. 58 FORCS Co., LTD
입력한후 [Create] 를클릭하면다음과같이등록됩니다. [Targets] 탭으로이동합니다. 오즈를등록할 Target 서버를선택합니다. FORCS Co., LTD 59
[Apply] 클릭하여등록을마칩니다. 오즈가정상적으로작동하는지확인해봅니다 http://127.0.0.1:7001/oz/server ( 서버는오즈서블릿폼의 WEB-INF/web.xml에서설정해준서블릿 url pattern입니다.) WebSphere 와의연동 WebSphere 3.5 WebSphere와오즈를연동하기위해서는 WebSphere의 Admin 서비스가반드시시작되어있어야합니다. 오즈서블릿설치 [ 시작 ] [ 프로그램 ] [WebSphere] 에서 [ 관리콘솔 ] 을실행합니다. 60 FORCS Co., LTD
왼쪽패널의아이콘을클릭하면서버이름 ( 호스트명 ) 의서비스가있습니다. 하위메뉴중에서 [Default Server] [Default Servlet Engine] 을선택합니다. 마우스오른쪽버튼을클릭하여 [ 작성 ] [ 웹응용프로그램 ] 을선택합니다. [ 일반 ] 탭에서등록할 [ 웹응용프로그램이름 ] 란에 oz 를입력하고, [ 설명 ] 란에는간략한설명을적어줍니다. [ 가상호스트 ] 란에기본값을 default_host 로설정한다음 [ 웹응용프로그램웹경로 ] 에 /oz 를입력합니다. 이값이오즈서블릿의 URL Path가됩니다. FORCS Co., LTD 61
다음은 [ 확장판 ] 탭을클릭합니다. [ 클래스경로 ] 에오즈를위한각각의클래스경로를적어줍니다. 기본적으로 OZServer25.jar, OZCommon25.jar, log4j.jar, jaxp.jar, parser.jar를경로로잡아주고 JDBC 드라이버를위한디렉토리와각각의 JDBC 파일경로를잡아줍니다. 25 25.jar 62 FORCS Co., LTD
메인패널에웹응용프로그램 oz 가생성되었습니다. 마우스오른쪽버튼을클릭한후 [ 작성 ] [Servlet] 을선택합니다. 이곳에서웹응용프로그램 oz 자체환경등을설정합니다. [Servlet 이름 ] 란에 ozservlet, [ 웹응용프로그램 ] 란은기본값인 oz 선택합니다. [Servlet 클래스이름 ] 란에는 oz.server.ozservlet 이라고입력합니다. [Servlet 웹경로목록 ] 에 [ 추가 ] 버튼을클릭한다음 server 라고입력합니다. 이것이오즈의 URL Pattern이됩니다. FORCS Co., LTD 63
oz와 WebSphere를위해서는 oz의 xml parser가 Sun이아닌 IBM임을알려주어야합니다. 콘솔의왼쪽창에서 [Default Server] 를클릭하여나오는다음과같은화면에서 Parser를설정해줍니다. 또한오즈의 xml.properties 파일에서도 IBM의해당 Parser에맞게변경해주어야합니다. 자세한내용은본매뉴얼 Ⅳ. 오즈엔터프라이즈서버설정 - xml.properties 를참조하시기바랍니다. 여기서 [ 매개변수 ] 란에 -Dorg.xml.sax.parser=com.ibm.xml.parsers.SAXPar ser 라고입력합니다. 모든설정이완료되면확인작업을수행합니다. 데이터베이스연결설정을확인합니다. 오즈서블릿의자체적인 DB Pooling을사용할때에는오즈서버데몬버전에서와같은방법으로 db.properties 파일을설정합니다. 웹브라우저에서 http://localhost/oz/server라고입력하여 server를로드합니다. 64 FORCS Co., LTD
WebSphere 4.0 1. 오즈서블릿디렉토리에서 servlet25.war 파일을만듭니다. jar cvf servlet25.war * <windows용 > 2. Application Assembly Tool 을실행시켜 servlet25.ear 파일을만듭니다. servlet25.ear 파일등록과정 [ 응용프로그램어셈블리도구사용환경 ] 에서 [ 응용프로그램작성마법사 ] 를선택합니다. [ 응용프로그램작성마법사 ] 에 servlet25.ear 파일에대한정보를입력합니다. FORCS Co., LTD 65
[ 다음 ] 을누르다가웹모듈추가창이나타나면 servlet25.war 를등록합니다. 문맥루트의오즈는웹상에서호출하는오즈서블릿의 URL Path 가됩니다. [ 다음 ] 을클릭하면서각설정들을등록한후완료합니다. 66 FORCS Co., LTD
[ 다른이름을저장 ] 을선택하여 servlet25.ear 파일로저장합니다. 다음과같은화면이나오면 [ 확인 ] 버튼을클릭합니다. 저장이완료되었습니다. FORCS Co., LTD 67
3. WebSphere 관리콘솔을실행하여오즈를등록합니다.(Single과 Server로구분됩니다.) Single에서 servlet25.ear 설치과정 [ 엔터프라이즈응용프로그램 ] 을선택한후 servlet2.ear을설치합니다. [ 설치 ] 를클릭하여 servlet25.ear 파일을찾은후 [ 다음 ] 을클릭합니다. 로컬 PC에파일 (servlet25.ear) 이있을때는위쪽의 [ 업로드또는설치할이시스템상의응용프로그램또는모듈을지정하십시오 ] 에서찾아 68 FORCS Co., LTD
주고, 서버에파일이있고원격으로설치할때는아래쪽 [ 설치할서버상의응용프로그램이나모듈을지정하십시오 ] 에서경로를등록해줍니다. [ 가상호스트이름 ] 을설정합니다. [ 웹모듈이름 ] 을확인하고 [ 다음 ] 을클릭합니다. 응용프로그램의관련된정보를확인하고 [ 완료 ] 를누릅니다. FORCS Co., LTD 69
다음과같이 servlet25 응용프로그램이설치됩니다. 처음설치후에는아카이브가정상으로나오지않습니다. 그문제를해결하기위해서는 구성을저장해야합니다 및 플러그인구성을재생성해야합니다 를반드시클릭해야합니다. [ 저장 ] 을클릭하여변경된환경파일을저장합니다. 플러그인구성을재생성해야합니다. 70 FORCS Co., LTD
[Application Server] [Default Server] 의 [ 고급설정값 ] 에서 웹서버플로그인구성 항목을클릭합니다. 다음과같이나오면 [ 생성 ] 을클릭하여완료시킵니다. 구성을다시저장하라는메시지가나오면다시저장합니다. WebSphere 를다시시작실행시키면오즈서블릿도함께실행됩니다. FORCS Co., LTD 71
[ 엔터프라이즈응용프로그램 ] 에서 servlet25 를선택하고 [ 확인 ] 버튼을클릭합니다. 다음과같이오즈서블릿이실행됩니다. 72 FORCS Co., LTD
Server에서 servlet25.ear 설치과정 [WebSphere 고급관리콘솔 ] 에서 [ 엔터프라이즈응용프로그램 ] [ 엔터프라이즈응용프로그램설치 ] 를선택합니다. [ 엔터프라이즈응용프로그램설치마법사 ] 에서 servlet25,ear 을설치합니다. [ 다음 ] 을클릭하면다음과같은화면들이나타납니다. [ 다음 ] 을클릭하면다음과같은화면들이나타납니다. FORCS Co., LTD 73
74 FORCS Co., LTD
설치할서버 ( 노드 ) 그룹을선택한후 [ 확인 ] 을클릭하면다음과같이 [ 응옹프로그램설치마법사완료 ] 메시지가나타납니다. [ 완료 ] 를클릭하면설치완료됩니다. 설치완료후노드 (servlet25.ear를설치할서버 ) 를선택한후 웹플러그인재생성 을해줍니다. 플러그인재생성을한후서버를재실행하면오즈도같이연동실행됩니다. FORCS Co., LTD 75
SliverStream 과의연동 디렉토리구조 SilverStream 디렉토리는 C:\SilverStream35로, 오즈서블릿디렉토리는 D:\servlet2로가정합니다. 오즈서블릿디렉토리구조는데몬기본디렉토리구조와동일합니다. 설치 D:\OZServlet\WEB-INF\classes 에있는 ozserver.properties 와 C:\OZServlet\conf 에있는 db.properties 등을적절히수정합니다. 그후 [SilverStream Designer] 를실행시키면아래와같은화면이나타납니다. 왼쪽트리는 SilverStream에연결된데이터베이스입니다. 이중한곳에 OZServlet을설치해야합니다. 설치할 DB를 Examples3_Java 로정했다고가정합니다. ( SilverMaster35 에설치하는것은권장하지않습니다..) 트리에서 [Examples3_Java] 클릭하면서브그룹들이나옵니다. 여기에서 [EJB JARs & Media] 를선택하면아래와같은화면이나타납니다. 76 FORCS Co., LTD
오른쪽화면의 Jars 선택하고, 아래 3개의아이콘중맨왼쪽에있는아이콘 ( - New ) 을클릭하면 4개의메뉴가나옵니다. 이중 [UPLOAD JAR, ZIP, or EJB] 메뉴를선택합니다. 다음과같이파일선택창이뜨면./WEB-INF/lib에있는 ozserver25.jar를선택합니다. 그러면아래화면과같이 ozserver25.jar추가가됩니다. FORCS Co., LTD 77
그다음아래와같은 command를실행시킵니다. C:\SilverStream35\bin>silvercmd ImportSource localhost Examples3_Java D:\servlet\SilverStream\Servlet.java -f D:\servlet\SilverStream\Servlet.xml -p:true localhost는 SilverStream이설치된호스트이름입니다. 만약 SilverStream이기본적인 80번 port를쓰지않고다른 port 번호를사용한다면 localhost:8080과같이 port 번호를명시해주어야합니다. Examples3_Java는 ozserver20.jar를등록시킨 DB 이름입니다. p:true를반드시해주어야합니다. 만약 SilverStream server에접속하기위한 username과 password가있다면맨뒤에 U:username P:password 와같이명시해주어야합니다. 옵션에대한자세한정보는 silvercmd ImportSource? 를실행시키면볼수있습니다. 다시 [SilverStream Designer] 화면으로돌아와서 [Examples3_Java] 의 [Objects] 를클릭하면아래화면과같이 oz 라는 package가새로생기고그아래에 Servlet 이라는항목이새로나타납니다. 78 FORCS Co., LTD
이 Servlet 항목을더블클릭하면아래와같이 [Business Object Designer] 창이나타납니다. 여기서메뉴중 [File] [Jar Files] 를선택하면 jar 파일을선택할수있는 [Select JAR Files] 창이하나가뜹니다. [Available Jars] 란에서 Examples3_Java 의 ozserver25.jar 를 [Jars used by this item] 란으로옮기면다음과같은화면이됩니다. ( 만약다음과같은화면이뜨지않고아무런반응도없다면 [Business Object Designer] 창을닫고다시띄웁니다. 창을닫을때 Save 창이뜨면 No 로선택합니다.) FORCS Co., LTD 79
다음으로화면위의 [Triggers] 라는아이콘에서마우스의오른쪽을클릭하면 [Properties] 라는메뉴가나옵니다. 이메뉴를선택하면다음과같은화면이나옵니다. [Object] 탭에서 [Lifetime] 이 Server-lifetime 인것을반드시확인합니다. 만약 Event-lifetime 이라면반드시 Server-lifetime 로바꿔줍니다. [Triggers] 탭의 [URLs.] 버튼을클릭하면 OZServlet 이나옵니다. 이 OZServlet 은 OZServlet을접근하기위한 URL path입니다. ( 실제로오즈서블릿 url은 http://localhost/examples3_java/ozservlet과같이됩니다.) 모든절차가끝나면 [Ctrl+S] 키를눌러저장합니다. 저장이되면서 compile이됩니다. Compile이끝나면창을닫습니다. 이제마지막으로커맨드상태로와서아래의내용으로 SilverStream 서버를실행시키는배치파일은만들어야합니다. 그리고 SilverStream 서버를이배치파일을통해실행시켜줍니다. 80 FORCS Co., LTD
환경변수설정 Set AGCLASSPATH=C:\OZServlet\conf;C:\OZServlet\lib\OZCommon.jar;C:\OZServlet\lib\parse r.jar;c:\ozservlet\lib\jaxp.jar;c:\ozservlet\lib\log4j.jar silverserver -nodbcheck +Dorg.xml.sax.parser=com.sun.xml.parser.Parser Window 2000 Server에서는 [ 내컴퓨터 ] 의환경변수설정부분에등록해도됩니다 위 AGCLASSPATH 세팅한부분에는오즈서블릿라이브러리 jar파일과 JDBC관련 jar(zip) 파일경로를추가해줍니다. ( 예 > C:\OZServlet\lib\jconn2.jar 등.) nodbcheck은 SilverStream 서버를실행시키는데필요한옵션입니다. 만약 SilverStream이설치된곳에서원래 nodbcheck 옵션을주지않았다면생략합니다. 마지막으로웹브라우저에서 http://localhost/examples3_java/ozservlet 를입력하여 OZServlet start 메시지가제대로뜨는지확인하면설정이완료됩니다. FORCS Co., LTD 81
Apache Jserv 와의연동 JServ는 Apache 웹서버엔진을사용하는대부분의웹서버및애플리케이션서버에기본적으로탑재되어있는서블릿엔진입니다. 여기에서설명하는파일및디렉토리구조는 JServ의기본구조입니다. Oracle ias, Netscape Web Server 등은해당디렉토리에서서블릿세팅부분을살펴보면비슷하게설정할수있도록이루어져있습니다. 이외에 WebLogic, WebSphere와같이특이한설정구조를가진제품들을제외한다면대부분설정해야할항목들은유사하기때문에 JServ를참조하시기바랍니다. 디렉토리구조 {$Jserv_Home} = D:/Apache/Jserv1.1 Jserv의디렉토리구조 [ 디렉토리 ] 파일 설명 [./conf] jserv.properties 오즈서블릿의 Classpath 추가 [./servlet] zone.properties 오즈서블릿 Alias 추가 환경설정절차 jserv.properties 파일을편집합니다. OZServer25.jar 파일과 ozserver.properites 파일이위치한디렉토리그리고./WEB-INF/lib 아래에있는필요한파일의클래스경로를다음과같이추가합니다. 사용할 DB에따라필요한 jdbc 드라이버를추가해줍니다. jserv.properties # wrapper.classpath=d:/apache/jserv1.1/apachejserv.jar wrapper.classpath=d:/jsdk2.0/lib/jsdk.jar ################### OZ ########################## wrapper.classpath=d:/servlet2/web-inf/classes wrapper.classpath=d:/servlet2/web-inf/lib wrapper.classpath=d:/servlet2/web-inf/lib/ozserver25.jar wrapper.classpath=d:/servlet2/web-inf/lib/ozcommon25.jar wrapper.classpath=d:/servlet2/web-inf/lib/log4j.jar wrapper.classpath=d:/servlet2/web-inf/lib/parser.jar wrapper.classpath=d:/servlet2/web-inf/lib/jaxp.jar wrapper.classpath=d:/servlet2/web-inf/lib/classses12_01.zip 82 FORCS Co., LTD
URL Pattern 설정 zone.properties 파일에다음항목들을추가합니다. 오즈서블릿의 Alias, Startup을설정해줍니다. (Startup 부분은웹서버에따라없을수도있습니다.) 각항목들은사용하는웹서버의매뉴얼을참고하십시오. {$Jserv_HOME}/servlets/zone.properties ############# S E R V L E T P A R A M E T E R S ############## # Startup Servlets # OZ servlets.startup=ozservlet # Servlet Aliases # OZ servlet.ozservlet.code = oz.server.ozservlet 설치후에는확인작업을수행합니다. 데이터베이스연결설정을확인합니다. 오즈서블릿의자체적인 DB Pooling을사용할때에는오즈서버데몬버전에서와같은방법으로 db.properties 파일을설정합니다. 웹서버및서블릿이실행중인지확인하고 ( http://jserv-ip로접속하여웹서버확인 ), http://jserv-ip/servlets/ozservlet로접속해오즈서블릿이제대로설치되어있는지살펴봅니다. FORCS Co., LTD 83
Tomcat 과의연동 Tomcat은웹로직과거의유사한설정구조를가지고있습니다. 일부분의설정을제외하고는거의동일한설정을사용합니다. 디렉토리구조 {$Tomcat_Home} = D:/Apache/Tomcat3.2 Tomcat 의디렉토리구조 [ 디렉토리 ] 파일설명./bin Tomcat.bat Tomcat.sh Tomcat 실행파일./conft server.xml 오즈서블릿의 URL Alias 추가 환경설정절차 오즈등록먼저 Tomcat의설치경로를 <TOMCAT_HOME> 이라고가정할때에는 <TOMCAT_HOME>/bin/tomcat.sh 또는 tomcat.bat 파일에오즈의클래스경로를추가합니다. 그리고난후에 server.xml 파일에오즈서블릿폼이 d:/servlet이라면오즈서블릿의 Alias를다음과같이등록합니다. <!-- Oz Servlet setting--> <Context path="/oz" docbase="d:/servlet" crosscontext="true" debug="0" reloadable="true" > </Context> <!-- Oz Zero AdminConsole setting--> <Context path="/ozadmin" docbase="d:/servlet" crosscontext="true" debug="0" reloadable="true" > </Context> 84 FORCS Co., LTD
web.xml의수정./web-inf/web.xml 파일은공통 web.xml과동일합니다. 먼저데이터베이스연결설정을확인합니다. 오즈서블릿의자체적인 DB Pooling을사용할때에는오즈서버데몬버전에서와같은방법으로 db.properties 파일을설정합니다. 설치후에는확인작업을수행합니다. 웹서버및서블릿이실행중인지확인하고 (http://webhost-ip/ 로접속하여웹서버를확인합니다 ) http://webhost-ip/oz/ozserver로접속해오즈서블릿이제대로설치되어있는지살펴봅니다. Resin 과의연동 디렉토리구조 Resin은특정한디렉토리구조를요구하지않습니다. 사용자의편의에따라디렉토리구조를결정하면됩니다. 오즈서블릿디렉토리가 D:\servlet이라고하면오즈서블릿디렉토리구조는앞에서살펴본기본디렉토리구조와동일합니다. 환경설정절차 Resin의환경설정파일 resin.conf에오즈서블릿에대한설정을추가해줍니다. {$Resin_Home}/conf/httpd.conf. CauchoHost localhost 6802 AddHandler caucho-request jsp <Location /servlet/*> SetHandler caucho-request </Location> {$Resin_Home}>/conf/resin.conf <app-dir>d:/servlet2</app-dir> <serverlet-maping url-pattern= /oz/* servlet-name= ozservlet /> <serverlet servlet-name= ozservlet servlet-class= oz.servlet.ozservlet > FORCS Co., LTD 85
</servlet> 클래스경로설정은 Resin의실행파일을실행할때넘겨줍니다. 그러므로오즈에관련된디렉토리를클래스경로에추가시켜주어야합니다. Httpd Dorg.xml.parser=com.sun.xml.parser.Parser classpath D:/servlet2; D:/servlet2/WEB-INF; D:/servlet2/WEB-INF/classes; D:/servlet2/WEB-INF/lib; Httpd는실행파일입니다. 위에서 Dorg.xml.parser=com.sun.xml.parser.Parser 는 Parser에관련된옵션입니다. 반드시넣어주어야합니다. 설치후에는확인작업을수행합니다. 데이터베이스연결을설정확인합니다. 오즈서블릿의자체적인 DB Pooling을사용할때에는오즈서버데몬버전에서와같은방법으로 db.properties 파일을설정합니다. 웹서버및서블릿이실행중인지확인하고 ( http://webhost-ip로접속하여웹서버를확인합니다.) http://webhost-ip/servlet/ozservlet로접속해오즈서블릿이제대로설치되어있는지살펴봅니다. Resin (1.2.9 이상 ) 오즈전체를 war 파일로묶어설치하게됩니다. 서블릿 alias 잡아주기 war 파일로등록할경우다른설정없이오즈서블릿의 web.xml에서 URL Pattern으로사용되게됩니다. 오즈파일을 war로묶기예 ) c:\oz>jar cvf oz.war * 위의예제를실행시키면 oz.war가생깁니다. oz.war를 resin의 webapps 폴더에이동시킨후 resin을실행시키면 oz.war 파일이 webapps폴더에 deploy됩니다. (resin을실행시킨후에 webapp 폴더에이동해도상관없습니다.) 풀린오즈파일을환경에맞도록 ozserver.properties를수정해둡니다. 웹브라우저에서 http://localhost:8080/oz/server로실행시켜봅니다. 86 FORCS Co., LTD
Inprise Application Server와의연동 IAS(Inprise Application Server) 는기본적으로 Tomcat 서블릿엔진을사용하며현재 IAS 4.5 버전이지원하는 Tomcat Servlet 3.2가기본적으로설치되어있습니다. 오즈서블릿을연동하기위해서는두가지의방법이있습니다. 첫번째방법은오즈서블릿의모든파일을 IAS의서블릿폴더에복사한다음오즈의 web.xml을수정하는방법입니다. 두번째방법은 IAS에서 Tomcat이설치된폴더의 server.xml 파일설정을수정하여오즈서블릿을등록하고오즈의 web.xml을적절히수정하는방법입니다. Inprise Application Server 4.1 이하 IAS 서블릿디렉토리에복사해서설치 파일의복사오즈서블릿의파일들을 IAS의서블릿디렉토리에복사하기위해 /Borland/AppServer/var/servers/<SERVERNAME>/wars/tomcat3/ 아래에 oz 라는디렉토리를만든후오즈서블릿의파일들을복사합니다. (<SERVERNAME> 은설치시설정한서버의이름입니다.) 이때 oz 디렉토리가오즈서블릿을호출하는 URL Path가됩니다. 이렇게생성한 oz의하위디렉토리는 Tomcat 설치시와동일한구조로이루어지며오즈서블릿기본구조입니다. 오즈서블릿디렉토리구조는앞서살펴본기본디렉토리구조와동일합니다../oz/WEB- INF/web.xml 파일을수정합니다. web.xml의수정오즈를호출하기위한 URL 맵핑에대한정보를입력합니다. 기본설정과동일하게설정하며, 거의수정할필요가없습니다. <servlet-mapping> <servlet-name>httpserver</servlet-name> <url-pattern>/ozservlet/*</url-pattern> </servlet-mapping> FORCS Co., LTD 87
오즈서블릿의구동확인설치후에는확인작업을수행합니다. 과정은다음과같습니다. http://server_name:8080/oz/ozservlet/ozserver Tomcat 의설정을직접수정해서설치합니다. 파일수정 /Borland/AppServer/var/servers/<SERVERNAME>/adm/tomcat3/conf/ser ver.xml 파일의내용중에서다음사항을추가합니다. 이곳에서 path= /oz 가오즈서블릿의 URL Alias입니다. ( 앞에서설정한 Tomcat 설정과같습니다.) 이때오즈의서블릿폼을 D:\servlet2라고가정하면 servlet.xml <Context trusted="false" docbase="d:/servlet" reloadable="true" debug="0" path="/oz" crosscontext="true"> </Context> web.xml 파일수정오즈의 web.xml 파일을 Tomcat의설정을참조해서수정하기바랍니다. 거의수정하실필요가없습니다. 오즈서블릿의확인설치후에는확인작업을수행합니다. 과정은다음과같습니다. 데이터베이스연결을설정확인합니다. 오즈서블릿의자체적인 DB Pooling을사용할때에는오즈서버데몬버전에서와같은방법으로 db.properties 파일을설정합니다. http://server_name:8080/oz/ozservlet/ozservlet 88 FORCS Co., LTD
Inprise Application Server 4.1 설정 ClassPath 잡기 IAS의클래스패스는 java.options라는파일에서잡아야합니다. 이파일은 IAS서버의루트폴더에서 properties/server/< 서버이름 > 폴더에위치해있습니다. 예 ) C:\Inprise\AppServer\properties\server\goldenhawk\java.options 이파일을에디터로열면아래와같은구문을볼수있을것이다. # Set the default heap size to 32 Mb -Xms32m # Set the maximum heap size to 32 Mb -Xmx32m # Make the default buffer size 1024 bytes -Dvbroker.orb.streamChunkSize=1024 여기에다음처럼오즈서블릿의클래스들을등록시킵니다. 여기서오즈서블릿은 c:\inprise\appserver\oz에위치한것으로가정합니다. # Set the default heap size to 32 Mb -Xms32m # Set the maximum heap size to 32 Mb -Xmx32m -classpath C:\Inprise\AppServer\oz\WEB-INF\lib\OZServlet25.jar; C:\Inprise\AppServer\oz\WEB-INF\lib\OZCommon25.jar; C:\Inprise\AppServer\oz\WEB-INF\lib\parser.jar; C:\Inprise\AppServer\oz\WEB-INF\lib\log4j.jar; C:\Inprise\AppServer\oz\WEB-INF\classes; C:\Inprise\AppServer\oz\WEB-INF\lib\jaxp.jar; C:\Inprise\AppServer\oz\WEB-INF\lib\crimson.jar; 오즈서블릿이사용하는라이브러리파일이기때문에반드시입력해야합니다. 또한사용하는 DB의 jdbc 드라이버파일로입력해야합니다. 여기서, OZServlet25.jar, OZCommon.jar, parser.jar, log4j.jar, classes폴더, FORCS Co., LTD 89
jaxp.jar, crimson.jar 파일들이며, jkjdbc.jar는 MS-SQL용 jdbc 드라이버입니다. 만약, 사용자의다른 DB(Oracle, Sybase, Informix, DB2 등 ) 를쓴다면여기서쓰는 jdbc 드라이버로대체하여입력해야합니다. 데몬의 Alias 등록관리모드로들어가서 [HTTP Web Engine] 을선택한후 [Manage] 를클릭합니다. [Servlet Aliases] 에 /oz 를등록시킵니다. ( /oz 는오즈서블릿의 URL Path 가됩니다.) 90 FORCS Co., LTD
[Servlets] 메뉴를클릭한후서블릿을등록시킵니다. 모든작업이끝나면 IAS를재구동합니다. 웹브라우저에서 http://localhost:8080/oz/ozservlet로실행시킵니다. FORCS Co., LTD 91
Ⅵ. 오즈스케줄러소개 오즈스케줄러서버개요 오즈스케줄러아키텍처 92 FORCS Co., LTD
오즈스케줄러서버개요 오즈스케줄러서버는보고서스케줄링기능을지원하는서버입니다. 사용자가설정한스케줄 ( 시간, 주기 ) 에맞춰보고서를생성하고생성된보고서를여러가지형태 (ozz, xls, txt, pdf) 로웹과이메일을통해배포하는기능을수행합니다. 특징 최소한의스레드를발생시키는구조로서버에부하를최소화합니다. 한개의오즈스케줄러서버로복수개의오즈엔터프라이즈서버의보고서를스케줄할수있습니다. 모든스케줄정보는암호화된파일로서버에보관됩니다. 불의의경우 ( 하드웨어적혹은소프트웨어적 ) 로서버의구동이멈추었을경우에도서버의재구동과동시에시스템은암호화파일을이용하여지속적인스케줄서비스를제공합니다. 스케줄러는해당하드웨어에서지속적으로시간을체크하여작동하게됩니다. 서버구동중이라도하드웨어시간이변경되었을경우하드웨어에서변경된시간을감지하여지속적인스케줄링서비스가가능하도록합니다. 스케줄러관련 API를이용하여사용자애플리케이션에서스케줄태스크생성및관리가가능합니다. 웹을통한일반적인보고서배포이외에도이메일을통한배포도가능합니다. 보고서생성시패러미터를외부프로그램에의해가변적으로혹은관리자에의해특정값으로고정시킬수있습니다. FORCS Co., LTD 93
기능 스케줄링오즈스케줄러서버는오즈엔터프라이즈서버와는독립된서버로하나의오즈스케줄러서버에서복수개의오즈엔터프라이즈서버에대한스케줄링작업을할수있습니다. 특정시점에한번또는주기적으로보고서를생성하도록스케줄링할수있으며, 주기적인보고서생성의경우일별 ( 하루한번, 시간별로생성 ), 주별, 월별, 그리고사용자정의에의해보고서생성을스케줄링할수있습니다. 배포 ozz, xls, txt, pdf 형태로특정사용자혹은그룹에이메일로배포할수있습니다. 오즈스케줄러서버는관리자가지정한 SMTP 서버와계정을통해이메일을전송하며웹상에서는정해진시간에테이터 (sdm) 가업데이트되어배포되도록설정할수있습니다. 사용자인터페이스오즈스케줄러에서는다음과같은사용자인터페이스를제공합니다. Command Line 컨트롤명령어 엔터프라이즈매니저의 GUI환경제공 스케줄러 API - 사용자애플리케이션이나 3 rd party 제품에서스케줄작업을수행할수있습니다. 94 FORCS Co., LTD
오즈스케줄러아키텍처 Enterprise Manager Shell Commander RMI Scheduler Server Excel PDF OZZ Send Mail User Task Task Task Task Task DM OZ Server OZ Servlet OZ Server DM FORCS Co., LTD 95
Ⅶ. 오즈스케줄러설치및실행 시스템요구사항오즈스케줄러서버설치오즈스케줄러서버의파일구조서버세팅서버구동 96 FORCS Co., LTD
시스템요구사항 JRE(Java Runtime Environment) 1.1.x 이상을지원하는모든운영체제 (Windows, UNIX, Linux, AS400, Mainframe등 ) 오즈스케줄러설치 Windows 환경에서는오즈제품 CD의 [Scheduler] 폴더의 setup.exe를실행하여자동설치할수있습니다. UNIX 환경에서는설치를위해자동설치쉘스크립트 (install.sh) 를제공합니다. 오즈스케줄러서버의파일구조 오즈스케줄러서버설치후다음과같은구조로디렉토리와파일이생성됩니다. 디렉토리파일설명 bin conf Commander.bat Ozcommon25.jar Ozserver25.jar OZScheduler25.jar OZSchedulerCommander25.jar OZSchedulerService.exe Scheduler.bat Scheduler_stop.bat Ozscheduler.properties Scheduler_server.properties Scheduler_server_log.properties 스케줄러 Shell Commander 실행파일스케줄러에필요한서버클래스라이브러리스케줄러클래스라이브러리스케줄러 Shell Commander jar 파일스케줄러 NT 서비스등록제거파일스케줄러실행파일스케줄러중지파일스케줄러경로설정파일스케줄러서버설정파일스케줄러로그설정파일 FORCS Co., LTD 97
External 스케줄된보고서의패러미터값이나스케줄결과파일명을동적으로치환하기위한외부프로그램이등록되는루트디렉토리 lib Activation.jar Crimson.jar Jaxp.jar Log4j.jar Mail.jar OZD25.jar Parser.jar Pdf_java.dll 메일을보내기위해필요한라이브러리 xml 파서관련라이브러리 xml 파서관련라이브러리로그에관련된라이브러리파일메일을보내기위해필요한라이브러리보고서생성시필요한라이브러리 xml 파서관련라이브러리 pdf 파일을생성하기위한외부라이브러리 logs OZSchedulerMainLog.log 스케줄러로그파일 Repository [excel] [ozz] [pdf] Excel 파일이저장되는디렉토리 ozz 파일이저장되는디렉토리 pdf 파일이저장되는디렉토리 ScheduledTask 스케줄링태스크정보파일들이저장되는곳의루트디렉토리 TempRepository ozz, excel, pdf 파일들이임시로저장되는디렉토리 서버세팅 설정파일 scheduler.bat / scheduler.sh scheduler.bat와 scheduler.sh는오즈스케줄러서버를구동시키는파일입니다. Scheduler.bat @echo off rem ----------------------------------------------------- 98 FORCS Co., LTD
rem rem OZ Scheduler Start-up File rem rem This batch file written and tested under Windows 2000 rem check your path indicate <JAVA_HOME>\bin rem rem ----------------------------------------------------- set OZSCHEDULER_HOME=..\ if not "%OZSCHEDULER_HOME%" == "" goto start echo Unable to determine the value of OZSCHEDULER_HOME. goto eof :start set OZSchLib=%OZSCHEDULER_HOME%\conf set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\bin\OZScheduler25.jar set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\bin\OZServer25.jar set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\bin\OZCommon25.jar rem ----------------------------------- rem Library for Logging rem ----------------------------------- set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\log4j.jar rem ----------------------------------- rem Library for Generating a PDF, Excel File. rem OZD25.jar is also used for Excel writing... rem ----------------------------------- set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\crimson.jar set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\parser.jar set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\jaxp.jar set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\OZD25.jar rem ----------------------------------- rem Library for Mailing. rem ----------------------------------- set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\mail.jar set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\activation.jar echo Loading OZScheduler... java -cp %OZSchLib% oz.scheduler.main.ozscheduler %1 %2 :eof FORCS Co., LTD 99
Scheduler.sh # ----------------------------------------------------- # # OZ Scheduler Start-up File # # This batch file written and tested under Windows 2000 # check your path indicate <JAVA_HOME>/bin # # ----------------------------------------------------- OZSCHEDULER_HOME=../ JAVA_HOME=/usr/local/jdk1.3.1_02 if [ "$OZSCHEDULER_HOME"!= "" ]; then OZSchLib=$OZSCHEDULER_HOME/conf OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/bin/OZScheduler25.jar OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/bin/OZServer25.jar OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/bin/OZCommon25.jar # ----------------------------------- # Library for Logging # ----------------------------------- OZSchLib=$OZSchLib$:OZSCHEDULER_HOME/lib/log4j.jar # ----------------------------------- # Library for Generating a PDF, Excel File. # OZD25.jar is also used for Excel writing... # ----------------------------------- OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/lib/crimson.jar OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/lib/parser.jar OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/lib/jaxp.jar OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/lib/OZD25.jar # ----------------------------------- # Library for Mailing. # ----------------------------------- OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/lib/mail.jar OZSchLib=$OZSchLib:$OZSCHEDULER_HOME/lib/activation.jar 100 FORCS Co., LTD
echo Loading OZScheduler... $JAVA_HOME/bin/java -cp $OZSchLib oz.scheduler.main.ozscheduler $1 $2 else echo Unable to determine the value of OZSCHEDULER_HOME. fi commander.bat / commander.sh commander.bat와 commander.sh는오즈스케줄러서버를제어하기위한 commander들을제어하는파일입니다. 자세한사항은본매뉴얼의 Ⅸ. 오즈컨트롤명령어 오즈스케줄러 Shell Command 를참조하시기바랍니다. Commander.bat @echo off rem ----------------------------------------------------- rem rem OZ Scheduler Commander Start-up File rem rem This batch file written and tested under Windows 2000 rem check your path indicate <JAVA_HOME>\bin rem rem ----------------------------------------------------- set OZSCHEDULER_HOME=..\ if not "%OZSCHEDULER_HOME%" == "" goto start echo Unable to determine the value of OZSCHEDULER_HOME. goto eof :start set OZSCLib=%OZSCHEDULER_HOME%\lib\log4j.jar set OZSCLib=%OZSCLib%;%OZSCHEDULER_HOME%\bin\OZServer25.jar set OZSCLib=%OZSCLib%;%OZSCHEDULER_HOME%\bin\OZCommon25.jar set OZSCLib=%OZSCLib%;%OZSCHEDULER_HOME%\bin\OZScheduler25.jar set OZSCLib=%OZSCLib%;%OZSCHEDULER_HOME%\bin\OZschedulerCommander25. jar java -cp %OZSCLib% oz.admin.shell.scheduler.command %1 %2 %3 %4 %5 %6 %7 %8 %9 FORCS Co., LTD 101
Commander.sh # ----------------------------------------------------- # # OZ Scheduler Commander Start-up File # # This batch file written and tested under Windows 2000 # check your path indicate <JAVA_HOME>/bin # # ----------------------------------------------------- OZSCHEDULER_HOME=../ JAVA_HOME=/usr/local/jdk1.3.1_02/bin if [ "$OZSCHEDULER_HOME"!= "" ]; then OZSCLib=$OZSCHEDULER_HOME/lib/log4j.jar OZSCLib=$OZSCLib:$OZSCHEDULER_HOME/bin/OZServer25.jar OZSCLib=$OZSCLib:$OZSCHEDULER_HOME/bin/OZCommon25.jar OZSCLib=$OZSCLib:$OZSCHEDULER_HOME/bin/OZScheduler25.jar OZSCLib=$OZSCLib:$OZSCHEDULER_HOME/bin/OZschedulerCommander25.jar $JAVAHOME/java -cp $OZSCLib oz.admin.shell.scheduler.command $1 $2 $3 $4 $5 $6 $7 $8 $9 else echo Unable to determine the value of OZSCHEDULER_HOME. fi ozscheduler.properties path.oz.scheduler.home=../ path.scheduler.file=%sch_home%/conf/scheduler_server.properties path.scheduler_log.file=%sch_home%/conf/scheduler_server_log.properties - path.oz.scheduler.home : 스케줄러의상대경로를설정합니다. - path.scheduler.file : 스케줄러서버의환경설정파일경로를설정합니다. - path.sheduler_log.file : 스케줄러서버의로그파일저장경로를설정합니다. 102 FORCS Co., LTD
scheduler_server.properties # ErrorNotifyToSender=false SMTPServer=mail.forcs.com SMTPServerPort=25 SchedulerPort=9521 TempRepositoryFilePath=%SCH_HOME%/TempRepository RepositoryFileRootPath=%SCH_HOME%/Repository RepositoryOZZPath=ozz RepositoryExcelPath=excel RepositoryPDFPath=pdf SchedulingInfoFilePath=%SCH_HOME%/ScheduledTask PDFExternalLib=%SCH_HOME%/lib/pdf_java.dll MailFrom=bluetone@forcs.com ExternalProgramFilePath=%SCH_HOME%/External 스케줄링중에러발생시전자메일발송주 ErrorNotifyToSender SMTPServer SMTPServerPort 소로에러를통보할것인지여부를설정합니다. (true/false, 기본값 false) 스케줄링결과를메일로전송하도록설정된경우사용할 SMTP 서버의주소와포트번호입니다. 스케줄러가오즈엔터프라이즈서버와통 SchedulerPort TempRepositoryFilePath RepositoryFileRootPath 신할포트번호입니다. 기본으로 9521번이설정되어있으며, 관리자가적절한값으로변경할수있습니다. 스케줄링결과만들어진파일이임시로저장되는디렉토리경로입니다. 스케줄링결과만들어진파일이저장될디렉토리경로입니다. 스케줄링결과만들어진 ozz 파일이저장 RepositoryOZZPath 될디렉토리경로입니다. (RepositoryFileRootPath에서의상대경로 ) 스케줄링결과만들어진 Excel 파일이 RepositoryExcelPath 저장될디렉토리경로입니다. (RepositoryFileRootPath에서의상대경로 ) FORCS Co., LTD 103
스케줄링결과만들어진 PDF 파일이저장 RepositoryPDFPath 될디렉토리경로입니다. (RepositoryFileRootPath에서의상대경로 ) 스케줄링태스크파일 (ozs) 의저장경로입 SchedulingInfoFilePath 니다. ( 기본값 SchedulerHome/ScheduledTask) 스케줄링결과를 pdf 로만드는데필요한 PDFExternalLib MailFrom pdf 라이브러리 (pdf_java.dll) 파일의경로입니다. 메일발송시보내는사람의전자메일주소입니다. 스케줄된보고서의패러미터값이나 ExternalProgramFilePath export 파일명등을동적으로치환하기위한외부프로그램이등록되는루트경로입니다. scheduler_server_log.properties # log4j.rootcategory=info, F1, C1 log4j.appender.f1=org.apache.log4j.rollingfileappender log4j.appender.f1.file=%sch_home%/logs/ozschedulermainlog.log log4j.appender.f1.maxfilesize=4000kb log4j.appender.f1.maxbackupindex=3 log4j.appender.f1.layout=org.apache.log4j.patternlayout log4j.appender.f1.layout.conversionpattern=%d{iso8601} [%t] %-5p %c %x - %m%n log4j.appender.c1=org.apache.log4j.consoleappender log4j.appender.c1.layout=org.apache.log4j.patternlayout log4j.appender.c1.layout.conversionpattern=[%t] %p %c %x - %m%n ############################################# ResultLog.MaxFileSize=500KB ResultLog.MaxBackupIndex=3 RepositoryExcelPath=excel 오즈스케줄러의로그에대한설정입니다. 기본설정은오즈엔터프라이즈에서의로그설정과동일합니다. 자세한설명은본매뉴얼 Ⅳ. 오즈엔터프라이즈서버설정 log.properties 를참조하시기바랍니다. 104 FORCS Co., LTD
서버구동 오즈스케줄러서버의구동 오즈스케줄러는 scheduler.bat/scheduler.sh를실행하면데몬형태로작동됩니다. 오즈스케줄러의세부설정이나스케줄태스크생성은 commander.bat/ commander.sh를이용하여실시간으로제어할수있습니다. Commander.bat/ Commander.sh에대해서는본매뉴얼의 "Ⅸ. 오즈컨트롤명령어 오즈스케줄러 Shell Command 를참조하시기바랍니다. 오즈스케줄러서버의윈도우서비스등록오즈엔터프라이즈서버에서와같이오즈스케줄러서버도 Windows의서비스로등록할수있습니다. 서비스등록은 OZSchedulerService.exe를이용하여오즈엔터프라이즈서버에서와같은방식으로설정하면됩니다. < 참고 > 오즈서버와스케줄러서버를 NT 서비스로등록한경우이를제거하기위해서는반드시 NT의구성요소서비스에서오즈서버를종료시킨후 ozstop.bat/ozsotp.sh를실행시켜야서비스를제거할수있습니다. FORCS Co., LTD 105
Ⅷ. 오즈엔터프라이즈매니저 설치및환경설정 운영 106 FORCS Co., LTD
설치및환경설정 시스템요구사항 JRE (JAVA Runtime Environment) 1.1.x 이상을지원하는운영체제 오즈엔터프라이즈매니저의설치 오즈엔터프라이즈매니저는제공되는인스톨프로그램 (setup.exe) 으로설치되며, 윈도우용 JRE가함께자동설치됩니다. 오즈엔터프라이즈매니저의파일구조 디렉토리파일설명 %OZ_HOME% ozicon.gif ozlang.properties ozlang_empty.properties ozlang_en.properties ozlang_en_us.properties ozlang_ja_jp.properties ozlang_ko.properties ozlang_ko_kr.properties chartres_ko_kr.xml chartres_empty.xml chartres_en_us.xml chartres _ja_jp.xml chartres _ko_kr.xml ozapp.zip image.zip MouseWheel.dll OZEnterpriseManager.bat 오즈엔터프라이즈서버의아이콘이미지오즈뷰어의언어리소스파일들오즈뷰어의 Chart 관련리소스파일들오즈뷰어클래스라이브러리오즈뷰어의이미지파일휠마우스이용에관한윈도우 dll 파일오즈엔터프라이즈매니저실행파일 FORCS Co., LTD 107
디렉토리파일설명 conf lib works conf.properties ftpconf.properties ftpserver.properties ftpuser.properties server.properties crimson.jar log4j.jar OZcommon25.jar OZEnterpriseManager10.jar OZFTP15.jar OZSCheduler25.jar OZserver25.jar xalan.jar 임시파일저장장소 스케줄러연결정보설정파일 OZ FTP 환경설정파일 OZ FTP 서버연결정보파일 OZ FTP 서버접속시사용할사용자정보서버연결정보저장파일 xml 크림손파서라이브러리파일 Log 사용에대한라이브러리파일오즈공용클래스라이브러리오즈엔터프라이즈매니저메인클래스라이브러리 OZ FTP 메인클래스라이브러리오즈스케줄러메인클래스라이브러리서버메인클래스라이브러리 xml Xerces 파서라이브러리파일 108 FORCS Co., LTD
운영 엔터프라이즈매니저실행 OZEnterpriseManager.bat 을실행시켜엔터프라이즈매니저를구동시킵니다. 서버 ( 서블릿 ) 등록하기새로운오즈서버 ( 서블릿 ) 를등록하고자하는경우콘솔메뉴에서 [ 서버추가 ] 를선택하거나왼쪽의콘솔아이콘을선택하여오른쪽마우스를클릭한후 [ 서버추가 ] 를선택하면새오즈서버 ( 서블릿 ) 를등록할수있는창이뜹니다. 서버명서버타입서버 IP 서버 URL 엔터프라이즈매니저에서는여러개의오즈서버를관리할수있습니다. 서버명은각서버를구분하기위한 Alias명입니다. 데몬형은포트를갖기때문에 TCP_Server를선택하고, 서블릿형은 URL로접근하기때문에 HTTP Server를선택합니다. 서버타입을 TCP_Server로선택했을경우오즈서버가설치되어있는호스트컴퓨터의 IP를설정합니다. 서버타입을 HTTP_Server로선택했을경우서블릿에접근가능한 URL을설정합니다. 웹에서오즈서블릿의메인페이지를호출하는 URL을설정하면됩니다. 예 ) http://www.oz.com/ozservlet FORCS Co., LTD 109
서버포트 Server Type을 TCP_Server로선택했을경우서버가사용하는 TCP 포트를설정합니다. 스케줄러 IP 스케줄러가설치된시스템의 IP를설정합니다. 스케줄러포트 스케줄러가사용하는포트를설정합니다. [ 새서버 ] 의 [ 추가 ] 버튼을클릭하면왼쪽콘솔아이콘아래서버서블릿아이콘이추가됩니다. 서버 ( 서블릿 ) 에접속하기접속할서버 ( 서블릿 ) 를선택하고콘솔메뉴에서 [ 접속 ] 을선택하면선택한서버에접속하기위한 [ 로그인 ] 창이뜹니다. [ 로그인네임 ] 과 [ 암호 ] 를입력합니다. 기본적으로 ID : admin, 암호 : admin으로설정되어있으며로그인후보안메뉴에서암호의변경및다른사용자를추가 / 삭제 / 변경할수있습니다. [ 로그인 ] 창하단에 암호저장 을체크하면이후에해당서버로접속시자동로그인이됩니다. 110 FORCS Co., LTD
오즈서버관리및환경설정엔터프라이즈매니저는등록된오즈서버의상태를모니터링하고각종환경을설정할수있도록합니다. 엔터프라이즈매니저를통해설정된값은실시간으로오즈서버에반영되기때문에오즈서버를재구동할필요가없습니다. 서버관리서버에대한버전정보와트랜잭션모니터링및서버제어를수행합니다. 서버정보현재서버버전정보와모듈별버전정보를확인할수있습니다. FORCS Co., LTD 111
서버상태현재의메모리사용량을확인할수있습니다. 아래의 [ 퍼포먼스 ] 버튼을클릭하면설정한시간단위로메모리의사용량을그래프로보여줍니다. 112 FORCS Co., LTD
서버처리현재서버에서처리되는일련의작업들에대한트랜잭션정보를보여줍니다. 메모리수집서버가자체적으로메모리수집작업을수행합니다. JVM상에서사용하지않은메모리를제거하여사용가능한메모리로바꿔줍니다. 중지해당서버를정상종료합니다. 리포트리포트저장경로설정및리포트별검증 / 조회작업을수행합니다. 리포트설정서버의폼파일저장경로를확인및수정할수있습니다. [ 저장 ] 버튼을클릭하면현재수정된값이서버로전송되어즉시반영됩니다. FORCS Co., LTD 113
리포트리스트서버에등록된보고서폼파일목록과정보를확인할수있습니다. 보고서를실행하여결과를확인하거나불필요한보고서를삭제할수있습니다. 콘솔메뉴의 [ 오즈 FTP연결 ] 을선택하면 FTP를이용하여하위디렉토리를생성하거나폼을업로드할수있습니다. 특정보고서폼을선택한후오른쪽마우스를클릭하면아래의메뉴를사용할수있습니다. 114 FORCS Co., LTD
- 폼보고서폼파일의소스를보여줍니다. - 데이터모듈해당보고서에포함된데이터셋의쿼리문혹은실행문을수행하여 XML 형태로데이터레코드를확인합니다. 패러미터가있을경우패러미터값을지정해주고 [ 확인 ] 버튼을클릭합니다. [ 캐시사용안함 ] 을선택하면서버에캐시된데이터를사용하지않고쿼리문이나실행문을직접실행하여데이터를가져옵니다. FORCS Co., LTD 115
- 뷰어실행엔터프라이즈매니저에내장된오즈뷰어를사용하여결과보고서를보여줍니다. - 삭제폼파일을삭제합니다. - 캐시시간해당보고서의데이터를캐시에저장할시간을설정할수있습니다. 시간단위는초이며최대 1800초까지설정가능합니다. 116 FORCS Co., LTD
캐시서버의캐시매니저설정및캐시된보고서데이터모듈을조회및삭제합니다. 캐시설정 - 캐시매니저사용 : 보고서데이터모듈캐시기능사용여부선택 - 캐시저장경로명 : 디스크캐싱할때데이터모듈파일이저장되는경로 - 기본타임아웃 ( 분 ) : 캐시에존재할기본시간설정만약리포트에별도의캐시타임을설정하게되면리포트에설정된캐시타임을따르게됩니다. - 프리메모리퍼센트 : JVM이사용가능한전체메모리중사용되지않고남아있는메모리의비율을말하며지정한비율이하로프리메모리퍼센트가떨어지면그이후부터는메모리에캐싱하지않고 캐시저장경로명 에설정한위치에파일로저장합니다. FORCS Co., LTD 117
캐시리스트현재캐싱되어있는데이터모듈리스트및정보를보여줍니다. 118 FORCS Co., LTD
스케줄 (Schedule) 스케줄러에의해생성된데이터를운영및관리합니다. 파일경로설정 - 스케줄결과저장경로명 : 스케줄러에의해생성된보고서의데이터모듈파일 (.str) 을오즈서버에서사용할수있도록저장할오즈서버의디렉토리를설정합니다. - 스케줄결과저장경로명 ( 사용자정의경로 ) : 스케줄러에의해생성된보고서의데이터모듈파일 (.sdm) 을사용자가사용할수있도록저장할오즈서버의디렉토리를설정합니다. 스케줄링시 서버데이터모듈파일명 을설정하면해당경로에 sdm 파일이저장되며사용자가이를이용할수있습니다. FORCS Co., LTD 119
스케줄리스트스케줄러에의해생성된데이터목록을보여줍니다. 오른쪽마우스를클릭하여스케줄링목록에서결과를삭제할수있습니다. 사용자스케줄리스트 OZSever_Home/Userscheduledresult 디렉토리아래의데이터모듈파일을보여줍니다. 오른쪽마우스를클릭하여사용자정의파일을스케줄링목록에서삭제하거나새폴더를생성, 삭제할수있습니다. 120 FORCS Co., LTD
커넥션데이터베이스연결정보를설정합니다. 커넥션풀현재서버에서연결하고있는 DB 목록을리스트로보여주며연결정보를추가 / 변경 / 삭제할수있습니다. 새로운커넥션풀추가벤더종류를선택하여 [ 커넥션풀추가 ] 버튼을클릭합니다. 필요한정보를입력하고 [ 추가 ] 버튼을클릭하면데이터베이스연결이완료됩니다. FORCS Co., LTD 121
- 풀 ( 데이터베이스정보와사용자정보 ) 여러개의데이터베이스연결정보를구현하기이름위한 alias명입니다. 타입데이터베이스타입을선택합니다. 주소, 포트, 데이터베이스 IP와포트번호, 데이터베이스이데이터베이스름입니다. Oracle 7.x 한글문제처리를위해사용하는 ijava package를사용할지여부를체크합니다. IJAVA 사용드라이버에서드라이버명과 db url을설정해줍니다. 사용자명, 암호데이터베이스에접근하는사용자정보입니다. 최대접속, 초기접속, 타임아웃등의정보를기접속재합니다. 드라이버명과 URL, 프로퍼티값등의정보를나타냅니다. 드라이버입력한정보에의하여새로운데이터베이스연결정보가추가됩니다. 로그오즈서버로그기록환경설정및서버로그데이터를검증합니다. 로그설정서버의로그환경설정을조회하고파일을보거나수정할수있습니다. 122 FORCS Co., LTD
로그보기로그에남겨진내용을보여줍니다. 스케줄러 스케줄러설정 FORCS Co., LTD 123
스케줄러의기본정보를보여주며수정할수있습니다. 스케줄러포트스케줄러정보파일저장경로명 SMTP 서버주소, SMTP 서버포트전자메일발송주소임시파일저장경로 PDF 외부라이브러리경로익스포트파일루트저장경로 ozz 파일저장경로 Excel 저장경로 PDF 저장경로외부프로그램저장경로관리자에게에러통보 스케줄러가사용할포트번호입니다. ( 기본값 9521) 스케줄링태스크파일 (ozs) 의저장경로입니다. ( 기본값 SchedulerHome/ScheduledTask) 스케줄링결과를메일로전송하도록설정된경우사용할 SMTP 서버의주소와포트번호입니다. 메일발송시보내는사람의전자메일주소입니다. 스케줄링결과만들어진파일이임시로저장되는디렉토리경로입니다. 스케줄링결과를 pdf로만드는데필요한 pdf 라이브러리 (pdf_java.dll) 파일의경로입니다. 스케줄링결과만들어진파일이저장될디렉토리경로입니다. 스케줄링결과만들어진 ozz파일이저장될디렉토리경로입니다. (' 익스포트파일루트저장경로 ' 에서의상대경로 ) 스케줄링결과만들어진 Excel파일이저장될디렉토리경로입니다. (' 익스포트파일루트저장경로 ' 에서의상대경로 ) 스케줄링결과만들어진 PDF파일이저장될디렉토리경로입니다. (' 익스포트파일루트저장경로 ' 에서의상대경로 ) 스케줄된보고서의패러미터값이나 export 파일명등을동적으로치환하기위한외부프로그램이등록되는루트경로입니다. 스케줄링중에러발생시전자메일발송주소로에러를통보할것인지여부를설정합니다. ( 기본값 false) 124 FORCS Co., LTD
태스크생성리포트별스케줄태스크를생성합니다. - 스케줄태스크생성하기스케줄링할폼파일을선택한후오른쪽마우스를클릭하여 [ 태스크생성 ] 메뉴를선택합니다. [ 태스크생성 ] 메뉴를클릭하면스케줄링정보설정창이뜹니다. 스케줄링정보설정 기본설정 스케줄러엑셀 파일명 스케줄링결과만들어질 excel 파일명 ( 기본적으로 ' 스케줄러설정 ' 시설정한 ' 익스포트파일루트저장경로 '/'Excel저장경로' 에해당이름의 excel 파일이저장되고절대경로는사용할수없습니다.) 정렬 excel로저장시정렬형태를지정합스타일니다. (crosstabstyle/liststyle) excel로저장시페이지열마다별도의 sheet에저장할지또는각페이지매치마다별도의 sheet로저장할지를지모드정합니다. (columnpersheet/pagepersheet) FORCS Co., LTD 125
매치서브모드이미지데이터저장모드시작제거라인 excel 보고서가 paperpersheet인경우지장순서를지정합니다. (rowfirst/columnfirst) excel로저장시이미지저장여부를지정합니다.(full/textonly) excel로저장시첫페이지에서삭제할라인의시작라인을지정합니다. 스케줄러엑셀파일명 - 계속서버데이터모듈파일 종료 제거라인 자동파일 분할 (7M) 첫페이지 제외 컬럼너비 조정 저장폰트 저장폰트 숫자 데이터 저장모드 excel로저장시첫페이지에서삭제할라인의마지막라인을지정합니다. excel 파일사이즈가 7MB보다큰경우파일을자동으로분할할지여부를지정합니다. excel로저장시첫페이지를저장하지않을지여부를지정합니다. excel로저장시컬럼너비를지정합니다. (fix/all/number/label) excel로저장시사용할폰트를지정합니다. excel로저장시사용할폰트를지정합니다. excel로저장시숫자데이터를정수또는문자열로저장할지여부를지정합니다. 스케줄링결과생성된데이터모듈을사용자가직접사용할목적으로오즈서버에저장해둘수있습니다. [ 서버데이터모듈파일명 ] 을설정하면설정한이름으로오즈서버에데이터모듈 (.sdm) 이저장됩니다.( 기본적으로 ' 스케줄 '-' 파일경로설정 '-' 스케줄결과저장경로명 ( 사용자정의경로 )' 에서설정한경로에해당이름의 sdm 파일이저장됩니다. 상대경로를설정해야하며제일앞에. 이들어가서는안됩니다. 예를들어./ 이나../ 은사용할수없습니다. ) 126 FORCS Co., LTD
패러미터생성과스케줄러스케줄링시사용할외부프로그램명 (' 스케줄러설파일경로정 ' 시설정한 ' 외부프로그램저장경로 ') 에서설정동적생성을위한한경로의해당파일을읽어옵니다. 외부프로그램스케줄링결과만들어질 pdf 파일명 ( 기본적으로스케줄러 ' 스케줄러설정 ' 시설정한 ' 익스포트파일루트서버에 pdf 저장경로 '/'PDF저장경로' 에해당이름의 pdf 파일파일저장이저장되고절대경로는사용할수없습니다.) 이와같이설정한내용은각각의변수들과값으로 ScheduledTask 디렉토리에저장됩니다 (ozs 파일의스케줄러태스크생성 ) 전자메일발송스케줄링된결과파일을메일로보낼수있습니다. PDF, XLS, OZZ 파일등스케줄러에의해생성된결과파일들을선택하여첨부할수있습니다. [ 수신자에게에러통보 ] 를선택하면스케줄링중에러가발생할경우메일수신자에게에러를통보합니다. [Include the HTML files] 를선택하면 PDF나 OZZ, XLS과같이 Export한 HTML 파일을첨부하여보낼수있습니다. FORCS Co., LTD 127
[Include HTML in Content] 를선택하면 Export한 HTML 파일내용이메일본문에들어가게되며이옵션을체크할경우에는본문내용은쓸수없습니다. [Use HTML] 을체크하면본문내용의 HTML 태그와함께사용할수있습니다. 리포트패러미터해당리포트의패러미터들을보여주며패러미터값을변경할수있습니다. < 참고 > 보고서스케줄링시보고서패러미터값이나결과파일명을동적으로설정하는방법 오즈스케줄러는보고서패러미터나기타사용자가입력하는항목에사용자정의날짜형식을사용하거나외부프로그램을통해동적으로치환할수있도록시스템변수를제공합니다. 동적으로적용가능한항목은다음과같습니다. 스케줄결과파일명 ( 데이터모듈파일명, 엑셀파일명, PDF 파일명, OZZ 파일명 ) 128 FORCS Co., LTD
리포트패러미터 1. 보고서패러미터또는결과파일을보고서가실행되는시점의날짜로이용하고자할때날짜관련시스템변수를이용할수있습니다. [ 형식 ] $OZ.#D/ 날짜형식 /#D 증감형식 $ $OZ ~ $ : 오즈스케줄러에서제공하는시스템변수를의미합니다. #D/ ~ /#D : 날짜형식을정의하기위한앞뒤구분자를의미합니다. 날짜형식 : 사용자정의날짜형식입니다. 날짜형식에사용되는심벌은오즈서버 [ 서블릿 ] 의로그설정에서사용한심벌과동일합니다. 표1 Date Format을참조하시기바랍니다. 증감형식 : 현재날짜를기준으로일단위로증감시킨날짜입니다. +_n_day (n_day : 정수 ) 표 1 Date Format 서식의미형태예제 G Year designator (Text) AD y Year (Number) 1996 M Month in year (Text 나 Number) d day in month (Number) 10 h hour in am/pm (1~12) (Number) 12 H Hour in day (0~23) (Number) 0 m Minute in hour (Number) 30 s Second in minute (Number) 55 S Millisecond 978 E day in week (Text) D day in year (Number) 189 July & 07 (local 에따라다름. 한국은무조건숫자만됨 ) Tuesday(local 에따라다름, 한국은 ' 목 ') F day of week in month (Number) 2 (2nd Wed in July) w Week in year (Number) 27 FORCS Co., LTD 129
W Week in month (Number) 2 a am/pm marker (Text) PM k hour in day (1~24) (Number) 24 K hour in am/pm(0~11) (Number) 0 z Time zone (Text) Pacific Standard Time ' Escape for text (Delimiter) '' Single quote (Literal) [Example] 현재일을 2002 년 10 월 2 일이라고가정 요구사항 : 보고서의패러미터 (FromDate, ToDate) 의값을현재일 로설정하고자할때 설정항목 스케줄태스크생성의 ' 리포트패러미터 ' FromDate=$OZ.#D/yyyy-MM-dd 00:00:00/#D$ 입력형태 ToDate=$OZ.#D/yyyy-MM-dd 23:59:59/#D$ 결 과 FromDate=2002-10-02 00:00:00 ToDate=2002-10-02 23:59:59 요구사항 : 스케줄결과엑셀파일명을현재일로사용하고자할때 설정항목 스케줄태스크생성의 ' 기본설정-스케줄러엑셀파일명 ' 입력형태 $OZ.#D/yyyy-MM-dd/#D$.xls 결 과 2002-10-02.xls 요구사항 : 스케줄결과데이터모듈파일명에현재날짜를넣어사 용하고자할때 설정항목 스케줄태스크생성의 ' 기본설정-서버데이터모듈파일명 ' 입력형태 ReportName_$OZ.#D/yyyy-MM-dd/#D$.sdm 결 과 ReportName_2002-10-02.sdm 요구사항 : 스케줄결과 PDF 파일명에현재날짜를기준으로 1일 증가시킨날짜를넣어사용하고자할때 설정항목 스케줄태스크생성의 ' 기본설정-' 스케줄러서버에 pdf 파일저장 입력형태 $OZ.#D/yyyyMMdd/#D+1$.pdf 결 과 20021001.pdf 130 FORCS Co., LTD
2. 외부프로그램을통해보고서패러미터등을동적으로치환하고자할경우스케줄태스크생성의 ' 기본설정-패러미터생성과파일경로동적생성을위한외부프로그램등록 에사용자가작성한프로그램을등록하고해당프로그램은 ' 오즈시스템변수명 = 설정값 ' 형태의문자열을표준출력으로리턴하여야합니다. 오즈시스템변수는다음과같습니다. $OZ.#P_ 패러미터명 : 보고서의해당패러미터값을설정합니다. $OZ.#F_USER : 스케줄결과데이터모듈파일명을설정합니다. $OZ.#F_EX : 스케줄결과엑셀파일명을설정합니다. $OZ.#F_OZZ : 스케줄결과 OZZ 파일명을설정합니다. $OZ.#F_PDF : 스케줄결과 PDF 파일명을설정합니다. [Example] 외부프로그램의표준출력 : $OZ.#F_DM = MyData.sdm $OZ.#F_EX = MyExcel.xls $OZ.#P_FromDate = 2002-10-01 $OZ.#P_ToDate = 2002-10-02 스케줄시간스케줄링시간과주기를설정합니다. FORCS Co., LTD 131
즉시실행 태스크를생성하는동시에스케줄링을실행합니다. 태스크정보는생성되지않습니다. 한번실행설정한시간에단한번만스케줄링실행합니다. 주기적실행 주기적실행 - 계속 일별주별월별하루에한번하루에여러번사용자정의실행 일별주기설정 ( 매월마지막날실행시키려면 '31일마다 ' 로설정 ) 주별주기설정 ( 몇주마다, 특정요일마다스케줄링할지설정 ) 월별주기설정 ( 매월스케줄링할날을특정일별, 특정주, 특정요일또는사용자가특정일설정 ) 예 ) 매월 1일과 5일 20일에스케줄링을하려면 1,5,20) 해당일주어진시간에한번씩실행해당일에주어진시간사이에주어진시간주기로실행해당일주어진시간에실행 ( 여러개의시간을설정할수있음 ) 예 ) AM1시 30분, PM 5시 10분에스케줄링하려면 01:30,17:10 OZZ 저장옵션 OZZ 파일저장옵션입니다. 132 FORCS Co., LTD
스케줄러서버의 ozz 파일저장메모컴포넌트사용보안을위한암호입력 스케줄링결과만들어질 ozz 파일의저장경로입니다. ( 기본적으로 ' 스케줄러설정 ' 시설정한 ' 익스포트파일루트저장경로 '/'ozz 저장경로 ' 에해당이름의 ozz 파일이저장되고절대경로는사용할수없습니다.) 스케줄링에의해만들어진 ozz 파일에메모컴포넌트추가가가능하게할것인지여부를설정합니다. ozz 파일 open시보안을위해암호를설정합니다. HTML 저장옵션 HTML 파일저장옵션입니다. HTML 저장 파일명 이미지저장경로 스케줄링결과만들어질 HTML 파일의저장경로입니다. ( 기본적으로 스케줄러설정 시설정한 익스포트파일루트 / HTML 저장경로 에해당이름의 HTML 파일이저장되고절대경로는사용할수없습니다.) HTML에서사용되는이미지의저장경로를설정합니다. ( 여기서의이미지파일은 이미지컴포넌트 로부터생성된이미지파일입니다.) FORCS Co., LTD 133
여러 HTML로저장페이지간공백높이 / 페이지간공백넓이 HTML 저장시페이지별로저장할것인지여부를설정합니다. 보고서전체를하나의 HTML 페이지로저장할때페이지간의높이와넓이를설정합니다. 태스크수정현재생성된태스크의정보를보여줍니다. 변경 스케줄링정보를수정할수있습니다. 삭제 스케줄링정보를삭제할수있습니다. 태스크결과 실행완료된태스크의스케줄결과를로그에저장된정보를통해확인할수있습니다. 중지 실행중인태스크를중지시킬수있습니다. 134 FORCS Co., LTD
태스크결과실행완료된태스크의스케줄결과를보여주며원하는기간과태스크 ID를설정하면해당하는스케줄결과를보여줍니다. [ 결과목록 ] 을선택한후오른쪽마우스를클릭하여 [ 에러보기 ] 를선택하면상세에러메시지를확인할수있습니다 익스포트파일 스케줄러설정 에서설정한 익스포트파일루트저장경로 아래의파일과폴더를보여줍니다. FORCS Co., LTD 135
외부프로그램 스케줄러설정, 외부프로그램저장경로 아래의파일과폴더를보여줍니다. 중지스케줄러를중지시킬수있습니다. 보안기본적으로 admin 계정이설정되어있습니다. 사용자 - 새사용자만들기 [ 보안 ] [ 사용자 ] 에서오른쪽마우스를클릭하여 [ 사용자 ] 메뉴를선택합니다. [ 사용자생성 ] 창에서 [ 사용자이름 ] 과 [ 암호 ] 를설정해주면새사용자가생성됩니다. 타입은 [ 일반사용자 ] 와 [ 관리자 ] 가있습니다. 관리자는모든그룹을엑세스할수있습니다. 136 FORCS Co., LTD