쓰리래빗츠 2.0 설치가이드

2.0 쓰리래빗츠 2.0 설치가이드 ( 주 ) 쓰리래빗츠

이문서에잘못된정보가있을수있습니다. 쓰리래빗츠는이문서가제공하는정보의정확성을유지하기위해노력하고특별한언급없이이문서를지속적으로변경하고보완할것입니다. 그러나이문서에잘못된정보가포함되어있지않다는것을보증하지않습니다. 이문서에기술된정보로인해발생할수있는직접적인또는간접적인손해, 데이터, 프로그램, 기타무형의재산에관한손실, 사용이익의손실등에대해비록이와같은손해가능성에대해사전에알고있었다고해도손해배상등기타책임을지지않습니다. 사용자는본문서를구입하거나, 전자문서로내려받거나, 사용을시작함으로써, 여기에명시된 내용을이해하며, 이에동의하는것으로간주합니다. 각회사의제품명을포함한각상표는각개발사의등록상표이며특허법과저작권법등에의해보호를 받고있습니다. 따라서본문서에포함된기타모든제품들과회사이름은각각해당소유주의 상표로서참조용으로만사용됩니다. 지은이ㅣ쓰리래빗츠 발행일ㅣ 2013 년 9 월 30 일 발행처 ( 주 ) 쓰리래빗츠주소 (150-070) 서울시영등포구대림1동 700-19 전화 1661-3023 홈페이지 www.3rabbitz.com ( 주 ) 쓰리래빗츠, 2013

차례 차례........................................................................... v 그림차례 표차례........................................................................ ix......................................................................... xi 머리말.......................................................................... xiii 1. 시스템요구사항............................................................... 1 1.1 소프트웨어요구사항................................................................ 1 1.1.1 웹브라우저.................................................................... 1 1.1.2 서버소프트웨어 1.1.2.1 운영체제................................................................. 2................................................................... 2 1.1.2.2 자바...................................................................... 2 1.2 하드웨어요구사항 2. 윈도우설치가이드.................................................................. 2............................................................. 3 2.1 쓰리래빗츠설치파일내려받기......................................................... 3 2.2 쓰리래빗츠설치.................................................................... 5 2.3 쓰리래빗츠시작하기................................................................. 8 3. 윈도우설치가이드 (ZIP 버전 )...................................................... 11 3.1 자바 6.0 이상설치.................................................................. 11 3.1.1 자바설치여부와버전확인......................................................... 11 3.1.2 자바설치..................................................................... 13 3.1.3 JRE_HOME 또는 JAVA_HOME 환경변수설정............................................... 13 3.2 쓰리래빗츠설치 3.3 쓰리래빗츠시작 3.4 쓰리래빗츠종료 4. 리눅스설치가이드 4.1 자바 6.0 이상설치.................................................................... 16.................................................................... 16.................................................................... 17............................................................. 19.................................................................. 19 4.1.1 자바설치여부와버전확인......................................................... 19 4.1.2 자바설치..................................................................... 20 v

vi 차례 4.1.2.1 우분투 4.2 쓰리래빗츠설치 4.3 쓰리래빗츠시작 4.4 쓰리래빗츠종료 5. 맥 OS 설치가이드.................................................................... 20.................................................................... 21.................................................................... 22.................................................................... 22.............................................................. 23 5.1 자바 6.0 이상설치 5.1.1 자바버전확인 5.1.2 자바업데이트 5.2 쓰리래빗츠설치 5.3 쓰리래빗츠시작 5.4 쓰리래빗츠종료.................................................................. 23.................................................................. 23.................................................................. 24.................................................................... 26.................................................................... 26.................................................................... 27 6. 설치마법사................................................................... 29 6.1 설치마법사시작하기 6.2 설치마법사로설정하기................................................................ 29............................................................... 30 6.3 영어글꼴등록하기.................................................................. 34 부록 A. 윈도우서비스로시작........................................................ 35 A.1 파일다운로드..................................................................... 35 A.2 서비스에등록하기 A.3 서비스에서삭제하기.................................................................. 35................................................................. 36 A.4 기타설정......................................................................... 37 A.4.1 자바힙메모리설정.............................................................. 37 부록 B. 포트번호변경............................................................. 39 B.1 서비스포트번호변경 B.2 정지포트번호변경................................................................ 39................................................................. 40 부록 C. 아파치웹서버연동......................................................... 41 C.1 mod_jk 설치....................................................................... 41 C.1.1 C.1.2 리눅스에설치 윈도우에설치.................................................................. 41.................................................................. 42 C.2 mod_jk 설정....................................................................... 43 C.2.1 httpd.conf 을이용.............................................................. 43 C.2.2 mods-enable 디렉토리를이용해서활성화.............................................. 44 C.3 workers.properties 만들기........................................................... 44 C.3.1 C.3.2 리눅스에서사용하는파일 윈도우에서사용하는파일.......................................................... 45.......................................................... 47 C.4 아파치웹서버설정................................................................. 50 C.5 톰캣설정......................................................................... 63 부록 D. ISS 웹서버연동........................................................... 53

vii D.1 isapi_redirect.dll 설치............................................................... 53 D.2 isapi_redirect.dll 설정............................................................ 54 D.3 ISS 관리자설정.................................................................... 58 D.4 톰캣설정......................................................................... 63 부록 E. 오라클데이터베이스사용..................................................... 65 E.1 오라클데이터베이스 JDBC 드라이버추가.................................................. 65 E.2 환경설정파일변경................................................................. 65 부록 F. MS SQL 서버데이터베이스사용................................................ 67 F.1 MS SQL 서버 JDBC 드라이버추가....................................................... 67 F.2 환경설정파일변경.................................................................. 68 찾아보기........................................................................ 69

그림차례 3. 윈도우설치가이드 (ZIP 버전 )...................................................... 11 그림 3-1 명령프롬프트실행.............................................................. 12 그림 3-2 자바버전확인................................................................. 12 그림 3-3 컴퓨터속성메뉴열기............................................................ 13 그림 3-4 컴퓨터에대한기본정보보기....................................................... 14 그림 3-5 그림 3-6 그림 3-7 그림 3-8 시스템속성창환경변수창새시스템변수제품폴더구성................................................................. 14................................................................... 15................................................................. 15................................................................. 16 4. 리눅스설치가이드............................................................. 19 그림 4-1 자바버전확인................................................................. 20 그림 4-2 제품디렉터리구성.............................................................. 21 5. 맥 OS 설치가이드.............................................................. 23 그림 5-1 제품디렉터리구성.............................................................. 26 6. 설치마법사................................................................... 29 그림 6-1 최종사용자사용권계약서동의..................................................... 30 그림 6-2 그림 6-3 그림 6-4 기본정보입력 라이선스키입력 사용자만들기................................................................. 31................................................................ 32.................................................................. 33 부록 C. 아파치웹서버연동......................................................... 41 그림 C-1 그림 C-2 64 비트일때받는파일 32 비트일때받는파일........................................................... 43........................................................... 43 부록 D. ISS 웹서버연동........................................................... 53 그림 D-1 그림 D-2 64 비트일때받는파일 32 비트일때받는파일........................................................... 53........................................................... 54 그림 D-3 isapi_redirect.dll 사용에필요한파일및디렉터리..................................... 54 ix

표차례 머리말.......................................................................... xiii 주요서식............................................................................. xiv 1. 시스템요구사항............................................................... 1 표 1-1 지원하는웹브라우저.............................................................. 1 3. 윈도우설치가이드 (ZIP 버전 )...................................................... 11 표 3-1 환경변수....................................................................... 15 xi

머리말 이책의내용 쓰리래빗츠 2.0 설치가이드는쓰리래빗츠북과비주얼을설치하는방법을운영체제별로설명합니다. 쓰리래빗츠북을사용하는방법은쓰리래빗츠북사용자가이드를, 쓰리래빗츠비주얼을사용하는방법은 쓰리래빗츠비주얼사용자가이드를참고합니다. 이책은다음과같이구성되어있습니다. 윈도우 쓰리래빗츠를윈도우에설치하는방법을설명합니다. 1. 시스템요구사항 2. 윈도우설치가이드 6. 설치마법사 리눅스 쓰리래빗츠를리눅스에설치하는방법을설명합니다. 1. 시스템요구사항 4. 리눅스설치가이드 6. 설치마법사 맥 OS 쓰리래빗츠를맥 OS 에설치하는방법을설명합니다. 1. 시스템요구사항 xiii

xiv 머리말 5. 맥 OS 설치가이드 6. 설치마법사 부록 부록 A. 윈도우서비스로시작 : 윈도우서비스로등록하는방법을설명합니다. 부록 B. 포트번호변경 : 포트번호를변경하는방법을설명합니다. 부록 E. 오라클데이터베이스사용 : 데이터베이스로오라클을사용하는방법을설명합니다. 부록 F. MS SQL 서버데이터베이스사용 : 데이터베이스로 MS SQL 서버를사용하는방법을설명합니다. 부록 D. ISS 웹서버연동 : 아파치웹서버와쓰리래빗츠를연동하는방법을설명합니다. 일러두기 다음은이책에서사용한주요서식에대한설명입니다. 주요서식항목 설명 예 강조 강조가필요한단어및문장은진하게표기했습니다. 강조 메뉴, 버튼, 링크 메뉴, 링크, 버튼등은앞과뒤에 < 과 > 를넣어표기했습니다. < 저장 > 단축키 키보드에서동시에눌러야하는단축키는 + 로연결했습니다. 그리고고정폭글꼴로 Ctrl + I 표기했습니다. 코드, 파일이름 코드, 명령어, 파일이름등은고정폭글꼴로표기했습니다. 3RABBIZ_HOME 다음과같이노트, 팁, 주의를제공합니다. 노트는본문에간단하게추가할짧은설명이나참조, 논평을제공하기위해사용합니다. 팁은도움말등의팁을제공하기위해사용합니다. 주의는독자또는사용자의주의를환기하는문장을제공하기위해사용합니다.

오류신고및문의 xv 오류신고및문의 이책내용중기술적인오류나, 맞춤법오류또는수정하거나추가하기원하는내용이있다면다음이메일주소로보 내주세요. 이메일 : support@3rabbitz.com

1. 시스템요구사항 1.1 소프트웨어요구사항.................................................................... 1 1.1.1 웹브라우저....................................................................... 1 1.1.2 서버소프트웨어 1.1.2.1 운영체제.................................................................... 2...................................................................... 2 1.1.2.2 자바......................................................................... 2 1.2 하드웨어요구사항..................................................................... 2 쓰리래빗츠는자바로개발한서버애플리케이션으로, 설치후에웹브라우저로접속하여사용하는웹기반소프트웨 어입니다. 따라서일반사용자는별도로소프트웨어를설치할필요가없습니다. 다만서버에쓰리래빗츠를설치하기 위한하드웨어와소프트웨어가필요합니다. 이장에서는이에필요한정보를설명합니다. 여기서언급하는모든요구사항은최소요구사항입니다. 1.1 소프트웨어요구사항 1.1.1 웹브라우저 표 1-1 지원하는웹브라우저 웹브라우저 지원버전 운영체제 마이크로소프트인터넷익스플로러 8.0 이상 윈도우 모질라파이어폭스 최신버전기준 윈도우, 리눅스, 맥 OS 구글크롬 최신버전기준 윈도우, 리눅스, 맥 OS 애플사파리 최신버전기준 윈도우, 맥 OS, ios 1 1

2 시스템요구사항 HTML5 를지원하는웹브라우저만을사용할수있습니다. 쓰리래빗츠북에서문서를읽을때사용하는웹뷰어는인터넷익스플로러 6 7 과오페라 11 이상을지원합니다. 웹브라우저지원내역에대한상세정보는 < 쓰리래빗츠북사용자가이드 웹브라우저 > 를참고합니다. 1.1.2 서버소프트웨어 1.1.2.1 운영체제 자바 6 이상을설치할수있는운영체제를지원합니다. 1.1.2.2 자바 쓰리래빗츠는자바로개발한소프트웨어로이를실행하려면운영체제에오라클자바 6.0 이상을설치해야합니다. 자바버전은 5.0, 6.0, 7.0 등과 1.5, 1.6, 1.7 등으로이중표기됩니다. 6.0 과 1.6 은같은버전을지칭합 니다. IBM 자바는지원하고 OpenJDK 는지원하지않습니다. 1.2 하드웨어요구사항 쓰리래빗츠를최소 2GHz CPU / 최소 2G RAM / 최소 200G HDD 이상의하드웨어를갖춘서버에설치해야합니다. 하드웨어사양은책과사용자수에따라달라질수있고, 개인컴퓨터에설치하여사용할수도있습니다. 1 ios 5 이상을지원하는데일부기능은사용할수없습니다.

2. 윈도우설치가이드 2.1 쓰리래빗츠설치파일내려받기............................................................. 3 2.2 쓰리래빗츠설치....................................................................... 5 2.3 쓰리래빗츠시작하기.................................................................... 8 다음순서로쓰리래빗츠를윈도우에설치합니다. 윈도우 7 을기준으로설명합니다. 1. 쓰리래빗츠설치파일을내려받습니다. 2. 쓰리래빗츠설치파일을실행합니다. 3. 쓰리래빗츠를시작합니다. 4. 설치마법사를실행합니다. 2.1 쓰리래빗츠설치파일내려받기 쓰리래빗츠홈페이지에서설치파일을내려받습니다. 32 비트와 64 비트를구분해서내려받습니다. 이를확인하는방 법은다음과같습니다. 1. 윈도우탐색기를실행합니다. 2. 1 내컴퓨터를선택한후오른쪽마우스를클릭한후 2 속성메뉴를선택합니다. 3

4 윈도우설치가이드 3. 3 시스템종류에서 32 비트인지 64 비트인지를확인합니다.

쓰리래빗츠설치 5 2.2 쓰리래빗츠설치 윈도우 7 이상에서쓰리래빗츠를설치하면 PC 보호기능으로인해다음과같은안내창이나타날수있습니다. 윈도우 8 PC 보호안내창

6 윈도우설치가이드 1 추가정보를클릭하면나타나는화면에서 2 실행버튼을클릭하면설치를시작합니다. 윈도우 7 PC 보호안내창 1 실행버튼을클릭하면설치를시작합니다. 내려받은설치파일을실행합니다.

쓰리래빗츠설치 7 설치경로를선택합니다. C:\Program Files 폴더에는설치할수없습니다. 자바가없다면설치과정에서자바 (JRE) 를설치하기때문에오래걸릴수있습니다.

8 윈도우설치가이드 2.3 쓰리래빗츠시작하기 쓰리래빗츠를설치하면시작메뉴에다음메뉴가나타납니다. <Start 3Rabbitz Server> 메뉴로쓰리래빗츠를시작합니다. 다음과같이콘솔이나타납니다.

쓰리래빗츠시작하기 9 쓰리래빗츠를실행한후 <Access 3Rabbitz> 메뉴를선택하면기본웹브라우저로쓰리래빗츠에접근합니다. 처음실행했을때는라이선스키입력과기본설정을하는데필요한설치마법사가나타납니다. 자세한사항은 6. 설치마법사를참고합니다. 쓰리래빗츠를정지하려면시작메뉴에서 <Stop 3Rabbitz Server> 메뉴를선택하거나앞에나타난콘솔에서 Ctrl + C 키를누릅니다. 시작메뉴가없을때는다음순서로쓰리래빗츠를시작합니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한폴더를지칭합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. startup.bat 파일을실행합니다. 시작메뉴가없을때는다음순서로쓰리래빗츠를종료합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. shutdown.bat 파일을실행합니다.

3. 윈도우설치가이드 (ZIP 버전 ) 3.1 자바 6.0 이상설치..................................................................... 11 3.1.1 자바설치여부와버전확인............................................................ 11 3.1.2 자바설치......................................................................... 13 3.1.3 JRE_HOME 또는 JAVA_HOME 환경변수설정.................................................. 13 3.2 쓰리래빗츠설치 3.3 쓰리래빗츠시작 3.4 쓰리래빗츠종료....................................................................... 16....................................................................... 16....................................................................... 17 다음순서로쓰리래빗츠를윈도우에설치합니다. 윈도우 7 을기준으로설명합니다. 1. 자바 6.0 이상을설치합니다. 2. 쓰리래빗츠설치파일을내려받습니다. 3. 쓰리래빗츠설치파일압축을풉니다. 4. 쓰리래빗츠를시작합니다. 5. 설치마법사를실행합니다. 3.1 자바 6.0 이상설치 3.1.1 자바설치여부와버전확인 다음순서로자바설치여부와버전을확인합니다. 1. 윈도우 < 시작 > 메뉴실행창에 CMD 를입력하여명령프롬프트를실행합니다. 11

12 윈도우설치가이드 (ZIP 버전 ) 그림 3-1 명령프롬프트실행 2. 명령프롬프트에서다음명령어를실행합니다. java -version 다음과같은결과가나타나지않거나버전이 1.6 이상이아니면자바를설치해야합니다. 그림 3-2 자바버전확인

자바 6.0 이상설치 13 3.1.2 자바설치 다음순서로자바를윈도우에설치합니다. 1. 오라클자바사이트에서자바설치파일을내려받습니다. 자바 7 을내려받는것을권장합니다. 32 비트윈도우를사용하면 Windows x86 Offline 을, 64 비트윈도우를사용하면 Windows x64 를선택합 니다. JRE 를내려받을것인가? JDK 를내려받을것인가? JRE(Java Runtime Environment) 는자바로만든소프트웨어 ( 쓰리래빗츠북과같은 ) 를실행시키기위 한것이고, JDK(Java Development Kit) 는자바소프트웨어개발에필요한도구와 JRE 의묶음입니 다. 따라서단지쓰리래빗츠사용을위해자바를설치한다면 JRE 를설치하는것을권장합니다. 2. 내려받은파일을클릭하여자바를설치합니다. 3.1.3 JRE_HOME 또는 JAVA_HOME 환경변수설정 다음순서로 JRE_HOME 또는 JAVA_HOME 환경변수를설정합니다. 1. < 시작 컴퓨터 > 메뉴를마우스로우클릭하면컨텍스트메뉴가나타납니다. 2. 컨텍스트메뉴에서 < 속성 > 메뉴를클릭합니다. 그림 3-3 컴퓨터속성메뉴열기

14 윈도우설치가이드 (ZIP 버전 ) 3. 좌측메뉴에서 < 고급시스템설정 > 메뉴를클릭합니다. 그림 3-4 컴퓨터에대한기본정보보기 4. 시스템속성창에서 < 고급 > 탭아래에있는 < 환경변수 > 버튼을클릭합니다. 그림 3-5 시스템속성창

자바 6.0 이상설치 15 5. 환경변수창 < 시스템변수 > 패널아래에있는 < 새로만들기 > 버튼을클릭합니다. 그림 3-6 환경변수창 6. 새시스템변수창에서변수이름과값을입력하고 < 확인 > 버튼을클릭합니다. 그림 3-7 새시스템변수 JRE 를설치했다면 JRE_HOME 을, JDK 를설치했다면 JAVA_HOME 을변수이름에입력합니다. 변수값에는 JRE 또는 JDK 가설치된폴더경로를입력해야하는데자세한경로는 C:\Program Files\Java 폴더에서확인합니다. 표 3-1 환경변수 변수이름변수값 1 JRE 를설치 JRE_HOME C:\Program Files\Java\jre7 JDK 를설치 JAVA_HOME C:\Program Files\Java\jdk1.7.0_02 1 변수값은자바버전과폴더위치에따라서다를수있습니다.

16 윈도우설치가이드 (ZIP 버전 ) JRE_HOME 과 JAVA_HOME 을모두설정했다면 JRE_HOME 이우선합니다. 3.2 쓰리래빗츠설치 설치파일을내려받아압축을풀면쓰리래빗츠설치가끝납니다. 1. 쓰리래빗츠다운로드페이지에서윈도우용설치파일을내려받습니다. 2. 압축을푼후 3rabbitz 폴더를설치하고자하는폴더로옮깁니다. 설치하려는폴더전체경로에공백문자와특수문자 (~!@$%^&*()_+ "<>':`) 가없어야합니다. 그림 3-8 제품폴더구성 3.3 쓰리래빗츠시작 3RABBITZ_HOME 은쓰리래빗츠를설치한폴더를지칭합니다. 다음순서로쓰리래빗츠를시작합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. startup.bat 파일을실행합니다. 3. 6. 설치마법사로초기설정작업을수행합니다.

쓰리래빗츠종료 17 3.4 쓰리래빗츠종료 다음순서로쓰리래빗츠를종료합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. shutdown.bat 파일을실행합니다.

4. 리눅스설치가이드 4.1 자바 6.0 이상설치..................................................................... 19 4.1.1 자바설치여부와버전확인............................................................ 19 4.1.2 자바설치 4.1.2.1 우분투 4.2 쓰리래빗츠설치 4.3 쓰리래빗츠시작 4.4 쓰리래빗츠종료......................................................................... 20........................................................................ 20....................................................................... 21....................................................................... 22....................................................................... 22 다음순서로쓰리래빗츠를리눅스에설치합니다. 1. 자바 6.0 이상을설치합니다. 2. 쓰리래빗츠설치파일을내려받습니다. 3. 쓰리래빗츠설치파일압축을풉니다. 4. 터미널에서쓰리래빗츠를시작합니다. 5. 설치마법사를실행합니다. 4.1 자바 6.0 이상설치 4.1.1 자바설치여부와버전확인 자바설치여부와버전확인을위해터미널에서다음명령어를실행합니다. java -version 다음과같은결과가나타나지않거나버전이 1.6 이상이아니거나 OpenJDK 이면자바를설치해야합니다. 19

20 리눅스설치가이드 그림 4-1 자바버전확인 4.1.2 자바설치 리눅스배포판과버전에따라자바를설치하는방법이매우다릅니다. 그래서자바설치는리눅스배포판과버전에맞 게진행합니다. 여기서는우분투에자바를설치하는방법만을설명합니다. 4.1.2.1 우분투 우분투에자바를설치하는방법입니다. 우분투 10.04 이상을사용하면터미널에서다음명령어를실행합니다. sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner" sudo apt-get update 터미널에서다음명령어를실행하여자바를설치합니다. sudo apt-get install sun-java6-jdk

쓰리래빗츠설치 21 설치이후에도 OpenJDK 가실행되면다음명령어로오라클자바가기본으로실행되도록변경합니다. sudo update-alternatives --config java 4.2 쓰리래빗츠설치 설치파일을내려받아압축을풀면쓰리래빗츠설치가완료됩니다. 1. 쓰리래빗츠다운로드페이지에서리눅스용설치파일을내려받습니다. 2. 내려받은파일을 FTP 로설치할리눅스서버로전송합니다. 리눅스서버가인터넷에연결되어있다면다음명령어로설치파일을리눅스서버로직접내려받을 수있습니다. wget http://www.3rabbitz.com/r/home/download/linux --content-disposition 설치하려는디렉터리전체경로에공백문자와특수문자 (~!@$%^&*()_+ "<>':`) 가없어야합니다. 3. tar 명령어로압축파일을풉니다. tar -xvf 3rabbitz-1790.tar.gz 그림 4-2 제품디렉터리구성

22 리눅스설치가이드 4.3 쓰리래빗츠시작 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 다음순서로쓰리래빗츠를시작합니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. 다음명령어를실행합니다../startup.sh 3. 6. 설치마법사로초기설정작업을수행합니다. 4.4 쓰리래빗츠종료 다음순서로쓰리래빗츠를종료합니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. 다음명령어를실행합니다../shutdown.sh

5. 맥 OS 설치가이드 5.1 자바 6.0 이상설치 5.1.1 자바버전확인 5.1.2 자바업데이트 5.2 쓰리래빗츠설치 5.3 쓰리래빗츠시작 5.4 쓰리래빗츠종료..................................................................... 23..................................................................... 23...................................................................... 24....................................................................... 26....................................................................... 26....................................................................... 27 다음순서로쓰리래빗츠를맥 OS 에설치합니다. 1. 자바 6.0 이상을설치합니다. 2. 쓰리래빗츠설치파일을내려받습니다. 3. 쓰리래빗츠설치파일압축을풉니다. 4. 터미널에서쓰리래빗츠를시작합니다. 5. 설치마법사를실행합니다. 5.1 자바 6.0 이상설치 맥 OS 에는자바가설치되어있습니다. 자바버전이 6.0 보다낮으면업데이트합니다. 5.1.1 자바버전확인 다음순서로자바버전을확인합니다. 1. 도크에있는 < 응용프로그램 유틸리티 > 메뉴에서터미널을실행합니다. 2. 터미널에서다음명령어를실행합니다. 23

24 맥 OS 설치가이드 java -version 버전이 1.6 이상이아니면자바를업데이트해야합니다. 5.1.2 자바업데이트 다음순서로자바를업데이트합니다. 1. 도크에있는 < 시스템환경설정 > 메뉴를실행합니다. 2. < 시스템환경설정 > 메뉴에서 < 시스템 소프트웨어업데이트 > 메뉴를클릭합니다.

3. 소프트웨어업데이트에있는 < 지금확인 > 버튼을클릭하여자바를업데이트합니다. 자바 6.0 이상설치 25

26 맥 OS 설치가이드 5.2 쓰리래빗츠설치 설치파일을내려받아압축을풀면쓰리래빗츠설치가완료됩니다. 1. 쓰리래빗츠다운로드페이지에서맥 OS 용설치파일을내려받습니다. 2. 압축을푼후 3rabbitz 디렉터리를설치하고자하는디렉터리로옮깁니다. 설치하려는디렉터리전체경로에공백문자와특수문자 (~!@$%^&*()_+ "<>':`) 가없어야합니다. 그림 5-1 제품디렉터리구성 5.3 쓰리래빗츠시작 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 다음순서로쓰리래빗츠를시작합니다. 1. 도크에있는 < 응용프로그램 유틸리티 > 메뉴에서터미널을실행합니다. 2. 3RABBITZ_HOME/bin 디렉터리로이동합니다.

쓰리래빗츠종료 27 3. 다음명령어를실행합니다../startup.sh 4. 6. 설치마법사로초기설정작업을수행합니다. 5.4 쓰리래빗츠종료 다음순서로쓰리래빗츠를종료합니다. 1. 도크에있는 < 응용프로그램 유틸리티 > 메뉴에서터미널을실행합니다. 2. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 3. 다음명령어를실행합니다../shutdown.sh

6. 설치마법사 6.1 설치마법사시작하기 6.2 설치마법사로설정하기.................................................................... 29.................................................................. 30 6.3 영어글꼴등록하기..................................................................... 34 6.1 설치마법사시작하기 쓰리래빗츠를시작한후웹브라우저에서다음 URL 로이동하면설치마법사가나타납니다. http://<domain_name_or_ip_address>:1975 기본포트번호는 1975 입니다. 이를변경하는방법은부록 B. 포트번호변경을참고합니다. 개인컴퓨터에설치했다면다음 URL 로접속합니다. http://127.0.0.1:1975 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 설치마법사가나타나지않으면 3RABBITZ_HOME/logs 디렉터리에있는로그파일을확인합니다. 29

30 설치마법사 6.2 설치마법사로설정하기 설치마법사로다음작업을수행합니다. 최종사용자사용권계약서동의 기본정보설정 기본 URL 데이터디렉터리와백업디렉터리 라이선스키입력 사용자만들기 1 최종사용자사용권계약서동의 최종사용자사용권계약서내용에동의해야다음단계로넘어갑니다. 그림 6-1 최종사용자사용권계약서동의

설치마법사로설정하기 31 설치마법사에서사용할언어를변경할수있습니다. 현재는영어와한국어를지원합니다. 2 기본정보설정 이단계에서설정하는항목은다음과같습니다. 기본 URL 설치한쓰리래빗츠주소로문서링크와메일발송등에사용합니다. 도메인주소나 IP 주소로입력합니다. 데이터디렉터리데이터베이스, 글꼴, 이미지, PDF, EPUB 등의다양한데이터를저장하는디렉터리입니다. 백업디렉터리데이터베이스와이미지를백업하는디렉터리입니다. 그림 6-2 기본정보입력 안정성을위해데이터디렉터리와디스크가다른디렉터리를백업디렉터리로사용하는것을권장합니다. 3 라이선스키입력 라이선스키를입력합니다.

32 설치마법사 그림 6-3 라이선스키입력 평가판라이선스키를발급받는방법은다음과같습니다. 1. 쓰리래빗츠홈페이지로이동한후로그인합니다. 회원가입이필요합니다. 2. < 1 내계정 > 을선택한후 < 2 라이선스 > 탭을클릭합니다. 그리고 < 3 라이선스발급 > 링크를클릭합니다.

설치마법사로설정하기 33 3. 제품과유형을선택하고설치마법사화면에있는서버아이디를복사해서붙여넣은후에 < 4 라이선스발급 > 버튼을클릭합니다. 4 사용자만들기 마지막으로 관리 권한을지닌사용자를만듭니다. 그림 6-4 사용자만들기

34 설치마법사 < 설치 > 링크를클릭하면설치를시작합니다. 설치를완료하면로그인화면으로이동합니다. 6.3 영어글꼴등록하기 쓰리래빗츠북은나눔글꼴과함께설치되는데이글꼴은영어문서에는적합하지않습니다. 그래서영어문서를작성 한다면 Liberation 글꼴을등록하는것을권장합니다. 자세한사항은쓰리래빗츠북사용자가이드 : Liberation 글꼴 등록하기를참고합니다. 쓰리래빗츠비주얼만을사용한다면영어글꼴을등록할수없습니다.

부록 A. 윈도우서비스로시작 A.1 파일다운로드 쓰리래빗츠를윈도우서비스로등록하려면다음파일을내려받습니다. 파일 다운로드 service.bat 다운로드 tomcat7.exe 32-bit Windows 다운로드 64-bit Windows 다운로드 64-bit Itanium Windows 다운로드 내려받은파일을 3RABBITZ_HOME\bin 폴더에복사합니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한폴더를지칭합니다. A.2 서비스에등록하기 다음순서로쓰리래빗츠를서비스에등록합니다. 1. 3RABBITZ_HOME\bin 폴더로이동합니다. 2. 다음명령어를실행합니다. service.bat install 35

36 윈도우서비스로시작 모든명령어는윈도우관리자권한으로수행해야합니다. 명령어를관리자권한으로실행하려면윈도우 < 시작 > 메뉴실행창에서 CMD 를입력하여명령프롬프트를실행할 때컨텍스트메뉴에서관리자권한으로실행을선택하면됩니다. 윈도우서비스에 3Rabbitz Book 이라는이름으로등록됩니다. 이렇게등록한서비스의시작유형은수동입니다. 윈도우가시작할때쓰리래빗츠를자동으로시작하려면 시작유형을자동으로변경합니다. A.3 서비스에서삭제하기 다음순서로쓰리래빗츠를서비스에서삭제합니다. 1. 3RABBITZ_HOME\bin 폴더로이동합니다. 2. 다음명령어를실행합니다.

기타설정 37 service.bat remove A.4 기타설정 A.4.1 자바힙메모리설정 다음순서로자바힙메모리설정을바꿉니다. 1. 3RABBITZ_HOME\bin 폴더로이동합니다. 2. 다음명령어를실행합니다. tomcat7 //US//3RabbitzBook --JvmMs 256 --JvmMx 1024 3. 쓰리래빗츠서비스를재시작합니다.

부록 B. 포트번호변경 B.1 서비스포트번호변경 B.2 정지포트번호변경................................................................... 39..................................................................... 40 쓰리래빗츠는 2 개의네트워크포트를사용합니다. 하나는사용자요청처리를위한서비스포트이고다른하나는쓰 리래빗츠를정지하기위해사용하는정지 (Shutdown) 포트입니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. B.1 서비스포트번호변경 서비스포트번호는기본값이 1975 입니다. 포트번호를바꾸려면 3RABBITZ_HOME/tomcat/conf/server.xml 파일에 서 1975 를다른번호로변경합니다. <Server port="5791" shutdown="shutdown"> <Service name="catalina">... <Connector port="1975" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" URIEncoding="UTF-8" />... </Service> </Server> 쓰리래빗츠를다시시작해야변경사항을반영합니다. 39

40 포트번호변경 B.2 정지포트번호변경 정지포트번호는기본값이 5791 입니다. 포트번호를바꾸려면 3RABBITZ_HOME/tomcat/conf/server.xml 파일에서 5791 을다른번호로변경합니다. <Server port="5791" shutdown="shutdown"> <Service name="catalina">... <Connector port="1975" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" URIEncoding="UTF-8" />... </Service> </Server> 쓰리래빗츠를다시시작해야변경사항을반영합니다.

부록 C. 아파치웹서버연동 쓰리래빗츠와웹서버를연동하려면아파치톰캣커넥터를사용합니다. 쓰리래빗츠가아파치톰캣을이용하기때문입 니다. C.1 mod_jk 설치 연동을위해 mod_jk 를설치해야합니다. 아파치톰캣커넥터페이지에서도움이되는내용을찾을수있습니다. 아파치톰캣커넉터는 1.2.40 버전을예로듭니다. C.1.1 리눅스에설치 1 1 sources 링크를이용해서소스를받습니다. 서버가인터넷에연결되어있다면다음과같이쉽게받을수있습니다. 41

42 아파치웹서버연동 wget http://www.apache.org/dist/tomcat/tomcat-connectors/jk/tomcat-connectors-1.2.40-src.tar.gz 2 컴파일하여설치합니다. tar xvzf tomcat-connectors-1.2.40-src.tar.gz cd tomcat-connectors-1.2.40-src/native./configure --with-apxs=/app/httpd-2.2.27/bin/apxs 1 make make install Advanced Packaging Tool 일명 apt-get 을지원하면다음명령어로간단히설치합니다. 다른환경 에서설치방법은공식페이지를참고하세요. sudo apt-get install libapache2-mod-jk C.1.2 윈도우에설치 1 1 binaries 를이용하여컴파일된파일을받습니다. 파일을받는경로는여기입니다. 아파치웹서버의종류에따라 32 비트, 64 비트로받을파일이다릅니다. OS 가아닌, 아파치웹서버의종류에따라파일이달라집니다. 예를들면윈도우 64 비트에서아파치 웹서버 32 비트를사용하고있다면 32 비트파일을받아야합니다. 1./configure 값은 " 아파치설치디렉토리 /bin/apxs" 을사용합니다.

mod_jk 설정 43 그림 C-1 64 비트일때받는파일 그림 C-2 32 비트일때받는파일 2 압축파일을풀어서 mod_jk.so 파일을 < 아파치웹서버설치경로 \modules> 로복사합니다. C.2 mod_jk 설정 C.2.1 httpd.conf 을이용 아파치웹서버를 httpd.conf 이용하여관리할때사용하는방법입니다. XAMP 에서기본으로사용하는방법입니다. <XAMP 설치경로 \apache\conf> 에 httpd.conf 파 일이있습니다. httpd.conf 의마지막에다음내용을넣습니다. XAMP 를이용한예제입니다. 파일의위치는사용하고있는환 경에맞게고쳐씁니다. Load mod_jk module LoadModule jk_module modules/mod_jk.so Where to find workers.properties JkWorkersFile conf/workers.properties Where to put jk shared memory JkShmFile logs/mod_jk.shm Where to put jk logs JkLogFile logs/mod_jk.log Set the jk log level [debug/error/info] JkLogLevel info Select the timestamp log format

44 아파치웹서버연동 JkLogStampFormat "[%a %b %d %H:%M:%S %Y] " 자세한내용은공식사이트문서를참고합니다. 아파치웹서버가설치된경로를기준으로상대경로를이용합니다. C.2.2 mods-enable 디렉토리를이용해서활성화 아파치웹서버의설정에 mods-enable 을사용할때이용하는방법입니다. 우분투서버에기본으로설치된아파치웹서버에서사용하는방법입니다. 1 아파치웹서버 mods-enable 디렉터리에설정파일들을만듭니다. jk.conf jk.load workers.properties 예시에사용된파일은여기에서받습니다. 예시의내용을실제환경에맞게수정합니다. 자세한내용은공식사 이트문서를참고합니다. 2 jk.conf 내용을입력합니다. JkWorkersFile /etc/apache2/mods-available/workers.properties JkShmFile /var/log/apache2/mod_jk.shm JkLogFile /var/log/apache2/mod_jk.log JkLogLevel info JkLogStampFormat "[%a %b %d %H:%M:%S %Y] " JkRequestLogFormat "%w %V %T" 3 jk.load 내용을입력합니다. LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so C.3 workers.properties 만들기

workers.properties 만들기 45 으로시작하는문장들은설명을위한주석입니다. 이해를돕기위해지우지않았습니다. 리눅스에서는슬러쉬문자를윈도우에서는역슬러쉬문자를사용하는것을주의하세요. C.3.1 리눅스에서사용하는파일 workers.properties - This file is a simplified version of the workers.properties supplied with the upstream sources. The jni inprocess worker (not build in the debian package) section and the ajp12 (deprecated) section are removed. As a general note, the characters $( and ) are used internally to define macros. Do not use them in your own configuration!!! Whenever you see a set of lines such as: x=value y=$(x)\something the final value for y will be value\something Normaly all you will need to do is un-comment and modify the first three properties, i.e. workers.tomcat_home, workers.java_home and ps. Most of the configuration is derived from these. When you are done updating workers.tomcat_home, workers.java_home and ps you should have 3 workers configured: - An ajp13 worker that connects to localhost:8009 - A load balancer worker OPTIONS ( very important for jni mode ) workers.tomcat_home should point to the location where you installed tomcat. This is where you have your conf, webapps and lib directories. workers.tomcat_home=/home/rabbitz/app-1-0/tomcat workers.java_home should point to your Java installation. Normally

46 아파치웹서버연동 you should have a bin and lib directories beneath it. workers.java_home=/usr/java/jdk1.6.0_35 You should configure your environment slash... ps=\ on NT and / on UNIX and maybe something different elsewhere. ps=/ ------ ADVANCED MODE ------------------------------------------------ --------------------------------------------------------------------- ------ worker list ------------------------------------------ --------------------------------------------------------------------- The workers that your plugins should create and work with worker.list=ajp13_worker ------ ajp13_worker WORKER DEFINITION ------------------------------ --------------------------------------------------------------------- Defining a worker named ajp13_worker and of type ajp13 Note that the name and the type do not have to match. worker.ajp13_worker.port=8009 worker.ajp13_worker.host=localhost worker.ajp13_worker.type=ajp13 Specifies the load balance factor when used with a load balancing worker. Note: ----> lbfactor must be > 0 ----> Low lbfactor means less work done by the worker. worker.ajp13_worker.lbfactor=1 Specify the size of the open connection cache. worker.ajp13_worker.cachesize ------ DEFAULT LOAD BALANCER WORKER DEFINITION ---------------------- ---------------------------------------------------------------------

workers.properties 만들기 47 The loadbalancer (type lb) workers perform wighted round-robin load balancing with sticky sessions. Note: ----> If a worker dies, the load balancer will check its state once in a while. Until then all work is redirected to peer workers. worker.loadbalancer.type=lb worker.loadbalancer.balance_workers=ajp13_worker 다음사항을주의하여만듭니다. workers.tomcat_home=/home/rabbitz/app-1-0/tomcat 쓰리래빗츠가설치된경로아래의 tomcat 디렉토리를넣습니다. workers.java_home=/usr/java/jdk1.6.0_35 JDK가설치된경로를넣습니다. ps=/ 리눅스는슬러쉬를사용합니다. ajp13_worker 아파치설정에서사용합니다. C.3.2 윈도우에서사용하는파일 workers.properties - This file is a simplified version of the workers.properties supplied with the upstream sources. The jni inprocess worker (not build in the debian package) section and the ajp12 (deprecated) section are removed. As a general note, the characters $( and ) are used internally to define macros. Do not use them in your own configuration!!! Whenever you see a set of lines such as: x=value y=$(x)\something the final value for y will be value\something Normaly all you will need to do is un-comment and modify the first three properties, i.e. workers.tomcat_home, workers.java_home and ps. Most of the configuration is derived from these.

48 아파치웹서버연동 When you are done updating workers.tomcat_home, workers.java_home and ps you should have 3 workers configured: - An ajp13 worker that connects to localhost:8009 - A load balancer worker OPTIONS ( very important for jni mode ) workers.tomcat_home should point to the location where you installed tomcat. This is where you have your conf, webapps and lib directories. workers.tomcat_home=c:\3rabbitz\tomcat workers.java_home should point to your Java installation. Normally you should have a bin and lib directories beneath it. workers.java_home=c:\program Files\Java\jdk1.7.0_71 You should configure your environment slash... ps=\ on NT and / on UNIX and maybe something different elsewhere. ps=\ ------ ADVANCED MODE ------------------------------------------------ --------------------------------------------------------------------- ------ worker list ------------------------------------------ --------------------------------------------------------------------- The workers that your plugins should create and work with worker.list=ajp13_worker ------ ajp13_worker WORKER DEFINITION ------------------------------ --------------------------------------------------------------------- Defining a worker named ajp13_worker and of type ajp13 Note that the name and the type do not have to match. worker.ajp13_worker.port=8009

workers.properties 만들기 49 worker.ajp13_worker.host=localhost worker.ajp13_worker.type=ajp13 Specifies the load balance factor when used with a load balancing worker. Note: ----> lbfactor must be > 0 ----> Low lbfactor means less work done by the worker. worker.ajp13_worker.lbfactor=1 Specify the size of the open connection cache. worker.ajp13_worker.cachesize ------ DEFAULT LOAD BALANCER WORKER DEFINITION ---------------------- --------------------------------------------------------------------- The loadbalancer (type lb) workers perform wighted round-robin load balancing with sticky sessions. Note: ----> If a worker dies, the load balancer will check its state once in a while. Until then all work is redirected to peer workers. worker.loadbalancer.type=lb worker.loadbalancer.balance_workers=ajp13_worker 다음사항을주의합니다. workers.tomcat_home=c:\3rabbitz\tomcat 쓰리래빗츠가설치된경로아래의 tomcat 디렉토리를넣습니다. workers.java_home=c:\program Files\Java\jdk1.7.0_71 JDK가설치된경로를넣습니다. ps=\ 윈도우는역슬러쉬를사용합니다. ajp13_worker 아파치설정에서사용합니다.

50 아파치웹서버연동 C.4 아파치웹서버설정 아파치웹서버에서 mod_jk 로요청을보내도록다음예시에서강조한내용을추가합니다. 수정할파일은 site s-availables 디렉터리의 default 또는 default-ssl 입니다. ajp13_worker 는 workers.properties 에서사용된이름과같아야합니다. <VirtualHost *:80> -- 생략된내용이있습니다. -- <Directory /> Options FollowSymLinks AllowOverride None </Directory> JkMount /* ajp13_worker JkUnMount /resource/* ajp13_worker 2 ErrorLog /var/log/apache2/error.log Possible values include: debug, info, notice, warn, error, crit, alert, emerg. LogLevel info -- 생략된내용이있습니다. -- </VirtualHost> 만약서브도메인을이용하려면다음과같이설정합니다. 아파치가상호스트문서를참고하세요. <VirtualHost doc.3rabbitz.com:80> -- 생략된내용이있습니다. -- <Directory /> Options FollowSymLinks AllowOverride None </Directory> JkMount /* ajp13_worker JkUnMount /resource/* ajp13_worker 3 ErrorLog /var/log/apache2/error.log Possible values include: debug, info, notice, warn, error, crit, alert, emerg. LogLevel info -- 생략된내용이있습니다. -- </VirtualHost> 2 정적파일을웹서버에서처리하기위한설정입니다. 3 정적파일을웹서버에서처리하기위한설정입니다.

톰캣설정 51 개인 PC 에서사용하기위해서는 hosts 파일에사용할도메인정보를넣어야합니다. hosts 파일은 < 윈도우설치경로 C:\Windows\System32\Drivers\etc> 에있습니다. 127.0.0.1 doc.3rabbitz.com XAMP 의경우가상호스트를관리하는파일은 <XAMP 설치경로 \apache\conf\extra\httpd -vhosts.conf> 입니다. C.5 톰캣설정 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 3RABBITZ_HOME/tomcat/conf/server.xml 파일을열어서다음과같이내용을바꿉니다. <Server port="5791" shutdown="shutdown"> <Service name="catalina"> <Connector port="8009" protocol="ajp/1.3" redirectport="8443" URIEncoding="UTF-8" /> <!-- <Connector port="1975" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" URIEncoding="UTF-8" /> --> <!-- 이하생략 --> </Service> </Server> 1 AJP/1.3 설정을위한 Connector 의주석을풉니다. work.properties 를설정할때 8009 포트번호를바꿨다면바뀐번호를사용합니다. 2 HTTP/1.1 를위한 Connector 를주석으로막습니다.

52 아파치웹서버연동 웹서버를거치지않고 1975 포트로쓰리래빗츠에접근하는것도허용하려면주석으로바꾸지않습 니다. 3 쓰리래빗츠를다시시작합니다. 쓰리래빗츠를다시시작할때변경한내용을사용합니다.

부록 D. ISS 웹서버연동 쓰리래빗츠와웹서버를연동하려면아파치톰캣커넥터를사용합니다. 쓰리래빗츠가아파치톰캣을이용하기 때문입니다. 윈도우 8 환경을예로듭니다. 윈도우버전에따라 IIS 관리자화면이다를수있습니다. D.1 isapi_redirect.dll 설치 1 설치에필요한파일을받습니다. IIS 와연동하려면 isapi_redirect.dll 를설치합니다. 설치파일은아파치톰캣커넥터페이지에서받습니다. 1 링크를이용하여사용하는 OS 에맞는파일을받습니다. 아파치톰캣커넉터는 1.2.40 버전을예로듭니다. REFERENCED_IMAGE_REMOVED 윈도우는 32 비트, 64 비트에따라다른파일을받습니다. 그림 D-1 64 비트일때받는파일 53

54 ISS 웹서버연동 그림 D-2 32 비트일때받는파일 2 isapi_redirect.dll 을복사합니다. 받은압축파일을풀어서 isapi_redirect.dll 을쓰리래빗츠설치위치아래 iss 디렉터리 ( 기본설치시 C:\3ra bbitz\iis) 로복사합니다. iss 디렉터리는설치후별도로만들어야합니다. 관리의편리성을위하여 iss 연동과관련된파일은쓰리래빗츠설치위치아래 iss 디렉터리 ( 기본설치 시 C:\3rabbitz\iis) 에함께있도록합니다. D.2 isapi_redirect.dll 설정 1 isapi_redirect.dll 가위치한디렉터리에다음디렉터리및파일을만듭니다. 디렉터리 파일 logs isapi_redirect.properties uriworkermap.properties workers.properties 그림 D-3 isapi_redirect.dll 사용에필요한파일및디렉터리

isapi_redirect.dll 설정 55 예시에사용된파일은여기에서다운받습니다. 예시의내용을실제환경에맞게수정합니다. 자세한 내용은공식사이트문서를참고합니다. 2 isapi_redirect.properties 내용을입력합니다. Configuration file for the Jakarta ISAPI Redirector The path to the ISAPI Redirector Extension, relative to the website This must be in a virtual directory with execute privileges extension_uri=/3rabbitz/isapi_redirect.dll Full path to the log file for the ISAPI Redirector log_file=c:\3rabbitz\iis\logs\isapi_redirect.%y-%m-%d.log Log level (debug, info, warn, error or trace) log_level=info Rotate the log file every day log_rotationtime=86400 Full path to the workers.properties file worker_file=c:\3rabbitz\iis\workers.properties Full path to the uriworkermap.properties file worker_mount_file=c:\3rabbitz\iis\uriworkermap.properties extension_uri=/3rabbitz/isapi_redirect.dll 에사용된 3rabbitz 값은다음단계에서사용됩 니다. 3 uriworkermap.properties 내용을입력합니다. Include default /*=ajp13_worker Exclude the static files!/resource/*=*!/resource/*=* 설정으로인하여 static 파일은 ISS 웹서버가바로처리하게됩니다. 4 workers.properties 내용을입력합니다. 윈도우에설치했을때는 workers.java_home 값에 JDK 가아닌 JRE 경로가포함되어도괜찮습니다. 윈도우시스템속성의환경변수에있는 JRE_HOME 또는 JAVA_HOME 값을입력합니다. 으로시작하는문장들은설정에영향을미치지않는주석입니다.

56 ISS 웹서버연동 workers.properties - This file is a simplified version of the workers.properties supplied with the upstream sources. The jni inprocess worker (not build in the debian package) section and the ajp12 (deprecated) section are removed. As a general note, the characters $( and ) are used internally to define macros. Do not use them in your own configuration!!! Whenever you see a set of lines such as: x=value y=$(x)\something the final value for y will be value\something Normaly all you will need to do is un-comment and modify the first three properties, i.e. workers.tomcat_home, workers.java_home and ps. Most of the configuration is derived from these. When you are done updating workers.tomcat_home, workers.java_home and ps you should have 3 workers configured: - An ajp13 worker that connects to localhost:8009 - A load balancer worker OPTIONS ( very important for jni mode ) workers.tomcat_home should point to the location where you installed tomcat. This is where you have your conf, webapps and lib directories. workers.tomcat_home=c:\3rabbitz\tomcat 1 workers.java_home should point to your Java installation. Normally you should have a bin and lib directories beneath it. workers.java_home=c:\program Files\Java\jdk1.7.0_55 2 You should configure your environment slash... ps=\ on NT and / on UNIX and maybe something different elsewhere. 1 쓰리래빗츠가설치된경로아래의 tomcat 디렉터리를입력합니다. 2 JDK 가설치된위치를입력합니다. JRE 를이용하여설치한경우시스템속성의환경변수에있는 JRE_HOME 경로를입력합니다.

isapi_redirect.dll 설정 57 ps=\ ------ ADVANCED MODE ------------------------------------------------ --------------------------------------------------------------------- ------ worker list ------------------------------------------ --------------------------------------------------------------------- The workers that your plugins should create and work with worker.list=ajp13_worker ------ ajp13_worker WORKER DEFINITION ------------------------------ --------------------------------------------------------------------- Defining a worker named ajp13_worker and of type ajp13 Note that the name and the type do not have to match. worker.ajp13_worker.port=8009 worker.ajp13_worker.host=localhost worker.ajp13_worker.type=ajp13 Specifies the load balance factor when used with a load balancing worker. Note: ----> lbfactor must be > 0 ----> Low lbfactor means less work done by the worker. worker.ajp13_worker.lbfactor=1 Specify the size of the open connection cache. worker.ajp13_worker.cachesize ------ DEFAULT LOAD BALANCER WORKER DEFINITION ---------------------- --------------------------------------------------------------------- The loadbalancer (type lb) workers perform wighted round-robin load balancing with sticky sessions. Note: ----> If a worker dies, the load balancer will check its state once in a while. Until then all work is redirected to peer workers. worker.loadbalancer.type=lb

58 ISS 웹서버연동 worker.loadbalancer.balance_workers=ajp13_worker 설정값에대한자세한설명은아파치톰캣커넥트공식문서를참고하세요. D.3 ISS 관리자설정 isapi_redirect.dll 를 IIS 에서사용하기위해 ISS( 인터넷정보서비스 ) 관리자를이용하여다음처럼설정합니 다. 1 웹사이트를추가합니다.

ISS 관리자설정 59 1 사이트선택후마우스우클릭메뉴에서웹사이트추가를선택합니다. 2 사이트이름은 3rabbitz로입력합니다. 응용프로그램풀은자동으로만들어집니다. 3 실제경로는쓰리래빗츠설치위치아래 web 디렉터리 ( 기본설치시 C:\3rabbitz\web) 를입력합니다. 4 호스트이름은사용할서브도메인명이있다면서브도메인명을포함하여입력합니다. 웹서버로들어오는모든서브도메인을쓰리래빗츠와연결하려면공란으로남겨둡니다. 한서버에서홈페이지와매뉴얼페이지를모두운영하고자할때서브도메인을이용합니다. 'www. 3rabbitz.com -> 홈페이지 ', 'doc.3rabbitz.com -> 쓰리래빗츠 ' 와같이서비스하려면호스트이 름에 'doc.3rabbitz.com' 를입력해야합니다. 2 가상디렉터리를추가합니다. 5 웹사이트선택하고마우스우클릭메뉴에서가상디렉터리추가기능을선택합니다. 6 별칭에는 isapi_redirect.properties 파일의 extension_uri=/3rabbitz/isapi_redirect.dll 에서 사용된 3rabbitz 를입력합니다.

60 ISS 웹서버연동 7 실제경로는 isapi_redirect.dll 가위치한디렉터리를입력합니다. 별칭과실제경로는 isapi_redirect.dll 를설치, 설정할때사용한값을이용합니다. 특별한이유 가없다면예시와같이입력합니다. 3 가상디렉터리를선택하고 8 처리기매핑을더블클릭합니다. 4 9 ISAPI-dll 을선택하고 10 기능사용권한편집을선택한후 11 실행권한을부여합니다.

ISS 관리자설정 61 5 12 좌측메뉴에서서버를선택하고 13 'ISAPI 및 CGI 제한 ' 을선택합니다. 'ISAPI 및 CGI 제한 ' 이활성화되지않은경우 < 제어판 프로그램 프로그램및기능 Window 기 능켜기 / 끄기 > 메뉴를이용하여 ISAPI 필터, ISAPI 확장기능을켭니다.

62 ISS 웹서버연동 6 14 추가버튼을클릭하여 15 새로운 'ISAPI 및 CGI 제한 ' 을만듭니다. ISAPI 또는 CGI 경로는 isapi_redirect.dll 를선택하고설명은 3rabbitz 3 를입력합니다. 7 16 좌측메뉴의서버를선택하고 17 'ISAPI 필터 ' 를선택합니다. 3 다른이름을입력하여도괜찮습니다.

톰캣설정 63 8 18 추가버튼을클릭하여 19 새로운 'ISAPI 필터 ' 를만듭니다. 필터이름은 3rabbitz 을실행파일은 isapi_redirect.dll 를입력합니다. 9 ISS 를재시작합니다. 서버를재시작하면사이트는재시작됩니다. 그러나응용프로그램풀은별도로시작하여야합니다. D.4 톰캣설정 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 3RABBITZ_HOME/tomcat/conf/server.xml 파일을열어서다음과같이내용을바꿉니다.

64 ISS 웹서버연동 <Server port="5791" shutdown="shutdown"> <Service name="catalina"> <Connector port="8009" protocol="ajp/1.3" redirectport="8443" URIEncoding="UTF-8" /> <!-- <Connector port="1975" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" URIEncoding="UTF-8" /> --> <!-- 이하생략 --> </Service> </Server> 1 AJP/1.3 설정을위한 Connector 의주석을풉니다. work.properties 를설정할때 8009 포트번호를바꿨다면바뀐번호를사용합니다. 2 HTTP/1.1 를위한 Connector 를주석으로막습니다. 웹서버를거치지않고 1975 포트로쓰리래빗츠에접근하는것도허용하려면주석으로바꾸지않습 니다. 3 쓰리래빗츠를다시시작합니다. 쓰리래빗츠를다시시작할때변경한내용을사용합니다.

부록 E. 오라클데이터베이스사용 E.1 오라클데이터베이스 JDBC 드라이버추가..................................................... 65 E.2 환경설정파일변경..................................................................... 65 아파치더비가아닌오라클데이터베이스를쓰리래빗츠데이터베이스로사용하는방법을설명합니다. 오라클데이터베이스를사용하면해당데이터베이스백업기능으로데이터를백업해야합니다. E.1 오라클데이터베이스 JDBC 드라이버추가 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 오라클데이터베이스버전에맞는 JDBC 드라이버를 3RABBITZ_HOME/web/WEB-INF/lib 디렉터리에추가합니다. 오라클데이터베이스 JDBC 드라이버는오라클사이트에서내려받습니다. 오라클데이터베이스 11g 를사 용한다면 ojdbc6.jar 드라이버를사용합니다. E.2 환경설정파일변경 다음순서로쓰리래빗츠에오라클데이터베이스를설정합니다. 65

66 오라클데이터베이스사용 1. 3RABBITZ_HOME/tomcat/conf/server.xml 파일을엽니다. <Context docbase="${3rabbitz.home}/web" path="" reloadable="false" backgroundprocessordelay="3"> <!-- for Apache Derby --> <Resource name="jdbc/base" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="database" password="database" driverclassname="org.apache.derby.jdbc.embeddeddriver" url="jdbc:derby:database;create=true" /> <!-- for Oracle <Resource name="jdbc/base" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="scott" password="tiger" driverclassname="oracle.jdbc.oracledriver" url="jdbc:oracle:thin:@127.0.0.1:1521:orcl" /> --> </Context> 2. Apache Derby 설정부분을주석처리합니다. 3. Oracle 설정부분주석을제거합니다. 4. username, password, url 등을변경합니다. 5. 쓰리래빗츠를재시작합니다. 설치와소프트웨어업데이트를할때자동으로쓰리래빗츠테이블을만듭니다. 이를위해서 usernam e 에설정한오라클계정이테이블생성, 칼럼변경, 인덱스추가와삭제권한을갖고있어야합니다.

부록 F. MS SQL 서버데이터베이스사용 F.1 MS SQL 서버 JDBC 드라이버추가.......................................................... 67 F.2 환경설정파일변경..................................................................... 68 아파치더비가아닌 MS SQL 서버를쓰리래빗츠데이터베이스로사용하는방법을설명합니다. MS SQL 서버 2008 버전부터지원합니다. MS SQL 서버를사용하면해당데이터베이스백업기능으로데이터를백업해야합니다. F.1 MS SQL 서버 JDBC 드라이버추가 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. MS SQL 서버버전에맞는 JDBC 드라이버를 3RABBITZ_HOME/web/WEB-INF/lib 디렉터리에추가합니다. MS SQL 서버 JDBC 드라이버는마이크로소프트사이트에서내려받습니다. MS SQL 서버 2012 를사용한 다면 sqljdbc4.jar 드라이버를사용합니다. 67

68 MS SQL 서버데이터베이스사용 F.2 환경설정파일변경 다음순서로쓰리래빗츠에 MS SQL 서버를설정합니다. 1. 3RABBITZ_HOME/tomcat/conf/server.xml 파일을엽니다. <Context docbase="${3rabbitz.home}/web" path="" reloadable="false" backgroundprocessordelay="3"> <!-- for Apache Derby --> <Resource name="jdbc/base" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="database" password="database" driverclassname="org.apache.derby.jdbc.embeddeddriver" url="jdbc:derby:database;create=true" /> <!-- for Oracle <Resource name="jdbc/base" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="scott" password="tiger" driverclassname="oracle.jdbc.oracledriver" url="jdbc:oracle:thin:@127.0.0.1:1521:orcl" /> --> <!-- for MS SQL <Resource name="jdbc/base" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="sa" password="1234" driverclassname="com.microsoft.sqlserver.jdbc.sqlserverdriver" url="jdbc:sqlserver://localhost:1433;databasename=rabbitz" /> --> </Context> 2. Apache Derby 설정부분을주석처리합니다. 3. MS SQL 설정부분주석을제거합니다. 4. username, password, url 등을변경합니다. 5. 쓰리래빗츠를재시작합니다. 설치와소프트웨어업데이트를할때자동으로쓰리래빗츠테이블을만듭니다. 이를위해서 usernam e 에설정한 MS SQL 서버계정이테이블생성, 칼럼변경, 인덱스추가와삭제권한을갖고있어야합 니다.

찾아보기 H HTML5, 2 M MS SQL 서버, 67 S server.xml, 39, 40, 51, 63, 66, 68 ㄱ 개인컴퓨터, 2, 29 기본정보설정기본 URL, 31 데이터디렉터리, 31 백업디렉터리, 31 ㄴ 나눔글꼴, 34 ㄷ 데이터베이스, 65, 67 ㄹ 라이선스키, 31 로그인화면, 34 로그파일, 29 리눅스쓰리래빗츠설치, 21 쓰리래빗츠시작, 22 startup.sh, 22 쓰리래빗츠종료, 22 shutdown.sh, 22 자바설치, 19 리눅스설치가이드, 19 ㅁ 맥 OS, 23 쓰리래빗츠설치, 26 쓰리래빗츠시작, 26 startup.sh, 27 쓰리래빗츠종료, 27 shutdown.sh, 27 자바설치, 23 문서와사용자수, 2 ㅅ 사용자만들기, 33 관리권한, 33 사파리, 1t 서버소프트웨어, 2 서버아이디, 33 서버애플리케이션, 1 서비스포트번호 1975, 39 변경, 39 설치마법사, 29 소프트웨어요구사항, 1 시스템요구사항, 1 ㅇ 언어영어, 31 한국어, 31 영어글꼴등록, 34 Liberation 글꼴, 34 영어문서, 34 오라클, 65 운영체제, 2 리눅스, 19 우분투, 20 맥 OS, 23 윈도우, 3, 11 윈도우 7, 3, 11 웹기반소프트웨어, 1 웹뷰어오페라 11, 2 인터넷익스플로러 6 7, 2 웹브라우저, 1 사파리, 1t 69

70 찾아보기 인터넷익스플로러, 1t 크롬, 1t 파이어폭스, 1t 윈도우쓰리래빗츠설치, 5, 16 쓰리래빗츠시작, 16 startup.bat, 9, 16 쓰리래빗츠종료, 17 shutdown.bat, 9, 17 자바설치, 11 윈도우설치가이드, 3, 11 인터넷익스플로러, 1t ㅈ 자바, 2 IBM 자바, 2 JAVA_HOME, 13 JDK, 13 JRE, 13 JRE_HOME, 13 OpenJDK, 2, 19 정지포트번호 5791, 40 변경, 40 ㅊ 최소요구사항, 1 최종사용자사용권계약서, 30 ㅋ 크롬, 1t ㅍ 파이어폭스, 1t 포트번호변경서비스포트, 39 정지포트, 39 ㅎ 하드웨어요구사항, 2