UNICORN3
UNICORN3 질문&답변UNICORN3 테스트게시판UNICORN3 FAQUNICORN3 정식등록 문의
Unicorn 설치 및 FAQ
Unicorn 설치 및 FAQ
Unicorn 설치안내,팁 및 FAQ 게시판 입니다
Unicorn3 설치 가이드
GoodBug http://www.jakartaproject.com
이미지 슬라이더 보기

Unicorn3 설치 가이드

 

 

1. 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나 데이터베이스는 계속 테스트 될 예정입니다

 

 

2. 설치전 확인사항

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계정의 권한을 확인 하세요

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

 

 /WEB-INF/classes/unicorn.properties

 /WEB-INF/conf/struts-config.xml

 /WEB-INF/jdbc/ (오라클인 경우에만)

 /out/attach/

 /out/editor/

 /out/icon/

 /out/photo/

 /out/thumb/

 /out/zip/

 /lucene/index/

 

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

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

 

예) apache httpd.conf

 

JkMount /*.jsp ajp13
JkMount /*.do ajp13
JkMount /article/* ajp13
JkMount /uploadManager ajp13
JkMount /downManager ajp13

jkMount /testManager ajp13

JkMount /alice-upload ajp13

JkMount /servlet/* ajp13

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

 

 

3. Unicorn3 소스설치

 

다운받은 파일의 압축을 풀고 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 폴더입니다

 

4. 프로그램 설치

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

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

 

 

5. 라이센스 키 설치

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

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

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

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

 

 

http://설치도메인/install.do 혹은

http://설치도메인/설정컨텍스트/install.do

예) 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 파일 설정]  <-- Oracle인 경우만 나타남

정상적으로 JDBC 파일이 생성 되었습니다

[기본 테이블설정]
정상적으로 테이블이 설정되었습니다

[관리자설정]
이미 관리자가 설정되어 있습니다

[캐릭터셋 설정]
캐릭터셋이 정상적으로 설정되었습니다

모든 설치가 정상적으로 완료되었습니다

 

JDBC 정리

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

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

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

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

 

진짜로 설치 끝~!

 

5. 설치 종료후..

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

 

<!--
<action
path="/install"
parameter="/jsp/admin/install.jsp"
type="org.apache.struts.actions.ForwardAction">
</action>

<action
path="/install-process"
type="com.jakartaproject.board.action.InstallAction"
scope="request"
name="forwardForm"
validate="false">
<forward name="SUCCESS" path="/jsp/commons/forward.jsp" redirect="false"/>
</action>
-->

 

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

 

<!--

<servlet>
      <servlet-name>test</servlet-name>
      <servlet-class>com.jakartaproject.unicorn.common.file.TestMngrServlet</servlet-class>
</servlet>

-->

...

<!--

<servlet-mapping>
      <servlet-name>test</servlet-name>
      <url-pattern>/servlet/com.jakartaproject.unicorn.common.file.TestMngrServlet</url-pattern>
</servlet-mapping>

-->

 

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

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

 

 

6. Unicorn 관리자화면 접속

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

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

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

 

7. Unicorn 기타 URL

 

 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

 

 

8. 기타 SQL실행

 

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

    이 우편번호 정보는 데이터베이스에 존재하여야 하는데, 이는 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 사이트에서 다운로드 하신후 사용하시면 됩니다

 

2013-10-31 10:08:32
112.216.206.***

 

좋은생각 ^^

10점 (1명)
설치 setup Unicorn3 설치 가이드 7 Tag 3 GoodBug 2006-09-07
덧글 7개 | 태그 3개 | 관련글보기
태그입력
쉽표(,)구분으로 한번에 여러 태그를 입력할수 있습니다
설치 (3) Install Guide (1) setup (1)
Best Reply
kebby

Linux + resin 환경에서 설치했는데 아주 잘 돌아 가네요.. 설치도 쉽고

 

좋은 자료 감사합니다. ^ ^

수평선
(0) (0)

참좋은 게시판이네요..근데 설치하다가 버그인지 모르는 현상을 보았습니다.

오라클로 설치하는중에 테이블스페이스를 입력하지 않으면 잘되는데 입력하면 연결테스트는 통과하지만 관리자 아이디를 생성못하더군요..오류메세지에 다음과 같히 나왔습니다.

<script language=javascript>parent.message('java.sql.SQLException: ORA-00959: 테이블스페이스 "UNICORN"이(가) 존재하지 않습니다.
')</script>

아무튼 이것때매 처음에 고생좀 했어요..^^

61.106.227.*** 2007-03-05 14:06:37
리어카
(0) (0)

흐음 저역시도... 테이블 스페이스가 들어갈경우 관리자 아이디를 생성 못하더군요^^

윗분과 동일한 현상.. 이 발생합니다^^

222.237.95.*** 2007-05-24 16:09:06
GoodBug
(0) (0)

오라클에 테이블 스페이스는 미리 생성되어 있어야 합니다

미리 생성된 테이블스페이스에 Unicorn을 설치하는 방식입니다

 

테이블 스페이스를 지정하지 않으면

해당 유저(오라클 유저)의 디폴트 테이블 스페이스에 테이블을 생성하게 됩니다

 

오라클 유저 생성 시 디폴트 테이블스페이스를 생성하지 않으면 템프가 디폴트가 됨으로 주의 하셔야 합니다

 

112.216.206.*** 2010-06-20 01:20:16
JAEUG
(0) (0)

정말 멋진 게시판입니다.

 

감사히 잘 사용하겠습니다^^

211.186.54.*** 2008-03-02 16:29:25
kebby
(1) (0)

Linux + resin 환경에서 설치했는데 아주 잘 돌아 가네요.. 설치도 쉽고

 

좋은 자료 감사합니다. ^ ^

210.96.12.*** 2009-03-13 15:17:38
쿄쿄쿄
(0) (0)

좋은 자료 감사합니다~!!^^

58.150.146.*** 2009-07-01 16:59:39
exodus
(0) (0)

cafe24에 mysql5버전으로 호스팅 신청했는데 utf-8만 지원된다고합니다.

 

그런데 Unicorn3에서 utf-8 지원이 안된다고 하네요. ㅠㅠ

 

결국 cafe24의 mysql4로 다시 돌아가야겠네요.

 

cafe24에 호스팅하는 분들은 참고하시기 바랍니다.

 

  

124.137.18.*** 2011-08-24 10:39:32
이름 비밀번호
Unicorn 설치 및 FAQ
Unicorn 설치안내,팁 및 FAQ 게시판 입니다
! 카테고리 번호 제목 글쓴이 일자 조회
FAQ 도로명 2014 도로명 전면 시행에 대한 Unicorn3 가이드 1 1 GoodBug 2014-01-01 3,581
FAQ 라이센스 Unicorn 라이센스 설치 안내입니다 1 GoodBug 2010-01-31 7,318
FAQ Unicorn3 Unicorn3 소개 1 1 GoodBug 2010-01-05 20,089
설치 setup Unicorn3 설치 가이드 7 3 GoodBug 2006-09-07 57,449
FAQ 99 기능 문의 tigermale 2015-06-22 912
설치 98 까페24 호스팅에서 FTP 기초문의입니다. 대기업 2013-04-22 1,961
FAQ 97 jdk1.5 JDK 1.5 환경 1 GoodBug 2012-03-21 2,597
FAQ 96 invalid filename 파일 업로드 시 멈춤현상이 발생한 경우 2 GoodBug 2012-03-07 3,438
설치 95 jdk1.4 JDK 1.4 환경 1 GoodBug 2012-02-27 2,497
설치 94 업그레이드 Unicorn v3.23 에서 Unicorn v3.40 으로 업그레이드 시 에러날때 1 GoodBug 2010-02-02 5,114
FAQ 93 Unicorn3 Unicorn3 히스토리 1 GoodBug 2010-01-05 5,630
FAQ 92 browser Unicorn3 V3.3 제약 사항 및 브라우져 지원 현황 1 GoodBug 2009-12-31 4,678
TIP 91 unicorn Unicorn3 주요 UI 기능 2 GoodBug 2009-12-30 15,872
TIP 90 메인화면에 설문조사 달기~! GoodBug 2008-06-10 8,491
FAQ 89 태그클라우드 메인화면(최근글목록,태그크라우드) 및 미니게시판(글5개씩) 만들기 (v3.20 이상) 1 1 GoodBug 2008-04-28 12,800
설치 88 Unicorn 파일서버 설정 및 파일 동기화 기능 설정 방법 3 GoodBug 2008-04-04 9,583
TIP 87 Unicorn3 v3.20 전체 기능 소개 1 GoodBug 2008-04-04 10,122
설치 86 MySQL 서버에 설치시 캐릭터셋 설정 부분에서 에러가 발생한다면 1 GoodBug 2008-04-04 9,355
TIP 85 로그인 다른사이트에서 Unicorn3로 로그인 하기 1 1 GoodBug 2008-02-29 7,698
TIP 84 Unicorn3에 테이블 컬럼 추가하기 GoodBug 2007-10-11 8,328
copyright 2005-2017 by Unicorn