Child pages
  • confluence 설치 및 업그레이드

Contents


atlassian confluence 5.10 download 버전을 설치하는 절차를 설명한다. 대상 OS 는 RHEL 이나 CentOS 이다.

사전 준비 

  1. confluence에는 HSQL 이 내장되어 있어서 테스트 용이라면 별도의 DBMS 를 설치할 필요가 없지만 실제 운영 환경에서 구동할거라면 DBMS 설치를 해야한다. 지원하는 DBMS 목록은 Supported Platforms 을 참고한다. 개인적으로는 PostgreSQL 을 추천한다. (참고: CentOS 6 에 yum 으로 MySQL 5.5 설치)
  2. JRE 나 JDK 가 설치되어 있어야 하며 JDK 8 을 권장한다. 
    1. 리눅스 명령창에서 oracle jdk 다운받기(Downloading Java JDK on Linux Command Line)
    2. RHEL/CentOS 에서 Oracle JRE/JDK 를 설치하고 alternatives 조정
  3. 기본 설치 패키지에는 tomcat 8 이 내장되어 있다. 여타 이유로 기본 패키지로 설치하지 않고 WAR 로 구동할 거라면 미리 tomcat 8을 설치해두어야 한다.


현재 Windows, Linux, Mac OS X, Solaris(x86) 만 공식적으로 지원하며 Sparc Solaris 는 atlassian 에서 공식적으로 지원하지 않는다. Linux, Mac OS X, Windows 는 installer 를 제공하나 익숙해지면 standalone 이 더 편리하므로 standalone 기준으로 설명한다.

Confluence 다운로드

  1. https://www.atlassian.com/software/confluence/download 에서 설치하려는 OS 에 맞는 설치본을 다운받는다. Standalone (TAR.GZ Archive) 를 다운받으면 된다.
  2. 적당한 폴더에 압축을 푼다.

    tar zxvf atlassian-confluence-5.2.5

     

  3. 설치한 DBMS 용 JDBC 를 다운받아서 압축을 푼 후에 나온 jar 파일을 atlassian-confluence-xxxx 내의 lib 폴더에 복사한다. MySQL용 JDBC는 http://dev.mysql.com/downloads/connector/j/ 에서 다운받는다.

    cp mysql-connector-java-5.1.28-bin.jar atlassian-confluence-5.2.5/lib
  4. atlassian-confluence-5.2.5 폴더로 이동한후에 conf/server.xml 을 수정할 부분이 있으면 수정한다. 

  5. confluence/WEB-INF/classes/confluence-init.properties  파일을 에디터로 열어서 confluence.home의 절대경로를 설정해 준다. 해당 경로는 첨부파일 및 confluence 설정파일이 저장되는 곳이니 confluence 를 운영하게 되면 반드시 백업해줘야 한다.

    ## 설정예
    confluence.home=/var/atlassian/confluence

    symbolic link 폴더일 경우 실제 폴더의 절대 경로를 적어줘야 한다.


DBMS 설정

DBMS는 MySQL 5.6 을 권장(자세한 설치는 Database Setup For MySQL 참고)


confluence 를 구동할 계정 및 database를 생성한다. 

MySQL용 script
CREATE DATABASE confluence CHARACTER SET utf8 COLLATE utf8_bin;
GRANT ALL PRIVILEGES ON confluence.* TO 'confluenceuser'@'localhost' IDENTIFIED BY 'confluencepass';


my.cnf 에 다음 내용 추가

skip-character-set-client-handshake
collation-server=utf8_unicode_ci
character-set-server=utf8

max_allowed_packet = 512M
innodb_log_file_size=2GB


MySQL 재시작

my.cnf에 다음 내용이 있으면 삭제할 것


sql_mode = NO_AUTO_VALUE_ON_ZERO



TOMCAT 설치

톰캣 설정에 URIEncoding="UTF-8"  반드시 추가

conf/server.xml
<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
               connectionTimeout="20000"
               redirectPort="8443" URIEncoding="UTF-8"/>

apache 의 mod_proxy 나 nginx 를 앞에 두고 서비스하는 경우 다음과 같이 proxyName, proxyPort 를 지정해 주어야 정상적으로 서비스가 가능함.

conf/server.xml
<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" URIEncoding="UTF-8"
           proxyName="www.lesstif.com" proxyPort="443" scheme="https" secure="true"/>


HTTP 서버와 연계

Web Server 는 nginx 보다는 apache httpd 가 연계가 편리함.

Apache httpd  설정

# Put this after the other LoadModule directives
LoadModule proxy_module /usr/lib/apache2/modules/mod_proxy.so
LoadModule proxy_http_module /usr/lib/apache2/modules/mod_proxy_http.so
LoadModule proxy_wstunnel_module /usr/lib/apache2/modules/mod_proxy_wstunnel.so
LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so

# Put this in the main section of your configuration (or virtual host, if using Apache virtual hosts)
 
  ProxyRequests Off
  ProxyPreserveHost On
    
  RewriteEngine On
  RewriteCond %{REQUEST_URI} !^/synchrony
  RewriteRule ^/(.*) http://<domain>:8090/$1 [P]

  <Proxy *>
      Require all granted
  </Proxy>

  ProxyPass /synchrony http://<domain>:8091/synchrony

  <Location /synchrony>
      Require all granted
      RewriteEngine on
      RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
      RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
      RewriteRule .* ws://<domain>:8091%{REQUEST_URI} [P]
  </Location>

  ProxyPass / http://<domain>:8090
  ProxyPassReverse / http://<domain>:8090
   
  <Location />
      Require all granted
  </Location>


웹 서버를 reverse proxy 로 사용하고 HTTPS 로 서비스를 제공할 경우

conf/server.xml 의 HTTP Connector 에 다음과 같이 proxyName, proxyPort 를 추가해야 한다.

proxyName="wiki.example.com" proxyPort="443" scheme="https"


전체 설정

 <Service name="Tomcat-Standalone">
        <Connector port="8090" connectionTimeout="20000" redirectPort="8443"
                maxThreads="200" minSpareThreads="10"
                enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
                proxyName="wiki.example.com" proxyPort="443" scheme="https"
                protocol="org.apache.coyote.http11.Http11NioProtocol" />


 

동시 편집 사용

confluence 6부터 동시 편집 기능이 추가되어 별도의 context 설정 필요(/synchrony, 8091)


 Click here to expand...
 location /synchrony {
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:8091/synchrony;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
    }
	
    # confluence
    location / {
        proxy_pass http://127.0.0.1:11080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }


SELinux context 추가

semanage port -a -p tcp -t http_port_t 8091


설치

  1. 구동
  2. 설치 유형 선택
     
  3. Add On 선택
     
  4. 라이선스 입력
     
  5. DB 선택
     
  6. JDBC 
     
  7. 연결 정보 설정
     
  8. 스키마를 만드는데 시간이 꽤 걸림. 완료되면 샘플 사이트를 만들지 물어봄. 
     
  9. JIRA 와 계정을 연결할지 물어봄. JIRA 가 있을 경우 Connect to JIRA 클릭
     
  10. JIRA 연결 정보와 관리자 계정 입력
     
  11. 다음을 눌러서 설치 완료


같이 보기

Write a comment…