Installation Guide - TmaxSoft · 2019-04-09 · 15 Tmax Installation Guide 7) Sun_SPARC (Solaris 2.5, 2.6, 2.7 or 2.8 32bit) 8) Sun_SPARC (Solaris 2.7 or 2.8 64bit) 9) Quit Input

Tmax Installation Guide

Version 3.8

파트번호 : TMIG-0702-05-380

버 전 : Tmax 3.8

개 정 : July 2, 2003

인 쇄 : Sep 20, 2003

Tmax Installation Guide 1

Part Number : TMIG-0702-02-380

Last Revised : 02,July, 2002

Print :

Copyright Information

Copyright©2001 Tmax Soft Co., Ltd. All Rights Reserved.

Tmax Soft Co., Ltd

18F Glass Tower, 946-1, Daechi-Dong, Kangnam-Gu

Seoul, Korea 135-708

This software and documents are made available only under

the terms of the Tmax Soft License Agreement and may be used

or copied only in accordance with the terms of this agreement.

No part of this document may be reproduced, transmitted, or

translated in any form or by any means, electronic, mechanical,

manual, or optical, without the prior written permission of

Tmax Soft Co., Ltd.

Trademark

Tmax, WebtoB, WebT, and JEUS are registered trademarks of

Tmax Soft Co., Ltd.


About This Guide

본 지침서는 미들웨어를 적용한 3-tier 시스템 환경으로 전환하기 위한 첫번째 작업으로써, Tmax와 WebT를 설치하고 테스트 하는 방법에 대해 기술하고 있다.

Chapter 1 설치를 위해 사전에 필요한 시스템 사양에 대해 설명한다. 또한 UNIX 또는 윈도우즈 플랫폼에서 Tmax를 설치하고, 환경을 설정해서 실제 샘플 프로그램을 통해 제품이 제대로 설치가 되었는지를 검증하는 방법에 대해 설명한다.

Chapter 2 UNIX와 윈도우즈 플랫폼에 WebT를 설치하고 테스트하는 내용을 다룬다.

Chapter 3 트랜잭션 관리 프로세스인 TMS 이진파일 생성 및 Apache Web Server 및 Apache JServ를 설치하는 방법, 그리고 하드웨어 및 소프트웨어 요구사항에 대해서 설명한다.

관련서 Getting Started Guide

Tmax Administration Guide

Tmax Reference Guide

Tmax C Programing Guide

Tmax WebT Programming Guide


-- 차 례 -- I. TMAX 설치 .................................................................................................................................................................. 6

1. TMAX를 설치하기 전에 ........................................................................................................................................... 7

1.1 Tmax 정식 패키지 구성 ................................................................................................................................ 7

1.2 CD-ROM의 디렉토리 구성............................................................................................................................ 8

1.3 평가판 Tmax 소프트웨어의 배포 ................................................................................................................ 9

1.4 하드웨어 및 소프트웨어 요구사항............................................................................................................ 10

1.5 Tmax 인스톨러에 대하여 ............................................................................................................................ 11

2. TMAX 시스템의 설치(UNIX) .................................................................................................................................. 12

2.1 콘솔 인스톨러 ............................................................................................................................................... 12

2.2 Tmax Server/Client 설치 ................................................................................................................................ 12

2.3 Tmax Client 설치 ........................................................................................................................................... 19

2.4 환경 설정 및 테스트 ................................................................................................................................... 25

3. TMAX 시스템 설치(WINDOWS NT/2000) ............................................................................................................... 36

3.1 GUI 인스톨러 ................................................................................................................................................ 36

3.2 Tmax Server/Client 설치 ................................................................................................................................ 36

3.3 Tmax Client 설치 ........................................................................................................................................... 48

3.4 환경 설정 및 테스트 ................................................................................................................................... 56

II. WEBT 설치 ............................................................................................................................................................... 65

1. WEBT 를 설치하기 전에 ....................................................................................................................................... 66

1.1 WebT 소프트웨어 배포 ................................................................................................................................ 66

1.2 WebT의 사용 환경........................................................................................................................................ 66

2. WEBT의 설치(UNIX 플랫폼) ................................................................................................................................ 67

2.1 WebT 설치...................................................................................................................................................... 67

2.2 환경 설정 ....................................................................................................................................................... 71

3. WEBT 설치(WINDOWS NT/2000 플랫폼) .............................................................................................................. 72

3.1 WebT Client 설치 ........................................................................................................................................... 72

3.2 환경 설정 ....................................................................................................................................................... 72

4. 라이센스 파일 설치 .............................................................................................................................................. 75

5. WEBT 테스트 .......................................................................................................................................................... 76

5.1 WebtoB/JEUS 환경 ........................................................................................................................................ 77

5.2 Apache/Apache JServ 환경 ............................................................................................................................ 91

III. 부록 .......................................................................................................................................................................... 95


1. TMS 컴파일 ............................................................................................................................................................ 96

1.1 TMS for Oracle DBMS.................................................................................................................................... 96

1.2 TMS for Infomix DBMS ................................................................................................................................. 98

2. APACHE WEB SERVER 및 APACHE JSERV 설치 ..................................................................................................... 101

3. PLATFORM SPECIFICATIONS FOR TMAX PRODUCTS.................................................................................................. 109

3.1 Compaq Tru64 v4.0 on Alpha........................................................................................................................ 109

3.2 Compaq Tru64 v5.0(5.1) on Alpha ................................................................................................................ 110

3.3 HP UX v10.20 on HP9000 Series .................................................................................................................. 110

3.4 HP HP-UX v11.00 on HP9000 Series............................................................................................................ 111

3.5 IBM AIX v4.3.x on RS/6000 ......................................................................................................................... 112

3.6 SUN Solaris v2.5.1(SunOS 5.5.1) on SPARC ............................................................................................... 113

3.7 SUN Solaris v2.6(SunOS 5.6) on UltraSPARC ............................................................................................. 113



3.10 RedHat Linux 7.x on Intel ........................................................................................................................... 116

3.11 Windows NT 4.0 on Intel ............................................................................................................................. 117

3.12 Windows NT 5.0(Windows 2000) on Intel .................................................................................................. 117

3.13 Windows 98 on Intel .................................................................................................................................... 118


Tmax Installation Guide


I. Tmax 설치

1장 에서는 미들웨어 Tmax를 도입하여 개발환경 또는 운용환경에서 사용

할 수 있게 하기 위해 Tmax Server와 Tmax Client를 설치하고 테스트하

는 방법에 대해 설명한다.

Tmax를 설치하기 전에

Tmax 시스템의 설치(UNIX)

Tmax 시스템의 설치(Windows)


1. Tmax를 설치하기 전에

본 절에서는 Tmax 시스템을 설치하기 전에 사용자가 사전에 점검하고 준

비해야 할 사항들에 대해 기술한다.

Tmax 정식 패키지 구성

Tmax 인스톨 CD의 디렉토리 구조

평가판 Tmax 소프트웨어의 배포

하드웨어 및 소프트웨어 요구사항

Tmax 인스톨러에 대하여

1.1 Tmax 정식 패키지 구성

Tmax Installation CD-ROM

- Tmax Server for UNIX(리눅스 포함) ,Windows NT/2000 platform

- Tmax Client for UNIX(리눅스 포함), Windows 95/98/NT/2000 platform

- Tmax Documents

Printed Tmax Manuals

- Tmax Product Overview

- Tmax Installation Guide

- Tmax Getting Started Guide

- Tmax C Programming Guide

- Tmax Administration Guide

- Tmax Reference Manual

- Tmax FDL Reference Manual


- Tmax WebT Programming Guide

- Tmax Error Message Reference Manual

- Tmax UCS Programming Guide

- Tmax Cagent Programming Guide

- Tmax Hostlink Programming Guide

- Tmax RCA Programming Guide

- Tmax RQ Programming Guide

- Tmax Release Notes

Tmax product License and Warranty

1.2 CD-ROM의 디렉토리 구성

㈜TmaxSoft 에서 제공하는 Tmax Installation CD-ROM은 다음과 같은 디렉

토리 구조를 가지고 있다.(Tmax가 지원하는 플랫폼이 추후에 더 증가할 수

있으므로 달라질 수도 있다)

Tmax 인스톨 CD의 디렉토리 구조


CD-ROM의 각 디렉토리들은 다음과 같은 내용을 포함한다.

WebT : WebT Class Library와 데모프로그램

manuals : Tmax와 WebT의 매뉴얼(일문 및 영문 메뉴얼은 필요에 따라 제공)

unix : UNIX용 Tmax Server 엔진과 클라이언트가 포함된 각 플랫폼별

디렉토리와 샘플프로그램

windows : Windows NT/2000용 Tmax Server 설치 프로그램

1.3 평가판 Tmax 소프트웨어의 배포

Tmax 제품은 인터넷을 통해 사용자가 직접 다운로드 하여 테스트 할 수

있는 기회를 제공하고 있다. 제품을 내려 받을 수 있는 URL은 다음과 같다.

http://forum.tmax.co.kr

Tmax와 WebT의 경우 제품을 받아 설치는 할 수 있으나 실제 Tmax의 운

용을 위해서는 ㈜TmaxSoft 로부터 평가판 라이센스를 발급 받아야 하며

평가 기간은 최대 6개월이다. 클라이언트 모듈만을 사용하고자 할때는 라이

센스를 필요로 하지 않는다.

라이센스에 관한 자세한 사항은 “I. 2.4 환경 설정 및 테스트” 에서 자세히

언급하기로 한다.

다음은 Tmax 제품과 관련해서 연락을 취할 수 있는 이메일 주소이다.

버그리포트 : [email protected]

라이센스 발급 : [email protected]

기술지원 홈페이지 : http://forum.tmax.co.kr


1.4 하드웨어 및 소프트웨어 요구사항

Vendor Operating System Engine Version Tmax/WebT

Version

Compaq Tru64 UNIX 64 bit 4.0, 5.0, 5.1 3.8/1.6

GNU/Redhat Linux on Intel Kernel Version 2.X

(RedHat 6.X or higher) 3.8/1.6

32 bit 10.20, 11.0,

10.30 HP HP-UX

64 bit 11.0

3.8/1.6

32 bit 4.3, 5L IBM AIX

64 bit 4.3, 5L 3.8/1.6

32 bit 2.5.1 ~ 2.8,

x86 Sun Solaris on SPARC

64 bit 2.7, 2.8

3.8/1.6

Microsoft Windows NT on Intel 32 bit 4.0, 2000, XP 3.8/1.6

표1. 필요한 시스템 및 운영체제 사양

표1은 Tmax Products(Tmax Server/Client, WebT)에서 지원하는 시스템 및 운

영체제를 나타내며 플랫폼별 요구사항과 같은 자세한 내용은 “부록 3. Platform

Specifications for Tmax Products” 를 참조한다.


1.5 Tmax 인스톨러에 대하여

Tmax 인스톨러는 두가지 형태로 나뉜다. 인스톨러는 압축된 형식의 Tmax

아카이브를 복사하여 압축을 해제하고 필요한 환경변수를 설정해 주며 플

랫폼 별로 적절한 샘플과 Makefile을 제공한다. 두가지 인스톨러는 다음과

같다.

UNIX/Linux 환경에서 사용하는 콘솔 인스톨러

Windows 환경에서 사용하는 GUI 인스톨러.


2. Tmax 시스템의 설치(Unix)

이 절에서는 UNIX 또는 Linux 운영체제에서 Tmax Server/Client 또는

Tmax Client를 설치하는 방법에 대해 설명한다. UNIX 상에 Tmax System

을 설치하지 않는 경우는 이 절을 건너 뛰어도 좋다.

콘솔 인스톨러

Tmax 서버/클라이언트의 설치

Tmax 클라이언트의 설치

환경 설정 및 테스트

2.1 콘솔 인스톨러

UNIX/Linux 환경에서는 별도의 GUI 인스톨러를 제공하지 않는다. 콘솔 인

스톨러는 쉘 스크립트로 만들어 졌으며 ps, grep, sed 등의 콘솔 명령어를

사용한다. 그러므로 인스톨러를 실행하기 전에 사용자는 적절한 PATH를

설정해 줘야 한다. 이들 명령어를 찾지 못하면 인스톨러는 수행되지 않는다.

2.2 Tmax Server/Client 설치

Tmax 시스템의 실제 운영을 위하여 Tmax 서버와 클라이언트를 모두 인

스톨 한다. Tmax 클라이언트만 설치하여 사용하고자 할 때에는 “I. 2.3

Tmax Client 설치” 를 참조한다.


설치 전 준비사항.

1) Tmax 계정을 만든다. root 계정으로 설치해도 되지만, 보통 Tmax 관리

자 계정을 따로 만들 것을 권장한다.

2) 인스톨 환경이 Tmax 의 최소 요구 사항에 합당한지 확인하고 CD-

ROM을 마운트 한다. 각 플랫폼별 최소 요구사항과 CD-ROM의 마운트 방

법은 “부록 3. Platform Specifications for Tmax Products ” 를 참조한다.

3) 설치 스크립트를 실행하기 전에 여러분의 시스템에 대해 몇 가지 확인

해야 할 사항이 있다. 서버에 설치된 운영체제와 아키텍처(32bit or 64bit),

Tmax를 설치하고자 하는 디렉토리의 절대 경로, 그리고 설치 후 테스트를

위해 서버의 IP 주소를 미리 알고 있어야 한다.

4) Tmax 관리자 계정으로 로그인 한다.

5) 마운트 된 CD-ROM 디렉토리로 이동한다.

6) 설치 스크립트를 실행한다.

sh install.sh


설치과정

다음은 Tmax 의 설치과정을 보여주며, #으로 주석처리 되어 있는 부분은

설치 항목에 대한 설명이다. 세부적인 내용과 지원 플랫폼은 버전에 따라

달라질수 있다.

-----------------------------------------------------------------

Contents of License Agreement

. . .

Do you accept all the terms of the license agreement? [y/n] : y

#라이센스 동의를 얻는다. 동의하지 않으면 설치를 중지하고 콘솔창으로 빠져나온다.

From now on, we will try to install. Please Answer to the following questions.

o Select one of the following :

1. Tmax Server/Client

2. Tmax Client

3. WebT for Tmax

4. Quit Installation Program

Select Product : 1

# 설치할 제품을 선택한다. Tmax Server/Client를 설치하고자 하므로 1번을 선택한다.

o Choose Operating System of your Server!

1) COMPAQ_Alpha (Tru64 V4.0 or V5.0 64bit)

2) HP_PA-RISK (HP-UX 10.20 or 11.0 32bit)

3) HP_PA-RISK (HP-UX 11.0 64bit)

4) IBM_PowerPC (AIX 4.2 or 4.3 32bit)

5) IBM_PowerPC (AIX 4.3 64bit)

6) Linux_x86 (RedHat 6.0 or higher 32bit)


7) Sun_SPARC (Solaris 2.5, 2.6, 2.7 or 2.8 32bit)

8) Sun_SPARC (Solaris 2.7 or 2.8 64bit)

9) Quit

Input : 8

# Tmax를 설치하기 위한 플랫폼을 선택한다. Installer는 OS의 아키텍처가

# 32bit인지, 64비트인지 체크하지 않으므로 정확히 시스템 사양을 확인한 후,

# 번호를 선택해야 한다.

# 설치하고자 하는 플랫폼이 항목에 없으면, ㈜티맥스소프트에 문의한다.

You have chosen SunOS 64bit system, are you sure? [y/n] : y

# y를 입력하면, 확인과정을 거친 후 다음 과정으로 넘어간다. ‘n’을 입력하면

# 설치는 종료된다.

o Enter the full path of the directory to install!

ex) /user/tmax/tmax

Input -> /user/tmax_______________________

Checking directory '/user/tmax' : OK

# Tmax를 수퍼유저 또는 일반유저 계정으로 설치할 수 있다. 보기에 나오는

# 디렉토리는 인스톨러를 수행하는 유저 홈디렉토리의 tmax 서브디렉토리를

# 보여준다.

# 설치하고자 하는 디렉토리의 절대경로를 입력한다. 입력하지 않거나 디렉토리를

# 만들 수 없는 경우에는 설치가 자동적으로 중지된다. 여기에서는 tmax 계정의

# 홈디렉토리를 입력하였다.

o Enter the IP Address of your Server!

Input -> 192.168.0.1________

You've input ‘192.168.0.1’, correct? [y/n] : y

# 설치가 끝난 후, Tmax가 정상적으로 동작하는지를 테스트 하기 위해 환경변수인

# TMAX_HOST_ADDR에 설정할 서버의 IP 주소를 입력한다.


# IP 주소 입력을 다시 하려면 ‘n’을 입력한다. 시스템의 IP 주소를 전혀 모른다면

# IP 주소가 틀렸더라도 그냥 ‘y’를 입력하고 다음으로 넘어간다. IP 주소를

# 재설정 하는 부분은 “I. 2.4 환경 설정 및 테스트” 에서 다루고 있다. 설치 시

# 입력하는 값들은 쉘 초기화 파일과 $TMAXDIR/sample/client/tmax.env 에

# 적용된다.

Now, installation is ready! Press RETURN to continue...

( Press Ctrl-C to quit )

# 모든 사항에 대한 입력을 완료하고 RETURN 키를 누르면 설치가 수행된다.

# Ctrl-C 키를 누르게 되면 설치가 중지된다.

===============================================

Step 1 : Making directories and Copying files

===============================================

Tmax core file is copied successfully... OK

Tmax sample files are copied successfully... OK

Extracting Tmax Core....

bin/

bin/tmm

. . .

+-----------------<<< Post-installation >>>---------------+

| Tmax environment variables have been added to your account's |

| scripts(.cshrc , .profile and .bash_profile). Before testing |

| the Tmax, just apply the script in the home directory. |

| |

| # C shell |

| source .cshrc |

| |

| # Bourne/Korn Shell |

| . ./.profile |

| |

| # Bourne again Shell |

| . ./.bash_profile |

+---------------------------------------------------+


# 설치가 끝난 후, 사용자가 해주어야 할 작업이 설명되어 있다.

===========[ Installation is completed successfully ]=============

Tmax Server installation is completed successfully.

Thank you for using Tmax Product!

Technical support center

Homepage : http://www.tmax.co.kr

E-mail : [email protected]

======================================================

설치된 Tmax 시스템의 디렉토리 구조.

slogtlog

ulog

TMAXDIR

config

appbin

bin

lib

log

svct

usrinc

path

sample

license

Tmax Server/Client 설치후의 디렉토리 구조

client

fdl

sdl

server


Tmax Root directory

디렉토리들은 다음과 같은 파일들을 포함한다.

appbin : Tmax를 이용해 개발된 응용 서버프로그램

bin : Tmax 명령과 유틸리티

config : Tmax 시스템 환경파일

lib : Tmax 라이브러리

license : 라이센스 파일

log : 로그 파일(시스템, 유저, 트랜잭션)

path : 프로세스간 통신 시 필요한 파이프

sample : Tmax 샘플 파일 및 디렉토리

svct : 응용 서버프로그램 컴파일 시 필요한 서비스 테이블 파일

usrinc : Tmax 헤더 파일

Tmax Sample directory


client : 클라이언트 샘플 프로그램

server : 서버 샘플 프로그램

fdl : 샘플 필드키 정의 파일(demo.f)

sdl : 샘플 구조체 정의 파일(demo.s)

Note : demo.f와 demo.s는 FDL(Field Definition Language)과 SDL(Structure

Definition Language) 형식의 필드들을 정의하는 파일이다. 사용자는

실제 프로젝트에서 사용할 FDL및 SDL 형식 필드들을 필요에 따라 직

접 만들어서 사용할 수 있다. 여기에 대한 자세한 사항은 Tmax C

Programming Guide 나 Tmax Reference Manual을 참조한다.

설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “I.

2.4 환경 설정 및 테스트” 에 설명되어 있다.


2.3 Tmax Client 설치

Tmax 서버를 설치하고 어플리케이션을 개발하여 Tmax 시스템을 시작하

는데 성공하였다면 실제로 서비스가 수행되는지 다양한 플랫폼에서 확인해

볼 필요가 있다. 사용자는 원하는 곳에 클라이언트를 깔고 클라이언트 프로

그램을 개발하여 서비스를 사용할 수 있다. Tmax 클라이언트 모듈은 라이

센스를 필요로 하지 않으며 홈페이지를 통해 자유롭게 받아서 사용할 수

있다.


1) Tmax Client를 위한 계정 또는 개발자용 계정을 만든다.

2) 인스톨 환경이 Tmax 의 최소 요구 사항에 합당한지 확인하고 CD-

ROM을 마운트 한다. 각 플랫폼별 최소 요구사항과 CD-ROM의 마운트 방

법은 “부록 3. Platform Specifications for Tmax Products ”를 참조한다.

3) 설치 스크립트를 실행하기 전에 여러분의 시스템에 대해 몇 가지 확인

해야 할 사항이 있다. 서버에 설치된 운영체제와 아키텍처(32bit or 64bit),

Tmax를 설치하고자 하는 디렉토리의 절대경로, 그리고 설치 후 테스트를

위해 서버의 IP 주소를 미리 알고 있어야 한다.

4) Tmax 클라이언트 계정으로 로그인 한다.

5) 마운트 된 CD-ROM 디렉토리로 이동한다.

6) Tmax 설치 스크립트를 실행한다.

sh install.sh

설치과정


다음은 설치과정을 보여주며, #으로 주석처리 되어 있는 부분은 설치 항목

에 대한 설명이다. 세부적인 내용과 지원 플랫폼은 버전에 따라 달라질수

있다.

-----------------------------------------------------------------


. . .


#라이센스 동의를 얻는다. 동의하지 않으면 설치가 중지된다.

From now on, we will try to install. Answer to the questions please.



2. Tmax Client

3. WebT for Tmax


Select Product : 2

# 설치할 제품을 선택한다. Tmax 클라이언트만 설치하고자 하므로 2번을 선택한다.

o Choose Operating System!

1) COMPAQ_Alpha (Tru64 V4.0 or V5.0 64bit)

2) HP_PA-RISK (HP-UX 10.20 or 11.0 32bit)

3) HP_PA-RISK (HP-UX 11.0 64bit)

4) IBM_PowerPC (AIX 4.2 or 4.3 32bit)

5) IBM_PowerPC (AIX 4.3 64bit)

6) Linux_x86 (RedHat 6.0 or higher 32bit)

7) Sun_SPARC (Solaris 2.5, 2.6, 2.7 or 2.8 32bit)

8) Sun_SPARC (Solaris 2.7 or 2.8 64bit)

9) Quit


Input : 4

# Tmax를 설치하기 위한 플랫폼을 선택한다. Installer는 OS의 아키텍처가

# 32bit인지, 64비트인지 체크하지 않으므로 정확히 시스템 사양을 확인한 후,

# 번호를 선택해야 한다.

# 설치하고자 하는 플랫폼이 항목에 없으면, ㈜티맥스소프트에 문의한다.

You have chosen AIX 32bit system, are you sure? [y/n] : y

# y를 입력하면, 확인과정을 거친 후 다음으로 넘어간다. n을 입력하면 설치는

# 종료된다.

o Enter the full path of the directory to install!

ex) /home/tmax/tmax

Input -> /home/tmax_______________________

Checking directory '/home/tmax' : OK

# Tmax를 수퍼유저 또는 일반유저 계정으로 설치할 수 있다. 보기에 나오는

# 디렉토리는 인스톨러를 수행하는 유저 홈디렉토리의 tmax 서브디렉토리를

# 보여준다.

# 설치하고자 하는 디렉토리의 절대경로를 입력한다. 입력하지 않거나 디렉토리를

# 만들 수 없는 경우, 설치는 중지된다. 여기에서는 tmax 계정의 홈디렉토리를

# 입력하였다.

o Enter the IP Address of your Server!

Input -> 192.168.0.1________

You've input ‘192.168.0.1’, correct? [y/n] : y

# 설치가 끝난 후, Tmax가 정상적으로 동작하는지를 테스트 하기 위해 환경변수인

# TMAX_HOST_ADDR에 설정할 서버의 IP 주소를 입력한다.

# IP 주소 입력을 다시 하려면 ‘n’을 입력한다. 시스템의 IP 주소를 전혀 모른다면

# IP 주소가 틀렸더라도 그냥 ‘y’를 입력하고 다음으로 넘어간다. IP 주소를

# 설정하는 부분은 “I. 2.4 환경 설정 및 테스트” 에서 다루고 있다. 설치 시 입력하는


# 값들은 쉘 초기화 파일과 $TMAXDIR/sample/client/tmax.env 에 적용된다.



# 모든 사항에 대한 입력을 완료하고 RETURN 키를 누르면 설치가 수행된다.

# Ctrl-C 키를 누르게 되면 설치가 중지된다.

===============================================================

Step 1 : Copying necessary files

===============================================================

sun32_cli.tar is copied successfully... OK

sun32sample.tar is copied successfully... OK

Extracting Tmax client library....

x bin, 0 bytes, 0 tape blocks

x bin/sdlc, 50080 bytes, 98 tape blocks

. . .

+-----------------<<< Post-Installation >>>---------------+

| Tmax environment variables have been added to your account's |

| script(.cshrc and .profile). Before testing the Tmax, please adjust |

| the script in the home directory. |

| |

| # C shell |

| source ~/.cshrc |

| |

| # Bourne/Korn Shell |

| . ./.profile |

| |

| # Bourne again Shell |

| . ./.bash_profile |

+----------------------------------------------------+

# 설치가 끝난 후, 사용자가 해주어야 할 작업이 설명되어 있다.

===========[ Installation is completed successfully ]=============

Tmax Client installation is completed successfully.



Technical support center

Homepage: http://www.tmax.co.kr


======================================================


Tmax Root Directory


bin : 유틸리티(fdlc, sdlc)

lib : Tmax 클라이언트 라이브러리



Sample Directory





Tmax 클라이언트 설치 후의 디렉토리 구조

TMAXDIR

bin

lib

sample

usrinc

client

fdl

sdl


설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “I. 2.4

환경 설정 및 테스트” 에 설명되어 있다.


2.4 환경 설정 및 테스트

본 절에서는 Tmax 서버와 클라이언트의 설치를 마친 후 실제 운용을 하는

예를 보여준다. 앞서의 인스톨 과정이 이상없이 끝났다면 TP-Monitor가

제공하는 막강한 기능들을 손쉽게 활용할 수 있을 것이다.

라이센스 파일 설치

Tmax 서버 시스템을 운영하거나 WebT를 통해 Tmax의 서비스를 이용하

고자 할 때는 설치 후에 반드시 라이센스 파일의 설치가 이루어져야 한다.

Tmax 클라이언트만 설치한 시스템이라면 이 절을 건너 뛰어도 좋다.

Tmax 클라이언트는 라이센스를 별도로 필요로 하지 않는다.

Tmax 제품군에 대한 라이센스는 옵션별로 나뉘어 지며, 그 내용은 다음과

같다.

Domain Gateway : 서로 다른 Tmax 도메인 간에 통신을 할 수 있는 시스템

Reliable Queue : 신뢰성 큐를 사용하고자 하는 시스템

HostLink : Tmax 서버와 Main Frame과의 연동을 위해 필요한 시스템

WebT : Web에서 Tmax의 서비스를 이용할 수 있는 시스템

사용자가 Tmax의 기본 기능 또는 그 이외에 위와 같은 기능을 추가적으로

사용하고자 할 경우, 라이센스를 ㈜Tmax Soft 로부터 발급 받아야 한다.

라이센스는 온라인 TmaxSoft 홈페이지 또는 E-mail을 통해 접수가 가능

하며, Tmax가 필요로 하는 양식에 맞춰 정보를 기입하면 원하는 라이센스

파일을 받아 설치할 수 있다. 라이센스를 발급받기 위하여 사용자는 Tmax

제품의 설치를 끝마친 후 아래와 같은 시스템 정보를 체크하는 유틸리티를

실행하여 그 결과를 라이센스 발급처에 알려주어야 한다. 보낼 email 주소

는 “I. 1.3 평가판 Tmax 소프트웨어의 배포” 를 참고한다.


Tmax 시스템이 정상적으로 설치 되었다면, license 디렉토리 내에 ncpu라

는 이름의 파일을 찾을 수 있을 것이다.

./ncpu

위와 같이 ncpu 유틸리티를 실행하면, 다음과 같은 정보가 화면에 나오게

된다.

HOST NAME1: tmaxs1

HOST NAME2: tmaxs1

HOSTID: 80FD0534

H/W SERIAL: 2164065588

NCPUS: 2

UNAME: SunOS tmaxs1 5.7 Generic_106541-11 sun4u sparc SUNW,Ultra-80

Note : ㈜Tmax Soft 는 정식으로 Tmax 제품군을 미리 사용해 볼 수 있

도록 평가 라이센스를 제공하며 평가판은 기능상의 제한은 두지 않고 사용기간만을 제한하고 있다. 평가 기간은 최장 6개월까지 연장할 수 있다. 자세한 문의 사항은 “I. 1.3 평가판 Tmax 소프트웨어의 배포” 부분에서 언급된 연락처를 참고한다.

환경 설정

설치 후 Tmax 응용프로그램을 컴파일 할 때, 또는 실제 개발환경에서 프

로젝트 진행 시에는 C 컴파일러나 make 유틸리티 등이 필요하다. 이런 파

일들(cc, make 등)이 포함된 디렉토리가 PATH 환경변수에 설정이 되어 있

는지 확인하고, 만약 설정이 되어 있지 않다면 반드시 관련 디렉토리와 그

외 필요한 기본 디렉토리들도 적용될 수 있도록 해야 한다.


다음은 Bourne shell 또는 Korn shell 사용자가 Tmax를 설치하면 .profile

에 추가되는 Tmax 시스템 환경 변수들을 보여준다. 자세한 내용은 플랫폼

마다 다를 수 있다.

######## Tmax Environment ########

TMAXDIR=/home/tmax; export TMAXDIR

PATH=/home/tmax/bin:$PATH:.; export PATH

TMAX_HOST_ADDR=192.168.0.1; export TMAX_HOST_ADDR

TMAX_HOST_PORT=8888; export TMAX_HOST_PORT

SDLFILE=$TMAXDIR/sample/sdl/tmax.sdl; export SDLFILE

FDLFILE=$TMAXDIR/sample/fdl/tmax.fdl; export FDLFILE

TMAX_CONNECT_TIMEOUT=3; export TMAX_CONNECT_TIMEOUT

#TMAX_RAC_PORT=3333; export TMAX_RAC_PORT

#TMAX_BACKUP_ADDR=xxx.xxx.xxx.xxx; export TMAX_BACKUP_ADDR

#TMAX_BACKUP_PORT=8888; export TMAX_BACKUP_PORT

## Using Tmax Shared Library ##

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TMAXDIR/lib; export LD_LIBRARY_PATH

위의 항목들을 간단히 설명하면 다음과 같다.

TMAXDIR : Tmax가 설치된 디렉토리의 경로

TMAX_HOST_ADDR : 접속하고자 하는 Tmax 서버의 IP 주소

TMAX_HOST_PORT : 속하고자 하는 Tmax 서버의 포트번호. 이 번호는 Tmax 서버의

시스템 설정파일(예: sample.m)에서 정하는 TPORTNO와 일치해야 한다.

SDLFILE : 구조체 버퍼 형식을 사용하기 위한 SDL 이진파일(filename.sdl)의 위치를 설

정하며, 응용 프로그램에서 구조체 버퍼 형식을 사용하지 않으면 정의할 필요가 없다.

FDLFILE : 필드키 버퍼 형식을 사용하기 위한 FDL 이진파일(filename.fdl)의 위치를 설정

하며, 응용프로그램에서 필드키 버퍼 형식을 사용하지 않으면 정의할 필요가 없다.

TMAX_CONNECT_TIMEOUT : Tmax System 접속 제한 시간

TMAX_RAC_PORT : Tmax 서버가 두 대 이상일 경우, 한곳에서 다른 서버를 관리하기

위해 필요한 포트번호를 지정하며, 원격관리를 받고자 하는 서버에서 설정.

TMAX_BACKUP_ADDR : 접속 서버의 장애시 연결하고자 하는 백업 서버의 IP 주소.


TMAX_BACKUP_PORT : 접속하고자 하는 Tmax 백업 서버의 포트번호. 이 번호는

Tmax 백업 서버의 시스템 설정파일(filename.m)에서 정하는 TPORTNO와 일치해야 한

다.

Tmax는 공유 라이브러리를 사용해서 새로운 버전이나 패치된 엔진을 적용

했을 때, 응용 서버 프로그램을 다시 컴파일 하여야 하는 불편함을 없앨 수

있다. 현재 Tmax 버전(3.8.x)에서는 정적 라이브러리와 공유 라이브러리를

함께 제공하고 있다.(단 IBM AIX는 일부만을 공유 라이브러리로 제공한다.)

공유 라이브러리를 사용하기 위해서는 응용 서버프로그램을 개발할 때 필

요한 라이브러리를 포함하도록 하고 각 OS의 컴파일러에 공유 라이브러리

이용에 관한 FLAGS 설정을 해주어야 한다. 자세한 내용은 Tmax Getting

Started Guide나 Tmax C Programming Guide 를 참조하도록 한다.

각 플랫폼 별 컴파일 옵션

#Solaris 32bit, Compaq, Linux: CFLAGS = -O –I$(TMAXDIR)

#Solaris 64bit: CFLAGS = -xarch=v9 -O –I$(TMAXDIR)

#HP 32bit: CFLAGS = -Ae -O –I$(TMAXDIR)

#HP 64bit: CFLAGS = -Ae +DA2.0W +DD64 +DS2.0 -O –I$(TMAXDIR)

#IBM 32bit: CFLAGS = -q32 –brtl -O –I$(TMAXDIR

#IBM 64bit: CFLAGS = -q64 –brtl -O –I$(TMAXDIR

공유 라이브러리의 디렉토리의 위치는 Tmax 인스톨시 환경 파일에 자동으

로 설정 된다. (LD_LIBRARY_PATH 또는 SHLIB_PATH)

설정한 Tmax 환경변수를 적용하기 위해 홈 디렉토리에서 다음과 같이 수

행한다.

<Bourne/Korn shell의 경우>

. ./.profile

<C shell의 경우>


source .cshrc

env 또는 set 명령으로 환경변수가 잘 적용 되었는지 확인한다.

sample.m 파일의 구성

아래는 Tmax를 기동 시킬 때 필요한 각종 정보들이 들어있는 Tmax 시스

템 환경 파일이다. 아스키 파일 형태로 작성하며, cfl 유틸리티로 컴파일 하

여 이진파일을 생성한다. 생성된 이진파일은 Tmax 기동 및 종료 시 참조

된다.

*DOMAIN

tmax1 SHMKEY =79990, MINCLH=1, MAXCLH=3,

TPORTNO=8888, BLOCKTIME=30

*NODE

tmaxs2 TMAXDIR = "/user/mmidea/tmax",

APPDIR = "/user/mmidea/tmax/appbin",

PATHDIR = "/user/mmidea/tmax/path",

TLOGDIR = "/user/mmidea/tmax/log/tlog",

ULOGDIR = "/user/mmidea/tmax/log/ulog",

SLOGDIR = "/user/mmidea/tmax/log/slog"

*SVRGROUP

svg1 NODENAME = tmaxs2

*SERVER

svr1 SVGNAME = svg1, MIN=1

*SERVICE

SDLTOUPPER SVRNAME = svr1

SDLTOLOWER SVRNAME = svr1


예제 프로그램 테스트

Tmax가 올바르게 설치가 되었는지 간단한 예제 프로그램을 통해서 살펴보

도록 한다. 프로그램에 사용된 각종 파일들은 다음과 같다.

[테스트 환경]

운영 체제: SunOS 5.7 32bit 버전

쉘: korn shell

$TMAXDIR=/user/tmax

[프로그램]

sample.m : Tmax 환경 설정 파일($TMAXDIR/config)

svr1.c : 서버 프로그램($TMAXDIR/sample/server)

sdltoupper.c : 클라이언트 프로그램($TMAXDIR/sample/client)

demo.s : 구조체 정의 파일($TMAXDIR/sample/sdl)

demo.f : 필드키 정의 파일($TMAXDIR/sample/fdl)

tmax.env : Tmax 환경변수 정의 파일($TMAXDIR/sample/client)

기본 환경 설정

$TMAXDIR/config 디렉토리로 이동하여 환경파일을 컴파일한다. 여기에서

는 편의상 Tmax 시스템이 설치된 홈 디렉토리를 TMAXDIR 이라 표현하

기로 한다.

$>cfl –i sample.m

성공적으로 컴파일이 된 후에는 다음과 같은 메시지가 출력된다.

CFL is done successfully for node(<nodename>)

Tmax가 설치되면 TMAXDIR/config 디렉토리에 자동으로 sample.m 파일

이 생성된다. 이때, 해당 서버의 호스트 이름이 실제 호스트 이름과 맞지

않는 경우가 발생할 수 있다. 예를 들어, uname –n 명령을 사용했을 때, 나


오는 이름이 tmax1.tmax.co.kr과 같이 나왔는데 컴파일이 되지 않는 경우

이다. 이럴 때는 TMAXDIR/license 디렉토리에 있는 ncpu 라는 유틸리티

를 실행하여 확인할 수 있다. ncpu 를 실행해서 나오는 호스트 이름을

sample.m에 입력하고, 그 호스트 이름에 맞는 라이센스를 다시 받아 설치

한다. ncpu 에 관한 내용은 “I. 2.4 환경 설정 및 테스트” 에 언급되어 있다.

다음 서비스 테이블을 생성한다. 서비스 테이블은 각각의 서버 프로세스가

생성될 때 필요한 파일로서 각각의 프로세스들이 어떤 서비스를 처리하는

지에 대한 정보가 담겨 있다.

$>gst

성공적으로 처리되면 다음과 같은 메시지가 출력된다.

SVC tables are successfully generated

GST is successfully done

TMAXDIR/sample/sdl 디렉토리로 이동하여 구조체 정의 이진파일을 생성

한다. 이 때 서버에서와 클라이언트에서 필요한 파일들이 다르므로 sdlc를

할 때 서버에서와 클라이언트에서 옵션을 다르게 해 주어야 한다.

즉, 서버측 에서는 다음과 같이 sdlc를 해 준다.

$>sdlc –i demo.s

위와 같이 하면 demo_sdl.h 및 demo_sdl.c 파일이 생성된다. 여기에서 생

성되는 파일들은 구조체 타입 버퍼를 사용하는 서버 프로그램에서 컴파일

할 때 참조가 된다. 물론 샘플로 제공되는 makefile 에서는 구조체 타입 버

퍼를 사용하는 서버 프로그램을 컴파일 할 때 sdlc를 하는 루틴이 있지만

서버 프로그램 컴파일 하기 전에 미리 sdlc를 해 두는 것이 좋다.

클라이언트 측에서는 다음과 같이 sdlc를 해 준다.

$>sdlc –c –i demo.s –o tmax.sdl

위와 같이 하면 demo_sdl.h 및 tmax.sdl 파일이 생성된다. –o option을 사

용하지 않으면 디폴트로 <구조체 파일명>.sdl 이 생성된다. 이 파일은 이진

파일로 구조체 타입 버퍼를 사용하는 클라이언트 프로그램에서 구조체 타

입 버퍼를 메모리에 할당할 때 사용된다. 이 파일의 위치는 사용자 환경파


일에 설정된 SDLFILE이라는 환경변수를 참조한다. tmax 시스템의 설치가

완료되었을때 tmax 인스톨러는 디폴트로 이 값을 TMAXDIR/sample/sdl/

tmax.sdl 로 설정 하므로 이 값을 그대로 사용하려면 sdlc 명령을 사용할

때 반드시 –o 옵션을 사용하여 이진 파일의 이름을 tmax.sdl 로 지정해 주

어야 한다.

sdlc가 성공적으로 수행되었다면 아무런 메시지가 출력되지 않는다.

TMAXDIR/sample/fdl 디렉토리로 이동하여 필드키 이진파일을 생성한다.

fdlc 는 서버나 클라이언트에 관계없이 다음과 같이 하면 된다.

$>fdlc –c –i demo.f

성공적으로 컴파일이 이루어지면 다음과 같은 메시지가 출력된다.

FDLC is successfully done

서버 프로그램 컴파일

TMAXDIR/sample/server 디렉토리로 이동하여 실제적으로 서비스를 제공

하는 서버 프로그램을 컴파일한다.

$>./compile sdl svr1

성공적으로 컴파일이 끝난 후에는 다음과 같은 메시지가 출력된다.

cc -O -I/user/tmax -c svr1.c

cc -O -I/user/tmax -L/user/tmax/lib -o svr1 svr1.o demo_sdl.o svr1_svctab.o

-lsvr -lnsl –lsocket -lnodb

mv svr1 /user/tmax/appbin

마지막 줄의 /user/tmax/appbin 은 서비스 프로그램들이 위치하는 디렉토

리로 Tmax 환경파일에 사용자 임의로 설정할 수 있다. 자세한 내용은

Tmax Administraion Guide 를 참조한다.


Tmax 시스템의 기동

서버 프로그램의 컴파일이 완료되면 Tmax 시스템을 기동할 수 있다.

Tmax 를 기동 시킨다.

$>tmboot

성공적으로 기동 되면 다음과 같은 메시지가 출력된다.

TMBOOT for node(<nodename>) is starting:

TMBOOT: TMM is starting: Thu Apr 12 23:05:51 2001

TMBOOT: CLL is starting: Thu Apr 12 23:05:51 2001

TMBOOT: CLH is starting: Thu Apr 12 23:05:51 2001

(I) CLH Current Tmax Configuration:

Number of client handler(MINCLH) = 1

Supported maximum user per node = 200

Supported maximum user per handler = 201

TMBOOT: SVR(svr1) is starting: Thu Apr 12 23:05:51 2001

<nodename>, <Supported maximum user per node>, <Supported maximu

m user per handler> 는 시스템마다 다른 값을 가진다.

Note : tmboot 시 실패할 수 있는 경우는 다음과 같다.

- Tmax 시스템 환경파일(xxxx.m)에서 지정된 TPORTNO, TPORTNO+1 을 이미

시스템에서 사용중인 경우

- SHMKEY 값이 이미 시스템에서 사용중인 경우

- Tmax 시스템 환경파일의 컴파일(cfl)이 제대로 수행되지 않은 경우

- Tmax 시스템 환경파일에 등록되어 있는 서비스 프로그램이 모두 컴파일되지 않은

경우

Tmax가 기동 되지 않거나 에러 메시지를 출력하면 위의 내용을 다시 확인

해 보고 수정한 후 다시 기동 시켜야 한다.


클라이언트 프로그램 컴파일 및 실행

TMAXDIR/sample/client 디렉토리로 이동하여 클라이언트 프로그램을 컴

파일한다.

$>./compile c sdltoupper

성공적으로 컴파일이 끝난 후에는 다음과 같은 메시지가 출력된다.

cc -O -I/user/tmax -c sdltoupper.c

cc -O -I/user/tmax -L/user/tmax/lib -o sdltoupper sdltoupper.o -lcli -lnsl –lsocket

실행하기에 앞서 현제 디렉토리(sample/client)에 tmax.env 파일이 있는지

확인한다. tmax.env 파일은 클라이언트에서 tmax 시스템에 접속하기 위한

환경변수를 정의한 텍스트 파일이다.

파일이 존재하면 클라이언트 프로그램을 실행시킨다.

$>./sdltoupper tmax

성공적으로 서비스가 수행되면 다음과 같은 메시지가 출력된다.

send data: tmax

recv data: TMAX

위의 결과를 받으면 정상적으로 Tmax가 설치 되었음을 확인할 수 있다.

그 외에 인스톨러가 제공하는 예제에 대해서 간략하게 설명한다.


클라이언트 서버 프로그램 compile 비 고

sdltoupper.c

sdltolower.c svr1.c compile sdl svr1 구조체 버퍼

toupper.c

tolower.c svr2.c compile c svr2 스트링 버퍼

fdltoupper.c

fdltolower.c svr3.c compile c svr3 필드키 버퍼

sdl_main.c sdltest.pc compile psdl sdltest구조체 버퍼

오라클 연동

fdl_main.c fdltest.pc compile pc fdltest 필드키 버퍼

오라클 연동


3. Tmax 시스템 설치(Windows NT/2000)

이 절에서는 Windows NT/2000 운영체제에서 Tmax Server/Client 또는

Tmax Client를 설치하는 방법에 대해 설명한다. Windows NT/2000에

Tmax System을 설치하지 않는 경우는 이 절을 건너 뛰어도 좋다.

GUI 인스톨러

Tmax 서버/클라이언트의 설치

Tmax 클라이언트의 설치

환경 설정 및 테스트

3.1 GUI 인스톨러

윈도우즈 환경에서는 GUI 인스톨러를 이용하여 Tmax 를 설치 할 수 있다.

GUI 인스톨러는 C를 이용하여 만들어졌으므로 별도의 모듈을 필요로 하지

않는다.

3.2 Tmax Server/Client 설치

Tmax 시스템의 실제 운영을 위하여 Tmax 서버와 클라이언트를 모두 인

스톨 한다. Tmax 클라이언트만 설치하고자 하는 사용자는 “I. 3.3 Tmax

Client 설치” 를 참조한다.

설치 전 준비사항


１）윈도우즈 플랫폼은 여러가지 서비스를 등록하므로 완전한 설치를 위해

서 Administrator 권한으로 설치할 것을 권장한다.

２）인스톨 환경이 Tmax설치 최소 요구사항에 합당한지 확인하고 CD-

ROM 드라이브에 Tmax CD-ROM 을 삽입한다.

３）오라클 DB를 사용할 경우는 오라클의 버전을 확인한다

４）windows디렉토리에 있는 setup.exe를 실행시킨다.

설치과정

다음은 Tmax 서버/클라이언트의 설치과정을 보여준다. 처음 setup.exe

를 실행하면 다음과 같은 화면을 볼 수 있다.


“Next” 버튼을 누르면 제품 라이센스 동의서를 볼 수 있다.

라이센스에 동의하는지를 묻는다. 이 때 No를 선택하고 다음과 같은 다이

얼로그 박스가 뜰때 “확인” 버튼을 누르면 설치가 중단된다.


라이센스에 동의하면 Tmax 설치 폴더를 묻는 화면으로 넘어간다.

Tmax가 설치될 폴더를 지정한다. 디폴트로 c:\tmax에 설치하게 되어 있

다. 다른 폴더에 설치하고 싶다면 왼쪽의 트리 컨트롤에서 설치하고자 하는

폴더를 지정해 주고 새로운 폴더를 만들고 싶다면 트리 컨트롤에서 새 폴

더를 만들고자 하는 폴더를 클릭한 후 오른쪽 아래의 “New Folder” 버튼

을 눌러 새 폴더 이름을 지정해 주면 새로운 폴더가 만들어지면서 설치 폴

더로 지정이 된다. 다른 폴더를 지정했다가 디폴트 폴더로 다시 지정하고

싶다면 “Restore default Location” 버튼을 누르면 디폴트 폴더인

“c:\tmax”이 설치 폴더로 지정이 된다.


설치 폴더를 지정하고 “Next” 버튼을 누르면 실제 인스톨 과정이 진행된다.

Tmax 시스템 파일/라이브러리와 샘플 등이 지정한 위치에 설치 되고 난

후 “File copy is finished. If you want to go next, please click <Next>

button.” 이라는 메시지가 나오면서 “Next”버튼이 활성화 되면 “Next” 버

튼을 클릭한다.


시스템 파일과 라이브러리 등의 설치 과정이 끝나면 Tmax 시스템 운용에

필요한 환경 변수를 설정해 주어야 한다. 처음 나오는 화면은 시스템 설정

에 관한 것이다.

Set Environment variable to your system Tmax 시스템을 설치할 서버의 IP 주소를 입력한다. 이 IP 주소는 클라이

언트가 Tmax의 서비스를 요청하기 위해 접속할 서버의 IP 주소이다. 디폴

트로 Tmax 시스템이 설치될 서버의 IP 주소가 설정되어 있다. IP 주소는

정확하게 입력하지 않으면 에러가 발생하므로 정확하게 입력하여야 한다.

클라이언트가 Tmax 시스템과 통신하기 위해 필요한 접속포트를 지정한다.

이 포트번호의 범위는 1 ~ 65535 까지이다. 인스톨러는 사용자가 입력한

포트가 이미 시스템에서 사용중인지 혹은 올바른 범위내의 값인지를 체크

하지 않으므로 서버 관리자와 문의하여 정확하게 입력해야 한다. 포트 번호

는 디폴트로 8888로 지정되어 있으므로 변경하지 않는다면 8888이 사용되


게 된다.

IP 주소 및 포트번호는 NT 환경변수 설정에서 언제든지 바꿀 수 있으며,

자세한 사항은 “I. 3.4 환경 설정 및 테스트” 부분을 참고한다.

다음 화면은 Tmax 운용에 관한 설정이다.

TMAX_WIN_PORT는 Tmax 시스템이 설치된 서버들간의 통신을 위한 포

트번호를 의미한다. TMAX_WIN_PORT 포트 번호부터 TMAX_WIN_PORT

+13까지 14개의 포트가 사용된다. 그러므로 앞서 지정한 TMAX_HOST_P

ORT와 겹치지 않도록 설정해야 한다. 범위에 맞는 현재 사용되지 않는 포

트번호를 입력해야 한다.

TMAX_XA_DLL은 DB를 사용한 분산 트랜잭션 처리를 하고자 할때 지정

해 주어야 한다.


대표적인 XA Library 중 하나를 선택할 수 있게 되어 있고 만약 분산 트랜

잭션을 사용하지 않는다면 None으로 지정해 두면 된다. 현재 버전(3.8)의

Tmax Windows 시스템은 Oracle 만을 지원한다.

Oracle DBMS를 사용할 경우

상기 의 과

정이 모두 끝나면 인스톨 완료 화면이 표시된다.

설치과정이 모두 완료된 후에는 입력한 환경변수가 반영되도록 해야 한다.

윈도우즈 2000의 경우는 위의 과정이 필요 없으나 윈도우즈 NT의 경우 시

스템 재부팅 과정이 꼭 필요하다. 재부팅을 하지 않을 경우 환경변수로 설

정은 되어 있지만 실제로 시스템에 반영되지는 않는다. 윈도우즈 2000의

경우는 No 를 선택하도록 하고 윈도우즈 NT의 경우는 Yes 를 선택하여

재부팅 하도록 한다.

사용자가 원하는 대로 지정한 다음 확인 버튼을 누르면 Tmax 인스톨러의

인스톨 과정은 일단락 된다.

Oracle version The name of DB’s XA dll

Oracle 7.3.x XA73.DLL

Oracle 8.0.x XA80.DLL

Oracle 8.1.x ORALCLIENT8.DLL

Oracle 9.x ORALCLIENT9.DLL



Tmax Root directory


appbin : Tmax를 이용해 개발된 응용 서버프로그램

bin : Tmax 명령과 유틸리티

config : Tmax 시스템 환경파일

lib : Tmax 라이브러리

license : 라이센스 파일

log : 로그 파일(시스템, 유저, 트랜잭션)

slogtlog

ulog

TMAXDIR

config

appbin

bin

lib

log

svct

usrinc

path

sample

license

Tmax Server/Client 설치후의 디렉토리 구조

client

fdl

sdl

server


path : 프로세스간 통신 시 필요한 파이프


svct : 응용 서버프로그램 컴파일 시 필요한 서비스 테이블 파일


Tmax Sample directory



server : 서버 샘플 프로그램



Note : demo.f와 demo.s는 FDL(Field Definition Language)과 SDL(Structure

Definition Language) 형식의 필드들을 정의하는 파일이다. 사용자는

실제 프로젝트에서 사용할 FDL및 SDL 형식 필드들을 필요에 따라 직

접 만들어서 사용할 수 있다. 여기에 대한 자세한 사항은 Tmax C

Programming Guide 나 Tmax Reference Manual 을 참조한다.

설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “I.

3.4 환경 설정 및 테스트” 에 설명되어 있다.

환경 변수 등록과 서비스 등록

설치과정에서 지정한 환경변수이외에 필드키버퍼나 구조체버퍼를 사용할

경우에 필요한 환경변수는 다음과 같이 자동으로 지정된다. 이 때

TMAXDIR은 Tmax System을 설치한 폴더의 경로를 의미한다.

FDLFILE : TMAXDIR\fdl\tmax.fdl

SDLFILE : TMAXDIR\sdl\tmax.sdl

또한 PATH에 TMAXDIR\bin 디렉토리가 자동으로 추가된다.


기존에 Tmax 시스템이 설치된 적이 있었다면 PATH를 제외한 다른 Tmax

환경변수들의 값은 새로 지정한 값으로 수정된다. 그러나 PATH에 잡혀있

는 디렉토리 값은 동일한 디렉토리에 재설치 하더라도 중복하여 추가된다.

가장 나중에 인스톨 된 디렉토리 값이 가장 처음에 위치한다.

시스템이 재부팅 되면 인스톨러는 자동으로 Tmax 시스템과 RACD를 윈도

우즈의 시스템 서비스 항목에 Tmax Loader, RACD Loader라는 이름으로

등록한다. 이 Tmax\RACD Loader는 Tmax 시스템 및 RACD의 시작 및

종료를 컨트롤 패널에서 할 수 있도록 지원한다.

등록된 Tmax Loader


만약 시스템을 재부팅 하였는데도 Tmax system또는 RACD가 시스템에 서

비스로 등록되어 있지 않다면 수동으로 설치하여야 한다. 도스 명령창을 열

고 다음과 같이 입력하여 서비스 등록 명령을 실행시킨다..

. C:\svcinstall C:\racdinstall

시스템 서비스에서 Tmax(RACD) Loader를 제거하려면 도스 명령창을 열

고 다음과 같이 입력하여 서비스 제거 명령을 실행시킨다.

C:\svcremove C:\racdremove

등록된 RACD Loader


3.3 Tmax Client 설치

Tmax 서버를 설치하고 어클리케이션을 개발하여 Tmax 시스템을 시작하

는데 성공하였다면 실제로 서비스가 수행되는지 다양한 플랫폼에서 확인해

볼 필요가 있다. 사용자는 원하는 곳에 클라이언트를 깔고 클라이언트 프로

그램을 개발하여 서비스를 사용할 수 있다. Tmax 클라이언트 모듈은 라이

센스를 필요로 하지 않으며 홈페이지를 통해 자유롭게 받아서 사용할 수

있다.

Tmax 클라이언트는 윈도우즈 NT/2000 뿐만 아니라 윈도우즈 98/Me 에

서도 사용할 수 있다. 이경우 GUI 인스톨러가 환경 설정을 해주지 않으므

로 직접 해당 파일(autoexec.bat) 에 필요한 환경변수를 설정하고 재부팅

해야 한다.

설치 전 준비사항

1) Admin.권한 혹은 윈도우즈용 클라이언트 개발을 위한 사용자 계정을 만

든다.

2) 인스톨 환경이 Tmax 클라이언트 설치 최소 요구사항에 합당한지 확인

하고 CD-ROM 드라이브에 Tmax CD-ROM 을 삽입한다.

3）windows/client 디렉토리에 있는 setup.exe 를 실행시킨다.

설치과정

다음은 Tmax 서버/클라이언트의 설치과정을 보여준다. 처음 setup.exe

를 실행하면 다음과 같은 화면을 볼 수 있다.


위와 같이 인스톨러 프로그램이 실행되면 “Next” 버튼을 눌러 라이센스 동

의 페이지로 이동한다.


라이센스에 동의하는지를 묻는다. 이 때 No를 선택하고 다음과 같은 다이

얼로그 박스가 뜰때 “확인” 버튼을 누르면 설치가 중단된다


라이센스에 동의하면 Tmax 설치 폴더를 묻는 화면으로 넘어간다.

Tmax가 설치될 폴더를 지정한다. 디폴트로 c: \tmax 에 설치하게 되어 있

다. 다른 폴더에 설치하고 싶다면 왼쪽의 트리 컨트롤에서 설치하고자 하는

폴더를 지정해 주고 새로운 폴더를 만들고 싶다면 트리 컨트롤에서 새 폴

더를 만들고자 하는 폴더를 클릭한 후 오른쪽 아래의 “New Folder” 버튼

을 눌러 새 폴더 이름을 지정해 주면 새로운 폴더가 만들어지면서 설치 폴

더로 지정이 된다. 다른 폴더를 지정했다가 디폴트 폴더로 다시 지정하고

싶다면 “Restore default Location” 버튼을 누르면 디폴트 폴더인 c:\tmax

이 설치 폴더로 지정이 된다.


설치 폴더를 지정하고 “Next” 버튼을 누르면 실제 인스톨 과정이 진행된다.

Tmax 시스템 파일/라이브러리와 샘플 등이 지정한 위치에 설치 되고 난

후 “File copy is finished. If you want to go next, please click <Next>

button.” 이라는 메시지가 나오면서 “Next” 버튼이 활성화 되면 “Next” 버

튼을 클릭한다.

시스템 파일과 라이브러리 등의 설치 과정이 끝나면 실제 접속이 이루어질

Tmax 시스템에 대한 환경 변수를 설정해 줘야 한다.


Set Environment variable to your system Tmax System을 설치할 Tmax Server의 IP 주소를 입력한다. 이 IP 주소

는 클라이언트가 Tmax의 서비스를 요청하기 위해 접속할 서버의 IP 주소

이다. 디폴트로 Tmax System이 설치된 localhost의 IP 주소가 설정되어

있다. IP 주소는 정확하게 입력하지 않으면 에러가 발생하므로 정확하게 입

력하여야 한다.

Client가 Tmax 시스템과 통신하기 위해 필요한 접속포트를 지정한다. 이

포트번호의 범위는 1 ~ 65535 까지이다. 인스톨러는 사용자가 입력한 포트

가 이미 시스템에서 사용중인지 혹는 올바른 범위내의 값인지를 체크하지

않으므로 올바르게 입력해야 한다. 포트번호는 디폴트로 8888로 지정되어

있으며 변경하지 않으면 그대로 8888이 사용된다.

IP 주소 및 포트번호는 NT 환경변수 설정에서 언제든지 바꿀 수 있으며,

자세한 사항은 “I. 3.4 환경 설정 및 테스트” 부분을 참고한다.


설치과정이 모두 완료된 후에는 입력한 환경변수가 반영되도록 해야 한다.

윈도우즈 2000의 경우는 위의 과정이 필요 없으나 윈도우즈 NT의 경우 시

스템 재부팅 과정이 꼭 필요하다. 재부팅을 하지 않을 경우 환경변수로 등

록은 되어져 있더라도 실제로 시스템에 반영되지는 않는다. 윈도우즈 2000

의 경우는 No를 선택하도록 하고 윈도우즈 NT의 경우는 Yes를 선택하여

재부팅 하도록 한다.

윈도우즈 98/Me 사용자는 바로 재부팅 하지말고 autoexec.bat 파일에 필

요한 환경변수를 설정하고 난 뒤 재부팅 하도록 한다.

사용자가 원하는 대로 지정한 다음 확인 버튼을 누르면 Tmax 클라이언트

의 인스톨이 완료된다.



Tmax Root Directory


bin : 유틸리티(fdlc, sdlc)

lib : Tmax 클라이언트 라이브러리



Sample Directory





설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “I. 3.4

환경 설정 및 테스트” 에 설명되어 있다.

Tmax 클라이언트 설치후 디렉토리 구조

TMAXDIR

bin

lib

sample

usrinc

client

fdl

sdl


3.4 환경 설정 및 테스트

본 절에서는 Tmax 서버와 클라이언트의 설치를 마친 후 실제 운용을 하는

예를 보여준다. 앞서의 인스톨 과정이 이상없이 끝났다면 TP-Monitor가

제공하는 막강한 기능들을 손쉽게 활용할 수 있을 것이다.

라이센스 파일 설치

Tmax 서버 시스템을 운영하거나 WebT를 통해 Tmax의 서비스를 이용하

고자 할 때는 설치 후에 반드시 라이센스 파일의 설치가 이루어져야 한다.

Tmax 클라이언트만 설치한 시스템이라면 이 절을 건너 뛰어도 좋다.

Tmax 클라이언트는 라이센스를 별도로 필요로 하지 않는다.

Tmax 제품군에 대한 라이센스는 옵션별로 나뉘어 지며, 그 내용은 다음과

같다.

Domain Gateway : 서로 다른 Tmax 도메인 간에 통신을 할 수 있는 시스템

Reliable Queue : 신뢰성 큐를 사용하고자 하는 시스템

HostLink : Tmax 서버와 Main Frame과의 연동을 위해 필요한 시스템

WebT : Web에서 Tmax의 서비스를 이용할 수 있는 시스템

사용자가 Tmax의 기본 기능 또는 그 이외에 위와 같은 기능을 추가적으로

사용하고자 할 경우, 라이센스를 ㈜Tmax Soft 로부터 발급 받아야 한다.

라이센스는 온라인 TmaxSoft 홈페이지 또는 E-mail 을 통해 접수가 가능

하며, Tmax가 필요로 하는 양식에 맞춰 정보를 기입하면 원하는 라이센스

파일을 받아 설치할 수 있다. 라이센스를 발급받기 위하여 사용자는 Tmax

제품의 설치를 끝마친 후 아래와 같은 시스템 정보를 체크하는 유틸리티를

실행하여 그 결과를 라이센스 발급처에 알려주어야 한다.

Tmax 시스템 실행 명령중에서 ncpu.exe를 실행시키면 윈도우즈 서버에

대한 정보를 알 수 있다.


- 도스 명령창을 연다. 도스 명령창은 시작버튼을 누르면 나오는 메뉴중에서 실행을

선택하고 입력창에 command라고 입력하면 실행된다.

- ncpu 명령을 입력하고 엔터키를 친다.

- 도스 명령창에 Tmax 서버의 호스트명이 출력된다.

- 출력된 호스트명을 TmaxSoft 라이센스 담당에게로 보내면 License File을 생성하여 보

내준다. 보낼 email 주소는 “ I. 1.3 평가판 Tmax 소프트웨어의 배포” 를 참고한다.

License File을 설치하고 나면 도스 명령창에서의 Tmax System 사용이


가능하다. 도스 명령창을 열고 Tmax 시스템을 실행하면 어플리케이션 로

그들과 시스템 런타임 메시지들이 화면상으로 출력되기 때문에 디버깅 하

기가 편리하다. 그러나, 주의해야 할 점은 tmboot를 실행한 도스 명령창을

tmdown을 실행하지 않고 종료할 경우 에러가 발생하면서 윈도우즈 시스템

에 의해 모든 프로세스들은 비정상 종료된다.

따라서 이런 경우가 발생하지 않도록 반드시 tmdown 후에 도스 명령창을

닫도록 주의해야만 한다.

어플리케이션 개발이 완료되어 더 이상 프로그램 디버깅을 할 필요가 없게

되면 도스 명령창에서 tmboot 또는 tmdown 명령을 입력하여 Tmax 시스

템을 시작하거나 종료하지 않고 시스템 서비스로 등록된 Tmax Loader를

이용하여 Tmax 시스템을 시작 또는 종료하는 방법을 사용해도 된다.

Tmax Loader를 이용할 경우 Tmax System 프로세스들이 백그라운드 시

스템 프로세스들로 움직이기 때문에 도스 명령창에서와는 달리 어플리케이

션 로그나 시스템 런타임 메시지들을 볼 수가 없고 디버깅을 하길 원한다

면 시스템 로그파일(slog파일)과 유저 로그파일(ulog 파일)에 기록되는 메

시지들을 이용해야 한다. 로그파일 설정과 기록 내용에 관해서는 Tmax

Administraion Guide 와 Tmax Reference Manual 을 참고한다.

Note : ㈜Tmax Soft 제품군에 대한 라이센스는 24시간 이내에 발급함을

원칙으로 하고 있다.

㈜Tmax Soft 는 정식으로 Tmax 제품군을 구매했을 때 발급하는

라이센스와 어느 정도의 기간을 두고 제품을 시험할 수 있도록

평가판 라이센스를 제공하고 있다.

평가판 라이센스에서는 기능상의 제한은 두지 않고, 사용기간 제

한을 두어 배포하고 있다. 자세한 문의 사항은 “I. 1.3 평가판 Tmax 소프트웨어의 배포” 부

분에서 언급한 연락처를 참고한다.


Tmax 시스템을 운용하기 전에

먼저 시스템 환경변수 들이 올바르게 지정되어져 있는지 확인한다. 확인하

는 방법은 아래 같이 하면 된다.

제어판 -> 시스템 -> 고급 -> 환경변수

확인할 환경변수 들은 설치과정 중에 지정한 TMAXDIR, TMAX_HOST_

ADDR, TMAX_HOST_PORT, TMAX_WIN_PORT, SDLFILE, FDLFILE,

PATH 이다.

이 때 PATH는 TMAXDIR\bin 디렉토리가 포함되어 있는지를 확인한다. 새

로운 도스 명령창을 열고 시스템에 환경변수가 반영이 되었는지 확인한다.

만약 환경변수가 반영이 되어 있지 않았다면 시스템을 재부팅 하거나 환경

파일 변경 내용을 적용하여 적절히 반영시켜 주어야 한다.

모든 환경변수 들이 올바르게 지정되어져 있고 시스템에 완전히 반영되어

져 있다면 Tmax 시스템에서 제공하는 샘플 프로그램을 실행시켜 Tmax

시스템이 정상적으로 설치되어졌는지 확인해야 한다. 샘플 프로그램은

Tmax 시스템이 설치된 폴더의 하위 디렉토리인 TMAXDIR\sample 내에

있다.


우선 샘플 프로그램을 동작하기 위한 Tmax 환경파일을 구성한다. Tmax

환경파일은 Tmax 시스템이 동작하는데 있어서 근거가 되는 파일이다. 구

성방법은 다음과 같은 방법으로 한다.

- 도스 명령창을 연다. 도스 명령창을 여는 방법은 시작메뉴 버튼을 눌러 나온 메뉴

중에서 실행을 선택하고 입력창에 ‘command’라고 입력하면 된다.


- 도스 명령창에서 Tmax System이 설치된 디렉토리의 하위 디렉토리 중 ‘config’라

는 디렉토리로 이동한다.

- ‘sample’ 디렉토리에서 샘플로 제공되는 Tmax 환경파일을 복사해 온다.

- 문서편집용 프로그램(예: notepad.exe)을 실행한 후 복사해온 Tmax 환경파일을 불

러온다. Tmax 환경파일 내용중 *NODE라는 절내의 노드명을 Tmax 서버의 호스트

명으로 바꾸고 TMAXDIR 및 각종 디렉토리들의 경로를 시스템에 설치된 경로와 맞

도록 수정한다. 이 때 호스트명은 라이센스 파일을 만들기 위해 사용했던 ncpu.exe

를 실행시켜 나온 호스트명과 동일해야 한다. 만일 설치과정 중에 TMAX_HOST_P

ORT 환경변수 값을 디폴트 값인 8888이 아닌 다른 포트번호로 입력한 경우

*DOMAIN이라는 절의 TPORTNO라는 항목 값을 지정한 포트번호와 동일하도록 수

정해야만 한다. Tmax 환경파일에 대하여 좀 더 자세한 내용을 보고싶다면 Tmax

Administration Guide 매뉴얼을 참조한다.

Tmax 환경파일을 수정했다면 저장을 한 후, 다음과 같은 방법으로 컴파일

을 한다. Tmax System은 Tmax 환경파일을 텍스트 형태로는 사용될 수

없고 바이너리 형태로 변환하여 사용한다. 컴파일 과정은 텍스트로 작성된

Tmax 환경파일을 바이너리 파일로 변환해주면서 동시에 텍스트로 작성된

Tmax 환경파일이 형식에 맞도록 올바르게 작성되었는지 확인하는 과정이

다.

C:\tmax\config> cfl –i sample.m

‘cfl’이란 명령은 Tmax System에서 제공하는 Tmax 환경파일 컴파일 명령

이다.

컴파일이 성공하면 ‘tmconfig’라는 이름의 바이너리 파일이 생성된다. 이

파일이 Tmax System이 부팅, 동작 또는 종료 시에 참조하는 환경파일 이

다.

‘tmconfig’ 라는 파일명은 디폴트로 지정되는 이름이다. 만약, 다른 파일명

으로 바이너리 파일을 만들고자 할 경우엔 다음과 같이 ‘-o’ 옵션을 주면

된다. 다음과 같이하면 ‘myproj’라는 파일명으로 바이너리 파일이 생성된다.

C:\tmax\config> cfl –i sample.m –o myproj

이 때 주의해야 할 점은 Tmax 시스템을 시작 또는 종료시킬 때에 반드시


‘-f’ 옵션의 인자로 생성된 바이너리 파일명을 써 주어야 한다는 것이다.

Tmax 시스템은 ‘-f’ 옵션이 없을 경우 디폴트로 ‘tmconfig’ 파일을 부팅 또

는 종료의 근거파일로 사용하기 때문이다.

C:\tmax\config> tmboot –f myproj

C:\tmax\config> tmdown –f myproj

Tmax 시스템을 시작 또는 종료시키는 내용은 나중에 다시 설명할 것이다.

환경파일 컴파일을 완료하면 다음과 같은 명령을 입력하여 서비스 테이블

을 생성해야 한다. 서비스 테이블은 Tmax 시스템이 클라이언트가 서비스

를 요청해 왔을 때에 서버 프로그램에서 요청한 서비스의 위치를 찾을 때

에 사용하는 것이다. 생성되어진 서비스 테이블은 서버 프로그램이 컴파일

을 완료하기 전에 함께 링크되어 컴파일 되어진다. 서비스 테이블은 ‘서버

명_svctab.c’의 이름을 갖는 C프로그램 파일이다.

C:\tmax\config> gst

서비스테이블 생성까지 완료되면 Tmax 환경파일 구성과정은 끝난다.

서비스 프로그램 컴파일

환경파일 구성이 끝나면 샘플 서버 프로그램과 클라이언트 프로그램을 컴

파일한다. 물론 컴파일을 하려면 c 컴파일러가 설치되어 있어야 한다. 일반

적으로 윈도우에서는 Microsoft Visual Studio를 사용하므로 Microsoft

Visual Studio를 설치해 두는 것을 권장한다. Microsoft Visual Studio를 설

치한 후 환경변수에 Microsoft Visual Studio 관련 환경변수 들이 등록되어

있는지 확인한다. 여기에서 사용할 nmake를 사용하기 위해서는 lib,

MSDevDir, PATH 등의 환경변수 들이 등록이 되어 있어야 한다.

먼저 서버프로그램을 컴파일 한다. 서버프로그램은 Tmax 시스템이 부팅될

때에 Tmax 시스템 프로세스들과 함께 부팅되어 서비스를 제공하는 프로그

램이다. 컴파일 은 다음과 같은 방법으로 하면 된다. 모든 과정은 도스 명


령 창에서 수행한다.

sample 프로그램의 구성은 UNIX와 같다.

TMAXDIR\sample\server 디렉토리로 이동한다. 이 디렉토리는 샘플 서버

프로그램과 make 파일이 들어있는 디렉토리이다.

서버 프로그램을 컴파일 하기 전에 서버 프로그램에서 구조체 버퍼 또는

필드 버퍼를 사용하는 경우 sdlc 또는 fdlc 를 통하여 구조체 파일(xxx.s)

또는 필드키 파일(xxx.f)을 컴파일 해야 한다.

구조체 파일은 유닉스 환경에서와 마찬가지로 서버와 클라이언트 각각에서

수행해야 한다.

서버 에서는 다음과 같이 한다.

C:\tmax\sample\sdl> sdlc –i demo.s

서버에서 sdlc를 위와 같이 하면 demo_sdl.h 와 demo_sdl.c 파일이 생성

된다. 이 두 파일은 구조체 버퍼 타입을 사용하는 서버 프로그램을 컴파일

할 때 참조된다. 샘플로 제공하는 서비스 프로그램들의 메이크 파일에는

sdlc 를 하는 루틴이 포함되어 있지만 사용자가 개발한 프로그램을 컴파일

할 때는 반드시 이 부분을 잊지 않도록 한다.

클라이언트 에서는 다음과 같이 한다.

C:\tmax\sample\sdl> sdlc –c –i –demo.s –o tmax.sdl

클라이언트 에서 sdlc 를 위와 같이 하면 demo_sdl.h 와 tmax.sdl 파일이

생성된다. –o 옵션을 사용하지 않으면 디폴트로 <구조체 파일>.sdl 이 생성

되지만 –o 옵션을 사용하여 원하는 파일 이름으로 바꿀 수 있다. 이 파일은

이진파일로 구조체 타입 버퍼를 사용하는 클라이언트 프로그램에서 구조체

타입 버퍼를 메모리에 할당할 때 사용된다. 이 파일의 위치는 사용자 환경

파일에 설정된 SDLFILE이라는 환경변수를 참조한다. tmax 인스톨러는 디

폴트로 이 값을 %TMAXDIR%\sdl\tmax.sdl 로 지정하므로 이 내용을 그대

로 사용하려면 반드시 –o 옵션을 사용하여 tmax.sdl 로 파일을 생성시켜야


한다.

프롬프트에 다음과 같이 입력하여 메이크 파일을 실행한다.

C:\tmax\sample\server> nmake /f svr2.mk

컴파일이 성공하면 서버프로그램 실행파일이 생성되고 그 실행파일은

TMAXDIR\appbin 이라는 디렉토리 밑으로 자동 복사된다. 서비스 프로그

램들이 위치하는 디렉토리는 Tmax 환경파일에 사용자 임의로 설정할 수

있으며 자세한 내용은 Tmax Administraion Guide 를 참조한다.

여기까지 하면 tmax 시스템을 기동 시킬 수 있다. 그렇지만 여기서는 클라

이언트 프로그램 컴파일하는 방법까지 설명한 후 tmax 시스템 기동에 대해

설명하도록 하겠다.

클라이언트 프로그램 컴파일

샘플 클라이언트 프로그램을 컴파일한다. 클라이언트 프로그램은 사용자의

요청을 입력받아 해당하는 서비스를 Tmax 시스템에 요청하는 프로그램이

다. 컴파일 방법은 두 가지가 있는데 비주얼 스튜디오를 사용하는 방법과

서버 프로그램 컴파일하는 방법과 동일한 nmake를 이용하는 방법이다.

TMAXDIR\sample\client 로 이동하면 샘플 클라이언트 프로그램과 make 파일이 들어있는 것을 볼 수 있다.

프롬프트에 다음과 같이 입력하여 메이크파일을 실행한다.

C:\tmax\sample\client> nmake /f toupper.mk

컴파일이 성공하면 클라이언트 프로그램 실행파일이 생성된다. 이 때 클라

이언트 실행파일은 현재 디렉토리에 위치한다.

도스 명령창에서 위와 같이 클라이언트 프로그램을 실행시켜도 되고

Microsoft Visual Studio 5.0/6.0이 설치되어 있다면 다음과 같은 방법으로


도 클라이언트 프로그램을 컴파일 할 수 있다.

Microsoft Visual Studio를 실행시킨 후 샘플 클라이언트 프로그램을 연다.

Default project를 생성시킨 후 F7을 누르거나 메뉴에서 컴파일을 눌러서

컴파일하면 된다. 비주얼 스튜디오를 이용하면 별도의 Makefile이 필요하지

않다.

서버 프로그램과 클라이언트 프로그램의 컴파일이 완료되면 Tmax 시스템

을 기동한다. Tmax 시스템을 기동하는 방법은 다음과 같이 하면 된다.

C:\tmax> tmboot

Tmboot 할 때에도 여러 가지 옵션을 사용할 수 있지만 기본적으로 위와

같이 하면 Tmax 시스템과 환경파일에 등록해 놓은 서버 프로그램들이 기

동 된다. 사용 가능한 다른 옵션들에 관하여 더 자세한 내용을 알고 싶다면

‘Tmax Administration Guide’ 매뉴얼을 참조한다.

Tmax 시스템을 기동하고 나면 샘플 클라이언트 프로그램을 실행시켜 정상

적인 결과가 나오는지 확인한다. 클라이언트 프로그램 실행 방법은 다음과

같이 하면 된다.

C:\tmax\sample\client> toupper aabbcc

샘플 프로그램의 내용은 클라이언트가 사용자로부터 소문자를 입력 받고,

Tmax 시스템을 통해 소문자를 대문자로 변환시키는 서비스를 요청하여 입

력 받은 소문자를 대문자로 변환한 결과를 사용자에게 보여주는 것이다.

Tmax 시스템이 정상적으로 동작한다면 위의 입력결과로 대문자로 구성된

‘AABBCC’라는 결과를 출력하게 된다. 클라이언트를 실행시켜 대문자로 변

환된 결과가 나오는지 확인하고 결과가 정상적으로 나온다면 Tmax 시스템

이 정상적으로 설치되었다는 것을 확인하는 것이다.


II. WebT 설치

WebT는 클라이언트/서버의 환경에서 최적의 성능(Performance)을 발휘하

는 Tmax의 서비스를 Web에서 이용할 수 있도록 Java 기반의 환경에서

개발된 제품으로써, Class Library 형태로 제공된다. WebT는 Applet,

Servlet, JSP 개발 환경을 지원한다. WebT를 이용한 개발 환경에 대해서는

Tmax Programming Guide(WebT) 를 참조한다.

WebT를 사용하기 위한 하드웨어 및 소프트웨어 요구사항에 대한 자세한

내용은 “III. 3. Platform Specifications for Tmax Products” 를 참조한다.


1. WebT 를 설치하기 전에

1.1 WebT 소프트웨어 배포

WebT는 직접적으로 제품을 받지 않을 경우, ㈜티맥스소프트 홈페이지

(http://forum.tmax.co.kr)를 통해서 파일 형태로 내려 받을 수 있다.

1.2 WebT의 사용 환경 이 절에서는 두 가지 환경에서의 WebT 사용법에 관해 알아 보도록 한다.

WebT는 순수 Java로 구현되었기 때문에 Java 환경이 사용 가능한 모든

시스템에서 이용할 수 있다.

이 지침서에서 예로 설명하는 두 가지 환경은 다음과 같다.

첫째, ㈜티맥스소프트에서 개발한 WebtoB(Web Server)와 JEUS(Web

Application Server)

둘째, 범용적으로 널리 쓰이는 아파치 웹서버와 아파치 JServ(Servlet 엔

진)

WebtoB와 JEUS의 설치에 관계된 내용은 WebtoB Installation Guide와

JEUS Installation Guide를 참조한다.

Apache와 JServ의 설치에 관계된 내용은 본 지침서의 “부록 2. Apache

Web Server 및 Apache JServ 설치”를 참고한다.


2. WebT의 설치(UNIX 플랫폼)

Tmax를 이용하여 개발된 어플리케이션을 Web 환경에서 제공하기 위해서

는 기존 웹서버를 연동하는 과정이 필요하다. ㈜TmaxSoft가 C언어를 이용

하여 개발한 웹서버인 Webtob는 Tmax와 엔진 레벨의 연동을 지원하므로

고속의 서비스 수행과 트랜잭션 처리가 가능하다.

Java로 개발된 여타 웹어플리케이션 서버와의 연동은 Tmax의 서비스를 이

용하기 위해 개발된 WebT 클래스 라이브러리를 통해 이루어진다. WebT를

설치하고 적절히 설정함으로써 Tmax로 개발된 어플리케이션을 웹을 통해

사용자들에게 제공할 수 있게 된다.

2.1 WebT 설치 WebT의 인스톨은 Tmax 콘솔 인스톨러를 통해 이루어진다.


1) CD-ROM 드라이브를 마운트 한다. 각 플랫폼별 마운트 방법은 “부록 3.

Platform Specifications for Tmax Products ”를 참조한다.

2) WebT를 설치하고자 하는 사용자 또는 수퍼유저 계정으로 로그인 한다.

4) 설치 CD-ROM이 마운트 되어 있는 디렉토리로 이동한다.

5) 설치 스크립트가 있는 마운트 된 CD-ROM 디렉토리로 이동한다.

6) 설치 스크립트를 실행한다.

sh install.sh

설치과정


다음은 WebT의 설치과정을 보여주며, #으로 주석처리 되어 있는 부분은

설치 항목에 대한 설명이다.

-----------------------------------------------------------------


. . .


# 라이센스 동의를 얻는다. 동의하지 않으면 설치가 중지된다.

From now on, we will try to install. Answer to the following questions.



2. Tmax Client

3. WebT for Tmax


Select Product : 3

# WebT를 설치하기 위해 3번을 입력한다. 설치하지 않고 종료하려면 4번을 입력한다.

You have chosen WebT for Tmax, are you sure? [y/n] : y

# 선택한 사항을 확인한다. 설치를 원치 않으면, n을 눌러 빠져 나간다.

o Input WebT directory to install !

ex) /usr/local/webt

Input -> /usr/local/webt________________


Checking directory '/usr/local/webt' : ‘/usr/local/webt’ is made

# WebT를 설치하고자 하는 디렉토리를 입력한다. 지정한 디렉토리가 존재하지

# 않으면 새롭게 디렉토리를 만든다. 사용 권한이 없는 곳에 디렉토리를 만들려고

# 하거나 절대경로를 입력하지 않으면 설치는 자동적으로 종료된다.



# 설치할 디렉토리의 입력이 끝나면, RETURN 키를 눌러 설치를 시작한다. 중단하고

# 싶으면 Ctrl-C를 눌러 설치를 끝낸다.

Copying file '/cdrom/WebT/webt-1.5.22.tar' to '/usr/local/webt' : OK

. . .

-----------------<<< Post-installation >>>------------------

In order to compile the WebT applications, you should add

path of the webt.jar to CLASSPATH variable and adjust it.

Absolute path of the installed webt.jar is as follows.

/usr/local/webt/lib/webt.jar

-------------------------------------------------------

# 설치 후 해야 할 일에 대해 설명하고 있다. 설치 후에 반드시 webt.jar의 경로를

# CLASSPATH 환경변수에 등록하고 적용시켜 주어야 한다.

# Bourne/Korn Shell의 경우 .profile에 다음과 같이 등록하고 적용시킨다.

# CLASSPATH=$CLASSPATH:/usr/local/webt/lib/webt.jar

============[ Installation is completed successfully ]============

Tmax WebT installation is completed successfully.


Technical Support Center


Homepage: http://www.tmax.co.kr


=======================================================

설치된 WebT의 디렉토리 구조

WebT Directory

bin : 필드키 정의 파일을 컴파일 할 수 있는 fdlc 실행파일

demo : Tmax 연동 데모 프로그램(Apache+ApacheJServ용과 WebtoB+JEUS용)

lib : WebT Class Library

test : HelloWebtServlet.java

WebT Client 설치 후 디렉토리 구조

Root of the WebT

bin

demo

lib

test

for Apache

for WebtoB


2.2 환경 설정

WebT 설치가 정상적으로 끝났다면, Tmax 사용자 계정의 홈 디렉토리로

가서 쉘 환경파일(.profile, .bash_profile, .cshrc 등)에 JDK의 bin 디렉토리

와 JSDK library의 경로를 설정해 준다. WebT 라이브러리도 CLASSPATH

에 추가한다. JDK, JSDK의 설치에 관한 내용은 “부록 2. Apache Web

Server 및 Apache JServ 설치” 에 설명되어 있다. Windows NT 환경에서

는 “II. 3. WebT 설치(Windows NT/2000 플랫폼)” 에서 설명했던 것처럼

각 환경변수(path, CLASSPATH)를 등록하여 적용시킨다.

다음은 Bourne shell 또는 Korn shell의 경우, PATH 및 CLASSPATH 를

지정한 예이다.

PATH=$PATH:/usr/local/jdk1.2.2/bin; export PATH

CLASSPATH=$CLASSPATH:/usr/local/JSDK2.0/lib/jsdk.jar:/usr/local/webt/lib/webt.jar ;

export CLASSPATH

홈 디렉토리에서 쉘 환경파일을 적용시킨다. Bourne/Korn shell 사용자의

경우이다.

. ./.profile

쉘 환경변수의 설정을 마쳤으면, Apache JServ의 설정 파일이 있는 디렉토

리로 이동한다. Apache JServ가 설치된 디렉토리는 /usr/local/jserv 라고

가정한다. Apache JServ의 설치에 관한 내용은 “부록 2. Apache Web

Server 및 Apache JServ 설치” 를 참고한다.

cd /usr/local/jserv/etc

vi 편집기로 jserv.properties 를 열어 편집한다.

파일을 살펴보면 wrapper.classpath 를 설정하는 곳이 있는데 이곳에

WebT 라이브러리가 위치한 절대 경로명을 한 줄 추가한다.

wrapper.classpath=/usr/local/webt/lib/webt.jar


3. WebT 설치(Windows NT/2000 플랫폼)

이 절에서는 Windows NT Server/2000 환경에 WebT를 설치하는 방법에

대해 설명한다. Windows NT 환경에 WebT를 설치하기 위해 인스톨러를

별도로 제공하지는 않는다.

3.1 WebT Client 설치

다음은 WebT를 설치하는 과정이다.

1) CD-ROM의 WebT\windows 폴더로 이동한다.

2) webt-1.6.8.exe를 실행한다.

3.2 환경 설정

webt.jar를 CLASSPATH에 등록하는 순서는 다음과 같다. Windows 2000

을 기준으로 설명한다.

시작 -> 설정 -> 제어판 -> 시스템 -> 고급 -> 환경변수

환경변수 버튼을 누르고 사용자 환경변수에 CLASSPATH 변수가 있는지

확인한다. CLASSPATH 변수가 없다면 새로 만들고, webt.jar가 있는 폴더

를 CLASSPATH 환경변수에 등록한다.


‘새로만들기’ 버튼을 눌러 환경변수에 다음과 같이 등록한다.

JEUS가 이미 설치되어 있다면, CLASSPATH 변수에 c:\Jeus\classes라는

경로가 이미 존재 할 것이다. JEUS가 아닌 아파치 JServ를 설치 했다면

JSDK(Java Servlet Development Kit)의 라이브러리(jsdk.jar) 경로가 설정

되어 있을 것이다. 따라서, 컴파일 시 오류가 발생한다면 이 CLASSPATH

변수를 먼저 점검해야 할 것이다.

모든 과정이 올바르게 진행 되었다면, 확인 버튼을 눌러 빠져 나온 후, 환

경변수가 제대로 등록되었는지 명령 프롬프트 창을 하나 열고 set 명령으

로 확인한다.


환경변수 등록 확인


4. 라이센스 파일 설치

WebT가 미들웨어 Tmax와 연동될 수 있도록 개발되었기 때문에 WebT를

사용하기 위한 별도의 라이센스는 없고 Tmax 라이센스 파일 내에 포함되

어 있다. 기존에 Tmax를 사용하던 시스템에서 WebT를 사용하고자 한다면

WebT 기능을 사용할 수 있는 새로운 라이센스 파일을 받아야 한다. Tmax

시스템이 설치된 디렉토리의 license 디렉토리에 license.dat 파일을 복사

하면 라이센스 파일의 설치는 완료된다. 라이센스의 설치에 관한 내용은 “I.

2.3 환경 설정 및 테스트” 에 자세히 설명되어 있다.


5. WebT 테스트

WebT가 제대로 인스톨되어 잘 작동하는지 확인할 차례이다. WebT 샘플중

HelloWebtServlet.java 와 Tmax와의 연동 테스트를 위한 BufTypeDemo.

java 파일을 가지고 테스트를 진행할 것이다.

다음은 테스트를 위해 설치된 각 플랫폼별/제품별 디렉토리들을 보여준다.

아래 표에 나타난 Tmax 항목에는 Tmax가 설치된 서버의 IP의 주소를 기

록해 놓았다. 참고로 WebtoB와 Apache Web Server가 설치된 장비의 IP

주소는 192.168.0.1이라고 가정한다.

WebtoB JEUS WebT Tmax

UNIX/Linux /usr/local/webtob /usr/local/Jeus /usr/local/webt 192.168.1.1

Windows NT c:\webtob c:\Jeus c:\webt 192.168.1.1

표. WebtoB/JEUS 테스트 환경

Apache ApacheJServ WebT Tmax

UNIX/Linux /usr/local/apache /usr/local/jserv /usr/local/webt 192.168.1.1

표. Apache/ApacheJServ 테스트 환경

여기서 설명하는 모든 과정은 WebtoB와 JEUS가 모두 정상적으로 설치되

었고 필요한 환경변수 들이 적용되었다는 가정 하에 진행된다. WebtoB와

JEUS의 설치에 관한 문서는 해당 매뉴얼을 참조한다.

Apache와 Apache JServ 환경은 Windows에서 설치하였을 때도 비슷하므

로, UNIX 환경에서만 테스트 하기로 한다.


5.1 WebtoB/JEUS 환경

WebT의 연동

WebT를 사용하기 위해서 webt.jar 클래스 라이브러리를 JEUS의 특정 디

렉토리에 위치시켜야 한다. 다음과 같이 webt.jar 를 /usr/local/Jeus/lib/a

pplication 으로 복사한다. 윈도우즈 서버의 경우에도 똑같이 적용하면 된다.

UNIX / Linux의 경우

cp /usr/local/webt/lib/webt.jar /usr/local/Jeus/lib/application

Windows NT의 경우

c:\webt\lib\webt.jar를 c:\Jeus\lib\application 폴더로 복사

WebT의 데모 프로그램이 있는 디렉토리를 JEUS의 Group DocBase로 복

사한다.

cp -R /usr/local/webt/demo/for_WebtoB/webtdemo

$JEUS_HOME/webhome/servlet_home/webapps

HelloWebtServlet.java 가 있는 디렉토리로 이동한다.

cd $JEUS_HOME/webhome/servlet_home/webapps/webtdemo/WEB-INF/classes

다음과 같이 소스 파일을 컴파일 한다.

javac HelloWebtServlet.java

컴파일 도중에 오류가 발생하였다면, 다시 한번 CLASSPATH 환경변수 등


을 체크한다. 컴파일이 정상적으로 진행되어 HelloWebtServlet.class 파일

이 생성되었는지 확인한다.

WebT 테스트 시 불러오는 그림파일이 들어있는 디렉토리를 WebtoB Web

Server의 Document Root에 복사한다.

cp –R /usr/local/webt/test/html/pic /usr/local/webtob/docs

그외의 설정 사항들에 대해서는 이 절의 마지막에 예제가 있으므로 참고한

다. 예제 설정 파일들이 모두 끝난 후에 WebtoB와 JEUS를 시작하도록 한

다.

테스트를 위한 모든 준비가 끝났다면 WebtoB와 JEUS를 시작한다.

WebtoB를 기동한다.

wsboot

WebtoB가 정상적으로 기동 되었다면, JEUS를 시작한다. Windows NT에서

는 명령 프롬프트 창을 열어 실행한다.

jeus

jeusadmin test boot –xml

test는 JEUS가 설치되어 있는 서버의 호스트(컴퓨터) 이름이다. WebtoB와

JEUS의 연동에 관한 자세한 내용은 JEUS Web Container 매뉴얼에서 찾

아볼 수 있다.

JEUS가 정상적으로 시작되었다면, 웹 브라우저를 열고 URL을 아래와 같이

입력해 본다. (192.168.0.1은 WebtoB Web Server가 설치된 서버의 IP 주소

이다.)

http://192.168.0.1/webtdemo/HelloWebtServlet

브라우저 창에 다음과 같은 메시지가 나오면 WebT가 정상적으로 설치된

것이다. (버전 번호는 메뉴얼과 다를 수 있다.)


Hello WebT !

This is WebT version 1.5.22p11

WebT와 Tmax 연동 테스트

WebtoB와 JEUS 환경에서 WebT와 Tmax를 연동하는 방법에 대해서 간단

한 데모 프로그램을 통해 알아본다.

[테스트 환경]

운영 체제: Sun OS 5.7 32bit 버전

쉘: Korn shell

TMAXDIR=/user/tmax

[Tmax 서버 프로그램]

sample.m : Tmax 환경 설정 파일($TMAXDIR/config)

demo1.c : 서버 프로그램($TMAXDIR/sample/webt)

demo.f : 필드키 정의 파일($TMAXDIR/sample/fdl)

[WebT Demo] /usr/local/webt/demo/for_WebtoB/webtdemo/WEB-INF/classes/webtdemo

BufType.java : 서비스와 버퍼타입을 선택하여 문자열을 Tmax 서버쪽으로 보내고

응답받는 프로그램

WebCount.java : 웹페이지 카운트 프로그램

demo.f : 필드키 정의 파일

[HTML Files]

데모 프로그램을 위한 html 파일들(/usr/local/webt/html/webt)



TMAXDIR/config 디렉토리로 이동하여 환경파일을 컴파일한다. 편의상

Tmax 시스템이 설치된 홈 디렉토리를 TMAXDIR 이라 표현하였다.

$>cfl –i sample.m


CFL is done successfully for node(nodename)

다음 서비스 테이블을 생성한다. 서비스 테이블은 각각의 서버 프로세스가

생성될 때 필요한 파일로서 각각의 프로세스들이 어떤 서비스를 처리하는

지에 대한 정보가 담겨 있다.

$>gst

성공적으로 처리되면 다음과 같은 메시지가 출력된다.

SVC tables are successfully generated

GST is successfully done

TMAXDIR/sample/sdl 디렉토리로 이동하여 구조체 정의 이진 파일을 생성

한다.

$>sdlc –c –i demo.s –o tmax.sdl

에러 메시지가 나오지 않으면 정상적으로 컴파일이 이루어진 것이다.

TMAXDIR/sample/fdl 디렉토리로 이동하여 필드키 이진 파일을 생성한다.

$>fdlc –c –i demo.f

성공적으로 컴파일이 이루어지면 다음과 같은 메시지가 출력된다.


FDLC is successfully done

서비스 프로그램 컴파일

TMAXDIR/sample/webt/server 디렉토리로 이동하여 서비스 프로그램을

컴파일한다.

$>./compile c demo1


cc -O -I/user/tmax -c demo1.c

cc -O -I/user/tmax -L/user/tmax/lib -o demo1 demo1.o demo_sdl.o demo1_svctab.o -lsvr -

lnsl -lsocket

mv demo1 /user/tmax/appbin/.

마지막 줄의 /user/tmax/appbin 은 서비스 프로그램들이 위치하는 디렉토

리로 Tmax 환경파일에 사용자 임의로 설정할 수 있다. 자세한 내용은

Tmax Administraion Guide 를 참조한다.

Tmax 기동

Tmax를 기동 시킨다.

$>tmboot

성공적으로 기동 되면 다음과 같은 메시지가 출력된다.

TMBOOT for node(nodename) is starting:

TMBOOT: TMM is starting: Thu Apr 12 23:05:51 2001

TMBOOT: CLL is starting: Thu Apr 12 23:05:51 2001

TMBOOT: CLH is starting: Thu Apr 12 23:05:51 2001

(I) CLH Current Tmax Configuration:

Number of client handler(MINCLH) = 1

Supported maximum user per node = 200

Supported maximum user per handler = 201


TMBOOT: SVR(demo1) is starting: Thu Apr 12 23:05:51 2001

TMBOOT: SVR(webcount) is starting: Thu Apr 12 23:05:51 2001

nodename, Supported maximum user per node, Supported maximum

user per handler는 시스템마다 다른 값을 가진다.

클라이언트쪽 샘플 프로그램을 컴파일 해서 테스트를 해본다. 테스트를 위

해서 WebtoB와 JEUS 환경을 맞춰야 한다. WebtoB와 JEUS의

Configuration 파일은 이 절의 마지막에 수록해 놓았으므로 참고한다.


설치 후, HelloWebtServlet 테스트를 하지 않았다면, WebT의 데모 프로그

램이 있는 디렉토리를 JEUS의 Group DocBase로 복사한다.

cp -R /usr/local/webt/demo/for_WebtoB/webtdemo

$JEUS_HOME/webhome/servlet_home/webapps

WebtoB Web Server와 Tmax Server 시스템이 동일 서버 내에 설치되어

있고, 포트번호를 바꾸지 않았다면 소스 수정이 필요 없지만, 만약 서버가

서로 분리되어 있다면 컴파일 하기 전에 반드시 소스를 수정해 주어야만

한다. BufType.java 와 WebCount.java 파일을 열어 다음 원본의 내용을

아래와 같이 수정하도록 한다.

WebtConnection con = new WebtConnection("localhost", 8888, 10, 20, 1);

localhost 는 Tmax가 설치된 서버의 IP 주소 또는 도메인(FQDN) 이름에

해당된다. WebtoB와 Tmax가 한 시스템에 존재한다면, localhost 를 고칠

필요는 없다. ‘8888’은 Tmax 시스템이 연결을 기다리는 포트번호에 해당

한다. Tmax 시스템에 연결할 수 있도록 포트번호와 IP 주소를 알맞게 바꾸

고 저장한다.

WebtConnection con = new WebtConnection("192.168.1.1", 8888, 10, 20, 1);

다음과 같이 컴파일을 시도한다. Windows 환경이라면 fdlc와 javac를 이용

해서 직접 컴파일 하도록 한다.


make

컴파일이 잘 되었다면, 생성된 클래스 파일들을 볼 수 있을 것이다. 이때,

게시판 관련 소스들도 컴파일이 되는데 이를 사용하려면, Tmax 시스템 환

경 파일(sample.m)에 등록해 주어야 하고, 오라클 DBMS에 테이블도 생성

해야 한다.

이 내용은 for_WebtoB 디렉토리의 README.first에 설명되어 있다.

Webtob 와 JEUS의 기동 이번엔 html 파일들을 WebtoB의 DocumentRoot로 복사한다. 관련 html

파일들은 /usr/local/webt/demo/for_WebtoB/html/webt 디렉토리 안에 있

다.

cp -R /usr/local/webt/demo/for_WebtoB/html/webt /usr/local/webtob/docs

WebtoB와 JEUS를 기동 시키기 전에 먼저 수정해야 할 몇 가지 파일들이

있다.

$JEUS_HOME/config/hostname/hostname_servlet_engine1/container.xml

과 $JEUS_HOME/webhome/servlet_home/webapps/webtdemo/WEB-INF

/web.xml을 수정한다. 해당 수정 내용들은 볼드체로 표시해 놓았다. 수정

할 내용은 이 절의 마지막에 있는 각종 설정 파일을 참조한다.

WebtoB와 JEUS를 기동 시킨다.

wsboot

jeus

jeusadmin test boot -xml

Tmax와 연동할 수 있는 데모 프로그램이 잘 동작하는지 브라우저를 통해

서 확인한다. URL을 다음과 같이 입력한다.

http://192.168.0.1/webt/index.html

아래 그림과 같이 화면이 나타나고, 소문자로 입력하여 서비스 요청을 하면,

Tmax 서버가 처리한 후 결과를 보내준다.


WebT와 Tmax의 연동에 관한 좀더 자세한 내용과 응용프로그램 개발을

위한 WebT 클래스 설명은 Tmax WebT Programming Guide 를 참조하도

록 한다.


다음은 테스트에 필요한 각종 설정 파일들에 대한 내용이다.

< Tmax Configuration File >

/user/tmax/config/sample.m

*DOMAIN

tmax1 SHMKEY =79990, MINCLH=1, MAXCLH=3,

TPORTNO=8888, BLOCKTIME=30

*NODE

nodename TMAXDIR = "/user/tmax",

APPDIR = "/user/tmax/appbin",

PATHDIR = "/user/tmax/path",

TLOGDIR = "/user/tmax/log/tlog",

ULOGDIR = "/user/tmax/log/ulog",

SLOGDIR = "/user/tmax/log/slog"

*SVRGROUP

svg1 NODENAME = "nodename"

*SERVER

demo1 SVGNAME=svg1, MIN=1

webcount SVGNAME=svg1, MIN=1

*SERVICE

TOUPPER_FDL SVRNAME=demo1

TOUPPER_STRING SVRNAME=demo1

TOUPPER_CARRAY SVRNAME=demo1

WEBCNT SVRNAME=webcount


<UNIX용 WebtoB 설정파일>

/usr/local/webtob/config/http.m

*DOMAIN

webtob1

*NODE

test WEBTOBDIR="/usr/local/webtob", HTH = 2, SHMKEY = 54000,

DOCROOT="/usr/local/webtob/docs", HTTPPORT = 80,

KEEPAliveTimeout = 15, JSVPORT = 9900,

Logging = "log1", Errorlog = "log2", CacheEntry = 0

*SVRGROUP

htmlsvg NODENAME = test, SvrType = HTML

jsvg NODENAME = test, SVRTYPE = JSV

*SERVER

html SVGNAME = htmlsvg, MinProc = 2, MaxProc = 10

MyGroup SVGNAME = jsvg, MinProc = 10, MAXProc = 20

*URI

uri1 Uri = "/examples/", Svrtype = JSV

uri2 Uri = "/webtdemo/", Svrtype = JSV

*ALIAS

alias1 URI = "/icons/", REalPath = "/usr/local/webtob/icons"

*EXT

htm MimeType = "text/html", SvrType = HTML

*LOGGING

log1 Format = "DEFAULT", FileName = "/usr/local/webtob/log/access.log",

OPTION = "sync"

log2 Format = "DEFAULT", FileName = "/usr/local/webtob/log/err.log",

OPTION = "sync"


<UNIX용 WebtoB 설정파일>

/usr/local/webtob/config/http.m

*DOMAIN

webtob1

*NODE

test WEBTOBDIR="/usr/local/webtob", HTH = 2, SHMKEY = 54000,

DOCROOT="/usr/local/webtob/docs", HTTPPORT = 80,



*SVRGROUP



*SERVER



*URI



*ALIAS

alias1 URI = "/icons/", REalPath = "/usr/local/webtob/icons"

*EXT


*LOGGING

log1 Format = "DEFAULT", FileName = "/usr/local/webtob/log/access.log",

OPTION = "sync"

log2 Format = "DEFAULT", FileName = "/usr/local/webtob/log/err.log",

OPTION = "sync"


<Windows NT용 WebtoB 설정파일>

c:\webtob\config\http.m

*DOMAIN

webtob1

*NODE

test WEBTOBDIR="c:\\WebtoB", HTH = 2, SHMKEY = 54000,

DOCROOT="c:\\WebtoB\\docs", HTTPPORT = 80,



*SVRGROUP



*SERVER



*URI



*ALIAS

alias1 URI = "/icons/", REalPath = "c:\\WebtoB\\icons\\"

*EXT


*LOGGING

log1 Format = "DEFAULT", FileName = "c:\\ WebtoB\\log\\access.log",

OPTION = "sync"

log2 Format = "DEFAULT", FileName = "c:\\WebtoB\\log\\err.log",

OPTION = "sync"


<UNIX / Windows NT 공통>

/usr/local/Jeus/config/hostname/hostname_servlet_engine1/container.xml

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE Container PUBLIC '-//Tmax Soft., Inc.//DTD Web Container//EN'

'file:///c:/Jeus/config/dtds/web-container_1_3.dtd'>

<Container MonitoringIntval="300"

SessionMonitoringIntval="600"

RedirectStdOut="true"

RedirectStdErr="true">

<ContextGroup GroupName="MyGroup"

GroupDocBase="webapps"

SharedSession="true"

SessionTimeoutMinute="20"

PrintErrorToBrowser="true">

<JSPEngine KeepGenerated="true"/>

<Logging ErrorLog="default" ErrorLogLevel="warning" ErrorLogBufferSize="0"

UserLog="default" UserLogBufferSize="0" AccessLog="default"

AccessLogBufferSize="0" AccessLogFormat="Default"/>

<Context ContextName="Examples" ContextPath="/examples"

DocBase="examples" EnableJSP="true" AutoReload="true">

</Context>

<Context ContextName="webtdemo" ContextPath="/webtdemo"

DocBase="webtdemo” EnableJSP="true" AutoReload="true">

</Context>

<Connection ListenerType="WebtobListener" Port="9900"

WebServerAddress="192.168.0.1" RegistrationID="MyGroup"

ConnectionPortNum="2" ServerAccessControl="false">

<ThreadPool MinThread="10" MaxThread="20" ChangeRate="2"

MaxIdleTime="300" MaxWaitQueue="4" />

</Connection>

</ContextGroup>

</Container>


/usr/local/Jeus/webhome/servlet_home/webapps/webtdemo/WEB-INF/web.xml

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN'

'file:///c:/Jeus/config/dtds/web-app_2_2.dtd'>

<web-app>

<servlet>

<servlet-name>ServletContextTest</servlet-name>

<servlet-class>ServletContextTest</servlet-class>

</servlet>

. . .

중간생략

. . .

<servlet>

<servlet-name>HelloWebtServlet</servlet-name>

<servlet-class>HelloWebtServlet</servlet-class>

<load-on-startup>-1</load-on-startup>

</servlet>

<servlet>

<servlet-name>BufType</servlet-name>

<servlet-class>webtdemo.BufType</servlet-class>

</servlet>

<servlet>

<servlet-name>WebCount</servlet-name>

<servlet-class>webtdemo.WebCount</servlet-class>

</servlet>

. . .

이하 생략

. . .


5.2 Apache/Apache JServ 환경

이 절에서는 Apache와 Apache JServ 환경에서 WebT를 테스트 하는 방법

에 대해 설명한다. Apache와 Apache JServ를 설치하는 방법은 이 지침서

의 “부록 2. Apache Web Server 및 Apache JServ 설치” 에 설명되어 있

다.

WebT 연동 테스트

HelloWebtServlet.java 가 있는 디렉토리로 이동한다.

cd /usr/local/webt/test

다음과 같이 소스 파일을 컴파일 한다.

javac HelloWebtServlet.java

컴파일 도중에 오류가 발생하였다면, 다시 한번 CLASSPATH 환경변수 등

을 체크한다. 컴파일이 정상적으로 진행되어 HelloWebtServlet.class 파일

이 생성 되었다면, 서블릿 클래스 디렉토리로 복사한다.

cp HelloWebtServlet.class /usr/local/jserv/servlets

디폴트 서블릿 클래스 디렉토리는 Apache JServ의 zone.properties 에 다

음과 같이 정의되어 있다.

repositories=/usr/local/jserv/servlets

WebT 테스트 시 불러오는 그림파일이 들어있는 디렉토리를 Apache Web

Server의 Document Root에 복사한다.

cp –R /usr/local/webt/test/html/pic /usr/local/apache/htdocs


테스트를 위한 모든 준비가 끝났다면 Apache Web Server를 기동 시킨다.

/usr/local/apache/bin/apachectl start

아파치가 정상적으로 시작되었다면, 웹 브라우저를 열고 URL을 아래와 같

이 입력해 본다. (192.168.0.1은 아파치 웹서버가 설치된 서버의 IP 주소이

다.)

http://192.168.0.1/servlets/HelloWebtServlet

브라우저 창에 다음과 같은 메시지가 나오면 WebT가 정상적으로 설치된

것이다.(버전 번호는 메뉴얼과 다를 수 있다.)

Hello WebT !

This is WebT version 1.5.22p9

WebT와 Tmax 연동 테스트

Apache와 Apache JServ 환경에서 WebT와 Tmax를 연동하는 방법에 대

해서 간단한 테스트를 통해 알아본다.

[테스트 환경]

운영 체제: Sun OS 5.7 32bit 버전

쉘: Korn shell

제품이 설치된 시스템의 환경은 2.5 WebT 테스트에 이미 언급되어 있으므로 참고한다.

[Tmax 서버 샘플 프로그램]

Tmax 서버측 환경은 2.5.1 WebtoB/JEUS 환경에서 테스트의 환경과 동일하다.

[WebT 클라이언트 샘플 프로그램]

/usr/local/webt/demo/for_Apache/webtdemo


BufType.java, WebCount.java : 클라이언트 프로그램

[HTML Files]

데모 프로그램을 위한 html 파일들(/usr/local/webt/html/webt)

Tmax의 서버 샘플 프로그램의 컴파일 방법과 Tmax 기동에 대해서는

WebtoB와 JEUS 환경에서 다루었으므로 이곳에서는 생략 하기로 한다. 여

기에서 다른 것은 Servlet Class의 경로이다.


WebT의 데모 프로그램이 들어있는 디렉토리를 JServ의 servlets 디렉토리

로 복사하고 소스를 수정한다.

cp -R /usr/local/webt/demo/for_Apache/webtdemo /usr/local/jserv/servlets

아파치 웹서버와 Tmax 시스템이 동일 서버 내에 설치되어 있고, 포트번호

를 바꾸지 않았다면 소스 수정이 필요 없지만, 만약 서버가 서로 분리되어

있다면 컴파일 하기 전에 반드시 소스를 수정해 주어야만 한다. BufType.

java와 WebCount.java 파일을 열어 다음의 내용을 수정하도록 한다.

WebtConnection con = new WebtConnection("localhost", 8888);

localhost 는 Tmax가 설치된 서버의 IP 주소 또는 도메인(FQDN) 이름에

해당된다. WebtoB와 Tmax가 한 시스템에 존재한다면, localhost 를 고칠

필요는 없다. ‘8888’은 Tmax 시스템이 연결을 기다리는 포트번호에 해당

한다. Tmax System에 연결할 수 있도록 포트번호와 IP 주소를 알맞게 바

꾸고 저장한다.

WebtConnection con = new WebtConnection(“192.168.1.1”, 8888);

다음과 같이 컴파일을 시도한다. Windows 환경이라면 fdlc와 javac를 이용

해서 직접 컴파일 하도록 한다.

make

컴파일이 잘 되었다면, 생성된 클래스 파일들을 볼 수 있을 것이다. 이때,


게시판 관련 소스들도 컴파일이 되는데 이를 사용하려면, Tmax 시스템 환

경 파일(sample.m)에 등록해 주어야 하고, 오라클 DBMS에 테이블도 생성

해야 한다.

이 내용은 for_Apache 디렉토리의 README.first에 설명되어 있다.

아파치 웹서버 / 아파치 JServ의 기동

이번엔 html 파일들을 WebtoB의 DocumentRoot로 복사한다. 관련 html

파일들은 /usr/local/webt/demo/for_Apache/html/webt 디렉토리 안에 있

다.

cp -R /usr/local/webt/demo/for_Apache/html/webt /usr/local/apache/htdocs

Apache를 기동 시킨다.


Tmax와 연동할 수 있는 샘플 프로그램(BufTypeDemo.class)이 잘 동작하

는지 브라우저를 통해서 확인한다. URL을 다음과 같이 입력한다.

http://192.168.0.1/webt/index.html

WebT와 Tmax의 연동에 관한 좀더 자세한 내용과 응용프로그램 개발을

위한 WebT 클래스 설명은 Tmax WebT Programming Guide 를 참조하도

록 한다.


III. 부록

1. TMS 컴파일 2. Apache Web Server 및 Apache JServ 설치

3. Platform Specifications for Tmax Products


1. TMS 컴파일

TMS(Transaction Management Server)는 Tmax 시스템의 구성요소로써

데이터베이스 관리 및 분산 트랜잭션 처리를 담당하는 프로세스이다. 이곳

에서는 Oracle과 Informix DBMS용 TMS 이진 파일의 생성 방법에 관하여

알아본다.

윈도우즈 환경에서는 TMS를 만드는 과정이 필요하지 않으며 현재 Oracle

만을 지원한다.

TMS for Oracle DBMS

TMS for Infomix DBMS

1.1 TMS for Oracle DBMS

Tmax에서 제공하는 tms_ora.mk 파일을 컴파일 해서 Oracle용 TMS 이진

파일을 만들 수 있다. tms_ora.mk 는 TMAXDIR/sample/server 디렉토리

에 있으며, 다음과 같이 컴파일 할 수 있다.

Note : TMAXDIR은 Tmax가 설치된 디렉토리를 나타낸다.

Step 1. Tmax 사용자 계정으로 로그인 한다.

su – tmax

Step 2. Oracle 환경변수 들을 가져와 쉘 환경파일에 붙여 넣고 적용시킨다.

다음은 Oracle 환경변수의 예이다.

## Oracle Environment ##


ORACLE_HOME=/oracle/app/oracle/product/8.0.5; export ORACLE_HOME

PATH=$PATH:$ORACLE_HOME/bin; export PATH

ORACLE_SID=ora805; export ORACLE_SID

NLS_LANG=American_America.KO16KSC5601; export NLS_LANG

ORA_NLS33=$ORACLE_HOME/ocommon/nls/admin/data; export ORA_NLS33

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME/lib;

export LD_LIBRARY_PATH

Step 3. $TMAXDIR/sample/server 디렉토리로 이동한다.

cd $TMAXDIR/sample/server

Step 4. Oracle용 TMS makefile(tms_ora.mk)을 가지고 컴파일 한다.

make –f tms_ora.mk all

컴파일 되어 생성된 TMS 이진 파일은 $TMAXDIR/appbin 디렉토리로 옮

겨지게 된다 이 파일은 tmboot 시 메모리에 적재되어, XA 인터페이스를 이

용하여 전역 트랜잭션 처리를 하는 Tmax 시스템에서 2PC(Phase Commit)

을 지원한다. Oracle용 TMS를 기동 시키기 위해 설정하는 Tmax 설정 파일

은 $TMAXDIR/config/sample.m을 참고한다.


1.2 TMS for Infomix DBMS

Informix용 TMS를 생성하기 위한 make 파일은 $TMAXDIR/sample/serv

er에 있으며, 파일명은 tms_info.mk이다. TMS 이진파일을 생성하는 과정

은 다음과 같다.

Step 1. Informix 계정으로 로그인 한다. Informix에서 사용하는 환경변수

들이 제대로 설정되어 있다고 가정한다.

su - informix

Step 2. esql을 다음과 같이 실행하여 결과로써 result 파일을 만든다.

esql -libs > result

Step 3. result 파일을 /tmp 디렉토리로 옮긴다.

mv result /tmp

result 파일의 내용은 다음과 같다.

<result>

----------------------------------------------------------------

-lifsql

-lifasf

-lifgen

-lifos

-lifgls

-lnsl

-lsocket

-laio

-lm

-ldl

-lelf

/user3/informix/lib/esql/checkapi.o


-lifglx -------------------------------------------------------------------

Step 4. 2PC(Phase Commit)를 지원하는 XA 인터페이스를 사용할 수 있도

록 하기 위해 플래그의 마지막에 –lifxa를 추가하고, result 파일의 내용을

복사해서 tms_info.mk 파일의 ‘INFOLIBS = ’ 에 붙여 넣는다. 이 플래그들

은 한 줄로 연결해서 붙여 넣어야 한다.

<tms_info.mk> ----------------------------------------------------------------

TARGET = tms_info

INFOLIBDIR = ${INFORMIXDIR}/lib

INFOELIBDIR = ${INFORMIXDIR}/esql

INFOLIBD = ${INFORMIXDIR}/lib/esql

INFOLIBS = -lifsql -lifasf -lifgen -lifos -lifgls -lnsl -lsocket -laio -lm -ldl -lelf

/user3/informix/lib/esql/checkapi.o -lifglx -lifxa

TMAXLIBDIR = $(TMAXDIR)/lib

TMAXLIBS = -ltms

$(TARGET):

$(CC) -o $(TARGET) -L$(TMAXLIBDIR) $(TMAXLIBS) -L$(INFOLIBD) -L$(INFOLIBDIR) -

L$(INFOELIBDIR) $(INFOLIBS)

cp $(TARGET) $(TMAXDIR)/appbin

clean:

-rm -f core $(TARGET)

----------------------------------------------------------------

Step 5. tms_info.mk를 저장하고, make를 수행해서 Informix용 TMS 이진

파일을 만든다. Informix에 XA 라이브러리가 설치되어 있지 않을 경우,

make 수행 중 해당 라이브러리를 찾을 수 없어 컴파일 오류가 날 수 있다.

이때는 해당 라이브러리를 설치한 후에 make를 수행하도록 해야 한다.

make -f tms_ora.mk


컴파일 되어 생성된 TMS 이진 파일은 $TMAXDIR/appbin 디렉토리로 옮

겨지게 된다. Oracle용 TMS를 기동 시키기 위해 설정하는 Tmax 설정 파

일은 $TMAXDIR/config/sample.m을 참고한다.


2. Apache Web Server 및 Apache JServ 설치

WebT를 설치하고 사용하기 위해서는 웹서버와 여러가지 관련 프로그램이

미리 설치되어야 한다. 이곳에서는 전세계에서 가장 많이 사용하는 아파치

웹서버와 Java 응용 클라이언트 프로그램을 개발하기 위한 아파치 JServ의

설치에 관해 알아보도록 한다. Java 환경을 지원하는 다른 웹서버에서도

WebT의 사용이 가능하다. 여기서 설명되는 패키지 외의 웹서버 또는 Java

개발 환경에 대한 설치는 다루지 않기 때문에 관련 매뉴얼을 참조한다.

필요한 소프트웨어 목록

Java Development Kit (JDK 1.1 이상) Java Servlet Development Kit (JSDK 2.0) Apache JServ (ApacheJServ 1.1 이상) Apache Web Server : apache-1.3.x (2.0 이상에서는 테스트 되어 있지 않음)

위의 목록에서 언급한 범위 내의 소프트웨어를 가지고 있다면 별 문제 없

이 설치를 할 수 있을 것이다. JDK의 경우 각 하드웨어 벤더들이 제공하는

패키지를 이용하면 된다. 솔라리스, 리눅스, 윈도우용 JDK는 http://www.jav asoft.com 에 가면 구할 수 있다.

설치하는 방법을 설명하기 위해 사용된 패키지들은 다음과 같으며, 사용된

운영체제는 리눅스이다. 다음의 파일들은 모두 /usr/local/src 에 있다고 가

정한다. 또한, 사용될 Apache와 Apache JServ는 DSO(Dynamic Shared

Object)가 아닌 static 방식으로 컴파일하게 된다는 것을 알아두어야한다.

DSO나 static 방식에 관한 내용은 Apache 매뉴얼을 참조한다. Windows

NT 환경에서 설치하려면 별도의 Windows용 패키지를 내려 받아 설치 하

여야 한다.

Windows용 패키지를 설치하기 위해서는 해당 매뉴얼을 참조한다.


jdk1_2_2-linux-i386.tar.Z

OS별로 각 vendor에서 제공하고, 해당 vendor의 홈페이지 등에서 구할 수

있으며, 이진파일 형태로 받아 설치 하면 된다.

jsdk20-solaris2-sparc.tar.Z

Sun Microsystems에서 제공하며, 내려 받아 어떤 운영체제에서도 사용할

수 있다.

apache_1.3.12.tar.Z

아파치 웹서버로 아파치 홈페이지(http://www.apache.org) 또는 관련 사이

트에서 구할 수 있다. 소스 형태로 받을 경우에는 컴파일 과정이 필요하다.

ApacheJServ-1.1.tar.gz

Apache Software Foundation (http://www.apache.org) 에서 구할 수 있으며,

소스 형태로 받을 경우, 컴파일 작업이 필요하다.

소스는 GNU의 gzip(.gz)이나 compress(.Z) 로 압축되어 있을 수 있다. gz

으로 끝나는 파일은 ‘gunzip’이나 ‘gzip –d’로 압축해제 할 수 있으며 Z로

끝나는 파일은 ‘uncompress’나 ‘zcat’ 툴을 이용하여 풀 수 있다. 자세한

사항은 해당 툴의 매뉴얼을 참조한다.

예제는 Bourne/Korn shell을 기준으로 설명한다. C shell 사용자는 관련 매

뉴얼을 참조한다.

설치 시 주의할 점이 한가지 있다. ApacheJServ-1.1을 설치할 때

configure 실행 시 GNU make를 찾기 때문에 리눅스가 아닌 GNU make가

설치되어 있지 않은 대부분의 다른 유닉스 상에서 오류가 날 것이다. 이 부


분은 차차 설명하기로 하겠다.

앞으로의 과정은 root권한으로 수행하며, 설치순서는 다음과 같다.

필요한 파일들을 적당한 디렉토리 아래에 풀거나 설치할 수 있도록 한다.

루트권한으로 소스가 있는 디렉토리로 이동한다.

cd /usr/local/src

JDK 1.2.2 설치

압축을 풀면 jdk1.2.2 디렉토리가 생성된다. 이 디렉토리를 적당한 위치로

옮긴다.

zcat jdk1_2_2-linux-i386.tar.Z | tar xf –

mv jdk1.2.2 /usr/local

참고 : JDK 1.3 이상의 버전에서는 스크립트 방식의 설치를 할 수 있도록

하고 있다. sh 또는 bin이라는 확장자를 가진 파일이라면 다음과 같은 방법

으로 설치할 수 있다.

sh j2sdk-1_3_0_01-solsparc.bin

JSDK 2.0의 설치

압축을 풀면 JSDK2.0 디렉토리가 생성된다. 이 디렉토리를 적당한 위치로

옮긴다.

zcat jsdk20-solaris2-sparc.tar.Z | tar xf –

mv JSDK2.0 /usr/local

PATH와 CLASSPATH를 설치 사용자 계정의 쉘 환경파일에 등록하여 두


면 된다.

PATH=$PATH:/usr/local/jdk1.2.2/bin ; export PATH

CLASSPATH=$CLASSPATH:/usr/JSDK2.0/lib/jsdk.jar; export CLASSPATH

위와 같이 환경변수를 설정한 후, 적용시켜 준다.

. ./.profile

적용시킨 후에는 다음과 같이 env 명령으로 CLASSPATH를 확인해 본다.

env | grep CLASSPATH

아파치 / 아파치 JServ의 설치

아파치 웹서버의 소스를 풀어 놓은 다음 설치하여 준다.

zcat apache_1.3.12.tar.Z | tar xf –

cd apache_1.3.12

./configure --prefix=/usr/local/apache

make install

이것은 Apache JServ를 설치하기 전에 한번 수행해 주는 작업으로

Apache JServ의 설치가 끝나면 JServ 라이브러리 모듈과 함께 다시 한번

컴파일 해주어야 한다.

ApacheJServ-1.1.tar.gz 파일의 압축을 푼다.

gunzip ApacheJServ-1.1.tar.gz

tar xf ApacheJServ-1.1.tar

다음의 과정을 거쳐 설치를 한다. 이때 prefix 부분에 Apache JServ가 설

치 되기를 원하는 곳을 입력하면 된다. prefix를 정하지 않으면 디폴트로

/usr/local/jserv에 설치된다.


./configure --prefix=/usr/local/jserv \

--with-apache-src=/usr/local/src/apache1.3.12 \

--with-jdk-home=/usr/local/jdk1.2.2 \

--with-JSDK=/usr/local/JSDK2.0/lib/jsdk.jar \

--disable-debugging

ApacheJServ-1.1을 설치할 때 configure 실행 시 GNU make를 찾기 때

문에 리눅스가 아닌 GNU make가 설치되어 있지 않은 대부분의 다른 유닉

스 상에서는 다음과 같이 해야한다.

GNU make 소스를 ftp://ftp.gnu.org에서 내려 받아서 컴파일을 하면

/usr/local/bin 디렉토리에 실행 가능한 make 이진파일이 생성된다. 원래

시스템에 있던 make 보다 먼저 찾을 수 있게 다음처럼 명령행에서 PATH

변수의 앞부분에 /usr/local/bin 디렉토리를 추가하고 export 명령으로 적

용시킨 후 위의 configure 작업을 다시 시작한다.

PATH=/usr/local/bin:$PATH ; export PATH

configure 과정이 끝나면 make install을 수행한다.

make install

설치를 이상없이 마쳤다면 /usr/local/jserv라는 디렉토리가 만들어진다.

다음은 Apache 소스가 있는 디렉토리로 이동해서 아래의 과정을 수행한다.

cd /usr/local/src/apache_1.3.12

./configure --prefix=/usr/local/apache \

--activate-module=src/modules/jserv/libjserv.a

make

make install

환경 설정 부분은 다음과 같다.

이미 JDK와 JSDK는 쉘 환경파일의 PATH와 CLASSPATH에 설정을 하였

다.


Apache JServ와 Apache Web Server는 컴파일 한 후, 각각의 설정파일에

내용을 추가 또는 변경함으로써 환경을 구성할 수 있다.

Apache가 최종적으로 컴파일 되었으면, 아파치가 설치된 디렉토리로 이동

한다. 이곳에 설정 파일을 담고 있는 conf라는 디렉토리가 존재한다. conf

디렉토리로 이동한 후 httpd.conf란 파일을 편집한다.

cd /usr/local/apache/conf

vi httpd.conf

Apache가 시작 될 때 Servlet 엔진이 같이 구동 되기 위해서는 이 파일의

마지막에 Apache JServ의 설정 파일을 읽어 들일 수 있도록 httpd.conf의

마지막 부분에 다음과 같이 한 줄을 추가한다.

Include /usr/local/jserv/etc/jserv.conf

나중에 Apache Web Server가 시작될 때 다음과 같은 순서로 설정 파일이

불려지게 된다.

httpd.conf -> jserv.conf -> jserv.properties -> zone.properties

jserv.conf, jserv.properties, zone.properties는 모두 /usr/local/jserv/etc

디렉토리 안에 존재하는 파일들이다.

Apache를 기동 시켜 본다.


Apache와 Apache JServ가 정상적으로 설치되고 기동 되었다면, 다음과 같

은 프로세스가 httpd 데몬과 함께 생성되어 있을 것이다. 이것은 ps 명령으

로 확인할 수 있다.

/usr/local/jdk1.2.2/bin/i386/native_threads/javaorg.apache.jserv.JServ ……

Apache와 Apache JServ가 정상적으로 설치되고 기동 되었는지를 확인하

기 위해 웹 브라우저에서 다음처럼 서버의 테스트 페이지를 불러온다. 패키


지가 설치된 서버의 IP 주소는 192.168.0.1 이라고 가정한다.

http://192.168.0.1/index.html.en

Apache Web Server의 테스트 페이지

Apache JServ가 제대로 동작하는지 확인하기 위해 다음과 같은 URL 주소

를 브라우저 창에 입력한다.

http://192.168.0.1/servlet/IsItWorking



3. Platform Specifications for Tmax Products

응용프로그램 및 시스템 또는 유저 로깅 정보에 따라 더 많은 디스크 공간

이 필요할 수 있다.

컴파일러는 Tmax 응용프로그램 개발 시에만 필요하다.

3.1 Compaq Tru64 v4.0 on Alpha

1) 하드웨어 요구사항

플랫폼 : Compaq Alpha

메모리 : 128MBytes 이상(256 Mbytes 이상 권장)

디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)

2) 소프트웨어 요구사항

운영체제 : Tru64 4.0

컴파일러 : Compaq ANSI C compiler

3) 네트워크

TCP/IP 네트워크

4) 설치된 제품의 디스크 사용공간

Tmax Server and Client : 6391 Kbyte

Tmax Client : 951 Kbyte

5) CD-ROM 마운트 방법

수퍼유저 권한으로 CD-ROM을 마운트할 디렉토리가 없으면 새로운 디렉토리 생성

mkdir /cdrom

/sbin/mount -r -t cdfs /dev/devicename /cdrom


3.2 Compaq Tru64 v5.0(5.1) on Alpha


플랫폼 : Compaq Alpha




운영체제 : Tru64 5.0

컴파일러 : Compaq ANSI C compiler

3) 네트워크

TCP/IP 네트워크





mkdir /cdrom

/usr/sbin/mount -r -t cdfs /dev/cdrom_devicename /cdrom

3.3 HP UX v10.20 on HP9000 Series


운영체제 : HP PA-RISC





운영체제 : HP-UX 10.20

컴파일러 : HP-UX ANSI C Compiler

3) 네트워크

TCP/IP 네트워크





su -

mkdir /cdrom

mount -F cdfs -o cdcase /dev/dsk/cdrom_devicename /cdrom

3.4 HP HP-UX v11.00 on HP9000 Series


플랫폼 : HP PA-RISC




운영체제 : HP-UX 11.0(64bit 아키텍쳐 지원)

컴파일러 : HP-UX ANSI C Compiler

3) 네트워크

TCP/IP 네트워크



Tmax Server and Client(32bit) : 5078 Kbyte

Tmax Client(32bit) : 700 Kbyte




su -

mkdir /cdrom

mount -F cdfs -o cdcase /dev/dsk/cdrom_devicename /cdrom

3.5 IBM AIX v4.3.x on RS/6000


플랫폼 : IBM PowerPC




운영체제 : AIX v4.3.x(64bit 아키텍쳐 지원)

컴파일러 : AIX XL C Compiler

3) 네트워크

TCP/IP 네트워크








smit 또는 smitty 유틸리티를 이용해서 CD-ROM 장치를 마운트 시킨다.

smitty mount

3.6 SUN Solaris v2.5.1(SunOS 5.5.1) on SPARC


플랫폼 : SUN UltraSPARC




운영체제 : SunOS 5.5.1

컴파일러 : SparCompiler C 4.0 또는 그 이상

3) 네트워크

TCP/IP 네트워크





별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 마운트 가능

3.7 SUN Solaris v2.6(SunOS 5.6) on UltraSPARC







운영체제 : SunOS 5.6


3) 네트워크

TCP/IP 네트워크





별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 /cdrom에 마운트







운영체제 : SunOS 5.7(64bit 아키텍쳐 지원)


3) 네트워크

TCP/IP 네트워크















운영체제 : SunOS 5.8(64bit 아키텍쳐 지원)


4) 네트워크

TCP/IP 네트워크









3.10 RedHat Linux 7.x on Intel


플랫폼 : Based on Intel CPU




운영체제 : RedHat Linux 계열 또는 기타 배포판(Kernel 2.0 이상)

컴파일러 : (Tmax 응용프로그램 개발 시에만 필요)

3) 네트워크

TCP/IP 네트워크


Tmax Server and Client(32bit) : 3860 kbyte



/mnt/cdrom 디렉토리가 없으면, 수퍼유저 권한으로 디렉토리를 생성

mkdir /mnt/cdrom

mount /mnt/cdrom 또는 mount –rt iso9660 /dev/devicename /mnt/cdrom

6) 알아두어야 할 사항

레드햇 계열에서는 Tmax 제품이 테스트 되었음.

RedHat 계열 이외의 배포판에 대해서는 일반적으로 잘 동작 할 것이라 기대되지만,

보장하지는 않음.


3.11 Windows NT 4.0 on Intel






컴파일러 : Windows NT 4.0 Server(서비스팩 3.0 이상 필요)

운영체제 : Microsoft Visual C++ 5.0 또는 그 이상

3) 네트워크

TCP/IP 네트워크



Tmax Server 또는 Tmax Client 설치 시 재시작 필요

3.12 Windows NT 5.0(Windows 2000) on Intel






운영체제 : Windows 2000 Server

컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램 개발 시에만 필요)

3) 네트워크


TCP/IP 네트워크



Tmax Server 설치 시 재시작이 필요하다는 메시지가 나오나 실제로 재시작 필요하지

않음. Windows NT 4.0 Server 상에서만 설치 후 재시작 필요

3.13 Windows 98 on Intel



메모리 : 32MBytes 이상

디스크 : 10MBytes 이상의 여유공간


운영체제 : Windows 98 (or Windows Me)

컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램 개발 시에만 필요)

3) 네트워크

TCP/IP 네트워크



Tmax 서버에 서비스 요청하기 전에 Tmax 환경변수(예:autoexec.bat) 적용 또는 환경

파일(예:tmax.env)의 설정 필요

Tmax 환경변수 예

TMAX_HOST_ADDR(Tmax 서버의 IP 주소)

TMAX_HOST_PORT(Tmax 서버의 포트번호)


FDLFILE(Fieldkey buffer type 사용 시에만 필요)

SDLFILE(Structure buffer type 사용 시에만 필요)