Unicorn3 설치 가이드

① Unicorn은 MySQL이나 Oracle 데이터베이스를 사용하기 때문에 접속할 데이터베이스가 필요합니다

    MySQL은 4.0 버젼 이상, Oracle은 9i 버젼 이상을 지원합니다

② Unicorn은 Java기반의 프로그램이기 때문에 Weblogic같은 WAS(Web Application Server)나 Tomcat같은

    JSP Container가 필요합니다

    JDK는 1.4부터, Tomcat은 4.1 이상버젼부터 지원합니다

③ 개발 테스트는 다음 환경에서 테스트 되었습니다 

    Tomcat4.1, 5.0, 5.5, 6.0

    Weblogic8 sp2
    Jeus 5.0

    MySQL 4.0, 4.1, 5.0

    Oracle 9 release2, Oracle 10g, Oracle 11g

    추가적으로 다른 WAS나 데이터베이스는 계속 테스트 될 예정입니다

① Unicorn 라이센스키를 반드시 신청 하세요(Unicorn3 V3.4 부터 적용됩니다)

    http://www.jakartaproject.com/license-request.do

    라이센스 키를 신청하시면 등록된 메일로 라이센스 키가 발급됩니다

    라이센스 키가 없으면 Unicorn 3.4버전 부터는 Unicorn이 동작 하지 않습니다

    메일로 Unicorn 설치시에 입력하는 설치 인증번호와 서버 라이센스키를 받을 수 있습니다

② 데이터베이스 계정의 권한을 확인 하세요

    http://www.jakartaproject.com/article/boardfaq/114122724164200

③ WAS를 실행하는 OS계정의 권한을 확인 하세요

    아래 디렉토리 및 파일에 쓰기권한이 있어야 합니다

④ 만약 아파치나 웹투비같은 웹서버가 설정되어있다면 아래 URL 패턴들은

     웹서버에서 WAS로 포워딩 해 줄수 있도록 설정해 주셔야 정상 작동 합니다

   자세한 서블릿 매핑 정보는 /WEB-INF/web.xml 을 참조하세요

다운받은 파일의 압축을 풀고 FTP등의 프로그램을 이용하여 해당 서버에 카피합니다

/web 디렉토리가 웹어플리케이션의 ROOT 디렉토리가 되도록 서버에 적절히 구성하시기 바랍니다

경로	설명
/css	style sheet 폴더입니다
/img	unicorn 이미지 폴더입니다 /img/skin/은 skin 이미지 폴더입니다
/js	자바스크립트 폴더입니다
/jsp/admin	관리자 프로그램 jsp 폴더입니다
/jsp/board/skin/	Unicorn JSP Skin 폴더입니다
/jsp/commons	Unnicorn이 공통으로 사용하는 jsp 폴더입니다
/jsp/errors	에러가 발생시 이동되는 페이지가 저장되어 있습니다 (404, 500 에러등..)
/jsp/install	Unicorn 설치시 사용되는 JSP가 들어있습니다
/jsp/layouts	Unicorn 전체 frame설정 및 디자인설정 폴더입니다
/lucene/index	Lucene검색엔진 에서 사용하는 인덱스 디렉토리 입니다
/out	파일 업로드 디렉토리 입니다 /attach 첨부파일 /editor html 에디터시 추가파일 /icon 사용자 업로드 아이폰파일 /level 사용자 레벨 이미지파일 /photo 사용자 업로드 사진파일 /thumb 썸네일이 생성되는 파일등을 나타냅니다 각 디렉토리에 있는 no.gif는 삭제하시면 안됩니다 각 no.gif 파일은 파일이 존재하지 않을때 나타나는 기본파일 입니다
/WEB-INF/classes	java 프로그램 및 각종 설정파일 폴더입니다 각종 *.properties 파일들이 있습니다
/WEB-INF/conf	struts 설정 및 tiles 설정 폴더입니다
/WEB-INF/lib	기타 서드파티 jar 폴더입니다
/WEB-INF/tld	tag library 폴더입니다

 소스 설치후 TOMCAT이나 해당 WAS를 기동시킵니다

 다음 URL을 통해 설치 화면으로 접속하세요

Unicorn3 V3.4 버젼 이후부터는 라이센스 키가 필요합니다

설치 인증번호는 ⑪ 최고관리자 설정 단계에서 입력하시고

서버 라이센스 키는 이를 복사하여 license.dat 에 저장합니다

license.dat 파일은 Unicorn 설치 서버의 /WEB-INF/classes/license.dat 에 위치해야 합니다

예) http://localhost:8080/install.do 혹은 http://localhost:8080/unicorn3/install.do

① Unicorn 라이센스 동의

먼저 라이센스를 읽고 동의해 주세요

"예 동의합니다"를 클릭 후 "다음"버튼을 클릭하세요

② 설치할 데이터베이스 선택

설치할 데이터베이스를 선택 후 "다음"버튼을 클릭하세요

③ ORACLE 데이터베이스 설정

설치된 오라클 버젼과 JAVA 버젼을 선택하세요

오라클 버젼은 SELECT * FROM SYS.V_$VERSION 에서 확인가능 하며,

JAVA 버젼확인은 윈도우의 커맨드 화면이나 유닉스 시스템의 콘솔에서 java -version 를 통해 확인할 수 있습니다

그다음 서버 IP와 계정정보, 데이터베이스명을 입력하세요

테이블 스페이스란은 특정 테이블스페이스에 테이블과 인덱스를 설치 하고자 한다면 입력하세요

그렇지 않고 해당 계정의 디폴트 테이블 스페이스에 설치 하고자 한다면 입력하지 않아도 됩니다

해당 정보를 입력후 "테스트"버튼을 클릭하면 "정상적으로 연결 되었습니다" 라는 메세지가 나와야 합니다

만약 그렇지 않은 경우 다시한번 설정값들을 확인해 보시기 바랍니다

이 테스트는 설정값을 가지고 정상적으로 데이터베이스의 커넥션을 맺을 수 있는지 확인해 보는 테스트입니다

④ MYSQL 데이터베이스 설정

ORACLE과 마찬가지로 MYSQL버젼, 서버IP, 및 계정 정보들을 입력 한 후 "테스트"버튼을 통해

정상적으로 커넥션이 맺어지는지 확인해 보시기 바랍니다

⑤ 데이터베이스 커넥션 테스트

"테스트"버튼 클릭시 위와 같이 "정상적으로 연결 되었습니다" 라는 메세지가 나온다면

"다음"버튼을 클릭하여 다음 화면으로 진행하세요

만약 그렇지 않다면 설정 정보들을 다시한번 확인해 보시기 바랍니다

⑥ 데이터베이스 및 파일 업로드 다운로드 캐릭터셋 설정 - I

먼저 데이터베이스 캐릭터셋을 설정합니다

"Encoding"을 "예"로 선택 후 "테스트"버튼을 클릭합니다

⑦ 데이터베이스 및 파일 업로드 다운로드 캐릭터셋 설정 - II

파업창이 나타나며 "홍길동"이란 글이 정상적으로 보이는 값을 찾습니다

위 그림에서는 "NO_NO"가 정상적인 값을 나타내었습니다

이 값을 셀렉트 목록에서 선택합니다

만약 정상적인 한글이 나타나지 않았다면 "Encoding"을"아니요"로 선택 후 정상적인 한글이 나타나는 값을 찾습니다

또한 정상적인 한글이 여러개 나타난다면 가능한 위에있는 값을 선택하세요

만약 "종결되지 않은 문자열 상수입니다" 라는 자바스크립트 에러가 나온다면 다음 URL을 참조하세요
http://www.jakartaproject.com/article/boardfaq/1135309677275
http://www.jakartaproject.com/article/boardfaq/1135315185818

혹은 아무런 메세지가 나지 않는다면..

http://www.jakartaproject.com/article/boardfaq/120729114259775

이래도 저래도 안된다면 Oracle인 경우 다음 URL을 참조하여 Oracle JDBC를 미리 /WEB-INF/lib/ 에 복사후에 install 해보세요
Oracle, JDK 버젼에 따른 JDBC 고르기
http://www.jakartaproject.com/article/jsptip/1133504495987

⑧ 업로드 캐릭터셋 설정

한글 파일명을 선택 후 "테스트"버튼을 클릭합니다

한글 파일명인 파일을 선택할 시에는 확장자를 제외하고는 모두 한글이어야 합니다(빈칸도안됨)

예) 새텍스트문서.txt ( O ), 새텍  스트문서.txt ( X ), 텍스트문서123.txt ( X ), 텍스트A문서.txt ( X )

위와같은 결과창이 나타나며 정상적으로 한글이 보이는 값을 라디오 버튼에서 선택하세요

⑨ 다운로드 캐릭터셋 설정

라디오 버튼에서 "KO"를 선택후 "테스트"버튼을 클릭합니다

만약 위와같이 파일명이 정상적으로 나타나지 않는다면 두번째 값인 "EN"을 선택 후 다시 "테스트"버튼을 클릭합니다

역시 정상적인 한글이 나타나지 않는다면 "NO"을 클릭후 다시 "테스트"버튼을 클릭합니다

위와같이 정상적인 한글명이 나왔다면 이제 모든 한글 캐릭터셋 설정은 마치게 됩니다

"다음"버튼을 클릭하여 다음 단계를 진행합니다

⑩ 썸네일 가능 설정

Unicorn에서는 썸네일 기능을 지원합니다

하지만 환경적으로 지원되지 않을 수 있음으로 반드시 테스트후 체크합니다

(그래픽 라이버러리가 없는 OS는 썸네일을 할 수 없습니다)

이미지 (jpg, gif)등의 파일을 선택 후 "테스트"버튼을 클릭합니다

중앙에 작은 썸네일 이미지가 나타난다면 라디오 버튼에 "그림이 보입니다"를 선택합니다

만약 그렇지 않다면 "그림이 안보여요"를 선택합니다

썸네일 이미지가 생성 되었는데 이 기능을 사용하지 않으려면 "그림이 안보입니다"를 선택하세요

"다음"버튼을 클릭하여 다음 단계를 진행합니다

⑪ 최고관리자 설정

라이센스키를 신청후 메일로 받은 설치인증번호를 입력합니다

최고 관리자를 설정합니다

각 항목에 맞는 값을 설정하세요. 모든값을 입력하여야 합니다

"종료"버튼을 클릭하면 Unicorn에서 필요한 테이블과 인덱스등을 생성하며 설치를 마치게 됩니다

⑫ 설치종료

이제 모든 설치가 완료되었습니다
모든 과정이 로그로 출력되며 해당 사항을 확인해 보세요
설치시 발생한 에러가 있다면 다시 설치하시기 바랍니다

만약 정상적으로 설치가 되었다면 다음과 같은 메세지나 나타나야 합니다

⑬ JDBC 정리

/WEB-INF/lib/ 디렉토리는 Unicorn에서 사용하는 여러가지 써드파티 jar들 입니다

만약 MYSQL 사용자라면 오라클 JDBC oraclejdbc.jar  가 남아있다면 삭제해 주세요

만약 Oracle 사용자라면 MySQL JDBC인 mysql-connector-java-3.1.13-bin.jar를 삭제 해 주세요

삭제 하지 않아도 별 문제는 없지만 메모리 낭비 할 필요 없겠죠?

진짜로 설치 끝~!

보안을 위해 모든 설정이 마친 후에는 install 페이지에 더이상 접근할 수 없도록 설정할 필요가 있습니다
/WEB-INF/conf/struts-config.xml 파일을 열어 다음을 주석처리 하길 권장합니다

web.xml 의 테스트 관련 servlet 주석치리 해주세요

와 같이 <!-- 와 -->로 주석처리 해 주세요

모든 사항은 톰캣 리스타트 후 적용이 되니 설정후 꼭 리스타트 하시기 바랍니다

관리자 접속 URL은 admin.do 입니다

위 URL과 같이 설치 도메인에 admin.do 를 호출하면 관리자 화면이 나타납니다

이 화면에 조금전에 입력한 최고관리자의 아이디와 비밀번호를 입력 후 엔터키를 치면 로그인 하게 됩니다

1	설명	URL
2	관리자 접속	admin.do
3	Unicorn 인스톨 주소	install.do
4	일반유저 게시판 로그인 주소	login.do
5	일반유저 게시판 로그아웃 주소	logout.do
6	회원 리스트 주소	member-rank.do
7	회원가입 주소	member-join.do
8	회원정보 수정 주소(로그인상태)	member-edit.do
9	회원 비밀번호 찾기 주소	member-password.do
10	회원 아이디찾기 주소	member-found.do
11	고급검색 주소	search.do
12	쪽지입력 주소	message-edit.do
13	받은쪽지함 주소	message-getlist.do
14	보낸쪽지함 수조	message-putlist.do
15	태그 크라우드 주소	tag-cloud.do
16	미니 게시판 주소(파라미터 설정요)	board-index.do
17	게시판 주소	board-list.do?boardId=게시판아이디
18	경매 게시판 주소	auction-list.do

① 만약 회원가입시 "주소"데이터를 받고자 한다면 우편번호 정보가 필요하게 됩니다

    이 우편번호 정보는 데이터베이스에 존재하여야 하는데, 이는 Unicorn설치시 자동으로 되지 않습니다

    /docs/sql/post.sql 를 각 데이터베이스별로 입력하여야 주소 입력시 우편번호를 조회하여 주소를 입력받을 수 있습니다

    최신 우편번호 데이터는 http://www.zipfinder.co.kr/zipcode/index.html 사이트에서 다운로드 하세요

② Unicorn 에서는 "국기보이기"기능을 제공하는데, 이 역시 국기 데이터를 데이터베이스에 입력 하여야 합니다

    /docs/sql/ip_country.sql 를 각 데이터베이스별로 입력하여야 정상적으로 "국기보이기"기능이 작동합니다

   이 "국기보이기"기능은 해당 WAS에 접속한 유저의 IP가 유효한 아이피여야 어느 국가인지 판별하게 됩니다

127.0.0.1 이나 내부아이피등은 인식 할수 없기 때문에 "국기"가 정상적으로 나타나지 않습니다

   최신 국가별 아이피 데이터는 http://ip-to-country.webhosting.info/node/view/5 사이트에서 다운로드 하신후 사용하시면 됩니다