중개 플랫폼 서비스 : Confluence

설치 가이드

설치전 사전 준비 사항
Confluence용 DB 설정
Confluence 설치
Apache HTTP Server 연동

사용자 가이드
관리자 가이드

한글화
디자인 가이드
Navagation Sidebar
JOSSO 적용

참고 문헌

위키 솔루션인 Confluence를 정리 한다.

홈페이지 : http://www.atlassian.com/software/confluence/, http://www.goldpitcher.co.kr/confluence/display/GPCONF/Home
다운로드 : http://www.atlassian.com/download/
Plugin : http://www.goldpitcher.co.kr/confluence/display/GPCONF/Confluence+Extension
라이센스 : 상용 (오픈소스 진영에는 무료 라이선스 발급)
플랫폼 : Java

설치 가이드

설치전 사전 준비 사항

[MySQL Community Server 5.0.51](MySQL 5.0.51.md) 설치
- [MySql Tools for 5.0](MySql Tools for 5.0.md) 설치
- phpMyAdmin 설치 (옵션 사항으로 필요시 설치)
[Apache HTTP Server 2.2.8 with OpenSSL 0.9.8g](Apache HTTP Server 2.2.8.md) 설치
[Apache Tomcat 6.0.16](Apache Tomcat 6.0.16.md) 설치
- [Tomcat Connectors 1.1.26](Tomcat Connectors 1.1.26.md)
- Confluence를 서비스 하기 위해서는 메모리가 충분해야 하므로 Tomcat을 기동할 때 "-Xms512m -Xmx512m" 옵션을 줄 것

Confluence용 DB 설정

Confluence 설치

다운로드 사이트에서 "confluence-2.10.2-std.zip" 파일을 다운로드 한다.

다운로드 받은 파일을 Tomcat에서 사용할 수 있도록 deploy 한다.
- $TOMCAT_HOME의 경로 중 여백(" ")이 포함되지 않았을 경우
  - 다운로드 받은 파일의 압축을 풀어 $TOMCAT_HOME/webapps/confluence 폴더로 모두 복사 한다.
  - $TOMCAT_HOME/webapps/confluence/WEB-INF/classes/confluence-init.properties 파일에서 confluence.home의 값을 $TOMCAT_HOME/webapps/confluence 로 지정한다.
- $TOMCAT_HOME의 경로 중 여백(" ")이 포함되었을 경우
  - 다운로드 받은 파일의 압축을 풀어 c:/confluence 폴더로 모두 복사 한다.
    :c:/confluence/WEB-INF/classes/confluence-init.properties 파일에서 confluence.home의 값을 c:/confluence이 되도록 ..을 적절히 사용하여 지정한다.

 C:/Program Files/Apache Software Foundation/Tomcat 6.0/webapps 일 경우
 confluence.home=../../../../confluence 와 같이 지정 한다.

- $TOMCAT_HOME/conf/server.xml에서 아래 사항을 참조하여 수정 한다.

 
     
         //--- 여기에 다음을 추가 한다.

MySQL의 JDBC Driver(mysql-connector-java-5.1.7-bin.jar)를 $CONFLUENCE_HOME/WEB-INF/lib 에 복사 한다.
- Tomcat을 재기동 한다.

http://localhost/confluence/를 사용하여 설치를 시작한다.
- 화면에서 Server ID를 복사하여 둔다.

새로 브라우저를 띄워 http://www.atlassian.com/에 접속하여 사용자 등록을 한다.
- 화면 상단의 "new my.atlassian.com" 링크를 선택 한다.
- "Sign up for an account" 링크를 선택 한다.
- 필요한 정보를 입력한 후 "Create Account" 버튼을 선택하여 사용자 계정을 생성 한다.

Confluence의 한달간 사용 가능한 라이선스 키를 발급 한다.
- http://www.atlassian.com/에 로그인 한다.
- 화면 상단의 "new my.atlassian.com" 링크를 선택 한다.
- "New Evaluation License" 링크를 선택 한다.
- Product로 "Confluence"를 선택하고 Server ID에서 위에서 복사해 둔 Server ID를 등록한 후 "Generate License" 버튼을 눌러 라이선스를 발급 한다.

이전에 진행하던 설치 화면에 위에서 생성한 라이선스 키를 복사하여 넣은 후 "Custom Installation" 버튼을 선택한다.

MySQL을 선택한 후 "External Database >>" 버튼을 선택 한다.

"Direct JDBC >>" 버튼을 선택 한다.

DB 접속 정보를 입력하고 "Next >>" 버튼을 선택 한다.
- Driver Class Name : com.mysql.jdbc.Driver
- Database URL : jdbc:mysql://localhost/confluencedb?autoReconnect=true
- User Name : confluence
- Password : 암호

"Example Site >>" 버튼을 선택하여 샘플 데이터가 등록되도록 한다.

관리자 정보를 등록하고 "Next >>" 버튼을 선택 한다.
- User Name : admin
- Password : 암호
- Password : 암호 확인
- Name : 이름
- Email : admin(골뱅이)jopenbusiness.com

http://localhost/confluence/로 접속하여 서비스를 사용한다.

Apache HTTP Server 연동

$APACHE_HOME/conf/httpd.conf 에 다음을 추가 한다.

 ###--- Confluence를 위한 환경 설정
 Alias   /confluence    c:/confluence
 
     Order allow,deny
     Allow from all

$APACHE_HOME/conf/mod_jk.conf 에 다음을 추가 한다.

 JkMount /confluence/*       worker1

Apache HTTP Server와 Apache Tomcat을 재기동 한다.

사용자 가이드

관리자 가이드

한글화

Plugin 형태로 설치를 하여야 한다.
- $CONFLUENCE_HOME/WEB-INF/lib/confluence-de_DE-plugin-1.7.jar 참조

위 confluence-de_DE-plugin-1.7.jar을 참조하여 languages-ko_KR.jar을 작성한다.
- languages-ko_KR.jar 파일을 $CONFLUENCE_HOME/WEB-INF/lib/ 에 복사한 후 Tomcat을 재기동 한다.

한국어를 Confluence의 default 언어로 설정 한다.
- Confluence의 관리자로 로그인 한다.
- "Browser -> Confluence Admin" 메뉴에서 language 메뉴를 선택 한다.
- 표시되는 화면에서 "한국어" 링크를 선택하여 한국어를 디폴트 언어로 지정 한다.

디자인 가이드

Confluence에서 Default Theme(기본 테마)를 선택하였을 경우에 디자인 변경에 대한 사항을 정리 한다.

디자인과 관련된 Confluence 메뉴
- "공간 -> Confluence Admin -> 룩앤필 -> 레이아웃" 메뉴에서 전체 화면 구조를 설정 한다.
- "공간 -> 공간 관리 -> 룩앤필 -> 레이아웃" 메뉴에서 해당 메뉴의 화면 구조를 설정 한다.

화면 레이아웃 관련 파일
{| cellspacing="1" cellpadding="1" border="1" width="100%"
|-
|width="30%" bgcolor="cyan" align="center"|레이아웃
|width="70%" bgcolor="cyan" align="center"|관련 파일 |- |align="center"|사이트 레이아웃 - 메인, 전체, 팝업, 인쇄

/decorators/'''main.vmd''', global.vmd, popup.vmd, printable.vmd
align="center"

/decorators/space.vmd, page.vmd, mail.vmd, blogpost.vmd
/decorators/components/sharedcomments.vmd, comments.vmd
-
align="center"
com/atlassian/confluence/spaces/Space.htmlexport.vm, com/atlassian/confluence/pages/Page.htmlexport.vm
}

로그인 화면

 /decorators/main.vmd
     /login.vm

로그아웃 화면

 /decorators/main.vmd
     /logout.vm

메인 화면

 /decorators/main.vmd
    /includes/css/'''master.css''', '''master-ie.css''', ...
    /includes/js/master.js, ...
     /decorators/header.vm
     /decorators/footer.vm

Navagation Sidebar

하나의 Space에서 페이지간의 이동을 위하여 Navagation Sidebar를 추가해 보자.

Confluence의 Default Theme 설정 확인
- 관리자로 로그인 한다.
- "Create a space" 메뉴를 선택하여 Navagation Sidebar를 적용할 새로운 공간(Sapces)를 생성 한다. (편의상 새로 만든 공간을 아래에서는 newSpace 라고 명명 한다.)
- "Browser -> Confluence Admin" 메뉴에서 "Themes" 메뉴를 선택하여 Current Theme를 Default Theme로 지정 한다.

새로 만든 공간에 TreeNavigation 페이지 생성
- 관리자로 로그인 한다.
- "Dashboard" 메뉴를 선택한 후 "newSpace"를 선택 한다. (Home 아래가 아니라 반드시 newSpace에서 페이지를 생성하여야 한다.)
- "Add -> Page"를 선택하여 "TreeNavigation"라는 이름의 페이지를 생성 한다.

 {pagetree:root=@home\|sort=natural\|excerpt=true\|reverse=false\|startDepth=1\|expandCollapseAll=true\|searchBox=true}
 또는
 {pagetree:root=@home|sort=natural|excerpt=true|reverse=false|startDepth=1|expandCollapseAll=true|searchBox=false}

새로 만든 공간의 페이지 레이아웃을 변경 하여 Navagation Sidebar가 표시되도록 한다.
- 관리자로 로그인 한다.
- "Dashboard" 메뉴를 선택한 후 "newSpace"를 선택 한다.
- "Space Admin -> Themes" 메뉴를 선택하여 "Default Theme"가 현재 테마로 선택되어 있는지 확인 한다.
- "Layout" 메뉴를 선택한 후 "Page Layout" 구역에서 "Create Custom" 링크를 선택 한다.

 <div class="wiki-content">
 $body
 </div>
 
 위에 표시된 글을 찾아 아래의 글로 대체 한다.
 
 #if ($action.isPrintableVersion() == false)
 <style>
 .spacetree * ul{
 padding-left:0px;
 margin-left: 0px;
 }
 .spacetree * li{
 margin-left: 5px;
 padding-left:5px;
 } 
 
 </style>
 
 <table cellspacing="2" cellpadding="5">
 <tr>
 <td valign="top" align="left" width="22%" bgcolor="#F9F9F9" class="noprint">
 <div class="tabletitle">Table of Contents</div>
 <div class="spacetree">
 #includePage($helper.spaceKey "TreeNavigation")
 </div>
 </td>
 <td valign="top" align="left" width="78%" class="pagecontent">
 <div class="wiki-content">
 $body
 </div>
 </td>
 </tr>
 </table>
 #else
 <div class="wiki-content">
     $body
 </div>
 #end

"Save" 버튼을 눌러 변경 사항을 저장 한다.

참고 문헌
- Adding a Navigation Sidebar

JOSSO 적용

SSO (Single-Sign-On) 솔루션인 JOSSO를 적용 한다.

참고 문헌

Jira : [http://www.atlassian.com/ Atlassian]의 위키 솔루션
Gold Pitcher
JIRA, Confluence 설치 관련 문의

분류: 오픈소스
DevOps

최종 수정일: 2024-09-30 12:26:18