1 En… · Web viewozcntrl.bat/ozcntrl.sh에서는 JRE 설치 디렉토리 및 서버를 운영하기 위한 각종 클래스 ... 설정 변경, ... $OZ.#EXF_WORD :

A Leader of Enterprise e-Business Solution

목 차

Ⅰ. 시작하기 전에 ………………………………………………………………………………… 3

본 매뉴얼의 목적 …………………………………………..…………………………………… 4

본 매뉴얼 구성 ………………………………………………..…………………………..……. 4

매뉴얼 로드맵 …………………………..………………………..…………………..…………… 5

Ⅱ. 오즈 엔터프라이즈 서버 소개 …………………………..……….…………………… 7

오즈 엔터프라이즈 서버 개요 ………………….………………..………………..……………. 8

오즈 엔터프라이즈 서버 특징……….………………………………………………………….. 8

오즈 엔터프라이즈 서버 아키텍처 …………………………………….……..………………. 10

Ⅲ. 오즈 엔터프라이즈 서버 실행 …………………………………….…….……………. 11

시스템 요구사항 ………………………..……………………………………………………. 12

오즈 엔터프라이즈 서버 설정 ………………………………….…………….……………… 13

오즈 엔터프라이즈 서버 데몬 실행 ……………….……………………..……………….... 24

Windows에서 오즈 엔터프라이즈 서버 서비스 등록하기 ……………………………….. 25

서블릿 타입으로 오즈 엔터프라이즈 서버 실행 ………….….……………..………..…… 30

Ⅳ. 오즈 엔터프라이즈 서버 설정 ……………..…………………………………….…... 31

ozserver.properties …………….…………….………………………………………………….. 32

xml.properties ………………………………………………….….………….……………….... 33

log.properties …………………………………….…………………..….………..…..………….. 35

db.properties ……………………………………….………………….….…………..………… 41

cachemngr.properties …………………………………………..…….………………….…….. 47

monitor.properties ……………………………….………….…………….…………………….. 49

uslmngr.properties …………………………………………...…………………………………. 55

FORCS Co., LTD 1

repository.properties ………………………………………...…………………………………. 57

spmgr.properties …………………………………………...…………………………………. 59

srmngr.properties …………………………………………...…………………………………. 60

Ⅴ. 오즈 스케줄러 …………………………………………………..…………………… 61

오즈 스케줄러 서버 개요 ……………………………………………………..……………. 62

오즈 스케줄러 아키텍처 ………………………………………………………..…….……… 64

시스템 요구사항 ……………………….……………………….………………………………. 65

오즈 스케줄러 서버의 파일 구성 ……………………..………..……………………..……. 65

오즈 스케줄러 서버 설정 …………………………………………………….……….……… 67

오즈 스케줄러 서버 실행 …………………………………………………………..………… 73

Ⅵ. 오즈 엔터프라이즈 매니저 ……………………………………………….…………… 78

오즈 엔터프라이즈 매니저의 개요 ……………………….………….……..………………. 79

시스템 요구사항 ……………………………………………………….…….…………………. 79

오즈 엔터프라이즈 매니저의 파일 구성 …………………………………..……….………. 80

오즈 엔터프라이즈 매니저 실행 ………………………………….…………………………. 81

오즈 엔터프라이즈 매니저 윈도우 …………………………………………………………. 83

오즈 엔터프라이즈 매니저의 기능 …………………………………..………………………. 84

Ⅶ. 오즈 리파지토리 매니저 …………………………………………………………… 118

오즈 리파지토리 매니저의 개요 ……………………….……………………………………. 119

시스템 요구사항 ……………………………………………………….………………………. 120

오즈 리파지토리 매니저의 파일 구성 ……………………………………………………. 120

오즈 리파지토리 매니저 실행 ……………………………………………………………. 121

오즈 리파지토리 매니저 윈도우 ……………………………………………………………. 122

오즈 리파지토리 매니저의 메뉴 ……………..…………………….………………………. 123

오즈 리파지토리 매니저의 기능 ……………..…………………….………………………. 127

Ⅷ. 오즈 컨트롤 명령어 …………………..………………….……………………………… 157

오즈 엔터프라이즈 서버 Shell Command ………………….……….…….………………. 158

2 FORCS Co., LTD


오즈 스케줄러 Shell Command …………………………………..…….………..…………. 167

FORCS Co., LTD 3

Ⅰ. 시작하기 전에

본 매뉴얼의 목적

본 매뉴얼 구성

매뉴얼 로드맵

본 매뉴얼은 오즈 엔터프라이즈 서버의 모든 구성요소에 대한 정보 제공과 오즈

엔터프라이즈 서버 설정 및 이용에 관한 기술적인 정보를 상세히 설명합니다.

본 매뉴얼의 구성과 각 장의 내용은 다음과 같습니다.

(오즈 엔터프라이즈 서버 관리자 매뉴얼 Ⅰ)

오즈 엔터프라이즈 서버

오즈 엔터프라이즈 서버에 대한 개요, 특성, 기능 및 아키텍처를 설명합니다.

오즈 엔터프라이즈 서버 실행

오즈 엔터프라이즈 서버의 실행 과정을 설명합니다.

오즈 엔터프라이즈 서버 설정

각 서버 환경 설정 파일에 대한 상세한 설명과 예를 보여줍니다.

오즈 스케줄러 오즈 스케줄러의 개요 및 설정과 실행에 관한 전반적인 사항을 설명합니다.

오즈 엔터프라이즈 매니저

오즈 엔터프라이즈 매니저의 환경 설정과 운영에 대해 설명합니다.

오즈 리파지토리 매니저

오즈 리파지토리 매니저의 구성 및 사용자 인터페이스, 사용방법에 대해 자세히

설명합니다.

4 FORCS Co., LTD

본 매뉴얼의 목적

본 매뉴얼 구성


오즈 컨트롤 명령어

오즈 엔터프라이즈 서버, 오즈 스케줄러의 모든 기능을 윈도우의 명령어 프롬프트

창 또는 유닉스의 Shell Command 창에서 컨트롤 할 수 있는 방법에 대해

설명합니다.

(오즈 엔터프라이즈 서버 관리자 매뉴얼 Ⅱ)

서블릿 엔진과의 연동 부분

오즈 엔터프라이즈 서버와 서블릿 엔진과의 연동에 관해 설명합니다.

보고서 개발자와 웹 애플리케이션 개발자, 시스템 관리자가 알아야 할 내용을 전달하기

위해 다음과 같은 매뉴얼을 제공합니다.

구 분 구 성 내 용

Getting Started오즈 소개와 간단한 보고서 작성을 통해 오즈의 개념을

설명합니다.

설치 가이드 오즈 제품을 설치하는 방법에 대해 자세히 설명합니다.

오즈 쿼리 디자이너

사용자 매뉴얼

오즈 쿼리 디자이너를 이용해 데이터 셋 정보를 작성하는

방법을 자세히 설명합니다.

오즈 리포트 디자이너

사용자 레퍼런스오즈 디자이너의 각 컴포넌트를 자세히 설명합니다.

오즈 리포트 디자이너

사용자 매뉴얼

보고서 작성 방법과 디자이너 사용 방법, 작성된 보고서를

웹에 배포하는 방법을 설명합니다.

오즈 리포트

뷰어 매뉴얼

웹에 배포한 보고서가 사용자 애플리케이션과 연동할 수

있도록 다양한 옵션을 설명합니다.

오즈 엔터프라이즈

서버 관리자 매뉴얼

Ⅰ) 서버 관리자가 오즈 서버를 효율적으로 관리할 수 있도록

오즈 서버의 설치 및 관리ᆞ운영 방법을 설명합니다.

Ⅱ) 오즈 엔터프라이즈 서버와 웹 애플리케이션 서버와의

연동 방법을 설명합니다.

FORCS Co., LTD 5

매뉴얼 로드맵

API 활용 매뉴얼

오즈 제품에서 사용하는 서버 API, UDS, USL, 뷰어 API 등

사용자 애플리케이션에서 직접 제어할 수 있는

API(Application Program Interface)에 대해 설명합니다.

에러 메시지 레퍼런스 오즈 제품에서 보여지는 에러 메시지를 자세히 설명합니다.

유틸리티 가이드오즈 제품과 함께 제공되는 각종 유틸리티 프로그램에 대해

자세히 설명합니다.

스크립트 가이드오즈에서 제공하는 스크립트의 문법과 그 활용 방법에 대해

자세히 설명합니다.

업그레이드 가이드오즈 2.5에서 3.0으로 업그레이드 하는 방법에 대해 자세히

설명합니다.

6 FORCS Co., LTD


FORCS Co., LTD 7

Ⅱ. 오즈 엔터프라이즈 서버 소개

오즈 엔터프라이즈 서버 개요

오즈 엔터프라이즈 서버 특징

오즈 엔터프라이즈 서버 아키텍처

오즈 엔터프라이즈 서버는 보고서 폼 관리와 클라이언트의 요청에 따른 보고서 데이터 셋

생성 및 폼과 데이터 셋의 전송을 수행하는 고성능 다중 스레드 서버 엔진입니다.

특징

우수한 이식성과 확장성

• 순수 JAVA/XML 기술로 개발

• JDBC/ODBC를 통한 다양한 데이터베이스와 연동 가능

• JVM (Java Virtual Machine)이 탑재된 모든 운영체제 환경지원

• 다양한 WAS와 연동하는 통합 환경 제공

고성능 서버 아키텍처

• 서버와 클라이언트간 분산처리를 통해 다중 사용자 환경에서 최적의

성능보장

효과적인 서버 운영관리

• 엔터프라이즈 매니저를 통한 one-point 통합 관리

• 실시간 모니터링 및 서버 설정

• 분산 원격 테스트 및 디버깅

리파지토리를 통한 버전 및 권한 관리

보고서 폼 파일, 데이터 정보 파일 등 다양한 아이템의 저장 및 수정에 대한

히스토리와 버전관리, 계층적인 카테고리 관리 및 권한 설정 기능을

제공합니다.

고성능 리포팅 엔진

DB Pooling, 다중 스레드, 스레드 재사용, 보고서별 캐시 설정, 디스크/메모리

혼용 캐시 기능 등 다양한 성능 향상 기법을 도입하여 다수 사용자의 동시 접속

환경에서도 최적의 성능을 보장합니다.

8 FORCS Co., LTD

오즈 엔터프라이즈 서버 개요

오즈 엔터프라이즈 서버 특징


실시간/대용량 데이터 처리

데이터 소스로부터 가져온 데이터의 처리 속도 향상을 위해 실시간으로 뷰어로

전송 할 수 있는 동시전송모드(Concurrent Mode)를 지원하며, 대용량 데이터

처리시에 메모리 관리의 효율을 위해 파일 모드를 지원합니다.

유연한 데이터 처리

별도의 CGI 코딩없이 데이터베이스와 연동할 수 있으며 Non-DB 데이터

연동을 위해 UDS(User Data Store) 인터페이스를 제공합니다.

데이터 보안 및 인증

보고서의 데이터를 담고 있는 데이터 모듈 파일의 위/변조 방지 기능이 있어,

공문서나 인증서 등의 서비스에 유용하게 적용될 수 있습니다. 또한 사용자 및

그룹별로 계층적 보안을 적용하고 인가된 사용자만이 접근 가능하도록 통제할

수 있어 보고서 보안 유지에 편리합니다.

FORCS Co., LTD 9

Note

오즈는 JDBC 및 ODBC를 통한 데이터베이스 외에도 Non-DB 데이터 소스 연동을 위해 UDS(User Data Store) 인터페이스를 제공합니다. UDS는 일반 텍스트 데이터는 물론 XML, EJB, Legacy Data 등 사용자 애플리케이션에서 넘겨주는 어떠한 형태의 데이터도 오즈의 데이터로 활용할 수 있어 기업의 모든 데이터 소스를 지원하면서 일관성 있게 보고서를 작성할 수 있게 합니다.

㈜UDS(User Data Store)

UDS UDS를 이용한 Non-database Source의 이용

JDBC/ODBC JDBC/ODBC를 이용하여 데이터베이스에 연결

Document Manager 보고서 관리 수행

Data Manager 보고서의 데이터 모듈 생성 및 관리 수행

Monitor 서버 프로세스의 운영상황을 모니터링하여 파일로 로깅

User Access Manager 사용자별/그룹별 보고서에 대한 접근 관리 수행

Schedule Manager오즈 스케줄러 서버가 생성한 결과 데이터 셋에 대한

관리 수행

Cache Manager자주 요청하는 결과 데이터 셋이나 보고서 폼 등의 캐싱

처리

Log Manager오즈 서버의 실행 결과를 로깅하고, 옵션에 따라 NT

Event와 Unix Syslog로 전송

Repository Manager 리파지토리 관련 서비스 수행

10 FORCS Co., LTD

오즈 엔터프라이즈 서버 아키텍처


FORCS Co., LTD 11

Ⅲ. 오즈 엔터프라이즈 서버 실행

시스템 요구사항


오즈 엔터프라이즈 서버 데몬 실행

Windows에서 오즈 엔터프라이즈 서버 서비스 등록하기

서블릿 타입으로 오즈 엔터프라이즈 서버 실행

오즈 엔터프라이즈 서버 운영을 위한 시스템 요구 사항

플랫폼

JRE(Java Runtime Environment) 1.1.X 이상을 지원하는 모든

운영체제 - Windows NT/2000, Linux, HP-UX, Solaris, AIX,

Unixware, Mainframe 등

Web Server

Web Server

Microsoft IIS(Internet Information Server),

Apache, NCSE, CERN, Netscape Enterprise

Server 등 모든 웹 서버

Web Application

Server

WebLogic, WebSphere, Oracle iAS(Internet

Application Server), Fujitsu Interstage, NEC

WebOTX등 J2EE를 지원하는 모든 WAS

DBMSOracle, Informix, Sybase, MS-SQL Server, DB2 등 ODBC/JDBC를

지원하는 모든 상용 DBMS

※ JRE 버전에 따라 다음과 같은 제약사항이 있습니다.▪ JRE 1.1.X : JDBC 1.0 스펙에 따라 BLOB, CLOB Type은 지원되지 않

으며, XML-DTD Store 및 JRE 1.2 이상을 지원하는 JDBC 드라이버는 사용할 수 없습니다. JDBC 버전은 1.0이며, 오즈가 지원하는 JDBC 버전은 1.0입니다.

▪ JRE 1.2. ~ JRE 1.3.X : 일반적인 오즈의 실행 환경이며, 1.1.X용

JDBC 드라이버도 대부분 사용할 수 있습니다. JDBC 버전은 2.0이며, 오즈가 지원하는 JDBC 버전은 2.0입니다.

▪ JRE 1.4 : JRE 1.4 전용 API(URL Type, Update Methods)는 사용하지

않습니다. JRE 1.4용으로 제작된 JDBC 드라이버의 사용을 권

장하며, 하위 버전의 JDBC 드라이버 이용시 문제가 발생할

수 있습니다. JDBC 버전은 3.0이며, 오즈가 지원하는 JDBC 버전은 2.0입니다.

12 FORCS Co., LTD



License 파일 설치

오즈 서버 라이센스는 ozlicense.xml 파일 형태로 발급되며 이 파일을 오즈

엔터프라이즈 서버의 [License] 디렉토리에 복사함으로써 설치됩니다. 각 License

파일에는 License 유효 기간, 서버 IP 주소, 운영체제 종류가 들어 있습니다. 오즈

엔터프라이즈 서버를 운영하던 중 IP 주소 및 운영체제가 변경되는 경우 License

파일을 재발급 받아야 합니다.

ozcntrl.bat / ozcntrl.shozcntrl.bat/ozcntrl.sh에서는 JRE 설치 디렉토리 및 서버를 운영하기 위한 각종

클래스 라이브러리를 설정합니다. 기본적으로 Windows 환경의 경우 자체 JVM을

내장하여 이를 이용하고 있으며, UNIX 환경의 경우 ozcntrl.sh의 JRE Path를 직접

설정해야 합니다.

※ 'MAX_MEMORY/MIN_MEMORY'는 자바의 옵션으로 JVM이 사용할 수 있는

최대/최소 메모리를 설정하며, 그 외 기타 자바 옵션은 JAVA_OPTION에서

설정할 수 있습니다. 해당 운영체제의 JAVA_OPTION에서 자세한 옵션 사항을

참조하여 서버 성능에 도움이 되는 옵션 사용을 권장합니다.

ozcntrl.bat 파일

@echo off

rem -----------------------------------------------------

rem

rem OZ Contorl(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.

FORCS Co., LTD 13


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.

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 mega-

byte.)

rem

rem -----------------------------------------------------

rem -----------------------------------

rem Set user-defined variables

rem -----------------------------------

set JAVA_HOME=..\..\JRE

set MAX_MEMORY=256

set MIN_MEMORY=128

set JAVA_OPTION=

set OZSERVER_HOME=..

set USER_CLASSPATH=%OZSERVER_HOME%\uds\

set OZLIBALL=%OZSERVER_HOME%\lib

set OZLIB=%OZLIBALL%\ozsfw30.jar;%OZSERVER_HOME%\conf\

set OZLIB=%OZLIB%;%OZLIBALL%\servlet.jar

rem -----------------------------------

rem for User Data Set classes

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\ozuds30.jar

rem -----------------------------------

rem Library for Logging

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\log4j.jar

14 FORCS Co., LTD


rem -----------------------------------

rem Library for XML

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\parser.jar

set OZLIB=%OZLIB%;%OZLIBALL%\xerces.jar

set OZLIB=%OZLIB%;%OZLIBALL%\crimson.jar

rem -----------------------------------

rem Library for XML Store

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\dtdparser12.jar

rem -----------------------------------

rem Repository File Sysgtem DB

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\hsqldb.jar

rem -----------------------------------

rem JDBC Driver for Oracle

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\classes12.zip

rem -----------------------------------

rem JDBC Driver for Mysql (3.0.14)

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\mysql.jar

rem -----------------------------------

rem JDBC Driver for Informix

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\ifxjdbc.jar

rem -----------------------------------

rem JDBC Driver for Syabse

FORCS Co., LTD 15

rem -----------------------------------

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

rem -----------------------------------

rem JDBC Driver for IBM DB2

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\db2java.zip

rem -----------------------------------

rem JDBC Driver for Uni-SQL

rem -----------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\unisqljdbc10.jar

rem -----------------------------------

rem USER_CLASSPATH

rem -----------------------------------

set OZLIB=%OZLIB%;%USER_CLASSPATH%

rem -----------------------------------------------------

rem HTTPS/SSL Module

rem -----------------------------------------------------

set OZLIB=%OZLIB%;%OZLIBALL%\jcert.jar

set OZLIB=%OZLIB%;%OZLIBALL%\jnet.jar

set OZLIB=%OZLIB%;%OZLIBALL%\jsse.jar

set JAVA_OPTION=

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

16 FORCS Co., LTD


ozcntrl.sh 파일

#!/bin/sh

#-----------------------------------------------------

#

# OZ Contorl.

#

# 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 mega-byte.)

# MIN_MEMORY - Minimum memory used by OZ Server. (The unit is mega-byte.)

# JAVA_OPTIONS - On some platforms, certain java command-line options are

# recommanded when running OZ Server.

#

#-----------------------------------------------------

# -----------------------------------

# Set user-defined variables

# -----------------------------------

JAVA_HOME=../../jre

USER_CLASSPATH=

MAX_MEMORY=256

MIN_MEMORY=128

JAVA_OPTION=-hotspot

OZSERVER_HOME=..

OZLIB=.:$OZSERVER_HOME/conf

FORCS Co., LTD 17

OZLIB=$OZLIB:$OZSERVER_HOME/lib/ozsfw30.jar

# -----------------------------------

# for User Data Set classes

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/ozuds30.jar

OZLIB=$OZLIB:$OZSERVER_HOME/lib/hsqldb.jar

OZLIB=$OZLIB:$OZSERVER_HOME/lib/servlet.jar

# -----------------------------------

# Library for Logging

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/log4j.jar

# -----------------------------------

# Library for XML

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/parser.jar

OZLIB=$OZLIB:$OZSERVER_HOME/lib/xerces.jar

OZLIB=$OZLIB:$OZSERVER_HOME/lib/crimson.jar

# -----------------------------------

# Library for XML Store

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/dtdparser120.jar

# -----------------------------------

# Library for SAP

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/sapjco.jar

# -----------------------------------

# JDBC Driver for Oracle

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/classes12.zip

18 FORCS Co., LTD


# -----------------------------------

# JDBC Driver for Informix

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/ifxjdbc.jar

# -----------------------------------

# JDBC Driver for Syabse

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/jconn2.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

# -----------------------------------

# HTTPS/SSL Module

# -----------------------------------

OZLIB=$OZLIB:$OZSERVER_HOME/lib/jcert.jar

OZLIB=$OZLIB:$OZSERVER_HOME/lib/jnet.jar

OZLIB=$OZLIB:$OZSERVER_HOME/lib/jsse.jar

# -----------------------------------

# USER CLASSPAATH

# -----------------------------------

if [ "$USER_CLASSPATH" != "" ]; then

OZLIB=$OZLIB:$USER_CLASSPATH

fi

FORCS Co., LTD 19

$JAVA_HOME/bin/java $JAVA_OPTION -cp $OZLIB oz.admin.shell.server.OZAShell

$1 $2 $3 $4 $5 $6 $7 $8 $9

ozcntrl에서는 오즈 서버를 실행하기 위한 가장 기본적인 설정만 하고 있으며

그 외 서버가 사용할 데이터베이스 등 기타 자세한 설정에 대해서는 본

메뉴얼의 "Ⅳ. 오즈 엔터프라이즈 서버 설정"을 참조하시기 바랍니다.

ozcntrl.bat/ozcntrl.sh는 오즈 서버의 실행 및 종료 이외에도 여러가지 오즈의

컨트롤을 가능하게 하는 명령어입니다. ozcntrl.bat/ozcntrl.sh에 대한 자세한

내용은 본 매뉴얼의 “Ⅷ. 오즈 컨트롤 명령어”를 참조하시기 바랍니다.

20 FORCS Co., LTD


오즈 엔터프라이즈 서버 파일 구성

오즈 엔터프라이즈 서버 설치 후 다음과 같은 형태의 디렉토리와 파일들이 시스템에

설치됩니다. UNIX와 Windows 계열에 따른 큰 차이는 없으나 데몬과 서블릿 타입에

따라서는 다른 폴더 구조를 가집니다. Windows용의 경우 오즈 서버가 설치된 상위

디렉토리 아래 JRE라는 디렉토리에 SUN사의 JRE 1.3.1을 탑재하고 있습니다.

오즈 엔터프라이즈 서버 데몬 타입 파일 구조

[디렉토리] [디렉토리]/파일 설명

bin

OZ_HTTPSTATMENT.LOG.

#

HTTP Store를 사용시 생성되는 파일들

#은 생성되는 순서에 따라 번호가

매겨짐

server.ico 오즈 서버 아이콘

chk_version.bat윈도우 (.bat) / 유닉스 (.sh)용

엔터프라이즈

chk_version.sh 오즈 서버 버전 체크 유틸리티

ozcntrl.bat

ozcntrl.sh오즈 엔터프라이즈 서버 Control 파일

OZService.exe 오즈 서비스 실행 파일

ServiceManager.exeNT Service를 등록, 해제, 시작, 정지

시켜주는 유틸리티

OZServer.ini NT Service 실행을 위한 환경 파일

InstallService.bat NT Service에 등록시켜주는 파일

UninstallService.bat등록된 오즈 서버를 NT Service에서

제거시키는 파일

ozstart.bat

ozstart.sh

오즈 엔터프라이즈 서버를 실행 시키는

파일

ozstop.bat

ozstop.sh

오즈 엔터프라이즈 서버를 종료 시키는

파일

cache 캐시된 데이터가 저장되는 장소

cache_ dm 파일로 생성된 데이터 모듈을 저장하는 장소

conf

cachemngr.properties Cache 관련 설정 파일

db.properties DB 연결 설정 파일

log.properties Log 설정 파일

FORCS Co., LTD 21

conf

- 계속

monitor.properties Monitor 설정 파일

ozserver.properties 오즈 서버 기본 설정 파일

repository.properties 리파지토리 설정 파일

spmgr.properties 보안 정책 설정 파일

srmngr.properties Scheduled data 처리 설정 파일

dbtmpl.properties각 DBMS별 기본 JDBC 드라이버

설정 파일

xml.properties XML 파서 설정 properties 파일

uslmngr.properties사용자 보안 설정에 대한 설정

파일(세션, PKI등 관련)

[SAMPLE]

db.properties.db2

db.properties에 대한

각 DBMS별 샘플 파일

db.properties.Informix

db.properties.mssql

db.properties.odbc

db.properties.oracle

db.properties.sybase

db.properties.unisql

db.properties에 대한 각

DBMS별 샘플 파일

db.properties.user

db.properties.weblogic

db.properties.websphere

db.properties.datasource

repository.properties.odbc repository.properties에

대한 샘플 파일repository.properties.oracle

lib classes12.zip Oracle 9i용 JDBC Driver

crimson.jar XML 크림손 파서 라이브러리 파일

db2java.jar DB2 연결을 위한 JDBC Driver

ifxjdbc.jar Infomix 연결을 위한 JDBC Driver

jconn2.jar Sybase 연결을 위한 JDBC Driver

jsee.jar J2EE 라이브러리(HTTPS/SSL 지원을 위해

필요한 라이브러리)

JRE 1.3.X의 경우에만 필요함

jcert.jar

jnet.jar

hsqldb.jar Builtin File Repository를 사용하기 위한 클래스

라이브러리

22 FORCS Co., LTD


ozsfw30.jar 오즈 서버 라이브러리 (서버, 스케줄러)

lib

- 계속

dtdparser120.jar XML Store를 사용하기 위한 클래스 라이브러리

ozuds30.jar오즈 User Data Store를 사용하기 위한 클래스

라이브러리

mysql.jar Mysql용 JDBC 라이브러리

log4j.jar Log 사용에 대한 라이브러리 파일

NTEventLogAppender

.dll

Windows NT에 Event 로그로 남기기 위한 dll

파일

parser.jar XML 파서 라이브러리 파일

unisqljdbc10.jar Unisql 연결을 위한 JDBC Driver

xerces.jar XML Xerces 파서 라이브러리 파일

servlet.jarUSL 사용시 필요한 J2EE 관련 라이브러리

파일

license ozlicense.xml 오즈 엔터프라이즈 서버 라이센스 파일

logsmonitor.log Monitor 로그 파일

server.log 서버 로그 파일

repository_

files

오즈 엔터프라이즈 서버에서 리파지토리 영역으로 사용하는 디렉토리

db_file.data

repository file db를 적용했을 때 생성되는 파일들db_file.properties

db_file.script

query.logrepository file db를 적용했을 때 생성되는 로그

파일

uds UDS 이용의 경우 UDS 관련 라이브러리가 위치하는 폴더

※ 제품에 함께 제공되는 JDBC 드라이버는 해당 데이터베이스 벤더의 일반적인

드라이버로 고객 사이트에 설치된 데이터베이스와 버전 등이 맞지 않을 수

있으므로 고객이 구입했거나 설치된 데이터베이스와 함께 제공된 드라이버로

교체하여 사용하시기 바랍니다.

FORCS Co., LTD 23

오즈 엔터프라이즈 서버 서블릿 타입 파일 구조

[디렉토리] [디렉토리]/파일 설명

bin

chk_version.bat

chk_version.sh버전 체크 유틸리티

ozcntrl.bat

ozcntrl.sh오즈 엔터프라이즈 서버 Control 파일

cache 파일로 캐시된 데이터가 저장되는 장소

cache_ dm 파일로 생성된 데이터 모듈을 파일로 저장하는 장소

conf cachemngr.properties Cache 관련 properties 파일

db.properties DB 설정 properties 파일

log.properties Log 설정 properties 파일

ozserver.priperties 오즈 서버 기본 설정 파일

monitor.properties Monitor 설정 properties 파일

xml.properties XML 파서 설정 properties 파일

repository.properties repository 설정 파일

spmgr.properties 보안 정책 설정 파일

srmngr.properties Scheduled data 처리 설정 파일

dbtmpl.properties각 DBMS별 기본 JDBC 드라이버 설정

파일

uslmngr.properties사용자 보안 설정에 대한 설정 파일(

세션, PKI 등 관련)

[SAMPLE]

db.properties.db2

db.properties.[DBMS-

NAME]

각 DBMS별 세팅 파일

db.properties.Informix

db.properties.mssql

db.properties.odbc

db.properties.oracle

db.properties.Sybase

db.properties.unisql

[SAMPLE] db.properties.user db.properties.[DBMS-

NAME]

각 DBMS별 설정 파일

db.properties.weblogic

db.properties.websphere

24 FORCS Co., LTD


db.properties.datasource

repository.properties.odbc repository.properties 샘플

파일repository.properties.oracle

license ozlicense.xml 오즈 엔터프라이즈 서버 라이센스 파일

logsmonitor.log 모니터 로그 파일

server.log 서버 로그 파일

repository_

files

오즈 엔터프라이즈 서버에서 리파지토리 영역으로 사용하는 디렉토리

db_file.datarepository file db를 적용했을 때 생성되는

파일들db_file.properties

db_file.script

query.logrepository file db를 적용했을 때 생성되는

로그 파일

SilverStrea

m

servlet.java SilverStream (Web Application Server와

연동할 경우 이용할 파일들)servlet.xml

uds UDS 관련 라이브러리 및 샘플파일

WEB-INF web.xml 오즈 서블릿에 URL을 맵핑하는 파일

classes

helloWorld.class오즈 엔터프라이즈 서버 설치시 사용할

수 있는 테스트용 자바 클래스

ozserver.properti

es

오즈 엔터프라이즈 서버 메인

properties 파일

lib classes12.jarzip Oracle 9i용 JDBC Driver

crimson.jar XML 크림손 파서 라이브러리 파일

db2java.jar DB2 연결을 위한 JDBC Driver

ifxjdbc.jar Infomix 연결을 위한 JDBC Driver

jconn2.jar Sybase 연결을 위한 JDBC Driver

hsqldb.jarBuiltin File Repository를 사용하기 위한

클래스 라이브러리

ozsfw30.jar 오즈 서버 라이브러리(서버, 스케줄러)

dtdparser120.jarXML Store를 사용하기 위한 클래스

라이브러리

ozuds30.jar오즈 User Data Store를 사용하기 위한

클래스 라이브러리

mysql.jar Mysql용 JDBC 라이브러리

FORCS Co., LTD 25

log4j.jar Log 사용에 대한 라이브러리 파일

NTEventLogAppe

nder.dll

Windows NT에 Event 로그로 남기기

위한 dll 파일

WEB-INF

- 계속

lib

- 계속

parser.jar XML 파서 라이브러리 파일

unisqljdbc10.jar Unisql 연결을 위한 JDBC Driver

xerces.jar XML Xerces 파서 라이브러리 파일

OZ_HTTPSTATMENT.LOG.

#

HTTP Store를 사용시 생성되는 파일들

#은 생성되는 순서에 따라 번호가

매겨짐

※ lib 디렉토리에 포함되어 있는 각종 JDBC 드라이버는 해당 벤더 및 상용 JDBC 제작사의 JDBC 드라이버를 보유하고 있는 DB의 버전에 맞게 구해서 바꿔

주십시오. 오즈는 제품 내에서 제공하는 JDBC 드라이버가 고객의 DB와의

접속 및 데이터 추출시 문제를 일으키지 않음을 보증하지 않습니다. JDBC 드라이버를 받으실 때는 해당 드라이버가 갖고 있는 여러가지 제약사항 및

알려진 버그를 반드시 숙지해 주십시오. 오즈에서 DB 접속 및 데이터 추출시

발생하는 문제의 대부분은 JDBC 드라이버 측에서 발생한 문제임을

알려드립니다.

오즈 엔터프라이즈 서버 실행

Windows 환경에서 오즈 서버를 실행시키기 위해서는 설치시 생성된 오즈 서버

아이콘을 더블 클릭합니다. 이 아이콘은 오즈 엔터프라이즈 서버의 [bin] 디렉토리

아래에 위치한 ozstart.bat를 실행 시킵니다. 오즈 엔터프라이즈 서버를 종료하기

위해서는 ozstop.bat을 실행합니다.

UNIX 시스템의 경우는 오즈 엔터프라이즈 서버의 [bin] 디렉토리 아래에 있는

ozstart.sh 파일을 이용하여 서버를 실행하고 서버를 종료하기 위해서는 ozstop.sh을

실행합니다.

ozstart.bat / ozstart.shozstart.bat 파일과 ozstart.sh 파일은 각 Windows와 UNIX에서 오즈 엔터프라이즈

26 FORCS Co., LTD

오즈 엔터프라이즈 서버 데몬 실행(독립 실행 서버)


서버를 실행시키는 파일입니다. 이 파일들은 ozcntrl.bat와 ozcntrl.sh를 실행 시키는

역할을 합니다.

FORCS Co., LTD 27

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 서비스 등록은 다음과 같습니다.

28 FORCS Co., LTD

Windows에서 오즈 엔터프라이즈 서버 서비스 등록하기


※ 인스톨러에 의해 디폴트 경로로 오즈 서버가 설치되는 경우 서비스 등록시 경로

를 변경할 필요가 없습니다.

FORCS Co., LTD 29

환경 설정

• JAVA 환경 설정

서버 설치시 디폴트로 설치되는 디렉토리에 Classpath 가 등록되어

반드시 등록되어 있어야 서비스 설치 및 구동이 됩니다.

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\OZServer.ini 파일에서

[JAVA] 항목의 bin 값을 java.exe 파일 위치로 절대 경로를 설정합니다.

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\InstallService.bat 파일과

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\UninstallService.bat 파일

실행시 필요한 jar 파일들의 경로를 절대 경로를 설정합니다.

– OZServer.ini 파일

[JAVA]

BIN=C:\Program Files\Forcs\OZ Product\jre\bin\java.exe

OPTION=-Xms128m -Xmx128m -cp

ARGS=oz.admin.shell.server.OZAShell -start

[CLASS]

;-----------------------------------

; Set user-base variables

;-----------------------------------

C:\Program Files\Forcs\OZ Product\OZServer

C:\Program Files\Forcs\OZ Product\OZServer\bin\conf\

C:\Program Files\Forcs\OZ Product\OZServer\lib\ozsfw30.jar

C:\Program Files\Forcs\OZ Product\OZServer\lib\servlet.jar

;-----------------------------------

; Set user-defined variables

;-----------------------------------

C:\Program Files\Forcs\OZ Product\OZServer\lib\ozuds30.jar

C:\Program Files\Forcs\OZ Product\OZServer\lib\sapjco.jar

C:\Program Files\Forcs\OZ Product\OZServer\lib\hsqldb.jar

C:\Program Files\Forcs\OZ Product\OZServer\lib\cryptix-jce-provider.jar

30 FORCS Co., LTD


C:\Program Files\Forcs\OZ Product\OZServer\lib\cryptix-jce-api.jar

;-----------------------------------

; for User Data Set classes

;-----------------------------------

C:\Program Files\Forcs\OZ Product\OZServer\uds\

C:\Program Files\Forcs\OZ Product\OZServer\uds\sample\

;-----------------------------------

; Library for Logging

;-----------------------------------

C:\Program Files\Forcs\OZ Product\OZServer\lib\log4j.jar

;-----------------------------------

; Library for XML

;-----------------------------------

C:\Program Files\Forcs\OZ Product\OZServer\lib\xerces.jar

C:\Program Files\Forcs\OZ Product\OZServer\lib\jaxp.jar

C:\Program Files\Forcs\OZ Product\OZServer\lib\parser.jar

;-----------------------------------

; JDBC Driver for Oracle

;-----------------------------------

C:\Program Files\Forcs\OZ Product\OZServer\lib\classes12_9i.zip

;-----------------------------------

; JDBC Driver for MSSQL

;-----------------------------------

;-----------------------------------

– InstallService.bat

@echo off

rem ----------------------------------------------------------------------

FORCS Co., LTD 31

rem 서비스 등록 배치파일

rem ----------------------------------------------------------------------

rem %1 - 서비스명 (스페이스가 없어야 함)

rem %2 - 서비스에 등록하는 실행파일

rem - OZ 프로젝트에서는 고정적으로 OZService.exe 를 사용합니다.

rem ----------------------------------------------------------------------

rem ServiceManager.exe %1 /i %2 %1

ServiceManager OZServer /i "C:\Program Files\Forcs\OZ Product\OZServer\

bin\OZService.exe" OZServer

rem ----------------------------------------------------------------------

rem 샘플 예제

rem ----------------------------------------------------------------------

rem InstallService OZServer D:/OZSource/NTService/OZService.exe

rem ----------------------------------------------------------------------

32 FORCS Co., LTD


– UninstallService.bat

@echo off

rem ----------------------------------------------------------------------

rem 서비스 등록 해제 배치파일

rem ----------------------------------------------------------------------


rem ----------------------------------------------------------------------

rem ServiceManager.exe %1 /u

ServiceManager.exe OZServer /u

rem ----------------------------------------------------------------------

rem 샘플 예제

rem ----------------------------------------------------------------------

rem UninstallService OZServer

rem ----------------------------------------------------------------------

• 오즈 서버 환경 설정

{오즈 엔터프라이즈 서버의 홈디렉토리}\conf\ozserver.properties 파일

에서 path.oz.server.home의 값에 오즈 서버의 홈 디렉토리 경로를 절

대 경로로 설정합니다.

서비스 파일 설정

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\InstallService.bat 파일과 {오즈

엔터프라이즈 서버의 홈디렉토리}\bin\UninstallService.bat 파일에 서비스

등록시 필요한 OZService.exe 파일 경로를 절대 경로로 설정합니다.

서비스 등록

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\InstallService.bat을 실행합니다.

서비스 제거

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\UninstallService.bat을 실행합니다.

FORCS Co., LTD 33

다음으로 [제어판] - [관리도구] - [서비스]

로 들어가면 오즈 서버가 등록된 것을 확인할 수 있습니다.

OZServer를 선택하여 서비스 시작 아이콘을 클릭하면 수동으로 서버를

실행할 수 있습니다. 서버 실행 방식을 수동에서 자동으로 바꾸려면 [시작

유형]에서 바꿔주면 됩니다.

오즈 엔터프라이즈 서버를 중지 시키기 위해서는 OZServer 서비스를 선택한 후 [

서비스 중지] 아이콘을 클릭합니다.

※ NT 서비스로 등록하면 로그는 콘솔로는 볼 수 없습니다. (log 파일로 가능)

34 FORCS Co., LTD


로그를 콘솔로 남기려면 NT 서비스로 등록하지 않고 ozstart.bat을 시작

프로그램에 등록시켜 줍니다.

오즈 엔터프라이즈 서버의 서블릿 타입의 경우 서블릿 엔진 또는 WAS에 먼저 등록되어

있어야 합니다. 오즈 엔터프라이즈 서버를 WAS에 등록하는 방법은 “오즈 엔터프라이즈

서버 관리자 매뉴얼Ⅱ - 서블릿 엔진과의 연동부분 – WAS에 대한 일반적인 서블릿 연동

절차”를 참조하시기 바랍니다.

등록이 완료된 후 오즈 서버는 WAS 또는 서블릿 엔진에 의해 자동 실행됩니다.

FORCS Co., LTD 35

서블릿 타입으로 오즈 엔터프라이즈 서버 실행

36 FORCS Co., LTD

Ⅳ. 오즈 엔터프라이즈 서버 설정

ozserver.propertiesxml.propertieslog.propertiesdb.propertiescachemngr.propertiesmonitor.propertiesuslmngr.propertiesrepository.propertiesspmgr.propertiessrmngr.propertiesdbtmpl.properties


오즈는 다양한 환경 파일을 통해 오즈 엔터프라이즈 서버의 운영 환경을 설정 및 제어합니 다.

본 장에서는 각 환경 파일에 대한 위치와 역할, 설정 방법을 소개합니다.

위치

[Daemon] {OZ_HOME}\conf\ozserver.properties

[Servlet] {OZ_HOME}\WEB-INF\classes\ozserver.properties

역할

오즈 서버와 관련된 통신 포트 설정 및 서버가 사용하는 각종 환경 파일에 대한

경로를 지정합니다. 이 파일의 내용이 변경되면 반드시 서버를 재실행해야 합니다.

ozserver.properties#-------------------------------------------

# Main configuration of ozserver/ozservlet

#-------------------------------------------

server.portnumber=8003

path.oz.server.home=c:/program files/forcs/oz server 30

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.connpool.properties.file=%OZ_HOME%/conf/db.properties

path.cache.properties.file=%OZ_HOME%/conf/cachemngr.properties

path.monitor.properties.file=%OZ_HOME%/conf/monitor.properties

path.usl.properties.file=%OZ_HOME%/conf/uslmngr.properties

path.repository.properties.file=%OZ_HOME%/conf/repository.properties

path.securitypolicy.properties.file=%OZ_HOME%/conf/spmgr.properties

path.schedule.properties.file=%OZ_HOME%/conf/srmngr.properties

path.dbinfotemplate.properties.file=%OZ_HOME%/conf/dbtmpl.properties

FORCS Co., LTD 37

ozserver.properties

%OZ_HOME%은 오즈 서버 홈 디렉토리를 가르키는 내부 변수로서

ozserver.properties 파일내의 path.oz.server.home 항목에 지정한 경로를 가지고

있습니다.

38 FORCS Co., LTD


ozserver.properties 파일의 항목과 값에 대한 설명

ozserver.properties 구성내역

변수 설명

server.portnumber

(데몬 타입인 경우만 사용)

서버가 사용할 TCP/IP 포트값을

설정합니 다. 기본값 : 8003

path.oz.server.home

오즈 서버 홈 디렉토리 경로를

설정합니다.

(상대/절대 경로 설정 가능)

path.license.file 라이센스 파일 경로를 설정합니다.

path.xml.properties.file xml.properties 파일 경로를 설정합니다.

path.log.properties.file log.properties 파일 경로를 설정합니다.

path.connpool.properties.file db.properties 파일 경로를 설정합니다.

path.cache.properties.filecachemngr.properties 파일 경로를

설정합니다.

path.monitor.properties.filemonitor.properties 파일 경로를

설정합니다.

path.usl.properties.fileuslmngr.properties 파일 경로를

설정합니다.

path.repository.properties.filerepository.properties 파일 경로를

설정합니다.

path.securitypolicy.properties.filespmgr.properties 파일 경로를

설정합니다.

path.schedule.properties.filesrmngr.properties 파일 경로를

설정합니다.

path.dbinfotemplate.properties.fil

e

dbtmpl.properties 파일 경로를

설정합니다.

FORCS Co., LTD 39

xml.properties

위치

[Daemon/Servlet] {OZ_HOME}\conf\xml.propeties

역할

오즈에서 사용할 xml 파서에 대한 정보를 설정합니다.

40 FORCS Co., LTD


xml.properties-----------------------------------------------

# Configuration of XML parser used by OZ Server

#-----------------------------------------------

#SYSTEM_DEFAULT Setting

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

# SYSTEM_DEFAULT : javax.xml.parsers.DocumentBuilderFactory 에서 넘겨주는 파서를

이용합니다.

변수 설명 값

sax.parser폼을 로드하는데 사용하는 파서를

설정합니다.SUN

CRIMSON

XERCES

SYSTEM_DEFAULTdom.parser

라이센스 파일과 XML 데이터 셋

파일을 읽을 때 사용하는 파서를

설정합니다.

※ 위에서 지정한 파서의 jar 파일이 클래스 패스에 걸려 있어야 합니다. 일반적으로 SUN이 가장 빠른 속도를 보여주기 때문에 SUN을 사용할 것을

권장합니다. 기존의 시스템 가령 WAS에서 CRIMSON을 사용하고 있을 경우, SUN 파서와 충돌이 나는 경우가 종종 있으므로 그럴경우 CRIMSON을

설정합니다. IBM의 JVM을 사용할 경우는 XERCES의 사용을 권장합니다. XML 데이터 셋에서 사용하는 XML 문서에, Entity가 사용되었을 경우, SUN

FORCS Co., LTD 41

파서는 Entity 처리를 정확히 수행하지 못하는 경우가 있으므로 dom.parser의 값으로 CRIMSON이나 XERCES를 사용해야 합니다.

※ SYSTEM_DEFAULT의 경우에는 설치된 JDK의 javax.xml.parsers. DocumentBuilderFactory에서 넘겨주는 파서를 이용합니다.

위치

[Daemon/Servlet] {OZ_HOME}\conf\log.properties

역할

오즈 서버 관련 log의 기록 형태와 방법들을 설정하는 파일입니다. 지원되는 log의

형태에는 CONSOLE(화면), ROLLING FILE, NT Event, UNIX Syslog가 있습니다.

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 로 설정합니다.

# 로그 파일의 크기가 그 이상을 넘어가면 이 파일을 백업한 후

42 FORCS Co., LTD

log.properties


# 새로운 로그 파일로 로그를 뿌립니다.

# 최대 백업 파일의 갯수는 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

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

log.properties 파일의 항목과 값에 대한 설명

FORCS Co., LTD 43

log.properties 파일은 “Set Prioritylog Level”, “Appender CONSOLE”, “Appender

ROLLING_FILE”, “Appender NT Event”, 그리고 “Appender syslog” 등 다섯가지

설정영역으로 구성되어 있습니다.

log.properties 구성내역

항목 설명

Set Prioritylog level

부분priority

log 의 Level 을 설정합니다.

[ERROR] : log level 중 낮은 단계이며,

실제로 에러 상황에서만 에러 메시지

를 log에 기록합니다.

[INFO] : [ERROR] level에서의 log 출력

과 함께 서버의 트랜잭션 정보를 log에

기록합니다.

[DEBUG] : [INFO] 및 [ERROR] level에

서의 log 출력과 함께 기타 전반적인

서버 동작 정보를 log에 기록합니다.

appender

CONSOLE

CONSOLE.Type

Appender 형태를 정의합니다.

콘솔에 로그를 출력할 경우에

해당하며, ‘stdout’을

설정합니다.

CONSOLE.Layout

로깅시 표시되는 형식을

정의합니다. 정의 문자에 따라

다르게 설정되며 각 정의

문자는 표 [Log Layout]을

참조하십시오.

CONSOLE.Async

콘솔에 로그를 출력할 때

버퍼링 여부를 설정합니다.

‘true’일 경우 버퍼링을 하지

않고 바로 콘솔에 출력하고,

‘false’일 경우 버퍼링을 하여

성능을 향상시킬 수 있습니다.

ROLLING_

FILE

ROLLING_FILE.

Type

Rolling File에 로그를 기록할

경우에 해당하며 ‘RollingFile’

을 설정합니다.

44 FORCS Co., LTD


ROLLING_FILE.

Layout

Log 파일의 표시형식을

정의합니다. 표 [Log Layout]을

참조하십시오.

ROLLING_FILE.

File

Log 파일의 경로와 이름을

설정합니다.

ROLLING_FILE.

Append

Log가 생길때 마다 로그 파일에

추가할지를 설정합니다.

true 값이면 추가합니다.

ROLLING_FILE.

MaxBackupIndex

Backup될 로그 파일의 최대

개수를 정의합니다. 최대

파일의 개수가 초과될 시에는

가장 오래된 파일이 삭제되고

새로운 파일이 생깁니다.

ROLLING_FILE.

MaxFilesize

로그 파일의 사이즈를

설정합니다.

ROLLING_FILE.

ImmediateFlush

버퍼에 있는 로그를 바로

기록할 것인지를 설정합니다.

appender

- 계속

NT Event

Log를 Windows NT의 Event로 등록하고자 할 경우 Lib

폴더 밑에 있는 NTEventLog Appender.dll 파일을

WINNT\SYSTEM32 디렉토리로 이동하여야 합니다.

NT_Event.Type

Log를 NT Event로 보낼 경우에

해당하며 ‘NTEvent’를

설정합니다.

NT_Event.Layout로그 표시형식을 정의합니다. 표

[Log Layout]을 참조하십시오.

NT_Event.Thresh

old

Prioritylog level에 따라 이벤트로

보내는 내용을 필터링 할 때

사용합니다. 현재 설정한

Prioritylog level보다 낮은 단계의

값만 지정할 수 있습니다.

ERROR/INFO/DEBUG

syslog SYSLOG.Type Log를 Unix의 Syslog로 보낼

경우에 해당하며 ‘Syslog’를

설정합니다.

FORCS Co., LTD 45

SYSLOG.Layout표시형식을 정의합니다. 표 [Log

Layout]을 참조하십시오.

SYSLOG.Thresh

old

Priorityloy level에 따라 Syslog로

보내는 내용을 필터링 할 때

사용합니다. 현재 설정한

Prioritylog level보다 낮은 단계의

값만 지정할 수 있습니다.

ERROR/INFO/DEBUG

SYSLOG.Syslog

Host

Syslog로 보낼 Unix 호스트의 IP

를 설정합니다.

appender

- 계속

syslog

- 계속

SYSLOG.Facility

Syslog 로 메시지를 보낼 때 해당

메시지가 발생하는 장소를

설정합니다.

‘KERN’, ‘USER’, ‘MAIL’,

‘DAEMON’, ‘AUTH’, ‘SYSLOG’,

‘LPR’, ‘NEWS’, ‘UUCP’, ‘CRON’,

‘AUTHPRIV’, ‘FTP’, ‘LOCAL1’,

‘LOCAL2’, ‘LOCAL3’, ‘LOCAL4’,

‘LOCAL5’, ‘LOCAL6’, ‘LOCAL7’.

SYSLOG.Facility

Printing

true값이면 log Message 에

Facility 이름을 추가합니다.

Log Layout

Character 설명

c

OZServer의 내부 module에 따른 category name을 출력합니다.

Category name은 다단계의 계층을 이루고 있는데 %c{2}처럼 출

력 단계를 지정할 수도 있습니다.

예) %c → oz.server.servlet

%c{1} → servlet

%c{2} → server.servlet

46 FORCS Co., LTD


d

날짜를 출력해 줍니다.

사용자가 패턴을 넣어주는 방식과 log4j 에서 설정해 놓은 패턴

(ABSOLUTE, DATE, ISO8601)을 사용하는 방식이 있습니다. 설정된

패턴 사용을 권장합니다.

[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 ...

m

log message 를 발생시키는 OZServer 내부 로직의 해당 event 에서

event 자체에 할당한 이름을 출력해 줍니다.

예) %d{ISO8601} [%t] %-5p %c{1} %x-% m

→ 2002-08-16 09:56:23,203[Handler 1] INFO MessageHandler

nC 언어의 “\n” 같은 개행 문자입니다. New Line 으로 log 의 커서를

옮겨줍니다.

p

message 의 log level 값(INFO, DEBUG, ERROR 등)을 출력해 줍니

다. 아래 예에서 %p 사이에 들어간 -5 는 5칸의 공간을 차지하고

왼쪽으로 정렬해 출력하라는 의미입니다.예) %d{ISO8601} [%t] % - 5p %c{1} %x-%m

→ 2002-08-16 09:56:23,203[Handler 1] INFO MessageHandler

r

오즈 서버가 시작된 시간을 기준으로 경과된 시간을 millisecond

단위로 연결된 event 에 출력시켜 줍니다.

[Example] [%r]

[2994] main INFO oz.server - OZServer...

t

Thread 이름을 연결된 event 에 출력합니다.

[Example] [%t]

59485 [Thread-2] INFO oz.server - Received a message

%% 기호를 넣고 싶을 때 사용합니다.

[Example] %%

Log 파일 Date Format

Symbol Meaning Presentation Example

G Era designator Text AD

FORCS Co., LTD 47

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 TextPacific 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

48 FORCS Co., LTD


<NT Event에 오즈 서버 로그가 등록된 예>

위치

[Daemon/Servlet] {OZ_HOME}\conf\db.properties

역할

오즈 서버가 사용할 데이터베이스의 연결 정보를 설정하는 파일로 복수개의 연결

정보를 설정할 수 있습니다. 오즈 서버는 서버 성능 향상을 위해 서버

시작시에 DB 연결 Pool을 생성하고, 이를 공유하여 사용할 수 있도록 하는 DB

Connection Pool을 지원합니다.

각 연결정보는 다음과 같은 형태로 설정됩니다.

aliasename.fieldname = value

• aliasename : 여러 개의 데이터베이스 연결정보를 구분하기 위해

데이터베이스별 커넥션별로 사용자가 임의로 부여

• fieldname : 데이터베이스 연결에 필요한 항목명

FORCS Co., LTD 49

db.properties

db.properties 구성내역

항목 설명

vendorDBMS 종류를 설정합니다.

(odbc, oracle, informix, sybase. ms-sql 등으로 설정)

driver JDBC 드라이버의 클래스명입니다.

url JDBC 드라이버의 연결 URL 입니다.

propsJDBC 드라이버의 connection property String 입니다.

(User/Password 설정)

dsn ODBC 의 데이터베이스 소스명입니다.

serverAddress 데이터베이스가 설치된 서버의 주소입니다.

portNo 데이터베이스 통신 포트 번호입니다.

sid Oracle 데이터베이스의 SID 입니다.

serverName 데이터베이스 서버명입니다.

dbName 데이터베이스명입니다.

user 사용자명입니다.

password 사용자 패스워드입니다.

maxconns 오즈 서버가 가질 수 있는 최대 DB Connnection 수입니다.

initconns 오즈 서버의 초기 DB Connection 수입니다.

timeoutMaxconns 를 초과할시 사용중인 Connnection 이 반환되 기

를 기다리는 최대 시간입니다.(단위:초)

sessionQuery

monitor log 에서 사용하는 session id 를 가져오기 위한 쿼

리문을 설정합니다. 자세한 내용은 “monitor.properties” 를

참조하시기 바랍니다.

doConnectionCheck

true 일 경우 ConnectionPool 에서 connection 을 가져올 때

마다 test query 를 수행하고 에러가 생기면 connection 을

새로 만듭니다.

testQueryStringdoConnectionCheck=true 일 경우 수행하는 테스트용 쿼리

입니다.

각 DBMS별 db.properties 설정 예제 파일

Oracle 데이터베이스 예제

oracle_example.vendor=oracle

50 FORCS Co., LTD


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

Informix 데이터베이스 예제

informix_example.vendor=informix

informix_example.serverAddress=127.0.0.1

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.9

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

FORCS Co., LTD 51

odbc_example.user=

odbc_example.password=

odbc_example.maxconns=5

odbc_example.initconns=2

odbc_example.timeout=5

※ NT 서비스로 등록하여 ODBC를 사용할 경우 사용자 DNS에 등록된

ODBC는 인식하지 못하므로 반드시 DNS로 등록해야 합니다.

db2 예제

db2_example.vendor=db2

db2_example.serverAddress=211.116.251.7

db2_example.portNo=1344

db2_example.dbName=db2

db2_example.user=db2admin

db2_example.maxconns=20

db2_example.initconns=5

db2_example.timeout=5

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.2

unisql_example.dbName=demodb

unisql_example.portNo=44300

unisql_example.user=

52 FORCS Co., LTD


unisql_example.password=

unisql_example.maxconns=20

unisql_example.initconns=5

unisql_example.timeout=5

User Custom DBMS 예제

user_example1.vendor=user

user_example1.driver=org.gjt.mm.mysql.driver

user_example1.url=jdbc:mysql://ip/test

user_example1.props=user=oz;password=oz

user_example1.user=oz

user_example1.maxconns=20

user_example1.initconns=5

user_example1.timeout=5

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

Websphere_example.driver=com.forcs.belle.WSJDBCDriver

Websphere_example.url=forcs:websphere:jdbc/

<websphere_data_source_name>:<user>:<pass>

※ com.forcs.belle.WSJDBCDriver는 ㈜포시에스에서 websphere의

Data Source를 사용할 수 있도록 제공하는 JDBC Driver입니다.

weblogic dbpool 예제

weblogic_exmaple.vendor=oracle

weblogic_exmaple.serverAddress=211.116.251.7

weblogic_exmaple.portNo=1521

FORCS Co., LTD 53

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

Data Source JNDI 예제

ds_example.vendor=oracle

ds_example.serverAddress=211.116.251.7

ds_example.portNo=1521

ds_example.sid=forcs815

ds_example.user=scott

ds_example.password=tiger

ds_example.maxconns=5

ds_example.initconns=0

ds_example.timeout=5

#

# Set JDBC Driver using JNDI.

54 FORCS Co., LTD


# com.forcs.jdbc.JNDIJDBCDriver is provided by FORCS

# in order to use DataSource.

#

ds_example.driver=com.forcs.jdbc.JNDIJDBCDriver

#

# URL Naming Rule

# forcs:<jndi_context_factory_name>:<user>:<password>:<jndi_source_name>

# forcs:<jndi_context_factory_name>:<jndi_source_name>

#

# DataSource of WebLogic

ds_example.url=forcs:weblogic.jndi.WLInitialContextFactory:<DataSource Name>

# DataSource of WebSphere

ds_example.url=forcs:com.ibm.websphere.naming.WsnInitialContextFactory:<DataSo

urce Name>

# DataSource of Jeus

ds_example.url=forcs:jeus.jndi.JEUSContextFactory:<DataSource Name>

# DataSource of iPlanet

# Notice : DataSource Name include "jdbc/" in case of iPlanet

# ex) jdbc/ecfcDS

ds_example.url=forcs:com.netscape.server.jndi.RootContextFactory::<DataSource

Name>

# DataSource of JRUN

ds_example.url=forcs:jrun.naming.JRunContextFactory:<DataSource Name>

FORCS Co., LTD 55

cachemngr.properties

위치

[Daemon/Servlet] {OZ_HOME}\conf\cachemngr.propeties

역할

캐시 매니저와 관련된 정보를 설정합니다. 동시 사용자가 많은 경우 설정된 시간

동안 데이터 모듈을 메모리에 저장하여 연속적으로 같은 내용의 보고서 요청시 캐시

안에 있는 데이터 모듈을 리턴하게 됩니다.

cachemngr.properties###

### Configuraion of Cache Manager

### Last Modified : Tue Jul 29 13:31:39 GMT+09:00 2003

###

CACHE_FILE_PATH = %OZ_HOME%/cache/

DM_CACHE_FILE_PATH = %OZ_HOME%/dm_cache/

repository.active=true

repository.memoryCacheValidTime=1200

repository.diskCacheValidTime=0

repository.freeMemoryPercentage=0

datamodule.active=true

datamodule.memoryCacheValidTime=1200

datamodule.diskCacheValidTime=0

datamodule.freeMemoryPercentage=0

56 FORCS Co., LTD


cachemngr.properties 구성내역

항목 설명

CACHE_FILE_PATH리파지토리로 설정되는 캐시 대상 저장 경로 를

설정합니다.

DM_CACHE_FILE_PATH데이터 모듈로 설정되는 캐시 대상 저장 경로 를

설정합니다.

/대상/.active‘true/false’ 값을 가지며 캐시 사용 여부를

설정합니다.

/대상/.memoryCacheValidTime메모리에 캐시를 저장할 때 보존하는 시간을

설정합니다.

/대상/.freeMemoryPercentage메모리 용량이 지정한 수치의 퍼센트 보다

적으면 디스크에 캐싱합니다.

/대상/.diskCacheValidTime디스크에 캐시를 보존하는 시간(단위:초)를

설정합니다.

※ 위의 cachemngr.properties의 기본 설정은 Repository와 Data Module 전체에 대한 캐시 설정입니다.

※ /대상/은 다음과 같이 설정합니다.① Repository 리파지토리에 저장된 아이템 파일 요청시 아이템 파일 자체를

캐싱합니다.대상정의 : Repository.[카테고리명].[아이템명]

([카테고리명], [아이템명]은 생략 가능)리파지토리의 캐시는 3단계(리파지토리 전체, 특정 카테고리, 특정아이템)로 지정할 수가 있습니다.Ex) repository.active = true repository.[/sales/국내].active = true repository.[/sales/해외].[po.ozr].active = true

② Data Module 보고서 요청시 데이터 모듈을 캐싱합니다.대상정의 : datamodule.report.[카테고리명].[ODI명].[패러미터=값]

FORCS Co., LTD 57

(각 단계-.로 구분-별로 생략 가능합니다.)ex) datamodule.active = true datamodule.report.[/sales].active = true datamodule.report.[/sales/국내].[po.odi].active = true

datamodule.report.[/sales/해외].[po.odi]. [Product=A001].active = true

* 카테고리명, 아이템, ODI명 등은 ‘[ ]’안에 명시합니다.

위치

[Daemon/Servlet] {OZ_HOME}\conf\monitor.properties

역할

오즈 서버 트랜잭션 관련 로그 정보 설정 파일입니다.

monitor.properties#-------------------------------------------

# configuraion of OZ Trasaction Monotior log

#-------------------------------------------

#

# OZ 3.0 에서는 트랜잭션에 관한 통계정보를 로그로 남길 수 있는 기능을 제공합니다.

# 이 파일은 그에 대한 설정들을 지정합니다.

#

#

# Whether log or not

#

MONITOR.Active=true

MONITOR.File=%OZ_HOME%/logs/monitor.log

58 FORCS Co., LTD

monitor.properties


MONITOR.MaxBackupIndex=5

MONITOR.MaxFileSize=1MB

MONITOR.ImmediateFlush=true

monitor.properties 구성내역

항목 설명

File Log 파일의 경로와 이름을 설정합니다.

MaxBackuplndex

Backup될 로그 파일의 최대 개수를 정의합니다. 최대 파일의

개수가 초과될시에는 가장 오래된 파일이 삭제되고 새로운

파일이 생깁니다.

MaxFileSize 로그 파일의 사이즈를 설정합니다.

ImmediateFlush 버퍼에 있는 로그를 바로 기록할 것인지를 설정합니다.

파일 포맷 구성내역

오즈 서버의 모든 서비스의 트랜잭션 정보를 csv 포맷으로 저장하여 따로

리포팅 할 수 있으며 탭 형식으로 구분됩니다.

파일 포맷은 다음과 같습니다.

MARK THR_ID TIME F_MEM T_MEM S_CODE S_STATUS S_PARAMS C_IP DB_SS E_TIME

항목 설명 값

MARK 서비스 시작 및 종료를 표시합니다.문자열

start, end

THR_ID 서비스 스레드 ID입니다. 숫자(int)

TIME 서비스 시작과 종료시간을 표시합니다.

1970년 1월 1일 0시에서

Millisecond

숫자(long), 숫자(int)

F_MEM 사용 가능한 메모리량 입니다. 단위 : byte

T_MEM 전체 JVM 메모리량 입니다. 단위 : byte

S_CODE

서비스 구분 코드를 표시합니다. 서비스

구분 코드는 아래의【서비스 코드】를


숫자(int)

S_STATUS 상태 코드를 표시합니다.성공 : 9001

실패 : 9002

FORCS Co., LTD 59

S_PARAMS클라이언트에서 서비스를 요청하면서

넘겨주는 패러미터입니다.문자열

C_IP서비스를 요청한 클라이언트의 IP

입니다.문자열

DB_SS DBMS 세션 ID입니다. 문자열

E_TIME 처리하는데 걸리는 시간입니다.

1970년 1월 1일 0시에서

Millisecond

숫자(long), 숫자(int)

※ session Id를 얻는 쿼리가 존재하는 모든 DB는 db.properties의

<alias>.sessionQuery에 세션 ID를 달리 등록해야 합니다. 쿼리

설정이 없을 경우 session ID가 공백문자로 로깅됩니다. sessionQuery 예제는 다음과 같습니다.

alias.sessionQuery = "[DB 별 Query]"

<infomix>

SELECT DBINFO(\"sessionid\") FROM SysTables WHERE TabID = 1

<mssql>

select @@spid

<oracle>

SELECT sid FROM V$SESSION WHERE audsid = userenv('sessionid')

<sybase>

select @@spid

【서비스 구분 코드】

서비스 구분 코드는 클라이언트의 모든 내부 요청을 구분하기 위한

코드이며, 새로운 서비스는 지속적으로 추가될 수 있습니다.// Repository 관련

CREATE USER = 100;

DELETE USER = 101;

CHECK USER PWD = 102;

60 FORCS Co., LTD


UPDATE USER PWD = 103;

DISABLE USER LOGIN = 104;

ENABLE USER LOGIN = 105;

ISENABLE USER LOGIN = 106;

UPDATE USER DESCRIPTION = 107;

GET USER DESCRIPTION = 108;

GET GROUPID USER = 109;

GET USERID NAME = 110;

UPDATE GROUPID USER = 111;

GET USER LIST = 112;

CREATE GROUP = 113;

DELETE GROUP = 114;

UPDATE USER GROUPADMIN = 115;

IS USER GROUPADMIN = 116;

UPDATE UPPER GROUPID = 117;

GET USER LIST GROUP = 118;

GET GROUP LIST GROUP = 119;

CREATE ITEM = 120;

DELETE ITEM = 121;

GET ITEM = 122;

GET CATEGORYID ITEM = 123;

GET GROUPID ITEM = 124;

UPDATE CATEGORYID ITEM = 125;

UPDATE GROUPID ITEM = 126;

GET ITEM LIST = 127;

CREATE CATEGORY = 128;

DELETE CATEGORY = 129;

UPDATE UPPER CATEGORYID = 130;

GET ITEM LIST CATEGORY = 131;

GET CATEGORY LIST CATEGORY = 132;

UPDATE ITEM USER AUTH = 133;

UPDATE ITEM GROUP AUTH = 134;

GET USER AUTH ITEM = 135 ;

GET GROU AUTH ITEM = 136;

GET ITEM LIST AUTH USER = 137;

FORCS Co., LTD 61

GET ITEM LIST AUTH GROUP = 138;

GET USER LIST AUTH ITEM = 139;

GET GROUP LIST AUTH ITEM = 140;

GET ITEMID = 141;

GET ITEM DATAINFO = 142;

UPDATE USERNAME =143;

UPDATE GROUPNAME = 144;

UPDATE ITEMNAME = 145;

GET ITEMPATH = 146;

GET DIRECTITEM = 147;

UPDATE CATEGORY USERAUTH = 148;

UPDATE CATEGORY GROUPAUTH =149;

GET USERAUTH CATEGORY = 150;

GET GROUPAUTH CATEGORY = 151;

GET CATEGORYLIST USERAUTH = 152;

GET CATEGORYLIST GROUPAUTH = 153;

GET USERLISTAUTH CATEGORY = 154;

GET GROUPLISTAUTH CATEGORY = 155;

UPDATE LOGINDEFAULT = 156;

UPDATE CATEGORYNAME = 157;

CREATE ITEMINDEX = 158;

DELETE ITEMINDEX = 159;

GET ITEMINDEX LIST = 160;

FINDE ITEM ITEMINDEX = 161;

UPDATE ITEM FILE = 162;

CHECK OUT ITEM = 163;

CHECK IN ITEM = 164;

ROLLBACK ITEM = 165;

UNDO CHECK OUT ITEM = 166;

GET ITEM BYVERSION = 167;

GET HISTORY LIST = 168;

CLEAR HISTORY = 169;

CHECK OUT USER = 170;

62 FORCS Co., LTD


GET CATEGORYINFO = 171;

GET ITEMINFO = 172;

GET USERNAME BYID = 173;

HAS SPECIFIC ITEM = 174;

GET ITEMCOUNT IN CATEGORY = 175;

LOGIN TO SERVER = 176;

LOGIN TO SERVER FROM SCHEDULER = 177;

GET ODI LIST = 178;

GET CATEGORYID = 179;

GET ITEMID WITH PATH = 180;

UPDATE DIRECT ITEM FILE = 181;

GET USERINFO = 182;

UPDATE ITEM DESCRIPTION = 183;

GET GROUPINFO = 184;

CREATE CATEGORY WITH PATH = 185;

CREATE ITEM WITH NAME = 186;

GET DIRECT ITEMS = 187;

LOGIN USER = 188;

LOGOUT USER= 189;

ISLOGIN USER = 190;

GET ITEMLIST WITH PERMISSION USER = 191;

GET CATEGORYLIST WITH PERMISSION USER = 192;

GET ITEMLIST WITH PERMISSION GROUP = 193;

GET CATEGORYLIST WITH PERMISSION GROUP = 194;

GET CATEGORYLIST OVER VIEW IN ROOT = 195;

GET DIRECT ITEM COMPRESSED = 196;

GET ITEM LIST CATEGORY NAME = 197;

GET ITEMLIST WITH PERMISSION USER CNAME = 198;

GET ITEMLIST WITH PERMISSION GROUP CNAME = 199;

// Datamodule 관련

GET DATAMODULE = 380;

GET DEFAULT PARAMETER = 381;

FORCS Co., LTD 63

GET USDM = 382;

GET APPLICATION DM = 383;

// Connection Pool API 관련

GET POOL INFO = 400;

GET POOL STATUS LIST = 401;

GET POOL INFO LIST = 402;

ADD POOL = 403 ;

REMOVE POOL = 404 ;

SAVE = 405 ;

// Log 관련 API

GET CONFIG = 406 ;

CONFIGURE PROPERTY = 407 ;

CONFIGURE STRING = 408 ;

GET FILE APPENDER FILE = 409 ;

SET PRIORITY = 410 ;

// Server Info 관련 API

GET VERSIONS = 411;

GARBAGE COLLECT = 412;

GET MEMORYINFO = 413;

GET HANDLER COUNT = 414;

GET MEMORY STATUS = 415;

GET CUMULATED COUNT = 416;

GET CUMULATED TIMER = 417;

GET DYNAMIC INFOMATION = 418;

DOWN MONITOR LOG = 419;

// Cache 관련 API

GET CACHE CONFIG = 420;

SET CACHE CONFIG = 421;

LOGAGENT TEST = 422;

GET REALTIME LOG = 423;

GET REALTIME MONITOR LOG = 424;

64 FORCS Co., LTD


DELETE CACHE DATA = 1100;

// STOP

SERVER STOP = 500;

SERVER RESTART = 501;

// Application DataModule

GET DATAMODULE APP = 520;

// Scheduler 관련 API

GET SCHEDULED RESULT LIST = 600 ;

REMOVE SCHEDULED RESULT = 601 ;

REMOVE SCHEDULED RESULT LIST = 602 ;

SET USDM = 603;

// Repository 설정 관련 API

GET REPOSITORY CONFIG = 700;

SET REPOSITORY CONFIG = 701;

RELOAD REPOSITORY = 702;

// DM Version 가져오기

GET DM VERSION = 800;

// USL 가져오기

GET USL = 900;

USE USL = 901;

위치

[Daemon/Servlet] {OZ_HOME}\conf\uslmngr.properties

역할

FORCS Co., LTD 65

uslmngr.properties

User Security Logic으로써 서버와 통신하는 클라이언트 프로그램과 서버에

암호화를 설정합니다. 암호화는 카테고리별, 아이템별로 세부적으로 적용할 수

있도록 되어 있습니다.

uslmngr.properties 파일

# oz3.0 USL configuration

#

# set whether use user security logic or not globaly

#

UseUserSecurityLogicVer30 = true

#

#set USL class name for each category.

#

#

# for all category (root category)

#

#category.[/]_SERVER=MyPackage.MyUSLServerClassName

#category.[/]_CLIENT=MyPackage.MyUSLClientClassName

category.[/]_SERVER=oz.usl.OZUSLServerSample

category.[/]_CLIENT=oz.usl.OZUSLCLIENT

#

# for a specific category & it's sub-categories

#

#category.[/some_category/

secret_reports]_SERVER=MyPackage.MyUSLServerClassName

#category.[/some_category/secret_reports]_CLIENT=MyPackage.MyUSLClientClassName

#

66 FORCS Co., LTD


#set USL for none category related OZServer service

#

OZDefault_SERVER=oz.usl.OZUSLServerSample

OZDefault_CLIENT=oz.usl.OZUSLClientSample

uslmngr.properties 구성내역

항목 설명

UseUSerSecurityLogicVer30 User Security Logic 의 사용여부를 설정합니다.

OZDefault_SERVER 서버의 기본 USL 이름입니다.

OZDefault_CLIENT 클라이언트의 기본 USL 이름입니다.

category1_SERVER[category1] 카테고리의 기본 서버 USL

이름입니다.

category 1_CLIENT[category1] 카테고리의 기본 클라이언트

이름입니다.

USL 사용시 필요한 자세한 내용은 “API 활용 매뉴얼의 Ⅳ. User Security

Logic”을 참조하시기 바랍니다.

FORCS Co., LTD 67

위치

[Daemon/Servlet] {OZ_HOME}\conf\repository.propeties

역할

오즈 서버에 Repository의 아이템을 저장하는 루트 디렉토리를 설정합니다.

기본값은 ‘{OZ_HOME}\repository_files’입니다.

repository.properties ###

### Repository Properties

### Last Modified : Wed Oct 15 13:29:05 KST 2003

###

# RDB, BUILTIN, NONE

REPOSITORY_TYPE = RDB

REPOSITORY_FILE_PATH = %OZ_HOME%/repository_files/

#Item file save number per a directory

#Default value is 500

#The value must be lager than 0

REPOSITORY_ITEM_NUMBER_PER_DIRECTORY = 500

#History item's valid days ( The history item over the value of day is deleted, when check in

the item )

#Default value is 30

#The 0 value is disable.

REPOSITORY_HISTORY_ITEM_VALID_DAYS = 10

REPOSITORY_QUERY_MAXBACKUPINDEX = 5

REPOSITORY_QUERY_MAXFILESIZE = 1M

REPOSITORY_QUERY_IMMEDIATEFLUSH = true

#

68 FORCS Co., LTD

repository.properties


# DB alias in /conf/db.properties to use repository

#

# note: ignored if REPOSITORY_TYPE is BUILTIN

#

REPOSITORY_DB_ALIAS = mssql_test3

REPOSITORY_LOCAL_PASSWORD_FILE=%OZ_HOME%bin\user.cif

#

# note: ignored if REPOSITORY_TYPE is BUILTIN and RDB

repository.properties 구성내역

항목 설명

TYPE

리파지토리 타입을 설정합니다.

RDB : 사용자가 사용할 DB 를 직접 설정할 경우

RDB 타입으로 선택하여야 합니다.

BUILTIN : 오즈 서버에 포함된 파일 DB 를

사용합니다.(Hypersonic SQL DB

사용)

NONE : 로컬 파일 시스템을 사용합니다.

FILE_PATH리파지토리 아이템 파일의 저장 경로를

설정합니다.

ITEM_NUMBER_PER

_DIRECTORY

리파지토리 아이템 파일의 저장 경로에 대한 한

디렉토리당 최대 아이템 개수를 설정합니다.

HISTORY_ITEM_VALID

_DAYS

아이템의 히스토리가 남아있도록 하는 기간을

설정합니다.

QUERY_MAXBACKUPINDEXBUILTIN DB 사용시 백업될 로그 파일의 최대

개수를 설정합니다. ‘

QUERY_MAXFILESIZEBUILTIN DB 사용시 로그 파일의 사이즈를

설정합니다.

QUERY_IMMEDIATEFLUSH

BUILTIN DB 사용시 버퍼에 있는 로그를 바로

기록할지 여부를 설정합니다. ‘true’ 값이면 바로

기록합니다.

DB_ALIASdb.properties에 있는 Alias가 정의한 DB 정보를

Repository로 사용합니다.

FORCS Co., LTD 69

※ REPOSITORY_TYPE이 ‘NONE’일 경우 다음과 같은 제약사항이 있습니다.① 그룹과 사용자 추가 및 권한 설정을 할 수 없으며, 기본 사용자인

‘admin’/’guest’ 계정으로만 제한됩니다.② 사용자에 대한 Check-In /Check-Out 기능을 제공하지 않으며,

아이템의 히스토리 및 Roll-back 기능을 사용할 수 없습니다.

70 FORCS Co., LTD


위치

[Daemon/Servlet] {OZ_HOME}\conf\spmgr.propeties

역할

오즈에서 한 사용자의 다중 로그인 허용 여부 및 에러 메시지의 보안 레벨을

설정합니다.

spmgr.propertiesuser.multilogin= true

user.sessionTimeout = 10

# Secure Level [ high / middle / low ]

# default : low

client_message_secure_level = low

spmgr.properties 구성내역

항목 설명

multilogin 하나의 사용자의 다중 접속 허용 여부를 설정합니다.

sesionTimout초단위 세션의 타임 아웃을 설정합니다. 단일 로그인

(user.multilogin이 ‘false’일 경우)일 경우 사용 가능합니다.

Secure highServer 아무 정보도 출력하지 않도록 설정합니다.

Client 에러 코드만 전송합니다.

Secure middleServer 서버 버전 정보만 출력하도록 설정합니다.

Client 에러 코드와 Exception Name만 전송합니다.

Secure lowServer

기존의 모든 정보를 그대로 출력하도록

보여줍니다.

Client 모든 에러 정보를 전송됩니다.

FORCS Co., LTD 71

spmgr.properties

위치

[Daemon/Servlet] {OZ_HOME}\conf\srmngr.propeties

역할

스케줄러에 의한 SDM 파일 생성 및 생성된 SDM 파일의 사용 여부를 설정합니다.

srmngr.properties# default : false

use_scheduled_data=true

# The path that scheduled data modules are stored.

# default : %OZ_HOME%/scheduled_data

datamodule_path=%OZ_HOME%/scheduled_data

srmngr.properties 구성내역

항목 설명

use_scheduled_dat

a

스케줄러에 의한 SDM 파일 생성 및 생성된 SDM 파일의

사용 여부를 설정합니다. (true/false)

datamodule_path SDM 파일이 저장될 서버 경로를 설정합니다.

72 FORCS Co., LTD

srmngr.properties


위치

[Daemon/Servlet] {OZ_HOME}\conf\dbtmpl.propeties

역할

각 DBMS에서 사용할 기본 JDBC 드라이버를 정의합니다

dbtmpl.properties#----------------------------------------------

# Configuration of Schedule DataModule Manager

#----------------------------------------------

# Last Modified : Fri Jan 14 16:56:23 GMT+09:00 2005

db2.driver = COM.ibm.db2.jdbc.net.DB2Driver

informix.driver = com.informix.jdbc.IfxDriver

mssql.driver = com.microsoft.jdbc.sqlserver.SQLServerDriver

odbc.driver = sun.jdbc.odbc.JdbcOdbcDriver

oracle.driver = oracle.jdbc.driver.OracleDriver

sybase.driver = com.sybase.jdbc2.jdbc.SybDriver

unisql.driver = unisql.jdbc.driver.UniSQLDriver

dbtmpl.properties 구성내역

항목 설명

db2.driver db2java.zip COM.ibm.db2.jdbc.net.DB2Driver

informix.driver ifxjdbc.jar com.informix.jdbc.IfxDriver

mssql.driver mssqlserver.jar com.microsoft.jdbc.sqlserver.SQLServerDriver

odbc.driver rt.jar sun.jdbc.odbc.JdbcOdbcDriver

oracle.driver classes12.zip oracle.jdbc.driver.OracleDriver

sybase.driver jconn2.jar com.sybase.jdbc2.jdbc.SybDriver

unisql.driver unisqljdbc10.jar unisql.jdbc.driver.UniSQLDriver

※ mssql.driver는 기본적으로 제공하지 않습니다.

FORCS Co., LTD 73

dbtmpl.properties

74 FORCS Co., LTD

Ⅴ. 오즈 스케줄러

오즈 스케줄러 서버 개요

오즈 스케줄러 아키텍처


오즈 스케줄러 서버의 파일 구성

오즈 스케줄러 서버 설정

오즈 스케줄러 서버 실행


오즈 스케줄러 서버는 보고서 스케줄링 기능을 지원하는 서버입니다. 사용자가 설정한

스케줄(시간, 주기)에 맞춰 보고서를 생성하고 생성된 보고서를 다양한 포맷으로

저장하고 이메일을 통해 배포하는 기능을 수행합니다.

특징

▪ 최소한의 스레드를 사용하는 구조로 서버의 부하를 최소화 합니다.

▪ 하나의 오즈 스케줄러 서버로 복수개의 오즈 엔터프라이즈 서버의 보고서

스케줄 작업을 수행할 수 있습니다.

▪ 모든 스케줄 정보는 암호화된 파일로 서버에 보관됩니다. 불의의 경우(

하드웨어적 혹은 소프트웨어적)로 서버의 실행이 멈추었을 경우에도 서버의

재실행과 동시에 시스템은 암호화 파일을 이용하여 지속적인 스케줄 서비스를

제공합니다.

▪ 스케줄러는 해당 하드웨어에서 지속적으로 시간을 체크하여 작동하게 됩니다.

서버 실행 중이라도 하드웨어 시간이 변경되었을 경우 하드웨어에서 변경된

시간을 감지하여 지속적인 스케줄링 서비스가 가능하도록 합니다.

▪ 스케줄러 관련 API를 이용하여 사용자 애플리케이션에서 스케줄 태스크 생성

및 관리가 가능합니다. 자세한 내용은 “API 활용 매뉴얼의 Ⅰ.서버 API”를


▪ 오즈 서버를 통한 이메일 배포도 가능합니다.

▪ 보고서 생성시 패러미터를 외부 프로그램에 의해 가변적으로 저장할 수 있으며

관리자에 의해 특정값으로 고정시킬 수도 있습니다.

기능

스케줄링

특정 시점에 한번 또는 주기적으로 정해진 작업(보고서 생성, 발송 등)을

하도록 설정할 수 있으며, 주기는 일별(하루 한번, 시간별), 주별, 월별, 그리고

사용자 임의로 설정할 수 있습니다.

보고서 생성 작업

오즈 스케줄러는 오즈 뷰어를 이용하여 다양한 형식의 보고서 생성 작업을

수행합니다. 기본적으로 오즈 자체 포맷 문서를 비롯하여 엑셀이나 HTML 등의

다양한 표준 문서 포맷으로 보고서를 생성합니다.

FORCS Co., LTD 75

오즈 스케줄러 서버 개요

데이터 모듈 파일

대용량 혹은 데이터베이스 서버에 부하를 많이 주는 보고서용 데이터 모듈

생성 작업을 오즈 스케줄러에 의해 수행할 수 있습니다. 해당 데이터 모듈

파일은 오즈 서버가 설치된 시스템의 지정한 위치에 생성되며, 오즈 뷰어

등에서 오즈 서버에 보고서 요청시 해당 데이터 모듈 파일을 이용하여 보고서

미리보기를 할 수 있습니다.

메일 배포

오즈 스케줄러 서버에서 생성된 보고서 파일은 오즈 엔터프라이즈 매니저등을

이용하여 정의한 수신자 그룹(To:, Cc:, Bcc: )에게 SMTP 서버를 통해 메일

전송을 할 수 있습니다.

사용자 인터페이스

오즈 스케줄러에서는 다음과 같은 사용자 인터페이스를 제공합니다.

• Command Line 컨트롤 명령어

• 엔터프라이즈 매니저의 GUI환경 제공

• 스케줄러 API - 사용자 애플리케이션이나 3rd party 제품에서 스케줄러

API를 이용하여 스케줄 작업을 수행할 수 있습니다.

76 FORCS Co., LTD


FORCS Co., LTD 77

오즈 스케줄러 아키텍처

Enterprise Manager Shell Commander

TCP/IP

Scheduler Server

Task Task Task Task Task

OZ Server OZ Servlet OZ Server SDM

XLS

PDF

OZD

Log-in

UserSMTP

OSMS Windows NT 4.0 이상, 2000 Server, 2003 Server

Java JRE(JAVA Runtime Environment) 1.3 이상

오즈 스케줄러 서버 설치 후 다음과 같은 구조로 디렉토리와 파일이 생성됩니다.

디렉토리 파일 설명

bin

sc.ico 오즈 스케줄러 ico

commander.batcommander.sh

스케줄러 Shell Commander 실행

파일

OZService.exebat 오즈 서비스 실행 파일

ServiceManager.exeNT Service를 등록, 해제, 시작, 정지

시켜주는 유틸리티

OZScheduler.ini NT Service 실행을 위한 환경 파일

InstallService.bat NT Service에 등록시켜주는 파일

UninstallService.bat등록된 오즈 스케줄러를 NT Service

에서 제거시키는 파일

scheduler.batscheduler.sh

스케줄러 실행 파일

scheduler_stop.batscheduler_stop.sh

스케줄러 중지 파일

conf

ozscheduler.properties 스케줄러 경로 설정 파일

scheduler_server.properties 스케줄러 서버 설정 파일

scheduler_server_log.properties

스케줄러 로그 설정 파일

licence ozlicense.xml 스케줄러 라이센스 파일

78 FORCS Co., LTD


오즈 스케줄러 서버의 파일 구성


external스케줄된 보고서의 패러미터 값이나 스케줄 결과 파일명을 동적으로

치환하기 위한 외부 프로그램이 등록되는 루트 디렉토리

lib

activation.jar 메일을 보내기 위해 필요한 라이브러리

log4j.jar 로그에 관련된 라이브러리

mail.jar 메일을 보내기 위해 필요한 라이브러리

ozsfw30.jar 오즈 서버 라이브러리(서버, 스케줄러)

jsee.jarJ2EE 라이브러리(HTTPS/SSL 지원)

JRE 1.3.X 의 경우에 필요jcert.jarjnet.jarparser.jar

xml 파서 관련 라이브러리crimson.jarxercesp.jar

logsOZSchedulerMainLog.log

스케줄러 로그 파일

license ozlicense.xml 스케줄러 라이센스 파일

repository 스케줄 태스크를 통해 생성된 익스포트 파일이 저장되는 디렉토리

ScheduledTask 스케줄링 태스크 정보 파일들이 저장되는 곳의 루트 디렉토리

TempRepository ozd, excel, pdf, html 등 생성되는 파일이 임시로 저장되는 디렉토리

viewer

ozcreport30.dll 오즈 뷰어 메인 모듈 및 컴포넌트 라이브러리

ozcviewer.exe 엑티브엑스 exe 프로그램

ozexcel30.dll 엑셀 라이브러리

ozjpdf417.dll 2차원 바코드 모듈 라이브러리

ozpdf30.dll PDF 라이브러리

res

charters_언어명_

국가명.xml

차트 런타임 모듈 선택 리소스

예)charters_ko_kr.xml

ozlang_언어명_

국가명.dll

뷰어 리소스

예)ozland_ko_kr.dll

viewer_error_msg_

언어명_국가명.xml

뷰어 자체 에러 발생시 코드별 메시지 리소스

예)viewer_error_msg_ko_kr.xml

viewer_server_error

_msg_언어명_

국가명.xml

서버 에러 발생시 코드별 메시지 리소스

예)viewer_server_error_msg_ko_kr.xml

FORCS Co., LTD 79

설정 파일

scheduler.bat

scheduler.bat는 오즈 스케줄러 서버를 실행시키는 파일입니다.

• scheduler.bat

@echo off

rem -----------------------------------------------------

rem

rem OZ Sscheduler Start-up File

rem



rem

rem -----------------------------------------------------

rem -----------------------------------

rem OZ Scheduler Home

rem -----------------------------------

set OZSCHEDULER_HOME=..\

rem -----------------------------------

rem JDK Path

rem -----------------------------------

set JAVA_HOME=..\..\jre\bin

if not "%OZSCHEDULER_HOME%" == "" goto start

echo Unable to determine the value of OZSCHEDULER_HOME.

goto eof

80 FORCS Co., LTD

오즈 스케줄러 서버 설정


:start

set OZSchLib=%OZSCHEDULER_HOME%\conf

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\ozsfw30.jar

rem -----------------------------------

rem Library for HTTPS/SSL

rem -----------------------------------

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\jcert.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\jnet.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\jsse.jar

rem -----------------------------------


rem -----------------------------------

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\log4j.jar

rem -----------------------------------

rem Library for XML Parsing

rem -----------------------------------

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\crimson.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\parser.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\xerces.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_HOME%\java -cp %OZSchLib% oz.scheduler.main.OZScheduler %1 %2

:eof

FORCS Co., LTD 81

commander.bat

commander.bat는 오즈 스케줄러 서버를 제어하기 위한 commander들을

제어하는 파일입니다. 자세한 사항은 본 매뉴얼의 “Ⅷ. 오즈 컨트롤 명령어 –

오즈 스케줄러 Shell Command”를 참조하시기 바랍니다.

• commander.bat

@echo off

rem -----------------------------------------------------

rem

rem OZ Scheduler Commander Start-up File

rem



rem

rem -----------------------------------------------------

rem -----------------------------------

rem OZ Scheduler Home

rem -----------------------------------

set OZSCHEDULER_HOME=..\

rem -----------------------------------

rem JDK Path

rem -----------------------------------

set JAVA_HOME=..\..\jre\bin

if not "%OZSCHEDULER_HOME%" == "" goto start

echo Unable to determine the value of OZSCHEDULER_HOME.

goto eof

:start

82 FORCS Co., LTD


set OZSchLib=%OZSCHEDULER_HOME%\conf

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\ozsfw30.jar

rem -----------------------------------

rem Library for HTTPS/SSL

rem -----------------------------------

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\jcert.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\jnet.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\jsse.jar

rem -----------------------------------


rem -----------------------------------

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\log4j.jar

rem -----------------------------------

rem Library for XML Parsing

rem -----------------------------------

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\crimson.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\parser.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\xerces.jar

rem -----------------------------------

rem Library for Mailing

rem -----------------------------------

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\mail.jar

set OZSchLib=%OZSchLib%;%OZSCHEDULER_HOME%\lib\activation.jar

%JAVA_HOME%java -classpath %OZSchLib%

oz.admin.shell.scheduler.Command %1 %2 %3 %4 %5 %6 %7 %8 %9

ozscheduler.propertiespath.oz.scheduler.home=..

SchedulerPort=9521

FORCS Co., LTD 83

path.scheduler.file=%SCH_HOME%/conf/scheduler_server.properties

path.scheduler.license=%SCH_HOME%/license/ozlicense.xml

path.scheduler_log.file=%SCH_HOME%/conf/scheduler_server_log.properties

path.oz.scheduler.hom

e

스케줄러가 설치된 상대 경로

SchedulerPort스케줄러가 오즈 엔터프라이즈 서버와 통신을 위해

사용할 포트 (Default : 9521)

path.scheduler.file 스케줄러 서버의 환경 설정 파일 경로

path.scheduler.license 스케줄러 서버 라이센스 파일

path.scheduler_log.file 스케줄러 서버의 로그 파일 저장 경로

scheduler_server.properties#

#Tue Mar 09 13:56:13 KST 2004

#[email protected]

#SMTPServer=mail.mail.com

ErrorNotifyToSender=true

MailFrom=

SMTPServer=

SMTPServerPort=25

RepositoryHTMLPath=html

ViewType=ActiveX

LeaveDataModuleWhenExportingReport=false

SchedulingInfoFilePath=%SCH_HOME%/ScheduledTask

TempRepositoryFilePath=%SCH_HOME%/TempRepository

RepositoryFileRootPath=%SCH_HOME%/Repository

ExternalProgramFilePath=%SCH_HOME%/External

ErrorNotifyToSender

스케줄된 작업을 실행하다 오류가 발생할 경우

설정된 사용자에게 메일을 보낼지를 설정

Value : true / false Default : false

84 FORCS Co., LTD


SMTPServer 스케줄링 결과를 메일 전송할 SMTP 서버명

MailFrom 스케줄링 결과를 메일 전송시 발신자 메일 주소

SMTPServerPort 스케줄링 결과를 메일 전송할 SMTP 서버 포트

RepositoryHTMLPath익스포트시 생성된 HTML 파일이 저장되는

디렉토리 설정

ViewType 익스포트하는 뷰어 타입 설정(Default : ActiveX)

LeaveDataModuleWhenExp

ortingReport

익스포트시 서버에 SDM 파일을 남기도록 설정

(Default : false)

SchedulingInfoFilePath스케줄 작업 파일(*.ozs)이 저장되는 디렉토리

(Default : SchedulerHome/ScheduledTask)

TempRepositoryFilePath 생성된 파일이 임시로 저장되는 디렉토리

ExternalProgramFilePath

스케줄된 보고서의 패러미터 값이나 Export 파일

명을 동적으로 치환하기 위한 외부 프로그램의

경로

scheduler_server_log.properties#-------------------------------------------

# configuraion of OZ logging system

#-------------------------------------------

#

# Set Prioritylog level

#

# DEBUG, INFO, ERROR

Priority=INFO

# appender CONSOEL

# Console 로 로그를 뿌립니다.

#

#

CONSOLE.Type=Stdout

CONSOLE.Layout=%r [%t] %p %c{1} %x - %m%n

CONSOLE.Async=true

#

# appender ROLLING_FILE

FORCS Co., LTD 85

# 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=%SCH_HOME%/logs/OZSchedulerMainLog.log

ROLLING_FILE.MaxBackupIndex=5

ROLLING_FILE.MaxFileSize=1MB

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

86 FORCS Co., LTD


#SYSLOG.FacilityPrinting=false

#

# appender Scheduler Task result log

# 스케줄러 태스크 실행시 결과 로그를 File 로 뿌립니다.

ResultLog.MaxBackupIndex=3

ResultLog.MaxFileSize=500KB

오즈 스케줄러의 로그에 대한 설정은 기본적으로 오즈 엔터프라이즈 로그

설정과 동일합니다.

단, 오즈 스케줄러 로그에서는 스케줄러 태스크 수행 결과 로그 파일 설정

부분인 ResultLog에 대한 설정이 추가됩니다.

RSULT_LOG.MaxBackupIndex

Backup될 로그 파일의 최대 개수를

정의합니다. 최대 파일의 개수가 초과될

시에는 가장 오래된 파일이 삭제되고 새로운

파일이 생깁니다.

RSULT_LOG.MaxFileSize 로그 파일의 사이즈를 설정합니다.

기본 설정에 대한 자세한 설명은 본 매뉴얼 “Ⅳ. 오즈 엔터프라이즈 서버 설정

– log.properties”를 참조하시기 바랍니다.

오즈 스케줄러는 윈도우 운영체제에서 서비스나 데몬 형태로 작동됩니다. 인스톨러를

이용하여 설치할 때, 서비스 등록 옵션을 체크하면 오즈 스케줄러 서버가 서비스에

자동으로 등록됩니다. 이때 시작 유형은 수동으로 시스템이 시작될 때 직접 시작해 주어야

합니다. 오즈 스케줄러 서버의 시작 유형을 자동으로 할 경우 JRE의 경로 설정 문제로

재부팅이 필요합니다.

오즈 스케줄러의 세부 설정이나 스케줄 태스크 생성은 commander.bat를 이용하여

실시간으로 제어할 수 있습니다. Commander.bat에 대해서는 본 매뉴얼의 "Ⅷ. 오즈

컨트롤 명령어 – 오즈 스케줄러 Shell Command”를 참조하시기 바랍니다.

오즈 스케줄러 서버의 윈도우 서비스 등록

인스톨러를 이용해서 오즈 스케줄러 설치시 서비스 등록 옵션을 체크하지 않고

인스톨 했다면 수동으로 서비스에 등록할 수 있습니다. 서비스 등록은

FORCS Co., LTD 87

오즈 스케줄러 서버 실행

OZSchedulerService.exe를 이용하여 오즈 엔터프라이즈 서버에서와 같은

방식으로 설정하면 됩니다.

Windows의 서비스 등록은 다음과 같습니다.

※ 인스톨러에 의해 디폴트 경로로 오즈 서버가 설치되는 경우 서비스 등록시

경로를 변경할 필요가 없습니다.

환경 설정

• JAVA 환경 설정

서버 설치시 디폴트로 설치되는 디렉토리에 Classpath 가 등록되어

반드시 등록되어 있어야 서비스 설치 및 구동이 됩니다.

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\OZScheduler.ini 파일에서

[JAVA] 항목의 bin 값을 java.exe 파일 위치로 절대 경로를 설정합니다.

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\InstallService.bat 파일과

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\UninstallService.bat 파일

실행시 필요한 jar 파일들의 경로를 절대 경로를 설정합니다.

– OZScheduler.ini 파일

[JAVA]

BIN=C:\Program Files\FORCS\OZ Product\jre\bin\java.exe

OPTION=-cp

ARGS=oz.scheduler.main.OZScheduler

[CLASS]

;-----------------------------------

; JDK Path

;-----------------------------------

C:\Program Files\FORCS\OZ Product\Scheduler

C:\Program Files\FORCS\OZ Product\Scheduler\conf

C:\Program Files\FORCS\OZ Product\Scheduler\lib\ozsfw30.jar

;-----------------------------------

; Library for HTTPS/SSL

;-----------------------------------

C:\Program Files\FORCS\OZ Product\Scheduler\lib\jcert.jar

88 FORCS Co., LTD


C:\Program Files\FORCS\OZ Product\Scheduler\lib\jnet.jar

C:\Program Files\FORCS\OZ Product\Scheduler\lib\jsse.jar

;-----------------------------------

; Library for Logging

;-----------------------------------

C:\Program Files\FORCS\OZ Product\Scheduler\lib\log4j.jar

;-----------------------------------

; Library for XML Parsing

;-----------------------------------

C:\Program Files\FORCS\OZ Product\Scheduler\lib\crimson.jar

C:\Program Files\FORCS\OZ Product\Scheduler\lib\parser.jar

C:\Program Files\FORCS\OZ Product\Scheduler\lib\xerces.jar

;-----------------------------------

; Library for Mailing

;-----------------------------------

C:\Program Files\FORCS\OZ Product\Scheduler\lib\mail.jar

C:\Program Files\FORCS\OZ Product\Scheduler\lib\activation.jar

;-----------------------------------

– InstallService.bat

@echo off

rem ----------------------------------------------------------------------

rem 서비스 등록 배치파일

rem ----------------------------------------------------------------------


rem %2 - 서비스에 등록하는 실행파일

rem - OZ 프로젝트에서는 고정적으로 OZService.exe 를 사용한다.

rem ----------------------------------------------------------------------

rem ServiceManager.exe %1 /i %2 %1

FORCS Co., LTD 89

ServiceManager OZScheduler /i "C:\Program Files\Forcs\OZ Product\Scheduler\

bin\OZService.exe" OZScheduler

rem ----------------------------------------------------------------------

rem 샘플 예제

rem ----------------------------------------------------------------------

rem InstallService OZServer D:/OZSource/NTService/OZService.exe

rem ----------------------------------------------------------------------

– UninstallService.bat

@echo off

rem ----------------------------------------------------------------------

rem 서비스 등록 해제 배치파일

rem ----------------------------------------------------------------------


rem ----------------------------------------------------------------------

rem ServiceManager.exe %1 /u

ServiceManager.exe OZScheduler /u

rem ----------------------------------------------------------------------

rem 샘플 예제

rem ----------------------------------------------------------------------

rem UninstallService OZServer

rem ----------------------------------------------------------------------

• 오즈 스케줄러 환경 설정

{오즈 엔터프라이즈 서버의 홈디렉토리}\conf\ozserver.properties 파일

에서 path.oz.server.home의 값에 오즈 서버의 홈 디렉토리 경로를 절

대 경로로 설정합니다.

서비스 파일 설정

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\InstallService.bat 파일과 {오즈

엔터프라이즈 서버의 홈디렉토리}\bin\UninstallService.bat 파일에 서비스

90 FORCS Co., LTD


등록시 필요한 OZService.exe 파일 경로를 절대 경로로 설정합니다.

서비스 등록

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\InstallService.bat을 실행합니다.

서비스 제거

{오즈 엔터프라이즈 서버의 홈디렉토리}\bin\UninstallService.bat을

실행합니다.

다음으로 [제어판] - [관리도구] - [서비스]

로 들어가면 오즈 스케줄러 서버가 등록된 것을 확인할 수 있습니다.

OZScheduler를 선택하여 서비스 시작 아이콘을 클릭하면 수동으로 서버를

실행할 수 있습니다. 서버 실행 방식을 수동에서 자동으로 바꾸려면 [시작

유형]에서 바꿔주면 됩니다.

FORCS Co., LTD 91

오즈 스케줄러 서버를 중지 시키기 위해서는 OZScheduler 서비스를 선택한

후 [서비스 중지] 아이콘을 클릭합니다.

※ 오즈 스케줄러 서비스는 서버를 실행시킬 때 같은 디렉토리안에 있는

scheduler.bat를 실행시킵니다. 실행중인 서버를 중지시킬 때는

디렉토리안에 있는 scheduler_stop.bat를 실행시킵니다. scheduler.bat와 scheduler_stop.bat는 OZSchedulerService.exe와

같은 디렉토리 안에 있어야 하며 배치 파일의 이름을 변경하면 안됩니다.

※ 오즈 서버와 스케줄러 서버를 NT 서비스로 등록한 경우 이를 제거하기

위해서는 반드시 NT의 구성요소 서비스에서 오즈 서버를 종료시킨 후

ozstop.bat/ozstop.sh(혹은 scheduler_stop.bat)를 실행시켜야

서비스를 제거할 수 있습니다.

92 FORCS Co., LTD


FORCS Co., LTD 93

Ⅵ. 오즈 엔터프라이즈 매니저

오즈 엔터프라이즈 매니저의 개요


오즈 엔터프라이즈 매니저의 파일 구성

오즈 엔터프라이즈 매니저 실행

오즈 엔터프라이즈 매니저 윈도우

오즈 엔터프라이즈 매니저의 기능

오즈 엔터프라이즈 매니저는 복수 개의 오즈 서버와 스케줄러 서버를 중앙집중식으로

관리할 수 있도록 기능을 지원하는 관리자 콘솔입니다. 관리자는 오즈 서버의 상태 확인,

설정 변경, 스케줄러 서버의 상태 확인, 설정 변경, 스케줄러 태스크 생성, 태스크 수행

결과 확인 등의 작업을 수행할 수 있습니다.

OSMS Windows NT 4.0, 2000 Server, 2003 Server

CPUPentium II 300MHz, Pentium III 500MHz 이상 권장

Main Memory최소 128MB, 256MB 이상 권장

HDD최소 10MB 이상 필요

94 FORCS Co., LTD

오즈 엔터프라이즈 매니저의 개요



오즈 엔터프라이즈 매니저를 설치한 다음 생성되는 디렉토리와 파일 종류 및 내용은

다음과 같습니다.


bin

OZFrameWorkEM.exe 오즈 엔터프라이즈 실행 파일

ozdm10_vc60u.dll 오즈 DM 라이브러리

OZOptWiz_vc60u.dll태스크 생성시 사용하는

라이브러리

XT3100Libu.dll XT Toolkit 라이브러리

res

MultiLanguageList.xml 언어 설정 정의 파일

em_언어_국가.dll오즈 엔터프라이즈 언어 리소스

파일

em_error_msg_언어_국가.xml 오즈 엔터프라이즈 에러 메시지

server_error_msg_언어_국가.xml서버 연동시 서버에서 발생하는

에러 메시지

viewer_parameter_언어_국가.xml 뷰어 패러미터 정의 파일

conf server.conf오즈 엔터프라이즈 서버 설정

파일

※ 리소스 파일의 명명 규칙은 em_언어코드_국가코드.dll이고, 언어코드와

국가코드는 ISO 표준 국가 및 언어 코드 639를 따릅니다.※ 리소스 파일을 찾는 순서는 em_언어코드_국가코드.dll, em_언어코드.dll,

em.dll의 순서로 찾고, *.dll이 없는 경우에는 영어로 표시됩니다.

FORCS Co., LTD 95

오즈 엔터프라이즈 매니저의 파일 구성

윈도우 시작 프로그램의 [프로그램] – [㈜포시에스] – [oz report 3.0] 메뉴에서 [OZ

Enterprise Manager]를 클릭합니다.

오즈 엔터프라이즈 매니저가 실행되면 다음과 같이 오즈 엔터프라이즈 매니저의 초기

화면이 나타납니다.

96 FORCS Co., LTD

오즈 엔터프라이즈 매니저 실행


※ [도구] 메뉴의 [언어]에서 설정하고자 하는 언어를 선택하면 변경된 언어를

적용하기 위해 프로그램을 다시 시작해야 한다는 메시지가 나타납니다. [확인] 버튼을 클릭하면 변경된 언어가 적용된 엔터프라이즈 매니저가 재실행됩니다.

FORCS Co., LTD 97

메뉴바오즈 엔터프라이즈 매니저의 메인 메뉴이며, 풀다운(pull

down) 형식으로 제공합니다.

툴바오즈 엔터프라이즈 매니저의 기능을 쉽고 빠르게 사용할 수

있도록 메뉴바 아래 아이콘 형태로 제공합니다.

콘솔 목록등록된 오즈 엔터프라이즈 서버와 스케줄러 서버의 목록을

보여줍니다.

콘솔 메뉴오즈 엔터프라이즈 서버 혹은 스케줄러 서버에서 사용할 수

있는 메뉴를 보여줍니다.

속성창선택한 메뉴의 설정 정보를 보여줍니다. 수정 및 편집, 추가,

삭제 등이 가능합니다.

98 FORCS Co., LTD

오즈 엔터프라이즈 매니저 윈도우

메뉴바툴바

속성창콘솔 목록

콘솔 메뉴


FORCS Co., LTD 99

서버 접속

서버(서블릿) 등록하기

새로운 오즈 서버(서블릿)를 등록하고자 하는 경우 [콘솔] 메뉴에서 [서버 추가]

를 선택하거나 아이콘 또는 왼쪽의 [콘솔 목록] 창에서 마우스 오른쪽

버튼을 클릭한 후 [서버 추가]를 선택하면 [새 서버(서블릿)]를 등록할 수 있는

창이 나타납니다.

이름

엔터프라이즈 매니저에서는 여러 개의 오즈 서버를 관리할 수

있습니다. 서버명은 각 서버를 구분하기 위한 Alias명입니다.

※ 엔터프라이즈 매니저에서는 서버 설정 변경을 위해

‘admin’ 계정만 접속 가능합니다.

타입데몬형은 포트를 갖기 때문에 TCP를 선택하고,

서블릿형은 URL로 접근하기 때문에 HTTP를 선택합니다.

IP서버 타입을 TCP로 선택했을 경우 오즈 서버가 설치되어 있는

호스트 컴퓨터의 IP를 설정합니다.

포트서버 타입을 TCP로 선택했을 경우 서버가 사용하는 TCP

포트를 설정합니다.

서버 URL

서버 타입을 HTTP로 선택했을 경우 서블릿에 접근 가능한

URL을 설정합니다. 웹에서 오즈 서블릿의 메인 페이지를

호출하는 URL을 설정하면 됩니다.

예) http://www.oz.com/ozservlet

100 FORCS Co., LTD

오즈 엔터프라이즈 매니저의 기능


[새 서버] 창에서 각 항목을 입력한 후 [추가] 버튼을 클릭하면 왼쪽 [콘솔 목록]

의 [서버 목록] 아이콘 아래 추가한 서버(서블릿) 아이콘이 추가됩니다.

서버(서블릿)에 접속하기

접속할 서버(서블릿)를 선택하고 콘솔 메뉴에서 [접속]을 선택하면 선택한

서버에 접속하기 위한 [로그인] 창이 나타납니다. [아이디]와 [암호]를

입력합니다. [아이디]와 [암호]를 입력한 후 [저장]을 체크하면 이후부터는 서버

접속시 해당 정보가 입력된 상태로 [로그인] 창이 나타납니다.

※ 서버는 기본적으로 ID : admin, 암호 : admin으로 설정되어 있으며, Repository Manager에서 암호 변경 및 사용자 추가/삭제/변경 등의

작업을 할 수 있습니다.

FORCS Co., LTD 101

오즈 서버 관리 및 환경 설정

엔터프라이즈 매니저는 등록된 오즈 서버의 상태를 모니터링하고 각종 환경을

설정할 수 있도록 합니다. 엔터프라이즈 매니저를 통해 설정된 값은 실시간으로

오즈 서버에 반영되기 때문에 오즈 서버를 재실행할 필요가 없습니다.

서버관리

서버에 대한 버전 정보와 메모리 정보를 관리합니다.

• 서버 정보

현재 서버 버전 정보와 모듈별 버전 정보를 확인할 수 있습니다.

• 메모리 상태

현재 서버의 전체 메모리, 사용 메모리, 비사용 메모리를 확인할 수

있습니다.

※ 사용 메모리는 오즈의 사용 메모리가 아니라 서버 내에서 구동되고

있는 전체 프로그램의 사용 메모리를 나타내는 것입니다.

102 FORCS Co., LTD


• 메모리 수집

서버가 자체적으로 메모리 수집 작업을 수행합니다. JVM상에서 사용하지

않은 메모리를 제거하여 사용 가능한 메모리로 바꿔줍니다.

• 서버 정지

서버 작동을 정지시킵니다.

FORCS Co., LTD 103

• 서버 재시작

서버를 정지시켰다가 재시작합니다.

※ 서버의 정지 및 재시작은 데몬 타입 서버에서만 작동합니다.서블릿 타입 서버는 WAS의 기능을 이용하여 정지 및 재시작하여

주시기 바랍니다.

저장소

저장소란 리파지토리를 말합니다. 리파지토리 서버 관련 설정을 조회 및

수정합니다.

• 저장소 설정

저장소와 관련된 옵션을 설정합니다.

값 변경 후 아래의 [저장] 버튼을 클릭하면 적용됩니다.

104 FORCS Co., LTD


REPOSITORY_TYPE리파지토리 타입을 설정합니다.(Builtin, RDB,

NONE)

REPOSITORY_DB_ALIASdb.properties에 있는 Alias가 정의한 DB

정보를 Repository로 사용합니다.

REPOSITORY_FILE_PATH 리파지토리 저장 파일 경로를 설정합니다.

REPOSITORY_ITEM_

NUMBER_PER_PATH

리파지토리 저장 경로에 대한 디렉토리 파일

숫자를 제한하도록 설정합니다.

REPOSITORY_HISTORY_

ITEM_VALID_DAYS

아이템의 히스토리가 남아있도록 하는 기간을

설정합니다.

REPOSITORY_ADD_

COMPRESSED_ITEM

리파지토리의 아이템 압축 여부를 설정합니다.

‘true’ 값이면 압축 폼을 사용합니다.

REPOSITORY_QUERY_MAX

BACKUPINDE

Builtin DB 사용시 백업될 로그 파일의 최대

개수를 설정합니다.

REPOSITORY_QUERY_MAX

FILESIZE

Builtin DB 사용시 로그 파일의 사이즈를

설정합니다.

REPOSITORY_QUERY_IMMI

DIATEFLUSH

Builtin DB 사용시 버퍼에 있는 로그를 바로

기록할지 여부를 설정합니다. ‘true’ 값이면

바로 기록합니다.

FORCS Co., LTD 105

• 저장소 재시작

리파지토리 서버를 재시작합니다.

설정을 변경한 후 재시작을 하면 변경한 내용이 적용됩니다.

캐시

서버의 캐시 매니저 설정 및 캐시된 보고서 데이터 모듈을 조회 및 삭제합니다.

• 캐시설정

CACHE_FILE_PATH디스크에 캐싱할 때 캐시 내용이 저장되는

장소의 경로를 설정합니다.

DM_CACHE_FILE_PATH디스크에 캐싱할 때 데이터 모듈이 저장되는

장소의 경로를 설정합니다.

• 캐시 리스트

설정된 캐시들을 보여줍니다.

각 이름을 더블 클릭하거나 마우스 오른쪽 버튼을 클릭한 후 [추가] 혹은

[수정]을 선택하면 캐시 정보를 변경할 수 있습니다.

그 외 캐시 삭제 및 데이터 삭제를 할 수 있습니다.

106 FORCS Co., LTD


– 추가

추가하고자 하는 [캐시 아이디]를 선택하여 더블 클릭하거나 마우스

오른쪽 버튼을 클릭하여 [추가]를 선택하면 다음과 같이 캐시정보를

수정할 수 있는 [캐시 정보] 창이 나타납니다.

캐시 아이디 캐시하고자 하는 아이디를 보여줍니다.

캐시 동작여부‘true/false’ 값을 가지며 캐시의 실행 유무를

설정합니다.

메모리 캐시 사용시간메모리에 캐시를 저장할 때 보존하는 시간을

설정합니다.

FORCS Co., LTD 107

디스크 캐시 사용시간디스크에 캐시를 보존하는 시간(단위:초)을

설정합니다.

프리 메모리 퍼센트메모리 용량이 지정한 수치의 퍼센트 보다

적으면 디스크에 캐싱합니다.

– 수정

cachemngr.properties에 이미 등록된 캐시 정보를 변경합니다.

– 삭제

등록된 캐시 정보를 삭제합니다.

– 데이터 삭제

선택한 캐시 정보에 의해서 오즈 엔터프라이즈 서버에 생성된 캐시

데이터를 삭제합니다.

커넥션

데이터베이스 연결 정보를 설정합니다.

• 커넥션 풀

현재 서버에서 연결하고 있는 DB 목록을 리스트로 보여줍니다. 각 이름을

더블 클릭하거나 마우스 오른쪽 버튼을 클릭한 후 [상세보기]를 선택하면

자세한 내용을 볼 수 있습니다.

그 외 커넥션 풀 추가, 수정 및 삭제를 할 수 있습니다.

108 FORCS Co., LTD


– 상세보기

자세히 보고자 하는 커넥션을 더블 클릭하거나 마우스 오른쪽 버튼을

클릭하여 [상세보기]를 선택하면 자세한 커넥션 정보를 볼 수

있습니다.

항목별 자세한 설명은 “[새로운 커넥션 풀 추가]” 내용을 참조하시

기 바랍니다.

– 새로운 커넥션 풀 추가

FORCS Co., LTD 109

[커넥션 풀 추가] 창에서 각 정보들을 입력한 후 [확인] 버튼을

클릭하면 커넥션 정보가 추가됩니다. DB 종류에 따라 입력해야 할

정보가 달라집니다.

110 FORCS Co., LTD


► 풀

이름여러 개의 데이터베이스 연결 정보를 구현하기 위한

alias명입니다.

타입 데이터베이스 타입을 선택합니다.

주소, 포트 데이터베이스 IP와 포트번호입니다.

데이터베이스

드라이버 종류

JDBC 드라이버 종류를 설정합니다. 예 : thin

(ODBC의 경우는 ODBC DSN)

데이터베이스

서버이름

DBMS의 서버 구분명을 입력합니다.(오라클의 경우

SID)

데이터베이스명 DBMS의 DB명을 입력합니다.

사용자 이름 데이터베이스에 접근하는 사용자 이름입니다.

패스워드 데이터베이스에 접근하는 사용자 암호입니다.

FORCS Co., LTD 111

► 접속

최대접속오즈 서버가 가질 수 있는 최대 DB Connection

수입니다.

초기접속 오즈 서버의 초기 DB Connection수입니다.

타임아웃Maxconns를 초과할시 사용중인 Connection이

반환되기를 기다리는 최대 시간입니다.(단위:초)

► 드라이버

드라이버명과 URL, 프로퍼티 값 등의 정보를 나타냅니다.

사용자 정의시 입력한 정보에 의하여 새로운 데이터베이스 연결

정보가 추가됩니다.

112 FORCS Co., LTD


드라이버

설정 사용

드라이버 JDBC 드라이버의 클래스명입니다.

URL JDBC 드라이버의 연결 URL입니다.

프로퍼티JDBC 드라이버의 connection

property string입니다.

► 옵션

오즈 서버가 커넥션 풀을 잃어버릴 경우를 방지하기 위해

테스트할 질의문을 추가합니다.

FORCS Co., LTD 113

항상 연결

테스트 시도하기

오즈 서버가 커넥션 풀을 잃어버릴 경우를

방지하여 테스트할 질의문을 추가함으로써

오즈 서버로 연결시 데이터베이스와 접속되어

있는지를 체크하여 연결이 끊어졌을 경우

커넥션 풀을 새로 연결시켜 줍니다.

– 커넥션 풀 수정

[커넥션 풀 수정]은 선택한 [커넥션 풀 추가]시 보여졌던 창을

이용하여 수정할 수 있습니다.

114 FORCS Co., LTD


– 커넥션 풀 삭제

삭제하고자 하는 커넥션을 선택한 후 마우스 오른쪽 버튼을 클릭하여

[삭제]를 선택합니다.

로그

오즈 서버 로그 기록환경 설정 및 서버 로그 데이터를 검증합니다.

• 로그 설정

서버의 로그 환경 설정을 조회하고 파일을 보거나 수정할 수 있습니다.

일반 텍스트 에디터와 같습니다. 수정 후 아래 [저장] 버튼을 클릭하면

수정됩니다.

FORCS Co., LTD 115

항목별 자세한 설명은 본 매뉴얼 “Ⅳ. 오즈 엔터프라이즈 서버 설정 -log.properties”를 참조하시기 바랍니다.

• 로그 보기

로그에 남겨진 내용을 보여줍니다. 수정 및 삭제는 할 수 없습니다.

아래의 [검색] 창에 검색어를 입력하면 원하는 검색 결과를 보여줍니다.

[시간간격] 창에 시간(초)를 입력하면 입력된 주기에 따라 로그를 자동

업데이트를 합니다.

116 FORCS Co., LTD


검색 결과를 더블 클릭하면 검색된 부분으로 이동합니다.

보기

• 콘솔 목록

왼쪽 [콘솔 목록]를 숨기거나 볼 수 있게 합니다.

• 콘솔 메뉴

왼쪽 [콘솔 메뉴]을 숨기거나 볼 수 있게 합니다.

• 도구 모음

메뉴 아래에 있는 도구 모음을 숨기거나 볼 수 있게 합니다.

• 상태 표시줄

아래 상태 표시줄을 숨기거나 볼 수 있게 합니다.

• 새로 고침(F5)

화면을 갱신합니다.

FORCS Co., LTD 117

도움말

오즈 엔터프라이즈 매니저의 버전과 빌드 정보, 사용권 등의 정보를

보여줍니다.

스케줄러 관리 및 설정

스케줄러 추가

스케줄러를 추가하려면 [콘솔 목록] 창에서 마우스 오른쪽 버튼을 클릭하여 [

스케줄러 추가]를 선택하거나 아이콘을 클릭합니다.

스케줄러에 접속하려면 등록된 스케줄러에서 마우스 오른쪽 버튼을 클릭하여 [

접속]을 선택합니다. 스케줄러는 서버별로 인증을 받기 때문에 [오즈 서버 로그인]

창에서 인증 받을(접속할) 서버를 먼저 선택하여야 합니다.

118 FORCS Co., LTD


[오즈 서버 선택]란에서 접속할 서버를 선택하면 [오즈 서버 정보]란에 서버 정보가

나타납니다. [사용자 아이디]와 [암호]를 입력한 후 [확인] 버튼을 클릭하면

스케줄러에 접속됩니다.

FORCS Co., LTD 119

관리

스케줄러에 의해 생성된 데이터를 운영 및 관리합니다.

• 스케줄러 설정

스케줄러와 관련된 옵션을 설정합니다. 값 변경 후 아래 [저장] 버튼을

클릭하면 설정된 값이 적용됩니다.

스케줄러의 기본 정보를 보여주며 수정할 수 있습니다.

ErrorNotifyToSender에러 발생시 관리자에게 이메일로

알려줍니다.

ExternalProgramFilePath 외부 프로그램의 경로를 설정합니다.

MailFrom 메일 발송자 주소를 설정합니다.

RepositoryFileRootPath Export 결과를 저장할 경로를 설정합니다.

SMTPServer이메일 발송을 위한 SMTP 서버의 IP를

설정합니다.

SMTPServerPort SMTP 서버의 포트 번호를 설정합니다.

SchedulerPort 오즈 스케줄러 서버의 포트를 설정합니다.

SchedulinginfoFilePath 스케줄 설정 파일의 경로를 설정합니다.

TempRepositoryFilePath 임시 파일을 저장할 경로를 설정합니다.

ViewType 뷰어 타입을 설정합니다.

120 FORCS Co., LTD


• 스케줄러 정지

스케줄러 작동을 정지시킵니다.

• 스케줄러 재시작

스케줄러를 정지시켰다가 재시작합니다.

FORCS Co., LTD 121

태스크

• 태스크 목록

스케줄링된 태스크 목록을 보여줍니다.

태스크 추가, 수정, 삭제, 결과보기, 시작 및 중지를 할 수 있습니다.

카테고리 해당 리포트의 카테고리 이름입니다.

리포트 이름 할당된 태스크를 수행할 리포트입니다.

타입 주기적 실행, 일시적 실행 등을 나타냅니다.

상태

WAITING일 경우 다음 실행을 기다리는 중이며,

PAUSE일 경우는 작업 실행이 되지 않는 것을

의미합니다.

- 태스크 추가

접속한 서버로부터 아이템을 받아와 OZReportFile 타입의 아이템을

보여줍니다. 아이템을 선택합니다.

122 FORCS Co., LTD


[다음] 버튼을 클릭하면 [태스크 설정 옵션]창이 나타납니다.

► 기본 설정

[패러미터 생성과 파일경로 동적 생성을 위한 외부 프로그램]은

스케줄링시 사용할 외부프로그램명('스케줄러 설정'시 설정한 '

FORCS Co., LTD 123

외부프로그램 저장경로')에서 설정한 경로의 해당 파일을

읽어옵니다.

[입력 패러미터]는 해당 리포트의 패러미터들을 보여주며

패러미터 값을 변경할 수 있습니다.

<참고> 보고서 스케줄링시 보고서 패러미터 값이나 결과 파일명을 동적으로

설정하는 방법

오즈 스케줄러는 보고서 패러미터나 기타 사용자가 입력하는 항목에

사용자 정의 날짜형식을 사용하거나 외부프로그램을 통해 동적으로 치

환할 수 있도록 시스템 변수를 제공합니다.

동적으로 적용 가능한 항목은 다음과 같습니다.

• 스케줄 결과 파일명(데이터 모듈 파일명, 엑셀 파일명, PDF 파일명, OZD

파일명)

• 리포트 패러미터

1. 보고서 패러미터 또는 결과 파일을 보고서가 실행되는 시점의 날짜로

이용하고자 할 때 날짜 관련 시스템 변수를 이용할 수 있습니다.

[형식] $OZ.#D/날짜형식/#D증감형식$

$OZ ~ $ : 오즈 스케줄러에서 제공하는 시스템 변수를 의미합니다.

#D/ ~ /#D : 날짜 형식을 정의하기 위한 앞뒤 구분자를 의미합니다.

날짜형식 : 사용자 정의 날짜 형식입니다.

날짜 형식에 사용되는 심벌은 오즈 서버 [서블릿]의

로그 설정에서 사용한 심벌과 동일합니다.

【표1】Date Format을 참조하시기 바랍니다.

증감형식 : 현재 날짜를 기준으로 일단위로 증감시킨 날짜입니다.

+_n_day (n_day : 정수)

124 FORCS Co., LTD


【표1】Date Format

서식 의미 형태 예제

G Year designator (Text) AD

y Year (Number) 1996

M Month in year(Text 나 Number)

July & 07 (locale에 따라 다름.한국은 무조건 숫자만 됨)

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) Tuesday(locale에 따라 다름,한국은 '목')

D day in year (Number) 189

F day of week in month (Number) 2 (2nd Wed in July)

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 (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$

FORCS Co., LTD 125

결 과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

2. 외부 프로그램을 통해 보고서 패러미터 등을 동적으로 치환하고자 할 경우

스케줄 태스크 생성의 '기본설정-패러미터 생성과 파일 경로 동적 생성을

위한 외부프로그램 등록’에 사용자가 작성한 프로그램을 등록하고 해당

프로그램은 '오즈시스템변수명 = 설정값' 형태의 문자열을 표준출력으로

리턴하여야 합니다.

오즈 시스템 변수는 다음과 같습니다.

$OZ.#P_패러미터명 : 보고서의 해당 패러미터 값을 설정합니다.

$OZ.#EXF_USER : 스케줄 결과 데이터 모듈 파일명을 설정합니다.

$OZ.#EXF_XLS : 스케줄 결과 엑셀 파일명을 설정합니다.

$OZ.#EXF_OZD : 스케줄 결과 OZD 파일명을 설정합니다.

$OZ.#EXF_PDF : 스케줄 결과 PDF 파일명을 설정합니다.

$OZ.#EXF_CSV : 스케줄 결과 CSV 파일명을 설정합니다.

$OZ.#EXF_HTML : 스케줄 결과 HTML 파일명을 설정합니다.

$OZ.#EXF_JPG : 스케줄 결과 JPG 파일명을 설정합니다.

126 FORCS Co., LTD


$OZ.#EXF_PPT : 스케줄 결과 PPT 파일명을 설정합니다.

$OZ.#EXF_SVG : 스케줄 결과 SVG 파일명을 설정합니다.

$OZ.#EXF_TEXT : 스케줄 결과 TEXT 파일명을 설정합니다.

$OZ.#EXF_TIFF : 스케줄 결과 TIFF 파일명을 설정합니다.

$OZ.#EXF_WORD : 스케줄 결과 WORD 파일명을 설정합니다.

예) 외부프로그램의 표준출력 : $OZ.#EXF_DM = MyData.sdm

$OZ.#EXF_XLS = MyExcel.xls

$OZ.#P_FromDate = 2002-10-01

$OZ.#P_ToDate = 2002-10-02

► 전자메일 발송

스케줄링된 결과 파일을 메일로 보낼 수 있습니다.

[내용에 HTML 포함]를 선택하면 PDF나 OZD, XLS과 같이

Export한 HTML 파일을 첨부하여 보낼 수 있습니다.

[수신자에게 에러통보]를 선택하면 스케줄링 중 에러가 발생할

경우 메일 수신자에게 에러를 통보합니다.

FORCS Co., LTD 127

[HTML 사용]을 체크하면 본문 내용의 HTML 태그와 함께 사용할

수 있습니다.

128 FORCS Co., LTD


► 스케줄 시간

스케줄링 시간과 주기를 설정합니다.

스케줄

타입

즉시 실행

태스크를 생성하는 동시에 스케줄링을

실행합니다.

태스크 정보는 생성되지 않습니다.

한번 실행설정한 시간에 단 한번만 스케줄링

실행합니다.

주기적 실행설정한 주기대로 스케줄링을

실행합니다.

주기

설정

일별

일별주기 설정 (매월 마지막날 실행

시키려면 '31일 마다'로 설정)

매n일마다, 평일마다 스케줄링 할지

설정

주별주별주기 설정 (몇주마다, 특정 요일마다

스케줄링 할지 설정)

월별

월별주기 설정 (매월 스케줄링할 날을

특정 일별, 특정 주, 특정 요일 또는

사용자가 특정일 설정)

예) 매월 1일과 5일 20일에 스케줄링을

하려면 → 1,5,20

FORCS Co., LTD 129

수행시간

하루 한번 해당일 주어진 시간에 한번씩 실행

하루 여러 번해당일에 주어진 시간 사이에 주어진

시간 주기로 실행

사용자 정의

해당일 주어진 시간에 실행(여러 개의

시간을 설정할 수 있음)

예) AM 1시 30분, PM 5시 10분에

스케줄링 하려면 → 01:30, 17:10

► 서버 데이터 모듈

SDM 파일을 익스포트 하기 위한 옵션입니다.

[서버 데이터 모듈]은 스케줄링 결과 생성된 데이터 모듈을

사용자가 직접 사용할 목적으로 오즈 서버에 저장해 둘 수 있

습니다. [서버 데이터 모듈 파일명]을 설정하면 설정한 이름으

로 오즈 서버에 데이터모듈(.sdm)이 저장됩니다(기본적으로 '

스케줄'-'파일경로설정'-'스케줄 결과 저장 경로명(사용자 정의

경로)'에서 설정한 경로에 해당이름의 sdm 파일이 저장됩니다.

상대경로를 설정해야 하며 제일 앞에 .이 들어가서는 안됩니

다. 예를 들어 ./이나 ../은 사용할 수 없습니다).

130 FORCS Co., LTD


► 패러미터

각 익스포트 포맷별 탭으로 구성됩니다. 각 탭에 대한 자세한

사항은 “오즈 리포트 뷰어 매뉴얼 Ⅲ. 오즈 뷰어 윈도우”를


• 태스크 결과

선택된 태스크의 결과를 보여줍니다.

[시작] 날짜와 [종료] 날짜를 입력하면 그 기간 사이에 일어난 태스크 작업

결과를 보여주며, 입력하지 않으며 전체 결과를 보여줍니다.

[태스크 아이디]를 입력하면 입력된 아이디의 태스크 결과만을 보여줍니다.

[스케줄링 태스크 결과]를 입력한 후 [확인]을 클릭하면 다음과 같이

FORCS Co., LTD 131

결과를 볼 수 있습니다. 에러 메시지가 있을 경우 마우스 오른쪽을

클릭하여 [에러보기]를 선택하면 상세 에러 메시지를 확인할 수 있습니다.

파일 관리

• 익스포트 파일

태스크 결과로 익스포트된 파일을 보여줍니다.

- 새폴더

132 FORCS Co., LTD


마우스 오른쪽을 클릭하여 [새폴더]를 선택하면 선택된 폴더의

하위에 새로운 폴더를 만들 수 있습니다.

- 폴더 삭제

마우스 오른쪽을 클릭하여 [폴더 삭제]를 선택하면 선택된 폴더를

삭제합니다.

- 새로 고침

마우스 오른쪽을 클릭하여 [새로 고침]을 선택하면 선택된 폴더의

내용을 업데이트 합니다(새로 생성된 익스포트 파일 등을 수시로

체크할 수 있습니다).

- 다운로드

마우스 오른쪽을 클릭하여 [다운로드]를 선택하면 로컬 컴퓨터로

익스포트된 파일을 다운로드 할 수 있습니다.

- 파일 삭제

익스포트된 파일을 삭제합니다.

• 외부 프로그램

태스크 생성시 사용되는 외부 프로그램을 보여줍니다.

- 새폴더

FORCS Co., LTD 133

마우스 오른쪽을 클릭하여 [새폴더]를 선택하면 선택된 폴더의

하위에 새로운 폴더를 만들 수 있습니다.

- 폴더 삭제

마우스 오른쪽을 클릭하여 [폴더 삭제]를 선택하면 선택된 폴더를

삭제합니다.

- 새로 고침

마우스 오른쪽을 클릭하여 [새로 고침]을 선택하면 선택된 폴더의

내용을 업데이트 합니다(새로 생성된 익스포트 파일 등을 수시로

체크할 수 있습니다).

- 프로그램 등록

외부 프로그램이 등록될 파일을 선택한 후 [열기]에서 파일을

지정하면 선택된 폴더에 외부 프로그램이 등록됩니다.

- 다운로드

마우스 오른쪽을 클릭하여 [다운로드]를 선택하면 로컬 컴퓨터로

익스포트된 파일을 다운로드 할 수 있습니다.

- 파일 삭제

익스포트된 파일을 삭제합니다.

• 중지

스케줄러를 중지시킬 수 있습니다.

로그

오즈 스케줄러의 로그 기록환경 설정 및 서버 로그 데이터를 검증합니다.

• 로그 설정

스케줄러의 로그 환경 설정을 조회하고 파일을 보거나 수정할 수

있습니다. 일반 텍스트 에디터와 같습니다. 수정 후 아래 [저장] 버튼을

클릭하면 수정됩니다.

134 FORCS Co., LTD


항목별 자세한 설명은 본 매뉴얼 “Ⅴ. 오즈 스케줄러 – 오즈 스케줄러

서버 설정”를 참조하시기 바랍니다.

• 로그 보기

로그에 남겨진 내용을 보여줍니다. 수정 및 삭제는 할 수 없습니다.

아래의 [검색] 창에 검색어를 입력하면 원하는 검색 결과를 보여줍니다.

[시간간격] 창에 시간(초)를 입력하면 입력된 주기에 따라 로그를 자동

업데이트를 합니다.

FORCS Co., LTD 135

검색 결과를 더블 클릭하면 검색된 부분으로 이동합니다.

136 FORCS Co., LTD


FORCS Co., LTD 137

Ⅶ. 오즈 리파지토리 매니저

오즈 리파지토리 매니저의 개요


오즈 리파지토리 매니저의 파일 구성

오즈 리파지토리 매니저 실행

오즈 리파지토리 매니저 윈도우

오즈 리파지토리 매니저의 메뉴

오즈 리파지토리 매니저의 기능

리파지토리는 오즈 폼 및 데이터 파일 등 각종 아이템을 포괄적으로 관리해주는

시스템입니다. 리파지토리 매니저는 아이템 체크인, 체크 아웃 기능을 통해 다중 사용자가

오즈 아이템을 공유할 수 있도록 도와줍니다. 또한 사용자들에 따라 다양한 단계의 권한을

부여할 수 있으며, 아이템이 수정될 때 이를 히스토리에 기록하는 기능을 포함하고

있습니다.

주요 기능

사용자/그룹 관리

사용자/그룹 생성, 삭제 및 속성(이름, 상세설명)을 변경할 수 있습니다.

카테고리/아이템 관리

카테고리/아이템 생성, 삭제 및 속성(이름, 권한)을 변경할 수 있습니다.

아이템 다운로드 및 업로드

리파지토리의 아이템을 다운로드/업로드 할 수 있습니다. 업로드의 경우에 는

아이템의 내용이 업데이트 되지만 히스토리에는 남지 않습니다.

아이템 체크인 및 체크 아웃, 체크 아웃 취소

리파지토리의 아이템에 대해서 체크인, 체크 아웃, 체크 아웃 취소 기능을

지원합니다. 사용자가 아이템을 체크인 할 경우 이 작업에 대한 정보가

히스토리에 저장됩니다.

아이템 히스토리 관리

아이템이 업데이트 된 히스토리를 열람할 수 있으며, 특정 버전을 다운로 드

받거나 롤백 시킬 수 있습니다.

카테고리 및 아이템에 대한 권한 설정

사용자 및 사용자 그룹별로 카테고리와 아이템에 대한 접근 권한을 설정할 수

있습니다.

138 FORCS Co., LTD

오즈 리파지토리 매니저의 개요


OSMS Windows NT 4.0 이상, 2000 Server, 2003 Server

CPUPentium II 300MHz, Pentium III 500MHz 이상 권장

Main Memory최소 128MB, 25MB 이상 권장

HDD최소 10MB 이상 필요

오즈 리파지토리 매니저를 설치한 다음 생성되는 디렉토리와 파일 종류 및 내용은 다음과

같습니다.


bin

OZRepositoryManager.exe 오즈 리파지토리 실행 파일

ozdm10_vc60u.dll 오즈 리파지토리 라이브러리

XT3100Libu.dll 오즈 리파지토리 라이브러리

OZRepositoryManager.ini 오즈 리파지토리 설정 파일

res

MultiLanguageList.xml 언어 설정 파일

rm_언어_국가.dll 오즈 리파지토리 언어 리소스 파일

rm_error_msg_언어_

국가. xml오즈 리파지토리 에러 메시지

server_error_msg_언어

_국가. xml

서버 연동시 서버에서 발생하는

에러 메시지

※ 리소스 파일의 명명 규칙은 rm_언어코드_국가코드.dll이고, 언어코드와

국가코드는 ISO 표준 국가 및 언어 코드 639를 따릅니다.※ 리소스 파일을 찾는 순서는 rm_언어코드_국가코드.dll, rm_언어코드.dll,

FORCS Co., LTD 139

오즈 리파지토리 매니저의 파일 구성


rm.dll의 순서로 찾고, *.dll이 없는 경우에는 영어로 표시됩니다.

윈도우 시작 프로그램의 [프로그램] – [㈜포시에스] – [oz report 3.0] 메뉴에서 [OZ

Repository Manager]를 클릭합니다.

오즈 리파지토리 매니저가 실행되면 다음과 같이 오즈 리파지 토리 매니저의 초기

화면이 나타납니다.

140 FORCS Co., LTD

오즈 리파지토리 매니저 실행


FORCS Co., LTD 141

오즈 리파지토리 매니저 윈도우

메뉴바 툴바

아이템 정보 창

그룹 /카테고리 트리창 속성/로컬 탐색/상태 정보 창

메뉴오즈 리파지토리 매니저의 메인 메뉴이며 풀다운(pull

down) 형식으로 제공합니다.

툴바오즈 리파지토리 매니저의 기능을 쉽고 빠르게 사용할 수

있도록 메뉴바 아래 아이콘 형태로 제공합니다.

그룹/카테고리 트리창카테고리와 그룹과 관련된 정보를 트리 구조로

보여줍니다.

아이템 정보 창

특정 그룹 또는 카테고리를 선택할 경우 해당 그룹이나

카테고리에 포함된 사용자 혹은 아이템을 리스트 구조로

보여줍니다.

속성/로컬 탐색/상태

정보 창

탭 형식으로 구성되어 카테고리/아이템 및 그룹/사용자

속성 및 로컬 컴퓨터 탐색, 각종 액션에 대한 실행 결과 및

상태 정보들을 보여줍니다. [속성] 탭에서는 이름 및 상세

정보 변경이 가능합니다.

파일 메뉴바의 [File]을 선택하면 아래와 같은 풀다운 메뉴가 나타납니다.

리파지토리 열기(Ctrl+R)오즈 리파지토리 매니저에 연결합니다.

리파지토리 닫기(Ctrl+E)

오즈 리파지토리 매니저와의 연결을 끊습니다.

새로고침(Ctrl+F)오즈 리파지토리 매니저의 상태를 새로고침 합니다.

142 FORCS Co., LTD

오즈 리파지토리 매니저의 메뉴


작업 폴더 설정

작업할 리파지토리 루트를 설정합니다.

작업 폴더로 이동

[작업 폴더 설정]에서 설정한 작업 폴더로 이동합니다.

닫기

오즈 리파지토리 매니저를 종료합니다.

FORCS Co., LTD 143

리파지토리

새로 만들기

새로운 그룹/사용자 혹은 카테고리/아이템을 생성합니다.

삭제

선택한 그룹/사용자 혹은 카테고리/아이템을 삭제합니다.

다운로드

서버에 있는 카테고리/아이템을 로컬 리파지토리로 가져옵니다.

체크아웃

서버 리파지토리에 있는 파일을 편집하기 위해 체크 아웃하여 파일을

가져옵니다.

체크인

변경된 파일을 서버 리파지토리에 올립니다.

체크아웃 취소

체크 아웃을 취소합니다.

히스토리

사용자가 리파지토리 서버에 있는 카테고리 및 아이템에 대해 체크 아웃한 후

144 FORCS Co., LTD


수정하여 체크인하게 되면 관련 정보들이 서버에 히스토리로 남겨져

관리되는데 현재 선택한 아이템에 대한 히스토리 정보를 별도 창으로

보여줍니다.

그룹 관리자 설정

현재 선택한 사용자를 그룹 관리자로 설정합니다.

그룹 관리자 해제

설정된 그룹 관리자를 해제합니다.

속성

그룹/ 사용자, 카테고리/아이템에 대한 속성들을 보여줍니다.

권한

카테고리 및 아이템의 그룹이나 사용자별 보기 혹은 읽기, 쓰기 등의 권한들을

설정합니다.

도구

작업창(Alt+0)

그룹 및 카테고리 트리 창을 숨기거나 볼 수 있게 합니다.

보고창(Alt+1)

속성 및 로컬 컴퓨터 탐색, 액션 실행 결과 및 상태를 보여주는 창을 숨기거나

볼 수 있게 합니다.

메인 툴바(Alt+2)

각종 아이콘으로 기능을 손쉽게 사용할 수 있는 툴바를 숨기거나 볼 수 있게

합니다.

FORCS Co., LTD 145

언어

한국어, 일본어, 영어로 언어를 변경할 수 있습니다. 설정하고자 하는 언어를

선택하면 변경된 언어를 적용하기 위해 프로그램을 다시 시작해야 한다는

메시지가 나타납니다. [확인] 버튼을 클릭하면 변경된 언어가 적용된

리파지토리 매니저가 재실행됩니다.

도움말

OZRepositoryManger 정보

오즈 리파지토리 매니저의 버전과 빌드 정보 등을 보여줍니다.

146 FORCS Co., LTD


서버 접속

서버 리파지토리 연결

메뉴의 [파일] – [리파지토리 열기]를 클릭하거나 아이콘을 클릭하면 서버 리파지토리에 접속할 수 있는 창이 나타납니다.

서버

접속 정보

종류

데몬형은 포트를 갖기 때문에 TCP를

선택하고, 서블릿형은 URL을 접근하기 때문에

HTTP를 선택합니다.

IP

서버 타입을 TCP로 선택했을 경우 오즈

서버가 설치되어 있는 호스트 컴퓨터의 IP를

설정합니다.

포트서버 타입을 TCP로 선택했을 경우 서버가

사용하는 TCP 포트를 설정합니다.

URL

서버 타입을 HTTP로 선택했을 경우 서블릿에

접근 가능한 URL을 설정합니다. 웹에서 오즈

서블릿의 메인 페이지를 호출하는 URL을

설정하면 됩니다.

FORCS Co., LTD 147

오즈 리파지토리 매니저의 기능

사용자

로그인 정보

이름

리파지토리 서버에 등록된 사용자 계정을

입력합니다.

※ 사용자 계정에는 모든 권한을 가진 ‘admin’ 계정과 디폴트인 ‘guest’ 계정이

있습니다. ‘guest’ 계정에는 아무런

권한이 없기 때문에 보고서 폼을 호출하기

위해서는 반드시 권한을 설정해야만

합니다.

패스워드리파지토리 서버 계정에 대한 패스워드를

입력합니다.

[리파지토리 열기] 창에서 각 항목을 입력한 후 [확인] 버튼을 클릭하면 다음과 같이

접속된 서버의 카테고리들이 나타납니다.

서버 리파지토리 연결 끊기

메뉴의 [파일] – [리파지토리 닫기]를 클릭하거나 아이콘을 클릭하면 서버

리파지토리에 연결을 끊습니다.


작업 폴더는 리파지토리 매니저가 리파지토리 서버로부터 파일을 복사받아

148 FORCS Co., LTD


저장하는 로컬 작업 폴더입니다. 작업 폴더는 리파지토리를 이용한 파일의 공유

과정에서 매우 중요한 역할을 담당하는 부분으로 특별한 설정이 없다면 오즈

리파지토리 매니저가 설치된 폴더와 같은 위치에 자동으로 생성됩니다.

작업 폴더 기본 값

오즈 리파지토리 매니저가 설치된 폴더가 다음과 같다면

C:\Program Files\Forcs\OZ Report 3.0\OZ Repository Manager

리파지토리 매니저의 기본 작업 폴더는 아래와 같이 설정됩니다.

C:\Program Files\Forcs\OZ Report 3.0\Repository

해당 폴더가 존재하지 않을 경우 자동으로 폴더가 생성됩니다.


작업 폴더로 설정하고자 하는 루트를 선택한 후 메뉴의 [파일] – [작업 폴더

설정] 혹은 아이콘을 클릭하거나 [보고창]의 [로컬 탐색기] 탭에서 원하는

폴더를 선택한 후 마우스 오른쪽 버튼을 클릭하여 [작업 폴더 설정]를

선택합니다.

메뉴의 [파일] – [작업 폴더로 이동] 혹은 아이콘을 클릭하거나 [보고창]

에서 마우스 오른쪽 버튼을 클릭하여 [작업 폴더로 이동]를 선택하면 설정된

작업 폴더로 이동합니다.

FORCS Co., LTD 149

그룹 및 사용자 관리

효율적인 사용자 관리를 위해 사용자 그룹을 지원하며, 유사한 성격이나 권한을

가진 사용자들의 집합을 그룹이라 정의합니다.

그룹 생성

리파지토리 그룹 트리에서 마우스 오른쪽 버튼을 클릭하여 [그룹 생성]을

선택하거나 아이콘을 클릭하여 새로운 그룹을 생성합니다. 새로운 그룹

생성은 ‘admin’만 가능하며, [Repository Group] 루트에서만 하위 그룹을

생성할 수 있습니다.

[그룹 이름 입력]에 생성할 그룹 이름을 설정하면 다음과 같이 새로운 그룹이

추가됩니다.

※ 그룹 이름에는 ‘/’가 포함되어서는 안됩니다.

150 FORCS Co., LTD


그룹 삭제

삭제하고자 하는 그룹을 선택한 후 마우스 오른쪽 버튼을 클릭하여 [삭제]를

선택하거나 아이콘을 선택하여 그룹을 삭제합니다. ‘admin’만 그룹을

삭제할 수 있습니다.

그룹 속성 설정

그룹을 선택한 후 오른쪽 마우스 버튼을 클릭하여 [속성]을 선택하거나

아이콘을 클릭하면 [보고창]의 [속성] 탭에 해당 그룹의 속성을 보여줍니다.

해당 그룹의 이름을 변경할 수 있습니다.

FORCS Co., LTD 151

Group Name은 ‘admin’ 혹은 해당 그룹의 Admin만이 변경 가능합니다.

※ 수정 가능한 부분은 검은색으로 표시되며, 수정 불가능한 부분은 회색

으로 표시됩니다.

사용자 생성

새로운 사용자를 추가하고자 하는 그룹에서 마우스 오른쪽 버튼을 클릭하여

[사용자 추가]을 선택하거나 아이콘을 클릭하여 새로운 사용자를

생성합니다.

※ 추가된 사용자는 <Ctrl키> + Drag&Drop으로 복수의 그룹에 속하게 할

수 있습니다.

기본 정보이름

새로 생성하고자 하는 사용자의 이름을

설정합니다.

패스워드 해당 사용자의 패스워드를 설정합니다.

상세 정보 설명 해당 사용자에 대한 설명을 입력합니다.

계층 정보 그룹

아이디

해당 사용자가 속한 그룹 아이디를 보여줍니다.

152 FORCS Co., LTD


그룹 이름 해당 사용자가 속한 그룹 이름을 보여줍니다.

필요한 정보를 입력하면 다음과 같이 새로운 사용자가 그룹에 생성됩니다.

사용자 삭제

삭제하고자 하는 사용자를 선택한 후 마우스 오른쪽 버튼을 클릭하여 [삭제]를

선택하거나 아이콘을 선택하여 사용자를 삭제합니다.

‘admin’은 모든 사용자를 삭제할 수 있으며, 특정 그룹의 Admin(Group Admin)

은 자신이 속한 그룹에 있는 사용자만 삭제할 수 있습니다.

그룹 관리자 지정

설정하고자 하는 사용자를 선택한 후 마우스 오른쪽 버튼을 클릭하여 [그룹

관리자 설정]을 선택하거나 아이콘을 선택하여 그룹 관리자를

지정합니다. Group Admin은 자신이 속한 그룹에 대해서 새로운 사용자를 추가

FORCS Co., LTD 153

/생성/삭제 할 수 있습니다. 그룹 관리자로 지정된 사용자의 아이콘은

빨간색으로 표시됩니다.

그룹 관리자 지정은 ‘admin’만이 할 수 있습니다다.

사용자 비밀번호 설정

이미 설정된 사용자 비밀번호를 변경할 수 있습니다.

현재 비밀번호 현재 설정되어 있는 비밀번호를 입력합니다.

새로운 비밀번호 새로 설정할 비밀번호를 입력합니다.

새로운 비밀번호 확인 새로 설정한 비밀번호를 다시 입력합니다.

[비밀번호] 창에서 비밀번호를 변경한 후 [확인] 버튼을 클릭하면 새로운

비밀번호가 설정됩니다.

※ ‘admin’ 계정으로 admin의 비밀번호나 다른 계정의 비밀번호를 수정

할 경우 이전 비밀번호를 입력하지 않아도 됩니다.※ 비밀번호는 4~16자여야 합니다.

154 FORCS Co., LTD


사용자 속성 설정

사용자를 선택한 후 오른쪽 마우스 버튼을 클릭하여 [속성]를 선택하거나

아이콘을 클릭하면 [보고창]의 [속성] 탭에 해당 사용자의 속성을 보여줍니다.

[속성] 탭에서 해당 사용자의 이름과 설명을 변경할 수 있습니다.

[사용자 이름]은 ‘admin’과 해당 사용자가 속한 그룹의 Admin만이 변경

가능하며, [사용자 설명]은 해당 사용자, 사용자가 속한 Admin, ‘admin’만이

변경 가능합니다.



카테고리/아이템 관리 오즈 리파지토리에 저장되는 데이터 정보 및 폼 파일들을 아이템이라 하며, 해당

FORCS Co., LTD 155

아이템을 그룹핑한 아이템 그룹을 카테고리로 정의합니다.

오즈 리파지토리 매니저를 이용하여 서버 리파지토리에 카테고리 생성 및 아이템

추가, 삭제, 속성 변경 등을 할 수 있습니다.

카테고리 생성

리파지토리 루트 트리에서 마우스 오른쪽 버튼을 클릭하여 [카테고리 생성]을

선택하거나 아이콘을 클릭하여 새로운 카테고리를 생성합니다. 새로운

카테고리 생성은 ‘admin’이거나 상위 카테고리에 대한 쓰기 권한을 가지고

있는 사용자만 가능합니다.

[카테고리 이름 입력]에 새로 생성할 카테고리 이름을 입력하고 [확인] 버튼을

클릭하면 다음과 같이 새로운 카테고리가 추가됩니다.

※ 카테고리 이름에는 ‘\’, ‘/’, ‘.’, ‘*’, ‘?’, ‘”’, ‘<’, ‘>’, ‘l’ 등이 포함되서는

안됩니다.

156 FORCS Co., LTD


아이템 추가

리파지토리에 새로운 아이템 추가는 로컬 시스템에서 원하는 파일들을

업로드하는 기능으로 제공됩니다. [보고창]의 [로컬 탐색기] 탭에서 작업 폴더로

이동한 후 리파지토리에 추가하기 원하는 파일이나 폴더를 선택하고 [아이템

정보창]으로 드래그&드롭합니다.

파일들을 선택한 상태에서 마우스 오른쪽 버튼을 클릭하여 [리파지토리로

업로드]를 선택하거나 툴바의 아이콘을 클릭하여도 같은 기능을

수행합니다.

※ 아이템은 <Ctrl키> + Drag&Drop으로 복수의 카테고리에 속하도록

링크시킬 수 있습니다. 아이템이 변경될 경우 링크된 모든 아이템들에

변경사항이 적용됩니다.

FORCS Co., LTD 157

선택한 파일들을 다시 한번 확인하기 위해서 다음과 같이 [아이템 업로드]

창이 나타납니다. 각 아이템별로 마우스 오른쪽 버튼을 클릭하여 [선택/

선택취소]를 선택할 수 있습니다.

[아이템 업로드] 창에서 추가할 아이템 리스트를 다시한번 확인하고 [업로드]

버튼을 클릭하면 다음과 같이 새로운 아이템이 추가됩니다.

158 FORCS Co., LTD


추가하고자 하는 아이템이 이미 같은 이름으로 존재할 경우 [파일 업데이트]

창이 나타납니다.

리파지토리에 존재하는 파일을 로컬 파일로 변경하기 위해서는 [예] 버튼을

선택하고 리파지토리 파일을 그대로 유지하기 위해서는 [아니오] 버튼을

선택합니다. [모두 적용] 옵션을 선택하면 현재 추가될 아이템 중에 이미

리파지토리에 존재하는 모든 파일에 대해 동일한 옵션이 적용됩니다.

카테고리 삭제

삭제하고자 하는 카테고리를 선택한 후 마우스 오른쪽 버튼을 클릭하여 [삭제]

를 선택하거나 아이콘을 선택하여 카테고리를 삭제합니다.

FORCS Co., LTD 159

삭제하려는 카테고리 아래에 아이템들이 등록되어 있을 경우 다음과 같이

아이템 삭제 관련 창이 나타납니다.

기본적으로 현재 체크 아웃 상태에 있는 아이템을 제외한 모든 아이템들이

삭제되도록 체크되어 표시됩니다. 필요시 체크 아웃된 아이템을 추가적으로

체크할 수 있습니다.

이름 선택한 카테고리에 있는 아이템들을 보여줍니다.

체크아웃 사용자 해당 아이템을 체크 아웃한 사용자를 보여줍니다.

체크아웃 시간 해당 아이템을 체크 아웃한 시간을 보여줍니다.

체크아웃된 아이템

선택체크하면 체크 아웃된 아이템을 선택합니다.

모두 선택 체크하면 모든 아이템을 선택합니다.

※ 헤더 부분의 Name을 클릭하면 그 항목에 대한 오름차순 또는

내림차순으로 아이템들을 정렬합니다.

삭제하기를 원하는 아이템을 체크하면 [삭제] 버튼을 클릭하면 해당

카테고리의 아이템 및 카테고리가 삭제됩니다. 단, 해당 카테고리에 속한 전체

160 FORCS Co., LTD


아이템이 삭제된 경우에만 카테고리가 삭제됩니다.

카테고리 삭제는 ‘admin’이거나 카테고리에 대한 쓰기 권한이 있는 사용자만

가능합니다.

아이템 삭제

삭제하고자 하는 아이템을 선택한 후 마우스 오른쪽 버튼을 클릭하여 [삭제]를

선택하거나 아이콘을 선택합니다.

[아이템 삭제]에서 삭제하고자 하는 아이템을 선택합니다. 기본적으로

현재체크 아웃 상태에 있는 아이템을 제외한 모든 아이템들이 삭제되도록

체크되어 표시시 체크 아웃된 아이템들을 추가적으로 체크할 수 있습니다.

카테고리 삭제는 ‘admin’이거나 카테고리에 대한 쓰기 권한이 있는 사용자만

가능합니다.

카테고리 다운로드

서버에 있는 카테고리를 로컬 리파지토리로 가져옵니다. 가져오고자 하는

카테고리를 선택한 후 마우스 오른쪽 버튼을 클릭하여 [다운로드]를


FORCS Co., LTD 161

해당 카테고리의 아이템 다운로드 창이 나타납니다.

기본적으로 현재 체크 아웃된 아이템을 제외한 모든 아이템들이 체크되어

표시됩니다. 필요시 체크 아웃된 아이템들은 추가적으로 체크할 수 있습니다.

이름 선택한 카테고리에 있는 아이템들을 보여줍니다.

체크아웃 사용자 해당 아이템을 체크 아웃한 사용자를 보여줍니다.

체크아웃 시간 해당 아이템을 체크 아웃한 시간을 보여줍니다.

체크아웃 된 아이템

선택체크하면 체크 아웃된 아이템을 선택합니다.

모두 선택 체크하면 모든 아이템을 선택합니다.

162 FORCS Co., LTD


다운로드한 아이템들을 선택한 후 [다운로드] 버튼을 클릭하면 로컬 작업

폴더에 서버 리파지토리 카테고리 구조와 동일한 형태로 폴더가 생성되고 해당

폴더로 아이템들이 다운로드 됩니다. 로컬에 이미 같은 이름의 아이템이

존재할 경우 [파일 업데이트] 창이 나타납니다.

이미 로컬에 존재하는 파일을 리파지토리 파일로 변경하기 위해서는 [예]

버튼을 선택하고 로컬 파일을 그대로 유지하기 위해서는 [아니오] 버튼을

선택합니다. [모두 적용] 옵션을 선택하면 현재 다운로드 되는 아이템 중에

이미 로컬에 존재하는 모든 파일에 대해 동일한 옵션이 적용됩니다.

아이템 다운로드

서버에 있는 아이템을 로컬 리파지토리로 가져옵니다. 가져오고자 하는

아이템을 선택한 후 마우스 오른쪽 버튼을 클릭하여 [다운로드]를 선택하거나

아이콘을 선택합니다.

FORCS Co., LTD 163

필요한 아이템을 선택한 후 [다운로드] 버튼을 클릭하면 로컬 [Repository]

폴더로 아이템이 다운로드 됩니다.

이미 같은 이름의 아이템이 존재할 경우 [파일 업데이트] 창이 나타납니다.

로컬 파일로 존재하는 파일을 리파지토리 파일로 변경하기 위해서는 [예]

버튼을 선택하고 로컬 파일을 그대로 유지하기 위해서는 [아니오] 버튼을

선택합니다. [모두 적용] 옵션을 선택하면 현재 추가될 아이템 중에 이미

로컬에 존재하는 모든 파일에 대해 동일한 옵션이 적용됩니다.

카테고리 속성 설정

카테고리를 선택한 후 오른쪽 마우스 버튼을 클릭하여 [속성]를 선택하거나

아이콘을 클릭하면 [보고창]의 [속성] 탭에 해당 카테고리의 속성을

보여줍니다. 해당 카테고리의 이름을 변경할 수 있습니다.

164 FORCS Co., LTD


FORCS Co., LTD 165

[카테고리 이름]과 [카테고리 권한]은 ‘admin’과 해당 카테고리에 쓰기 권한이

있는 사용자만 변경 가능합니다.



아이템 속성 설정

아이템을 선택한 후 오른쪽 마우스 버튼을 클릭하여 [속성]을 선택하거나

아이콘을 클릭하면 [보기창]의 [속성] 탭에 해당 아이템의 속성을 보여줍니다.

해당 아이템의 이름을 변경할 수 있습니다.

166 FORCS Co., LTD


[아이템 이름]과 [아이템 권한]은 ‘admin’과 해당 카테고리에 쓰기 권한이 있는

사용자만 변경 가능합니다.



버전 관리

오즈 리파지토리 매니저는 다중 사용자(개발자) 환경을 지원하기 위해 강력한

FORCS Co., LTD 167

버전관리 기능을 제공합니다.

다중 사용자 환경에서 파일의 안전한 공유와 갱신을 보장하기 위해 오즈

리파지토리 매니저는 하나의 아이템이 한 명 이상의 개발자에 의해 동시에

수정되거나 갱신되는 것을 허용하지 않습니다. 이를 위해 리파지토리 서버는 어떤

순간에도 각각의 아이템에 대한 수정권한을 오직 한 명의 개발자에게만 부여하고,

리파지토리 서버가 관리하는 파일을 갱신하기 위해서는 반드시 리파지토리

서버로부터 수정 권한을 받도록 제한합니다.

리파지토리 서버에 등록된 파일을 수정/갱신하기 위해서는 다음의 과정을 반드시

따라야 합니다.

• 체크 아웃 기능을 이용하여 파일에 대한 접근 권한을 얻습니다.

• 작업 폴더에 파일을 복사 받아 수정합니다.

• 체크인 기능을 이용하여 파일의 수정 내용을 리파지토리 서버에

등록합니다.

체크 아웃된 아이템이 ‘체크인’ 되거나 ‘체크 아웃 취소’ 되기 전까지 다른

사용자가 동일한 아이템에 대한 편집 권한을 부여받을 수 없기 때문에 팀 단위

공동 작업에서 원활한 프로젝트 진행을 위해서는 공유 파일에 대한 체크 아웃

시간을 최소화하여야 하며, 수정 내용으로 인해 발생할 수 있는 문제를

최소화하기 위해 팀원들과 수정 내용을 공유하는 부가적인 노력이 필요합니다.

체크 아웃

체크 아웃 기능은 카테고리 및 아이템 수정을 위해 리파지토리 서버로부터

특정 카테고리 및 아이템에 대한 수정 권한을 받아오는 기능입니다.

• 카테고리 체크 아웃

카테고리 체크아웃을 이용하면 카테고리에 속한 모든 아이템 및 하위

카테고리에 속한 아이템을 체크아웃 할 수 있습니다. 체크 아웃 하고자

하는 카테고리를 선택한 후 마우스 오른쪽 버튼을 클릭하여

[Check Out]을 선택하거나 아이콘을 선택합니다.

168 FORCS Co., LTD


해당 카테고리에 속한 아이템들의 체크 아웃 확인 창이 나타납니다.

해당 카테고리에 속한 아이템 중 이미 체크 아웃 상태에 있는 아이템을

제외한 모든 아이템이 체크되어 표시됩니다.

이름선택한 카테고리에 있는 아이템을 보여줍니다. 체크

아웃 하고자 하는 아이템을 선택할 수 있습니다.

체크인 시간 해당 아이템의 체크 인 시간을 보여줍니다.

아이템

다운로드 및

로컬 파일

업데이트

선택한 아이템을 체크아웃 함과 동시에 로컬 시스템의

작업 폴더에 있는 해당 아이템 파일을 리파지토리

파일로 변경합니다.

모두 선택 모든 아이템을 선택합니다.

체크아웃 하고자 하는 아이템을 선택한 후 [체크아웃] 버튼을 클릭하면 선택된

FORCS Co., LTD 169

아이템을 다음과 같이 빨간색 아이콘으로 표시되며, 수정 권한이 주어진 체크

아웃된 아이템임을 알려줍니다.

• 아이템 체크 아웃

체크 아웃 하고자 하는 아이템들을 선택한 후 마우스 오른쪽 버튼을

클릭하여 [체크아웃]을 선택하거나 아이콘을 선택합니다.

해당 아이템들의 체크 아웃 확인 창이 나타납니다. 선택한 아이템 중 이미

체크 아웃 상태에 있는 아이템을 제외한 모든 아이템들이 체크되어

표시됩니다.

170 FORCS Co., LTD


이름 체크 아웃 하고자 하는 아이템을 보여줍니다.

체크인 시간 해당 아이템의 체크 인 시간을 보여줍니다.

아이템 다운로드 및

로컬 파일 업데이트

선택한 아이템을 체크아웃 함과 동시에 로컬

리파지토리로 다운로드 합니다.


체크 아웃 하고자 하는 아이템들을 선택한 후 [체크아웃] 버튼을 클릭하면

선택된 아이템들을 다음과 같이 빨간색 아이콘으로 표시하여 수정 권한이

주어진 체크 아웃된 아이템임을 알려줍니다.

FORCS Co., LTD 171

체크 인

체크 인은 리파지토리 서버로부터 체크 아웃 후 수정된 내용을 다시

리파지토리 서버에 저장하고 수정 권한을 반납하는 기능입니다.

• 카테고리 체크 인

카테고리 체크인을 이용하면 카테고리에 속한 모든 아이템 및 하위

카테고리에 속한 아이템을 체크인 할 수 있습니다. 체크 인 하고자 하는

카테고리를 선택한 후 마우스 오른쪽 버튼을 클릭하여 [체크인]을


해당 카테고리에 속한 카테고리의 체크 인 확인 창이 나타납니다. 해당

카테고리에 속한 아이템 중 현재 체크 아웃 상태에 있는 모든 아이템이

172 FORCS Co., LTD


체크되어 표시됩니다.

이름 체크 인하고자하는 아이템을 보여줍니다.

체크아웃 시간 해당 아이템의 체크 아웃한 시간을 보여줍니다.

체크아웃 상태

유지

선택한 아이템을 체크 인 후에도 계속 체크 아웃

상태를 유지할지 여부를 설정합니다. [Keep Check

Out]을 설정하면 체크 인 후에도 해당 아이템이 계속

체크 아웃된 상태로 보여집니다.


체크 인 하고자 하는 아이템을 선택한 후 [체크인] 버튼을 클릭하면 체크

아웃되었던 아이템이 다음과 같이 수정 권한을 반납한 원래의 아이콘으로

표시됩니다.

FORCS Co., LTD 173

174 FORCS Co., LTD


• 아이템 체크 인

체크 인 하고자 하는 아이템들을 선택한 후 마우스 오른쪽 버튼을

클릭하여 [체크인]을 선택하거나 아이콘을 선택합니다.

해당 아이템들의 체크 인 확인 창이 나타납니다. 현재 체크 아웃 상태에

있는 모든 아이템이 체크되어 표시됩니다.

이름 체크 인하고자하는 아이템을 보여줍니다.


체크아웃 상태

유지

선택한 아이템을 체크 인 후에도 계속 체크 아웃

상태를 유지할지 여부를 설정합니다. [Keep Check

Out]을 설정하면 체크 인 후에도 해당 아이템이 계속

체크 아웃된 상태로 보여집니다.


체크 인 하고자 하는 아이템을 선택한 후 [체크인] 버튼을 클릭하면 체크

아웃되었던 아이템이 다음과 같이 수정 권한을 반납한 원래의 아이콘으로

표시됩니다.

FORCS Co., LTD 175

체크 아웃 취소

체크 아웃 취소 기능은 체크 아웃된 카테고리 및 아이템의 수정사항을

리파지토리 서버에 반영하지 않고 단순히 수정 권한을 반납하는 기능입니다.

• 카테고리 체크 아웃 취소

체크 아웃을 취소합니다. 체크 아웃했던 카테고리를 선택한 후 마우스

오른쪽 버튼을 클릭하여 [체크아웃 취소]을 선택하거나 아이콘을 선택합니다.

176 FORCS Co., LTD


해당 카테고리의 체크 아웃 취소 확인 창이 나타납니다.

이름 체크 아웃 취소하고자 하는 아이템을 보여줍니다.



및 로컬 파일

업데이트

선택한 아이템을 체크아웃 취소함과 동시에 로컬

시스템의 작업 폴더에 있는 해당 아이템 파일을

리파지토리 파일로 변경합니다.


체크 아웃 취소하고자 하는 아이템을 선택한 후 [체크아웃 취소] 버튼

을 클릭하면 체크 아웃이 취소됩니다.

FORCS Co., LTD 177

• 아이템 체크 아웃 취소

체크 아웃을 취소합니다. 체크 아웃했던 아이템을 선택한 후 마우스

오른쪽 버튼을 클릭하여 [체크아웃 취소]을 선택하거나 아이콘을 선택합니다.

해당 아이템의 체크 아웃 취소 확인 창이 나타납니다.

이름 체크 아웃 취소하고자하는 아이템을 보여줍니다.



및 로컬 파일

업데이트

선택한 아이템을 체크아웃 취소함과 동시에 로컬

시스템의 작업 폴더에 있는 해당 아이템 파일을

리파지토리 파일로 변경합니다.


체크 아웃 취소하고자 하는 아이템을 선택한 후 [체크아웃 취소] 버튼

을 클릭하면 체크 아웃이 취소됩니다.

아이템 히스토리 관리

사용자가 리파지토리 서버에 있는 아이템을 체크 아웃하여 수정한 후 체크

178 FORCS Co., LTD


인하게 되면 체크인과 관련된 정보들이 서버에 히스토리로 기록됩니다.

해당 아이템에서 마우스 오른쪽 버튼을 클릭하여 [히스토리 보기]를


다운로드

히스토리에 저장된 이전 버전의 아이템을 로컬 시스템에

다운로드 합니다.(해당 아이템에 대한 권한이 Read 권한

이상일 때 가능)

롤백

해당 아이템을 히스토리에서 선택한 이전 버전의

아이템으로 되돌립니다.(해당 아이템에 대한 권한이

Write 권한 이상일 때 가능)

삭제선택한 아이템 이후의 히스토리를 삭제합니다. (해당

아이템에 대한 권한이 Write 권한 이상일 때 가능)

권한 설정

리파지토리 매니저는 카테고리 및 아이템에 대해 그룹/사용자 단위로 권한을

설정할 수 있습니다.

※ 단, 카테고리나 아이템에 권한을 주기 위해서는 [Repository Root]에 ‘읽

기’ 이상의 권한이 있어야 합니다. 만약 권한이 없는 경우 어떤 카테고리나

아이템도 읽어올 수 없습니다. 또한, 하위 카테고리의 권한은 상위 카테고리의

권한 이상이여야 합니다.

해당 카테고리 혹은 아이템에서 마우스 오른쪽 버튼을 클릭하여 [권한]을


FORCS Co., LTD 179

카테고리 권한 /

아이템 권한

권한을 설정하고자 하는 카테고리/아이템의 이름을

보여줍니다.

그룹/사용자해당 카테고리/아이템의 권한을 가지고 있는 그룹/

사용자를 보여줍니다.

권한

권한 종류 즉, [권한]을 보여줍니다.

보기 카테고리/아이템의 보기 권한만 가능합니다.

읽기

카테고리/아이템을 보거나 로컬 시스템에

다운로드 하여 열람할 수 있습니다. 단, 속성

변경이나 체크 인, 체크 아웃, 권한 설정 등의

수정 권한은 없습니다.

쓰기

카테고리/아이템을 열람하거나 다운로드 및

체크 인, 체크 아웃, 속성 변경, 권한 설정 등

모든 작업이 가능합니다.

추가 새로운 그룹 혹은 사용자를 추가합니다.

삭제 선택한 그룹 혹은 사용자를 삭제합니다.

업데이트해당 카테고리/아이템의 권한을 수정하거나 추가한

결과가 적용됩니다.

[추가] 버튼을 클릭하면 그룹/사용자 트리에서 새로운 그룹 혹은 사용자를 추가할

수 있습니다.

180 FORCS Co., LTD


FORCS Co., LTD 181

Ⅷ. 오즈 컨트롤 명령어

오즈 엔터프라이즈 서버 Shell Command

오즈 스케줄러 Shell Command

개요

Windows의 명령 프롬프트 및 Unix의 Command Line에서 오즈 서버를 관리하는

기능을 제공합니다.

로컬 뿐 아니라 원격상에 있는 오즈 서버 데몬이나 서블릿을 관리할 수 있습니다.

기본 사용법

Windows

Windows의 경우 <OZSERVER_HOME>\bin\ozcntrl.bat

Unix

Unix의 경우 <OZSERVER_HOME>/bin/ozcntrl.sh

사용법

ozcntrl [-command] [-arg_name:arg_value...] [-option...]

예

• 각 옵션들을 Command 아큐먼트로 입력하는 경우

ozcntrl -version -ip:211.116.251.60 –port:8001 –id:admin –pwd:admin

• 각 옵션들을 대화식으로 입력하는 경우

ozcntrl -testsdm

ozcntrl 　

이와 같이 명령어만 입력하면 ozcntrl은 필요한 옵션들을 차례로 묻게

됩니다.

• 각 옵션들을 서버 설정 정보 파일에 저장하는 경우

ozcntrl –regsrv를 이용해서 관리할 서버 정보를 파일에 기록할 수

있습니다.

ozcntrl –regsrv를 통해 생성된 정보는 ozashell.properties라는 파일에

저장되므로 다음부터는 서버에 관한 정보(url or ip/port, id, password)를

182 FORCS Co., LTD

오즈 엔터프라이즈 서버 Shell Command


입력할 필요가 없습니다.

단, 이 경우라도 사용자가 command Line에서 -ip, -port 등의 지정하는

경우, 이 정보가 우선합니다.

명령어(Command) 목록

ozcntrl -help 참고

Arguments아규먼트들은 다음의 세 가지 Source로부터 입력 받게 됩니다.

Source A

ozcntrl –regsrv를 통해 컴퓨터에 기록된 파일(ozashell.properties. 서버의 주소

및 사용자 ID/Password를 저장하고 있습니다)

Source B

Command argument

Source C

Interactive한 User Input

아규먼트들은 위의 Source로부터 읽어 들이는 순서에 따라 다음의 세가지 형태로

나눌 수 있습니다.

• Type 1

Source B → Source A → Source C의 순으로 아큐먼트를 검색합니다.

Server Address 아규먼트들이 이에 해당합니다.

• Type 2

Source B → Source C의 순으로 아규먼트를 검색합니다.

Server Address 외에 작업을 수행하는데 반드시 필요한 아규먼트들이

이에 해당합니다.

예) 보고서 이름. 그룹 이름. User Input Parameter

FORCS Co., LTD 183

• Type 3

Source B에서만 아규먼트를 검색합니다.

옵션으로 주어진 아규먼트들이 이에 해당합니다.

예) -xml 등

공통으로 사용하는 아규먼트

Command 의미 Example Type

urlHTTP-Server

(Servlet) URL-url:http://127.0.0.1:8080/oz/server 1

ipTCP-Server

(Daemon) Address-ip:127.0.0.1 1

portTCP-Server

(Daemon) Port-port:8002 1

id ID -id:admin 1

pwd Password -pwd:admin 1

fn File Name -fn:d:/test.xml 2

rn Report Name -rn:/susb/report1 2

gn report Group Name -gn:/susb 2

pm ParaMeters

-pm:arg1=ttt;arg2=123

-pm:default

(default parameter를 사용)

2

Commands

형식 표기법

Command를 포함한 모든 아규먼트는 생략 가능합니다.

[ ] 는 Type 1 아규먼트를 나타냅니다.

{} 는 Type 2 아규먼트를 나타냅니다.

() 는 Type 3 아규먼트를 나타냅니다.

184 FORCS Co., LTD


기본 명령어

• -help

사용법을 보여줍니다.

형식 : ozcntrl -help

• -regsrv

서버 주소를 등록합니다.

한번 등록한 후에는 아규먼트를 지정하지 않아도 등록한 서버 주소를

사용합니다.

형식 : ozcntrl -regsrv

• -start

오즈 서버 데몬을 실행시킵니다.

형식 : ozcntrl -start {configuration_file_name}

configuration_file_name은 오즈 서버 데몬의 설정 파일입니다. 지정하지

않으면 클래스 경로에서 ozserver.properties를 찾습니다.

예)

ozcntrl -start

ozcntrl -start d:/server2.properties

• -stop

오즈 서버 데몬을 중지합니다(서블릿 타입의 서버는 종료시킬 수

없습니다).

형식 : ozcntrl –stop [SERVER–LOCATION]

SERVER–LOCATION는 다음과 같은 형식입니다.

–ip : ip_address –port:port_number

예)

ozcntrl –stop

ozcntrl –stop –ip:127.0.0.1 –port:8003

FORCS Co., LTD 185

• -version

오즈 서버 및 서버가 설치되어 있는 시스템 버전 정보를 확인합니다. 오즈

서버에 접속하여 정보를 가져오므로 서버 정보는 반드시 명시하여야

합니다.

형식 : ozcntrl –version[SERVER–INFO]

예)

ozcntrl –version

ozcntrl –version –url:http://211.116.251.60:8080/oz/server

ozcntrl –version –ip:211.116.251.60 –port:8080 –id:admin

–pwd:admin

• -local.version

-version은 원격에서 실행되는 서버 버전까지 알려주는데 반해 로컬

시스템만 지원하며, 현재 ozcntrl이 사용하고 있는 ozrd30.jar과

ozsfw30.jar의 버전을 알려줍니다.

형식 : ozcntrl –local.version

예)

ozcntrl –local.version

• -testsdm

SDM 형식의 파일을 읽어 데이터 내용을 확인해 줍니다.

형식 : ozcntrl –testsdm {–fn:sdm_file_name} (–xml)

–fn : 테스트할 sdm 형식의 파일을 지정합니다.

xml : 이 옵션을 주면 데이터 모듈을 XML 형태로 파일에 기록합니다.

기록되는 파일의 위치는 ./sdmtest.xml입니다.

예)

ozcntrl –testsdm

ozcntrl –testsdm –fn:/temp/report1.sdm –xml

186 FORCS Co., LTD


Repository Manager 관련 명령어

• -repository.setcfg

Repository Manager의 설정값을 세팅합니다.

형식 : ozcntl –repository.setcfg [SERVER– LOCATION]

{–rp:repository_path}

예)

ozcntl –rpt.setcfg

ozcntl –rpt.setcfg –url:http://127.0.0.1:8080/oz/server

• -repository.getcfg

Reository Manager의 설정값을 확인합니다.

형식 : ozcntl –repository.getcfg [SERVER–LOCATION]

예)

ozcntl –rpt.getcfg

ozcntl –rpt.getcfg –url:http://127.0.0.1:8080/oz/server

• -repository.dn

Repository의 아이템 파일을 다운로드 합니다.

형식 : ozcntl –repository.dn [SERVER–INFO]

예)

ozcntl –rpt.dn

ozcntl –rpt.dn –url:http://127.0.0.1:8080/oz/server

Cache Manager 관련 명령어

• -cache.setcfg

캐시 매니저의 설정값을 세팅합니다.

형식 : ozcntl –cache.setcfg [SERVER–INFO]

{–active:cache_manager_activity –free:free_memory_percentage

–default:default_caching_time_out -rp:repository_path}

–active : 캐시 매니저 활성화 여부를 true/false로 설정합니다.

FORCS Co., LTD 187

–free : Total Memory 대비 Free Memory의 비율이 이 이하로 떨어지면

파일로 캐싱하도록 저장합니다.

–default : 캐싱 타임아웃을 지정하지 않은 보고서에 적용할 기본

타임아웃을 지정합니다.

단위는 초이며, 0을 세팅하면 디폴트 타임아웃은 사용하지

않습니다. 최대 30분(1800초)까지 지정 가능합니다.

–rp : 파일로 캐싱할 때의 저장 경로입니다.

예)

ozcntl –cache.setcfg

ozcntl –cache.setcfg –url:http://127.0.0.1:8080/oz/server

–active:true –free:20

ozcntl –cache.setcfg –url:http://127.0.0.1:8080/oz/server

–active:true –default:60 –rp:%OZ_HOME%/cache

ozcntl –cache.setcfg –free:10 –default:30

세팅하지 않는 값들에는 변화가 없습니다.

• -cache.getcfg

캐시 매니저의 설정값을 확인합니다.

형식 : ozcntl –cache.getcfg [SERVER–INFO]

예)

ozcntl –cache.getcfg

ozcntl –cache.getcfg –url:http://127.0.0.1:8080/oz/server

　

　Connection Pool 관련 명령어

• -cp.status

데이터베이스 커넥션 풀의 설정값과 현재 상태를 확인합니다.

형식 : ozcntrl –cp.status [SERVER–INFO]

예)

ozcntrl –cp.status

ozcntrl –cp.status –ip:127.0.0.1 –port:8003

ozcntrl –cp.status –url:http://127.0.0.1:8080/oz/server

188 FORCS Co., LTD


• -cp.set

커넥션 풀의 설정값을 변경합니다.

형식 : ozcntrl –cp.set [SERVER–INFO] {–fn:properties_file}

–fn : connection pool의 설정 값을 기록한 파일명 이 파일의 형식은

db.properties와 동일합니다.

현재 설정되어 있는 커넥션 풀들을 모두 삭제한 후 –fn 옵션에서 지정한

파일에서 정의한 커넥션 풀들을 추가합니다.

예)

ozcntrl -cp.status -fn:new_db.properties

　

Log Manager 관련 명령어

• -log.getcfg

로그 매니저 설정값을 확인합니다.

형식 : ozcntrl –log.getcfg [SERVER–INFO]

예)

ozcntrl –log.getcfg

ozcntrl –log.getcfg –ip:127.0.0.1 –port:8003

ozcntrl –log.getcfg –url:http://127.0.0.1:8080/oz/server

　

• -log.set

로그의 Priority Level을 설정합니다.

형식 : ozcntrl –log.set [SERVER–INFO] {–lp:log_priorty}

log_priority의 값은 DEBUG/INFO/ERROR 중 하나가 올 수 있습니다.

예)

ozcntrl –log.set

ozcntrl –log.set –lp:INFO

ozcntrl –log.set –url:http://127.0.0.1:8080/oz/server

　

• -log.dn

로그 파일을 다운로드 받습니다.

형식 : ozcntrl –log.set [SERVER–INFO] {–fn:filename}

FORCS Co., LTD 189

filename : 로그를 저장할 파일 이름

예)

ozcntrl -log.dn

ozcntrl -log.dn -lp:INFO

ozcntrl -log.dn -url:http://127.0.0.1:8080/oz/server

Monitor 관련 명령어

• -mntr.dn

트랜잭션 모니터 로그를 다운로드 받습니다.

형식 : ozcntrl –mntr.dn [SERVER–INFO] {–fn:filename}

filename : 로그를 저장할 파일 이름

예)

ozcntrl -mntr.dn

ozcntrl -mntr.dn -fn:d:/monitor.log

ozcntrl -mntr.dn -url:http://127.0.0.1:8080/oz/server

Builtin DB 복구 관련 명령어

• -builtin.repair

query.log 파일을 이용하여 db_file.script의 내용을 복구합니다.

형식 : ozcntrl –builtin.repair [SERVER–INFO]

예)

ozcntrl -builtin.repair

ozcntrl -builtin.repair –ip:127.0.0.1 –port:8003

ozcntrl -builtin.repair –url:http://127.0.0.1:8080/oz/server

190 FORCS Co., LTD


개요

스케줄러를 Windows의 Command Line에서 제어할 수 있는 기능을 제공합니다.

GUI를 이용하는 엔터프라이즈 매니저에서 수행할 수 있는 모든 기능을 제공합니다.

기본 사용법

Windows

commander.bat 실행

사용법

commander [required-option] [selective-options]

아규먼트

아규먼트에는 필수 아규먼트와 옵션 아규먼트가 있습니다.

필수 아규먼트

반드시 입력해야 하는 옵션입니다.

어떤 일을 할 것인지 명시합니다.

-editConfig 스케줄러의 설정 항목들을 조회하고 수정합니다.

-load 스케줄링 태스크 정보를 별도의 파일에서 스케줄러로

로드합니다.

-remove 스케줄된 태스크를 삭제합니다.

-list 스케줄된 태스크 목록을 조회하고 태스크들을 삭제, Pause, Resume

시킵니다.

-result 스케줄된 태스크들의 실행 결과 로그를 조회해 봅니다.

-stop 스케줄러를 종료 시킵니다.

-published 스케줄러의 Published file 들을 브라우징 및 관리합니다.

-restart 스케줄러를 다시 시작합니다.

옵션 아규먼트

선택적으로 사용되는 옵션입니다.

FORCS Co., LTD 191

오즈 스케줄러 Shell Command

-IP:<IP> 스케줄러의 IP (디폴트 : 127.0.0.1)

-Port:<Port> 스케줄러의 Port 번호 (디폴트 : 9521)

-SIP:<IP> 오즈 서버의 IP (디폴트: 127.0.0.1)

-SPort:<Port> 오즈 서버의 Port (디폴트: 8002)

-SURL:<URL> 오즈 서블릿의 URL

-SID:<ID> 오즈 서버에 접속하기 위한 ID

-SPWD:<PWD> 오즈 서버에 접속하기 위한 패스워드

-file:<FileName> 위 옵션들을 매번 입력할 필요없이 파일에 한번 저장한

다음에 그 파일을 불러올 수 있는데, 그 파일명을 명시해

줍니다. 파일에 없는 옵션은 커맨드 상에서 입력 받을 수

있습니다. 만약 동일한 옵션이 파일과 커맨드 상에서와

동시에 존재한다면, 나중의 것을 사용합니다.

예제는 아래와 같습니다.

Port:9521

sip:211.116.251.89

SPort:8002

SID:admin

SPWD:admin

※ 주) : /q 를 입력하면 Shell Commander를 빠져나갑니다.※ 주) : 각각의 command별로 연관되는 스케줄링 태스크는 옵션상에서

입력한 오즈 서버와 연동되는 스케줄링 태스크입니다.

Commands

기본 Command

• -editConfig

스케줄러 설정 항목들이 리스트 되어 나타납니다.

스케줄러 설정에서 변경 사항들이 대화형식으로 나타납니다.

• -load

스케줄 정보를 정의한 ozs 파일을 로드합니다.

대화형으로 해당 파일명을 입력하게 됩니다.

• -remove

태스크 ID를 입력받아 해당 태스크를 삭제합니다.

192 FORCS Co., LTD


• -list

현재 스케줄된 태스크들의 목록을 보여줍니다.

Launch Type 앞에 (W), (R), (P) 세 가지의 상태가 표시됩니다.

(W) : Waiting 현재 스케줄 대기중인 태스크입니다.

(R) : Running 현재 스케줄되어 실행중인 태스크입니다.

(P) : Scheduling

Pausing

오즈 스케줄의 태스크 실행을 잠시 멈춥니다.

태스크는 다음 실행 시각부터 정상 작동합니다.

다음의 Action을 취할 수 있습니다.

[D] : Download

선택한 스케줄 태스크들을 Text 파일 형식으로

로컬에 다운 받습니다. -load 옵션으로 스케줄링

태스크를 스케줄러에 로드할 때는 본 파일 형식

그대로 다운받게 되며 그 외의 경우에는 암호화된

태스크를 텍스트 형식으로 다운받게 됩니다.

[E] : Eliminate

선택한 스케줄된 태스크들을 삭제합니다. 만약

지정한 태스크가 현재 실행중이라면 삭제 불가능

합니다.

[P] : Pause

선택한 스케줄된 태스크들을 Pause 시킵니다. 만약

지정한 태스크가 현재 실행중이라면 Pause 가

불가능합니다.

[R] : Resume

선택한 Pause된 스케줄된 태스크들을 Resume

(=Waiting 상태) 시킵니다. 만약 지정한 태스크가

현재 실행중이라면 Resume 불가능합니다.

[L] : reload 스케줄된 태스크 리스트를 다시 로드합니다.

• -result

검색조건(First Date, End Date, Task ID)을 입력하여 실행시각이 되어

실행한 태스크들의 실행 결과 로그를 조회합니다.

• -stop

스케줄러를 종료합니다.

• -published

FORCS Co., LTD 193

Published File들의 목록을 조회합니다.

기본 디렉토리로 ‘RepositoryFileRootPath’에 있는 항목이 출력됩니다.

[M] : Mkdir 디렉토리를 생성합니다.

[R] : Rmdir

디렉토리를 제거합니다. 제거하고자 하는

디렉토리들의 번호를 입력한 다음, 그 하위 디렉토리

및 Published File들을 모두 강제로 제거할 것인지를

입력합니다.

[C] : Chdir하위 디렉토리로 경로를 바꾸어 목록을 조회합니다.

바꾸고자 하는 디렉토리의 번호를 입력합니다.

[G] : Get

원하는 파일을 다운로드 합니다. 받고자 하는

파일들의 번호를 입력한 다음, 다운 받고자 하는 로컬

디렉토리 명을 입력합니다.

다음의 Action을 취할 수 있습니다.

[D] : Delete지정한 파일을 삭제합니다. 삭제하고자 하는

파일들의 번호를 입력합니다.

[L] : reload 현 목록을 다시 로드합니다.

• -external

외부 프로그램 들의 목록을 조회합니다.

기본으로 ‘ExternalProgramFilePath’ 항목에 설정됐던 디렉토리가 루트

가 되어 그 아래에 있는 파일 및 디렉토리 항목들이 출력됩니다.

[M] : Mkdir 디렉토리를 생성합니다.

[R] : Rmdir

디렉토리를 제거합니다. 제거하고자 하는

디렉토리들의 번호를 입력한 다음, 그 하위 디렉토리

및 Published File들을 모두 강제로 제거 할 것인지를

입력합니다.

[C] : Chdir하위 디렉토리로 경로를 바꾸어 목록을 조회합니다.

바꾸고자 하는 디렉토리의 번호를 입력합니다.

[G] : Get

원하는 파일을 다운로드 합니다. 받고자 하는

파일들의 번호를 입력한 다음, 다운 받고자 하는 로컬

디렉토리 명을 입력합니다.

[P] : Put 로컬에 있는 파일을 업로드 합니다.

194 FORCS Co., LTD


[D] : Delete지정한 파일을 삭제합니다. 삭제하고자 하는

파일들의 번호를 입력합니다.

[L] : reload 현 목록을 다시 로드합니다.

Load 옵션을 통해 세팅하는 스케줄링 정보 파일 예제

Commander 상이라 많은 양의 정보 모두를 옵션으로 받을 수가 없는 경우 텍스트

파일로부터 로드하게 됩니다.

각 항목들은 엔터프라이즈 매니저에서 스케줄링 태스크를 세팅하는 화면의 각각의

요소와 1:1로 매핑됩니다.

‘_check’로 끝나는 항목을 세팅하려면 항상 ‘check’ 라는 값을 줘야 합니다. (‘true’

가 아님.)

메일로 결과를 보낼 경우, 메시지 내용 부분에 해당하는 ‘mail_text_message=’

필드의 값에 만약 캐리지 리턴 값을 넣을 경우 “\n” 이라고 표시해줘야 합니다.

그리고 내용에 만약 “\n” 이 들어가야 한다면 “\\n”으로 표시해 주어야 합니다. (결국

‘\’ 를 하나씩 더 붙여주는 셈입니다.)

예제

##** Note that if you want to check a '...._check' field, you should write in 'check' as a

value (excluding quotation mark).

## Basic Information

report_name=parameter_test.ozr

category_name=/

## ID & Password of target OZ Server

server_id=admin

server_pwd=admin

## Information for Sending an Email

## If you want to specify two or more person recipients, you should give comma

separated sequence of addresses to recipient fields.

## If you want to insert a line separator in mail message, you should write '\\n'.

mail_check=check

[email protected], [email protected]

FORCS Co., LTD 195

[email protected]

[email protected]

mail_subject=제목

mail_text_message=내용

## Parameters

parameter_count=4

parameter_name_1=[FORM].formparam

parameter_value_1=form1

parameter_name_2=[FORM].odiparam

parameter_value_2=form2

parameter_name_3=parameter_test.odiparam

parameter_value_3=odi1

parameter_name_4=parameter_test.odiparam2

parameter_value_4=odi2

## External Program

external_program_check=check

external_program_command=notepad.bat

## Schedule Time

## launch_type = immediately / once / periodically

launch_type=Periodically

## Once Execution

#execution_year=

#execution_month=

#execution_day=

#execution_hour=

#execution_min=

## Periodicaly Execution

#### Periodically Execution - Start Date Configuration

start_year=2005

start_month=1

196 FORCS Co., LTD


start_day=3

#### Periodically Execution - Days Configuration

## periodically_execution_day_type = daily / weekly / monthly

periodically_execution_day_type=daily

#### Periodically Execution - Days Configuration - Daily

## daily_type = specific_day[daily_every_days] / weekday

daily_type=specific_day

daily_every_days=1

## Periodically Execution - Time Configuration

periodically_execution_time_type=user_defined

## Periodically Execution - Time Configuration - User_Defined

## user_defined_time = ex) 01:10, 04:50, 17:25 ... (in ascending powers)

user_defined_time=11:40

## Data Module Server Store

dm_server_check=check

dm_server_name=parameter_test.sdm

odi_name_list=parameter_test.odi

odi_name_list_category=/

odi_name=parameter_test.odi

odi_category_name=/

odi_parameter_count=2

odi_parameter_name_1=odiparam

odi_parameter_value_1=sdm odi 1

odi_parameter_name_2=odiparam2

odi_parameter_value_2=sdm odi 2

file_export_list=pdf/ozd/html/jpg/xls/doc/svg/txt/ppt/tif/csv

## Excel Local Store

exparg.excel.filename=test.xls

## PDF File Store

FORCS Co., LTD 197

exparg.pdf.filename=test.pdf

exparg.ozd.filename=test.ozd

exparg.html.filename=test.html

exparg.jpg.filename=test.jpg

exparg.word.filename=test.doc

exparg.svg.filename=test.svg

exparg.text.filename=test.txt

exparg.ppt.filename=test.ppt

exparg.tiff.filename=test.tif

exparg.csv.filename=test.csv

198 FORCS Co., LTD

Documents

1 En… · Web viewozcntrl.bat/ozcntrl.sh에서는 JRE 설치 디렉토리 및 서버를 운영하기 위한 각종 클래스 ... 설정 변경, ... $OZ.#EXF_WORD :