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.
Tmax Installation Guide 2
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
Tmax Installation Guide 3
-- 차 례 -- 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
Tmax Installation Guide 4
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.8 SUN Solaris v2.7(SunOS 5.7) on UltraSPARC ............................................................................................. 114
3.9 SUN Solaris v2.8(SunOS 5.8) on UltraSPARC ............................................................................................. 115
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 5
Tmax Installation Guide
Tmax Installation Guide 6
I. Tmax 설치
1장 에서는 미들웨어 Tmax를 도입하여 개발환경 또는 운용환경에서 사용
할 수 있게 하기 위해 Tmax Server와 Tmax Client를 설치하고 테스트하
는 방법에 대해 설명한다.
Tmax를 설치하기 전에
Tmax 시스템의 설치(UNIX)
Tmax 시스템의 설치(Windows)
Tmax Installation Guide 7
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 Installation Guide 8
- 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의 디렉토리 구조
Tmax Installation Guide 9
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
Tmax Installation Guide 10
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” 를 참조한다.
Tmax Installation Guide 11
1.5 Tmax 인스톨러에 대하여
Tmax 인스톨러는 두가지 형태로 나뉜다. 인스톨러는 압축된 형식의 Tmax
아카이브를 복사하여 압축을 해제하고 필요한 환경변수를 설정해 주며 플
랫폼 별로 적절한 샘플과 Makefile을 제공한다. 두가지 인스톨러는 다음과
같다.
UNIX/Linux 환경에서 사용하는 콘솔 인스톨러
Windows 환경에서 사용하는 GUI 인스톨러.
Tmax Installation Guide 12
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 설치” 를 참조한다.
Tmax Installation Guide 13
설치 전 준비사항.
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 Installation Guide 14
설치과정
다음은 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)
Tmax Installation Guide 15
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 주소를 입력한다.
Tmax Installation Guide 16
# 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 |
+---------------------------------------------------+
Tmax Installation Guide 17
# 설치가 끝난 후, 사용자가 해주어야 할 작업이 설명되어 있다.
===========[ 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 Installation Guide 18
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 환경 설정 및 테스트” 에 설명되어 있다.
Tmax Installation Guide 19
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
설치과정
Tmax Installation Guide 20
다음은 설치과정을 보여주며, #으로 주석처리 되어 있는 부분은 설치 항목
에 대한 설명이다. 세부적인 내용과 지원 플랫폼은 버전에 따라 달라질수
있다.
-----------------------------------------------------------------
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.
o Select one of the following :
1. Tmax Server/Client
2. Tmax Client
3. WebT for Tmax
4. Quit Installation Program
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
Tmax Installation Guide 21
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 환경 설정 및 테스트” 에서 다루고 있다. 설치 시 입력하는
Tmax Installation Guide 22
# 값들은 쉘 초기화 파일과 $TMAXDIR/sample/client/tmax.env 에 적용된다.
Now, installation is ready! Press RETURN to continue...
( Press Ctrl-C to quit )
# 모든 사항에 대한 입력을 완료하고 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.
Thank you for using Tmax Product!
Tmax Installation Guide 23
Technical support center
Homepage: http://www.tmax.co.kr
E-mail : [email protected]
======================================================
설치된 Tmax 시스템의 디렉토리 구조.
Tmax Root Directory
디렉토리들은 다음과 같은 파일들을 포함한다.
bin : 유틸리티(fdlc, sdlc)
lib : Tmax 클라이언트 라이브러리
sample : Tmax 샘플 파일 및 디렉토리
usrinc : Tmax 헤더 파일
Sample Directory
디렉토리들은 다음과 같은 파일들을 포함한다.
client : 클라이언트 샘플 프로그램
fdl : 샘플 필드키 정의 파일(demo.f)
sdl : 샘플 구조체 정의 파일(demo.s)
Tmax 클라이언트 설치 후의 디렉토리 구조
TMAXDIR
bin
lib
sample
usrinc
client
fdl
sdl
Tmax Installation Guide 24
설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “I. 2.4
환경 설정 및 테스트” 에 설명되어 있다.
Tmax Installation Guide 25
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 Installation Guide 26
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 환경변수에 설정이 되어 있
는지 확인하고, 만약 설정이 되어 있지 않다면 반드시 관련 디렉토리와 그
외 필요한 기본 디렉토리들도 적용될 수 있도록 해야 한다.
Tmax Installation Guide 27
다음은 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 Installation Guide 28
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의 경우>
Tmax Installation Guide 29
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 Installation Guide 30
예제 프로그램 테스트
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 명령을 사용했을 때, 나
Tmax Installation Guide 31
오는 이름이 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 이 생성된다. 이 파일은 이진
파일로 구조체 타입 버퍼를 사용하는 클라이언트 프로그램에서 구조체 타
입 버퍼를 메모리에 할당할 때 사용된다. 이 파일의 위치는 사용자 환경파
Tmax Installation Guide 32
일에 설정된 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 Installation Guide 33
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가 기동 되지 않거나 에러 메시지를 출력하면 위의 내용을 다시 확인
해 보고 수정한 후 다시 기동 시켜야 한다.
Tmax Installation Guide 34
클라이언트 프로그램 컴파일 및 실행
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가 설치 되었음을 확인할 수 있다.
그 외에 인스톨러가 제공하는 예제에 대해서 간략하게 설명한다.
Tmax Installation Guide 35
클라이언트 서버 프로그램 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 필드키 버퍼
오라클 연동
Tmax Installation Guide 36
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 설치” 를 참조한다.
설치 전 준비사항
Tmax Installation Guide 37
1)윈도우즈 플랫폼은 여러가지 서비스를 등록하므로 완전한 설치를 위해
서 Administrator 권한으로 설치할 것을 권장한다.
2)인스톨 환경이 Tmax설치 최소 요구사항에 합당한지 확인하고 CD-
ROM 드라이브에 Tmax CD-ROM 을 삽입한다.
3)오라클 DB를 사용할 경우는 오라클의 버전을 확인한다
4)windows디렉토리에 있는 setup.exe를 실행시킨다.
설치과정
다음은 Tmax 서버/클라이언트의 설치과정을 보여준다. 처음 setup.exe
를 실행하면 다음과 같은 화면을 볼 수 있다.
Tmax Installation Guide 38
“Next” 버튼을 누르면 제품 라이센스 동의서를 볼 수 있다.
라이센스에 동의하는지를 묻는다. 이 때 No를 선택하고 다음과 같은 다이
얼로그 박스가 뜰때 “확인” 버튼을 누르면 설치가 중단된다.
Tmax Installation Guide 39
라이센스에 동의하면 Tmax 설치 폴더를 묻는 화면으로 넘어간다.
Tmax가 설치될 폴더를 지정한다. 디폴트로 c:\tmax에 설치하게 되어 있
다. 다른 폴더에 설치하고 싶다면 왼쪽의 트리 컨트롤에서 설치하고자 하는
폴더를 지정해 주고 새로운 폴더를 만들고 싶다면 트리 컨트롤에서 새 폴
더를 만들고자 하는 폴더를 클릭한 후 오른쪽 아래의 “New Folder” 버튼
을 눌러 새 폴더 이름을 지정해 주면 새로운 폴더가 만들어지면서 설치 폴
더로 지정이 된다. 다른 폴더를 지정했다가 디폴트 폴더로 다시 지정하고
싶다면 “Restore default Location” 버튼을 누르면 디폴트 폴더인
“c:\tmax”이 설치 폴더로 지정이 된다.
Tmax Installation Guide 40
설치 폴더를 지정하고 “Next” 버튼을 누르면 실제 인스톨 과정이 진행된다.
Tmax 시스템 파일/라이브러리와 샘플 등이 지정한 위치에 설치 되고 난
후 “File copy is finished. If you want to go next, please click <Next>
button.” 이라는 메시지가 나오면서 “Next”버튼이 활성화 되면 “Next” 버
튼을 클릭한다.
Tmax Installation Guide 41
시스템 파일과 라이브러리 등의 설치 과정이 끝나면 Tmax 시스템 운용에
필요한 환경 변수를 설정해 주어야 한다. 처음 나오는 화면은 시스템 설정
에 관한 것이다.
Set Environment variable to your system Tmax 시스템을 설치할 서버의 IP 주소를 입력한다. 이 IP 주소는 클라이
언트가 Tmax의 서비스를 요청하기 위해 접속할 서버의 IP 주소이다. 디폴
트로 Tmax 시스템이 설치될 서버의 IP 주소가 설정되어 있다. IP 주소는
정확하게 입력하지 않으면 에러가 발생하므로 정확하게 입력하여야 한다.
클라이언트가 Tmax 시스템과 통신하기 위해 필요한 접속포트를 지정한다.
이 포트번호의 범위는 1 ~ 65535 까지이다. 인스톨러는 사용자가 입력한
포트가 이미 시스템에서 사용중인지 혹은 올바른 범위내의 값인지를 체크
하지 않으므로 서버 관리자와 문의하여 정확하게 입력해야 한다. 포트 번호
는 디폴트로 8888로 지정되어 있으므로 변경하지 않는다면 8888이 사용되
Tmax Installation Guide 42
게 된다.
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를 사용한 분산 트랜잭션 처리를 하고자 할때 지정
해 주어야 한다.
Tmax Installation Guide 43
대표적인 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 Installation Guide 44
설치된 Tmax 시스템의 디렉토리 구조.
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
Tmax Installation Guide 45
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.
3.4 환경 설정 및 테스트” 에 설명되어 있다.
환경 변수 등록과 서비스 등록
설치과정에서 지정한 환경변수이외에 필드키버퍼나 구조체버퍼를 사용할
경우에 필요한 환경변수는 다음과 같이 자동으로 지정된다. 이 때
TMAXDIR은 Tmax System을 설치한 폴더의 경로를 의미한다.
FDLFILE : TMAXDIR\fdl\tmax.fdl
SDLFILE : TMAXDIR\sdl\tmax.sdl
또한 PATH에 TMAXDIR\bin 디렉토리가 자동으로 추가된다.
Tmax Installation Guide 46
기존에 Tmax 시스템이 설치된 적이 있었다면 PATH를 제외한 다른 Tmax
환경변수들의 값은 새로 지정한 값으로 수정된다. 그러나 PATH에 잡혀있
는 디렉토리 값은 동일한 디렉토리에 재설치 하더라도 중복하여 추가된다.
가장 나중에 인스톨 된 디렉토리 값이 가장 처음에 위치한다.
시스템이 재부팅 되면 인스톨러는 자동으로 Tmax 시스템과 RACD를 윈도
우즈의 시스템 서비스 항목에 Tmax Loader, RACD Loader라는 이름으로
등록한다. 이 Tmax\RACD Loader는 Tmax 시스템 및 RACD의 시작 및
종료를 컨트롤 패널에서 할 수 있도록 지원한다.
등록된 Tmax Loader
Tmax Installation Guide 47
만약 시스템을 재부팅 하였는데도 Tmax system또는 RACD가 시스템에 서
비스로 등록되어 있지 않다면 수동으로 설치하여야 한다. 도스 명령창을 열
고 다음과 같이 입력하여 서비스 등록 명령을 실행시킨다..
. C:\svcinstall C:\racdinstall
시스템 서비스에서 Tmax(RACD) Loader를 제거하려면 도스 명령창을 열
고 다음과 같이 입력하여 서비스 제거 명령을 실행시킨다.
C:\svcremove C:\racdremove
등록된 RACD Loader
Tmax Installation Guide 48
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
를 실행하면 다음과 같은 화면을 볼 수 있다.
Tmax Installation Guide 49
위와 같이 인스톨러 프로그램이 실행되면 “Next” 버튼을 눌러 라이센스 동
의 페이지로 이동한다.
Tmax Installation Guide 50
라이센스에 동의하는지를 묻는다. 이 때 No를 선택하고 다음과 같은 다이
얼로그 박스가 뜰때 “확인” 버튼을 누르면 설치가 중단된다
Tmax Installation Guide 51
라이센스에 동의하면 Tmax 설치 폴더를 묻는 화면으로 넘어간다.
Tmax가 설치될 폴더를 지정한다. 디폴트로 c: \tmax 에 설치하게 되어 있
다. 다른 폴더에 설치하고 싶다면 왼쪽의 트리 컨트롤에서 설치하고자 하는
폴더를 지정해 주고 새로운 폴더를 만들고 싶다면 트리 컨트롤에서 새 폴
더를 만들고자 하는 폴더를 클릭한 후 오른쪽 아래의 “New Folder” 버튼
을 눌러 새 폴더 이름을 지정해 주면 새로운 폴더가 만들어지면서 설치 폴
더로 지정이 된다. 다른 폴더를 지정했다가 디폴트 폴더로 다시 지정하고
싶다면 “Restore default Location” 버튼을 누르면 디폴트 폴더인 c:\tmax
이 설치 폴더로 지정이 된다.
Tmax Installation Guide 52
설치 폴더를 지정하고 “Next” 버튼을 누르면 실제 인스톨 과정이 진행된다.
Tmax 시스템 파일/라이브러리와 샘플 등이 지정한 위치에 설치 되고 난
후 “File copy is finished. If you want to go next, please click <Next>
button.” 이라는 메시지가 나오면서 “Next” 버튼이 활성화 되면 “Next” 버
튼을 클릭한다.
시스템 파일과 라이브러리 등의 설치 과정이 끝나면 실제 접속이 이루어질
Tmax 시스템에 대한 환경 변수를 설정해 줘야 한다.
Tmax Installation Guide 53
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 환경 설정 및 테스트” 부분을 참고한다.
Tmax Installation Guide 54
설치과정이 모두 완료된 후에는 입력한 환경변수가 반영되도록 해야 한다.
윈도우즈 2000의 경우는 위의 과정이 필요 없으나 윈도우즈 NT의 경우 시
스템 재부팅 과정이 꼭 필요하다. 재부팅을 하지 않을 경우 환경변수로 등
록은 되어져 있더라도 실제로 시스템에 반영되지는 않는다. 윈도우즈 2000
의 경우는 No를 선택하도록 하고 윈도우즈 NT의 경우는 Yes를 선택하여
재부팅 하도록 한다.
윈도우즈 98/Me 사용자는 바로 재부팅 하지말고 autoexec.bat 파일에 필
요한 환경변수를 설정하고 난 뒤 재부팅 하도록 한다.
사용자가 원하는 대로 지정한 다음 확인 버튼을 누르면 Tmax 클라이언트
의 인스톨이 완료된다.
Tmax Installation Guide 55
설치된 Tmax 시스템의 디렉토리 구조.
Tmax Root Directory
디렉토리들은 다음과 같은 파일들을 포함한다.
bin : 유틸리티(fdlc, sdlc)
lib : Tmax 클라이언트 라이브러리
sample : Tmax 샘플 파일 및 디렉토리
usrinc : Tmax 헤더 파일
Sample Directory
디렉토리들은 다음과 같은 파일들을 포함한다.
client : 클라이언트 샘플 프로그램
fdl : 샘플 필드키 정의 파일(demo.f)
sdl : 샘플 구조체 정의 파일(demo.s)
설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “I. 3.4
환경 설정 및 테스트” 에 설명되어 있다.
Tmax 클라이언트 설치후 디렉토리 구조
TMAXDIR
bin
lib
sample
usrinc
client
fdl
sdl
Tmax Installation Guide 56
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를 실행시키면 윈도우즈 서버에
대한 정보를 알 수 있다.
Tmax Installation Guide 57
- 도스 명령창을 연다. 도스 명령창은 시작버튼을 누르면 나오는 메뉴중에서 실행을
선택하고 입력창에 command라고 입력하면 실행된다.
- ncpu 명령을 입력하고 엔터키를 친다.
- 도스 명령창에 Tmax 서버의 호스트명이 출력된다.
- 출력된 호스트명을 TmaxSoft 라이센스 담당에게로 보내면 License File을 생성하여 보
내준다. 보낼 email 주소는 “ I. 1.3 평가판 Tmax 소프트웨어의 배포” 를 참고한다.
License File을 설치하고 나면 도스 명령창에서의 Tmax System 사용이
Tmax Installation Guide 58
가능하다. 도스 명령창을 열고 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 Installation Guide 59
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 Installation Guide 60
- 도스 명령창에서 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 시스템을 시작 또는 종료시킬 때에 반드시
Tmax Installation Guide 61
‘-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 시스템 프로세스들과 함께 부팅되어 서비스를 제공하는 프로그
램이다. 컴파일 은 다음과 같은 방법으로 하면 된다. 모든 과정은 도스 명
Tmax Installation Guide 62
령 창에서 수행한다.
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 로 파일을 생성시켜야
Tmax Installation Guide 63
한다.
프롬프트에 다음과 같이 입력하여 메이크 파일을 실행한다.
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이 설치되어 있다면 다음과 같은 방법으로
Tmax Installation Guide 64
도 클라이언트 프로그램을 컴파일 할 수 있다.
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 시스템
이 정상적으로 설치되었다는 것을 확인하는 것이다.
Tmax Installation Guide 65
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” 를 참조한다.
Tmax Installation Guide 66
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 설치”를 참고한다.
Tmax Installation Guide 67
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
설치과정
Tmax Installation Guide 68
다음은 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.
o Select one of the following :
1. Tmax Server/Client
2. Tmax Client
3. WebT for Tmax
4. Quit Installation Program
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________________
Tmax Installation Guide 69
Checking directory '/usr/local/webt' : ‘/usr/local/webt’ is made
# WebT를 설치하고자 하는 디렉토리를 입력한다. 지정한 디렉토리가 존재하지
# 않으면 새롭게 디렉토리를 만든다. 사용 권한이 없는 곳에 디렉토리를 만들려고
# 하거나 절대경로를 입력하지 않으면 설치는 자동적으로 종료된다.
Now, installation is ready! Press RETURN to continue...
( Press Ctrl-C to quit )
# 설치할 디렉토리의 입력이 끝나면, 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.
Thank you for using Tmax Product!
Technical Support Center
Tmax Installation Guide 70
Homepage: http://www.tmax.co.kr
E-mail : [email protected]
=======================================================
설치된 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
Tmax Installation Guide 71
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
Tmax Installation Guide 72
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 환경변수에 등록한다.
Tmax Installation Guide 73
‘새로만들기’ 버튼을 눌러 환경변수에 다음과 같이 등록한다.
JEUS가 이미 설치되어 있다면, CLASSPATH 변수에 c:\Jeus\classes라는
경로가 이미 존재 할 것이다. JEUS가 아닌 아파치 JServ를 설치 했다면
JSDK(Java Servlet Development Kit)의 라이브러리(jsdk.jar) 경로가 설정
되어 있을 것이다. 따라서, 컴파일 시 오류가 발생한다면 이 CLASSPATH
변수를 먼저 점검해야 할 것이다.
모든 과정이 올바르게 진행 되었다면, 확인 버튼을 눌러 빠져 나온 후, 환
경변수가 제대로 등록되었는지 명령 프롬프트 창을 하나 열고 set 명령으
로 확인한다.
Tmax Installation Guide 74
환경변수 등록 확인
Tmax Installation Guide 75
4. 라이센스 파일 설치
WebT가 미들웨어 Tmax와 연동될 수 있도록 개발되었기 때문에 WebT를
사용하기 위한 별도의 라이센스는 없고 Tmax 라이센스 파일 내에 포함되
어 있다. 기존에 Tmax를 사용하던 시스템에서 WebT를 사용하고자 한다면
WebT 기능을 사용할 수 있는 새로운 라이센스 파일을 받아야 한다. Tmax
시스템이 설치된 디렉토리의 license 디렉토리에 license.dat 파일을 복사
하면 라이센스 파일의 설치는 완료된다. 라이센스의 설치에 관한 내용은 “I.
2.3 환경 설정 및 테스트” 에 자세히 설명되어 있다.
Tmax Installation Guide 76
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 환경에서만 테스트 하기로 한다.
Tmax Installation Guide 77
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 환경변수 등
Tmax Installation Guide 78
을 체크한다. 컴파일이 정상적으로 진행되어 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가 정상적으로 설치된
것이다. (버전 번호는 메뉴얼과 다를 수 있다.)
Tmax Installation Guide 79
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)
기본 환경 설정
Tmax Installation Guide 80
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
성공적으로 컴파일이 이루어지면 다음과 같은 메시지가 출력된다.
Tmax Installation Guide 81
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
Tmax Installation Guide 82
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를 이용
해서 직접 컴파일 하도록 한다.
Tmax Installation Guide 83
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 서버가 처리한 후 결과를 보내준다.
Tmax Installation Guide 84
WebT와 Tmax의 연동에 관한 좀더 자세한 내용과 응용프로그램 개발을
위한 WebT 클래스 설명은 Tmax WebT Programming Guide 를 참조하도
록 한다.
Tmax Installation Guide 85
다음은 테스트에 필요한 각종 설정 파일들에 대한 내용이다.
< 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
Tmax Installation Guide 86
<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"
Tmax Installation Guide 87
<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"
Tmax Installation Guide 88
<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,
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 = "c:\\WebtoB\\icons\\"
*EXT
htm MimeType = "text/html", SvrType = HTML
*LOGGING
log1 Format = "DEFAULT", FileName = "c:\\ WebtoB\\log\\access.log",
OPTION = "sync"
log2 Format = "DEFAULT", FileName = "c:\\WebtoB\\log\\err.log",
OPTION = "sync"
Tmax Installation Guide 89
<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>
Tmax Installation Guide 90
/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>
. . .
이하 생략
. . .
Tmax Installation Guide 91
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
Tmax Installation Guide 92
테스트를 위한 모든 준비가 끝났다면 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
Tmax Installation Guide 93
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 Installation Guide 94
게시판 관련 소스들도 컴파일이 되는데 이를 사용하려면, 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를 기동 시킨다.
/usr/local/apache/bin/apachectl start
Tmax와 연동할 수 있는 샘플 프로그램(BufTypeDemo.class)이 잘 동작하
는지 브라우저를 통해서 확인한다. URL을 다음과 같이 입력한다.
http://192.168.0.1/webt/index.html
WebT와 Tmax의 연동에 관한 좀더 자세한 내용과 응용프로그램 개발을
위한 WebT 클래스 설명은 Tmax WebT Programming Guide 를 참조하도
록 한다.
Tmax Installation Guide 95
III. 부록
1. TMS 컴파일 2. Apache Web Server 및 Apache JServ 설치
3. Platform Specifications for Tmax Products
Tmax Installation Guide 96
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 ##
Tmax Installation Guide 97
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을 참고한다.
Tmax Installation Guide 98
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
Tmax Installation Guide 99
-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
Tmax Installation Guide 100
컴파일 되어 생성된 TMS 이진 파일은 $TMAXDIR/appbin 디렉토리로 옮
겨지게 된다. Oracle용 TMS를 기동 시키기 위해 설정하는 Tmax 설정 파
일은 $TMAXDIR/config/sample.m을 참고한다.
Tmax Installation Guide 101
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용 패키지를 설치하기 위해서는 해당 매뉴얼을 참조한다.
Tmax Installation Guide 102
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가
설치되어 있지 않은 대부분의 다른 유닉스 상에서 오류가 날 것이다. 이 부
Tmax Installation Guide 103
분은 차차 설명하기로 하겠다.
앞으로의 과정은 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를 설치 사용자 계정의 쉘 환경파일에 등록하여 두
Tmax Installation Guide 104
면 된다.
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에 설치된다.
Tmax Installation Guide 105
./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에 설정을 하였
다.
Tmax Installation Guide 106
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를 기동 시켜 본다.
/usr/local/apache/bin/apachectl start
Apache와 Apache JServ가 정상적으로 설치되고 기동 되었다면, 다음과 같
은 프로세스가 httpd 데몬과 함께 생성되어 있을 것이다. 이것은 ps 명령으
로 확인할 수 있다.
/usr/local/jdk1.2.2/bin/i386/native_threads/javaorg.apache.jserv.JServ ……
Apache와 Apache JServ가 정상적으로 설치되고 기동 되었는지를 확인하
기 위해 웹 브라우저에서 다음처럼 서버의 테스트 페이지를 불러온다. 패키
Tmax Installation Guide 107
지가 설치된 서버의 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
Tmax Installation Guide 108
Tmax Installation Guide 109
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
Tmax Installation Guide 110
3.2 Compaq Tru64 v5.0(5.1) on Alpha
1) 하드웨어 요구사항
플랫폼 : Compaq Alpha
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : Tru64 5.0
컴파일러 : Compaq ANSI C compiler
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client : 6391 Kbyte
Tmax Client : 951 Kbyte
5) CD-ROM 마운트 방법
mkdir /cdrom
/usr/sbin/mount -r -t cdfs /dev/cdrom_devicename /cdrom
3.3 HP UX v10.20 on HP9000 Series
1) 하드웨어 요구사항
운영체제 : HP PA-RISC
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
Tmax Installation Guide 111
2) 소프트웨어 요구사항
운영체제 : HP-UX 10.20
컴파일러 : HP-UX ANSI C Compiler
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client : 5078 Kbyte
Tmax Client : 700 Kbyte
5) CD-ROM 마운트 방법
su -
mkdir /cdrom
mount -F cdfs -o cdcase /dev/dsk/cdrom_devicename /cdrom
3.4 HP HP-UX v11.00 on HP9000 Series
1) 하드웨어 요구사항
플랫폼 : HP PA-RISC
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : HP-UX 11.0(64bit 아키텍쳐 지원)
컴파일러 : HP-UX ANSI C Compiler
3) 네트워크
TCP/IP 네트워크
Tmax Installation Guide 112
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client(32bit) : 5078 Kbyte
Tmax Client(32bit) : 700 Kbyte
Tmax Server and Client(64bit) : 5616 Kbyte
Tmax Client(64bit) : 942 Kbyte
5) CD-ROM 마운트 방법
su -
mkdir /cdrom
mount -F cdfs -o cdcase /dev/dsk/cdrom_devicename /cdrom
3.5 IBM AIX v4.3.x on RS/6000
1) 하드웨어 요구사항
플랫폼 : IBM PowerPC
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : AIX v4.3.x(64bit 아키텍쳐 지원)
컴파일러 : AIX XL C Compiler
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client(32bit) : 4859 Kbyte
Tmax Client(32bit) : 706 Kbyte
Tmax Server and Client(64bit) : 5768 Kbyte
Tmax Client(64bit) : 848 Kbyte
Tmax Installation Guide 113
5) CD-ROM 마운트 방법
smit 또는 smitty 유틸리티를 이용해서 CD-ROM 장치를 마운트 시킨다.
smitty mount
3.6 SUN Solaris v2.5.1(SunOS 5.5.1) on SPARC
1) 하드웨어 요구사항
플랫폼 : SUN UltraSPARC
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : SunOS 5.5.1
컴파일러 : SparCompiler C 4.0 또는 그 이상
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client : 6825 Kbyte
Tmax Client : 816 Kbyte
5) CD-ROM 마운트 방법
별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 마운트 가능
3.7 SUN Solaris v2.6(SunOS 5.6) on UltraSPARC
1) 하드웨어 요구사항
플랫폼 : SUN UltraSPARC
Tmax Installation Guide 114
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : SunOS 5.6
컴파일러 : SparCompiler C 4.0 또는 그 이상
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client : 6825 Kbyte
Tmax Client : 816 Kbyte
5) CD-ROM 마운트 방법
별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 /cdrom에 마운트
3.8 SUN Solaris v2.7(SunOS 5.7) on UltraSPARC
1) 하드웨어 요구사항
플랫폼 : SUN UltraSPARC
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : SunOS 5.7(64bit 아키텍쳐 지원)
컴파일러 : SparCompiler C 4.0 또는 그 이상
3) 네트워크
TCP/IP 네트워크
Tmax Installation Guide 115
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client : 6825 Kbyte
Tmax Client : 816 Kbyte
Tmax Server and Client(64bit) : 6855 Kbyte
Tmax Client(64bit) : 1031 Kbyte
5) CD-ROM 마운트 방법
별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 /cdrom에 마운트
3.9 SUN Solaris v2.8(SunOS 5.8) on UltraSPARC
1) 하드웨어 요구사항
플랫폼 : SUN UltraSPARC
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
3) 소프트웨어 요구사항
운영체제 : SunOS 5.8(64bit 아키텍쳐 지원)
컴파일러 : SparCompiler C 4.0 또는 그 이상
4) 네트워크
TCP/IP 네트워크
5) 설치된 제품의 디스크 사용공간
Tmax Server and Client : 6825 Kbyte
Tmax Client : 816 Kbyte
Tmax Server and Client(64bit) : 6855 Kbyte
Tmax Client(64bit) : 1031 Kbyte
6) CD-ROM 마운트 방법
별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 /cdrom에 마운트
Tmax Installation Guide 116
3.10 RedHat Linux 7.x on Intel
1) 하드웨어 요구사항
플랫폼 : Based on Intel CPU
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : RedHat Linux 계열 또는 기타 배포판(Kernel 2.0 이상)
컴파일러 : (Tmax 응용프로그램 개발 시에만 필요)
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
Tmax Server and Client(32bit) : 3860 kbyte
Tmax Client(32bit) : 636 Kbyte
5) CD-ROM 마운트 방법
/mnt/cdrom 디렉토리가 없으면, 수퍼유저 권한으로 디렉토리를 생성
mkdir /mnt/cdrom
mount /mnt/cdrom 또는 mount –rt iso9660 /dev/devicename /mnt/cdrom
6) 알아두어야 할 사항
레드햇 계열에서는 Tmax 제품이 테스트 되었음.
RedHat 계열 이외의 배포판에 대해서는 일반적으로 잘 동작 할 것이라 기대되지만,
보장하지는 않음.
Tmax Installation Guide 117
3.11 Windows NT 4.0 on Intel
1) 하드웨어 요구사항
플랫폼 : Based on Intel CPU
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
컴파일러 : Windows NT 4.0 Server(서비스팩 3.0 이상 필요)
운영체제 : Microsoft Visual C++ 5.0 또는 그 이상
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
5) 알아두어야 할 사항
Tmax Server 또는 Tmax Client 설치 시 재시작 필요
3.12 Windows NT 5.0(Windows 2000) on Intel
1) 하드웨어 요구사항
플랫폼 : Based on Intel CPU
메모리 : 128MBytes 이상(256 Mbytes 이상 권장)
디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)
2) 소프트웨어 요구사항
운영체제 : Windows 2000 Server
컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램 개발 시에만 필요)
3) 네트워크
Tmax Installation Guide 118
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
5) 알아두어야 할 사항
Tmax Server 설치 시 재시작이 필요하다는 메시지가 나오나 실제로 재시작 필요하지
않음. Windows NT 4.0 Server 상에서만 설치 후 재시작 필요
3.13 Windows 98 on Intel
1) 하드웨어 요구사항
플랫폼 : Based on Intel CPU
메모리 : 32MBytes 이상
디스크 : 10MBytes 이상의 여유공간
2) 소프트웨어 요구사항
운영체제 : Windows 98 (or Windows Me)
컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램 개발 시에만 필요)
3) 네트워크
TCP/IP 네트워크
4) 설치된 제품의 디스크 사용공간
5) 알아두어야 할 사항
Tmax 서버에 서비스 요청하기 전에 Tmax 환경변수(예:autoexec.bat) 적용 또는 환경
파일(예:tmax.env)의 설정 필요
Tmax 환경변수 예
TMAX_HOST_ADDR(Tmax 서버의 IP 주소)
TMAX_HOST_PORT(Tmax 서버의 포트번호)
Tmax Installation Guide 119
FDLFILE(Fieldkey buffer type 사용 시에만 필요)
SDLFILE(Structure buffer type 사용 시에만 필요)