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

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

Confluence 다운로드

https://www.atlassian.com/software/confluence/download 에서 설치하려는 OS 에 맞는 설치본을 다운받는다. Standalone (TAR.GZ Archive) 를 다운받으면 된다.
적당한 폴더에 압축을 푼다.
```
tar zxvf atlassian-confluence-5.2.5
```
설치한 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
```
atlassian-confluence-5.2.5 폴더로 이동한후에 conf/server.xml 을 수정할 부분이 있으면 수정한다.
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

https://confluence.atlassian.com/confkb/mysqlsyntaxerrorexception-row-size-too-large-658735905.html

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

https://confluence.atlassian.com/doc/using-apache-with-mod_proxy-173669.html

# 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)

https://confluence.atlassian.com/confkb/how-to-use-nginx-to-proxy-requests-for-confluence-313459790.html

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

설치

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

같이 보기

Child pages

Contents

사전 준비

Confluence 다운로드

DBMS 설정

TOMCAT 설치

HTTP 서버와 연계

Apache httpd 설정

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

동시 편집 사용

설치

같이 보기

Child pages

confluence 설치 및 업그레이드

Contents

사전 준비

Confluence 다운로드

DBMS 설정

TOMCAT 설치

HTTP 서버와 연계

Apache httpd 설정

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

동시 편집 사용

설치

같이 보기