jakartaproject

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

    Weblogic8 sp2
    Jeus 5.0

    MySQL 4.0, 4.1, 5.0

    Oracle 9 release2

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

 

 

2. 설치전 확인사항

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

 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/

 /lucene/index/

 

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

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

 

예) apache httpd.conf

 

JkMount /*.jsp ajp13
JkMount /*.do ajp13
JkMount /article/* ajp13
JkMount /uploadManager ajp13
JkMount /downManager 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을 통해 설치 화면으로 접속하세요

 

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

 

⑧ 업로드 캐릭터셋 설정

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

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

 

⑨ 다운로드 캐릭터셋 설정

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

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

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

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

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

 

⑩ 썸네일 가능 설정

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

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

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

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

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

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

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

 

⑪ 최고관리자 설정

최고 관리자를 설정합니다

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

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

 

⑫ 설치종료

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

 

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

[데이터베이스설정]
정상적으로 데이터베이스 커넥션이 설정되었습니다

 

[JDBC 파일 설정]  <-- Oracle인 경우만 나타남

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

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

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

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

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

 

만약 오라클 사용자라면 한단계가 더 있습니다

오라클 버젼과 JDK 버젼에 따라 JDBC 설정을 따로 해줘야 합니다

일단 톰캣을 stop 시킨후 다음을 진행하세요

① /WEB-INF/lib/classes12.jar 파일을 삭제합니다 (혹은 classes111.jar나 ojdbc14.jar 도 있다면 이 파일들도 삭제합니다)

② /WEB-INF/jdbc/ 디렉토리에 가보면 입력한 오라클버젼과 JDK버젼에 따라 적합한 JDBC 파일이 생성되어있을겁니다

   *.zip 파일은 무시하시고 방금 새로 생성된 jar 파일(classes111.jar 혹은 classes12.jar혹은 ojdbc14.jar 3개중 하나만 생성되었을겁니다) 하나만 /WEB-INF/lib/ 에 복사합니다

 

↑ 오라클 버젼과 jdk 버젼설정으로 새로 생성된 ojdbc14.jar (혹은 classes111.jar 혹은 classes12.jar가 될수있다) 를 /WEB-INF/lib/ 에 복사합니다

오라클이라면 /WEB-INF/lib/ 에 오라클JDBC만(mysql jdbc는 삭제), MySQL이라면 mysql용 JDBC만(oracle jdbc는 삭제) 남겨 놓으시기 바랍니다

진짜로 설치 끝~!

 

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설치시 자동으로 되지 않습니다

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

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

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

이 "국기보이기"기능은 해당 WAS에 접속한 유저의 IP가 유효한 아이피여야 어느 국가인지 판별하게 됩니다 127.0.0.1 이나 내부아이피등은 인식 할수 없기 때문에 "국기"가 정상적으로 나타나지 않습니다