68
WebtoB Installation Guide

Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide

Page 2: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

저작권 Copyright (c) 2000 Tmax Soft Co., Ltd. All Rights Reserved. 본 서의 일부나 전체의 내용은 어떠한 형태로든 무단 복제를 금하며 전기적, 물리적, 사진, 기록 또는 다른 매체로의 복제를 위해서는 반드시 Tmax Soft 의 사전 동의를 얻어야 합니다. 본 제품 사용 중 일어난 특정한, 우발적, 비직접적, 필연적인 손실을 책임지지 않습니다. 그러나 특수한 목적에 적합하고 유통가능하며 규정사항에 위배되지 않을 경우에는 제외됩니다. 본 서에는 기술적인 오류나 인쇄상의 오류가 있을 수 있습니다. 본 서의 내용 중 수정된 부분은 정기적으로 제품의 개정본에 추가 될 것입니다. 본 문서에 포함된 내용은 별도의 사전 통보 없이 내용을 보강하기 위해서 수정되어질 수 있습니다. 상표 Tmax, WebT, WebtoB, JEUS, Host-Link, WebInOne 은 Tmax Soft Co., Ltd.의 상

표입니다. 업체 정보 ㈜ Tmax 소프트 135-708 서울시 강남구 대치동 946-1 글라스타워 18 층

WebtoB Installation Guide 1

Tel: +82-2-6288-2114, 2006 Fax: +82-2-6288-2115 E-Mail: [email protected]

Page 3: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

About This Guide

이 책은 WebtoB Web Server 의 설치를 돕기위한 가이드북이다. 이 책은 사용자가 본 제품을 구매하여 웹서버를 부팅하기까지의 과정, 즉 설치과정을 돕기 위한 책으로, 아래와 같은 내용구성으로 되어있다.

Chapter 1

WebtoB 에 대한 전반적인 소개와, 설치를 위해 미리 알고 있어야 할 사항에 대한 소개를 담고 있다.

Chapter 2

WebtoB 제품의 구성, 본 제품이 지원하는 플랫폼에 대한 안내, 설치를 위한 권장 사양, 그리고 라이센스 체계에 대한 안내를 담고 있다.

Chapter 3,4

WebtoB 의 설치에서부터 부팅전 까지의 단계에 대한 setp by step 지침

이다. 윈도우 환경을 포함하여 모든 지원가능한 플랫폼에서의 설치 가

이드이며, 윈도우의 경우에도 필요한 내용이 있으니 윈도우 사용자도 이 장을 꼭 읽어주길 바란다. 각 절차를 따라 쉽게 설치할 수 있도록 내용구성이 되어있다.

Chapter 5

설치과정중 일어날 수 있는 일반적인 에러에 대한 해결책을 담고있다. 앞장에서 설명한 대로 설치를 하였음에도 문제가 발생하였다면, 이 장을 참고하여 문제점을 해결할 수 있을 것이다.

Chapter 6 (Standard+)

WebtoB Installation Guide 2

WebtoB Servlet Engine 의 설치를 위한 내용을 담고있다. WebtoB Servlet Engine 을 설치하는 방법을 플랫폼별로 나누어 설명한다.

Page 4: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

-- 차 례 --

About This Guide .......................................................................... 2

1 WebtoB 개요 .............................................................................. 5

1.1 WebtoB 설치/입문을 읽기 전에 ............................................................................ 5

1.2 미리 알아 두어야 할 사항 ..................................................................................... 5

2 WebtoB의 소개 .......................................................................... 6

2.1 WebtoB란? ............................................................................................................. 6

2.2 설치하기 전에 ......................................................................................................... 6

2.2.1 제품 확인 ......................................................................................................... 6

2.2.2 WebtoB 제품별 기능 ....................................................................................... 7

2.2.3 지원 플랫폼 및 운영체제 ................................................................................ 7

2.2.4 H/W 및 S/W 요구사항 .................................................................................... 7

2.2.5 각 플랫폼별 공통사항 ..................................................................................... 9

2.2.6 라이센스 부여 방식 ......................................................................................... 9

3 WebtoB 설치하기 ..................................................................... 10

3.1 시스템 환경 파악 .................................................................................................. 10

3.1.1 호스트 이름.................................................................................................... 10

3.1.2 포트번호 ......................................................................................................... 11

WebtoB Installation Guide 3

3.1.3 설치 과정 ....................................................................................................... 12

Page 5: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

3.2 Unix/Linux에서 WebtoB 설치............................................................................. 12

3.2.1 WebtoB설치 전 주의사항 .............................................................................. 12

3.2.2 CD-ROM으로 설치(SHELLSCRIPT) ............................................................. 13

3.2.3 CD-ROM으로 설치(GUI)................................................................................ 27

3.2.4 License 등록 .................................................................................................. 40

3.2.5 WebtoB Upgrade/Patch 방법......................................................................... 41

4 WebtoB의 실행 ........................................................................ 42

4.1 환경설정 ................................................................................................................ 42

4.1.1 기본 항목 ....................................................................................................... 46

4.1.2 추가 항목 ....................................................................................................... 49

4.1.3 WebtoB 환경 파일의 Compile ...................................................................... 50

4.1.4 WebtoB의 실행과 종료.................................................................................. 50

5 Windows NT/2000의 WebtoB 설치 ....................................... 52

5.1 WebtoB설치 전 주의사항 .................................................................................... 52

5.2 CD-ROM으로 설치(Windows) ............................................................................. 52

6 설치과정 중 문제해결............................................................... 65

6.1 1. 모든 플랫폼 ...................................................................................................... 65

6.1.1 Hardware Requirements and Software Requirements................................... 65

6.1.2 Host name problem ........................................................................................ 65

6.1.3 Port Problem................................................................................................... 65

6.1.4 SHMKEY Problem.......................................................................................... 66

6.1.5 Path Problem.................................................................................................. 66

6.2 Unix/Linux ............................................................................................................ 66

6.2.1 Directory Setting Problem .............................................................................. 66

6.2.2 License Problem............................................................................................. 66

WebtoB Installation Guide 4

6.2.3 User Account Problem.................................................................................... 66

Page 6: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

1 WebtoB 개요

1.1 WebtoB 설치/입문을 읽기 전에

WebtoB 는 ㈜티맥스소프트에서 개발하여 출시한 야심작으로서, 전 세

계 웹서버 시장의 대부분을 차지하고 있는 Apache 와 IIS, Netscape Server 등의 문제점을 해결하고 보다 나은 성능과 안정성 등을 고려한 제품이다.

WebtoB 설치/입문은 WebtoB 를 설치하고, 기본 개념과 WebtoB 를 이

해하고자 하는 사용자를 위해 작성되었다.

1.2 미리 알아 두어야 할 사항

제품을 설치하고 웹서버 환경을 구성하기 위해서는 다음과 같이 미리 알고 있어야 할 부분이 있다.

Unix 기본 명령어에 대한 이해

Internet 과 World Wide Web 에 대한 기본적인 이해

WebtoB Installation Guide 5

Technical Support Information

http://www.tmax.co.kr

http://forum.tmax.co.kr(Developer’s Community & Download Service )

[email protected]

Page 7: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

2 WebtoB 의 소개

본 장에서는 WebtoB 를 설치 할 때, 미리 고려하여야 할 사항에 대한 설명과 WebtoB 의 특징에 대해 기술한다.

2.1 WebtoB 란?

WebtoB 는 ‘Web to Business’에서 따온 이름이며 Web 상에서 Browser 의 요구를 처리하여 주는 Server 용 소프트웨어이다. Web Server 시장의 대

략 67%를 상회하는 Apache 와의 호환성을 위주로, 더 나은 성능과 안

정성, 그리고 보안성을 제공하기 위해 나온 제품이다. 또한, 기존 Web Server 와의 차별을 위하여 WebtoB 만의 새로운 기능들(Caching, Session Management, Transaction Processing Service Call 등)을 추가하였다.

WebtoB 에서 제공하는 Service 들은 다음과 같다.

다양한 HTML 문서들의 처리

CGI 및 WBAPI 지원

SSI(Server Side Include) 지원

PHP Script Language 지원

TP monitor 서비스 지원 (Enterprise+)

Servlet 및 JSP 지원 (Standard+)

ACL 및 SSL 등 다양한 보안 Service 지원

2.2 설치하기 전에

WebtoB Installation Guide 6

2.2.1 제품 확인

- WebtoB 제품 CD-ROM 1 매

Page 8: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

- WebtoB 제품 라이센스 및 보증서

- 매뉴얼(WebtoB 설치/입문, WebtoB 관리자지침서)

2.2.2 WebtoB 제품별 기능

제품구분 제공기능

WebtoB3.0@Base HTML, CGI, PHP, SSI, SSL, Basic WBAPI

WebtoB3.0@Standard WebtoB@Base + Multi-Node +

Load Balancing + JSP/Servlet + WBAPI

WebtoB3.0@Enterprise WebtoB@Standard + TP-Service + Fail over

2.2.3 지원 플랫폼 및 운영체제

제조사 지원 운영체제 릴리즈/버전 WebtoB 버전

Compaq Tru64 UNIX 4.0, 5.0 3.1

HP HP-UX 10.20, 11.0 3.1

IBM AIX 4.2, 4.3 3.1

GNU Linux Kernel 2.0 이상 3.1

SUN Solaris 2.6, 2.7, 2.8 3.1

Windows NT base system 4.0 and 2000 3.1

WebtoB Installation Guide 7

2.2.4 H/W 및 S/W 요구사항

COMPAQ

Compaq Alpha Platform

Page 9: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 8

128Mbytes Memory

Compaq ANSI C 컴파일러

HP

HP PA-RISK

128Mbytes Memory

HP-UX ANSI C 컴파일러

IBM

IBM PowerPC

128Mbytes Memory

AIX XL C 컴파일러

GNU/RedHat

Intel Pentium Processor

128Mbytes Memory

GNU ANSI C 컴파일러

SUN

UltraSPARC uniprocessor

128Mbytes Memory

SparCompiler C 4.0

Windows

Intel Pentium 2 processor

128Mbytes Memory

Visual Studio 5.0 이상

Page 10: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

2.2.5 각 플랫폼별 공통사항

- TCP/IP Network 환경

- C 컴파일러는 CGI, WBAPI 또는 Tmax 서비스 프로그램 컴파일시 필요

- 설치후 WebtoB 의 디스크 사용량 : 40Mbytes 미만(WebtoB Servlet Engine 포함시)

WebtoB Installation Guide 9

2.2.6 라이센스 부여 방식

- 정식버전 : CPU 개수와 기능별 라이센스

- 평가판 버전 : 날짜 제한 방식 등의 라이센스

Page 11: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

3 WebtoB 설치하기

앞에서 언급한 Hardware 와 Software 에 대한 조건을 모두 갖추었다면, 다음을 확인한 다음 WebtoB Web server 를 설치한다.

호스트 이름 확인 ( 라이센스 요청시 필요 )

UNIX System 의 경우 - uname –n 명령 또는 /etc/hosts 파일 확인

Windows 계열의 경우 - 시스템 환경 변수를 보고 찾음

WebtoB 가 제공하는 유틸리티 프로그램을 이용 - WebtoB 를 설치한 뒤 생기는/license 디렉터리안의 ncpu 를 실행하여 정확한 호스트 이름(HOSTNAME1)을 얻을 수 있다.

Web Server 기동 시에 부여될 포트번호(default : 80)

Web Server 를 기동 시킬 계정(default : root)

Note : Default 로 지정되는 80 포트는 root 사용자가 아니면 사용할 수 없다. 따라서, root 계정이 아닌 사용자는 1024 번 이후의 포트를 설정하여 사용해야 한다.

3.1 시스템 환경 파악

WebtoB Installation Guide 10

3.1.1 호스트 이름

WebtoB 를 정상적으로 기동 시키기 위해서는 반드시 제품에 대한 라

이센스를 적용하고, WebtoB Configuration 파일을 설정해야 한다. 이중 특히 Configuration File 은 WebtoB 가 실제 운영될 수 있는 환경으로 구

성된다. WebtoB 는 인스톨 과정에서 호스트 이름과 IP Address 를 자

동으로 찾아내어 환경파일에 등록하여 준다. 시스템의 IP 주소와 호스

트 이름을 알아내는 방법은 다음과 같으며, 대표적으로 SUN Solaris 경

우의 예를 들었다.

Page 12: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

Ex 1] SUN Solaris System

$ ifconfig –a

lo0: flags=849<UP,LOOPBACK,RUNNING,MULTICAST> mtu 8232

inet 127.0.0.1 netmask ff000000

hme0:lags=863<UP,BROADCAST,NOTRAILERS,RUNNING,MULTICAST> mtu

1500

inet 192.168.0.1 netmask ffffff00 broadcast 192.168.63.255

$ uname –n

www

여기에서 호스트 이름이 FQDN(Fully Qualified Domain Name) 형식으로 출력이 된다면 맨 앞에 있는 이름만 설정하면 된다.

WebtoB Installation Guide 11

3.1.2 포트번호

WebtoB 가 특정 Server 에 설치되어 기동 될 때, 외부 클라이언트(보통 인터넷 브라우저)로 부터의 연결을 기다리는 Port 가 필요하게 된다. 일반적으로 Web Server 를 설치하게 되면 디폴트로 80 번 port 를 이용

하게 된다. 대부분의 운영체제에서 이 Port 번호는 수퍼유저가 아니면 이용할 수 없게 된다. 80 번호를 사용하기 위해서는 root 권한을 가져

야 하며, 사용자 계정으로 WebtoB 를 설치하고자 한다면 1024 번 이

후의 Port 번호를 사용하면 된다. 또한, WebtoB 에서 사용할 Port 번호

가 다른 프로그램에 의해서 이미 사용되고 있지는 않은지 확인 해야

만 한다. 환경파일에 포트번호를 등록하기 전에 이러한 사항을 확인 후 설정한다. 다른 Port 를 설정하여 이용한다면, 사용자에게 이 Port 를 알려주어야 할 것이다. Port 번호가 80 이 아닌 경우에, Browser 는 아래

와 같이 서비스 요청을 하게 된다.

EX] Web Server 의 Port 번호가 8080 일 경우

http://www.tmax.co.kr:8080/index.html

이제 본격적으로 WebtoB 를 설치해 보도록 하자.

제품의 CD-ROM 에는 WebtoB 를 설치할 수 있는 프로그램이 들어있다. 각각의 플랫폼에 대한 이진(Binary) 파일이 있기 때문에, 다양한 운영체제에 설치할 수 있다.

Page 13: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

3.1.3 설치 과정

WebtoB Web Server 를 설치하는 기본적인 절차는 다음과 같다.

Step 1

WebtoB 가 지원하는 플랫폼과 운영체제 등 기본 시스템의 사양이 갖

추어 졌는지 확인한다.

Step 2

설치하려고 하는 Server 에 다른 Web Server 나 WebtoB 의 기존 Version이 설치되어 있는지 확인한다. 다른 Web Server 를 이미 사용하고 있다

면, 이용하려는 포트번호가 중복되지 않는지 확인하고 필요하다면 해

당 Web Server 를 중지시킨다.

Step 3

위의 모든 작업이 우선적으로 이루어진 후, WebtoB 를 원하는 Server에 설치하고 사용한다.

Step 4

설치가 끝난 후에는 라이센스 파일을 적용시키도록 한다. WebtoB Web Server 는 평가판이라 할지라도 License 파일이 있어야 사용할 수 있다. 평가판의 경우에는 사용에 제한이 있기 때문에 사전에 이를 반드시 확인하여야 한다.

3.2 Unix/Linux 에서 WebtoB 설치

이번 장에서는 Unix/Linux 환경 하에서 WebtoB 3.0 의 설치에 대해서 설명할 것이다. Unix 에서는 Windows NT/2000 등의 환경과는 달리 command 기반으로 되어 있기 때문에 설치와 환경설정에 다소 불편함

이 따를 수 있다. 그러나, WebtoB 에서는 간단한 작업만으로 설치를 가

능하게 하였으므로, 이 장에서 설명하는 부분만을 가지고 충분히 쉽게 설치할 수 있다.

WebtoB Installation Guide 12

3.2.1 WebtoB 설치 전 주의사항

WebtoB 를 설치하기 전에 자신의 시스템 환경 파일을 반드시 살펴 보

도록 한다 . 이전에 WebtoB 가 설치 되었는지 또는 WebtoB Servlet Engine 을 함께 설치하고자 할 때는 이전에 WebtoB Servlet Engine 을

Page 14: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

설치한 내용이 있는지 확인 한 후 관련 환경변수들을 삭제하는 것을 권장한다. 이는 적용된 설치 path 가 혼동될 수가 있고 새로이 설치하

려는 WebtoB Servlet Engine 이 Shard Memory 충돌을 일으켜 정상적인 인스톨을 못하는 경우가 발생할 수 있기 때문이다.

또한, WebtoB Servlet Engine 을 함께 인스톨 할 경우에는 몇가지 더 주

의 사항들이 있다. 인스톨을 하기 전에 반드시 $which java Command Line 을 수행하여 jdk path 가 잡혀 있는지 확인해야 한다. 이는 WebtoB Servlet Engine 설치 과정에서 Security 와 관련한 Password 값을 인코딩 해야하기 때문이다.

따라서 이전에 JDK가 설치되어 있지 않으면 http://java.sun.com/j2se/1.3/ 사이트에서 자신의 시스템의 OS에 맞는 Java 2 SDK v1.3.0, Standard Edition을 download 하여 미리 설치해 두어야 한다. JDK version은 되도

TM

Java version 1.3.0(HopSpot Server 포함) 또는 version 1.2.2 이상 버전을 설치하도록 한다. 설치 후 반드시 JDK가 정상적으로 설치되었는지 확

인한다.

Java version 1.3.0 에서 WebtoB Servlet Engine 을 사용할 것을 권장하고 있다.

3.2.2 CD-ROM 으로 설치(SHELLSCRIPT)

Solaris, HP, AIX, Compaq, Linux 에서 이루어지는 WebtoB 와 WebtoB Servlet Engine 의 설치 과정은 모두 동일하며, 설치 과정은 Text 기반

으로 이루어지고 있기 때문에, Terminal 을 이용해서 설치할 수 있다. Installer 에서 기본적으로 Default 설정값을 제시하고 있지만, 자동으로 그 값을 입력해 주거나, 잘못된 값을 입력했을 경우, 다시 입력하도록 하지 않기 때문에, 항상 설정값 입력시에 주의를 기울여야 할 것이다.

WebtoB CD-ROM(ShellScript)을 통하여 설치하는 방법은 다음과 같다.

CD 를 CD-ROM 에 넣는다.

CD-ROM 을 Mount 한다.

CD 안에 UNIX ShellScript 설치파일이 존재하는지 확인한다.

설치의 시작

압축을 푼 디렉토리에서 “install.sh ” 을 실행한다.

WebtoB Installation Guide 13

License Agreement

Page 15: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 14

################################################################

# Web Server WebtoB Release 3.0

#

# This Software is made by 'Tmax Soft Co., Ltd.'

# and this software is distributed under our license agreement.

#

#

# Software End-User License Agreement

#

# Product : WebtoB

#

# This is a legal agreement between you (either an individual

# or an entity) and Tmax Soft, Incorporated. By opening the

# sealed software package and/or by using the software, you

# agree to be bound by the terms of this agreement.

#

# WebtoB Software License

#

# 1. Grant of License: This WebtoB Software License Agreement

# ("License") permits you to use one copy of the WebtoBsoftware

# product WebtoB, on any single computer, provided the software

# is in use on only one computer at any one time. If this

# package is a license pack, you may make and use additional

# copies of the software up to the number of licensed copies

# authorized. If you have multiple licenses for the software,

# then at any time you may have as many copies of the software

# in use as you have licenses.

# The software is "in use" on a computer when it is loaded

# into the temporary memory (i.e., RAM) or installed into the

# permanent memory (e.g., hard disk, CD-ROM, or other storage

# device) of that computer, except that a copy installed on a

# network server for the sole purpose of distribution to other

# computers is not "in use". If the anticipated number of

# users of the software will exceed the number of applicable

# licenses, then you must have a reasonable mechanism or

# process in place to ensure that the number of persons using

# the software concurrently does not exceed the number of

# licenses.

#

# 2. Copyright: The software (including any images, applets,

# photographs, animations, video, audio, music and text

Page 16: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

# incorporated into the software) is owned by Tmax Soft or

# its suppliers and international treaty provisions. Therefore,

# you must treat the software like any other copyrighted

# material (e.g., a book or musical recording) except that you

# may either (a) make one copy of the software solely for

# backup or archival purposes, or (b) transfer the software to

# a single hard disk provided you keep the original solely for

# backup or archival purposes. You may not copy the printed

# materials accompanying the software, nor print copies of any

# user documentation provided in "online" or electronic form.

#

# 3. Other restrictions: This license is your proof of

# license to exercise the rights granted herein and must be

# retained by you. You may not rent or lease the software, but

# you may transfer your rights under this license on a ermanent

# basis provided you transfer this license, the software, and

# all accompanying printed materials, retain no copies, and the

# recipient agrees to the terms of this license. You may not

# reverse engineer, decompile, or disassemble the software,

# except to the extent that the foregoing restriction is

# expressly prohibited by applicable law.

#

#

# Tmax Soft Co., Ltd.

#

################################################################

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

라이센스 동의를 얻는 과정이다. 내용을 읽고 동의를 하면 다음 과정으로 넘어갈 수 있으며 n 을 선택시 설치가 중단된다.

WebtoB Installation Guide 15

Operating System 선택

서버의 운영체제를 묻는 질문이다. 해당 운영체제에 대한 번호

를 선택한다.

해당되지 않는 운영체제를 선택하는 경우는 다시 선택하라는 메시지가 나오게 된다. 설치의 중단은 언제든지 ctrl+c 를 누르

면 된다.

Page 17: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

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

please.

o Choose Operating System of your Server!

1) Compaq-Alpha(Tru64 V4.0 or V5.0)

2) HP_PA-RISK(HP-UX 10.x or 11.x 32bit)

3) HP_PA-RISK(HP-UX 11.x 64bit)

4) IBM(AIX 4.2 or 4.3 32bit)

5) IBM(AIX 4.3 64bit)

6) Linux_x86 (RedHat 6.0 or higher 32bit)

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

8) Sun_SPARC (Solaris 2.7 or 2.8 64bit)

9) Quit

Select : 1

32 bit 와 64 bit 가 모두 지원되는 운영체제의 경우 확답의 여부를 묻

게 된다. 역시 y 를 확인하고 선택한다.

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

WebtoB 설치 디렉토리 설정

WebtoB 를 설치할 디렉토리의 절대 경로를 지정한다.

인스톨러가 권장하는 path 와 무관하게 자신이 원하는 곳을 지

정하면 된다. 단, 반드시 절대 경로를 써 주어야 하며, 계정의 권한이 없는 곳을 지정하는 경우는 설치가 중단된다. Directory 는 미리 만들어 두어야 할 필요는 없으며, write 권한만 있다면 인스톨러가 자동으로 path 를 만들어 설치한다.

WebtoB Installation Guide 16

o Enter the installation path of the JDK !

ex) /user1/choco/webtob

Input -> /user1/choco/webtob______________

Checking directory '/user1/choco/webtob' :

/user1/choco/webtob is made

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

( Press Ctrl-C to quit )

Page 18: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 17

만약 WebtoB 를 설치한 directory 가 존재하는 경우 다음과 같은 메시

지가 나온다. 인스톨시에 비정상적으로 종료될 경우 인스톨시 생성된 data 을 삭제하기 때문에 이와 같이 설치 이전에 direcotry 가 존재하는 경우 그 해당 directory 에 data 가 함께 삭제될 우려가 있다. 따라서 WebtoB 설치 directory 명을 바꾸어 주는 것이 좋다.

o Enter the installation path of the WebtoB !

ex) /home/choco/webtob

Input -> /home/choco/webtob_______________

Checking directory '/home/choco/webtob' : OK

This directory already exists!!!

It is possible that this directory and existing data can be

deleted

by the abnormal termination of installation.

Are you sure to install this directory? [y/n] : n

만약 위의 설정값을 y 로 입력하면 현재 지정된 설치 directory 에 WebtoB 를 설치하고 n 이라는 값으로 설정하면 새로운 WebtoB 설치 directory path 를 입력한다.

Resetting the installation path of the WebtoB !

Input -> /home/choco/webtob1_________________________________

path 를 지정해 주고나면 설치가 시작된다. 부적합한 경로를 지정한 경

우가 아니라면, 아래와 같은 화면이 나오면서 자동으로 설치가 완료된

다.

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

Step 1 : Making directories and Copying files

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

WebtoB core file is copied successfully... OK

WebtoB sample files are copied successfully... OK

Extracting WebtoB Core....

x bin, 0 bytes, 0 테이프 블록

x bin/wsm, 156048 bytes, 305 테이프 블록

x bin/wsm.dbg, 158212 bytes, 310 테이프 블록

x bin/htl, 71968 bytes, 141 테이프 블록

x bin/hth, 273000 bytes, 534 테이프 블록

Page 19: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

...

x bin/hth.dbg, 286656 bytes, 560 테이프 블록

x template/license/ncpu.hp, 20536 bytes, 41 테이프 블록

x template/license/ncpu.linux, 3836 bytes, 8 테이프 블록

x template/license/ncpu.solaris, 6272 bytes, 13 테이프 블록

WebtoB Directory 구성 및 예상되는 동시 접속자수 설정에 따른 환경 파일 작성

WebtoB 인스톨시 동시 접속자 수를 설정함으로써 임의의 적합

한 WebtoB 환경 파일(sample.m)과 차후에 WebtoB Servlet Engine을 함 께 설 치 할 경 우 WebtoB Servlet Engine 환 경 파 일

(container.xml)을 동적으로 생성해 줄 때 적절한 설정값들을 정

해준다.

WebtoB Installation Guide 18

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

Step 2 : Generating and configuring WebtoB sample config file

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

o Select one of the following :

1. Total user number of concurrent connection(1~800)

2. Total user number of concurrent connection(800~1500)

In case users are over the 15000, you can modify

configuration file by yourself!!

Select Product : 1

Copying sample.m to /user1/choco/webtob/config directory....

OK

인스톨시에는 예상되는 동시 접속자 수를 고려하여 메뉴를 선

택한다. 이때 생성되는 환경 파일의 설정값들은 사용자 시스템

의 성능이나 제공하고자 하는 서비스의 종류와 규모에 따라 다

소 차이가 있을 수 있다. 따라서 사용자들은 이점을 고려하여 차후에 환경파일을 적절히 수정하도록 권장한다. 또한 예상되

Page 20: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

는 동시 접속자의 수가 1500 명이상의 경우에도 사용자 직접 환경파일을 수정해 주어야 한다.

WebtoB 만 설치할 경우

WebtoB 설치시 동시에 WebtoB Servlet Engine 의 설치 여부를 정

할 수 있다. WebtoB 만을 설치할 경우 아래의 물음에 n 이라는 값으로 입력한다.

WebtoB Installation Guide 19

o Would you like to install Servlet Engine? [y/n] : n

WebtoB directory structure

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

+- bin

|- lib

|- usrinc

|- ap

|- config

WEBTOBDIR-+- path

|- license

| +- syslog

|- log -|- txlog

| +- usrlog

|- svct

+- docs

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

Step 3 : Adjusting Permissions

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

Changing Mode :

Adjusting permission to '0755', '/user1/choco/webtob/bin' : OK

Adjusting permission to '0755', '/user1/choco/webtob/lib' : OK

Adjusting permission to '0755', '/user1/choco/webtob/usrinc' :

OK

Adjusting permission to '0755', '/user1/choco/webtob/config' :

OK

Adjusting permission to '0755', '/user1/choco/webtob/svct' : OK

Page 21: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

Adjusting permission to '0755', '/user1/choco/webtob/license' :

OK

Adjusting permission to '0755', '/user1/choco/webtob/path' : OK

Adjusting permission to '0755', '/user1/choco/webtob/bin/*' : OK

Adjusting permission to

'0644','/user1/choco/webtob/config/sample.m' : OK

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

WebtoB installation is completed successfully.

WebtoB environment variables have been added to your account's

scripts(.cshrc and .profile). Before testing the Tmax, justapply

the script in the home directory.

# C shell

source .cshrc

# Bourne/Korn Shell

. ./.profile

Thank you for using WebtoB Product!

Technical support center

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

E-mail : [email protected]

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

위와 같은 화면이 보인다면 WebtoB 설치가 성공적으로 완료된 것이다.

WebtoB Installation Guide 20

WebtoB Servlet Engine 을 함께 설치할 경우

WebtoB 설치시 동시에 WebtoB Servlet Engine 의 설치 여부를 정

할 수 있다. WebtoB 설치시 WebtoB Servlet Engine 을 함께 설치

하고자 할 경우 아래의 물음에 y 라는 값으로 설정한다.

o Would you like to install Servlet Engine? [y/n] : y

Page 22: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Servlet Engine 을 설치할 패키지 선택

그 다음, 아래의 화면이 출력되고, 원하는 패키지의 번호를 입

력하고 Enter 를 누른다.

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

Step 3 : JDK Path Setting

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

Your JDK Version is 1.3

o Select one of the following :

1. J2EE(TM) 1.2 Extension for jdk 1.3

2. J2EE(TM) 1.2 Extension for jdk 1.2

3. Quit Installation Program

Select Product : 1

WebtoB Installation Guide 21

JDK Path 의 입력

아래의 화면에서 Current JDK_PATH 로 제시된 경로는 JDK 가 설치된 경로가 아니고, java 실행화일의 경로를 표시하는 것이

다. 위의 경로와 동일하게 입력할 경우, 경로가 잘못되었다는 메시지를 표시하고 설치가 종료되기 때문에, /j2se 까지만 입력

해야 한다. ( ex : /usr/j2se )

o Enter the installation path of the JDK !

Input Sample) /usr/j2se

Current JDK_PATH = /usr/j2se

Input -> /usr/j2se____________

Checking directory '/usr/java130' : OK

JDK Directory Check Success!!!

만일 , 정상적으로 입력한 경우에도 “Java virtual machine not found” 라는 에러메시지가 출력될 경우, USER 의 Home 디렉토

리로 이동하여 .cshrc 파일을 열어서 LD_LIBRARY_PATH(HP 이 외 ) : ${LD_LIBRARY_PATH} SHLIB_PAHT(HP Machine) : ${ SHLIB_PATH }가 설정되어 있는가 확인하고, 존재하지 않는 경로가 지정되어 있는 경우, 삭제한 뒤, 로그아웃 한 뒤, 다시 로그인 하고 처음부터 다시 설치한다.

Page 23: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

파일복사

WebtoB 설치 디렉토리 밑에 jeus 라는 이름의 디렉토리가 만들

어 지고 그곳으로 필요한 파일이 복사된다. 시스템 상황에 따

라 늦어질 수 있다.

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

Step 4 : Making directories and Copying files "

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

Extracting Servlet Engine File....

x InstallTemp, 0 bytes, 0 테이프 블록

x InstallTemp/-CstOut.gif, 26 bytes, 1 테이프 블록

x InstallTemp/chmod.sh, 35 bytes, 1 테이프 블록

x InstallTemp/chscript.sh, 52 bytes, 1 테이프 블록

x webhome/servlet_home/webapps/WEB-INF, 0 bytes, 0 테이프 블록

x webhome/servlet_home/jspwork, 0 bytes, 0 테이프 블록

x workspace, 0 bytes, 0 테이프 블록

JEUS core file is copied successfully... OK

WebtoB Installation Guide 22

Password 입력

WebtoB Servlet Engine Security 관련한 7 자이상의 문자로 이루어

진 Password 입력한다.

====================================================== Step 5 : JEUS Security Setting ======================================================

o Enter Password of Administrator The minimum password length is 7 characters ex) jeusadmin Input -> Checking Password..... Conferm -> Checking Password..... Checking OK...

만일, 패스워드가 7 자미만이거나 두개의 패스워드가 일치하지 않을 경우, 처음부터 다시 입력을 해야 한다.

Page 24: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

설치 완료

WebtoB Installation Guide 23

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

Step 6 : Generating and configuring Servlet Engine sample

config file

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

Copying JeusMain.xml to /user1/choco/webtob/jeus/config/tmaxs1

directory.... OK

Copying file_realm.xml to

/user1/choco/webtob/jeus/config/tmaxs1 directory.... OK

Copying container.xml to

/user1/choco/webtob/jeus/config/tmaxs1_servlet_engine1

directory.... OK

WebtoB directory structure

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

+- bin

|- lib

|- usrinc

|- ap

|- config

WEBTOBDIR-+- path

|- license

| +- syslog

|- log -|- txlog

| +- usrlog

|- svct

|- docs

| +- bin

| |- classes

| |- config

+- jeus-|- lib

|- logs

|- webhome

+- workspace

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

Step 7 : Adjusting Permissions

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

Page 25: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 24

Changing Mode :

Adjusting permission to '0755', '/user1/choco/webtob/bin' : OK

Adjusting permission to '0755', '/user1/choco/webtob/lib' : OK

Adjusting permission to '0755', '/user1/choco/webtob/usrinc' :

OK

Adjusting permission to '0755', '/user1/choco/webtob/config' :

OK

Adjusting permission to '0755', '/user1/choco/webtob/svct' : OK

Adjusting permission to '0755', '/user1/choco/webtob/license' :

OK

Adjusting permission to '0755', '/user1/choco/webtob/path' : OK

Adjusting permission to '0755', '/user1/choco/webtob/bin/*' : OK

Adjusting permission to '0755',

'/user1/choco/webtob/jeus/bin/*' : OK

Adjusting permission to '0755',

'/user1/choco/webtob/jeus/lib/system/*.so' : OK

Adjusting permission to '0755', '/user1/choco/webtob/jeus' : OK

Adjusting permission to '0644',

'/user1/choco/webtob/config/sample.m' : OK

=========[ Installation is completed uccessfully ]=============

WebtoB and Servlet Engine installation is completed successfully.

WebtoB environment variables and Servlet Engine environment

variables

have been added to your account's scripts(.cshrc and .profile).

Before

testing the Tmax, justapply the script in the home directory.

# C shell

source .cshrc

# Bourne/Korn Shell

. ./.profile

Thank you for using WebtoB Product!

Technical support center

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

E-mail : [email protected]

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

Page 26: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

위와 같은 화면이 보인다면 WebtoB 와 WebtoB Servlet Engine 설치가 성공적으로 완료된 것이다.

기본적으로 인스톨러는 각 시스템의 환경 파일에 환경 변수를 자동으

로 등록해 준다. 먼저 시스템 환경 파일에 환경 변수를 등록하기 전에 그 시스템 의 환경 파일을 profile_wbbk_생성날짜 형태의 파일 이름으

로 backup 을 해 놓은 후에 WebtoB 만 설치할 경우 WebtoB 가 필요로 하는 환경변수만을 설정해주고, WebtoB Servlet Engine 을 함께 인스톨 시에는 WebtoB Servlet Engine 가 필요로 하는 환경 변수도 같이 등록해 준 다 . 유 의 할 점 은 WebtoB Servlet Engine 환 경 변 수 중 에 LD_LIBRARY_PATH 는 HP system 인 경우에는 SHLIB_PATH 의 환경 변수 이름으로 변환 되어서 설정된다.

환경변수가 등록된 .profile, .bash_profile 의 예

### WebtoB Environment ###

WEBTOBDIR=/user1/choco/webtob; export WEBTOBDIR

PATH=/user1/choco/webtob/bin:$PATH:.; export PATH

### Using WebtoB Shared Library for WBAPI ###

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$WEBTOBDIR/lib; export

LD_LIBRARY_PATH

######## JEUS Environment ########

W2B_JEUSHOME=/user1/choco/webtob/jeus; export W2B_JEUSHOME

W2B_SERVLETHOME=$W2B_JEUSHOME/webhome/servlet_home; export

W2B_SERVLETHOME

W2B_JDKHOME=/usr/j2se; export W2B_JDKHOME

PATH=$W2B_JDKHOME/bin:$W2B_JEUSHOME/bin:$PATH:.; export PATH

W2B_S_BASEPORT=9736; export W2B_S_BASEPORT

## Using Tmax Shared Library ##

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$W2B_JEUSHOME/lib/system;

export LD_LIBRARY_PATH

환경변수가 등록된 .cshrc 의 예

WebtoB Installation Guide 25

######## WebtoB Environment ########

setenv WEBTOBDIR /user1/choco/webtob

set path=($path /user1/choco/webtob/bin .)

### Using WebtoB Shared Library for WBAPI ###

Page 27: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

setenv LD_LIBRARY_PATH /user1/choco/webtob/lib

######## JEUS Environment ########

setenv W2B_JEUSHOME /user1/choco/webtob/jeus

setenv W2B_SERVLETHOME $W2B_JEUSHOME/webhome/servlet_home

setenv W2B_JDKHOME /usr/j2se

setenv path=($W2B_JDKHOME/bin $W2B_JEUSHOME/bin $path .)

setenv W2B_S_BASEPORT 9736

### Using Tmax Shared Library ###

setenv LD_LIBRARY_PATH=($W2B_JEUSHOME/lib/system

$LD_LIBRARY_PATH)

환경변수가 등록된 .bashrc 의 예

######## WebtoB Environment ########

WEBTOBDIR=/home/choco/webtob

PATH=$PATH: /home/choco/webtob/bin

### Using WebtoB Shared Library for WBAPI ###

LD_LIBRARY_PATH=/home/choco/webtob/lib

export WEBTOBDIR PATH LD_LIBRARY_PATH

######## JEUS Environment ########

W2B_JEUSHOME=/home/choco/webtob/jeus

W2B_SERVLETHOME=$W2B_JEUSHOME/webhome/servlet_home

W2B_JDKHOME=/usr/j2se

PATH=$PATH:$W2B_JDKHOME/bin:$W2B_JEUSHOME/bin

W2B_S_BASEPORT=9736

### Using Tmax Shared Library ###

LD_LIBRARY_PATH=$W2B_JEUSHOME/lib/system

export W2B_JEUSHOME W2B_SERVLETHOME W2B_JDKHOME PATH

W2B_S_BASEPORT LD_LIBRARY_PATH

WebtoB Installation Guide 26

환경변수의 적용

Page 28: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

기본적으로 WebtoB 인스톨이 정상적으로 종료되면 수정된 시스템 환경 파일이 적용이 될 수 아래 같은 Command Line 을 실행하거나 logout 후 login 하는 것을 권장한다.

C shell 의 경우 $ source .cshrc

Korn shell 의 경우 $ . ./.profile

Bash Shell 의 경우 $ . ./.bashrc

정상적으로 설치가 진행되었다면, 실제 수행을 위하여 License 파일을 받아야 한다. 제품 License 는 ㈜티맥스소프트에서 발급하며, 정식과 데모버전 두 가지 종류로 나뉜다.

Note : WebtoB 설치가 성공적으로 이루어진 다음에 WebtoB Servlet Engine 설치가 실패하였을 경우 이전에 설치된 WebtoB 를 삭제하도록 하였다. WebtoB 와 WebtoB Servlet Engine 을 함께 인스톨시 도중에 실

패를 하면 다시 인스톨 스크립트를 수행시켜 인스톨 과정을 다시 하면 된다.

3.2.3 CD-ROM 으로 설치(GUI)

Solaris, HP, Compaq, AIX 에서 이루어지는 WebtoB 설치 과정은 동일하

며, 설치시 화면 구성은 Windows 설치 때와 동일하다. 모두 설치 툴을 이용하여 설치한다.그러나 UNIX 에서 설치 툴을 이용하기 위해서는 자바 기반의 GUI 환경을 지원하는 콘솔 혹은 터미널이 설치되어 있어

야만 한다.

WebtoB CD-ROM(GUI)을 통하여 설치하는 방법은 다음과 같다.

CD 를 CD-ROM 에 넣는다.

CD-ROM 을 Mount 한다.

CD 안에 WebtoB UNIX GUI 설치파일(OS_name.bin)이 존재하는지 확인한다.

WebtoB Installation Guide 27

설치의 시작

Page 29: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

지금부터 AIX Machine 에 WebtoB 를 설치해 보도록 하겠다. Ibm32.bin 를 Double Click 한다. 설치 명령 파일인 Ibm32.bin 을 실행시키면 다음과 같이 WebtoB 설치 메인 화면이 나오며, 이

것으로 WebtoB 설치 툴이 정상적으로 기동 된 것을 확인 할 수 있다.

Introduction 화면

설치를 계속할지 여부를 묻는 창이 나타나면 NEXT 를 누른다.

WebtoB Installation Guide 28

다음은 설치시 간략한 주의 사항을 다루고 있다.

Page 30: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB 를 설치하기 전에 실행중인 모든 프로그램을 종료한다.

Exit 버튼 : 설치 프로그램을 즉시 종료한다.

Next 버튼 : 현재 화면의 입력을 완료하고 다음 화면으로 넘어간다.

Previous 버튼 : 전 화면으로 이동한다.

위의 사항은 WebtoB 의 설치 툴이 종료할 때까지 동일하게 적용된다. 특히 안전한 설치를 위해서 WebtoB 이외의 실행 중인 Program 을 종료하기 바란다. 계속 진행하기를 선택하면 License 동의 여부를 묻는 화면이 나온다.

License Agreement 화면

아래와 같은 License 계약의 창이 뜨면, 그 내용을 잘 읽어본 후 동의하는 경우에 한해 YES 를 선택한다. NO 를 선택하면 더 이상 install 이 진행되지 않는다.

Next 버튼을 선택하면 WebtoB 를 설치할 디렉토리를 선택하는 화면이 나타난다.

WebtoB Installation Guide 29

설치 디렉토리 선택화면

Page 31: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

프로그램이 설치될 경로를 지정하는 화면이다. ( Default 권장 )

Default 로 System Root Directory 에 “webtob”이란 이름으로 설정

되어 있다.

다른 디렉토리로 변경하기 위해서는 Choose 버튼을 눌러 새로운 디렉토리를 선택한 후 Select 버튼을 누른다.

Restore Default Location : 설치 디렉토리를 기본 디렉토리로 설정한다.

Choose : 설치 디렉토리를 변경하기위해 디렉토리 선택 대

화창을 만든다.

기본 디렉토리로 선택을 완료하고 Install 버튼을 누르면 Install Set 선택 화면이 나타난다.

WebtoB Installation Guide 30

Install Set 선택화면

Page 32: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB 설치 프로그램은 WebtoB Servlet Engine, WebtoB 두개의 Install Set 을 가지고 있으며, 한 개의 Install Set 만을 선택할 수 있다. 각 Install Set 의 특성은 다음과 같다.

다른 디렉토리로 변경하기 위해서는 Choose 버튼을 눌러 새로운 디렉토리를 선택한 후 Select 버튼을 누른다.

WebtoBServlet engine WebtoB 와 함께 WebtoB Servlet Engine 을 설치한다.

WebtoB WebtoB 만 설치한다.

만약 WebtoB 만 설치할 경우 WentoB 를 선택하고 Next 버튼을 누르면 configuration file 설정에 필요한 정보를 입력한다.

WebtoB Installation Guide 31

설치 진행 화면

Page 33: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

파일의 복사 과정을 나타내는 화면이다. 설치를 중단하고 싶으

면 대화상자의 Exit 버튼을 선택한다. 그러나 제거 툴의 설치가 완료되었는지 알 수 없으므로 제거 툴의 정상적인 동작을 보장

할 수 없다. 가능한 설치를 완료한 후 제거 툴을 이용하여 제

거하기를 권장한다. 이 설치 진행 화면은 시스템 상황에 따라 수분이 소요될 수 있으므로 중간에 Exit 하는 일이 없도록 한다.

WebtoB Installation Guide 32

동시접속자수 입력

인스톨시에는 1~1500 명 사이의 예상되는 동시 접속자 수를 고

려하여 값을 입력한다. 따라서 1500 명이상의 경우에는 사용자 직접 환경파일을 수정해 주어야 한다.

Page 34: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

입력되는 동시 접속자 수 정보를 참조하여 WebtoB 환경파일

(sample.m)에 적절한 값을 설정하여 환경파일을 생성한다.

이때 생성된 환경 파일의 설정값이 각 사용자의 시스템 환경

이나 서비스 종류와 규모에 따라 적절하지 않을 수도 있으므로 차후에 사용자들이 이점을 고려하여 차후에 환경파일을 적절히 수정하도록 권장한다.

Next 버튼을 누르면 설치 완료 화면이 나타난다.

WebtoB Installation Guide 33

설치 완료 화면

Page 35: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

설치 과정 중 추가한 환경변수를 시스템에 반영하기 위해 재부팅을 요구하는 화면이 나온다. 설치과정이 완료된 후에는 반드시 System 에서 Log out 또는 재 기동하거나, profile 을 실행해서 환경변수를 System 에 반영하도록 한다. 이로써 WebtoB 의 설치 과정이 완료된 것이다.

WebtoB Installation Guide 34

WebtoB Servlet Engine 설치 여부 설정(WebtoB 와 WebtoB Servlet Engine 를 함께 설치할 경우)

Page 36: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Servlet Engine 설치를 선택하고 Install 버튼을 누르면 configuration file 설정에 필요한 정보를 입력한다.

WebtoB Installation Guide 35

JDK version 선택화면

Page 37: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB 설치 프로그램은 J2EE™ 1.2 Extention for jdk1.3, J2EE™ 1.2 Extention for jdk1.3 두개의 Install Set 을 가지고 있으며, 한 개의 Install Set 만을 선택할 수 있다. 각 Install Set 의 특성은 다

음과 같다.

JDK 1.3 WebtoB 와 함께 Java Version 1.3.0 과 호환성을 갖춘 WebtoB Servlet Engine 을 설치한다.

JDK 1.2 WebtoB 와 함께 Java Version 1.2.2 와 환성을 갖춘 WebtoB Servlet Engine 을 설치한다.

WebtoB Installation Guide 36

동시접속자수 입력

인스톨시에는 1~1500 명 사이의 예상되는 동시 접속자 수를 고

려하여 값을 입력한다. 따라서 1500 명이상의 경우에는 사용자 직접 환경파일을 수정해 주어야 한다.

Page 38: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

입력되는 동시 접속자 수 정보를 참조하여 WebtoB 환경파일

(sample.m)과 WebtoB Servlet Engine 환경파일(container.xml)에 적

절한 값을 설정하여 환경파일을 생성한다.

이때 생성된 환경 파일의 설정값이 각 사용자의 시스템 환경

이나 서비스 종류와 규모에 따라 적절하지 않을 수도 있으므로 차후에 사용자들이 이점을 고려하여 차후에 환경파일을 적절히 수정하도록 권장한다.

Next 버튼을 누르면 WebtoB Servlet Engine 환경을 설정하기 위한 대화상자가 나타난다.

WebtoB Installation Guide 37

Password 입력화면

WebtoB Servlet Engine 기동 시에 입력하게 될 administrator 의 Password 를 입력 한다. 타당성 Check 를 행한 후 맞으면 다음 화면으로 틀린 경우는 재입력을 요구하는 메세지를 내보낸다. 이 Password 는 WebtoB Servlet Engine 기동시 계속적으로 사용하게 되므로 반드시 기억해야 할 필요가 있다.

Page 39: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

Next 버튼을 누르면 Java 의 설치 디렉토리를 확인하는 화면이 나온다.

WebtoB Installation Guide 38

Java 설치 디렉토리 확인 화면

이 화면에서 선택한 디렉토리는 W2B_JDKHOME 이라는 환경변수로 등록이 되고 WebtoB Servlet Engine server 의 기동에 영향을 미치게 된다. 만약 사전에 Java 를 설치하지 않았다면 일단 설치를 중단하고 Java 를 설치한 후 WebtoB Servlet Engine 을 재 설치하는 방법과 WebtoB Servlet Engine 설치 완료 후 W2B_JDKHOME 이라는 환경변수를 수정하는 방법이 있다. 설치 툴에서는 후자의 방법을 권장하고 있다

Page 40: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

Next 버튼을 누르면 설치 완료 화면이 나타난다.

WebtoB Installation Guide 39

설치 완료 화면

Page 41: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

설치 과정 중 추가한 환경변수를 시스템에 반영하기 위해 재부

팅을 요구하는 화면이 나온다. 설치과정이 완료된 후에는 반드

시 System 에서 Log out 또는 재 기동하거나, profile 을 실행해

서 환경변수를 System 에 반영하도록 한다. 이로써 WebtoB 와 WebtoB Servlet Engine 의 설치 과정이 완료된 것이다.

WebtoB Installation Guide 40

3.2.4 License 등록

Solaris, HP, Compaq, AIX 에서 이루어지는 WebtoB 설치 과정은 동일하며, 설치시 화면 구성은 Windows 설치 때와 동일하다. 모두 설치 툴을 이용하여 설치한다.그러나 UNIX 에서 설치 툴을 이용하기 위해서는 자바 기반의 GUI 환경을 지원하는 콘솔 혹은 터미널이 설치되어 있어야만 한다.

Tmax Soft License Center

[email protected] (Demo License 요청)

forum.tmax.co.kr (Devloper`s Community & Download Service)

Tel: +82-2-6288-2114

Page 42: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

License 파일을 WebtoB 가 설치된 곳의 license 디렉토리에 복사한 뒤 실제 환경파일 컴파일 과정을 거치면, 이제 WebtoB 를 운영할 수 있게 된다.

이 License File 이 없으면 WebtoB Web Server 를 이용하여 어떠한 작업

도 불가능하다. 따라서, 반드시 Tmax Soft 의 허가를 통하여 발급된 License File 을 보관하기 바란다.

Note : License 파일은 제공받은 이름과 무관하게 반드시 license.dat 라

는 이름으로 WEBTODDIR/license 에 위치하여야 한다. 만약 Tmax Soft로 부터 받은 라이센스 파일명이 license.webtob-30_demo 라고 가정하면, 이 파일을 license.dat 로 변경하여 사용한다.

WebtoB Installation Guide 41

3.2.5 WebtoB Upgrade/Patch 방법

WebtoB 를 새로운 버전으로 업그레이드 또는 패치를 하기 위해서는 ㈜티맥스소프트로부터 제공되는 파일을 받아 단순히 압축을 풀어 적

용시킬 수가 있다.

업그레이드/패치 파일은 ㈜티맥스소프트에서 제공하며 본사 홈페이지

를 통해 다운로드 받거나 Email 로 전송 받을 수 있다.

파일은 [OSname].tar.Z 형식의 이름으로 압축되어 있으며, HP 64 비트용 WebtoB 라고 했을 때, hp64.tar.Z 와 같다. 이 이름은 언제든지 다른 이름으로 변경될 수 있으므로 참고하기 바란다.

다운로드 받은 파일을 WebtoB 가 설치되어 있는 디렉토리로 위치시킨 후, 압축을 풀어주면 된다. 이때 WebtoB 는 ‘wsdown’ 명령으로 실행을 중지시켜야 한다.

zcat hp64.tar.Z | tar xvf – 또는

uncompress hp64.tar.Z

tar xvf hp64.tar

압축을 풀었으면 WebtoB Configuration File 을 다시 컴파일 시킨 후 WebtoB 를 기동시킨다.

wscfl –i sample.m

wsboot

Page 43: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

4 WebtoB 의 실행

WebtoB Installation Guide 42

4.1 환경설정

WebtoB 의 모든 설치 과정이 문제 없이 수행되었다면 , 사용자는 WebtoB 가 설치된 곳에 config/ 라는 directory 가 존재함을 확인 할 수 있을 것이다.

이 directory 내에서 WebtoB 의 환경을 설정하는 File 을 생성하고 compile 한다. WebtoB 를 설치하면 기본적으로 이 directory 내에 예제로 이용할 수 있도록 manual.m 을 제공한다. 이 File 을 이용하여 필요한 부분을 설정해 나가면 된다. 사용자가 입력한 기본정보를 바탕으로, WebtoB 가 boot 할 수 있도록 설정된 가장 기본적인 환경파일도 자동

으로 생성되어 제공되며, 이 파일의 이름은 sample.m 이다. WebtoB 에 익숙하지 않은 사용자라면 manual.m 을 참고하여 sample.m 의 기능

을 추가해 나가면 된다.

manual.m 의 내용은 다음과 같다.

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

#

# webtob sample configuration file.

#

# This file supports all of the functions for webtob.

#

#

# If you want to get more information,

# please, refer to the Webtob Administrator's Guide.

#

# If you have some question, please send e-mail to us.

#

# [email protected]

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

*DOMAIN

webtob

Page 44: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 43

*NODE

www WEBTOBDIR = "/usr/local/webtob",

SHMKEY = 69000,

DOCROOT = "/usr/local/webtob/docs",

AppDir = "/usr/local/webtob/ap",

HostName = "www.tmax.co.kr",

PORT = "80",

JSVPort = 9999,

HTH = 1,

SSLNAME = Y,

SSLNAME = "ssl1",

NodePort = 7777,

RacPort = 3333,

Timeout = 300,

ClichkIntval = 30,

CacheSize = 128,

CacheEntry = 128,

KeepAliveTimeout = 60,

KeepAliveMax = 9999,

IndexName = "index.html",

Options = "+Index",

ErrorDocument = "403, 404",

DirIndex = "fancy",

Logging = "log1",

ErrorLog = "log2",

SysLogDir = "/usr/local/webtob/log/syslog",

EnvFile = webtob_env,

Method = "GET,POST,HEAD",

LanguagePrio = "kr",

Admin = "[email protected]",

Listen = "192.168.0.1:5469,192.1.1.9:5469"

*VHOST

vhost1 DOCROOT="/usr/local/webtob/docs/vshot_docs",

NODENAME = www,

HOSTNAME = "www2.tmax.co.kr",

HOSTALIAS = "www?.tmax.co.kr",

PORT = "8080",

Listen = "192.168.0.1:5469",

Admin = "[email protected]",

Page 45: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 44

AppDir = "/usr/local/webtob/vhost/ap",

UsrLogDir = "/usr/local/webtob/vhost/log/usrlog",

UserDir = "/usr/local/webtob/vhost",

EnvFile = webtob_env,

IndexName = "test.html",

LOGGING = "log1"

*SVRGROUP

htmlg NODENAME = www, SVRTYPE = HTML

cgig NODENAME = www, SVRTYPE = CGI

jsvg NODENAME = www, SVRTYPE = JSV

ssig NODENAME = www, SVRTYPE = SSI

phpg NODENAME = www, SVRTYPE = PHP,

ScriptLoc = "/cgi-bin/php"

wbapg NODENAME = www, SVRTYPE = WEBSTD

tpsvg NODENAME = www, SVRTYPE = TPSTD,

DBNAME = ORACLE,

OPENINFO = "Oracle_XA+Acc=P/scott/tiger+SesTm=60",

TMSNAME = tms_ora, MINTMS = 2, MAXTMS = 4

*SERVER

html SVGNAME = htmlg, MinProc = 1, MaxProc = 5

cgi SVGNAME = cgig, MinProc = 1,

MaxProc = 5, SvrCPC = 4

ssi SVGNAME = ssig, MinProc = 1, MaxProc =2

php SVGNAME = phpg, MinProc = 1, MaxProc =2

jsv1 SVGNAME = jsvg, MinProc = 1, MaxProc = 10

wbaps SVGNAME = wbapg, MinProc = 2, MaxProc = 5

tpsvr SVGNAME = tpsvg, MinProc = 2, MaxProc = 5

*SERVICE

tpsvc SVRNAME = tpsvr

example SVRNAME = wbaps

write_board SVRNAME = wbaps

*DIRECTORY

dir1 DIRECTORY = "/usr/local/webtob/docs/vhost_docs",

ForceMimetype = "CGI"

*URI

uri1 URI = "/cgi-bin/", SVRTYPE = CGI

Page 46: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

uri2 URI = "/examples/", SVRTYPE = JSV

*ALIAS

alias1 URI = "/cgi-bin/",

REALPATH = "/usr/local/webtob/cgi-bin/"

*DIRINDEX

fancy OPTIONS = "FANCY"

*LOGGING

log1 FORMAT = "DEFAULT",

FILENAME = "/usr/local/webtob/log/access.log",

Option = "sync"

log2 FORMAT = "ERROR",

FILENAME = "/usr/local/webtob/log/error.log",

Option = "sync"

*AUTHENT

authent1 TYPE = Basic,

USERFILE = "/usr/local/webtob/bin/pwfile"

*SSL

ssl1 CertificateFile =

"/usr/local/webtob/ssl/newreq.pem",

CertificateKeyFile =

"/usr/local/webtob/ssl/newreq.pem"

*ERRORDOCUMENT

403 Status = 403, URL=http://www.tmax.co.kr/403.html

404 Status = 404, URL=http://www.tmax.co.kr/404.html

WebtoB Installation Guide 45

*EXT

htm MIMETYPE = "text/html", SVRTYPE = HTML

any MIMETYPE = "text/html", SVRTYPE = CGI

jsp MIMETYPE = "test/jsp", SVRTYPE = JSV

Configuration 파일(manual.m)의 구성에 대한 자세한 설명은 WebtoB 관리자지침서 를 참조하기로 한다.

Page 47: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB 에서 기본적으로 설정해야 하는 절은 다음과 같다.

4.1.1 기본 항목

WebtoB 의 모든 설치 과정이 문제 없이 수행되었다면, 사용자는 WebtoB 가 설치된 곳에

config/ 라는 directory 가 존재함을 확인 할 수 있을 것이다.

4.1.1.1 DOMAIN Section

도메인 절에서는 여러 WebtoB 노드를 가질 수 있는 하나의 도메인 이

름을 정의하고, 시스템의 전반적인 환경을 정의한다.

Ex] Domain 절의 예

*DOMAIN

WebtoB1

각 항목에 대한 설명

Domain 을 WebtoB1 이라는 이름으로 하였다. 여기서의 Domain 이라 함은, 인터넷에서 사용하는 도메인 이름과는 전혀 무관하며, WebtoB 시스템에서 사용하는 하나의 영역 이름이라고 보면 된다.

4.1.1.2 NODE section

WebtoB 를 이루는 각 노드에 대한 환경설정이 이루어 진다. 이 Node절에서는 다음의 항목에 대한 정의가 이루어진다

공유 메모리 Key 값을 설정하는 ShmKey 값 설정

WebtoB Handler 의 개수

각종 디렉토리의 설정

WebtoB 가 설치된 디렉토리

서비스 할 문서의 디렉토리

응용 서버프로그램의 실행 파일들을 포함하는 디렉토리

로그 메시지가 저장될 디렉토리

WebtoB Installation Guide 46

환경설정 파일과 아이콘 파일의 디렉토리

Page 48: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

Ex] Node 절의 예

*NODE

webtob WEBTOBDIR="/usr/local/webtob",

HTH = 2,

SHMKEY=89000,

DOCROOT="/usr/local/webtob/docs",

PORT="80",

각 항목에 대한 설명

WEBTOBDIR : WebtoB 가 설치된 Drectory

HTH : WebtoB 의 주기능을 담당하는 HTH 개수 지정

SHMKEY : WebtoB Shared Memory 의 Key 값 설정

DOCROOT : html 문서가 있는 Directory

PORT : Web Server Listen port (Default Value = 80)

Ex) PORT = “8080”

4.1.1.3 SVRGROUP section

WebtoB 를 통해 응용 서버 프로세스를 접근하는 경우, 서버 프로세스

의 논리적인 연관성에 따라 이들을 그룹으로 관리할 필요가 있게 된

다. 이 절에서는 다음의 항목들에 대한 설정을 한다.

노드 이름

서버그룹의 형태

WebtoB Installation Guide 47

Ex] Server Group 절의 예

*SVRGROUP

htmlg NODENAME = www, SvrType = HTML

cgig NODENAME = www, SvrType = CGI

ssig NODENAME = www, SvrType = SSI

각 항목에 대한 설명

NODENAME : 각 server group 에 대한 Node 이름

SvrType : 각 server group 에 대한 server 형태

Page 49: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

4.1.1.4 SERVER section

응용 서버 프로세스를 등록한다. 각각의 서버는 서비스 종류에 따라 HTML, CGI, JSV 등으로 구분된다. 이 절에서는 다음의 항목들을 정의

한다.

서버그룹 이름과 실행 가능한 프로세스의 개수

WebtoB Installation Guide 48

Ex] Server 절의 예

*SERVER

html SVGNAME = htmlg, MinProc = 1, MaxProc = 2

cgi SVGNAME = cgig, MinProc = 1, MaxProc = 2

ssi SVGNAME = ssig, MinProc = 1, MaxProc = 10

각 항목에 대한 설명

html : html 이라는 이름의 server 설정.

SVGNAME : server 가 속한 server group

MinProc : 처리할 수 있는 Process 의 최소 개수

(처음 WebtoB 기동시 생성될 프로세스 수)

MaxProc : 처리할 수 있는 Process 의 최대 개수

(추가 프로세스 생성시 제한할 최대 개수)

지금까지 언급한 것들은 WebtoB 의 시작을 위해 기본적으로 설정이 필요한 항목들이다. 이 외에도, WebtoB 에서 추가로 제공하는 많은 기능들을 이용하기 위해서는 다른 많은 항목들의 설정이 추가로 필요하게 된다.

다음 절에서는 추가로 설정할 항목들에 대한 간단한 소개를 할 것이

다.

WebtoB 환경설정에 대한 자세한 정보를 알고 싶다면, WebtoB 관리자

지침서 를 참조하기 바란다.

Page 50: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

4.1.2 추가 항목

4.1.2.1 VHOST section

Virtual Host 를 지원하기 위한 각종 환경 값을 설정한다. 이 VHOST 절

에서는 다음의 항목들을 정의 한다.

Virtual Host 에 해당하는 호스트 이름

서비스 문서 디렉토리 등

Ex] VHOST 절의 예

*VHOST

vhost1 DOCROOT="/www2/docs", NODENAME = www,

HOSTNAME = "www2.tmax.co.kr",

각 항목에 대한 설명

DOCROOT : 새로운 사이트의 웹 문서가 위치할 Directory 의 지정

NODENAME : vhost 를 위한 호스트 이름

HOSTNAME : vhost 를 위한 FQDN(Fully Qualified Domain Name)

4.1.2.2 SERVICE section

WebtoB 를 통해 Tmax 응용 프로세스를 바로 접근할 경우, 제공되는 서비스를 등록해야 한다. 이 절에서는 다음의 항목 등을 설정한다.

서버의 이름과 서비스의 이름을 설정

서비스 우선순위와 처리 제한 시간

4.1.2.3 DIRECTORY

노드내의 특정 디렉토리의 속성을 정하기 위한 환경설정을 한다. 디렉

토리 접근에 인증이 필요하도록 하는 AuthentName, 디렉토리 안의 파

일 확장명을 설정하는 ForceExt, DefaultExt 등이 있으며, 디렉토리 접근 내역을 기록하는 로그 등을 설정할 수 있다.

WebtoB Installation Guide 49

4.1.2.4 URI

클라이언트 요구를 URI 의 설정에 따라 처리하는 서비스를 구분하도

록 설정한다.

Page 51: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

4.1.2.5 ALIAS

실제 서버 안의 물리적인 디렉토리의 절대경로와 URI 를 alias 시키도

록 설정할 수 있다.

4.1.2.6 DIRINDEX

클라이언트가 요구한 index.html 과 같은 특정 화일이 존재하지 않는 경우, 전체 디렉토리 구조를 보여줄 수 있도록 설정한다. Indexing 하는 방식과 Icon 등을 지정할 수 있다.

4.1.2.7 LOGGING

클라이언트의 요구 내역을 기록하는 형식을 지정한다.

4.1.2.8 AUTHENT

클라이언트의 접근을 제한하기 위한 인증 과정을 유저와 그룹 단위로 통제할 수 있도록 설정한다.

4.1.2.9 EXT

클라이언트가 요구한 파일의 확장자 명에 따라 처리 담당 프로세스를 지정할 수 있다.

4.1.3 WebtoB 환경 파일의 Compile

WebtoB 가 제공하는 wscfl 이라는 유틸리티를 이용하면 환경파일을 compile 하여 웹서버 기동시에 실제 참조할 wsconfig 바이너리 파일이 생성 된다.

UNIX System 의 경우

EX] wscfl 의 수행

$wscfl –i sample.m

이 환경 File 에 대한 자세한 정보는 WebtoB 관리자지침서 에서 얻을 수 있다. 좀더 복잡한 환경 설정을 원하거나, WebtoB 의 다양한 기능을 사용하고 싶다면, WebtoB 관리자지침서 를 참조하기 바란다.

WebtoB Installation Guide 50

4.1.4 WebtoB 의 실행과 종료

위의 설치 및 환경 설정이 모두 완료 되면 이제 WebtoB 를 실행 할 수 있다. WebtoB 가 설치된 ‘bin’ directory 내에 있는 wsboot 라는 명령

어를 통하여 실행할 수 있다. WebtoB 의 종료는 wsdown 이라는 명령어

를 사용한다.

Page 52: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 51

EX] WebtoB 실행의 경우

$wsboot

EX] WebtoB 종료의 경우

$wsdown

Page 53: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

5 Windows NT/2000 의 WebtoB 설치

5.1 WebtoB 설치 전 주의사항

WebtoB 를 설치시 WebtoB Servlet Engine 를 함께 인스톨 할 경우에는 먼저 JDK 가 설치되어 있어야 한다.

따라서 이전에 JDK가 설치되어 있지 않으면 http://java.sun.com/j2se/1.3/ 사이트에서 자신의 시스템의 OS에 맞는 Java 2 SDK v1.3.0, Standard Edition을 download 하여 미리 설치해 두어야 한다. JDK version은 되도

TM

Java version 1.3.0(HopSpot Server 포함) 또는 version 1.2.2 이상 버전을 설치하도록 한다. 설치 후 반드시 JDK가 정상적으로 설치되었는지 확

인한다. 사용자 환경변수 중 PATH에 java 실행 모듈이 존재하는 bin 디렉토리를 추가한다.

Note : Java version 1.3.0 에서 WebtoB Servlet Engine 을 사용할 것을 권

장하고 있다.

5.2 CD-ROM 으로 설치(Windows)

WebtoB NT 버전은 installer 를 이용하여 여타의 윈도우 응용프로그램과 동일한 방법으로 간단히 설치할 수 있다.

CD 를 CD-ROM 에 넣는다.

CD-ROM 을 Mount 한다.

CD 안에 WebtoB Windows 설치파일(WebtoB.exe)이 존재하는지 확인한다.

설치의 시작

WebtoB Installation Guide 52

WebtoB.exe 를 Double Click 한다. 설치 명령 파일인 WebtoB.exe 실행시

키면 다음과 같이 WebtoB 설치 메인 화면이 나오며, 이것으로 WebtoB설치 툴이 정상적으로 기동 된 것을 확인 할 수 있다.

Page 54: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

Introduction 화면

WebtoB Installation Guide 53

설치를 계속할지 여부를 묻는 창이 나타나면 NEXT 를 누른다.

다음은 설치시 간략한 주의 사항을 다루고 있다.

Page 55: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB 를 설치하기 전에 실행중인 모든 프로그램을 종료한다.

Exit 버튼 : 설치 프로그램을 즉시 종료한다.

Next 버튼 : 현재 화면의 입력을 완료하고 다음 화면으로 넘어간다.

Previous 버튼 : 전 화면으로 이동한다.

위의 사항은 WebtoB 의 설치 툴이 종료할 때까지 동일하게 적용된다. 특히 안전한 설치를 위해서 WebtoB 이외의 실행 중인 Program 을 종료하기 바란다. 계속 진행하기를 선택하면 License 동의 여부를 묻는 화면이 나온다.

License Agreement 화면

WebtoB Installation Guide 54

아래와 같은 License 계약의 창이 뜨면 , 그 내용을 잘 읽어본 후 동의하는 경우에 한해 YES 를 선택한다. NO 를 선택하면 더 이상 install 이 진행되지 않는다.

Next 버튼을 선택하면 WebtoB 를 설치할 디렉토리를 선택하는 화면이 나타난다.

Page 56: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

설치 디렉토리 선택화면

프로그램이 설치될 경로를 지정하는 화면이다. ( Default 권장 )

Default 경로는 c:\webtob 이다.

다른 디렉토리로 변경하기 위해서는 Choose 버튼을 눌러 새로운 디렉토리를 선택한 후 Select 버튼을 누른다.

Restore Default Location : 설치 디렉토리를 기본 디렉토리로 설정한다.

Choose : 설치 디렉토리를 변경하기위해 디렉토리 선택 대

화창을 만든다.

WebtoB Installation Guide 55

기본 디렉토리로 선택을 완료하고 Install 버튼을 누르면 Install Set 선택 화면이 나타난다.

Page 57: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

Install Set 선택화면

WebtoB 설치 프로그램은 WebtoB Servlet Engine, WebtoB 두개의 Install Set 을 가지고 있으며, 한 개의 Install Set 만을 선택할 수 있다. 각 Install Set 의 특성은 다음과 같다.

WebtoBServlet engine WebtoB 와 함께 WebtoB Servlet Engine 을 설치한다.

WebtoB WebtoB 만 설치한다.

WebtoB Installation Guide 56

만약 WebtoB 만 설치할 경우 WentoB 를 선택하고 Next 버튼을 누르면 configuration file 설정에 필요한 정보를 입력한다.

Page 58: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

설치 진행 화면

파일의 복사 과정을 나타내는 화면이다. 설치를 중단하고 싶으면 대화상자의 Exit 버튼을 선택한다. 그러나 제거 툴의 설치가 완료되었는지 알 수 없으므로 제거 툴의 정상적인 동작을 보장할 수 없다. 가능한 설치를 완료한 후 제거 툴을 이용하여 제거하기를 권장한다. 이 설치 진행 화면은 시스템 상황에 따라 수분이 소요될 수 있으므로 중간에 Exit 하는 일이 없도록 한다.

동시접속자수 입력

WebtoB Installation Guide 57

인스톨시에는 1~1500 명 사이의 예상되는 동시 접속자 수를 고려하여 값을 입력한다. 따라서 1500 명이상의 경우에는 사용자 직접 환경파일

을 수정해 주어야 한다.

Page 59: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 58

입력되는 동시 접속자 수 정보를 참조하여 WebtoB 환경파일(sample.m)에 적절한 값을 설정하여 환경파일을 생성한다.

이때 생성된 환경 파일의 설정값이 각 사용자의 시스템 환경이나 서비스 종류와 규모에 따라 적절하지 않을 수도 있으므로 차후에 사용자들이 이점을 고려하여 차후에 환경파일을 적절히 수정하도록 권장한다.

Next 버튼을 누르면 설치 완료 화면이 나타난다.

Page 60: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

설치 완료 화면

WebtoB Installation Guide 59

설치 과정 중 추가한 환경변수를 시스템에 반영하기 위해 재부팅을 요구하는 화면이 나온다. 설치과정이 완료된 후에는 반드시 System 에서 Log out 또는 재 기동하거나, profile 을 실행해서 환경변수를 System 에 반영하도록 한다. 이로써 WebtoB 의 설치 과정이 완료된 것이다.

Page 61: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Servlet Engine 설치 여부 설정(WebtoB 와 WebtoB Servlet Engine 를 함께 설치할 경우)

WebtoB Servlet Engine 설 치 를 선 택 하 고 Install 버 튼 을 누 르 면 configuration file 설정에 필요한 정보를 입력한다.

JDK version 선택화면

WebtoB Installation Guide 60

Page 62: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB 설치 프로그램은 J2EE™ 1.2 Extention for jdk1.3, J2EE™ 1.2 Extention for jdk1.3 두개의 Install Set 을 가지고 있으며, 한 개의 Install Set 만을 선택할 수 있다. 각 Install Set 의 특성은 다음과 같다.

JDK 1.3 WebtoB 와 함께 Java Version 1.3.0 과 호환성을 갖춘 WebtoB Servlet Engine 을 설치한다.

JDK 1.2 WebtoB 와 함께 Java Version 1.2.2 와 환성을 갖춘 WebtoB Servlet Engine 을 설치한다.

동시접속자수 입력

WebtoB Installation Guide 61

인스톨시에는 1~1500 명 사이의 예상되는 동시 접속자 수를 고려하여 값을 입력한다. 따라서 1500 명이상의 경우에는 사용자 직접 환경파일을 수정해 주어야 한다.

입력되는 동시 접속자 수 정보를 참조하여 WebtoB 환경파일(sample.m)과 WebtoB Servlet Engine 환경파일(container.xml)에 적절한 값을 설정하여 환경파일을 생성한다.

이때 생성된 환경 파일의 설정값이 각 사용자의 시스템 환경이나 서

비스 종류와 규모에 따라 적절하지 않을 수도 있으므로 차후에 사용

Page 63: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

자들이 이점을 고려하여 차후에 환경파일을 적절히 수정하도록 권장

한다.

Next 버튼을 누르면 WebtoB Servlet Engine 환경을 설정하기 위한 대화상

자가 나타난다.

Password 입력화면

WebtoB Servlet Engine 기동 시에 입력하게 될 administrator 의 Password 를 입력 한다. 타당성 Check 를 행한 후 맞으면 다음 화면으로 틀린 경우는 재입력을 요구하는 메세지를 내보낸다. 이 Password 는 WebtoB Servlet Engine 기동시 계속적으로 사용하게 되므로 반드시 기억해야 할 필요가 있다.

Next 버튼을 누르면 Java 의 설치 디렉토리를 확인하는 화면이 나온다.

Java 설치 디렉토리 확인 화면

WebtoB Installation Guide 62

이 화면에서 선택한 디렉토리는 W2B_JDKHOME 이라는 환경변수로 등록이 되고 WebtoB Servlet Engine server 의 기동에 영향을 미치게 된다. 만약 사전에 Java 를 설치하지 않았다면 일단 설치를 중단하고 Java 를 설치한 후 WebtoB Servlet Engine 을 재 설치하는 방법과 WebtoB Servlet Engine 설치 완료 후 W2B_JDKHOME 이라는

Page 64: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

환경변수를 수정하는 방법이 있다. 설치 툴에서는 후자의 방법을 권장하고 있다.

Next 버튼을 누르면 설치 완료 화면이 나타난다.

설치 완료 화면

WebtoB Installation Guide 63

Page 65: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 64

설치 과정 중 추가한 환경변수를 시스템에 반영하기 위해 재부팅을 요구하는 화면이 나온다. 설치과정이 완료된 후에는 반드시 System 에서 Log out 또는 재 기동하거나, profile 을 실행해서 환경변수를 System 에 반영하도록 한다. 이로써 WebtoB 와 WebtoB Servlet Engine 의 설치 과정이 완료된 것이다.

시스템을 재시작하면 프로그램 폴더 아래에 WebtoB 가 생긴 것을 확인할 수 있을 것이다. ( 단 default 경로(c:\webtob)를 이용한 경우임 ). WebtoB Servlet Engine 을 함께 설치한 경우에는 W2B_JEUSHOME 값이 default 경로가 C:\webtob\jeus 를 설정된다. 이제 License 가 있는지 확인

한 다음 받은 License 를 License 폴더 아래에 license.dat 라는 이름으로 두고 Administration Tool 을 이용하여 환경설정을 하고 부팅하면 된다. Administration Tool 를 이용하여 WebtoB 의 환경설정을 하는 방법은 관

리자 매뉴얼을 참고하면 된다.

Page 66: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

6 설치과정 중 문제해결

이 장에서는 Unix, Linux, Windows NT, Windows2000 등의 운영체제에서 WebtoB 를 설치할 때 발생할 수 있는 문제점에 대해서 다룰 것이다. 특히, 자주 발생할 수 있는 문제들과 실수를 범하기 쉬운 점을 중점적

으로 예제를 들어 설명할 것이다.

6.1 1. 모든 플랫폼 6.1.1 Hardware Requirements and Software Requirements

WebtoB 를 설치하는 도중 문제가 발생하였을 때, 가장 먼저 확인하여

야 할 것은 WebtoB 설치/입문 첫장에 언급한 Hardware Requirements 와 Software Requirements 에 대한 내용이다. 설치할 Machine 이 WebtoB 가 지원하는지, 설치된 운영체제를 WebtoB 가 지원하는 것인지를 제일 먼

저 파악하여야 할 것이다.

6.1.2 Host name problem

WebtoB 를 설치하는데 아무런 문제없이 진행되었는데, wscfl 을 수행시

켰을 때 제대로 컴파일이 되지 않는다면, WebtoB 가 설치된 장비의 Host name 을 확인하여야 한다. Configuration File 내의 NODE name 설정

이 정확한지 확인한다.

WebtoB Installation Guide 65

6.1.3 Port Problem

WebtoB 를 설치하고 난 후 , wscfl 등의 작업이 순조롭게 진행되고 WebtoB 를 실 행 할 때 실 행 이 되 지 않 는 다 면 , 우 선 자 신 이 Configuration File 에 설정한 Port 가 사용 가능한 것인지를 확인하여야 한다. 이 Port 가 다른 프로그램에 의해서 이미 사용 중이거나 사용자

의 권한이 root 가 아니어서 사용할 수 없는 것인지 확인하여야 한다.

보통 1024 번 이상의 Port 번호는 임의로 사용할 수 있으나, 이 이전의 번호는 root 의 권한이 있어야 사용 가능하다.

80 Port 를 사용하고 싶다면, 반드시 root 의 사용권한을 가지고 있어야 하며 다른 Web Server 와 충돌하지 않는지 확인하여야 한다.

Page 67: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

6.1.4 SHMKEY Problem

환경파일 Node section 에서 SHMKEY 를 정의해 줄 때, 이미 다른 프로

그램이 사용하는 메모리를 침범하는 값을 넣어주게 되면, wsboot 시 error 가 나게 된다. 그럴 경우에는 SHMKEY 값을 변경해 줌으로서 해

결이 가능하다.

6.1.5 Path Problem

WebtoB 를 설치하고 난 후에는 반드시 WEBTOBDIR 을 등록하여야 한

다. WebtoB 의 실행시 이 Parameter 에 대한 Error Message 가 출력된다

면, 이를 WebtoB 가 설치된 directory 에 맞게 설정한다.

6.2 Unix/Linux 6.2.1 Directory Setting Problem

WebtoB 를 설치하고 난 후, 반드시 다음의 directory 가 존재하는지 확

인한다.

bin/ usrinc/ ap/ cgi-bin/ config/ docs/ license/ log/

path/ log/txlog/ log/syslog log/usrlog

다른 서비스를 이용하는 경우, 추가의 directory 가 생길 수 도 있으나, 위의 것들은 반드시 있어야 한다. 설치 후 이들 중 누락된 것이 있다

면, 확인후 다시 설치 하기 바란다.

6.2.2 License Problem

WebtoB 를 설치하고 모든 과정이 제대로 진행되었다 할지라도 License File 이 존재하지 않는다면 wscfl 을 실행할 수 없고 , 결과적으로 WebtoB 를 실행하는 것이 불가능하게 된다. 정식 사용자라면 반드시 TmaxSoft License Center 에 연락을 하여 정식 License 를 받아야 한다. 또한, Demo License 를 가지고 있는 사람은 일정 시간이 지나면 사용할 수 없는 제약과, 동시에 특정 수 이상의 사용자를 처리할 수 없다는 제약이 있다는 것을 숙지하여야 한다.

WebtoB Installation Guide 66

6.2.3 User Account Problem

WebtoB 를 설치할 때 보통 usr/local directory 를 많이 이용한다. 물

론, 사용자가 원하는 곳에 임의로 설치하는 것도 당연히 가능하다. 사

용자가 설치한 계정과 실제 WebtoB 를 기동하는 계정이 만약 다르다

면, 실행이 되지 않을 수 있다. 이런 경우에는 보통 permission denied라는 문구와 함께 실행이 거부 되는데, 이 때에는 사용자의 계정을 다

Page 68: Installation Guide - TmaxSoft · 2019-04-09 · Management, Transaction Processing Service Call 등)을 추가하였다. WebtoB 에서 제공하는 Service들은 다음과 같다

WebtoB Installation Guide 67

시 한 번 확인할 필요가 있다. 또한, 앞에서 언급한 Port 문제에서 80 번호 등 1024 번 미만의 번호를 이용하는 경우에는 보통 root 의 권한

이 필요하기 때문에 이를 반드시 확인하여야 한다.