3Rabbitz Book 설치가이드

3Rabbitz Book 설치가이드 ( 주 ) 쓰리래빗츠

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

목차 목차................................................................. vii 그림목차 표목차............................................................. ix............................................................... xi 1 시스템요구사항...................................................... 1 소프트웨어요구사항.......................................................... 1 클라이언트소프트웨어...................................................... 1 서버소프트웨어........................................................... 2 OS................................................................... 2 Java Development Kit (JDK)............................................... 2 하드웨어.................................................................. 2 2 윈도우시스템설치가이드.............................................. 3 Java 설치................................................................. 3 Java Development Kit (JDK) 설치여부확인...................................... 3 Java Development Kit (JDK) 설치............................................. 5 JAVA HOME 환경설정...................................................... 9 애플리케이션설치........................................................... 12 3 리눅스시스템설치가이드.............................................. 13 Java 설치................................................................. 13 Java Development Kit (JDK) 설치여부확인...................................... 13 Java Development Kit (JDK) 설치............................................. 14 애플리케이션설치........................................................... 15 4 설치마법사 EULA 정보......................................................... 19................................................................ 19 vii

기본정보.................................................................. 20 라이센스정보 관리자정보.............................................................. 20................................................................ 21 5 시스템환경설정 PORT 설정변경..................................................... 23............................................................. 23 애플리케이션 PORT 변경 Shutdown PORT 변경..................................................... 23...................................................... 23 색인................................................................. 25 viii 목차

그림목차 2 윈도우시스템설치가이드.............................................. 3 그림 2-1 그림 2-2 그림 2-3 도스창호출 JDK 버전확인 JDK 다운로드........................................................ 4...................................................... 5...................................................... 6 그림 2-4 윈도우종류별 JDK 선택............................................... 7 그림 2-5 자바설치마법사 - 1 그림 2-6 자바설치마법사 - 2.................................................. 8.................................................. 8 그림 2-7 그림 2-8 내컴퓨터속성탭열기 컴퓨터기본정보보기................................................ 9................................................ 10 그림 2-9 그림 2-10 시스템속성 환경변수........................................................ 10........................................................ 11 그림 2-11 그림 2-12 새시스템변수 제품구성파일..................................................... 11..................................................... 12 3 리눅스시스템설치가이드.............................................. 13 그림 3-1 제품구성파일...................................................... 16 4 설치마법사......................................................... 19 그림 4-1 최종사용자사용권계약서 (EULA) 확인단계................................ 19 그림 4-2 그림 4-3 기본정보입력단계 라이센스입력단계.................................................. 20................................................... 21 그림 4-4 관리자정보입력단계................................................ 22 ix

표목차 1 시스템요구사항...................................................... 1 표 1-1 지원브라우저........................................................ 1 xi

시스템요구사항 1 3Rabbitz Book은서버에서구동되는웹애플리케이션으로브라우저를통하여개별사용자의컴퓨터를이용하여사용하실수있습니다. 따라서사용자는별도의설치가필요하지않습니다. 다만서버에설치하기위해서는별도의하드웨어및소프트웨어가필요합니다. 시스템요구사항에서는이러한요구사항에대한정보를제공합니다. 또한앞으로언급할모든요구사항은최소요구사항임을인지하시기바랍니다. 소프트웨어요구사항 3Rabbitz Book 을사용하기위하여필요한많은소프트웨어는제품에포함되어있습니다. 다만 라이센스와관련된이슈로포함하지못하는소프트웨어는사용자가설치시에별도로준비하셔야 합니다. 클라이언트소프트웨어 표 1-1 지원브라우저 브라우저 지원버전 마이크로소프트인터넷익스플로러 8.0, 9.0 모질라파이어폭스 4.0 구글크롬 10.0 애플사파리 5.0 웹뷰어의경우추가로마이크로소프트인터넷익스플로러 6.0 이상버전 (6.0, 7.0) 과 오페라소프트웨어오페라브라우저를지원합니다. 1

브라우저지원내역에대한상세한정보를원하시는분은사용자매뉴얼의웹브라우저관련 내용을참고하시기바랍니다. 서버소프트웨어 서버소프트웨어는대부분제품에포함되어있습니다. 라이센스문제로제공해드리지못하는 OS, Java Development Kit (JDK) 의경우사용자가설치하셔야합니다. OS 3Rabbitz Book 은자바가설치되는모든 OS 를지원합니다. 다만설치와관련된가이드는윈도우 시스템설치가이드와리눅스시스템설치가이드에대하여지원합니다. Java Development Kit (JDK) 3Rabbitz Book을사용하기위해서는 Java Development Kit (JDK) 또는 Java Runtime Environment (JRE) 를설치하셔야합니다. 세부설치절차는 OS별설치가이드 ( 윈도우, 리눅스 ) 를참고하시기바랍니다. Java Development Kit (JDK) 지원버전은 1.6 (update 10 or higher) 입니다. 하드웨어 3Rabbitz Book 는최소 2GHz+ CPU or equivalent / 512MB RAM 이상의서버를요구합니다. 하지만동시사용자가증가할경우성능상의저하가있을수있기때문에동시사용자를고려하여 서버용량을증가시키기바랍니다. 2 시스템요구사항

윈도우시스템설치가이드 2 3Rabbitz Book 을윈도우에서설치하기위한절차는다음과같습니다. 1. Java Development Kit (JDK) 또는 Java Runtime Environment (JRE) 를설치합니다. 2. 3Rabbitz Book 애플리케이션파일을다운로드및복사합니다. 3. 3Rabbitz Book 실행합니다. 4. 기본정보및라이센스, 관리자정보입력후설치작업을진행합니다. 5. 설치가완료된애플리케이션을사용합니다. Java 설치 Java Development Kit (JDK) 설치여부확인 현재사용하시려는 Java Development Kit (JDK) 이설치되어있는경우별도의설치절차를진행하실 필요가없습니다. 설치여부확인절차는다음과같습니다. 1. 시작메뉴의실행창에 cmd 를입력하여도스창을호출합니다. 3

그림 2-1 도스창호출 2. 도스창에다음명령어를입력하여설치된 JDK 버전을확인합니다. 명령어가실행되어버전 확인이가능하고 JDK 버전이 Java Development Kit (JDK) 에부합할경우별도의설치를 진행하실필요가없습니다. java -version 4 윈도우시스템설치가이드

그림 2-2 JDK 버전확인 JRE만설치되어있는경우에도위의확인결과와동일하게위와동일한메세지가확인될수있습니다. JDK와 JRE를구분하는방법은설치경로를확인하여폴더를기준으로판단합니다. JRE만설치되어있는경우에는폴더가 bin, lib 2개만존재합니다. 이경우에는다음단계의 JDK 설치를진행해주시기바랍니다. Java Development Kit (JDK) 설치 라이센스문제로 Java Development Kit (JDK) 는제품에포함되지않기때문에설치시 Oracle 자바 사이트에서필요한파일을다운로드받아서진행하시기바랍니다. 설치절차는다음과같습니다. 1. Oracle 자바사이트에서필요한파일을다운로드받습니다. Java 설치 5

그림 2-3 JDK 다운로드 2. 사용하시는윈도우버전에맞는파일을선택하여다운로드받습니다. 32 비트윈도우인경우 Windows x86 를, 64 비트용윈도우를사용하시는경우에는 Windows x64 를선택하시기 바랍니다. 6 윈도우시스템설치가이드

그림 2-4 윈도우종류별 JDK 선택 3. 다운로드받으신파일을실행시켜서자바설치마법사를실행합니다. Java 설치 7

그림 2-5 자바설치마법사 - 1 4. 일반적인환경에서는기본값을설치하시면됩니다. JDK 에대한이해가있으신분들은필요한 경우설정옵션을변경하시기바랍니다. 그림 2-6 자바설치마법사 - 2 8 윈도우시스템설치가이드

JAVA HOME 환경설정 윈도우시스템 [ 내컴퓨터아이콘우클릭 속성선택 고급탭선택 환경변수선택 시스템변수 ] 에 JAVA_HOME 값을설치한 JDK 경로로설정합니다. 상세한작업과정은다음과같습니다. 1. 시작메뉴의컴퓨터아이콘을마우스로우클릭하여 < 속성 > 탭을선택합니다. 그림 2-7 내컴퓨터속성탭열기 2. 컴퓨터기본정보보기화면의좌측메뉴에서 < 고급시스템설정 > 메뉴를클릭합니다. Java 설치 9

그림 2-8 컴퓨터기본정보보기 3. 시스템속성화면의 < 고급 > 탭아래쪽에 < 환경변수 > 버튼을클릭합니다. 그림 2-9 시스템속성 4. 환경변수화면의아래쪽 < 시스템변수 (S)> 탭의 < 새로만들기 > 버튼을클릭합니다. 10 윈도우시스템설치가이드

그림 2-10 환경변수 5. 새시스템변수화면에필요한값을입력하고 < 확인 > 버튼을클릭합니다. 그림 2-11 새시스템변수 변수이름 (N) 대문자로 JAVA_HOME을입력합니다. 변수값 (V) JDK가설치된폴더경로를입력합니다. 일반적으로기본값으로설치한경우 C:\Program Files\Java\jdk1.6.0_25와같은형태입니다. 마지막의 jdk1.6.0_25는설치하신 JDK 버전에따라상이합니다. 1.6버전의 update 25 인경우예시와동일합니다. 정상적으로설치되었는지확인하는방법은현재보시는문서상단의 Java Development Kit (JDK) 설치여부확인을참고하시기바랍니다. Java 설치 11

애플리케이션설치 애플리케이션은다음의절차에따라서설치합니다. 1. 3Rabbitz 다운로드페이지에서윈도우용설치제품을다운로드합니다. 2. 다운로드한파일을압축프로그램 (ZIP 파일지원 ) 을이용하여압축을풉니다. 3. 압축을푼폴더에있는 3rabbitz 폴더를설치하려는폴더로이동시킵니다. 설치하고자하는폴더의상위경로에공백문자가포함된경우비정상적인작동을하기 때문에공백문자는포함되지않아야하며이와더불어 특수문자 (~!@#$%^&*()_+ "<>':`) 도사용하지않으시는것을추천합니다. 그림 2-12 제품구성파일 4. 3rabbitz 폴더하위의 bin 폴더로이동합니다. 5. startup.bat 파일을실행하여애플리케이션을구동합니다. 6. 브라우저를이용하여애플리케이션이설치된서버의 URL( 예시 : http://localhost:1975) 을 입력하여설치마법사를실행시켜서설치를진행합니다. 7. 시스템을종료하고자하실때에는 3rabbitz 폴더하위의 bin 폴더의 shutdown.bat 파일을 실행하시기바랍니다. 설치후설치마법사가정상적으로실행되지않는경우 3rabbits/logs 디렉토리에서로그 파일을확인해주시기바랍니다. 애플리케이션에서사용할 PORT 는기본값이 1975 입니다. 기본값을바꾸기위해서는 PORT 설정변경을참고하시기바랍니다. 12 윈도우시스템설치가이드

리눅스시스템설치가이드 3 3Rabbitz Book 을리눅스에서설치하기위한절차는다음과같습니다. 설치에대한예시는우분투 서버기준으로진행됩니다. 1. Java Development Kit (JDK) 또는 Java Runtime Environment (JRE) 를설치합니다. 2. 3Rabbitz Book 애플리케이션파일다운로드및복사합니다. 3. 3Rabbitz Book 실행합니다. 4. 기본정보및라이센스, 관리자정보입력후설치작업을진행합니다. 5. 설치가완료된애플리케이션을사용합니다. Java 설치 Java Development Kit (JDK) 설치여부확인 현재사용하시려는 Java Development Kit (JDK) 가설치되어있는경우별도의설치절차를진행하실필요가없습니다. 설치여부확인절차는다음과같습니다. 명령어를입력하여설치된 JDK 버전을확인합니다. 명령어가실행되어버전확인이가능하고 JDK 버전이 Java Development Kit (JDK) 에부합할경우별도의설치를진행하실필요가없습니다. java -version 정상설치시메세지 java version "1.6.0_24" Java(TM) SE Runtime Environment (build 1.6.0_24-b07) Java HotSpot(TM) Server VM (build 19.1-b02, mixed mode) 13

JRE만설치되어있는경우에도위의확인결과와동일하게위와동일한메세지가확인될수있습니다. JDK와 JRE를구분하는방법은설치경로를확인하여폴더를기준으로판단합니다. JRE만설치되어있는경우에는폴더가 bin, lib 2개만존재합니다. 이경우에는다음단계의 JDK 설치를진행해주시기바랍니다. Java Development Kit (JDK) 설치 라이센스문제로 Java Development Kit (JDK) 는제품에포함되지않기때문에설치시 Oracle 자바 사이트에서필요한파일을다운로드받아서진행하시기바랍니다. 설치절차는다음과같습니다. 직접다운로드받아서파일을업로드하고설치를진행하셔도되나, 우분투시스템의설치 기능을이용하는것이편리합니다. 1. 우분투서버가이드를참고하여 JDK 를설치하면됩니다. 다음명령어를입력하여설치가능한 JDK 를확인합니다. apt-cache search jdk 이하결과일부... openjdk-6-dbg - Java runtime based on OpenJDK (debugging symbols) openjdk-6-demo - Java runtime based on OpenJDK (demos and examples) openjdk-6-doc - OpenJDK Development Kit (JDK) documentation openjdk-6-jdk - OpenJDK Development Kit (JDK) openjdk-6-jre - OpenJDK Java runtime, using Hotspot JIT openjdk-6-jre-headless - OpenJDK Java runtime, using Hotspot JIT (headless) openjdk-6-jre-lib - OpenJDK Java runtime (architecture independent libraries) openjdk-6-source - OpenJDK Development Kit (JDK) source files openoffice.org-gcj - full-featured office productivity suite -- Java libraries for GIJ openjdk-6-jre-zero - Alternative JVM for OpenJDK, using Zero/Shark sun-java6-bin - Sun Java(TM) Runtime Environment (JRE) 6 (architecture dependent files) sun-java6-demo - Sun Java(TM) Development Kit (JDK) 6 demos and examples sun-java6-doc - Sun JDK(TM) Documention -- integration installer sun-java6-javadb - Java(TM) DB, Sun Microsystems' distribution of Apache Derby 14 리눅스시스템설치가이드

sun-java6-jdk - Sun Java(TM) Development Kit (JDK) 6 sun-java6-jre - Sun Java(TM) Runtime Environment (JRE) 6 (architecture independent files) sun-java6-source - Sun Java(TM) Development Kit (JDK) 6 source files 2. 확인된 JDK 중설치할버전을선택하여설치합니다. 3Rabbitz Book 을이용하기위해서는 JAVA6 JDK 를설치하셔야합니다. 설치를위하여다음명령어를입력합니다. apt-get install sun-java6-jdk 이하설치과정 Do you want to continue [Y/n]? y Get:1 http://my.archive.ubuntu.com hardy/main java-common 0.28ubuntu3 [78.2kB] Get:2 http://my.archive.ubuntu.com hardy/multiverse sun-java6-jre 6-06-0ubuntu1 [6334kB] Get:3 http://my.archive.ubuntu.com hardy/main odbcinst1debian1 2.2.11-16build1 [66.2kB] Get:4 http://my.archive.ubuntu.com hardy/main unixodbc 2.2.11-16build1 [289kB] Get:5 http://my.archive.ubuntu.com hardy/multiverse sun-java6-bin 6-06-0ubuntu1 [27.3MB] Get:6 http://my.archive.ubuntu.com hardy/multiverse sun-java6-jdk 6-06-0ubuntu1 [9625kB] 85% [6 sun-java6-jdk 3208002/9625kB 33%] 정상적으로설치되었는지확인하는방법은현재보시는문서상단의 Java Development Kit (JDK) 설치여부확인을참고하시기바랍니다. 애플리케이션설치 애플리케이션은다음의절차에따라서설치합니다. 1. 3Rabbitz 다운로드페이지에서리눅스용설치제품을다운로드합니다. 2. 다운로드한파일을 FTP 를이용하여서버의설치할디렉토리로업로드합니다. 애플리케이션설치 15

설치하시려는서버가인터넷이연결된환경이라면다음명령어로간단히다운로드및 서버로업로드절차를수행하실수있습니다. 업로드되는디렉토리는명령어를입력하신 위치입니다. wget http://www.3rabbitz.com/r/home/download/linux --content-disposition 설치하고자하는폴더의상위경로에공백문자가포함된경우비정상적인작동을하기 때문에공백문자는포함되지않아야하며이와더불어 특수문자 (~!@#$%^&*()_+ "<>':`) 도사용하지않으시는것을추천합니다. 3. tar 명령어를이용하여압축파일을풉니다. tar -xvf 3rabbitz-book-1.0.0.tar.gz 그림 3-1 제품구성파일 4. 3rabbitz 폴더하위의 bin 폴더로이동합니다. 5. startup.sh 파일을실행하여애플리케이션을구동합니다. 6. 브라우저를이용하여애플리케이션이설치된서버의 URL( 예시 : http://server_domain:1975) 을입력하여설치마법사를실행시켜서설치를진행합니다. 7. 시스템을종료하고자하실때에는 3rabbitz 폴더하위의 bin 디렉토리의 shutdown.sh 파일을 실행하시기바랍니다. 16 리눅스시스템설치가이드

설치후설치마법사가정상적으로실행되지않는경우 3rabbits/logs 디렉토리에서로그 파일을확인해주시기바랍니다. 애플리케이션에서사용할 PORT 는기본값이 1975 입니다. 기본값을바꾸기위해서는 PORT 설정변경을참고하시기바랍니다. 애플리케이션설치 17

설치마법사 4 데이터경로, 라이센스정보, 관리자정보등설치과정의필수적인정보를입력하여애플리케이션이 구동될수있는기본데이터를생성하는작업을도와주는기능입니다. EULA 정보 설치전에최종사용자사용권계약서 (EULA) 내용을확인하시기바랍니다. 그림 4-1 최종사용자사용권계약서 (EULA) 확인단계 19

기본정보 애플리케이션에접속할기본 URL, 데이터 ( 데이터베이스, 폰트, 이미지, PDF, EPUB 파일 ) 및백업을위하여사용하는경로등을입력하는과정입니다. 데이터경로및백업경로의기본값은설치한경로의 data 디렉토리를이용하도록되어있습니다. 다른접근가능한디렉토리를사용하고자할경우에는사용자정의에입력해주십시요. 그림 4-2 기본정보입력단계 여건이된다면백업경로는안정성을위하여데이터경로와다른드라이버에있는 디렉토리를선택하기를추천합니다. 애플리케이션이사용하는 3rabbitz 아래의디렉토리 (bin, logs, tomcat, web) 는사용하실 수없으며, 애플리케이션을실행한계정이읽기와쓰기권한을가진디렉토리만설정 가능합니다. 라이센스정보 3Rabbitz Book 을사용하기위해서는라이센스키가필요합니다. 라이센스를발급받아서입력하는 절차는다음과같습니다. 20 설치마법사

그림 4-3 라이센스입력단계 1. 설치화면에서확인가능한서버아이디를복사합니다. 2. 3Rabbitz 홈페이지를방문해주십시요. 3. 회원가입을아직안하신경우회원가입을진행해주십시요. 4. 계정으로로그인하신후내계정에서기존의라이센스정보확인및신규라이센스발급이 가능합니다. 5. 복사하신서버아이디를이용하여라이센스를발급해주십시요. 6. 발급된라이센스텍스트를설치화면에입력하고다음단계를진행해주십시요. 3Rabbitz Book 을사용하기위해서는라이센스가꼭필요합니다. 30 일평가판을이용하기 위해서도홈페이지를방문해라이센스를발급받으시기바랍니다. 사용중인라이센스는 추후별도의구매절차를통하여변경가능합니다. 관리자정보 관리자정보를입력하고애플리케이션설치를시작한다. 관리자정보 21

그림 4-4 관리자정보입력단계 22 설치마법사

시스템환경설정 5 PORT 설정변경 애플리케이션 PORT 변경 애플리케이션에서사용할 PORT 는기본값이 1975 입니다. 기본값을바꾸기위해서는 [ 3rabbitz tomcat conf server.xml ] 파일의 1975 부분을원하는 PORT 값 ( 예시 : 80) 으로변경하시기 바랍니다. <Server port="5791" shutdown="shutdown"> <Service name="catalina"> - 일부생략 - <Connector port="1975( 수정대상 )" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" URIEncoding="UTF-8" /> - 일부생략 - </Service> </Server> Shutdown PORT 변경 애플리케이션 Shutdown 시사용할 PORT 는기본값이 5791 입니다. 기본값을바꾸기위해서는 [ 3rabbitz tomcat conf server.xml ] 파일의 5791 부분을원하는 PORT 값 ( 예시 : 6791) 으로 변경하시기바랍니다. 23

<Server port="5791( 수정대상 )" shutdown="shutdown"> <Service name="catalina"> - 일부생략 - <Connector port="1975" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" URIEncoding="UTF-8" /> - 일부생략 - </Service> </Server> shutdown PORT 는 5791 PORT 를기존에사용하고계시지않으시다면별도로변경할 필요가없습니다. 24 시스템환경설정

색인 J Java 설치리눅스, 13 윈도우, 3 P PORT 설정애플리케이션, 23 애플리케이션 PORT, 23 ㅅ 서버소프트웨어, 2 소프트웨어요구사항, 1 시스템요구사항, 1 ㅇ 애플리케이션설치리눅스, 15 윈도우, 12 ㅋ 클라이언트소프트웨어, 1t ㅎ 하드웨어, 2 25