Tmax

Transcription

1 WebtoB Installation Guide

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

3 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 Servlet Engine 의설치를위한내용을담고있다. WebtoB Servlet Engine 을설치하는방법을플랫폼별로나누어설명한다. WebtoB Installation Guide 2

4 -- 차례 -- About This Guide WebtoB 개요 WebtoB 설치 / 입문을읽기전에 미리알아두어야할사항 WebtoB 의소개 WebtoB 란? 설치하기전에 제품확인 WebtoB 제품별기능 지원플랫폼및운영체제 H/W 및 S/W 요구사항 각플랫폼별공통사항 라이센스부여방식 WebtoB 설치하기 시스템환경파악 호스트이름 포트번호 설치과정 WebtoB Installation Guide

5 3.2 Unix/Linux 에서 WebtoB 설치 WebtoB 설치전주의사항 CD-ROM 으로설치 (SHELLSCRIPT) CD-ROM 으로설치 (GUI) License 등록 WebtoB Upgrade/Patch 방법 WebtoB 의실행 환경설정 기본항목 추가항목 WebtoB 환경파일의 Compile WebtoB 의실행과종료 Windows NT/2000 의 WebtoB 설치 WebtoB 설치전주의사항 CD-ROM 으로설치 (Windows) 설치과정중문제해결 모든플랫폼 Hardware Requirements and Software Requirements Host name problem Port Problem SHMKEY Problem Path Problem Unix/Linux Directory Setting Problem License Problem User Account Problem WebtoB Installation Guide 4

6 1 WebtoB 개요 1.1 WebtoB 설치 / 입문을읽기전에 WebtoB 는 티맥스소프트에서개발하여출시한야심작으로서, 전세계웹서버시장의대부분을차지하고있는 Apache 와 IIS, Netscape Server 등의문제점을해결하고보다나은성능과안정성등을고려한제품이다. WebtoB 설치 / 입문은 WebtoB 를설치하고, 기본개념과 WebtoB 를이해하고자하는사용자를위해작성되었다. 1.2 미리알아두어야할사항 제품을설치하고웹서버환경을구성하기위해서는다음과같이미리알고있어야할부분이있다. Unix 기본명령어에대한이해 Internet 과 World Wide Web 에대한기본적인이해 Technical Support Information s Community & Download Service ) info@tmax.co.kr 5 WebtoB Installation Guide

7 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 제품 CD-ROM 1 매 WebtoB Installation Guide 6

8 - WebtoB 제품라이센스및보증서 - 매뉴얼 (WebtoB 설치 / 입문, WebtoB 관리자지침서 ) WebtoB 제품별기능 제품구분 WebtoB3.0@Base 제공기능 HTML, CGI, PHP, SSI, SSL, Basic WBAPI WebtoB3.0@Standard WebtoB3.0@Enterprise WebtoB@Base + Multi-Node + Load Balancing + JSP/Servlet + WBAPI WebtoB@Standard + TP-Service + Fail over 지원플랫폼및운영체제 제조사지원운영체제릴리즈 / 버전 WebtoB 버전 Compaq Tru64 UNIX 4.0, HP HP-UX 10.20, IBM AIX 4.2, GNU Linux Kernel 2.0 이상 3.1 SUN Solaris 2.6, 2.7, Windows NT base system 4.0 and H/W 및 S/W 요구사항 COMPAQ Compaq Alpha Platform 7 WebtoB Installation Guide

9 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 이상 WebtoB Installation Guide 8

10 2.2.5 각플랫폼별공통사항 - TCP/IP Network 환경 - C 컴파일러는 CGI, WBAPI 또는 Tmax 서비스프로그램컴파일시필요 - 설치후 WebtoB 의디스크사용량 : 40Mbytes 미만 (WebtoB Servlet Engine 포함시 ) 라이센스부여방식 - 정식버전 : CPU 개수와기능별라이센스 - 평가판버전 : 날짜제한방식등의라이센스 9 WebtoB Installation Guide

11 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 를정상적으로기동시키기위해서는반드시제품에대한라이센스를적용하고, WebtoB Configuration 파일을설정해야한다. 이중특히 Configuration File 은 WebtoB 가실제운영될수있는환경으로구성된다. WebtoB 는인스톨과정에서호스트이름과 IP Address 를자동으로찾아내어환경파일에등록하여준다. 시스템의 IP 주소와호스트이름을알아내는방법은다음과같으며, 대표적으로 SUN Solaris 경우의예를들었다. WebtoB Installation Guide 10

12 Ex 1] SUN Solaris System $ ifconfig a lo0: flags=849<up,loopback,running,multicast> mtu 8232 inet netmask ff hme0:lags=863<up,broadcast,notrailers,running,multicast> mtu 1500 inet netmask ffffff00 broadcast $ uname n www 여기에서호스트이름이 FQDN(Fully Qualified Domain Name) 형식으로출력이된다면맨앞에있는이름만설정하면된다 포트번호 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 일경우 이제본격적으로 WebtoB 를설치해보도록하자. 제품의 CD-ROM 에는 WebtoB 를설치할수있는프로그램이들어있다. 각각의플랫폼에대한이진 (Binary) 파일이있기때문에, 다양한운영체제에설치할수있다. 11 WebtoB Installation Guide

13 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 설치전주의사항 WebtoB 를설치하기전에자신의시스템환경파일을반드시살펴보도록한다. 이전에 WebtoB 가설치되었는지또는 WebtoB Servlet Engine 을함께설치하고자할때는이전에 WebtoB Servlet Engine 을 WebtoB Installation Guide 12

14 설치한내용이있는지확인한후관련환경변수들을삭제하는것을권장한다. 이는적용된설치 path 가혼동될수가있고새로이설치하려는 WebtoB Servlet Engine 이 Shard Memory 충돌을일으켜정상적인인스톨을못하는경우가발생할수있기때문이다. 또한, WebtoB Servlet Engine 을함께인스톨할경우에는몇가지더주의사항들이있다. 인스톨을하기전에반드시 $which java Command Line 을수행하여 jdk path 가잡혀있는지확인해야한다. 이는 WebtoB Servlet Engine 설치과정에서 Security 와관련한 Password 값을인코딩해야하기때문이다. 따라서이전에 JDK가설치되어있지않으면 TM 사이트에서자신의시스템의 OS에맞는 Java 2 SDK v1.3.0, Standard Edition을 download 하여미리설치해두어야한다. JDK version은되도록 Java version 1.3.0(HopSpot Server 포함 ) 또는 version 이상버전을설치하도록한다. 설치후반드시 JDK가정상적으로설치되었는지확인한다. Java version 에서 WebtoB Servlet Engine 을사용할것을권장하고있다 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 을실행한다. License Agreement 13 WebtoB Installation Guide

15 ################################################################ # 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 WebtoB Installation Guide 14

16 # 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 을선택시설치가중단된다. Operating System 선택 서버의운영체제를묻는질문이다. 해당운영체제에대한번호를선택한다. 해당되지않는운영체제를선택하는경우는다시선택하라는메시지가나오게된다. 설치의중단은언제든지 ctrl+c 를누르면된다. 15 WebtoB Installation Guide

17 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 bit) 5) IBM(AIX bit) 6) Linux_x86 (RedHat 6.0 or higher 32bit) 7) Sun_SPARC (Solaris 2.5.1, 2.6, 2.7 or bit) 8) Sun_SPARC (Solaris 2.7 or bit) 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 를만들어설치한다. 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 ) WebtoB Installation Guide 16

18 만약 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, bytes, 305 테이프블록 x bin/wsm.dbg, bytes, 310 테이프블록 x bin/htl, bytes, 141 테이프블록 x bin/hth, bytes, 534 테이프블록 17 WebtoB Installation Guide

19 ... x bin/hth.dbg, bytes, 560 테이프블록 x template/license/ncpu.hp, 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) 을동적으로생성해줄때적절한설정값들을정해준다. =============================================================== 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 OK Copying sample.m to /user1/choco/webtob/config directory... 인스톨시에는예상되는동시접속자수를고려하여메뉴를선택한다. 이때생성되는환경파일의설정값들은사용자시스템의성능이나제공하고자하는서비스의종류와규모에따라다소차이가있을수있다. 따라서사용자들은이점을고려하여차후에환경파일을적절히수정하도록권장한다. 또한예상되 WebtoB Installation Guide 18

20 는동시접속자의수가 1500 명이상의경우에도사용자직접환경파일을수정해주어야한다. WebtoB 만설치할경우 WebtoB 설치시동시에 WebtoB Servlet Engine 의설치여부를정할수있다. WebtoB 만을설치할경우아래의물음에 n 이라는값으로입력한다. 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 19 WebtoB Installation Guide

21 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: info@tmax.co.kr ============================================================== 위와같은화면이보인다면 WebtoB 설치가성공적으로완료된것이다. WebtoB Servlet Engine 을함께설치할경우 WebtoB 설치시동시에 WebtoB Servlet Engine 의설치여부를정할수있다. WebtoB 설치시 WebtoB Servlet Engine 을함께설치하고자할경우아래의물음에 y 라는값으로설정한다. o Would you like to install Servlet Engine? [y/n] : y WebtoB Installation Guide 20

22 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 J2EE(TM) 1.2 Extension for jdk Quit Installation Program Select Product : 1 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 } 가설정되어있는가확인하고, 존재하지않는경로가지정되어있는경우, 삭제한뒤, 로그아웃한뒤, 다시로그인하고처음부터다시설치한다. 21 WebtoB Installation Guide

23 파일복사 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 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 자미만이거나두개의패스워드가일치하지않을경우, 처음부터다시입력을해야한다. WebtoB Installation Guide 22

24 설치완료 ================================================================ 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 ========================================== 23 WebtoB Installation Guide

25 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: info@tmax.co.kr =============================================================== WebtoB Installation Guide 24

26 위와같은화면이보인다면 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 Environment ######## setenv WEBTOBDIR /user1/choco/webtob set path=($path /user1/choco/webtob/bin.) ### Using WebtoB Shared Library for WBAPI ### 25 WebtoB Installation Guide

27 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

28 기본적으로 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 을함께인스톨시도중에실패를하면다시인스톨스크립트를수행시켜인스톨과정을다시하면된다 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) 이존재하는지확인한다. 설치의시작 27 WebtoB Installation Guide

29 지금부터 AIX Machine 에 WebtoB 를설치해보도록하겠다. Ibm32.bin 를 Double Click 한다. 설치명령파일인 Ibm32.bin 을실행시키면다음과같이 WebtoB 설치메인화면이나오며, 이것으로 WebtoB 설치툴이정상적으로기동된것을확인할수있다. Introduction 화면 설치를계속할지여부를묻는창이나타나면 NEXT 를누른다. 다음은설치시간략한주의사항을다루고있다. WebtoB Installation Guide 28

30 WebtoB 를설치하기전에실행중인모든프로그램을종료한다. Exit 버튼 : 설치프로그램을즉시종료한다. Next 버튼 : 현재화면의입력을완료하고다음화면으로넘어간다. Previous 버튼 : 전화면으로이동한다. 위의사항은 WebtoB 의설치툴이종료할때까지동일하게적용된다. 특히안전한설치를위해서 WebtoB 이외의실행중인 Program 을종료하기바란다. 계속진행하기를선택하면 License 동의여부를묻는화면이나온다. License Agreement 화면 아래와같은 License 계약의창이뜨면, 그내용을잘읽어본후동의하는경우에한해 YES 를선택한다. NO 를선택하면더이상 install 이진행되지않는다. Next 버튼을선택하면 WebtoB 를설치할디렉토리를선택하는화면이나타난다. 설치디렉토리선택화면 29 WebtoB Installation Guide

31 프로그램이설치될경로를지정하는화면이다. ( Default 권장 ) Default 로 System Root Directory 에 webtob 이란이름으로설정되어있다. 다른디렉토리로변경하기위해서는 Choose 버튼을눌러새로운디렉토리를선택한후 Select 버튼을누른다. Restore Default Location : 설치디렉토리를기본디렉토리로설정한다. Choose : 설치디렉토리를변경하기위해디렉토리선택대화창을만든다. 기본디렉토리로선택을완료하고 Install 버튼을누르면 Install Set 선택화면이나타난다. Install Set 선택화면 WebtoB Installation Guide 30

32 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 설정에필요한정보를입력한다. 설치진행화면 31 WebtoB Installation Guide

33 파일의복사과정을나타내는화면이다. 설치를중단하고싶으면대화상자의 Exit 버튼을선택한다. 그러나제거툴의설치가완료되었는지알수없으므로제거툴의정상적인동작을보장할수없다. 가능한설치를완료한후제거툴을이용하여제거하기를권장한다. 이설치진행화면은시스템상황에따라수분이소요될수있으므로중간에 Exit 하는일이없도록한다. 동시접속자수입력 인스톨시에는 1~1500 명사이의예상되는동시접속자수를고려하여값을입력한다. 따라서 1500 명이상의경우에는사용자직접환경파일을수정해주어야한다. WebtoB Installation Guide 32

34 입력되는동시접속자수정보를참조하여 WebtoB 환경파일 (sample.m) 에적절한값을설정하여환경파일을생성한다. 이때생성된환경파일의설정값이각사용자의시스템환경이나서비스종류와규모에따라적절하지않을수도있으므로차후에사용자들이이점을고려하여차후에환경파일을적절히수정하도록권장한다. Next 버튼을누르면설치완료화면이나타난다. 설치완료화면 33 WebtoB Installation Guide

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

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

37 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 과호환성을갖춘 WebtoB Servlet Engine 을설치한다. JDK 1.2 WebtoB 와함께 Java Version 와환성을갖춘 WebtoB Servlet Engine 을설치한다. 동시접속자수입력 인스톨시에는 1~1500 명사이의예상되는동시접속자수를고려하여값을입력한다. 따라서 1500 명이상의경우에는사용자직접환경파일을수정해주어야한다. WebtoB Installation Guide 36

38 입력되는동시접속자수정보를참조하여 WebtoB 환경파일 (sample.m) 과 WebtoB Servlet Engine 환경파일 (container.xml) 에적절한값을설정하여환경파일을생성한다. 이때생성된환경파일의설정값이각사용자의시스템환경이나서비스종류와규모에따라적절하지않을수도있으므로차후에사용자들이이점을고려하여차후에환경파일을적절히수정하도록권장한다. Next 버튼을누르면 WebtoB Servlet Engine 환경을설정하기위한대화상자가나타난다. Password 입력화면 WebtoB Servlet Engine 기동시에입력하게될 administrator 의 Password 를입력한다. 타당성 Check 를행한후맞으면다음화면으로틀린경우는재입력을요구하는메세지를내보낸다. 이 Password 는 WebtoB Servlet Engine 기동시계속적으로사용하게되므로반드시기억해야할필요가있다. 37 WebtoB Installation Guide

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

40 Next 버튼을누르면설치완료화면이나타난다. 설치완료화면 39 WebtoB Installation Guide

41 설치과정중추가한환경변수를시스템에반영하기위해재부팅을요구하는화면이나온다. 설치과정이완료된후에는반드시 System 에서 Log out 또는재기동하거나, profile 을실행해서환경변수를 System 에반영하도록한다. 이로써 WebtoB 와 WebtoB Servlet Engine 의설치과정이완료된것이다 License 등록 Solaris, HP, Compaq, AIX 에서이루어지는 WebtoB 설치과정은동일하며, 설치시화면구성은 Windows 설치때와동일하다. 모두설치툴을이용하여설치한다. 그러나 UNIX 에서설치툴을이용하기위해서는자바기반의 GUI 환경을지원하는콘솔혹은터미널이설치되어있어야만한다. Tmax Soft License Center (Demo License 요청 ) forum.tmax.co.kr (Devloper`s Community & Download Service) Tel: WebtoB Installation Guide 40

42 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 Upgrade/Patch 방법 WebtoB 를새로운버전으로업그레이드또는패치를하기위해서는 티맥스소프트로부터제공되는파일을받아단순히압축을풀어적용시킬수가있다. 업그레이드 / 패치파일은 티맥스소프트에서제공하며본사홈페이지를통해다운로드받거나 로전송받을수있다. 파일은 [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 41 WebtoB Installation Guide

43 4 WebtoB 의실행 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 to us. # # info@tmax.co.kr # *DOMAIN webtob WebtoB Installation Guide 42

44 *NODE www WEBTOBDIR = "/usr/local/webtob", SHMKEY = 69000, DOCROOT = "/usr/local/webtob/docs", AppDir = "/usr/local/webtob/ap", HostName = " 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 = "tmax@tmax.co.kr", Listen = " :5469, :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 = " :5469", Admin = "root@tmax.co.kr", 43 WebtoB Installation Guide

45 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 cgig jsvg ssig phpg wbapg tpsvg NODENAME = www, SVRTYPE = HTML NODENAME = www, SVRTYPE = CGI NODENAME = www, SVRTYPE = JSV NODENAME = www, SVRTYPE = SSI NODENAME = www, SVRTYPE = PHP, ScriptLoc = "/cgi-bin/php" NODENAME = www, SVRTYPE = WEBSTD 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 example write_board SVRNAME = tpsvr SVRNAME = wbaps SVRNAME = wbaps *DIRECTORY dir1 DIRECTORY = "/usr/local/webtob/docs/vhost_docs", ForceMimetype = "CGI" *URI uri1 URI = "/cgi-bin/", SVRTYPE = CGI WebtoB Installation Guide 44

46 uri2 URI = "/examples/", SVRTYPE = JSV *ALIAS alias1 URI = "/cgi-bin/", REALPATH = "/usr/local/webtob/cgi-bin/" *DIRINDEX fancy OPTIONS = "FANCY" *LOGGING log1 log2 FORMAT = "DEFAULT", FILENAME = "/usr/local/webtob/log/access.log", Option = "sync" 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= 404 Status = 404, URL= *EXT htm any jsp MIMETYPE = "text/html", SVRTYPE = HTML MIMETYPE = "text/html", SVRTYPE = CGI MIMETYPE = "test/jsp", SVRTYPE = JSV Configuration 파일 (manual.m) 의구성에대한자세한설명은 WebtoB 관리자지침서를참조하기로한다. 45 WebtoB Installation Guide

47 WebtoB 에서기본적으로설정해야하는절은다음과같다 기본항목 WebtoB 의모든설치과정이문제없이수행되었다면, 사용자는 WebtoB 가설치된곳에 config/ 라는 directory 가존재함을확인할수있을것이다 DOMAIN Section 도메인절에서는여러 WebtoB 노드를가질수있는하나의도메인이름을정의하고, 시스템의전반적인환경을정의한다. Ex] Domain 절의예 *DOMAIN WebtoB1 각항목에대한설명 Domain 을 WebtoB1 이라는이름으로하였다. 여기서의 Domain 이라함은, 인터넷에서사용하는도메인이름과는전혀무관하며, WebtoB 시스템에서사용하는하나의영역이름이라고보면된다 NODE section WebtoB 를이루는각노드에대한환경설정이이루어진다. 이 Node 절에서는다음의항목에대한정의가이루어진다 공유메모리 Key 값을설정하는 ShmKey 값설정 WebtoB Handler 의개수 각종디렉토리의설정 WebtoB 가설치된디렉토리 서비스할문서의디렉토리 응용서버프로그램의실행파일들을포함하는디렉토리 로그메시지가저장될디렉토리 환경설정파일과아이콘파일의디렉토리 WebtoB Installation Guide 46

48 Ex] Node 절의예 *NODE webtob HTH = 2, SHMKEY=89000, DOCROOT="/usr/local/webtob/docs", PORT="80", 각항목에대한설명 WEBTOBDIR="/usr/local/webtob", WEBTOBDIR : WebtoB 가설치된 Drectory HTH : WebtoB 의주기능을담당하는 HTH 개수지정 SHMKEY : WebtoB Shared Memory 의 Key 값설정 DOCROOT : html 문서가있는 Directory PORT : Web Server Listen port (Default Value = 80) Ex) PORT = SVRGROUP section WebtoB 를통해응용서버프로세스를접근하는경우, 서버프로세스의논리적인연관성에따라이들을그룹으로관리할필요가있게된다. 이절에서는다음의항목들에대한설정을한다. 노드이름 서버그룹의형태 Ex] Server Group 절의예 *SVRGROUP htmlg cgig ssig NODENAME = www, SvrType = HTML NODENAME = www, SvrType = CGI NODENAME = www, SvrType = SSI 각항목에대한설명 NODENAME : 각 server group 에대한 Node 이름 SvrType : 각 server group 에대한 server 형태 47 WebtoB Installation Guide

49 SERVER section 응용서버프로세스를등록한다. 각각의서버는서비스종류에따라 HTML, CGI, JSV 등으로구분된다. 이절에서는다음의항목들을정의한다. 서버그룹이름과실행가능한프로세스의개수 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 관리자지침서를참조하기바란다. WebtoB Installation Guide 48

50 4.1.2 추가항목 VHOST section Virtual Host 를지원하기위한각종환경값을설정한다. 이 VHOST 절에서는다음의항목들을정의한다. Virtual Host 에해당하는호스트이름 서비스문서디렉토리등 Ex] VHOST 절의예 *VHOST vhost1 HOSTNAME = "www2.tmax.co.kr", 각항목에대한설명 DOCROOT="/www2/docs", NODENAME = www, DOCROOT : 새로운사이트의웹문서가위치할 Directory 의 지정 NODENAME : vhost 를위한호스트이름 HOSTNAME : vhost 를위한 FQDN(Fully Qualified Domain Name) SERVICE section WebtoB 를통해 Tmax 응용프로세스를바로접근할경우, 제공되는서비스를등록해야한다. 이절에서는다음의항목등을설정한다. 서버의이름과서비스의이름을설정 서비스우선순위와처리제한시간 DIRECTORY 노드내의특정디렉토리의속성을정하기위한환경설정을한다. 디렉토리접근에인증이필요하도록하는 AuthentName, 디렉토리안의파일확장명을설정하는 ForceExt, DefaultExt 등이있으며, 디렉토리접근내역을기록하는로그등을설정할수있다 URI 클라이언트요구를 URI 의설정에따라처리하는서비스를구분하도록설정한다. 49 WebtoB Installation Guide

51 ALIAS 실제서버안의물리적인디렉토리의절대경로와 URI 를 alias 시키도록설정할수있다 DIRINDEX 클라이언트가요구한 index.html 과같은특정화일이존재하지않는경우, 전체디렉토리구조를보여줄수있도록설정한다. Indexing 하는방식과 Icon 등을지정할수있다 LOGGING 클라이언트의요구내역을기록하는형식을지정한다 AUTHENT 클라이언트의접근을제한하기위한인증과정을유저와그룹단위로통제할수있도록설정한다 EXT 클라이언트가요구한파일의확장자명에따라처리담당프로세스를지정할수있다 WebtoB 환경파일의 Compile WebtoB 가제공하는 wscfl 이라는유틸리티를이용하면환경파일을 compile 하여웹서버기동시에실제참조할 wsconfig 바이너리파일이생성된다. UNIX System 의경우 EX] wscfl 의수행 $wscfl i sample.m 이환경 File 에대한자세한정보는 WebtoB 관리자지침서에서얻을수있다. 좀더복잡한환경설정을원하거나, WebtoB 의다양한기능을사용하고싶다면, WebtoB 관리자지침서를참조하기바란다 WebtoB 의실행과종료 위의설치및환경설정이모두완료되면이제 WebtoB 를실행할수있다. WebtoB 가설치된 bin directory 내에있는 wsboot 라는명령어를통하여실행할수있다. WebtoB 의종료는 wsdown 이라는명령어를사용한다. WebtoB Installation Guide 50

52 EX] WebtoB 실행의경우 $wsboot EX] WebtoB 종료의경우 $wsdown 51 WebtoB Installation Guide

53 5 Windows NT/2000 의 WebtoB 설치 5.1 WebtoB 설치전주의사항 WebtoB 를설치시 WebtoB Servlet Engine 를함께인스톨할경우에는먼저 JDK 가설치되어있어야한다. 따라서이전에 JDK가설치되어있지않으면 TM 사이트에서자신의시스템의 OS에맞는 Java 2 SDK v1.3.0, Standard Edition을 download 하여미리설치해두어야한다. JDK version은되도록 Java version 1.3.0(HopSpot Server 포함 ) 또는 version 이상버전을설치하도록한다. 설치후반드시 JDK가정상적으로설치되었는지확인한다. 사용자환경변수중 PATH에 java 실행모듈이존재하는 bin 디렉토리를추가한다. Note : Java version 에서 WebtoB Servlet Engine 을사용할것을권장하고있다. 5.2 CD-ROM 으로설치 (Windows) WebtoB NT 버전은 installer 를이용하여여타의윈도우응용프로그램과동일한방법으로간단히설치할수있다. CD 를 CD-ROM 에넣는다. CD-ROM 을 Mount 한다. CD 안에 WebtoB Windows 설치파일 (WebtoB.exe) 이존재하는지확인한다. 설치의시작 WebtoB.exe 를 Double Click 한다. 설치명령파일인 WebtoB.exe 실행시키면다음과같이 WebtoB 설치메인화면이나오며, 이것으로 WebtoB 설치툴이정상적으로기동된것을확인할수있다. WebtoB Installation Guide 52

54 Introduction 화면 설치를계속할지여부를묻는창이나타나면 NEXT 를누른다. 다음은설치시간략한주의사항을다루고있다. 53 WebtoB Installation Guide

55 WebtoB 를 설치하기 전에 실행중인 모든 프로그램을 종료한다. Exit 버튼 : 설치프로그램을즉시종료한다. Next 버튼 : 현재화면의입력을완료하고다음화면으로넘어간다. Previous 버튼 : 전화면으로이동한다. 위의사항은 WebtoB 의설치툴이종료할때까지동일하게적용된다. 특히안전한설치를위해서 WebtoB 이외의실행중인 Program 을종료하기바란다. 계속진행하기를선택하면 License 동의여부를묻는화면이나온다. License Agreement 화면 아래와같은 License 계약의창이뜨면, 그내용을잘읽어본후동의하는경우에한해 YES 를선택한다. NO 를선택하면더이상 install 이진행되지않는다. Next 버튼을선택하면 WebtoB 를설치할디렉토리를선택하는화면이나타난다. WebtoB Installation Guide 54

56 설치디렉토리선택화면 프로그램이설치될경로를지정하는화면이다. ( Default 권장 ) Default 경로는 c:\webtob 이다. 다른디렉토리로변경하기위해서는 Choose 디렉토리를선택한후 Select 버튼을누른다. 버튼을눌러새로운 Restore Default Location : 설치디렉토리를기본디렉토리로설정한다. Choose : 설치디렉토리를변경하기위해디렉토리선택대화창을만든다. 기본디렉토리로선택을완료하고 Install 버튼을누르면 Install Set 선택화면이나타난다. 55 WebtoB Installation Guide

57 Install Set 선택화면 WebtoB 설치프로그램은 WebtoB Servlet Engine, WebtoB 두개의 Install Set 을가지고있으며, 한개의 Install Set 만을선택할수있다. 각 Install Set 의특성은다음과같다. WebtoBServlet engine WebtoB 와함께 WebtoB Servlet Engine 을설치한다. WebtoB WebtoB 만설치한다. 만약 WebtoB 만설치할경우 WentoB 를선택하고 Next 버튼을누르면 configuration file 설정에필요한정보를입력한다. WebtoB Installation Guide 56

58 설치진행화면 파일의복사과정을나타내는화면이다. 설치를중단하고싶으면대화상자의 Exit 버튼을선택한다. 그러나제거툴의설치가완료되었는지알수없으므로제거툴의정상적인동작을보장할수없다. 가능한설치를완료한후제거툴을이용하여제거하기를권장한다. 이설치진행화면은시스템상황에따라수분이소요될수있으므로중간에 Exit 하는일이없도록한다. 동시접속자수입력 인스톨시에는 1~1500 명사이의예상되는동시접속자수를고려하여값을입력한다. 따라서 1500 명이상의경우에는사용자직접환경파일을수정해주어야한다. 57 WebtoB Installation Guide

59 입력되는동시접속자수정보를참조하여 WebtoB 환경파일 (sample.m) 에적절한값을설정하여환경파일을생성한다. 이때생성된환경파일의설정값이각사용자의시스템환경이나서비스종류와규모에따라적절하지않을수도있으므로차후에사용자들이이점을고려하여차후에환경파일을적절히수정하도록권장한다. Next 버튼을누르면설치완료화면이나타난다. WebtoB Installation Guide 58

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

61 WebtoB Servlet Engine 설치여부설정 (WebtoB 와 WebtoB Servlet Engine 를함께설치할경우 ) WebtoB Servlet Engine 설치를선택하고 Install 버튼을누르면 configuration file 설정에필요한정보를입력한다. JDK version 선택화면 WebtoB Installation Guide 60

62 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 과호환성을갖춘 WebtoB Servlet Engine 을설치한다. JDK 1.2 WebtoB 와함께 Java Version 와환성을갖춘 WebtoB Servlet Engine 을설치한다. 동시접속자수입력 인스톨시에는 1~1500 명사이의예상되는동시접속자수를고려하여값을입력한다. 따라서 1500 명이상의경우에는사용자직접환경파일을수정해주어야한다. 입력되는동시접속자수정보를참조하여 WebtoB 환경파일 (sample.m) 과 WebtoB Servlet Engine 환경파일 (container.xml) 에적절한값을설정하여환경파일을생성한다. 이때생성된환경파일의설정값이각사용자의시스템환경이나서비스종류와규모에따라적절하지않을수도있으므로차후에사용 61 WebtoB Installation Guide

63 자들이이점을고려하여차후에환경파일을적절히수정하도록권장한다. Next 버튼을누르면 WebtoB Servlet Engine 환경을설정하기위한대화상자가나타난다. Password 입력화면 WebtoB Servlet Engine 기동시에입력하게될 administrator 의 Password 를입력한다. 타당성 Check 를행한후맞으면다음화면으로틀린경우는재입력을요구하는메세지를내보낸다. 이 Password 는 WebtoB Servlet Engine 기동시계속적으로사용하게되므로반드시기억해야할필요가있다. Next 버튼을누르면 Java 의설치디렉토리를확인하는화면이나온다. Java 설치디렉토리확인화면 이화면에서선택한디렉토리는 W2B_JDKHOME 이라는환경변수로등록이되고 WebtoB Servlet Engine server 의기동에영향을미치게된다. 만약사전에 Java 를설치하지않았다면일단설치를중단하고 Java 를설치한후 WebtoB Servlet Engine 을재설치하는방법과 WebtoB Servlet Engine 설치완료후 W2B_JDKHOME 이라는 WebtoB Installation Guide 62

64 환경변수를수정하는방법이있다. 설치툴에서는후자의방법을권장하고있다. Next 버튼을누르면설치완료화면이나타난다. 설치완료화면 63 WebtoB Installation Guide

65 설치과정중추가한환경변수를시스템에반영하기위해재부팅을요구하는화면이나온다. 설치과정이완료된후에는반드시 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 의환경설정을하는방법은관리자매뉴얼을참고하면된다. WebtoB Installation Guide 64

66 6 설치과정중문제해결 이장에서는 Unix, Linux, Windows NT, Windows2000 등의운영체제에서 WebtoB 를설치할때발생할수있는문제점에대해서다룰것이다. 특히, 자주발생할수있는문제들과실수를범하기쉬운점을중점적으로예제를들어설명할것이다 모든플랫폼 Hardware Requirements and Software Requirements WebtoB 를설치하는도중문제가발생하였을때, 가장먼저확인하여야할것은 WebtoB 설치 / 입문첫장에언급한 Hardware Requirements 와 Software Requirements 에대한내용이다. 설치할 Machine 이 WebtoB 가지원하는지, 설치된운영체제를 WebtoB 가지원하는것인지를제일먼저파악하여야할것이다 Host name problem WebtoB 를설치하는데아무런문제없이진행되었는데, wscfl 을수행시켰을때제대로컴파일이되지않는다면, WebtoB 가설치된장비의 Host name 을확인하여야한다. Configuration File 내의 NODE name 설정이정확한지확인한다 Port Problem WebtoB 를설치하고난후, wscfl 등의작업이순조롭게진행되고 WebtoB 를실행할때실행이되지않는다면, 우선자신이 Configuration File 에설정한 Port 가사용가능한것인지를확인하여야한다. 이 Port 가다른프로그램에의해서이미사용중이거나사용자의권한이 root 가아니어서사용할수없는것인지확인하여야한다. 보통 1024 번이상의 Port 번호는임의로사용할수있으나, 이이전의번호는 root 의권한이있어야사용가능하다. 80 Port 를사용하고싶다면, 반드시 root 의사용권한을가지고있어야하며다른 Web Server 와충돌하지않는지확인하여야한다. 65 WebtoB Installation Guide

67 6.1.4 SHMKEY Problem 환경파일 Node section 에서 SHMKEY 를정의해줄때, 이미다른프로그램이사용하는메모리를침범하는값을넣어주게되면, wsboot 시 error 가나게된다. 그럴경우에는 SHMKEY 값을변경해줌으로서해결이가능하다 Path Problem WebtoB 를설치하고난후에는반드시 WEBTOBDIR 을등록하여야한다. WebtoB 의실행시이 Parameter 에대한 Error Message 가출력된다면, 이를 WebtoB 가설치된 directory 에맞게설정한다. 6.2 Unix/Linux Directory Setting Problem WebtoB 를설치하고난후, 반드시다음의 directory 가존재하는지확인한다. bin/ usrinc/ ap/ cgi-bin/ config/ docs/ license/ log/ path/ log/txlog/ log/syslog log/usrlog 다른서비스를이용하는경우, 추가의 directory 가생길수도있으나, 위의것들은반드시있어야한다. 설치후이들중누락된것이있다면, 확인후다시설치하기바란다 License Problem WebtoB 를설치하고모든과정이제대로진행되었다할지라도 License File 이존재하지않는다면 wscfl 을실행할수없고, 결과적으로 WebtoB 를실행하는것이불가능하게된다. 정식사용자라면반드시 TmaxSoft License Center 에연락을하여정식 License 를받아야한다. 또한, Demo License 를가지고있는사람은일정시간이지나면사용할수없는제약과, 동시에특정수이상의사용자를처리할수없다는제약이있다는것을숙지하여야한다 User Account Problem WebtoB 를설치할때보통 usr/local directory 를많이이용한다. 물론, 사용자가원하는곳에임의로설치하는것도당연히가능하다. 사용자가설치한계정과실제 WebtoB 를기동하는계정이만약다르다면, 실행이되지않을수있다. 이런경우에는보통 permission denied 라는문구와함께실행이거부되는데, 이때에는사용자의계정을다 WebtoB Installation Guide 66

68 시한번확인할필요가있다. 또한, 앞에서언급한 Port 문제에서 80 번호등 1024 번미만의번호를이용하는경우에는보통 root 의권한이필요하기때문에이를반드시확인하여야한다. 67 WebtoB Installation Guide