Download - Tmax€¦ · Web viewHP UX v10.20 on HP9000 Series 98 3.3.4 HP-UX v11.00 on HP9000 Series 99 3.3.5 HP-UX v11.11 on HP9000 Series 100 3.3.6 HP-UX v11i on Itanium 101 3.3.7 IBM AIX

Tmax Installation Guide

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

Copyright NoticeCopyright©2000 Tmax Soft Co., Ltd. All Rights Reserved.Tmax Soft Co., Ltd.대한민국 서울시 강남구 대치동 946-1 글라스타워 18 층 우)135-708

Restricted Rights LegendThis 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.소프트웨어 및 문서는 오직 TmaxSoft Co., Ltd.와의 사용권 계약 하에서만 이용이 가능하며, 사용권 계약에 따라서 사용하거나 복사 할 수 있습니다. 또한 이 매뉴얼에서 언급하지 않은 정보에 대해서는 보증 및 책임을 지지 않습니다.이 매뉴얼에 대한 권리는 저작권에 보호되므로 발행자의 허가 없이 전체 또는 일부를 어떤 형식이나, 사진 녹화, 기록, 정보 저장 및 검색 시스템과 같은 그래픽이나 전자적, 기계적 수단으로 복제하거나 사용할 수 없습니다.

TrademarksTmax, WebtoB, WebT, and JEUS are registered trademarks of Tmax Soft Co., Ltd.All other product names may be trademarks of the respective companies with which they are associated.Tmax, WebtoB, WebT, JEUS 는 TmaxSoft Co., Ltd.의 등록 상표입니다.기타 모든 제품들과 회사 이름은 각각 해당 소유주의 상표로서 참조용으로만 사용됩니다.


Document Edition Date Version

TMIG-0909-05-314 Sep 9, 2004 Tmax 3.14

About This Guide

본 지침서는 미들웨어를 적용한 3-tier 시스템 환경으로 전환하기 위한

첫번째 작업으로써, Tmax 와 WebT 를 설치하고 테스트 하는 방법에

대해 기술하고 있다.

Tmax Installation Guide 1

Chapter 1

설치를 위해 사전에 필요한 시스템 사양에 대해 설명한다. 또한 UNIX

또는 윈도우즈 플랫폼에서 Tmax 를 설치하고, 환경을 설정해서 실제

샘플 프로그램을 통해 제품이 제대로 설치가 되었는지를 검증하는

방법에 대해 설명한다.

Chapter 2

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

다룬다.

Chapter 3

트랜잭션 관리 프로세스인 TMS 이진파일 생성 및 Apache Web

Server 및 Apache JServ 를 설치하는 방법, 그리고 하드웨어 및

소프트웨어 요구사항에 대해서 설명한다.

관련서Getting Started GuideTmax Administration GuideTmax Reference GuideTmax C Programing GuideTmax WebT Programming Guide

Tmax Installation Guide2

차 례

1 Tmax 설치....................................................................................5

1.1 Tmax를 설치하기 전에...........................................................................................5

1.2 Tmax 정식 패키지 구성..........................................................................................5

1.3 CD-ROM의 디렉토리 구성......................................................................................6

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

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

1.6 Tmax 인스톨러에 대하여........................................................................................8

1.7 Tmax 시스템의 설치(Unix).....................................................................................9

1.7.1 콘솔 인스톨러..................................................................................................91.7.2 Tmax Server/Client 설치..................................................................................91.7.3 Tmax Client 설치...........................................................................................161.7.4 환경 설정.......................................................................................................191.7.5 예제 프로그램 테스트.....................................................................................24

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

1.8.1 GUI 인스톨러.................................................................................................291.8.2 Tmax Server/Client 설치................................................................................291.8.3 Tmax Client 설치...........................................................................................411.8.4 환경 설정.......................................................................................................49

2 WebT 설치.................................................................................57

2.1 WebT 를 설치하기 전에........................................................................................58

2.1.1 WebT 소프트웨어 배포..................................................................................582.1.2 WebT의 사용 환경.........................................................................................58

2.2 WebT의 설치(UNIX 플랫폼)..................................................................................59

2.2.1 WebT 설치.....................................................................................................592.2.2 환경 설정.......................................................................................................63

2.3 WebT 설치(Windows NT/2000 플랫폼)................................................................64

2.3.1 WebT Client 설치...........................................................................................64


2.3.2 환경 설정.......................................................................................................642.3.3 라이센스 파일 설치........................................................................................67

2.4 WebT 테스트........................................................................................................68

2.5 WebtoB/JEUS 환경..............................................................................................69

2.5.1 WebT의 연동.................................................................................................692.5.2 WebT와 Tmax 연동 테스트............................................................................70

2.6 Apache/Apache JServ 환경................................................................................82

2.6.1 WebT 연동 테스트.........................................................................................822.6.2 WebT와 Tmax 연동 테스트............................................................................83

3 부록............................................................................................86

3.1 TMS 컴파일...........................................................................................................87

3.1.1 TMS for Oracle DBMS...................................................................................873.1.2 TMS for Infomix DBMS..................................................................................89

3.2 Apache Web Server 및 Apache JServ 설치.......................................................91

3.2.1 JDK 1.2.2 설치...............................................................................................923.2.2 JSDK 2.0의 설치............................................................................................933.2.3 아파치 / 아파치 JServ의 설치........................................................................93

3.3 Platform Specifications for Tmax Products......................................................97

3.3.1 Compaq Tru64 v4.0 on Alpha........................................................................973.3.2 Compaq Tru64 v5.0(5.1) on Alpha.................................................................983.3.3 HP UX v10.20 on HP9000 Series..................................................................983.3.4 HP-UX v11.00 on HP9000 Series..................................................................993.3.5 HP-UX v11.11 on HP9000 Series................................................................1003.3.6 HP-UX v11i on Itanium.................................................................................1013.3.7 IBM AIX v4.3.x on RS/6000.........................................................................1013.3.8 IBM AIX v5.1.x on RS/6000.........................................................................1023.3.9 SUN Solaris v2.5.1(SunOS 5.5.1) on SPARC..............................................1033.3.10 SUN Solaris v2.6(SunOS 5.6) on UltraSPARC............................................1043.3.11 SUN Solaris v2.7(SunOS 5.7) on UltraSPARC............................................1043.3.12 SUN Solaris v2.8(SunOS 5.8) on UltraSPARC............................................1053.3.13 SUN Solaris 8 on x86...................................................................................1063.3.14 SCO Unixware 7 on x86..............................................................................1073.3.15 SCO Unixware 2 on x86..............................................................................1073.3.16 NCR MP-RAS v03.02 on x86.......................................................................1083.3.17 RedHat Linux 7.x on Intel.............................................................................1093.3.18 Windows NT 4.0 on Intel..............................................................................1103.3.19 Windows NT 5.0(Windows 2000) on Intel....................................................1103.3.20 Windows 98 on Intel.....................................................................................111


1 Tmax 설치

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

사용할 수 있게 하기 위해 Tmax Server 와 Tmax Client 를 설치하고

테스트하는 방법에 대해 설명한다.

Tmax 를 설치하기 전에

Tmax 시스템의 설치(UNIX)

Tmax 시스템의 설치(Windows)

1.1 Tmax 를 설치하기 전에

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

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

Tmax 정식 패키지 구성

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

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

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

Tmax 인스톨러에 대하여


1.2 Tmax 정식 패키지 구성

Tmax Installation CD-ROM

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

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

platform

3. Tmax Documents

Printed Tmax Manuals

1. Tmax Product Overview

2. Tmax Installation Guide

3. Tmax Getting Started Guide

4. Tmax C Programming Guide

5. Tmax Administration Guide

6. Tmax Reference Manual

7. Tmax FDL Reference Manual

8. Tmax WebT Programming Guide

9. Tmax Error Message Reference Manual

10. Tmax UCS Programming Guide

11. Tmax Cagent Programming Guide

12. Tmax Hostlink Programming Guide

13. Tmax RCA Programming Guide

14. Tmax RQ Programming Guide

15. Tmax Release Notes

Tmax product License and Warranty


1.3 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.4 평가판 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.5 하드웨어 및 소프트웨어 요구사항

Vendor Operating System Engine VersionTmax/WebTVersion

Compaq Tru64 UNIX 64 bit 4.0, 5.0, 5.1 3.8/1.6GNU/Redhat Linux on Intel Kernel Version 2.X

(RedHat 6.X or higher) 3.8/1.6


http://forum.tmax.co.kr/

mailto:[email protected]

mailto:[email protected]


HP HP-UX 32 bit 10.20, 11.0, 10.30 3.8/1.6

64 bit 11.0

IBM AIX 32 bit 4.3, 5L 3.8/1.664 bit 4.3, 5L

Sun Solaris on SPARC 32 bit 2.5.1 ~ 2.8, x86 3.8/1.6

64 bit 2.7, 2.8

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.6 Tmax 인스톨러에 대하여

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

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

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

다음과 같다.

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

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


1.7 Tmax 시스템의 설치(Unix)

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

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

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

콘솔 인스톨러

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

Tmax 클라이언트의 설치

환경 설정 및 테스트

1.7.1 콘솔 인스톨러

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

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

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

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

않는다.

1.7.2 Tmax Server/Client 설치

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

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

Tmax Client 설치” 를 참조한다.


1.7.2.1 설치 전 준비사항.

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

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

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

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

마운트 방법은 “부록 3. Platform Specifications for Tmax Products ”

를 참조한다.

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

확인해야 할 사항이 있다. 서버에 설치된 운영체제와 아키텍처

(32bit or 64bit), Tmax 를 설치하고자 하는 디렉토리의 절대 경로,

그리고 설치 후 테스트를 위해 서버의 IP 주소를 미리 알고 있어야

한다.

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

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

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

sh install.sh


1.7.2.2 설치과정

다음은 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/Client2. Tmax Client3. WebT for Tmax4. 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/tmaxInput -> /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... OKTmax 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.krE-mail : [email protected]======================================================

설치된 Tmax 시스템의 디렉토리 구조.는 다음과 같다.


그림 1 설치된 Tmax 시스템의 디렉토리 구조


Tmax Root directory

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

2. bin : Tmax 명령과 유틸리티

3. config : Tmax 시스템 환경파일

4. lib : Tmax 라이브러리

5. license : 라이센스 파일

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

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

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

9. svct : 응용 서버프로그램 컴파일 시 필요한 서비스

테이블 파일

10. usrinc : Tmax 헤더 파일 Tmax Sample directory

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

2. server : 서버 샘플 프로그램

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


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

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

Definition Language) 형식의 필드들을 정의하는 파일이다 . 사용자는 실제 프로젝트에서 사용할 FDL 및 SDL 형식 필드들을 필요에 따라 직접 만들어서 사용할 수 있다. 여기에 대한 자세한 사항은 Tmax C Programming Guide 나 Tmax Reference Manual 을 참조한다.

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

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

1.7.3 Tmax Client 설치

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

시작하는데 성공하였다면 실제로 서비스가 수행되는지 다양한

플랫폼에서 확인해 볼 필요가 있다. 사용자는 원하는 곳에 클라이언트를

깔고 클라이언트 프로그램을 개발하여 서비스를 사용할 수 있다. Tmax

클라이언트 모듈은 라이센스를 필요로 하지 않으며 홈페이지를 통해

자유롭게 받아서 사용할 수 있다.

1.7.3.1 설치 전 준비사항.

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

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

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


마운트 방법은 “부록 3. Platform Specifications for Tmax Products ”

를 참조한다.

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

확인해야 할 사항이 있다. 서버에 설치된 운영체제와 아키텍처

(32bit or 64bit), Tmax 를 설치하고자 하는 디렉토리의 절대경로,

그리고 설치 후 테스트를 위해 서버의 IP 주소를 미리 알고 있어야

한다.

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

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

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

sh install.sh

1.7.3.2 설치과정

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

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

달라질수 있다.

-----------------------------------------------------------------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. Answer to the questions please.




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/tmaxInput -> /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... OKsun32sample.tar is copied successfully... OK

Extracting Tmax client library....x bin, 0 bytes, 0 tape blocksx 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.


Thank you for using Tmax Product!

Technical support center

Homepage: http://www.tmax.co.krE-mail : [email protected]======================================================


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


Tmax Root Directory

1. bin : 유틸리티(fdlc, sdlc)

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


4. usrinc : Tmax 헤더 파일 Sample Directory







1.7.4 환경 설정

1.7.4.1 라이센스 파일 설치

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: tmaxs1HOST NAME2: tmaxs1HOSTID: 80FD0534H/W SERIAL: 2164065588NCPUS: 2UNAME: SunOS tmaxs1 5.7 Generic_106541-11 sun4u sparc SUNW,Ultra-80

㈜Tmax Soft 는 정식으로 Tmax 제품군을 미리 사용해 볼 수 있도록 평가

라이센스를 제공하며 평가판은 기능상의 제한은 두지 않고 사용기간만을

제한하고 있다. 평가 기간은 최장 6 개월까지 연장할 수 있다.

자세한 문의 사항은 “I. 1.3 평가판 Tmax 소프트웨어의 배포” 부분에서

언급된 연락처를 참고한다.

1.7.4.2 환경 설정

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

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


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

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

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

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

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

마다 다를 수 있다.

######## Tmax Environment ########TMAXDIR=/home/tmax; export TMAXDIRPATH=/home/tmax/bin:$PATH:.; export PATHTMAX_HOST_ADDR=192.168.0.1; export TMAX_HOST_ADDRTMAX_HOST_PORT=8888; export TMAX_HOST_PORTSDLFILE=$TMAXDIR/sample/sdl/tmax.sdl; export SDLFILEFDLFILE=$TMAXDIR/sample/fdl/tmax.fdl; export FDLFILETMAX_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 명령으로 환경변수가 잘 적용 되었는지 확인한다.


1.7.4.3 sample.m 파일의 구성

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

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

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

*DOMAINtmax1 SHMKEY =79990, MINCLH=1, MAXCLH=3,TPORTNO=8888, BLOCKTIME=30

*NODEtmaxs2 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"

*SVRGROUPsvg1 NODENAME = tmaxs2

*SERVERsvr1 SVGNAME = svg1, MIN=1

*SERVICESDLTOUPPER SVRNAME = svr1SDLTOLOWER SVRNAME = svr1

1.7.5 예제 프로그램 테스트

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

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

테스트 환경

1. 운영 체제: SunOS 5.7 32bit 버전


2. 쉘: korn shell

3. $TMAXDIR=/user/tmax

프로그램1. sample.m : Tmax 환경 설정 파일($TMAXDIR/config)

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

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

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

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

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

1.7.5.1 기본 환경 설정

$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 generatedGST 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

1.7.5.2 서버 프로그램 컴파일

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

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

$>./compile sdl svr1


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

cc -O -I/user/tmax -c svr1.ccc -O -I/user/tmax -L/user/tmax/lib -o svr1 svr1.o demo_sdl.o svr1_svctab.o -lsvr -lnsl –lsocket -lnodbmv svr1 /user/tmax/appbin

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

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

내용은 Tmax Administraion Guide 를 참조한다.

1.7.5.3 Tmax 시스템의 기동

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

를 기동 시킨다.

$>tmboot

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

TMBOOT for node(<nodename>) is starting:TMBOOT: TMM is starting: Thu Apr 12 23:05:51 2001TMBOOT: CLL is starting: Thu Apr 12 23:05:51 2001TMBOOT: CLH is starting: Thu Apr 12 23:05:51 2001(I) CLH Current Tmax Configuration:Number of client handler(MINCLH) = 1Supported maximum user per node = 200Supported maximum user per handler = 201TMBOOT: SVR(svr1) is starting: Thu Apr 12 23:05:51 2001<nodename>, <Supported maximum user per node>, <Supported maximu m

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

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

Tmax 시스템 환경파일(xxxx.m)에서 지정된 TPORTNO,

TPORTNO+1 을 이미 시스템에서 사용중인 경우


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

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

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

컴파일되지 않은 경우

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

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

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

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

컴파일한다.

$>./compile c sdltoupper

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

cc -O -I/user/tmax -c sdltoupper.ccc -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.csvr1.c compile sdl svr1 구조체 버퍼

toupper.c

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

fdltoupper.c

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

sdl_main.c sdltest.pc compile psdl sdltest

구조체 버퍼

오라클 연동

fdl_main.c fdltest.pc compile pc fdltest

필드키 버퍼

오라클 연동


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

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

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

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

GUI 인스톨러

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

Tmax 클라이언트의 설치

환경 설정 및 테스트

1.8.1 GUI 인스톨러

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

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

하지 않는다.

1.8.2 Tmax Server/Client 설치

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

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

Client 설치” 를 참조한다.


1.8.2.1 설치 전 준비사항

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

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

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

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

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

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

1.8.2.2 설치과정

다음은　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 만을 지원한다.

상기 의

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

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

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

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


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

44

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

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

재부팅 하도록 한다.

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

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


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


Tmax Root directory

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

2. bin : Tmax 명령과 유틸리티

3. config : Tmax 시스템 환경파일


4. lib : Tmax 라이브러리

5. license : 라이센스 파일

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

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


9. svct : 응용 서버프로그램 컴파일 시 필요한 서비스

테이블 파일

10. usrinc : Tmax 헤더 파일 Tmax Sample directory


2. server : 서버 샘플 프로그램



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

Definition Language) 형식의 필드들을 정의하는 파일이다 . 사용자는 실제 프로젝트에서 사용할 FDL 및 SDL 형식 필드들을 필요에 따라 직접 만들어서 사용할 수 있다. 여기에 대한 자세한 사항은 Tmax C Programming Guide 나 Tmax

Reference Manual 을 참조한다.




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

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

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

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 의

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


그림 4 등록된 Tmax Loader


그림 5 등록된 RACD LOADER

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

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

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

C:\svcinstallC:\racdinstall

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

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

C:\svcremoveC:\racdremove


1.8.3 Tmax Client 설치

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

시작하는데 성공하였다면 실제로 서비스가 수행되는지 다양한

플랫폼에서 확인해 볼 필요가 있다. 사용자는 원하는 곳에 클라이언트를

깔고 클라이언트 프로그램을 개발하여 서비스를 사용할 수 있다. Tmax

클라이언트 모듈은 라이센스를 필요로 하지 않으며 홈페이지를 통해

자유롭게 받아서 사용할 수 있다.

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

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

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

재부팅 해야 한다.

1.8.3.1 설치 전 준비사항

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

계정을 만든다.

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

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

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


1.8.3.2 설치과정

다음은　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

클라이언트의 인스톨이 완료된다.


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


Tmax Root Directory

1. bin : 유틸리티(fdlc, sdlc)

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


4. usrinc : Tmax 헤더 파일 Sample Directory







1.8.4 환경 설정

1.8.4.1 라이센스 파일 설치

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 을 참고한다.

㈜Tmax Soft 제품군에 대한 라이센스는 24 시간 이내에 발급함을 원칙으로

하고 있다.

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

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

라이센스를 제공하고 있다. 평가판 라이센스에서는 기능상의 제한은 두지

않고, 사용기간 제한을 두어 배포하고 있다.

자세한 문의 사항은 “I. 1.3 평가판 Tmax 소프트웨어의 배포” 부분에서

언급한 연락처를 참고한다.

1.8.4.2 Tmax 시스템을 운용하기 전에

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

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

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


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

ADDR, TMAX_HOST_PORT, TMAX_WIN_PORT, SDLFILE, FDLFILE,

PATH 이다.

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

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

확인한다. 만약 환경변수가 반영이 되어 있지 않았다면 시스템을 재부팅

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

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

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

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

프로그램은 Tmax 시스템이 설치된 폴더의 하위 디렉토리인 TMAXDIR\

sample 내에 있다.

1.8.4.3 기본 환경 설정

우선 샘플 프로그램을 동작하기 위한 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 환경파일이 형식에 맞도록 올바르게 작성되었는지 확인하는

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

컴파일 명령이다.

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

컴파일이 성공하면 ‘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 myprojC:\tmax\config> tmdown –f myproj

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

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

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

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

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

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

C:\tmax\config> gst

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

1.8.4.4 서비스 프로그램 컴파일

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

컴파일한다. 물론 컴파일을 하려면 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 시스템 기동에

대해 설명하도록 하겠다.

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

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

사용자의 요청을 입력받아 해당하는 서비스를 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

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


2 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” 를 참조한다.


2.1 WebT 를 설치하기 전에

2.1.1 WebT 소프트웨어 배포

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

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

2.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.2 WebT 의 설치(UNIX 플랫폼)

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

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

언어를 이용하여 개발한 웹서버인 Webtob 는 Tmax 와 엔진 레벨의 연동을

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

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

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

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

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

2.2.1 WebT 설치

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

2.2.1.1 설치 전 준비사항.

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

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

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

한다.

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

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


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

sh install.sh

2.2.1.2 설치과정

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

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

-----------------------------------------------------------------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. Answer to the following questions.



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/webtInput -> /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 addpath 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.Thank you for using Tmax Product!

Technical Support CenterHomepage: http://www.tmax.co.krE-mail : [email protected]

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

2.2.1.3 설치된 WebT 의 디렉토리 구조

그림 7 설치된 WebT 의 디렉토리 구조


WebT Directory

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

2. demo : Tmax 연 동 데 모 프 로 그 램 (Apache+ApacheJServ

용과 WebtoB+JEUS 용)

3. lib : WebT Class Library

4. test : HelloWebtServlet.java


2.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 PATHCLASSPATH=$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


2.3 WebT 설치(Windows NT/2000 플랫폼)

이 절에서는 Windows NT Server/2000 환경에 WebT 를 설치하는 방법에

대해 설명한다. Windows NT 환경에 WebT 를 설치하기 위해 인스톨러를

별도로 제공하지는 않는다.

2.3.1 WebT Client 설치

다음은 WebT 를 설치하는 과정이다.

CD-ROM 의 WebT\windows 폴더로 이동한다.

webt-1.6.8.exe 를 실행한다.

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

명령으로 확인한다.


그림 8 환경변수 등록 확인


2.3.3 라이센스 파일 설치

WebT 가 미들웨어 Tmax 와 연동될 수 있도록 개발되었기 때문에 WebT 를

사용하기 위한 별도의 라이센스는 없고 Tmax 라이센스 파일 내에

포함되어 있다. 기존에 Tmax 를 사용하던 시스템에서 WebT 를 사용하고자

한다면 WebT 기능을 사용할 수 있는 새로운 라이센스 파일을 받아야 한다.

Tmax 시스템이 설치된 디렉토리의 license 디렉토리에 license.dat 파일을

복사하면 라이센스 파일의 설치는 완료된다. 라이센스의 설치에 관한

내용은 “I. 2.3 환경 설정 및 테스트” 에 자세히 설명되어 있다.


2.4 WebT 테스트

WebT 가 제대로 인스톨되어 잘 작동하는지 확인할 차례이다. WebT

샘플중 HelloWebtServlet.java 와 Tmax 와의 연동 테스트를 위한

BufTypeDemo. java 파일을 가지고 테스트를 진행할 것이다.

다음은 테스트를 위해 설치된 각 플랫폼별/제품별 디렉토리들을 보여준다. 아래 표에 나타난 Tmax 항목에는 Tmax 가 설치된 서버의 IP 의 주소를 기록해 놓았다.

참고로 WebtoB 와 Apache Web Server 가 설치된 장비의 IP 주소는 192.168.0.1

이라고 가정한다.

WebtoB JEUS WebT TmaxUNIX/Linux /usr/local/webtob /usr/local/Jeus /usr/local/webt 192.168.1.1Windows NT

c:\webtob c:\Jeus c:\webt 192.168.1.1

표. WebtoB/JEUS 테스트 환경

Apache ApacheJServ WebT TmaxUNIX/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 환경에서만 테스트 하기로 한다.


2.5 WebtoB/JEUS 환경

2.5.1 WebT 의 연동

WebT 를 사용하기 위해서 webt.jar 클래스 라이브러리를 JEUS 의 특정

디렉토리에 위치시켜야 한다. 다음과 같이 webt.jar 를 /usr/local/Jeus/lib/a

pplication 으로 복사한다. 윈도우즈 서버의 경우에도 똑같이 적용하면 된다.

UNIX / Linux 의 경우1. /usr/local/webt/lib/webt.jar 를 /usr/local/jeus/lib/application 에 복사

Windows NT 의 경우1. 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

에서는 명령 프롬프트 창을 열어 실행한다.

jeusjeusadmin 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

2.5.2 WebT 와 Tmax 연동 테스트

WebtoB 와 JEUS 환경에서 WebT 와 Tmax 를 연동하는 방법에 대해서

간단한 데모 프로그램을 통해 알아본다.

테스트 환경

1. 운영 체제: Sun OS 5.7 32bit 버전

2. 쉘: Korn shell

3. TMAXDIR=/user/tmax

[Tmax 서버 프로그램]

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

2. demo1.c : 서버 프로그램($TMAXDIR/sample/webt)

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


http://192.168.0.1/webtdemo/HelloWebtServlet

WebT Demo

1. /usr/local/webt/demo/for_WebtoB/webtdemo/WEB-INF/classes/webtdemo

2. BufType.java : 서비스와 버퍼타입을 선택하여 문자열을

Tmax 서버쪽으로 보내고 응답받는 프로그램

3. WebCount.java : 웹페이지 카운트 프로그램

4. demo.f : 필드키 정의 파일

[HTML Files]

1. 데모 프로그램을 위한 html 파일들(/usr/local/webt/html/webt)

2.5.2.1 기본 환경 설정

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

2.5.2.2 서비스 프로그램 컴파일

TMAXDIR/sample/webt/server 디렉토리로 이동하여 서비스 프로그램을

컴파일한다.

$>./compile c demo1


cc -O -I/user/tmax -c demo1.ccc -O -I/user/tmax -L/user/tmax/lib -o demo1 demo1.o demo_sdl.o demo1_svctab.o -lsvr -lnsl -lsocketmv demo1 /user/tmax/appbin/.

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

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

내용은 Tmax Administraion Guide 를 참조한다.


2.5.2.3 Tmax 기동

Tmax 를 기동 시킨다.

$>tmboot

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

TMBOOT for node(nodename) is starting:TMBOOT: TMM is starting: Thu Apr 12 23:05:51 2001TMBOOT: CLL is starting: Thu Apr 12 23:05:51 2001TMBOOT: CLH is starting: Thu Apr 12 23:05:51 2001(I) CLH Current Tmax Configuration:Number of client handler(MINCLH) = 1Supported maximum user per node = 200Supported maximum user per handler = 201TMBOOT: SVR(demo1) is starting: Thu Apr 12 23:05:51 2001TMBOOT: SVR(webcount) is starting: Thu Apr 12 23:05:51 2001nodename, 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 에 설명되어 있다.


2.5.2.5 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

*DOMAINtmax1 SHMKEY =79990, MINCLH=1, MAXCLH=3,TPORTNO=8888, BLOCKTIME=30

*NODEnodename 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"

*SVRGROUPsvg1 NODENAME = "nodename"

*SERVERdemo1 SVGNAME=svg1, MIN=1webcount SVGNAME=svg1, MIN=1

*SERVICETOUPPER_FDL SVRNAME=demo1TOUPPER_STRING SVRNAME=demo1TOUPPER_CARRAY SVRNAME=demo1WEBCNT SVRNAME=webcount


<UNIX 용 WebtoB 설정파일>

/usr/local/webtob/config/http.m*DOMAINwebtob1

*NODEtest 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

*SVRGROUPhtmlsvg NODENAME = test, SvrType = HTMLjsvg NODENAME = test, SVRTYPE = JSV

*SERVERhtml SVGNAME = htmlsvg, MinProc = 2, MaxProc = 10MyGroup SVGNAME = jsvg, MinProc = 10, MAXProc = 20

*URIuri1 Uri = "/examples/", Svrtype = JSVuri2 Uri = "/webtdemo/", Svrtype = JSV

*ALIASalias1 URI = "/icons/", REalPath = "/usr/local/webtob/icons"

*EXThtm MimeType = "text/html", SvrType = HTML

*LOGGINGlog1 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*DOMAINwebtob1

*NODEtest 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




*ALIASalias1 URI = "/icons/", REalPath = "/usr/local/webtob/icons"


*LOGGINGlog1 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*DOMAINwebtob1

*NODEtest WEBTOBDIR="c:\\WebtoB", HTH = 2, SHMKEY = 54000,

DOCROOT="c:\\WebtoB\\docs", HTTPPORT = 80,KEEPAliveTimeout = 15, JSVPORT = 9900,Logging = "log1", Errorlog = "log2", CacheEntry = 0




*ALIASalias1 URI = "/icons/", REalPath = "c:\\WebtoB\\icons\\"


*LOGGINGlog1 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>

. . . 이하 생략. . .


2.6 Apache/Apache JServ 환경

이 절에서는 Apache 와 Apache JServ 환경에서 WebT 를 테스트 하는

방법에 대해 설명한다. Apache 와 Apache JServ 를 설치하는 방법은 이

지침서의 “부록 2. Apache Web Server 및 Apache JServ 설치” 에 설명되어 있다.

2.6.1 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

2.6.2 WebT 와 Tmax 연동 테스트

Apache 와 Apache JServ 환경에서 WebT 와 Tmax 를 연동하는 방법에

대해서 간단한 테스트를 통해 알아본다.

테스트 환경

1. 운영 체제: Sun OS 5.7 32bit 버전

2. 쉘: Korn shell

3. 제품이 설치된 시스템의 환경은 2.5 WebT 테스트에 이미

언급되어 있으므로 참고한다.

Tmax 서버 샘플 프로그램


http://192.168.0.1/examples/HelloWebtServlet

1. Tmax 서버측 환경은 2.5.1 WebtoB/JEUS 환경에서 테스트의

환경과 동일하다.

WebT 클라이언트 샘플 프로그램

1. /usr/local/webt/demo/for_Apache/webtdemo

2. BufType.java, WebCount.java : 클라이언트 프로그램

HTML Files

1. 데모 프로그램을 위한 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 에 설명되어 있다.

2.6.2.2 아파치 웹서버 / 아파치 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 를 참조하도록 한다.


3 부록

TMS 컴파일

Apache Web Server 및 Apache JServ 설치 Platform Specifications for Tmax Products


3.1 TMS 컴파일

TMS(Transaction Management Server) 는 Tmax 시 스 템 의 구 성 요 소 로 써 데 이 터 베 이 스 관 리 및 분 산 트 랜 잭 션 처 리 를 담 당 하 는 프 로 세 스 이 다 .

이곳에서는 Oracle 과 Informix DBMS 용 TMS 이진 파일의 생성 방법에 관하여 알아본다.

윈도우즈 환경에서는 TMS 를 만드는 과정이 필요하지 않으며 현재 Oracle

만을 지원한다.

TMS for Oracle DBMS

TMS for Infomix DBMS

3.1.1 TMS for Oracle DBMS

Tmax 에서 제공하는 tms_ora.mk 파일을 컴파일 해서 Oracle 용 TMS 이진

파일을 만들 수 있다. tms_ora.mk 는 TMAXDIR/sample/server 디렉토리에

있으며, 다음과 같이 컴파일 할 수 있다.

TMAXDIR 은 Tmax 가 설치된 디렉토리를 나타낸다.

Step 1. Tmax 사용자 계정으로 로그인 한다.

$su – tmax

Step 2. Oracle 환경변수 들을 가져와 쉘 환경파일에 붙여 넣고

적용시킨다. 다음은 Oracle 환경변수의 예이다.

## Oracle Environment ##ORACLE_HOME=/oracle/app/oracle/product/8.0.5; export ORACLE_HOMEPATH=$PATH:$ORACLE_HOME/bin; export PATH


ORACLE_SID=ora805; export ORACLE_SIDNLS_LANG=American_America.KO16KSC5601; export NLS_LANGORA_NLS33=$ORACLE_HOME/ocommon/nls/admin/data; export ORA_NLS33LD_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 을 참고한다.


3.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}/libINFOELIBDIR = ${INFORMIXDIR}/esqlINFOLIBD = ${INFORMIXDIR}/lib/esqlINFOLIBS = -lifsql -lifasf -lifgen -lifos -lifgls -lnsl -lsocket -laio -lm -ldl -lelf /user3/informix/lib/esql/checkapi.o -lifglx -lifxa

TMAXLIBDIR = $(TMAXDIR)/libTMAXLIBS = -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 을 참고한다.


3.2 Apache Web Server 및 Apache JServ 설치

WebT 를 설치하고 사용하기 위해서는 웹서버와 여러가지 관련

프로그램이 미리 설치되어야 한다. 이곳에서는 전세계에서 가장 많이

사용하는 아파치 웹서버와 Java 응용 클라이언트 프로그램을 개발하기

위한 아파치 JServ 의 설치에 관해 알아보도록 한다. Java 환경을 지원하는

다른 웹서버에서도 WebT 의 사용이 가능하다. 여기서 설명되는 패키지

외의 웹서버 또는 Java 개발 환경에 대한 설치는 다루지 않기 때문에 관련

매뉴얼을 참조한다.

필요한 소프트웨어 목록

1. Java Development Kit (JDK 1.1 이상)

2. Java Servlet Development Kit (JSDK 2.0)

3. Apache JServ (ApacheJServ 1.1 이상)

4. Apache Web Server : apache-1.3.x (2.0 이상에서는 테스트 되어 있지 않음)

위의 목록에서 언급한 범위 내의 소프트웨어를 가지고 있다면 별 문제

없이 설치를 할 수 있을 것이다. JDK 의 경우 각 하드웨어 벤더들이

제공하는 패키지를 이용하면 된다. 솔라리스, 리눅스, 윈도우용 JDK 는

http://www.jav asoft.com 에 가면 구할 수 있다.


http://www.javasoft.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 ) 에서 구할 수 있으며,

소스 형태로 받을 경우, 컴파일 작업이 필요하다.


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

3.2.1 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

3.2.2 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 PATHCLASSPATH=$CLASSPATH:/usr/JSDK2.0/lib/jsdk.jar; export CLASSPATH

위와 같이 환경변수를 설정한 후, 적용시켜 준다.

$. ./.profile

적용시킨 후에는 다음과 같이 env 명령으로 CLASSPATH 를 확인해 본다.

$env | grep CLASSPATH

3.2.3 아파치 / 아파치 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 을 수행한다.


ftp://ftp.gnu.org/

$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


http://192.168.0.1/index.html.en

그림 9 Apache Web Server 의 테스트 페이지

Apache JServ 가 제대로 동작하는지 확인하기 위해 다음과 같은 URL

주소를 브라우저 창에 입력한다.

http://192.168.0.1/servlet/IsItWorking


http://192.168.0.1/servlet/IsItWorking

3.3 Platform Specifications for Tmax Products

응용프로그램 및 시스템 또는 유저 로깅 정보에 따라 더 많은 디스크

공간이 필요할 수 있다.

컴파일러는 Tmax 응용프로그램 개발 시에만 필요하다.

3.3.1 Compaq Tru64 v4.0 on Alpha

하드웨어 요구사항

플랫폼 : Compaq Alpha

메모리 : 128MBytes 이상(256 Mbytes 이상 권장)

디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)

소프트웨어 요구사항

운영체제 : Tru64 4.0

컴파일러 : Compaq ANSI C compiler

네트워크

TCP/IP 네트워크

설치된 제품의 디스크 사용공간

Tmax Server and Client : 6391 Kbyte


Tmax Client : 951 Kbyte

CD-ROM 마운트 방법

수퍼유저 권한으로 CD-ROM 을 마운트할 디렉토리가 없으면

새로운 디렉토리 생성

$mkdir /cdrom$/sbin/mount -r -t cdfs /dev/devicename /cdrom

3.3.2 Compaq Tru64 v5.0(5.1) on Alpha


플랫폼 : Compaq Alpha




운영체제 : Tru64 5.0

컴파일러 : Compaq ANSI C compiler

네트워크

TCP/IP 네트워크






$mkdir /cdrom$/usr/sbin/mount -r -t cdfs /dev/cdrom_devicename /cdrom

3.3.3 HP UX v10.20 on HP9000 Series

하드웨어 요구사항]

플랫폼 : HP PA-RISC




운영체제 : HP-UX 10.20

컴파일러 : HP-UX ANSI C Compiler

네트워크

TCP/IP 네트워크





$su -$mkdir /cdrom$mount -F cdfs -o cdcase /dev/dsk/cdrom_devicename /cdrom


3.3.4 HP-UX v11.00 on HP9000 Series






운영체제 : HP-UX 11.0(64bit 아키텍쳐 지원)


네트워크

TCP/IP 네트워크


Tmax Server and Client(32bit) : 5078 Kbyte

Tmax Client(32bit) : 700 Kbyte






3.3.5 HP-UX v11.11 on HP9000 Series






운영체제 : HP-UX 11.11(64bit 아키텍쳐 지원)


네트워크

TCP/IP 네트워크









3.3.6 HP-UX v11i on Itanium


플랫폼 : HP Intel Itanium-based servers




운영체제 : HP-UX 11i (64bit 아키텍쳐 지원)

컴파일러 : HP ANSI C compiler

네트워크

TCP/IP 네트워크









3.3.7 IBM AIX v4.3.x on RS/6000


플랫폼 : IBM PowerPC




운영체제 : AIX v4.3.x(64bit 아키텍쳐 지원)

컴파일러 : AIX XL C Compiler

네트워크

TCP/IP 네트워크







smit 또는 smitty 유틸리티를 이용해서 CD-ROM 장치를 마운트

시킨다.


$smitty mount

3.3.8 IBM AIX v5.1.x on RS/6000


플랫폼 : IBM PowerPC




운영체제 : AIX v5.1.x(64bit 아키텍쳐 지원)

컴파일러 : AIX XL C Compiler

네트워크

TCP/IP 네트워크








smit 또는 smitty 유틸리티를 이용해서 CD-ROM 장치를 마운트

시킨다.

$smitty mount

3.3.9 SUN Solaris v2.5.1(SunOS 5.5.1) on SPARC


플랫폼 : SUN UltraSPARC




운영체제 : SunOS 5.5.1

컴파일러 : SparCompiler C 4.0 또는 그 이상

네트워크

TCP/IP 네트워크






별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로

마운트 가능

3.3.10 SUN Solaris v2.6(SunOS 5.6) on UltraSPARC






운영체제 : SunOS 5.6


네트워크

TCP/IP 네트워크






/cdrom 에 마운트








운영체제 : SunOS 5.7(64bit 아키텍쳐 지원)


네트워크

TCP/IP 네트워크
















운영체제 : SunOS 5.8(64bit 아키텍쳐 지원)


네트워크

TCP/IP 네트워크










3.3.13 SUN Solaris 8 on x86


플랫폼 : Intel x86-based servers




운영체제 : Solaris 8

컴파일러 : SUN ANSI C compiler

네트워크

TCP/IP 네트워크










3.3.14 SCO Unixware 7 on x86






운영체제 : Unixware 7.1

컴파일러 : Unixware ANSI C compiler

네트워크

TCP/IP 네트워크







$mount -r -F cdfs /dev/cdrom/cdrom1 /mnt

3.3.15 SCO Unixware 2 on x86







운영체제 : Unixware 2.1

컴파일러 : Unixware ANSI C compiler

네트워크

TCP/IP 네트워크







$mount -r -F cdfs /dev/cdrom/cdrom1 /mnt

3.3.16 NCR MP-RAS v03.02 on x86


플랫폼 : NCR Intel x86-based SMP servers





운영체제 : NCR UNIX SVR4 MP-RAS 03.02

컴파일러 : NCR High Performance C Compiler

네트워크

TCP/IP 네트워크






3.3.17 RedHat Linux 7.x on Intel


플랫폼 : Based on Intel CPU


디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상

권장)



운영체제 : RedHat Linux 계열 또는 기타 배포판(Kernel 2.0

이상)

컴파일러 : (Tmax 응용프로그램 개발 시에만 필요)

네트워크

TCP/IP 네트워크


Tmax Server and Client(32bit) : 3860 kbyte Tmax Client(32bit) : 636 Kbyte


/mnt/cdrom 디렉토리가 없으면, 수퍼유저 권한으로

디렉토리를 생성

$mkdir /mnt/cdrom$mount /mnt/cdrom 또는 mount –rt iso9660 /dev/devicename /mnt/cdrom

알아두어야 할 사항 레드햇 계열에서는 Tmax 제품이 테스트 되었음. RedHat 계열

이외의 배포판에 대해서는 일반적으로 잘 동작 할 것이라

기대되지만, 보장하지는 않음.

3.3.18 Windows NT 4.0 on Intel







컴파일러 : Windows NT 4.0 Server(서비스팩 3.0 이상 필요)

운영체제 : Microsoft Visual C++ 5.0 또는 그 이상

네트워크

TCP/IP 네트워크

알아두어야 할 사항

Tmax Server 또는 Tmax Client 설치 시 재시작 필요3.3.19 Windows NT 5.0(Windows 2000) on Intel

하드웨어 요구사항 플랫폼 : Based on Intel CPU





운영체제 : Windows 2000 Server

컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램

개발 시에만 필요)

네트워크

TCP/IP 네트워크


Tmax Server 설치 시 재시작이 필요하다는 메시지가 나오나

실제로 재시작 필요하지 않음. Windows NT 4.0 Server 상에서만 설치 후 재시작 필요

3.3.20 Windows 98 on Intel



메모리 : 32MBytes 이상

디스크 : 10MBytes 이상의 여유공간


운영체제 : Windows 98 (or Windows Me)

컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램

개발 시에만 필요)


네트워크

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 사용 시에만 필요)


Download - Tmax€¦ · Web viewHP UX v10.20 on HP9000 Series 98 3.3.4 HP-UX v11.00 on HP9000 Series 99 3.3.5 HP-UX v11.11 on HP9000 Series 100 3.3.6 HP-UX v11i on Itanium 101 3.3.7 IBM AIX

Top Related