Transcription

1 쓰리래빗츠 3.0 관리자가이드

2

3 3.0 쓰리래빗츠 3.0 관리자가이드 ( 주 ) 쓰리래빗츠

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

5 차례 차례 v 그림차례 xi 표차례 머리말 xiii xv 부 I. 기본 UI UI 기본설정 관리자모드로메뉴를바꾸기 웹브라우저제목바꾸기 기본 URL 바꾸기 첫번째페이지바꾸기 1.5 로고와패비콘바꾸기 1.6 날짜와시간형식바꾸기 예외화면에서시스템정보숨기기 메뉴및공통기능 메뉴 BOOK 메뉴 관리메뉴 공통기능 대시보드 문서만들기 프로젝트만들기 v

6 vi 차례 3.3 파일내보내기 문서검색 라벨로여러문서묶기 즐겨찾기 최근에연문서 지켜보기 로그인화면 CSS 설정 5. 라벨과메시지바꾸기 5.1 메시지덮어쓰기 키확인하기 배너넣기 부 II. 사용자관리 로그인 로그인유지 7.2 비밀번호찾기 모든관리자가비밀번호를잃어버린경우 로그인화면에알림메시지넣기 내프로파일 내프로파일바꾸기 8.2 내비밀번호바꾸기 사용자관리 사용자만들기 9.2 사용자삭제 9.3 비밀번호변경 그룹관리 그룹만들기 그룹에사용자추가 그룹삭제 LDAP 으로로그인하기 LDAP 설정

7 vii 11.2 LDAP 로그인정책 OAuth 2.0 으로사용자관리하기 들어가며 OAuth 2.0 이란? 쓰리래빗츠 OAuth URL 설정 인증서버구현하기 OAuth 서버 URL 구현 OAuth 서버토큰 URL 구현 OAuth 서버사용자프로파일 URL 구현 JSP 구현예제 OAuthQueue.java oauth.jsp oauth_token.jsp oauth_user_profile.jsp OAuth 적용에따라알아야하는사항 부 III. 서버관리 쓰리래빗츠시작과정지 쓰리래빗츠시작 윈도우 리눅스와유닉스와맥 OS 쓰리래빗츠정지 윈도우 리눅스와유닉스와맥 OS 소프트웨어업데이트 소프트웨어업데이트준비 쓰리래빗츠를설치한서버에서인터넷연결이가능할때 쓰리래빗츠를설치한서버에서인터넷연결이불가능할때 쓰리래빗츠재시작 윈도우 리눅스와맥 OS 라이선스키버전이맞지않을때

8 viii 차례 15. 자바힙메모리바꾸기 15.1 자바힙메모리확인 윈도우에서자바힙메모리바꾸기 윈도우서비스에등록했을때 윈도우서비스에등록하지않았을때 리눅스와유닉스와맥 OS 에서자바힙메모리설정바꾸기 포트번호바꾸기 서비스포트번호변경 16.2 정지포트번호변경 메일설정하기 메일과관련한이벤트 메일서버설정 테스트메일보내기 구글, 네이버, 다음계정으로메일서버설정하기 발송한메일목록확인 로그파일 로그파일위치 로그파일내려받기 로그파일삭제 18.4 로그파일압축 18.5 로그수준바꾸기 라이선스관리 서버아이디란? 라이선스키를추가하거나바꾸기 라이선스키발급하기 평가판과 Personal 라이선스 정식라이선스 오픈소스와비영리기관라이선스 백업과복원 20.1 백업 복원

9 ix 21. 서버옮기기 운영체제가같을때 21.2 운영체제가다를때 데이터와백업디렉터리위치바꾸기 전체문서목록보기 윈도우 윈도우서비스에등록했을때 윈도우서비스에등록하지않았을때 리눅스 일본어사용하기 윈도우 23.2 리눅스 시작스크립트옵션설정 윈도우 윈도우서비스에등록했을때 윈도우서비스에등록하지않았을때 리눅스 찾아보기

10

11 그림차례 3. 대시보드 그림 3-1 라벨로여러문서묶기 그림 3-2 그림 3-3 그림 3-4 문서즐겨찾기 장즐겨찾기 최근에연문서 그림 3-5 문서에대한지켜보기설정 그룹관리 그림 10-1 접근권한변경 소프트웨어업데이트 그림 14-1 그림 14-2 소프트웨어업데이트내려받기 소프트웨어업데이트준비완료 그림 14-3 설치파일올리기 로그파일 그림 18-1 로그수준변경 xi

12

13 표차례 머리말 xv 주요서식 xvii 9. 사용자관리 표 9-1 사용자권한 메일설정하기 표 17-1 메일서버입력필드 xiii

14

15 머리말 이책의내용 이관리자가이드는쓰리래빗츠의사용방법을각부로나누어설명합니다. 사용자는자신에게필 요한부분을독립적으로찾아볼수있습니다. 쓰리래빗츠를설치하는방법은쓰리래빗츠설치가이드를, 쓰리래빗츠북을사용하는 방법은쓰리래빗츠북사용자가이드를, 쓰리래빗츠비주얼을사용하는방법은쓰리래 빗츠비주얼사용자가이드를참고합니다. 이책의구성은다음과같습니다. 1 부. 기본 UI 쓰리래빗츠기본 UI 를다룹니다. 1. UI 기본설정 : UI 기본설정방법을설명합니다. 2. 메뉴및공통기능 : 메뉴구조와공통기능을설명합니다. 3. 대시보드 : 대시보드를구성하는여러요소를설명합니다. 4. 로그인화면 CSS 설정 : 로그인화면을 CSS로꾸미는방법을설명합니다. 5. 라벨과메시지바꾸기 : 메시지를덮어쓰는방법을설명합니다. xv

16 xvi 머리말 6. 배너넣기 : 웹뷰어와로그인화면에알림메시지를넣는방법을설명합니다. 2 부. 사용자관리 사용자, 그룹, 로그인등을다룹니다. 7. 로그인 : 로그인과관련한내용을설명합니다. 8. 내프로파일 : 내프로파일과비밀번호를바꾸는방법을설명합니다. 9. 사용자관리 : 사용자를만들고, 권한을설정하는방법을설명합니다. 10. 그룹관리 : 그룹을만들고, 사용자를할당하는방법을설명합니다. 11. LDAP으로로그인하기 : LDAP으로로그인하는방법을설명합니다. 12. OAuth 2.0으로사용자관리하기 : OAuth 2.0으로로그인하는방법을설명합니다. 3 부. 서버관리 쓰리래빗츠서버관리를다룹니다. 13. 쓰리래빗츠시작과정지 : 쓰리래빗츠를시작하고정지하는방법을설명합니다. 14. 소프트웨어업데이트 : 소프트웨어를업데이트하는방법을설명합니다. 15. 자바힙메모리바꾸기 : 자바힙메모리를바꾸는방법을설명합니다. 16. 포트번호바꾸기 : 포트번호를바꾸는방법을설명합니다. 17. 메일설정하기 : 메일서버를설정하는방법을설명합니다. 18. 로그파일 : 로그파일과관련한내용을설명합니다. 19. 라이선스관리 : 라이선스를관리하는방법을설명합니다. 20. 백업과복원 : 백업과복원방법을설명합니다. 21. 서버옮기기 : 쓰리래빗츠를설치한서버를옮기는방법을설명합니다. 22. 전체문서목록보기 : 전체문서목록을확인하는방법을설명합니다. 23. 일본어사용하기 : 일본어를사용하는방법을설명합니다.

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

18 xviii 머리말 이메일 : support@3rabbitz.com

19 부 I. 기본 UI 1

20

21 1. UI 기본설정 1.1 관리자모드로메뉴를바꾸기 관리 권한이있으면관리자모드로메뉴를바꿀수있습니다. 1.2 웹브라우저제목바꾸기 다음순서로웹브라우저제목을바꿉니다. 1. < 관리 환경설정 일반설정 > 메뉴로이동합니다. 2. < 일반설정변경 > 링크를클릭합니다. 3. 기본정보 패널에서 제목 을입력합니다. 3

22 4 UI 기본설정 4. < 저장 > 버튼을클릭합니다. 바꾼제목을확인하려면웹브라우저를새로고침합니다. 1.3 기본 URL 바꾸기 PDF 와 epub 파일과이메일에들어가는링크주소에기본 URL 을사용합니다. 다음순서로설치 할때입력한기본 URL 을바꿉니다. 1. < 관리 환경설정 일반설정 > 메뉴로이동합니다. 2. < 일반설정변경 > 링크를클릭합니다. 3. 기본정보 패널에서 기본 URL 을입력합니다. 4. < 저장 > 버튼을클릭합니다. IP 주소가아닌도메인주소로입력합니다. 도메인주소를바꿀때기본 URL 도바꿔야 합니다. 1.4 첫번째페이지바꾸기 첫번째페이지는사용자가웹브라우저주소창에기본도메인주소만입력했을때나타나는주소 입니다. 기본값은로그인화면 ( 로그인했다면대시보드가나타납니다.) 입니다. 다음순서로첫번째 페이지를바꿉니다. 1. < 관리 환경설정 일반설정 > 메뉴로이동합니다. 2. < 일반설정변경 > 링크를클릭합니다.

23 로고와패비콘바꾸기 5 3. 기본정보 패널에서 첫번째페이지 를입력합니다. 4. < 저장 > 버튼을클릭합니다. 첫번째페이지로공개한웹뷰어또는웹페이지주소를선택했을때로그인하려면다 음주소를입력합니다. 다양하게첫번째페이지를설정할수있습니다. 쓰리래빗츠내부공개주소 /book_release_note_ko와같은문서와웹페이지공개주소를입력합니다. 빗금으로시작하지않으면앞에빗금이자동으로붙습니다. 외부주소 http 또는 https로시작하는외부주소를입력합니다. 웹브라우저언어로분기웹브라우저언어에따라첫번째페이지를다르게설정할수있습니다. 다음과같이설정합니다. ko:/book_release_note_ko;en:/book_release_note_en 1.5 로고와패비콘바꾸기 다음순서로로고와패비콘을바꿉니다. 1. < 관리 환경설정 일반설정 > 메뉴로이동합니다. 2. < 일반설정변경 > 링크를클릭합니다. 3. 로고 패널에서 로고 ( 로그인화면과웹뷰어에서사용 ), 2 헤더로고, 3 패비콘 을설정합니다.

24 6 UI 기본설정 4. < 저장 > 버튼을클릭합니다. 1.6 날짜와시간형식바꾸기 다음순서로날짜와시간형식을바꿉니다. 1. < 관리 환경설정 일반설정 > 메뉴로이동합니다. 2. < 일반설정변경 > 링크를클릭합니다. 3. 형식 패널에서 날짜 / 시 / 분형식 과 날짜 / 시 / 분 / 초형식 을선택합니다. 4. < 저장 > 버튼을클릭합니다. 1.7 예외화면에서시스템정보숨기기 예외화면에예외트레이스가나타납니다. 보안규정에어긋난다면다음순서로예외트레이스를 숨깁니다.

25 예외화면에서시스템정보숨기기 7 1. < 관리 환경설정 일반설정 > 메뉴로이동합니다. 2. < 일반설정변경 > 링크를클릭합니다. 3. 옵션 패널에서 예외트레이스를숨깁니다 를선택합니다. 4. < 저장 > 버튼을클릭합니다. 로그파일에도예외트레이스를기록합니다.

26

27 2. 메뉴및공통기능 2.1 메뉴 공통기능 메뉴 9

28 10 메뉴및공통기능 쓰리래빗츠북메뉴는 BOOK 과관리로나뉩니다. 1 로전체메뉴를바꿀수있습니다. 관리 권한이있는사용자만이전체메뉴를바꿀수있습니다 BOOK 메뉴 BOOK 메뉴에는대시보드, 서식, 도구가있습니다. 대시보드대시보드에서문서를만들고관리합니다. 프로젝트를만들어여러문서를묶을수있습니다. 서식서식메뉴에는테마, 웹뷰어레이아웃, PDF 페이지레이아웃, PDF 글꼴, 하이픈패턴등이있습니다. 이메뉴는 서식만들기 권한이있는사용자에게만보입니다. 도구도구메뉴에는내보내기, 가져오기, 웹페이지, 용어집, 문구, 댓글, 피드백통계등이있습니다. 웹페이지와문구와용어집메뉴는 서식만들기 권한이있는사용자에게만보입니다 관리메뉴 관리메뉴에는사용자관리, 환경설정, 서버관리, 소프트웨어업데이트, About 등이있습니다.

29 공통기능 11 사용자관리사용자관리메뉴에는사용자관리, 그룹관리등이있습니다. 환경설정환경설정메뉴에는일반설정, 메일서버, 라이선스, API 등이있습니다. 서버관리서버관리메뉴에는서버속성, JMX, 메일, 백업, 로그등이있습니다. 소프트웨어업데이트새로운버전으로쓰리래빗츠를업데이트할수있습니다. About 쓰리래빗츠와관련한기본정보를제공합니다. 2.2 공통기능 화면오른쪽위에있는공통기능을설명합니다.

30 12 메뉴및공통기능 1 홈 : 첫번째메뉴로이동합니다. 2 알림 : 지켜보고있는문서변경, 댓글, 피드백등과관련한이벤트를알려줍니다. 3 즐겨찾기 : 즐겨찾기한문서를보여줍니다. 4 최근에연문서 : 최근에연문서를보여줍니다. 5 메뉴바꾸기 : 관리 권한이있는사용자만이전체메뉴를바꿀수있습니다. 6 내프로파일 : 이름, 이메일, 언어, 시간대, 비밀번호등을바꿀수있습니다. 사용자아이디는 변경할수없습니다.

31 공통기능 13 7 도움말 : 쓰리래빗츠홈페이지에있는도움말이열립니다. 8 로그아웃

32

33 3. 대시보드 문서가많아지면문서를찾기어려워집니다. 쓰리래빗츠북은문서관리에도움이되는다양한기 능을제공합니다. 15

34 16 대시보드 3.1 문서만들기 자세한설명은문서구성하기를참고합니다. 3.2 프로젝트만들기 프로젝트를만들어문서를관리합니다.

35 프로젝트만들기 17 1 대시보드를프로젝트목록으로구성합니다. 2 대시보드를문서목록으로구성합니다. 3 끌어다넣기로프로젝트위치를변경합니다. 4 프로젝트정보변경, 삭제, 구성원변경, 문서추가등의작업을합니다. 문서접근권한으로 프로젝트모든구성원 을설정할수있습니다.

36 18 대시보드 3.3 파일내보내기 자세한사항은한번에여러문서에대해서파일만들기를참고합니다. 3.4 문서검색 문서목록에서다음항목을검색할수있습니다. 제목 부제목 에디션 저자 영문은대소문자를구별합니다. < 1 내용검색 > 옵션을선택하면내용에서검색합니다.

37 라벨로여러문서묶기 19 내용검색을위한색인작업은 10 분마다이루어집니다. 그래서최근에작성한내용은 검색결과에나타나지않을수있습니다. 3.5 라벨로여러문서묶기 그림 3-1 라벨로여러문서묶기 라벨로여러문서를하나의그룹으로묶거나특정문서를쉽게찾아볼수있도록설정할수있습니 다. 다음순서로라벨을사용합니다. 1. 문서를만들거나변경할때라벨정보를입력합니다. 쉼표, 쌍반점, 띄어쓰기등으로구분하여 2 개이상의라벨을설정할수있습니다. 2. 문서목록위에라벨목록이표시됩니다. 3. 특정라벨을클릭하면해당라벨이설정된문서만이목록에나타납니다.

38 20 대시보드 3.6 즐겨찾기 문서나장을즐겨찾기할수있습니다. 그림 3-2 문서즐겨찾기 그림 3-3 장즐겨찾기

39 즐겨찾기 21 1 문서를즐겨찾기합니다. 2 장을즐겨찾기합니다. 화면오른쪽위에있는공통기능에서즐겨찾기를한문서와장을확인할수있습니다. 3 아이콘을클릭하면즐겨찾기목록이나타납니다. 4 문서제목을클릭하면문서상세화면으로이동합니다. 5 장제목을클릭하면해당장을편집할수있는에디터가열립니다. 6 즐겨찾기아이콘 ( ) 을클릭하면즐겨찾기가해제됩니다.

40 22 대시보드 3.7 최근에연문서 대시보드에서최근에연문서목록을확인할수있습니다. 그림 3-4 최근에연문서 1 아이콘을클릭하면최근에연문서목록이나타납니다. 2 문서제목을클릭하면문서상세화면으로이동합니다. 3 장제목을클릭하면에디터가열립니다. 3.8 지켜보기 지켜보기는문서가변경되었을때이를확인할수있게해주거나메일로알림을제공하는기능입 니다.

41 지켜보기 23 해당문서를지켜보는사용자에게한시간동안의변경내용을모아서메일로발송합니 다. 다만이를위해서는이메일을설정해야합니다. 자세한사항은내부링크가잘못되 었습니다. 를참고합니다. 그림 3-5 문서에대한지켜보기설정 문서제목오른쪽에있는 1 아이콘 ( ) 을클릭하여문서를지켜보기합니다. 지켜보는문서의내용변경과댓글및피드백의생성, 변경, 삭제등을알림으로제공합 니다.

42

43 4. 로그인화면 CSS 설정 웹페이지를이용해서로그인화면에 CSS 를설정할수있습니다. 쓰리래빗츠북을설치했을때만사용할수있습니다. 1. < 도구 웹페이지 > 메뉴에서새로운웹페이지를만듭니다. 유형으로 1 로그인 CSS 를선택 합니다. 로그인 CSS 웹페이지는하나만만들수있습니다. 2. 상세화면에서 < 2 편집 > 링크를클릭한후 CSS 를설정합니다. 25

44 26 로그인화면 CSS 설정 예를들어배경그림을넣으려면다음과같이 CSS 를입력합니다. body { } background: rgb(250, 250, 250) url(/r/image/get/d71a65386e9d6801) no-repeat; url 에들어갈이미지는외부경로를사용하거나, 에디터오른쪽위에있는 < 그림넣기 > 로추가할 수있습니다.

45 5. 라벨과메시지바꾸기 5.1 메시지덮어쓰기 < 서버관리 메시지덮어쓰기 > 메뉴에서라벨과메시지를바꿀수있습니다. 1. < 서버관리 1 메시지덮어쓰기 > 메뉴로이동합니다. 2. < 2 추가 > 링크를클릭합니다. 3. 덮어쓸메시지를입력합니다. 키를확인하는방법은 5.2 키확인하기를참고합니다. 27

46 28 라벨과메시지바꾸기 5.2 키확인하기 바꿔야하는라벨과메시지키를확인하는방법입니다. 1. 오른쪽위에서 1 내프로파일을선택합니다. 2. < 내프로파일변경 > 링크를클릭한후, 언어를 키 로바꿉니다. 이렇게하면다음과같이바꿀 라벨과메시지키를확인할수있습니다.

47 6. 배너넣기 다음순서로웹뷰어와로그인화면에알림메시지를넣습니다. 1. < 도구 배너 > 메뉴로이동합니다. 2. < 배너만들기 > 링크를클릭합니다. 3. 기본정보를입력한후 < 저장 > 버튼을클릭합니다. 유형에따라웹뷰어또는로그인화면에배너가나타납니다. 내용에 html 코드를직접넣을수있습니다. 웹뷰어의배너모습입니다. 로그인화면의배너모습입니다. 29

48 30 배너넣기

49 부 II. 사용자관리 31

50

51 7. 로그인 7.1 로그인유지 7.2 비밀번호찾기 모든관리자가비밀번호를잃어버린경우 로그인화면에알림메시지넣기 로그인유지 로그인할때 < 1 로그인유지 > 버튼을사용하면다음에는자동로그인합니다. 33

52 34 로그인 7.2 비밀번호찾기 메일서버를설정하면 < 1 비밀번호를잊으셨나요?> 링크가나타납니다.

53 비밀번호찾기 35 메일서버는 < 관리 환경설정 메일서버 > 메뉴에서설정합니다. 자세한설명은 17.2 메일서버설정을참고합니다. 비밀번호가기억나지않을때, 다음상황에서는쓰리래빗츠관리자에게도움을요청합니다. < 비밀번호를잊으셨나요?> 링크가나타나지않았을때 ( 메일서버를설정하지않음 ) 비밀번호를초기화해도메일이오지않을때 ( 메일서버를잘못설정 )

54 36 로그인 7.3 모든관리자가비밀번호를잃어버린경우 관리 권한을지닌모든사용자들이비밀번호를기억하지못하고메일서버를설정하지않아 비 밀번호찾기 기능이비활성화되어있는경우에도, 특정사용자의비밀번호를임시로변경할수 있습니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 1. 3RABBITZ_HOME/web/WEB-INF/web.xml 파일을엽니다. 2. 주석을제거하고, userid 대신에비밀번호를변경할사용자아이디를, password 대신에새로 운비밀번호를입력합니다. <!-- 이줄제거 <context-param> <param-name>change_password</param-name> <param-value>userid/password</param-value> </context-param> --> 이줄제거 3. 쓰리래빗츠를재시작합니다. 4. 새로설정한비밀번호로로그인한후에 < 내프로파일 > 메뉴에서비밀번호를변경합니다. 5. 3RABBITZ_HOME/web/WEB-INF/web.xml 파일을원상태로되돌립니다. 6. 쓰리래빗츠를재시작합니다. 3RABBITZ_HOME/web/WEB-INF/web.xml 파일을원상태로되돌리지않으면서버를재시 작할때마다설정내용대로비밀번호를바꿉니다.

55 7.4 로그인화면에알림메시지넣기 로그인화면에알림메시지넣기 37 자세한사항은 6. 배너넣기를참고합니다.

56

57 8. 내프로파일 8.1 내프로파일바꾸기 8.2 내비밀번호바꾸기 내프로파일바꾸기 1. < 1 설정 > 메뉴에서 < 2 내프로파일 > 메뉴를선택합니다. 2. < 내프로파일변경 > 링크를클릭합니다. 39

58 40 내프로파일 3. 내프로파일내용을바꾼후, < 내프로파일변경 > 버튼을클릭합니다. 사용자아이디 는바꿀수없습니다. 8.2 내비밀번호바꾸기 1. < 1 설정 > 메뉴에서 < 2 내프로파일 > 메뉴를선택합니다. 2. < 비밀번호변경 > 링크를클릭합니다. 3. 비밀번호를바꾼후, < 비밀번호변경 > 버튼을클릭합니다.

59 9. 사용자관리 9.1 사용자만들기 9.2 사용자삭제 9.3 비밀번호변경 사용자만들기 만들수있는사용자최대숫자는라이선스종류에따라다릅니다. 다음순서로사용자를만듭니다. 1. < 사용자만들기 > 링크를클릭합니다. 2. 입력화면에서기본정보, 비밀번호, 권한, 그룹등을입력한후 < 저장 > 버튼을클릭합니다. 다음을주의합니다. 사용자아이디에는영어알파벳과숫자만을사용할수있습니다. 사용자를만든이후에는사용자아이디를변경할수없습니다. 다음은권한에대한설명입니다. 41

60 42 사용자관리 표 9-1 사용자권한 권한 설명 공통 관리 < 관리 > 메뉴에서사용자, 환경설정등을설정할수있습니다. 북 서식만들기 < 서식 > 메뉴에서테마와레이아웃등을설정할수있습니다. 글쓰기 < 대시보드 > 메뉴에서문서를만들고내용을작성할수있습니다. 글읽기 < 대시보드 > 메뉴에서문서를읽일수있습니다. 글읽기권한만가진사용자는라이선스사용자수를계산할때제외합니다. 비주얼 비주얼 < 대시보드 > 메뉴에서비주얼문서를만들고내용을작성할수있습니다. 9.2 사용자삭제 다음순서로사용자를삭제합니다. 1. 사용자목록에서삭제할 사용자아이디 를클릭합니다. 2. < 사용자삭제 > 링크를클릭합니다. 3. < 삭제 > 버튼을클릭하면사용자가삭제됩니다. 삭제된사용자가소유한책들에대한 소유자 권한이사용자를삭제한사람에게자동 이관됩니다. 자기자신은삭제할수없습니다.

61 비밀번호변경 비밀번호변경 다음순서로사용자비밀번호를변경합니다. 1. 사용자목록에서비밀번호를변경할 사용자아이디 를클릭합니다. 2. < 비밀번호변경 > 링크를클릭합니다. 3. 새로운비밀번호를입력한후에 < 비밀번호변경 > 버튼을클릭합니다. 자기자신의비밀번호는여기서변경할수없습니다. 자신의비밀번호를바꾸는방법은 8.2 내비밀번호바꾸기를참고합니다.

62

63 10. 그룹관리 10.1 그룹만들기 다음순서로그룹을만듭니다. 1. < 관리 사용자관리 그룹관리 > 메뉴로이동합니다. 2. < 그룹만들기 > 링크를클릭합니다. 3. 기본정보 를입력한후 < 저장 > 버튼을클릭합니다. 그룹아이디 에는영어와숫자만을입력할수있습니다. 그룹을만든후에는 그룹아이디 를바꿀수없습니다. 그룹을만들면문서접근권한을변경할때사용자뿐만아니라그룹도선택할수있습니다. 45

64 46 그룹관리 그림 10-1 접근권한변경

65 그룹삭제 그룹에사용자추가 다음순서로그룹에사용자를추가합니다. 1. < 관리 사용자관리 그룹관리 > 메뉴로이동합니다. 2. 사용자를추가할그룹의 < 구성원변경 > 링크를클릭합니다. 3. 구성원을선택한후 < 저장 > 버튼을클릭합니다 그룹삭제 다음순서로그룹을삭제합니다. 1. < 관리 사용자관리 그룹관리 > 메뉴로이동합니다. 2. 삭제할그룹의 < 삭제 > 링크를클릭합니다.

66

67 11. LDAP 으로로그인하기 LDAP(Lightweight Directory Access Protocol) 을이용한로그인을지원합니다 LDAP 설정 < 관리 환경설정 API> 메뉴에서 LDAP 을설정합니다. 49

68 50 LDAP 으로로그인하기 다음은각입력항목에대한설명입니다. LDAP 호스트 LDAP 서버주소를입력합니다. ldap:// 은생략할수있습니다. SSL을사용할때는 ldaps :// 를앞에붙어야합니다. LDAP 포트번호기본값은 389입니다. LDAP TLS 연결사용 TLS로 LDAP 서버와연결할때선택합니다. LDAP 계정사용자검색을위해 LDAP 서버에연결할때사용하는 LDAP 계정입니다. LDAP 비밀번호사용자검색을위해 LDAP 서버에연결할때사용하는 LDAP 계정비밀번호입니다. LDAP 기본 DN 기본 Distinguished Name LDAP 사용자필터사용자를검색할때사용하는필터입니다. 사용자아이디는 ${uid} 로입력합니다. 기본값은 uid=${uid} 입니다. LDAP 아이디속성아이디속성이름입니다. 기본값은 uid입니다. LDAP 이름속성이름속성이름입니다. 기본값은 displayname입니다. LDAP 아이디속성메일속성이름입니다. 기본값은 mail입니다. LDAP 설정이틀리거나 LDAP 서버와연결할수없을때도쓰리래빗츠비밀번호로로 그인할수있습니다. LDAP 설정과관련한문제는로그파일을확인합니다.

69 LDAP 로그인정책 LDAP 로그인정책 LDAP 으로로그인할때알아야할주의사항입니다. LDAP으로로그인한사용자정보가쓰리래빗츠에없으면자동으로사용자를만듭니다. LDAP 과연동하기전에만든사용자아이디가 LDAP 사용자아이디와같으면해당사용자를그대로사용합니다. LDAP으로처음로그인한사용자에게는글쓰기권한을부여합니다. 사용자수라이선스제한에걸리면글읽기권한을부여합니다. 관리자가 < 사용자관리 > 메뉴에서권한을바꿀수있습니다. LDAP으로로그인한사용자는내프로파일이나비밀번호를변경할수없습니다. LDAP에서사용자이름이나이메일주소가바뀌면로그인할때자동으로사용자정보를변경합니다. 관리자가쓰리래빗츠에서사용자에게비밀번호를부여하면 LDAP 뿐만아니라쓰리래빗츠비밀번호로도로그인할수있습니다.

70

71 12. OAuth 2.0 으로사용자관리하기 12.1 들어가며 대부분의회사나조직은직원과고객데이터베이스를가지고있습니다. 쓰리래빗츠를도입하면 일부데이터베이스를이중으로관리해야하는불편함에직면합니다. 이문제를해결하기위해서 쓰리래빗츠는 OAuth 2.0 으로사용자를관리하는기능을제공합니다 OAuth 2.0 이란? OAuth 2.0 은여러애플리케이션이안전하게인증및권한을제어할수있도록해주는오픈프로 토콜입니다. OAuth 를구성하는주요요소는다음과같습니다. 인증서버 (Authorization Server) 로그인과같은사용자인증을처리하는서버입니다. 직원이나고객데이터베이스에접근할수있는웹사이트에 OAuth에맞춰필요한기능을추가해야합니다. 클라이언트 ( 쓰리래빗츠 ) 인증서버로로그인한후에사용할수있는서비스를말합니다. 쓰리래빗츠가이에해당합니다. 53

72 54 OAuth 2.0 으로사용자관리하기 웹브라우저 웹브라우저리다이렉트로인증서버와쓰리래빗츠를연결합니다. OAuth에서는인증서버와자원서버 (Resource Server) 를분리해서설명합니다. 자원서버는사용자프로파일등을제공하는역활을하는데쓰리래빗츠에 OAuth를적용할때인증서버와자원서버를분리할필요가없기때문에인증과자원제공을모두인증서버에서처리하는것으로가정합니다. 쓰리래빗츠에 OAuth 2.0 을적용하면다음과같이사용자인증을처리합니다. 1 웹브라우저에서쓰리래빗츠를호출합니다. 외부에공개한문서에는바로접근할수있습니다. 2 인증과정을거치지않았다면쓰리래빗츠는인증서버로리다이렉트합니다. 이때쿼리문자 열로다음파라미터를전달합니다. redirect_uri 인증이성공한후웹브라우저리다이렉트로이동할쓰리래빗츠주소 state 중복호출을방지하기위한장치입니다. 인증이성공한후이값을쿼리문자열로다시보냅니다.

73 OAuth 2.0 이란? 55 3 인증서버에서인증에성공하면쓰리래빗츠로부터받은 redirect_uri 으로리다이렉트합니 다. 이때쿼리문자열로 code 와 state 를전달합니다. 보안을위해서미리정해진주소 ( 로리다이렉 트할수도있습니다. 4 쓰리래빗츠는 code 를파라미터로인증서버에토큰을요청합니다.

74 56 OAuth 2.0 으로사용자관리하기 웹브라우저를거치지않고쓰리래빗츠이인증서버를직접호출합니다. 5 인증서버에서받은토큰을파라미터로쓰리래빗츠는인증서버에사용자프로파일정보를 요청합니다. 웹브라우저를거치지않고쓰리래빗츠가인증서버를직접호출합니다. 토큰대신에바로사용자프로파일정보를요청하고받는것이낫아보입니다. 하지만 OAut h 는인증뿐만아니라다양한서비스나자원에접근할수있는프레임워크입니다. 예를들어

75 쓰리래빗츠 OAuth URL 설정 57 주소록이나사진목록과같은것들을요청하는데사용할수있습니다. 따라서토큰을가져오 는것과서비스 ( 사용자프로파일정보 ) 를요청하는것이분리되어있습니다 쓰리래빗츠 OAuth URL 설정 사용자를인증하는인증서버 URL 을쓰리래빗츠에설정합니다. 1 < 관리 환경설정 API> 메뉴로이동합니다. 1 <API 변경 > 링크를클릭합니다. 2 OAuth 서버 URL 을모두입력한후저장합니다.

76 58 OAuth 2.0 으로사용자관리하기 네트워크보안을위해서 HTTPS 를사용하는것을권장합니다 인증서버구현하기 쓰리래빗츠에설정한 OAuth URL 기능을구현합니다. 구현해야하는 URL 은세개입니다. 직원또는고객데이터베이스에접근할수있는기존웹사이트 ( 애플리케이션 ) 에이기 능을추가합니다.

77 인증서버구현하기 59 OAuth 서버 URL 사용자를인증하는 URL입니다. 사용자가로그인하지않았다면로그인페이지로이동시킵니다. 사용자가인증에성공하면웹브라우저리다이렉트로인증코드를쓰리래빗츠로전달합니다. OAuth 서버토큰 URL 인증서버로받은인증코드로쓰리래빗츠가접근토큰을가져오는 URL입니다. 이때는웹브라우저를거치지않고쓰리래빗츠가인증서버를직접호출합니다. OAuth 서버사용자프로파일 URL 인증서버로받은인증토큰으로쓰리래빗츠가사용자정보를가져오는 URL입니다. 이때는웹브라우저를거치지않고쓰리래빗츠가인증서버를직접호출합니다 OAuth 서버 URL 구현 쓰리래빗츠는웹브라우저리다이렉트로다음파라미터와함께인증서버를호출합니다. redirect_uri 인증이성공한후웹브라우저리다이렉트로이동할쓰리래빗츠주소 state 중복호출을방지하기위한장치입니다. 인증이성공한후이값을쿼리문자열로다시보냅니다. 사용자가인정서버로그인에성공하면 redirect_uri 로리다이렉트합니다. 이때다음을쿼리문 자열로함께보내야합니다. code 코드문자열입니다. 특별한포멧은없습니다. state 쓰리래빗츠로부터받은 state 값을그대로전달합니다. 구현할때다음을참고합니다. 보안을위해서미리정해진주소 ( 로리다이렉트할수도

78 60 OAuth 2.0 으로사용자관리하기 있습니다. state 값으로중복호출및코드노출에따른보안문제를방지할수있습니다. OAuth 서버를 구현할때같은 state 값으로들어오는중복요청을걸러내는것을권장합니다 OAuth 서버토큰 URL 구현 쓰리래빗츠는인증서버로다음파라미터를보냅니다. code 앞단계에서받은코드값입니다. 인증서버는 JSON 형식으로결과를반환해야합니다. Content-Type: application/json; charset=utf-8 JSON 형식은다음과같습니다. { "access_token": " 접근토큰 ", "expires_in": 60 } expires_in 은접근토큰유효기간으로초를단위로합니다 OAuth 서버사용자프로파일 URL 구현 쓰리래빗츠는인증서버로다음파라미터를보냅니다. access_token 앞단계에서받은토큰값입니다.

79 인증서버구현하기 61 인증서버는토큰값에맞는사용자정보를쓰리래빗츠로반환해야합니다. 이때지켜야하는형식 은다음과같습니다. Content-Type: application/json; charset=utf-8 다음을반환합니다. { } "id": " 사용자아이디 ", "name": " 사용자이름 ", " ": " 사용자이메일주소 ", "roles": " 사용자권한 ", "groups": " 사용자가속한그룹 " roles 에세미콜론을구분자로여러개를설정할수있습니다. 설정할수있는권한은다음과같습 니다. admin edtior writer reader roles 에세미콜론을구분자로여러개를설정할수있습니다. "roles": "admin;writer" writer 를설정했다면 reader 는설정할필요가없습니다. 쓰리래빗츠에서권한을설정하려면 roles 에 3rabbitz 를입력합니다.

80 62 OAuth 2.0 으로사용자관리하기 "roles": "3rabbitz" groups 에세미콜론을구분자로여러그룹아이디를설정할수있습니다. 그룹아이디에대한설 명은 10. 그룹관리를참고합니다. "groups": "marketing;support" 쓰리래빗츠에서그룹을설정하려면 groups 에 3rabbitz 를입력합니다. "groups": "3rabbitz" 12.5 JSP 구현예제 프로그래밍언어와개발환경에따라서인증서버를구현하는방법이달라집니다. 인증서버를구 현할때참고할수있는자바와 JSP 로구현한예제입니다 OAuthQueue.java 코드와토큰과사용자아이디를연결시켜주는자바클래스입니다. package com.threerabbitz.oauth; import java.util.linkedlist; import java.util.uuid; public class OAuthQueue {

81 JSP 구현예제 63 private static final int MAX_SIZE = 10000; private static OAuthQueue instance = new OAuthQueue(); public static OAuthQueue getinstance() { } return instance; private LinkedList<OAuthInfo> queue = new LinkedList<OAuthInfo>(); public synchronized String getcode(string user) { if (user == null) { throw new IllegalArgumentException("user_cannot_be_null"); } OAuthInfo result = new OAuthInfo(user); queue.add(result); if (queue.size() > MAX_SIZE) { queue.removefirst(); } return result.code; } public synchronized String gettoken(string code) { if (code == null) { throw new IllegalArgumentException("code_cannot_be_null"); } for (int i = queue.size() - 1; i > -1; i--) { OAuthInfo info = queue.get(i); if (info.code.equals(code)) { return info.token; } } return null; }

82 64 OAuth 2.0 으로사용자관리하기 public synchronized String getuser(string token) { if (token == null) { throw new IllegalArgumentException("token_cannot_be_null"); } for (int i = queue.size() - 1; i > -1; i--) { OAuthInfo info = queue.get(i); if (info.token.equals(token)) { return info.user; } } return null; } static private class OAuthInfo { String code = UUID.randomUUID().toString(); String token = UUID.randomUUID().toString(); String user; } OAuthInfo(String user) { } this.user = user; } 8 인증데이터캐싱크기를 10,000개로제한합니다. 12 싱글톤패턴을적용했습니다. 56 코드, 토큰, 사용자아이디를담고있는 OAuthInfo 클래스를선언합니다. 57 java.util.uuid 클래스로코드와토큰값을만듭니다.

83 JSP 구현예제 oauth.jsp 로그인여부를체크하고웹브라우저리다이렉트로쓰리래빗츠에코드를전달하는 JSP 파일입니 다. page contenttype="text/html; charset=utf-8" pageencoding="utf-8" %> page import="com.threerabbitz.base.domain.user" %> page import="com.threerabbitz.oauth.oauthqueue" %> <% String redirecturi = request.getparameter("redirect_uri"); String state = request.getparameter("state"); User user = (User) session.getattribute("user"); if (user!= null) { String code = OAuthQueue.getInstance().getCode(user.getUserid()); response.sendredirect(redirecturi + "?code=" + code + "&state=" + state); } else { String path = "/oauth.jsp?redirect_uri=" + redirecturi + "&state=" + state; session.setattribute("path", path); request.getrequestdispatcher("/login.jsp").forward(request, response); } %> 10 사용자가로그인했는지를체크합니다. 개발환경에맞게고칩니다. 12 code와 state를쿼리문자열에넣어서라다이렉트합니다. 15 로그인이후에이동할페이지를설정합니다. 개발환경에맞게고칩니다. 16 로그인페이지로이동합니다. 개발환경에맞게고칩니다.

84 66 OAuth 2.0 으로사용자관리하기 oauth_token.jsp 코드 (code) 를받아토큰을반환하는 JSP 파일입니다. page contenttype="application/json; charset=utf-8" pageencoding="utf-8" %> page import="com.threerabbitz.oauth.oauthqueue" %> <% String code = request.getparameter("code"); String token = OAuthQueue.getInstance().getToken(code); if (token!= null) { out.print("{"); out.print("\"access_token\": \"" + token + "\","); out.print("\"expires_in\": 60"); out.print("}"); } %> 1 Content-Type 은 application/json; charset=utf-8 입니다. 11 expires_in 속성으로유효기간을설정합니다. 단위는초입니다 oauth_user_profile.jsp 토큰 (access_token) 을받아사용자정보를반환하는 JSP 파일입니다. <%@ page contenttype="application/json; charset=utf-8" pageencoding="utf-8" %> <%@ page import="com.threerabbitz.base.domain.user" %> <%@ page import="com.threerabbitz.base.domain.users" %> <%@ page import="com.threerabbitz.oauth.oauthqueue" %>

85 OAuth 적용에따라알아야하는사항 67 <% String token = request.getparameter("access_token"); User user = Users.find(OAuthQueue.getInstance().getUser(token)); if (user!= null) { out.print("{"); out.print("\"id\": \"" + user.getuserid() + "\","); out.print("\"name\": \"" + user.getname() + "\","); out.print("\" \": \"" + user.get () + "\","); out.print("\"roles\": \"3rabbitz\","); out.print("\"groups\": \"3rabbitz\""); out.print("}"); } %> 1 Content-Type 은 application/json; charset=utf-8 입니다. 9 사용자아이디로사용자정보를찾습니다. 실제환경에맞게고칩니다 OAuth 적용에따라알아야하는사항 쓰리래빗츠에서만든사용자는 OAuth이아닌 OAuth로처음로그인할때쓰리래빗츠에자동으로사용자가만들어집니다. 라이선스를초과하면글읽기권한만있는사용자로만들어집니다. OAuth로로그인한사용자는내프로파일정보를바꿀수없습니다.

86

87 부 III. 서버관리 69

88

89 13. 쓰리래빗츠시작과정지 13.1 쓰리래빗츠시작 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리 ( 윈도우에서는폴더 ) 를지칭합니다 윈도우 윈도우에서는다음순서로쓰리래빗츠를시작합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. startup.bat 파일을실행합니다. 윈도우서비스에등록했다면윈도우서비스에서시작합니다. 71

90 72 쓰리래빗츠시작과정지 리눅스와유닉스와맥 OS 리눅스와유닉스와맥 OS 에서는다음순서로쓰리래빗츠를시작합니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. 다음명령어를실행합니다../startup.sh 재시작할때는쓰리래빗츠가완전하게정지된후 1 쓰리래빗츠를시작합니다 쓰리래빗츠정지 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리 ( 윈도우에서는폴더 ) 를지칭합니다 윈도우 윈도우에서는다음순서로쓰리래빗츠를정지합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. shutdown.bat 파일을실행합니다. 1. ps -ef grep 3rabbitz 명령어로정지여부를확인합니다.

91 쓰리래빗츠정지 73 윈도우서비스에등록했다면윈도우서비스에서정지합니다 리눅스와유닉스와맥 OS 리눅스와유닉스와맥 OS 에서는다음순서로쓰리래빗츠를정지합니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. 다음명령어를실행합니다../shutdown.sh

92

93 14. 소프트웨어업데이트 14.1 소프트웨어업데이트준비 쓰리래빗츠재시작 라이선스키버전이맞지않을때 < 소프트웨어업데이트 > 메뉴에서새로운버전으로쓰리래빗츠를업데이트합니다 소프트웨어업데이트준비 쓰리래빗츠를설치한서버에서인터넷연결이 가능할때 다음순서로소프트웨어업데이트가가능한지확인하고필요한설치파일을다운로드합니다. 소프트웨어업데이트를확인하고다운로드할때쓰리래빗츠업데이트서버로서버아 이디와현재설치한제품의버전정보를전송합니다. 1. < 소프트웨어업데이트 > 메뉴를클릭합니다. 75

94 76 소프트웨어업데이트 2. < 업데이트확인 > 링크를클릭합니다. 3. 업데이트가가능하면 1 새로운버전정보와 < 2 업데이트내려받기 > 링크가나타납니다. 그림 14-1 소프트웨어업데이트내려받기 < 릴리스노트보기 > 링크를클릭하여변경내역을확인합니다. 4. < 업데이트내려받기 > 링크를클릭하면업데이트에필요한파일을다운로드합니다. 그림 14-2 소프트웨어업데이트준비완료 설치파일다운로드이후에업데이트를하지않으려면 < 취소 > 링크를클릭합니다.

95 쓰리래빗츠재시작 쓰리래빗츠를설치한서버에서인터넷연결이 불가능할때 쓰리래빗츠를설치한서버가인터넷과연결되어있지않으면설치파일을다운로드할수없습니 다. 이때는다음순서로설치파일을직접업로드합니다. 1. 쓰리래빗츠홈페이지에서설치파일을다운로드합니다. 2. < 소프트웨어업데이트 > 메뉴를클릭합니다. 3. < 업데이트확인 > 링크를클릭합니다. 4. < 설치파일올리기 > 링크를클릭해서다운로드한설치파일을업로드합니다. 그림 14-3 설치파일올리기 14.2 쓰리래빗츠재시작 다운로드완료후에쓰리래빗츠를재시작하면소프트웨어가자동으로업데이트됩니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다.

96 78 소프트웨어업데이트 윈도우 다음순서로쓰리래빗츠를재시작합니다. 1. 탐색기에서 3RABBITZ_HOME\bin 폴더로이동합니다. 2. shutdown.bat 파일을실행합니다. 3. 쓰리래빗츠가완전하게정지되면 startup.bat 파일을실행합니다 리눅스와맥 OS 다음순서로쓰리래빗츠를재시작합니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. 다음명령어를실행합니다../shutdown.sh 3. 쓰리래빗츠를정지한후 1 다음명령어를실행합니다../startup.sh 14.3 라이선스키버전이맞지않을때 메이저업데이트를하려면먼저라이선스키를업데이트해야합니다. 구매후 1 년이지나지않았 다면새로운라이선스키를발급해드립니다. 다음이메일주소로서버아이디를보내주세요. 1. ps -ef grep 3rabbitz 명령어로정지여부를확인합니다.

97 라이선스키버전이맞지않을때 79 구매후 1 년이지났다면소프트웨어업데이트를구매해야합니다.

98

99 15. 자바힙메모리바꾸기 15.1 자바힙메모리확인 다음순서로자바힙메모리설정내용을확인합니다. 1. < 관리 서버관리 1 JMX> 메뉴로이동합니다. 2. Java Platform 목록에서 java.lang:type=runtime 을열어자바힙메모리설정을확인합니 다. 81

100 82 자바힙메모리바꾸기 15.2 윈도우에서자바힙메모리바꾸기

101 윈도우에서자바힙메모리바꾸기 83 3RABBITZ_HOME 은쓰리래빗츠를설치한폴더를지칭합니다 윈도우서비스에등록했을때 다음순서로자바힙메모리설정을바꿉니다. 1. 명령프롬프트를실행합니다. 2. 3RABBITZ_HOME\bin 폴더로이동합니다. 3. 다음명령어를실행합니다. tomcat8 //US//3Rabbitz --JvmMs JvmMx 쓰리래빗츠서비스를재시작합니다 윈도우서비스에등록하지않았을때 다음순서로윈도우에서자바힙메모리설정을바꿉니다. 1. 탐색기에서 3RABBITZ_HOME/bin 폴더로이동합니다. 2. startup.bat 파일을열어다음부분에서자바힙메모리설정을바꿉니다.... cd "%CURRENT_DIR%" set TITLE=3Rabbitz set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx1024m set JAVA_OPTS=%JAVA_OPTS% -D3rabbitz.home="%RABBITZ_HOME%" :gothome...

102 84 자바힙메모리바꾸기 3. 쓰리래빗츠를재시작합니다. 재시작방법은 13. 쓰리래빗츠시작과정지를참고하세요. 4. 자바힙메모리설정이바뀌었는지확인합니다 리눅스와유닉스와맥 OS 에서자바힙메 모리설정바꾸기 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 다음순서로리눅스와유닉스와맥 OS 에서자바힙메모리설정을바꿉니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. startup.sh 파일을열어다음부분에서자바힙메모리설정을바꿉니다.... EXECUTABLE=catalina.sh JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx1024m" JAVA_OPTS="$JAVA_OPTS -D3rabbitz.home=${RABBITZ_HOME}" export JAVA_OPTS 쓰리래빗츠를재시작합니다. 재시작방법은 13. 쓰리래빗츠시작과정지을참고하세요. 4. 자바힙메모리설정이바뀌었는지확인합니다.

103 16. 포트번호바꾸기 쓰리래빗츠는 2 개의네트워크포트를사용합니다. 하나는사용자요청처리를위한서비스포트 이고다른하나는쓰리래빗츠를정지하기위해사용하는정지 (Shutdown) 포트입니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리 ( 윈도우에서는폴더 ) 를지칭합니다 서비스포트번호변경 서비스포트번호는기본값이 1975 입니다. 포트번호를바꾸려면 3RABBITZ_HOME/tomcat/conf/s erver.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> 85

104 86 포트번호바꾸기 쓰리래빗츠를다시시작해야변경사항을반영합니다 정지포트번호변경 정지포트번호는기본값이 5791 입니다. 포트번호를바꾸려면 3RABBITZ_HOME/tomcat/conf/se rver.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> 쓰리래빗츠를다시시작해야변경사항을반영합니다.

105 17. 메일설정하기 17.1 메일과관련한이벤트 메일서버를설정하면, 다음이벤트가일어났을때메일을발송합니다. 지켜보기하는문서가바뀔때 지켜보기하는문서에피드백이달릴때 지켜보기하는문서에댓글이달릴때 그리고메일서버를설정해야, 로그인화면에 < 비밀번호찾기 > 링크가나타납니다 메일서버설정 다음순서로메일서버를설정합니다. 1. < 환경설정 메일서버 > 메뉴를클릭합니다. 2. < 메일서버설정변경 > 링크를클릭합니다. 3. 입력화면에서기본정보, 보내는서버 (SMTP) 등을입력한후 < 저장 > 버튼을클릭합니다. 87

106 88 메일설정하기 표 17-1 메일서버입력필드 필드이름 필수입력여부 설명 메일제목접두어 아니오 메일제목앞에붙는접두어를입력합니다. 보내는서버 (SMTP ) 주소 예 보내는서버주소로 IP 또는도메인이름으로입력합니다. 예 ) smtp.gmail.com 보내는서버 (SMTP ) 포트 예 보내는서버포트번호를입력합니다. 예 ) 465 메일계정아이디 아니오 보내는서버가인증을요구하는경우에입력합니다. 보내는서버에따라서계정아이디만입력하거나메일주소전체를입력해야합니다. 메일계정비밀번호 아니오 보내는서버가인증을요구하는경우에비밀번호를입력합니다. 메일발송주소 아니오 메일계정아이디를설정한경우에메일계정아이디가보내는사람주소가됩니다. 보내는사람주소로다른계정을사용하려면여기에메일발송주소를입력합니다. 메일계정아이디와비밀번호설정이필요없는경우에는메일발송주소를입력해야보내는사람주소가설정됩니다 테스트메일보내기 다음순서로테스트메일을보내메일서버설정을검증합니다. 1. < 환경설정 메일서버 > 메뉴를클릭합니다. 2. < 테스트메일보내기 > 링크 ( 메일서버를설정했을때만링크가나타납니다.) 를클릭합니다. 3. 메일내용을입력한후에아래에있는 < 보내기 > 버튼을클릭합니다.

107 발송한메일목록확인 구글, 네이버, 다음계정으로메일서버 설정하기 메일서버를직접운영하지않아도구글, 네이버, 다음계정이있다면이를사용하여메일서버를 설정할수있습니다. 외부메일서버는하루에보낼수있는메일숫자를제한하기도합니다. 이벤트가많이 일어날때는메일이발송되지않을수있습니다. 구글 네이버 다음 보내는서버 (SMTP) 주소 smtp.gmail.com smtp.naver.com smtp.daum.net 보내는서버 (SMTP) 포트 메일계정아이디 m et 메일계정비밀번호 구글비밀번호 네이버비밀번호 다음비밀번호 17.5 발송한메일목록확인 < 서버관리 메일 > 메뉴에서시스템이발송한메일목록을조회할수있습니다. 30 일간메일발송내역을보관합니다. 30 일이후에는자동으로삭제합니다.

108

109 18. 로그파일 18.1 로그파일위치 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리 ( 윈도우에서는폴더 ) 를지칭합니다. 로그파일위치는다음디렉터리 ( 폴더 ) 입니다. 3RABBITZ_HOME/logs 로그는일자별로구분하여파일에씁니다. 서버관련로그는 catalina.yyyy-mm-dd.log 파일에, 애플리케이션관련로그는 localhost.yyyy-mm-dd.log 파일에씁니다 로그파일내려받기 < 서버관리 로그 > 메뉴에서로그파일을내려받을수있습니다. 91

110 92 로그파일 18.3 로그파일삭제 < 서버관리 로그 > 메뉴에서로그파일을삭제할수있습니다. 일자별로로그파일을기록하는데오늘로그파일은삭제할수없습니다 로그파일압축 오랜시간동안쓰리래빗츠를사용하면로그파일이많아집니다. 이문제를해결하기위해서월단 위로로그파일을압축합니다. 지난달전에만들어진로그파일만을압축합니다 로그수준바꾸기 < 서버관리 로그 > 메뉴에서로그수준을바꿀수있습니다. 로그수준 (Level) ALL, SEVERE, WARNING, INFO, FINE, FINEST, OFF

111 로그수준바꾸기 93 그림 18-1 로그수준변경 로그수준기본값은 INFO 입니다. FINE 으로수준을바꾸면로그가많아집니다. 특별한 이유가없다면로그수준을변경하지않습니다.

112

113 19. 라이선스관리 19.1 서버아이디란? 서버아이디는구분자를포함총 36 자로이루어진문자열입니다. 예 : A13B03AE-FE51-35D4-FAE0-0CE2BEE71D22 쓰리래빗츠를설치하는컴퓨터마다고유한서버아이디가만들어지며서버아이디를가지고라이선스키를만듭니다. 라이선스키를발급받으려면서버아이디를알아야합니다. 이서버아이디를확인하는방법은다음과같습니다. 새로설치할때는설치마법사에서라이선스정보를입력하는단계에서확인할수있습니다. 95

114 96 라이선스관리 라이선스업그레이드또는변경할때는 < 관리 환경설정 라이선스 > 메뉴에서확인할수있습니 다.

115 라이선스키를추가하거나바꾸기 라이선스키를추가하거나바꾸기 다음순서로라이선스키를추가하거나바꿉니다. 1. < 환경설정 라이선스 > 메뉴로이동합니다. 2. < 라이선스업그레이드 > 링크를클릭합니다 3. 라이선스키를입력한후, < 저장 > 버튼을클릭합니다.

116 98 라이선스관리 19.3 라이선스키발급하기 평가판과 Personal 라이선스 평가판과 Personal 라이선스키는쓰리래빗츠홈페이지에서직접발급받을수있습니다. 1. 홈페이지오른쪽위에있는 < 내계정 > 메뉴를클릭합니다. 2. < 라이선스 > 탭을선택한후, < 라이선스발급 > 링크를클릭합니다. 3. 제품과유형을선택하고, 서버아이디를입력합니다. 4. < 라이선스발급 > 버튼을누릅니다 정식라이선스 제품구매를완료하면, 정식라이선스키를발급해드립니다. 정식라이선스키는홈페이지에서발 급할수없습니다 오픈소스와비영리기관라이선스 오픈소스라이선스 오픈소스라이선스는 Open Source Initiative 가승인한오픈소스라이선스를준수하고 있는프로젝트를위한라이선스입니다. 독립적인개발자커뮤니티없이영리목적으로한회사가진행하고있는프로젝트에는 오픈소스라이선스를발급하지않을수있습니다. 비영리기관라이선스 비영리기관은주로사회봉사단체를의미합니다. 정부또는연구소를포함한정부산하단 체, 병원, 학교등은이에해당하지않습니다.

117 라이선스키발급하기 99 오픈소스와비영리기관라이선스를신청하려면다음정보를 으로보내주 세요. 사용목적 서버아이디 필요한문서수와사용자수 오픈소스와비영리기관라이선스를신청하기전에평가판라이선스로제품을설치한 후제품이필요한기능을갖추고있는지먼저확인하는것을권장합니다.

118

119 20. 백업과복원 20.1 백업 20.2 복원 백업 쓰리래빗츠는다음과같이데이터베이스를백업합니다. 일요일오전 4 시에전체데이터베이스를백업합니다. 일요일을제외한나머지날에는오전 4 시에하루동안의변경사항을백업합니다. 아파치더비를사용할때만이백업기능이동작합니다. 다른데이터베이스를사용한다 면해당데이터베이스백업기능을사용합니다. 101

120 102 백업과복원 20.2 복원 다음순서로쓰리래빗츠데이터베이스를복원합니다. 1. 쓰리래빗츠를정지합니다. 2. 복원할때발생하는문제를대비하기위해, 쓰리래빗츠를설치한디렉터리에있는모든파일 을복사하여보관합니다. 3. 쓰리래빗츠를설치한디렉터리에 restore라는이름의빈파일을만듭니다. 4. 쓰리래빗츠를시작합니다. 5. 웹브라우저로쓰리래빗츠에접근하면복원화면이나타납니다. < 시작 > 버튼을눌러데이터 를복원합니다. 아파치더비를사용할때만이복원기능이동작합니다. 다른데이터베이스를사용한다 면해당데이터베이스복원기능을사용합니다. 복원에성공했다면, 복원과정에서생긴보관파일을삭제합니다. 복원할때이전데이터를다음 이름으로보관합니다. 데이터베이스파일 : database_ t 이미지파일 : upload_ t 기본값으로설치했다면, 쓰리래빗츠데이터디렉터리위치는 3RABBITZ_HOME/data 입 니다.

121 21. 서버옮기기 21.1 운영체제가같을때 리눅스에서리눅스 ( 또는유닉스 ), 윈도우에서윈도우로쓰리래빗츠를옮긴다면다음순서로작업합 니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 1. 최신버전으로쓰리래빗츠를업데이트합니다. 자세한사항은 14. 소프트웨어업데이트를참고합니다. 2. 쓰리래빗츠를정지합니다. 3. 기존 3RABBITZ_HOME 디렉터리를새로운서버에모두복사합니다. 설치할때데이터또는백업경로를바꿨다면, 그디렉터리도같은위치로복사합니다. 4. 새로운서버에옮긴쓰리래빗츠를시작합니다. 5. 새로운서버에옮긴쓰리래빗츠의서버아이디를확인합니다. 자세한사항은 19.1 서버아이디란? 를참고합니다. 6. 새로운라이선스키를발급받습니다. 자세한사항은 19.3 라이선스키발급하기를참고합니다. 7. 라이선스키를바꿉니다. 자세한사항은 19.2 라이선스키를추가하거나바꾸기를참고합니다. 103

122 104 서버옮기기 21.2 운영체제가다를때 리눅스에서윈도우, 윈도우에서리눅스로쓰리래빗츠를옮긴다면다음순서로작업합니다. 1. 옮길서버에쓰리래빗츠를설치합니다. 자세한사항은설치가이드를참고합니다. 2. 기존쓰리래빗츠를정지합니다. 3. 새로설치한쓰리래빗츠를정지합니다. 4. 기존쓰리래빗츠의데이터와백업디렉터리를새로설치한쓰리래빗츠의데이터와백업디렉 터리에복사합니다. 5. 새로설치한쓰리래빗츠를시작합니다 데이터와백업디렉터리위치바꾸기 다음순서로데이터와백업디렉터리위치를바꿉니다. 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 1. 쓰리래빗츠를정지합니다. 2. 데이터와백업디렉터리를새로운위치로복사합니다. 3. 3RABBITZ_HOME/preference.properties 파일을열고, 데이터와백업디렉터리위치를바꿉 니다. # FilePreference infomation. #Thu Oct 22 12:04:28 KST 2015 BACKUP_DIR=../data/backup DB_DIR=../data

123 데이터와백업디렉터리위치바꾸기 105 상대경로시작위치는 3RABBIZE_HOME/bin 디렉터리입니다. 4. 쓰리래빗츠를시작합니다.

124

125 22. 전체문서목록보기 관리자권한이있어도대시보드에는접근권한이있는문서만이나타납니다. 관리목적으로모든 문서목록을확인할수있는방법을제공합니다. 문서내용은볼수없습니다 윈도우 윈도우서비스에등록했을때 다음순서로시작옵션설정을바꿉니다. 1. 명령프롬프트를실행합니다. 2. 3RABBITZ_HOME\bin 폴더로이동합니다. 3. 다음명령어를실행합니다. tomcat8 //US//3Rabbitz ++JvmOptions -D3rabbitz.support_document_list_for_ admin=true 4. 쓰리래빗츠서비스를재시작합니다. 관리자권한을가진사용자는 < 도구 1 문서목록 > 메뉴에서전체문서목록을확인할수있습니 107

126 108 전체문서목록보기 다 윈도우서비스에등록하지않았을때 1 시작스크립트에 3rabbitz.support_document_list_for_admin 옵션을추가합니다. 윈도우에서는 3RABBITZ_HOME/bin/startup.bat 파일을열어 18 번째줄다음에진한부분 을추가합니다. set TITLE=3Rabbitz set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx1024m set JAVA_OPTS=%JAVA_OPTS% -D3rabbitz.home="%RABBITZ_HOME%" set JAVA_OPTS=%JAVA_OPTS% -D3rabbitz.support_document_list_for_admin=true :gothome 2 쓰리래빗츠를재시작합니다. 관리자권한을가진사용자는 < 도구 1 문서목록 > 메뉴에서전체문서목록을확인할수 있습니다.

127 리눅스 리눅스 1 시작스크립트에 3rabbitz.support_document_list_for_admin 옵션을추가합니다. 리눅스에서는 3RABBITZ_HOME/bin/startup.sh 파일을열어 55 번째줄다음에진한부분을 추가합니다. EXECUTABLE=catalina.sh JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx1024m" JAVA_OPTS="$JAVA_OPTS -D3rabbitz.home=${RABBITZ_HOME}" JAVA_OPTS="$JAVA_OPTS -D3rabbitz.support_document_list_for_admin=true" export JAVA_OPTS 2 쓰리래빗츠를재시작합니다. 관리자권한을가진사용자는 < 도구 1 문서목록 > 메뉴에서전체문서목록을확인할수 있습니다.

128 110 전체문서목록보기

129 23. 일본어사용하기 일본어번역이부실해서공식적으로일본어를지원하지는않습니다. 일본어를사용하도록설정은 할수있습니다. 부실한일본어번역을바꾸려면 5. 라벨과메시지바꾸기를참고합니다 윈도우 3RABBITZ_HOME 은쓰리래빗츠를설치한폴더를지칭합니다. 다음순서로일본어를사용할수있습니다. 1. 탐색기에서 3RABBITZ_HOME/bin 폴더로이동합니다. 2. startup.bat 파일을열어다음부분에서일본어설정옵션을추가합니다.... cd "%CURRENT_DIR%" set TITLE=3Rabbitz set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx1024m set JAVA_OPTS=%JAVA_OPTS% -D3rabbitz.home="%RABBITZ_HOME%" 111

130 112 일본어사용하기 set JAVA_OPTS=%JAVA_OPTS% -D3rabbitz.support_japanese="true" :gothome 쓰리래빗츠를재시작합니다. 재시작방법은 13. 쓰리래빗츠시작과정지를참고하세요 리눅스 3RABBITZ_HOME 은쓰리래빗츠를설치한디렉터리를지칭합니다. 다음순서로일본어를사용할수있습니다. 1. 3RABBITZ_HOME/bin 디렉터리로이동합니다. 2. startup.sh 파일을열어다음부분에서일본어설정옵션을추가합니다.... EXECUTABLE=catalina.sh JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx1024m" JAVA_OPTS="$JAVA_OPTS -D3rabbitz.home=${RABBITZ_HOME}" JAVA_OPTS="$JAVA_OPTS -D3rabbitz.support_japanese=true" export JAVA_OPTS 쓰리래빗츠를재시작합니다. 재시작방법은 13. 쓰리래빗츠시작과정지을참고하세요.

131 24. 시작스크립트옵션설정 시작스크립트옵션설정방법을설명합니다. 3rabbitz.support_document_list_for_admin 옵 션을 true 값으로설정하는방법을설명합니다. 실제옵션이름과값으로바꿉니다 윈도우 윈도우서비스에등록했을때 다음순서로시작옵션설정을바꿉니다. 1. 명령프롬프트를실행합니다. 2. 3RABBITZ_HOME\bin 폴더로이동합니다. 3. 다음명령어를실행합니다. tomcat8 //US//3Rabbitz ++JvmOptions -D3rabbitz.support_document_list_for_ admin=true 3rabbitz.support_document_list_for_admin 옵션이름과 true 값을실제옵션 이름과값으로바꿉니다. 4. 쓰리래빗츠서비스를재시작합니다. 113

132 114 시작스크립트옵션설정 윈도우서비스에등록하지않았을때 1 시작스크립트에 3rabbitz.support_document_list_for_admin 옵션을추가합니다. 윈도우에서는 3RABBITZ_HOME/bin/startup.bat 파일을열어다음진한부분을추가합니다. set TITLE=3Rabbitz set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx1024m set JAVA_OPTS=%JAVA_OPTS% -D3rabbitz.home="%RABBITZ_HOME%" set JAVA_OPTS=%JAVA_OPTS% -D3rabbitz.support_document_list_for_admin=true :gothome 3rabbitz.support_document_list_for_admin 옵션이름과 true 값을실제옵션 이름과값으로바꿉니다. 2 쓰리래빗츠를재시작합니다 리눅스 1 시작스크립트에 3rabbitz.support_document_list_for_admin 옵션을추가합니다. 리눅스에서는 3RABBITZ_HOME/bin/startup.sh 파일을열어다음진한부분을추가합니다. EXECUTABLE=catalina.sh JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx1024m" JAVA_OPTS="$JAVA_OPTS -D3rabbitz.home=${RABBITZ_HOME}" JAVA_OPTS="$JAVA_OPTS -D3rabbitz.support_document_list_for_admin=true"

133 리눅스 115 export JAVA_OPTS 3rabbitz.support_document_list_for_admin 옵션이름과 true 값을실제옵션 이름과값으로바꿉니다. 2 쓰리래빗츠를재시작합니다.

134

135 찾아보기 쓰리래빗츠재시작, 77 S server.xml, 85, 86 ㄹ ㅈ 정지포트번호 5791, 86 변경, 86 지켜보기, 22 라벨, 19 ㅁ ㅌ 테스트메일보내기, 88 문서검색, 18 ㅂ 비밀번호찾기, 36 ㅍ 포트번호변경서비스포트, 85 정지포트, 85 ㅅ 사용자관리비밀번호변경, 43 삭제, 42 사용자권한관리, 42t 글쓰기, 42t 글읽기, 42t 비주얼, 42t 서식만들기, 42t 서버관리백업, 101 서비스포트번호 1975, 85 변경, 85 소프트웨어업데이트, 75 릴리스노트,