쓰리래빗츠 3.0 설치 가이드

쓰리래빗츠 3.0 설치가이드

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

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

차례 차례..................................................... v 그림차례................................................. ix 표차례 머리말................................................... xi................................................... xiii 1. 시스템요구사항........................................ 1 1.1 소프트웨어요구사항....................................... 2 1.1.1 웹브라우저........................................... 2 1.1.2 서버소프트웨어........................................ 2 1.1.2.1 운영체제.......................................... 3 1.1.2.2 자바............................................. 3 1.2 하드웨어요구사항......................................... 3 2. 윈도우설치가이드....................................... 5 2.1 쓰리래빗츠설치파일내려받기................................ 6 2.2 쓰리래빗츠설치........................................... 7 2.3 쓰리래빗츠시작하기........................................ 11 3. 윈도우설치가이드 (ZIP 버전 )................................ 13 3.1 자바 8.0 이상설치......................................... 14 3.1.1 자바설치여부와버전확인................................ 14 v

3.1.2 자바설치............................................. 15 3.1.3 JAVA_HOME 환경변수설정................................. 16 3.2 쓰리래빗츠설치 3.3 데이터베이스설정 3.4 쓰리래빗츠시작 3.5 쓰리래빗츠종료........................................... 19......................................... 20........................................... 21........................................... 21 4. 리눅스설치가이드....................................... 23 4.1 자바 8.0 이상설치......................................... 24 4.1.1 자바설치여부와버전확인................................ 24 4.1.2 자바설치 4.2 쓰리래빗츠설치............................................. 24........................................... 24 4.3 데이터베이스설정 4.4 쓰리래빗츠시작 4.5 쓰리래빗츠종료......................................... 26........................................... 26........................................... 27 5. 맥 OS 설치가이드....................................... 29 5.1 자바 8.0 이상설치 5.1.1 자바버전확인 5.1.2 자바업데이트 5.2 쓰리래빗츠설치 5.3 쓰리래빗츠시작 5.4 쓰리래빗츠종료......................................... 30......................................... 30......................................... 31........................................... 32........................................... 33........................................... 34 6. 설치마법사............................................ 35 6.1 설치마법사시작하기 6.2 설치마법사로설정하기....................................... 35...................................... 36 부록 A. 윈도우서비스로시작................................. 43 A.1 파일다운로드............................................. 43 A.2 서비스에등록하기 A.3 서비스에서삭제하기......................................... 44........................................ 45 A.4 JRE 를업데이트했을때...................................... 45 vi 차례

A.5 기타설정................................................ 46 A.5.1 자바힙메모리설정..................................... 46 부록 B. 아파치웹서버연동................................... 47 B.1 mod_jk 설치.............................................. 47 B.1.1 B.1.2 리눅스에설치 윈도우에설치......................................... 47......................................... 49 B.2 mod_jk 설정.............................................. 50 B.2.1 httpd.conf 을이용...................................... 50 B.2.2 mods-enable 디렉토리를이용해서활성화..................... 51 B.3 workers.properties 만들기................................... 52 B.3.1 B.3.2 리눅스에서사용하는파일 윈도우에서사용하는파일................................. 52................................. 56 B.4 아파치웹서버설정......................................... 60 B.5 톰캣설정................................................ 63 부록 C. ISS 웹서버연동..................................... 65 C.1 isapi_redirect.dll 설치 C.2 isapi_redirect.dll 설정.................................... 65.................................... 67 C.3 ISS 관리자설정........................................... 73 C.4 톰캣설정................................................ 80 부록 D. 오라클데이터베이스사용.............................. 83 D.1 오라클데이터베이스 JDBC 드라이버추가........................ 83 D.2 환경설정파일변경........................................ 84 부록 E. MS SQL 서버데이터베이스사용......................... 87 E.1 MS SQL 서버 JDBC 드라이버추가.............................. 87 E.2 환경설정파일변경......................................... 88 부록 F. iptables 로 80 포트사용하기............................ 91 찾아보기.................................................. 93 vii

그림차례 3. 윈도우설치가이드 (ZIP 버전 )................................ 13 그림 3-1 명령프롬프트실행..................................... 14 그림 3-2 자바버전확인........................................ 15 그림 3-3 컴퓨터속성메뉴열기................................... 16 그림 3-4 컴퓨터에대한기본정보보기.............................. 17 그림 3-5 그림 3-6 그림 3-7 그림 3-8 시스템속성창환경변수창새시스템변수제품폴더구성........................................ 17.......................................... 18........................................ 19........................................ 20 4. 리눅스설치가이드....................................... 23 그림 4-1 제품디렉터리구성..................................... 25 5. 맥 OS 설치가이드....................................... 29 그림 5-1 제품디렉터리구성..................................... 33 6. 설치마법사............................................ 35 그림 6-1 최종사용자사용권계약서동의............................ 37 그림 6-2 그림 6-3 기본정보입력 라이선스키입력........................................ 38....................................... 39 그림 6-4 사용자만들기......................................... 40 부록 B. 아파치웹서버연동................................... 47 ix

그림 B-1 그림 B-2 64 비트일때받는파일 32 비트일때받는파일................................... 49................................... 49 부록 C. ISS 웹서버연동..................................... 65 그림 C-1 그림 C-2 64 비트일때받는파일 32 비트일때받는파일................................... 66................................... 66 그림 C-3 isapi_redirect.dll 사용에필요한파일및디렉터리............ 67 x 그림차례

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

머리말 이책의내용 쓰리래빗츠북과비주얼을설치하는방법을운영체제별로설명합니다. 쓰리래빗츠를관리하는방법은쓰리래빗츠관리자가이드를, 쓰리래빗츠북을사용하는방법은쓰리래빗츠북사용자가이드를, 쓰리래빗츠비주얼을사용하는방법은쓰리래빗츠비주얼사용자가이드를, 쓰리래빗츠드라이브를사용하는방법은쓰리래빗츠드라이브사용자가이드를참고합니다. 이책의구성은다음과같습니다. 윈도우 윈도우에쓰리래빗츠를설치하는방법을설명합니다. 1. 시스템요구사항 3. 윈도우설치가이드 (ZIP 버전 ) xiii

6. 설치마법사 리눅스 리눅스에쓰리래빗츠를설치하는방법을설명합니다. 1. 시스템요구사항 4. 리눅스설치가이드 6. 설치마법사 맥 OS 맥 OS 에쓰리래빗츠를설치하는방법을설명합니다. 1. 시스템요구사항 5. 맥 OS 설치가이드 6. 설치마법사 부록 부록 A. 윈도우서비스로시작 : 윈도우서비스로등록하는방법을설명합니다. 부록 B. 아파치웹서버연동 : 아파치웹서버와쓰리래빗츠를연동하는방법을설명합니다. 부록 C. ISS 웹서버연동 : ISS 웹서버와쓰리래빗츠를연동하는방법을설명합니다. 부록 D. 오라클데이터베이스사용 : 데이터베이스로오라클을사용하는방법을설명합니다. 부록 E. MS SQL 서버데이터베이스사용 : 데이터베이스로 MS SQL 서버를사용하는방법을설명합니다. 부록 F. iptables로 80 포트사용하기 : 리눅스에서 iptables로 80 포트를사용하는방법을설명합니다. xiv 머리말

일러두기 다음은이책에서사용한주요서식에대한설명입니다. 주요서식항목 설명 예 강조 강조가필요한단어및문장은진하게표기했습니다. 강조 메뉴, 버튼, 링 메뉴, 링크, 버튼등은앞과뒤에 < 과 > 를넣어표기했습니다. < 저장 > 크 단축키 키보드에서동시에눌러야하는단축키는 + 로연결했습니다. Ctrl + I 그리고고정폭글꼴로표기했습니다. 코드, 파일이름 코드, 명령어, 파일이름등은고정폭글꼴로표기했습니다. 3RABBIZ_HOM E 다음과같이노트, 팁, 주의를제공합니다. 노트는본문에간단하게추가할짧은설명이나참조, 논평을제공하기위해 사용합니다. 팁은도움말등의팁을제공하기위해사용합니다. 주의는독자또는사용자의주의를환기하는문장을제공하기위해사용합니 다. 일러두기 xv

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

시스템요구사항 1. 1.1 소프트웨어요구사항........................................... 2 1.1.1 웹브라우저.............................................. 2 1.1.2 서버소프트웨어 1.1.2.1 운영체제........................................... 2............................................. 3 1.1.2.2 자바................................................. 3 1.2 하드웨어요구사항............................................ 3 쓰리래빗츠는자바로개발한서버애플리케이션으로, 설치후에웹브라우저로접속하여사용하는웹기반소프트웨어입니다. 따라서일반사용자는별도로소프트웨어를설치할필요가없습니다. 다만서버에쓰리래빗츠를설치하기위한하드웨어와소프트웨어가필요합니다. 이장에서는이에필요한정보를설명합니다. 여기서언급하는모든요구사항은최소요구사항입니다. 1

1.1 소프트웨어요구사항 1.1.1 웹브라우저 표 1-1 지원하는웹브라우저 웹브라우저 지원버전 운영체제 마이크로소프트인터넷익스 엣지최신버전또는 11 이상 윈도우 플로러 모질라파이어폭스 최신버전기준 윈도우, 리눅스, 맥 OS 구글크롬 최신버전기준 윈도우, 리눅스, 맥 OS 애플사파리 최신버전기준 윈도우, 맥 OS, ios 1 HTML5 를지원하는웹브라우저만을사용할수있습니다. 쓰리래빗츠북에서문서를읽을때사용하는웹뷰어는인터넷익스플로러 8 이상 과오페라 11 이상을지원합니다. 웹브라우저지원내역에대한상세정보는 < 쓰리래빗츠북사용자가이드 웹브라우저 > 를참고합니다. 1.1.2 서버소프트웨어 1. ios 8 이상을지원하는데일부기능은사용할수없습니다. 2 시스템요구사항

1.1.2.1 운영체제 자바 8 이상을설치할수있는운영체제를지원합니다. 1.1.2.2 자바 쓰리래빗츠를실행하려면운영체제에오라클자바 8.0 이상을설치해야합니다. IBM 자바는지원하고 OpenJDK 는지원하지않습니다. 1.2 하드웨어요구사항 쓰리래빗츠를최소 2GHz CPU / 최소 4G RAM / 최소 200G HDD 이상의하드웨어 를갖춘서버에설치해야합니다. 하드웨어사양은책과사용자수에따라달라집니다. 개인컴퓨터에설치하 여사용할수도있습니다. 하드웨어요구사항 3

윈도우설치가이드 2. 2.1 쓰리래빗츠설치파일내려받기.................................... 6 2.2 쓰리래빗츠설치............................................... 7 2.3 쓰리래빗츠시작하기........................................... 11 현재는설치파일 (exe) 을제공하고있지않습니다. 3. 윈도우설치가이드 (ZI P 버전 ) 을참고해서설치합니다. 다음순서로윈도우에쓰리래빗츠를설치합니다. 윈도우 8.1 을기준으로설명합니다. 1. 쓰리래빗츠설치파일을내려받습니다. 2. 쓰리래빗츠설치파일을실행합니다. 3. 쓰리래빗츠를시작합니다. 4. 설치마법사를실행합니다. 5

2.1 쓰리래빗츠설치파일내려받기 쓰리래빗츠홈페이지에서설치파일을내려받습니다. 32 비트와 64 비트를구분해서내 려받습니다. 다음순서로시스템종류를확인합니다. 1. 탐색기를열고, 1 내 PC( 또는내컴퓨터 ) 를오른쪽클릭하면컨텍스트메뉴가나타 납니다. 2. 컨텍스트메뉴에서 < 2 속성 > 메뉴를클릭합니다. 6 윈도우설치가이드

3. 3 시스템종류에서 32 비트인지 64 비트인지를확인합니다. 2.2 쓰리래빗츠설치 쓰리래빗츠를설치할때 PC 보호기능으로인해다음안내창이나타날수있습니다. 쓰리래빗츠설치 7

윈도우 8 PC 보호안내창 1 추가정보를클릭하면나타나는화면에서 2 실행버튼을클릭합니다. 8 윈도우설치가이드

윈도우 7 PC 보호안내창 1 실행버튼을클릭합니다. 내려받은설치파일을실행합니다. 쓰리래빗츠설치 9

설치경로를선택합니다. C:\Program Files 폴더에는설치할수없습니다. 자바가없다면설치과정에서자바 (JRE) 를설치하기때문에오래걸릴수있습니다. 10 윈도우설치가이드

2.3 쓰리래빗츠시작하기 쓰리래빗츠를설치하면시작메뉴에다음메뉴가나타납니다. Access 3Rabbitz Start 3Rabbitz Stop 3Rabbitz Uninstall <Start 3Rabbitz> 메뉴로쓰리래빗츠를시작합니다. 다음과같이콘솔이나타납니다. 쓰리래빗츠를실행한후 <Access 3Rabbitz> 메뉴를선택하면기본웹브라우저로쓰리래빗츠에접근합니다. 처음실행했을때는라이선스키입력과기본설정을하는데필요한설치마법사가나타납니다. 자세한사항은 6. 설치마법사를참고합니다. 쓰리래빗츠를정지하려면시작메뉴에서 <Stop 3Rabbitz> 메뉴를선택하거나앞에 쓰리래빗츠시작하기 11

나타난콘솔에서 Ctrl + C 키를누릅니다. 시작메뉴가없을때는다음순서로쓰리래빗츠를시작합니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한폴더를지칭합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. startup.bat 파일을실행합니다. 시작메뉴가없을때는다음순서로쓰리래빗츠를종료합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. shutdown.bat 파일을실행합니다. 12 윈도우설치가이드

윈도우설치가이드 (ZIP 버전 ) 3. 3.1 자바 8.0 이상설치............................................. 14 3.1.1 자바설치여부와버전확인................................... 14 3.1.2 자바설치................................................ 15 3.1.3 JAVA_HOME 환경변수설정.................................... 16 3.2 쓰리래빗츠설치 3.3 데이터베이스설정 3.4 쓰리래빗츠시작............................................... 19............................................. 20............................................... 21 3.5 쓰리래빗츠종료............................................... 21 다음순서로윈도우에쓰리래빗츠를설치합니다. 윈도우 8.1 을기준으로설명합니다. 1. 자바 8.0 이상을설치합니다. 2. 쓰리래빗츠설치파일을내려받습니다. 3. 쓰리래빗츠설치파일압축을풉니다. 4. 쓰리래빗츠를시작합니다. 5. 설치마법사를실행합니다. 13

3.1 자바 8.0 이상설치 3.1.1 자바설치여부와버전확인 다음순서로자바설치여부와버전을확인합니다. 1. 윈도우 + X 단축키를누르면나타나는컨텍스트메뉴에서 < 1 명령프롬프트 > 메 뉴를선택합니다. 그림 3-1 명령프롬프트실행 2. 명령프롬프트에서다음명령어를실행합니다. 14 윈도우설치가이드 (ZIP 버전 )

java -version 다음과같은결과가나타나지않거나버전이 1.8 이상이아니면자바를설치해야 합니다. 그림 3-2 자바버전확인 3.1.2 자바설치 다음순서로윈도우에자바를설치합니다. 1. 오라클자바사이트에서자바설치파일을내려받습니다. 자바 8 이상을내려받아야합니다.. 32 비트윈도우를사용하면 Windows x86 Offline 을, 64 비트윈도우를사용 하면 Windows x64 를선택합니다. JRE 를내려받을것인가? JDK 를내려받을것인가? JRE(Java Runtime Environment) 는자바로만든소프트웨어 ( 쓰리래빗츠와같은 ) 를실행시키기위한것이고, JDK(Java Development Kit) 는자바소프트웨어개발에필요한도구와 JRE의묶음입니다. 모두사용가능합니다. 하지만 JRE는자동업데이트로인한불편함이있습니다. JRE를자동업데이트해도 JRE_HOME 경로는일일이바꿔야합니다. 따라서 JDK를사용하는것을권장합니다. 자바 8.0 이상설치 15

2. 내려받은파일을클릭하여자바를설치합니다. 3.1.3 JAVA_HOME 환경변수설정 다음순서로 JAVA_HOME 환경변수를설정합니다. 1. 탐색기를열고, 1 내 PC( 또는내컴퓨터 ) 를오른쪽클릭하면컨텍스트메뉴가나타 납니다. 2. 컨텍스트메뉴에서 < 2 속성 > 메뉴를클릭합니다. 그림 3-3 컴퓨터속성메뉴열기 16 윈도우설치가이드 (ZIP 버전 )

3. 좌측메뉴에서 < 3 고급시스템설정 > 메뉴를클릭합니다. 그림 3-4 컴퓨터에대한기본정보보기 4. 시스템속성창에서 < 4 고급 > 탭아래에있는 < 5 환경변수 > 버튼을클릭합니다. 그림 3-5 시스템속성창 자바 8.0 이상설치 17

5. 환경변수창 < 6 시스템변수 > 패널아래에있는 < 7 새로만들기 > 버튼을클릭합 니다. 그림 3-6 환경변수창 6. 새시스템변수창에서변수이름과값을입력하고 < 8 확인 > 버튼을클릭합니다. 18 윈도우설치가이드 (ZIP 버전 )

그림 3-7 새시스템변수 변수값에는 JDK 를설치한폴더경로를입력해야하는데자세한경로는 C:\Progr am Files\Java 폴더에서확인합니다. 표 3-1 환경변수 변수이름변수값 1 JDK 를설치 JAVA_HOME C:\Program Files\Java\jdk1.8.0_20 만약 JRE_HOME 을설정했다면 JAVA_HOME 보다 JRE_HOME 이우선합니다. 3.2 쓰리래빗츠설치 설치파일을내려받아압축을풀면쓰리래빗츠설치가끝납니다. 1. 쓰리래빗츠다운로드페이지에서윈도우용설치파일을내려받습니다. 1. 변수값은자바버전과폴더위치에따라서다릅니다. 쓰리래빗츠설치 19

2. 압축을푼후 3rabbitz 폴더를설치하고자하는폴더로옮깁니다. 설치하려는폴더전체경로에공백문자와특수문자 (~!@$%^&*()_+ "<>':` ) 가없어야합니다. 그림 3-8 제품폴더구성 3.3 데이터베이스설정 다른데이터베이스를사용하려면쓰리래빗츠를시작하기전에데이터베이스연결정 보를설정합니다. 다음문서를참고합니다. 쓰리래빗츠설치파일에들어있는기본데이터베이스를사용한다면다음단 계로넘어갑니다. 부록 D. 오라클데이터베이스사용 부록 E. MS SQL 서버데이터베이스사용 20 윈도우설치가이드 (ZIP 버전 )

3.4 쓰리래빗츠시작 3RABBITZ_HOME 은쓰리래빗츠를설치한폴더를지칭합니다. 다음순서로쓰리래빗츠를시작합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. startup.bat 파일을실행합니다. 3. 6. 설치마법사로초기설정작업을수행합니다. 3.5 쓰리래빗츠종료 다음순서로쓰리래빗츠를종료합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. shutdown.bat 파일을실행합니다. 쓰리래빗츠종료 21

리눅스설치가이드 4. 4.1 자바 8.0 이상설치............................................. 24 4.1.1 자바설치여부와버전확인................................... 24 4.1.2 자바설치 4.2 쓰리래빗츠설치................................................ 24............................................... 24 4.3 데이터베이스설정 4.4 쓰리래빗츠시작............................................. 26............................................... 26 4.5 쓰리래빗츠종료............................................... 27 다음순서로리눅스에쓰리래빗츠를설치합니다. 1. 자바 8.0 이상을설치합니다. 2. 쓰리래빗츠설치파일을내려받습니다. 3. 쓰리래빗츠설치파일압축을풉니다. 4. 터미널에서쓰리래빗츠를시작합니다. 5. 설치마법사를실행합니다. 23

4.1 자바 8.0 이상설치 4.1.1 자바설치여부와버전확인 자바설치여부와버전확인을위해터미널에서다음명령어를실행합니다. java -version 자바가없거나버전이 1.8 이상이아니거나 OpenJDK 이면자바를설치해야합니다. 4.1.2 자바설치 리눅스배포판과버전에따라자바를설치하는방법이다릅니다. 자바설치는리눅스 배포판과버전에맞게진행합니다. 4.2 쓰리래빗츠설치 설치파일을내려받아압축을풀면쓰리래빗츠설치가끝납니다 1. 쓰리래빗츠다운로드페이지에서리눅스용설치파일을내려받습니다. 2. 리눅스서버로 FTP 등을이용해서내려받은파일을전송합니다. 24 리눅스설치가이드

리눅스서버가인터넷에연결되어있다면다음명령어로리눅스서버로 설치파일을내려받을수있습니다. wget http://www.3rabbitz.com/r/home/download/linux --contentdisposition 설치하려는디렉터리전체경로에공백문자와특수문자 (~!@$%^&* ()_+ "<>':`) 가없어야합니다. 3. tar 명령어로압축파일을풉니다. tar -xvf 3rabbitz-1790.tar.gz 그림 4-1 제품디렉터리구성 4. 리눅스사용자설정파일 (.profile) 또는쓰리래빗츠실행파일 (3RABBITZ_HOME/ bin/startup.sh 과 3RABBITZ_HOME/bin/shutdown.sh) 에 JAVA_HOME 을설정합니 다. JAVA_HOME=/usr/lib/jvm/java-8-oracle export JAVA_HOME 쓰리래빗츠설치 25

경로는자바버전과디렉터리위치에따라서다릅니다. 4.3 데이터베이스설정 다른데이터베이스를사용하려면쓰리래빗츠를시작하기전에데이터베이스연결정 보를설정합니다. 다음문서를참고합니다. 쓰리래빗츠설치파일에들어있는기본데이터베이스를사용한다면다음단 계로넘어갑니다. 부록 D. 오라클데이터베이스사용 부록 E. MS SQL 서버데이터베이스사용 4.4 쓰리래빗츠시작 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 다음순서로쓰리래빗츠를시작합니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. 다음명령어를실행합니다. 26 리눅스설치가이드

./startup.sh 3. 6. 설치마법사로초기설정작업을수행합니다. 4.5 쓰리래빗츠종료 다음순서로쓰리래빗츠를종료합니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. 다음명령어를실행합니다../shutdown.sh 쓰리래빗츠종료 27

맥 OS 설치가이드 5. 5.1 자바 8.0 이상설치 5.1.1 자바버전확인 5.1.2 자바업데이트............................................. 30............................................ 30............................................. 31 5.2 쓰리래빗츠설치 5.3 쓰리래빗츠시작 5.4 쓰리래빗츠종료............................................... 32............................................... 33............................................... 34 다음순서로맥 OS 에쓰리래빗츠를설치합니다. 1. 자바 8.0 이상을설치합니다. 2. 쓰리래빗츠설치파일을내려받습니다. 3. 쓰리래빗츠설치파일압축을풉니다. 4. 터미널에서쓰리래빗츠를시작합니다. 5. 설치마법사를실행합니다. 29

5.1 자바 8.0 이상설치 맥 OS 에는자바가설치되어있습니다. 자바버전이 8.0 보다낮으면업데이트합니다. 5.1.1 자바버전확인 다음순서로자바버전을확인합니다. 1. 도크에있는 < 응용프로그램 유틸리티 > 메뉴에서터미널을실행합니다. 2. 터미널에서다음명령어를실행합니다. java -version 버전이 1.8 이상이아니면자바를업데이트해야합니다. 30 맥 OS 설치가이드

5.1.2 자바업데이트 다음순서로자바를업데이트합니다. 1. 도크에있는 < 시스템환경설정 > 메뉴를실행합니다. 2. < 시스템환경설정 > 메뉴에서 < 시스템 소프트웨어업데이트 > 메뉴를클릭합니다. 3. 소프트웨어업데이트에있는 < 지금확인 > 버튼을클릭하여자바를업데이트합니 다. 자바 8.0 이상설치 31

5.2 쓰리래빗츠설치 설치파일을내려받아압축을풀면쓰리래빗츠설치가끝납니다. 1. 쓰리래빗츠다운로드페이지에서맥 OS 용설치파일을내려받습니다. 2. 압축을푼후설치하고자하는디렉터리로 3rabbitz 디렉터리를옮깁니다. 설치하려는디렉터리전체경로에공백문자와특수문자 (~!@$%^&*()_+ "<>':`) 가없어야합니다. 32 맥 OS 설치가이드

그림 5-1 제품디렉터리구성 5.3 쓰리래빗츠시작 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 다음순서로쓰리래빗츠를시작합니다. 1. 도크에있는 < 응용프로그램 유틸리티 > 메뉴에서터미널을실행합니다. 2. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 3. 다음명령어를실행합니다../startup.sh 쓰리래빗츠시작 33

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

설치마법사 6. 6.1 설치마법사시작하기 6.2 설치마법사로설정하기........................................... 35......................................... 36 6.1 설치마법사시작하기 쓰리래빗츠를시작한후웹브라우저에서다음 URL 로이동하면설치마법사가나타납 니다. http://<domain_name_or_ip_address>:1975 기본포트번호는 1975 입니다. 바꾸려면포트번호바꾸기를참고합니다. 개인컴퓨터에설치했다면다음 URL 로접속합니다. 35

http://127.0.0.1:1975 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 설치마법사가나타나지않으면 3RABBITZ_HOME/logs 디렉터리에있는로그 파일을확인합니다. 6.2 설치마법사로설정하기 설치마법사로다음작업을수행합니다. 최종사용자사용권계약서동의 기본정보설정 기본 URL 데이터디렉터리와백업디렉터리 라이선스키입력 사용자만들기 1 최종사용자사용권계약서동의 최종사용자사용권계약서내용에동의해야다음단계로넘어갑니다. 36 설치마법사

그림 6-1 최종사용자사용권계약서동의 설치마법사에서사용할언어를변경할수있습니다. 영어와한국어를 지원합니다. 2 기본정보설정 이단계에서설정하는항목은다음과같습니다. 기본 URL 설치한쓰리래빗츠주소로문서링크와메일발송등에사용합니다. 도메 인주소나 IP 주소를입력합니다. 설치마법사로설정하기 37

데이터디렉터리데이터베이스, 글꼴, 이미지, PDF, EPUB 등의다양한데이터를저장하는디렉터리입니다. 백업디렉터리데이터베이스와이미지를백업하는디렉터리입니다. 그림 6-2 기본정보입력 안정성을위해데이터디렉터리와디스크가다른디렉터리를백업디 렉터리로사용하는것을권장합니다. 3 라이선스키입력 라이선스키를입력합니다. 38 설치마법사

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

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

< 설치 > 링크를클릭하면설치를시작합니다. 설치가끝나면로그인화면으로이 동합니다. 설치마법사로설정하기 41

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

A.2 서비스에등록하기 다음순서로서비스에쓰리래빗츠를등록합니다. 1. 관리자권한으로명령프롬프트를시작합니다. I. 윈도우 < 시작 > 메뉴실행창에서 CMD를입력합니다. II. 메뉴에서명령프롬프트를오른쪽클릭하면컨텍스트메뉴가나타납니다. III. 관리자권한으로실행을선택합니다. 2. 3RABBITZ_HOME\bin 폴더로이동합니다. 3. 다음명령어를실행합니다. service.bat install 작업을끝내면윈도우서비스에 3Rabbitz 이라는이름이나타납니다. 44 윈도우서비스로시작

서비스의시작유형은수동입니다. 윈도우가시작할때쓰리래빗츠를자동 으로시작하려면시작유형을자동으로바꿉니다. A.3 서비스에서삭제하기 다음순서로쓰리래빗츠를서비스에서삭제합니다. 1. 관리자권한으로명령프롬프트를시작합니다. I. 윈도우 < 시작 > 메뉴실행창에서 CMD를입력합니다. II. 메뉴에서명령프롬프트를오른쪽클릭하면컨텍스트메뉴가나타납니다. III. 관리자권한으로실행을선택합니다. 2. 3RABBITZ_HOME\bin 폴더로이동합니다. 3. 다음명령어를실행합니다. service.bat remove A.4 JRE 를업데이트했을때 JRE 를업데이트하면서비스를삭제한후다시등록해야합니다. 쓰리래빗츠를 JRE 가 아닌 JDK 로실행하고있다면상관없습니다. JRE 를업데이트했을때 45

A.5 기타설정 A.5.1 자바힙메모리설정 다음순서로자바힙메모리설정을바꿉니다. 1. 3RABBITZ_HOME\bin 폴더로이동합니다. 2. 다음명령어를실행합니다. tomcat8 //US//3Rabbitz --JvmMs 256 --JvmMx 1024 3. 쓰리래빗츠서비스를재시작합니다. 46 윈도우서비스로시작

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

서버가인터넷에연결되어있다면다음과같이쉽게받을수있습니다. 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 1../configure 값은 " 아파치설치디렉토리 /bin/apxs" 을사용합니다. 48 아파치웹서버연동

B.1.2 윈도우에설치 1 1 binaries 를이용하여컴파일된파일을받습니다. 파일을받는경로는여기입 니다. 아파치웹서버의종류에따라 32 비트, 64 비트로받을파일이다릅니다. OS 가아닌, 아파치웹서버의종류에따라파일이달라집니다. 예를들 면윈도우 64 비트에서아파치웹서버 32 비트를사용하고있다면 32 비 트파일을받아야합니다. 그림 B-1 64 비트일때받는파일 그림 B-2 32 비트일때받는파일 mod_jk 설치 49

2 압축파일을풀어서 mod_jk.so 파일을 < 아파치웹서버설치경로 \modules> 로 복사합니다. B.2 mod_jk 설정 B.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 50 아파치웹서버연동

JkLogStampFormat "[%a %b %d %H:%M:%S %Y] " 자세한내용은공식사이트문서를참고합니다. 아파치웹서버가설치된경로를기준으로상대경로를이용합니다. B.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] " mod_jk 설정 51

JkRequestLogFormat "%w %V %T" 3 jk.load 내용을입력합니다. LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so B.3 workers.properties 만들기 으로시작하는문장들은설명을위한주석입니다. 이해를돕기위해지우지 않았습니다. 리눅스에서는슬러쉬문자를윈도우에서는역슬러쉬문자를사용하는것을 주의하세요. B.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. 52 아파치웹서버연동

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.properties 만들기 53

workers.tomcat_home=/home/rabbitz/app-1-0/tomcat workers.java_home should point to your Java installation. Normally 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 54 아파치웹서버연동

------ 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. workers.properties 만들기 55

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 아파치설정에서사용합니다. B.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. 56 아파치웹서버연동

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 58 아파치웹서버연동

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 아파치설정에서사용합니다. B.4 아파치웹서버설정 아파치웹서버에서 mod_jk 로요청을보내도록다음예시에서강조한내용을추가합 니다. 수정할파일은 sites-availables 디렉터리의 default 또는 default-ssl 입니 다. 60 아파치웹서버연동

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> 만약서브도메인을이용하려면다음과같이설정합니다. 아파치가상호스트문서를참 고하세요. 2. 정적파일을웹서버에서처리하기위한설정입니다. 아파치웹서버설정 61

<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> 개인 PC 에서사용하기위해서는 hosts 파일에사용할도메인정보를넣어야 합니다. hosts 파일은 < 윈도우설치경로 C:\Windows\System32\Drive rs\etc> 에있습니다. 3. 정적파일을웹서버에서처리하기위한설정입니다. 62 아파치웹서버연동

127.0.0.1 doc.3rabbitz.com XAMP 의경우가상호스트를관리하는파일은 <XAMP 설치경로 \apach e\conf\extra\httpd-vhosts.conf> 입니다. B.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" />  톰캣설정 63

</Service> </Server> 1 AJP/1.3 설정을위한 Connector 의주석을풉니다. work.properties 를설정할때 8009 포트번호를바꿨다면바뀐번호 를사용합니다. 2 HTTP/1.1 를위한 Connector 를주석으로막습니다. 웹서버를거치지않고 1975 포트로쓰리래빗츠에접근하는것도허용 하려면주석으로바꾸지않습니다. 3 쓰리래빗츠를다시시작합니다. 쓰리래빗츠를다시시작할때변경한내용을사용합니다. 64 아파치웹서버연동

ISS 웹서버연동부록 C. 쓰리래빗츠와웹서버를연동하려면아파치톰캣커넥터를사용합니다. 쓰리래빗츠가 아파치톰캣을이용하기때문입니다. 윈도우 8 을기준으로설명합니다. 윈도우버전에따라 IIS 관리자화면이다 릅니다. C.1 isapi_redirect.dll 설치 1 설치에필요한파일을받습니다. IIS와연동하려면 isapi_redirect.dll를설치합니다. 설치파일은아파치톰캣커넥터페이지에서받습니다. 1 링크를이용하여사용하는 OS에맞는파일을받습니다. 아파치톰캣커넉터는 1.2.40 버전을예로듭니다. 65

윈도우는 32 비트, 64 비트에따라다른파일을받습니다. 그림 C-1 64 비트일때받는파일 그림 C-2 32 비트일때받는파일 2 isapi_redirect.dll을복사합니다. 받은압축파일을풀어서 isapi_redirect.dll을쓰리래빗츠설치위치아래 iss 디렉터리 ( 기본설치시 C:\3rabbitz\iis) 로복사합니다. iss 디렉터리는설치후별도로만들어야합니다. 관리의편리성을위하여 iss 연동과관련된파일은쓰리래빗츠설치위 치아래 iss 디렉터리 ( 기본설치시 C:\3rabbitz\iis) 에함께있도록합니 66 ISS 웹서버연동

다. C.2 isapi_redirect.dll 설정 1 isapi_redirect.dll 가위치한디렉터리에다음디렉터리및파일을만듭니다. 디렉터리 파일 logs isapi_redirect.properties uriworkermap.properties workers.properties 그림 C-3 isapi_redirect.dll 사용에필요한파일및디렉터리 예시에사용된파일은여기에서다운받습니다. 예시의내용을실제환 경에맞게수정합니다. 자세한내용은공식사이트문서를참고합니다. 2 isapi_redirect.properties 내용을입력합니다. isapi_redirect.dll 설정 67

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 68 ISS 웹서버연동

Exclude the static files!/resource/*=*!/resource/*=* 설정으로인하여 static 파일은 ISS 웹서버가바로처 리하게됩니다. 4 workers.properties 내용을입력합니다. 윈도우에설치했을때는 workers.java_home 값에 JDK 가아닌 JRE 경 로가포함되어도괜찮습니다. 윈도우시스템속성의환경변수에있는 JRE_HOME 또는 JAVA_HOME 값을입력합니다. 으로시작하는문장들은설정에영향을미치지않는주석입니다. 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: isapi_redirect.dll 설정 69

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 1. 쓰리래빗츠가설치된경로아래의 tomcat 디렉터리를입력합니다. 70 ISS 웹서버연동

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. ps=\ ------ ADVANCED MODE ------------------------------------------------ ---------------------------------------------------------------- ----- ------ worker list ------------------------------------------ ---------------------------------------------------------------- ----- The workers that your plugins should create and work with 2. JDK 가설치된위치를입력합니다. JRE 를이용하여설치한경우시스템속성의환경변수에있 는 JRE_HOME 경로를입력합니다. isapi_redirect.dll 설정 71

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 72 ISS 웹서버연동

---------------------- ---------------------------------------------------------------- ----- 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 설정값에대한자세한설명은아파치톰캣커넥트공식문서를참고하 세요. C.3 ISS 관리자설정 isapi_redirect.dll 를 IIS 에서사용하기위해 ISS( 인터넷정보서비스 ) 관리자를이용 하여다음처럼설정합니다. 1 웹사이트를추가합니다. ISS 관리자설정 73

1 사이트선택후마우스우클릭메뉴에서웹사이트추가를선택합니다. 2 사이트이름은 3rabbitz로입력합니다. 응용프로그램풀은자동으로만들어집니다. 3 실제경로는쓰리래빗츠설치위치아래 web 디렉터리 ( 기본설치시 C:\3rabbit z\web) 를입력합니다. 4 호스트이름은사용할서브도메인명이있다면서브도메인명을포함하여입력합니다. 웹서버로들어오는모든서브도메인을쓰리래빗츠와연결하려면공란으로남겨둡니다. 74 ISS 웹서버연동

한서버에서홈페이지와매뉴얼페이지를모두운영하고자할때서브도메인을이용합니다. 'www.3rabbitz.com -> 홈페이지 ', 'doc.3rab bitz.com -> 쓰리래빗츠 ' 와같이서비스하려면호스트이름에 'doc.3 rabbitz.com' 를입력해야합니다. 2 가상디렉터리를추가합니다. 5 웹사이트선택하고마우스우클릭메뉴에서가상디렉터리추가기능을선택 합니다. 6 별칭에는 isapi_redirect.properties 파일의 extension_uri=/3rabbitz/ ISS 관리자설정 75

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

'ISAPI-dll' 항목이활성화되지않은경우 < 제어판 프로그램 프로그램및기능 Window 기능켜기 / 끄기 > 메뉴를이용하여 ISAPI 필터, I SAPI 확장기능을켭니다. 이기능을추가하지않으면다음단계의 'ISAPI 및 CGI 제한 ' 및 'ISAPI 필터 ' 설정도할수없습니다. ISS 관리자설정 77

5 12 좌측메뉴에서서버를선택하고 13 'ISAPI 및 CGI 제한 ' 을선택합니다. 78 ISS 웹서버연동

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

8 18 추가버튼을클릭하여 19 새로운 'ISAPI 필터 ' 를만듭니다. 필터이름은 3rabbitz 을실행파일은 isapi_redirect.dll 를입력합니다. 9 ISS 를재시작합니다. 서버를재시작하면사이트는재시작됩니다. 그러나응용프로그램풀 은별도로시작하여야합니다. C.4 톰캣설정 80 ISS 웹서버연동

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" />   </Service> </Server> 1 AJP/1.3 설정을위한 Connector 의주석을풉니다. work.properties 를설정할때 8009 포트번호를바꿨다면바뀐번호 를사용합니다. 톰캣설정 81

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

오라클데이터베이스사용부록 D. D.1 오라클데이터베이스 JDBC 드라이버추가............................ 83 D.2 환경설정파일변경............................................ 84 쓰리래빗츠데이터베이스로오라클데이터베이스를사용하는방법을설명합니다. 오라클데이터베이스를사용하면해당데이터베이스백업기능으로데이터 를백업해야합니다. D.1 오라클데이터베이스 JDBC 드라이 버추가 83

3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 오라클데이터베이스버전에맞는 JDBC 드라이버를 3RABBITZ_HOME/web/WEB-INF/li b 디렉터리에추가합니다. 오라클데이터베이스 JDBC 드라이버는오라클사이트에서내려받습니다. 오라클데이터베이스 11g 를사용한다면 ojdbc6.jar 드라이버를사용합니 다. D.2 환경설정파일변경 다음순서로쓰리래빗츠에오라클데이터베이스를설정합니다. 1. 3RABBITZ_HOME/tomcat/conf/server.xml 파일을엽니다. <Context docbase="${3rabbitz.home}/web" path="" reloadable="false" backgroundprocessordelay="3">  <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" 84 오라클데이터베이스사용

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. 쓰리래빗츠를재시작합니다. 설치와소프트웨어업데이트를할때자동으로쓰리래빗츠테이블을만 듭니다. username 에설정한오라클계정이테이블생성, 칼럼변경, 인 덱스추가와삭제권한을갖고있어야합니다. 환경설정파일변경 85

MS SQL 서버데이터베이스사용부록 E. E.1 MS SQL 서버 JDBC 드라이버추가................................. 87 E.2 환경설정파일변경............................................ 88 쓰리래빗츠데이터베이스로 MS SQL 서버를사용하는방법을설명합니다. MS SQL 서버 2008 버전부터지원합니다. MS SQL 서버를사용하면해당 데이터베이스백업기능으로데이터를백업해야합니다. E.1 MS SQL 서버 JDBC 드라이버추가 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. MS SQL 서버버전에맞는 JDBC 드라이버를 3RABBITZ_HOME/web/WEB-INF/lib 디렉 87

터리에추가합니다. MS SQL 서버 JDBC 드라이버는마이크로소프트사이트에서내려받습니다. MS SQL 서버 2012 를사용한다면 sqljdbc4.jar 드라이버를사용합니다. E.2 환경설정파일변경 다음순서로쓰리래빗츠에 MS SQL 서버를설정합니다. 1. 3RABBITZ_HOME/tomcat/conf/server.xml 파일을엽니다. <Context docbase="${3rabbitz.home}/web" path="" reloadable="false" backgroundprocessordelay="3">  <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" />  88 MS SQL 서버데이터베이스사용

</Context> 2. Apache Derby 설정부분을주석처리합니다. 3. MS SQL 설정부분주석을제거합니다. 4. username, password, url 등을변경합니다. 5. 쓰리래빗츠를재시작합니다. 설치와소프트웨어업데이트를할때자동으로쓰리래빗츠테이블을만 듭니다. username 에설정한 MS SQL 서버계정이테이블생성, 칼럼변 경, 인덱스추가와삭제권한을갖고있어야합니다. 환경설정파일변경 89

iptables 로 80 포트사용하기부록 F. 쓰리래빗츠는 1975 포트를사용합니다. 리눅스에서 80 포트를사용하려면 root 계정으로쓰리래빗츠를시작하거나 80 포트를사용하는웹서버와연동해야합니다. 다른프로그램이 80 포트를사용하고있지않은리눅스서버에쓰리래빗츠를설치했다면 iptables 설정으로 80 포트를사용할수도있습니다. 다음명령어로설정합니다. iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 1975 root 계정으로실행해야합니다. i 옵션으로설정한 eth0 는인터넷에연결되어있는장비를의미합니다. 서버마다이름 이다를수있습니다. 다음명령어로이름을확인합니다. cat /proc/net/dev 또는 ifconfig 명령어로확인할수있습니다. 다음명령어로설정을확인할수있습니다. 91

iptables -t nat -L 설정을삭제하려면다음명령어를실행합니다. iptables -D PREROUTING -t nat -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 1975 92 iptables 로 80 포트사용하기

찾아보기 H HTML5, 2 M MS SQL 서버, 87 S server.xml, 63, 81, 84, 88 ㄱ 개인컴퓨터, 3, 35 기본정보설정기본 URL, 37 데이터디렉터리, 38 백업디렉터리, 38 ㄷ 데이터베이스, 83, 87 ㄹ 라이선스키, 38 로그인화면, 41 로그파일, 36 리눅스쓰리래빗츠설치, 24 쓰리래빗츠시작, 26 startup.sh, 27 쓰리래빗츠종료, 27 shutdown.sh, 27 자바설치, 24 리눅스설치가이드, 23 ㅁ 맥 OS, 29 쓰리래빗츠설치, 32 쓰리래빗츠시작, 33 startup.sh, 33 쓰리래빗츠종료, 34 shutdown.sh, 34 자바설치, 30 문서와사용자수, 3 ㅅ 사용자만들기, 40 관리권한, 40 사파리, 2t 서버소프트웨어, 2 서버아이디, 40 서버애플리케이션, 1 설치마법사, 35 소프트웨어요구사항, 2 시스템요구사항, 1 93

ㅇ 언어영어, 37 한국어, 37 오라클, 83 운영체제, 3 리눅스, 23 맥 OS, 29 윈도우, 5, 13 윈도우 8.1, 5, 13 웹기반소프트웨어, 1 웹뷰어오페라 11, 2 인터넷익스플로러 8, 2 웹브라우저, 2 사파리, 2t 인터넷익스플로러, 2t 크롬, 2t 파이어폭스, 2t 윈도우쓰리래빗츠설치, 7, 19 쓰리래빗츠시작, 21 startup.bat, 12, 21 쓰리래빗츠종료, 21 shutdown.bat, 12, 21 자바설치, 14 윈도우설치가이드, 5, 13 인터넷익스플로러, 2t ㅍ 파이어폭스, 2t ㅎ 하드웨어요구사항, 3 ㅈ 자바, 3 IBM 자바, 3 JAVA_HOME, 16 JDK, 15 JRE, 15 OpenJDK, 3, 24 ㅊ 최소요구사항, 1 최종사용자사용권계약서, 36 ㅋ 크롬, 2t 94 찾아보기