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


설치 가이드



설치전 사전 준비 사항

  • [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 설정

{{MySQL DB 설정|Confluence|confluencedb|confluence}}


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/](http://localhost/confluence/)를 사용하여 설치를 시작한다.
- 화면에서 Server ID를 복사하여 둔다.
![설치 시작](img/Confluence_install_01.png)

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


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


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


- MySQL을 선택한 후 "External Database >>" 버튼을 선택 한다.
![DB 선택](img/Confluence_install_02.png)

- "Direct JDBC >>" 버튼을 선택 한다.
![DB 직접 접속](img/Confluence_install_03.png)

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

- "Example Site >>" 버튼을 선택하여 샘플 데이터가 등록되도록 한다.
![Example](img/Confluence_install_05.png)

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

- [http://localhost/confluence/](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"|컨텐츠 레이아웃 - 공간, 페이지, 메일, 블로그 포스트, 댓글, Comments | /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 ```


하나의 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

```


JOSSO 적용

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


참고 문헌


공유하기