Copyright 2005 Tmax Soft Co., Ltd. All Rights Reserved.
Copyright Notice Copyright 2005 Tmax Soft Co., Ltd. All Rights Reserved. Tmax Soft Co., Ltd. 대한민국서울시강남구대치동 946-1 글라스타워 18 층우 )135-708 Restricted Rights Legend This software and documents are made available only under the terms of the Tmax Soft License Agreement and may be used or copied only in accordance with the terms of this agreement. No part of this document may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, or optical, without the prior written permission of Tmax Soft Co., Ltd. 이프로그램과문서는 TmaxSoft 라이선스동의하에서만만들거나, 사용되거나, 복사될수있습니다. TmaxSoft Co., Ltd. 의허락없이이문서의일부분이나전체를전자적, 기계적, 광학적, 수작업등어떤방법으로든복사, 재생산, 번역등을할수없습니다. Trademarks Tmax,, WebT, and JEUS are registered trademarks of Tmax Soft Co., Ltd. All other product names may be trademarks of the respective companies with which they are associated. Tmax,, WebT, JEUS 는 TmaxSoft Co., Ltd. 의등록상표입니다. 기타모든제품들과회사이름은각각해당소유주의상표로서참조용으로만사용됩니다. Document info Document name: Document date: 2005-09-23 Manual release version: 4.1 Software Version: 4.1
차례 매뉴얼에대하여... 4 매뉴얼의대상... 4 매뉴얼의전제조건... 4 매뉴얼의구성... 4 일러두기... 5 제품별기능... 6 1 의소개... 9 1.1 란?... 9 2 설치전확인사항... 10 2.1 제품확인... 10 2.2 Full Installer 지원플랫폼정보및요구환경... 10 2.3 시스템환경파악... 11 2.3.1 호스트이름... 12 2.3.2 포트번호... 12 2.3.3 환경변수... 13 2.3.4 JDK 버전확인 (Standard Edition : Servlet engine 설치시 )... 13 2.3.5 File Descriptor 확인... 13 2.4 평가판 소프트웨어의배포... 14 3 설치하기... 15 3.1 설치과정... 15 3.2 Unix/Linux 에서 설치... 15 3.2.1 설치하기 ()... 16 3.2.1.1 설치파일실행... 16 3.2.1.2 License 동의... 17 3.2.1.3 OS 선택... 20 1 TmaxSoft
3.2.1.4 Install Set 선택... 21 3.2.1.5 설치경로설정... 21 3.2.1.6 설치정보확인... 22 3.2.1.7 준비확인... 22 3.2.1.8 파일설치작업... 23 3.2.1.9 설치확인... 23 3.2.2 설치하기 (+Servlet Engine)... 25 3.2.2.1 Install Set 선택... 25 3.2.2.2 설치경로설정... 26 3.2.2.3 JDK 경로설정... 26 3.2.2.4 Servlet Engine 관리자패스워드설정... 26 3.2.2.5 설치정보확인... 27 3.2.2.6 준비확인... 28 3.2.2.7 파일설치작업... 28 3.2.2.8 설치확인... 29 3.3 Windows 에서 설치... 31 3.3.1 설치하기 ( )... 31 3.3.1.1 설치파일실행... 31 3.3.1.2 설치안내... 32 3.3.1.3 License 동의... 33 3.3.1.4 Install Set 선택... 34 3.3.1.5 설치경로설정... 35 3.3.1.6 설치정보확인... 36 3.3.1.7 파일설치작업... 37 3.3.1.8 설치확인... 38 3.3.2 설치하기 ( + Servlet Engine )... 38 3.3.2.1 Install Set 선택... 39 3.3.2.2 설치경로설정... 40 3.3.2.3 JDK 경로설정... 41 3.3.2.4 Servlet Engine 관리자패스워드설정... 42 3.3.2.5 설치정보확인... 43 3.3.2.6 파일설치작업... 44 3.3.2.7 설치확인... 45 4 기동및종료... 46 4.1 License 발급... 46 4.2 환경파일작성및컴파일... 47 4.3 기동... 48 4.4 종료... 49 5 제거하기 (Uninstall)... 52 5.1 Unix/Linux 에서의 제거... 52 TmaxSoft 2
5.1.1 Uninstaller 실행... 52 5.1.2 Uninstall 작업... 53 5.1.3 Uninstall 작업완료... 53 5.1.4 Uninstall 확인... 53 5.2 Windows 에서의 제거... 54 5.2.1 Uninstaller 실행... 54 5.2.2 Uninstall 안내... 54 5.2.3 Uninstall 작업... 55 5.2.4 Uninstall 작업완료... 56 5.2.5 Uninstall 확인... 56 3 TmaxSoft
매뉴얼에대하여 매뉴얼의대상 본매뉴얼은 TmaxSoft 의 Web Server 제품인 의설치를돕기위해만들어졌다. 본매뉴얼의이용자는 UNIX 와 Web 에대한기초지식이있는사람으로서 Web Server 에관심이있는모든일반사용자와 Web Server 관리자를포함한다. 매뉴얼의전제조건 본매뉴얼을이해하기위해서는 Web Server 와 World Wide Web, TCP/IP, HTTP 에대한기초적인이해만있으면되고, 특별한전문지식이요구되지는않는다. 그렇지만 를 UNIX 환경에서운영하고자하는경우라면, UNIX 사용에관련한기본적인지식이요구된다. 설치후보다자세한설정및운용에관한사항은 관리자안내서를참조해야한다. 매뉴얼의구성 본매뉴얼은다음과같이 5개장 (Chapters) 으로구성되어져있다. 1. 의소개 2. 설치전확인사항 3. 설치하기 4. 기동및종료 5. 제거하기 TmaxSoft 4
일러두기 표기예 내용 텍스트본문, 12 포인트, 바탕체 Times New Roman 텍스트 본문강조 CTRL+C CTRL 과동시에 C 를누름 public class myclass { } Java 코드 <system-config> XML 문서 참조 : / 주의 :` Configuration 메뉴를연다 WEBTOBDIR 참조사항과주의할사항 GUI 의버튼같은컴포넌트 가실제설치된디렉토리 예 )c:\tmaxsoft\4.1 wsboot [ 파라미터 ] 콘솔명령어와문법 옵션파라미터 < xyz > < 와 > 사이의내용이실제값으로변경됨 선택사항. 예 ) A B: A 나 B 중하나 파라미터등이반복되어서나옴?, +, * 보통 XML 문서에각각 없거나, 한번, 한번이상, 없거나, 여러번 을나타낸다. 5 TmaxSoft
... XML 이나코드등의생략 <<FileName.ext>> 코드의파일명 그림 1. 그림이름이나표이름 제품별기능 제품구분 Base 제공기능 HTML, CGI, PHP, SSI, SSL, WBAPI Standard Base 제공기능, Multi-Node, JSP/Servlet, Load Balancing, Fail-Over TmaxSoft 6
연락처 Korea Tmax Soft Co., Ltd 18F Glass Tower, 946-1, Daechi-Dong, Kangnam-Gu, Seoul 135-708 South Korea Tel: 82-2-6288-2114 Fax: 82-2-6288-2115 Email: info@tmax.co.kr Web (Korean): http://www.tmax.co.kr USA Tmax Soft, Inc. 560 Sylvan Ave, Englewood Cliffs NJ 07632 USA Tel: 1-201-567-8266 FAX: 1-201-567-7339 Email: info@tmaxsoft.com Web (English): http://www.tmaxsoft.com Japan Tmax Soft Japan Co., Ltd. 6-7 Sanbancho, Chiyoda-ku, Tokyo 102-0075 Japan Tel: 81-3-5210-9270 FAX: 81-3-5210-9277 Email: info@tmaxsoft.co.jp Web (Japanese): http://www.tmaxsoft.co.jp China Beijing Silver Tower, RM 1507, 2# North Rd Dong San Huan, Chaoyang District, Beijing, China, 100027 Tel: 86-10-6410-6148 Fax: 86-10-6410-6144 E-mail : info@tmaxchina.com.cn Web (Chinese): http://www.tmaxchina.com.cn 7 TmaxSoft
TmaxSoft 8
1 의소개 본장에서는 를설치할때, 미리고려하여야할사항에대한설명과 의특징에대해기술한다. 1.1 란? 는 Web to Business 에서따온이름이며 Web 상에서 Browser 의 요구를처리하여주는 Server 용소프트웨어이다. Web Server 시장의 대략 60% 를상회하는 Apache 와의호환성을위주로, 더나은성능과 안정성, 그리고보안성을제공하기위해나온제품이다. 또한, 기존 Web Server 와의차별을위하여 만의새로운기능들을 추가하였다. 에서제공하는서비스들은다음과같다. 다양한 HTML 문서들의처리 CGI 및 WBAPI 지원 SSI(Server Side Include) 지원 PHP Script Language 지원 JEUS 연동 / Tmax 연동 ACL 및 SSL 등다양한보안서비스지원 Servlet 및 JSP 지원 (Standard Edition) Multi-Node (Standard Edition) Load Balancing / Fail-Over (Standard Edition) 9 TmaxSoft
2 설치전확인사항 2.1 제품확인 - 제품 CD-ROM 1 매 - 제품라이센스및보증서및매뉴얼 2.2 Full Installer 지원플랫폼정보및요구환경 지원플랫폼정보 요구환경 운영체제 CPU 메모리 CGI,WBAPI 사용시 Servlet 사용시 IBM AIX V 4.3, V5.x 32bit/64bit IBM PowerPC 512MB Compaq Tru64 5.1 Compaq Alpha 512MB AIX C 컴파일러 Compaq ANSI C JDK 1.4.2 또는그이상 HP-UX 11.xx 32bit/64bit HP PA-RISK 512MB HP-UX ANSI C HP-UX 11.xx 32bit/64bit Intel Itanium 512MB HP-UX ANSI C Linux K.2.4 이상 (32bit) Intel i386 Processor 512MB GNU ANSI C Linux K.2.4 이상 (64bit) Intel Itanium 512MB GNU ANSI C TmaxSoft 10
SunOS 5.7~5.9 32bit/64bit UltraSPARC 512MB SUN ANSI C SunOS 5.8~5.9 32bit Intel i386 Processor 512MB SUN ANSI C Windows 2000/XP/2003 Intel i386 Processor 512MB Microsoft Visual C++ 5.0 또는그이상 위에언급된최소한의필요환경에대한요구사항과함께기본적으로 TCP/IP 네트워크환경, 설치에필요한 500Mbytes 이상의 Disk 용량및 /tmp 디렉토리권한등이필요하다. 이외에도 설치환경은각사이트의컨텐츠종류와양, 사용자수등많은주변환경과변수에따라최적의환경을구성해야한다. 2.3 시스템환경파악 를설치하기위해서는다음을확인한후설치한다. 호스트이름확인 ( 라이센스요청시필요 ) UNIX System 의경우 - uname n 명령또는 /etc/hosts 파일확인 Windows 계열의경우 - 시스템환경변수를보고찾음 가제공하는유틸리티프로그램을이용 - 를설치한뒤생기는 /license 디렉터리안의 ncpu 를실행하여정확한호스트이름 (HOSTNAME1) 을얻을수있다. Web Server 기동시에부여될포트번호 (default : 80) Web Server 를기동시킬계정 (default : root) 11 TmaxSoft
Note : Default 로지정되는 80 포트는 root 사용자가아니면사용할수없다. 따라서, root 계정이아닌사용자는 1024 번이후의포트를설정하여사용해야한다. 2.3.1 호스트이름 를정상적으로기동시키기위해서는반드시제품에대한라이센스가필요하며, 환경파일을설정해야한다. 그리고이작업을위해서는호스트이름을알아야한다. 는인스톨과정에서호스트이름과 IP Address 를자동으로찾아내어환경파일에등록하여준다. 시스템의 IP 주소와호스트이름을알아내는방법은다음과같으며, 대표적으로 SUN Solaris 경우의예를들었다. Ex 1] SUN Solaris System $ ifconfig a lo0: flags=849<up,loopback,running,multicast> mtu 8232 inet 127.0.0.1 netmask ff000000 hme0: flags=863<up,broadcast,notrailers,running,multicast> mtu 1500 inet 192.168.1.10 netmask ffff0000 broadcast 192.168.255.255 $ uname n tmaxs1 여기에서호스트이름이 FQDN(Fully Qualified Domain Name) 형식으로출력이된다면맨앞에있는이름만설정하면된다. 2.3.2 포트번호 가기동될때, 외부클라이언트 ( 인터넷브라우저 ) 로부터의연결을기다리는 Port 가필요하게된다. 일반적으로 Web Server 를설치하게되면디폴트로 80 번 Port 를이용하게된다. 그러나대부분의운영체제에서이 Port 번호는수퍼유저가아니면이용할수없게된다. 80 번호를사용하기위해서는 root 권한을가져야하며, 일반사용자계정으로 를설치하고자한다면 1024 번이후의 Port 번호를사용하면된다. TmaxSoft 12
또한 에서사용할 Port 번호가다른프로그램에의해서이미사용되고있는지도확인해야한다. 환경파일에포트번호를등록하기전에이러한사항을확인후설정한다. 다른 Port 를설정하여이용한다면, 사용자에게이 Port 를알려주어야할것이다. 그리고 Port 번호가 80 이아닌경우에브라우저는아래와같이서비스요청을해야한다. EX] Web Server 의 Port 번호가 8080 일경우 http://www.tmax.co.kr:8080/index.html 2.3.3 환경변수 를설치하기전에자신의시스템환경파일을반드시살펴보도록한다. 이전에 가설치되었는지또는 Servlet Engine 을함께설치하고자할때는이전에 Servlet Engine 을설치한내용이있는지확인한후관련환경변수들을삭제하는것을권장한다. 이는적용된설치 path 가혼동될수가있고새로이설치하려는 Servlet Engine 이 Shared Memory 충돌을일으켜정상적인인스톨을못하는경우가발생할수있기때문이다. 2.3.4 JDK 버전확인 (Standard Edition : Servlet engine 설치시 ) Standard Edition 에서 Servlet Engine 을함께인스톨할경우에필요한주의사항들이있다. 인스톨을하기전에반드시 $which java Command Line 을수행하여 jdk path 가잡혀있는지확인해야한다. 이는 Servlet Engine 설치과정에서 Security 와관련한 Password 값을인코딩해야하기때문이다. 따라서이전에 JDK가설치되어있지않으면아래사이트에서자신의 TM OS에맞는 Java 2 SDK v1.4.2 또는그이상의 Standard Edition을 download 하여미리설치해두어야한다. http://java.sun.com/j2se/ JDK version 은 Java version 1.4.2 (HopSpot Server 포함 ) 또는그이상의버전을설치하도록한다. 설치후반드시 JDK 가정상적으로설치되었는지확인한다. 2.3.5 File Descriptor 확인 File Descriptor(FD) 는 에서동시에띄울수있는프로세스수및동시접속자수에영향을미친다. 13 TmaxSoft
따라서 FD 값이동시에띄울프로세스수와동시접속자수를합한값보다크게설정되어있는지확인하여야한다. 단, 에서최적의성능을내기위하여 FD 를 Unix 의경우는최대 8192 개까지사용하며, Linux, Windows 의경우는최대 1024 개까지사용한다. 2.4 평가판 소프트웨어의배포 Tmax 제품은인터넷을통해사용자가직접다운로드하여테스트할수있는기회를제공하고있다. 제품을내려받을수있는 URL 은다음과같다. htt://technet.tmax.co.kr Tmax Soft 는정식으로 Tmax 제품군을미리사용해볼수있도록평가라이센스를제공하며평가판은기능상의제한은두지않고사용기간만을제한하고있다. 평가기간은 3 개월이다. 다음은 Tmax 제품과관련해서연락을취할수있는 URL 주소이다. 기술지원홈페이지 : http://technet.tmax.co.kr 데모라이센스발급 : http://technet.tmax.co.kr ( 다운로드 -> 라이센스신청 ) TmaxSoft 14
3 설치하기 3.1 설치과정 Web Server 를설치하는기본적인절차는다음과같다. Step 1 가지원하는플랫폼과운영체제등기본시스템의사양이갖추어졌는지확인한다. Step 2 설치하려고하는 Server 에다른 Web Server 나 의기존 Version 이설치되어있는지확인한다. 다른 Web Server 를이미사용하고있다면, 이용하려는포트번호가중복되지않는지확인하고필요하다면해당 Web Server 를중지시킨다. Step 3 위의모든작업이우선적으로이루어진후, Server 에설치하고사용한다. 를원하는 Step 4 설치가끝난후에는라이센스파일을적용시키도록한다. Web Server 는평가판이라할지라도 License 파일이있어야사용할수있다. 평가판의경우에는사용기한에제한이있기때문에사전에이를반드시확인하여야한다. 3.2 Unix/Linux 에서 설치 이번장에서는 Unix/Linux 환경하에서 4 의설치에대해설명할것이다. Unix 에서의 인스톨러는 Windows NT/2000 등의환경과는달리 command 기반으로되어있다. 에서는간단한작업만으로설치를가능하게하였으므로이장에서설명하는부분만을가지고충분히쉽게설치할수있다. 15 TmaxSoft
3.2.1 설치하기 () Solaris, HP, AIX, Compaq, Linux 에서이루어지는 와 Servlet Engine 의설치과정은모두동일하며, 설치과정은 Text 기반으로이루어지고있기때문에 Terminal 을이용해서설치할수있다. 인스톨러에서기본적으로 Default 설정값을제시하고있지만항상설정값입력시에주의를기울여야할것이다. 만약이전단계로돌아가고싶다면 back 이라고입력한다. 는설치과정에서 /tmp 디렉토리를사용한다. 설치계정은이디렉토리에대한권한이있어야한다. 3.2.1.1 설치파일실행설치는해당플랫폼별설치파일 (*.bin) 을실행시키는것으로시작한다. Ex) $ webtob-41-aix-ppc.bin Preparing to install... Extracting the JRE from the installer archive... Unpacking the JRE... Extracting the installation resources from the installer archive... Configuring the installer for this system's environment... Launching installer... Preparing CONSOLE Mode Installation... ================================================================ (created with InstallAnywhere by Zero G) ---------------------------------------------------------------- ================================================================ Introduction ------------ InstallAnywhere will guide you through the installation of Full AIX. TmaxSoft 16
It is strongly recommended that you quit all programs before continuing with this installation. Respond to each prompt to proceed to the next step in the installation. If you want to change something on a previous step, type 'back'. You may cancel this installation at any time by typing 'quit'. PRESS <ENTER> TO CONTINUE: 설치파일을실행시키면 를설치하기위한준비작업을진행한후간단한사용안내와함께계속진행여부를선택하도록한다. 계속진행하고자하면 <ENTER> 키를입력하고중단하고자하면 quit 를입력한다. 3.2.1.2 License 동의 라이센스에관한내용을보여주고그것의동의여부를묻는다. Ex) ================================================================ License Agreement ----------------- Installation and use of Full AIX requires acceptance of the following License Agreement: Release Tmax Soft Co., Ltd. (hereafter, Tmax Soft) End-User License Agreement Product : This is a legal agreement between you (either an individual or an company) 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. 17 TmaxSoft
Tmax Soft License 1. Grant of License: This Tmax Soft License Agreement ("License") permits you to use one copy of the Tmax Soft product Tmax, 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 devices) 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 PRESS <ENTER> TO CONTINUE: 다음페이지를계속해서보려면 <ENTER> 키를입력하고설치를중단하고자하면 quit 를입력한다. 아래는 <ENTER> 키를입력하여라이센스를끝까지본것이다. Ex) 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 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 materials TmaxSoft 18
(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, lease, or transfer your rights under this license on a permanent 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 engine, decompile, or disassemble the software, except to the extent that the foregoing restriction is expressly prohibited by applicable law. PRESS <ENTER> TO CONTINUE: DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): 라이센스에관한내용이모두보여지고나면그에대한동의여부를 묻는다. Y 를선택하여라이센스에동의하면다음단계로계속 진행하며 N 을 선택하여 라이센스에 동의하지 않으면 설치는 중단된다. 19 TmaxSoft
3.2.1.3 OS 선택 라이센스에동의하면 OS 의상세버전을선택하기위한단계가나온다. Ex) ================================================================ Choose Operating System ------------------------ 1) IBM (AIX 4.x 5.x 32 Bit) 2) IBM (AIX 4.x 64 Bit) 3) IBM (AIX 5.x 64 Bit) Quit : quit Choose Operating System (DEFAULT: 3): OS 리스트중에서선택하며, 인스톨러가 default 로선택한 OS 를그대로적용시키고자할때는 <ENTER> 키를입력해도된다. OS 를선택하고나면다시한번확인질문이나온다. Ex) ================================================================ Confirm Message --------------- Your choice is "IBM (AIX 5.x 64 Bit)" To continue, select 'OK'. To change OS Platform, select 'Back' ->1- OK 2- Back ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 다시 OS 를선택할수있으며, 기선택한것으로진행하고자하면 <ENTER> 키를입력한다. TmaxSoft 20
3.2.1.4 Install Set 선택 Standard Edition 에서제공되는 Servlet Engine 과함께설치하고자하는경우 1 번을선택한다. Servlet Engine 기능은데모라이센스에서제한없이제공되지만정식라이센스로적용시반드시 Standard 라이센스를적용해야한다. 만설치하고자하는경우는 2번을선택한다. 이장에서는 만설치하는경우에대해서설명한다. Servlet Engine 과함께설치하는경우는 [3.2.2 설치하기 (+Servlet Engine)] 에따로설명할것이므로해당장을참고하기바란다. Ex) ================================================================ Choose Install Set ------------------ Please choose the Install Set to be installed by this installer. ->1- Servlet + WebToB 2- WebToB ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 3.2.1.5 설치경로설정 가설치될디렉토리를설정한다. 직접절대경로를입력하거나 Default Install Folder 로나오는디렉토리선택시 <ENTER> 키를입력한다. Ex) ================================================================ Choose Install Folder --------------------- Where would you like to install? Default Install Folder: /data/wbqas/webtob 21 TmaxSoft
ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 3.2.1.6 설치정보확인 파일의설치에앞서제품, 설치경로, Install Set(Servlet Engine 설치여부 ), 디스크용량정보등을확인한다. 계속진행하고자하는경우 <ENTER> 키를입력하고, 중단하고자할경우 quit 를입력한다. Ex) ================================================================ Pre-Installation Summary ------------------------ Please Review the Following Before Continuing: Product Name: Full AIX Install Folder: /data/wbqas/webtob Install Set WebToB Disk Space Information (for Installation Target): Required: 60,835,404 bytes Available: 370,405,376 bytes PRESS <ENTER> TO CONTINUE: 3.2.1.7 준비확인 설치정보를확인하면설치준비여부를다시한번확인한다. 준비되었다면 <ENTER> 키를입력하여계속진행시키고, 중단하고자하면 quit 를입력한다. Ex) TmaxSoft 22
================================================================ Ready To Install ---------------- Ready to install Full AIX onto your system at the following location: /data/wbqas/webtob PRESS <ENTER> TO INSTALL: 3.2.1.8 파일설치작업 파일을설치하고, 설치에필요한작업들을수행한후설치성공메시지를보여준다. <ENTER> 키입력으로인스톨러를마친다. Ex) ================================================================ Installing... ------------- [=============== =============== =============== ==============] [--------------- --------------- --------------- --------------] ================================================================ Installation Complete --------------------- Congratulations. Full AIX has been successfully installed to: /data/wbqas/webtob PRESS <ENTER> TO EXIT THE INSTALLER: 3.2.1.9 설치확인 설치경로확인 23 TmaxSoft
지정된설치경로로디렉토리가생성되고그하위에파일들이설치됨을확인한다. $ cd $WEBTOBDIR $ ls UninstallerData ap bin cgi-bin config docs icons lib license log path ssl svct usrinc 환경변수확인.profile(ksh 기준 ) 에 다음과 같이 환경변수가 등록됨을 확인한다. Ex) 환경변수등록예 (.profile) # New environment setting added by Full AIX on Tue Jul 19 11:22:43 KST 2005 1. # The unmodified version of this file is saved in /data/wbqas/.profile2048646812. # Do NOT modify these lines; they are used to uninstall. WEBTOBDIR=/data/wbqas/webtob export WEBTOBDIR # End comments by InstallAnywhere on Tue Jul 19 11:22:43 KST 2005 1. # New environment setting added by Full AIX on Tue Jul 19 11:22:43 KST 2005 2. # The unmodified version of this file is saved in /data/wbqas/.profile2048646812. # Do NOT modify these lines; they are used to uninstall. TmaxSoft 24
PATH="${WEBTOBDIR}/bin:${PATH}" export PATH # End comments by InstallAnywhere on Tue Jul 19 11:22:43 KST 2005 2. # New environment setting added by Full AIX on Tue Jul 19 11:22:43 KST 2005 3. # The unmodified version of this file is saved in /data/wbqas/.profile2048646812. # Do NOT modify these lines; they are used to uninstall. LIBPATH="${WEBTOBDIR}/lib:${LIBPATH}" export LIBPATH # End comments by InstallAnywhere on Tue Jul 19 11:22:43 KST 2005 3. 3.2.2 설치하기 (+Servlet Engine) Servlet Engine 은 Standard 에서제공하는기능이다. 이장에서는설치과정중에서 Servlet Engine 의설치를선택한경우그이후의설치과정에대해서만기술하므로그이전부분은 [3.2.1 설치하기 ()] 를참조해야한다. 3.2.2.1 Install Set 선택 Servlet Engine 을설치할것인지 Install Set 선택단계에서결정한다. Ex) ================================================================ Choose Install Set ------------------ Please choose the Install Set to be installed by this installer. ->1- Servlet + WebToB 2- WebToB ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 25 TmaxSoft
3.2.2.2 설치경로설정 가설치될디렉토리를설정한다. 직접절대경로를입력하거나 Default Install Folder 로나오는디렉토리선택시 <ENTER> 키를입력한다. Ex) ================================================================ Choose Install Folder --------------------- Where would you like to install? Default Install Folder: /data/wbqas/webtob ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 3.2.2.3 JDK 경로설정 Servlet Engine 에서사용할 JDK 의경로를직접입력하거나 Default 로찾아주는경로를선택할경우 <ENTER> 키를입력한다. Ex) ================================================================ Choose JDK Folder ----------------- Please Choose a Folder: Input User JDK Folder (DEFAULT: /usr/java142): 3.2.2.4 Servlet Engine 관리자패스워드설정 Servlet Engine 의관리자계정 (administrator) 에대한패스워드를입력하고다시한번확인입력한다. TmaxSoft 26
Ex) ================================================================ Password Input -------------- Enter the Password for the administrator account. This password will be registered in JEUS as the first user. Input Password:: Confirm Password:: 3.2.2.5 설치정보확인 파일의설치에앞서제품, 설치경로, Install Set(Servlet Engine 설치여부 ), 디스크용량정보등을확인한다. 계속진행하고자하는경우 <ENTER> 키를입력하고, 중단하고자할경우 quit 를입력한다. Ex) ================================================================ Pre-Installation Summary ------------------------ Please Review the Following Before Continuing: Product Name: Full AIX Install Folder: /data/wbqas/webtob Install Set Servlet + WebToB Disk Space Information (for Installation Target): Required: 138,502,209 bytes Available: 543,477,760 bytes PRESS <ENTER> TO CONTINUE: 27 TmaxSoft
3.2.2.6 준비확인 설치정보를확인하면설치준비여부를다시한번확인한다. 준비되었다면 <ENTER> 키를입력하여계속진행시키고, 중단하고자하면 quit 를입력한다. Ex) ================================================================ Ready To Install ---------------- Ready to install Full AIX onto your system at the following location: /data/wbqas/webtob PRESS <ENTER> TO INSTALL: 3.2.2.7 파일설치작업 파일을설치하고, 설치에필요한작업들을수행한후설치성공메시지를보여준다. <ENTER> 키입력으로인스톨러를마친다. Ex) ================================================================ Installing... ------------- [=============== =============== =============== ==============] [--------------- --------------- --------------- --------------] ================================================================ Installation Complete --------------------- Congratulations. Full AIX has been successfully installed to: /data/wbqas/webtob PRESS <ENTER> TO EXIT THE INSTALLER: TmaxSoft 28
3.2.2.8 설치확인 설치경로확인 지정된설치경로로디렉토리가생성되고그하위에파일들이설치됨을확인한다. $ cd $WEBTOBDIR $ ls UninstallerData ap bin cgi-bin config docs icons jeus lib license log path ssl svct usrinc 환경변수확인.profile(ksh 기준 ) 에 다음과 같이 환경변수가 등록됨을 확인한다. Ex) 환경변수등록예 (.profile) # New environment setting added by Full HP on Fri Nov 11 20:15: 42 MST 2005 1. # The unmodified version of this file is saved in /data/wbqas/.profil e803416435. # Do NOT modify these lines; they are used to uninstall. W2B_JEUSHOME=/data/wbqas/webtob/jeus export W2B_JEUSHOME 29 TmaxSoft
# End comments by InstallAnywhere on Fri Nov 11 20:15:42 MST 2005 1. # New environment setting added by Full HP on Fri Nov 11 20:15: 42 MST 2005 2. # The unmodified version of this file is saved in /data/wbqas/.profil e803416435. # Do NOT modify these lines; they are used to uninstall. PATH="${W2B_JEUSHOME}/bin:${PATH}" export PATH # End comments by InstallAnywhere on Fri Nov 11 20:15:42 MST 2005 2. # New environment setting added by Full HP on Fri Nov 11 20:15: 42 MST 2005 3. # The unmodified version of this file is saved in /data/wbqas/.profil e803416435. # Do NOT modify these lines; they are used to uninstall. WEBTOBDIR=/data/wbqas/webtob export WEBTOBDIR # End comments by InstallAnywhere on Fri Nov 11 20:15:42 MST 2005 3. # New environment setting added by Full HP on Fri Nov 11 20:15: 42 MST 2005 4. # The unmodified version of this file is saved in /data/wbqas/.profil e803416435. # Do NOT modify these lines; they are used to uninstall. PATH="${WEBTOBDIR}/bin:${PATH}" export PATH # End comments by InstallAnywhere on Fri Nov 11 20:15:42 MST 2005 4. # New environment setting added by Full HP on Fri Nov 11 20:15: TmaxSoft 30
42 MST 2005 5. # The unmodified version of this file is saved in /data/wbqas/.profil e803416435. # Do NOT modify these lines; they are used to uninstall. LIBPATH="${WEBTOBDIR}/lib:${LIBPATH}" export LIBPATH # End comments by InstallAnywhere on Fri Nov 11 20:15:42 MST 2005 5. 3.3 Windows 에서 설치 이장에서는 Windows 에서의 설치에대해설명한다. windows 에서는 GUI 로인스톨과정이진행된다. 3.3.1 설치하기 ( ) 3.3.1.1 설치파일실행 설치를위해 webtob-41-win-32-x86.exe 를실행시킨다. 그림 3-3. 인스톨러준비화면 31 TmaxSoft
3.3.1.2 설치안내 그림 3-4. 설치안내화면 인스톨러를사용하여설치하는과정에있어서필요한사항들을안내한다. 다음단계로넘어갈때는 Next 버튼을, 이전단계로돌아갈때는 Previous 버튼을, 그리고설치과정을중단하고자할때는 Cancel 버튼을클릭한다. TmaxSoft 32
3.3.1.3 License 동의 그림 3-5. License 동의화면 라이센스에관한내용을보여주고그것의동의여부를묻는다. 라이센스에동의하면 I accept the terms of the License Agreement 를선택하고 Next 버튼을클릭하여다음단계로넘어간다. 라이센스에동의하지않으면다음단계로넘어갈수없다. 33 TmaxSoft
3.3.1.4 Install Set 선택 그림 3-6. Install Set 선택화면 Standard Edition 에서제공되는 Servlet Engine 과함께설치하고자하는경우 Servlet+ 를선택한다. Servlet Engine 기능은데모라이센스에서제한없이제공되지만정식라이센스로적용시반드시 Standard 라이센스를적용해야한다. 만설치하고자하는경우는아래에있는 를선택한다. 이장에서는 만설치하는경우에대해서설명한다. Servlet Engine 과함께설치하는경우는 [3.3.2 설치하기 (+Servlet Engine)] 에따로설명할것이므로해당장을참고하기바란다. TmaxSoft 34
3.3.1.5 설치경로설정 그림 3-7. 설치경로설정화면 가설치될디렉토리를설정한다. 직접절대경로를입력하거나 Choose 버튼으로탐색하여선택할수도있다. Default Install Folder 로나오는디렉토리설정시그대로 Next 버튼을클릭한다. 35 TmaxSoft
3.3.1.6 설치정보확인 그림 3-8. 설치정보확인화면 파일의설치에앞서제품, 설치경로, 디스크용량정보등을확인한다. 계속진행하고자하는경우 Install 버튼을선택하고, 수정할사항이있을때는 Previous 버튼을선택한다. 중단하고자할경우 Cancel 버튼을선택한다. TmaxSoft 36
3.3.1.7 파일설치작업 그림 3-9. 파일설치작업화면 그림 3-10. 설치완료화면 37 TmaxSoft
파일을설치하고, 설치에필요한작업들을수행한후설치성공메시지를보여준다. 3.3.1.8 설치확인 설치경로확인 지정된설치경로로디렉토리가생성되고그하위에파일들이설치됨을확인한다. 그림 3-11. 설치디렉토리구조 환경변수확인 다음과같이환경변수가등록됨을확인한다. Ex) 환경변수등록예 WEBTOBDIR=C:\TmaxSoft\4.1 PATH=%WEBTOBDIR%\bin;%WEBTOBDIR%\lib; 3.3.2 설치하기 ( + Servlet Engine ) Servlet Engine 은 Standard 에서제공하는기능이다. 이장에서는설치과정중에서 Servlet Engine 의설치를선택한경우그이후의설치과정에대해서만기술하므로그이전부분은 [3.3.1 설치하기 ()] 를참조해야한다. TmaxSoft 38
3.3.2.1 Install Set 선택 그림 3-12. Install Set 선택화면 Servlet Engine 을설치할것인지 Install Set 선택단계에서결정한다. 39 TmaxSoft
3.3.2.2 설치경로설정 그림 3-13. 설치경로설정화면 가설치될디렉토리를설정한다. 직접절대경로를입력하거나 Choose 버튼으로탐색하여선택할수도있다. Default Install Folder 로나오는디렉토리선택시그대로 Next 버튼을클릭한다. TmaxSoft 40
3.3.2.3 JDK 경로설정 그림 3-14. JDK 경로설정화면 Servlet Engine 에서사용할 JDK 의경로를설정한다. 직접절대경로를입력하거나 Choose 버튼을이용하여탐색할수도있다. Default 로제시되는경로를그대로사용할경우 Next 버튼을이용, 다음단계로넘어간다. 41 TmaxSoft
3.3.2.4 Servlet Engine 관리자패스워드설정 그림 3-16. Servlet Engine 관리자패스워드설정화면 Servlet Engine 의관리자계정 (administrator) 에대한패스워드를입력하고다시한번확인입력한다. TmaxSoft 42
3.3.2.5 설치정보확인 그림 3-17. 설치정보확인화면 파일의설치에앞서제품, 설치경로, 디스크용량정보등을확인한다. 계속진행하고자하는경우 Install 버튼을선택하고, 수정할사항이있을때는 Previous 버튼을선택한다. 중단하고자할경우 Cancel 버튼을선택한다. 43 TmaxSoft
3.3.2.6 파일설치작업 그림 3-18. 파일설치작업화면 그림 3-19. 설치완료화면 TmaxSoft 44
파일을설치하고, 설치에필요한작업들을수행한후설치성공메시지를보여준다. 3.3.2.7 설치확인 설치경로확인 지정된설치경로로디렉토리가생성되고그하위에파일들이설치됨을확인한다. 그림 3-20. 설치디렉토리구조 환경변수확인 다음과같이환경변수가등록됨을확인한다. Ex) 환경변수등록예 ( 사용자환경변수 ) WEBTOBDIR=C:\TmaxSoft\4.1 PATH=%WEBTOBDIR%\bin;%WEBTOBDIR%\lib;%W2B_JEUSHOME%\bin;%W 2B_JEUSHOME%\lib\system; W2B_JEUSHOME=C:\TmaxSoft\4.1\jeus 45 TmaxSoft
4 기동및종료 가정상적으로설치되고동작하는지간단히알아보기위해 를시험기동해보도록한다. 이장에서는환경파일작성과컴파일, 그리고기동및종료에대해정상동작만확인해볼수있도록매우간단하게설명할것이므로보다자세한사항은 관리자안내서 를참조하도록한다. 4.1 License 발급 를사용하기위해서는반드시 License 가필요하다. 정식라이센스발급이전에데모라이센스를발급받고사용하기위한절차는다음과같다. hostname 확인 데모라이센스신청시 hostname 을입력해야하므로해당머신의 hostname 을확인한다. hostname 확인은아래예와같이 hostname 명령이나 설치시 $WEBTOBDIR/license 디렉토리에생성되는 ncpu 로확인가능하다. Ex 1) $ hostname Gloria Ex 2) $ $WEBTOBDIR/license/ncpu HOST NAME1: gloria HOST NAME2: GLORIA Volume[C:\] type: NTFS Volume[C:\] serial: 3C358980 NCPUS: 1 IPADDRESS: 192.168.1.174 192.168.19.1 192.168.114.1 TmaxSoft 46
라이센스신청 http://technet.tmax.co.kr 으로접속하여 다운로드 -> 라이센스신청 화면으로들어온다. 제품명, 호스트 (hostname), E-mail 주소등의정보를입력하여라이센스를신청한다. 입력한 E-mail 주소로데모라이센스가전송된다. 라이센스적용 받은데모라이센스를 $WEBTOBDIR/license license.dat 라는파일명으로놓는다. 디렉토리에 데모라이센스적용시 3 개월간기능의제약없이사용할수있다. 4.2 환경파일작성및컴파일 를기동해보기위해선환경파일을작성하고컴파일해야한다. 환경파일은 $WEBTOBDIR/config 디렉토리에 sample.m 이라는파일이기본적으로들어있으므로이를활용한다. sample.m 을열어서 SHMKEY 항목과 PORT 항목을확인한다. SHMKEY 항목이다른프로그램과충돌나는경우 를기동시킬때에러메세지가발생하므로수정해주도록한다. 또한 PORT 항목이이미사용중인포트번호일경우올바른 동작을기대할수없으므로중복되지않는번호로설정해주도록한다. 이를확인하였으면다음과같이환경파일을컴파일한다. $ wscfl i sample.m Current configuration: Number of client handler(hth) = 1 Supported maximum user per node = 4037 Supported maximum user per handler = 4037 CFL is done successfully for node(tmaxh4(tmaxh4)) 컴파일후 wsconfig 라는파일이생겼음을확인한다. 47 TmaxSoft
4.3 기동 기동은다음과같이 wsboot 명령어로실행한다. $ wsboot WSBOOT for node(tmaxh4) is starting: Welcome to demo system: it will expire 2005/10/26 Today: 2005/8/17 WSBOOT: WSM is starting: Wed Aug 17 23:14:15 2005 WSBOOT: HTL is starting: Wed Aug 17 23:14:15 2005 WSBOOT: HTH is starting: Wed Aug 17 23:14:15 2005 Current Configuration: Number of client handler(hth) = 1 Supported maximum user per node = 4037 Supported maximum user per handler = 4037 WSBOOT: SVR(htmls) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(htmls) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(htmls) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(htmls) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(cgis) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(cgis) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(cgis) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(cgis) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(ssis) is starting: Wed Aug 17 23:14:15 2005 WSBOOT: SVR(ssis) is starting: Wed Aug 17 23:14:15 2005 를기동시켰으면브라우저로요청을보내본다. http://<ip-address>:<port>/ 화면에다음과같이나오면 가정상적으로기동되어동작하는것이다. TmaxSoft 48
그림 4-1. 샘플페이지 4.4 종료 를종료하기위해서는다음과같이 wsdown 명령어를수행한다. $ wsdown Do you really want to down whole? (y : n): y WSDOWN for node(tmaxh4) is starting: WSDOWN: SERVER(html1:10) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(html:1) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(cgi:22) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(html:0) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(cgi:20) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(ssi:30) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(cgi:21) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(ssi:31) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(html1:11) downed: Wed Aug 17 23:21:23 2005 WSDOWN: SERVER(cgi:23) downed: Wed Aug 17 23:21:23 2005 WSDOWN: HTL downed: Wed Aug 17 23:21:23 2005 49 TmaxSoft
WSDOWN: HTH downed: Wed Aug 17 23:21:23 2005 WSDOWN: WSM downed: Wed Aug 17 23:21:23 2005 WSDOWN: WEBTOB is down 4.5 Windows 에서 서비스등록과제거 4.5.1 소개 는 Windows 운영체제에서 Windows 서비스로서동작할수있도록설계되었다. 이기능을사용하려면, 폴더에있는서비스를실행한다. 이다음은 Windows NT 서비스로동작하도록 를등록한다. 4.5.2 서비스등록 srvinstall.exe 가위치한 %WEBTOBDIR% 아래 bin 디렉토리로이동한다. ( 기본 : C:\TmaxSoft\4.1\bin) srvinstall.exe 파일을실행하면 Windows 에서비스로서 를등록한다. 를윈도우서비스로등록하려면다음과같이실행한다. c:\tmaxsoft\4.1\bin> srvinstall.exe Webtob service installed 4.5.3 서비스를사용할때 동작 Windows 에서시작 설정 제어판 관리도구 서비스를클릭하면서비스창에서 서비스가확인된다. 서비스명을더블클릭하면시작, 중지, 일시중지, 계속버튼이나타난다. 시작버튼을클릭하면서비스가시작된다. 이것은설치파일에등록된 Engine 과기타서비스들이로딩된다는것을나타낸다. 서비스를중지하기위하여중지버튼을클릭할수있다. 단, 최초설치후재부팅을하지않았을경우 LocalSystem 권한으로실행시키면환경변수가적용되지않아서 WEBTOBDIR is not set 에러가발생할수있다. LocalSystem 권한으로 를실행하고자한다면재부팅후사용하여야한다. 권한변경에관한설명은 관리자안내서 를참고하기바란다. TmaxSoft 50
4.5.4 서비스제거 서비스를중지하기위해서 Windows 에서시작 설정 제어판 관리도구 서비스를선택한다. 서비스를영구히제거하기위하여 %WEBTOBDIR%\bin 디렉토리의 srvremove.exe 를실행한다. c:\tmaxsoft\4.1\bin> srvremove.exe Webtob service removed 51 TmaxSoft
5 제거하기 (Uninstall) 5.1 Unix/Linux 에서의 제거 5.1.1 Uninstaller 실행 를제거하기위해 Uninstaller 가다음위치에제공된다. $WEBTOBDIR/UninstallerData/Uninstall 이를다음과같이실행시키면 Uninstall 작업에대한안내메시지가출력된다. Uninstall 작업에서는설치시생성되었던파일과디렉토리를삭제하며설치후생성된파일에대해서는별도로삭제해야한다. $ Uninstall Preparing CONSOLE Mode Installation... ================================================================ (created with InstallAnywhere by Zero G) ---------------------------------------------------------------- ================================================================ Uninstall Full AIX ------------------------- About to uninstall... Full AIX This will remove features installed by InstallAnywhere. It will not remove files and folders created after the installation. PRESS <ENTER> TO CONTINUE: TmaxSoft 52
5.1.2 Uninstall 작업 Uninstaller 실행후 <ENTER> 키입력으로계속진행하도록하면화면에아래예와같이보이면서각종파일삭제, 환경변수삭제등의작업을수행한다. Ex) ================================================================ Uninstalling......* * ************************* 5.1.3 Uninstall 작업완료 제거작업을성공적으로마쳤음을알리고 Uninstaller 실행을끝낸다. Ex) ================================================================ Uninstall Complete ------------------ All items were successfully uninstalled. 5.1.4 Uninstall 확인 파일삭제확인 설치했던파일들이모두삭제되었음을확인한다. 단, 설치이후생성된파일들은남아있을수있으므로별도로삭제해야한다. 환경변수삭제확인 설치시등록되었던환경변수들과 PATH 에설정되었던경로들이정상적으로삭제되었음을확인한다. 53 TmaxSoft
5.2 Windows 에서의 제거 5.2.1 Uninstaller 실행 를제거하기위해 Uninstaller 가다음위치에제공된다. %WEBTOBDIR%\UninstallerData\Uninstall 5.2.2 Uninstall 안내 그림 5-1.Uninstall 안내화면 Uninstall 실행시설치된파일들을제거한다. 그러나설치후생성된파일들은삭제되지않으므로 Uninstall 실행후별도로삭제해야한다. TmaxSoft 54
5.2.3 Uninstall 작업 그림 5-2. Uninstall 작업화면 설치파일, 폴더, 레지스트리등을제거하는작업을수행한다. 55 TmaxSoft
5.2.4 Uninstall 작업완료 그림 5-3. Uninstall 작업완료 제거작업을마쳤음을알리고삭제되지않은폴더에대해안내한다. 5.2.5 Uninstall 확인 파일삭제확인 설치했던파일들이모두삭제되었음을확인한다. 단, 설치이후생성된파일들은남아있을수있으므로별도로삭제해야한다. 환경변수삭제확인 설치시등록되었던환경변수들과 PATH 에설정된경로들이정상적으로삭제되었음을확인한다. TmaxSoft 56