Contents
atlassian confluence 5.10 download 버전을 설치하는 절차를 설명한다. 대상 OS 는 RHEL 이나 CentOS 이다.
사전 준비
- confluence에는 HSQL 이 내장되어 있어서 테스트 용이라면 별도의 DBMS 를 설치할 필요가 없지만 실제 운영 환경에서 구동할거라면 DBMS 설치를 해야한다. 지원하는 DBMS 목록은 Supported Platforms 을 참고한다. 개인적으로는 PostgreSQL 을 추천한다. (참고: CentOS 6 에 yum 으로 MySQL 5.5 설치)
- JRE 나 JDK 가 설치되어 있어야 하며 JDK 8 을 권장한다.
- 기본 설치 패키지에는 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를 생성한다.
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" 반드시 추가
<Connector port="8090" connectionTimeout="20000" redirectPort="8443" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8"/>
apache 의 mod_proxy 나 nginx 를 앞에 두고 서비스하는 경우 다음과 같이 proxyName, proxyPort 를 지정해 주어야 정상적으로 서비스가 가능함.
<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)
SELinux context 추가
semanage port -a -p tcp -t http_port_t 8091
설치
- 구동
- 설치 유형 선택
- Add On 선택
- 라이선스 입력
- DB 선택
- JDBC
- 연결 정보 설정
- 스키마를 만드는데 시간이 꽤 걸림. 완료되면 샘플 사이트를 만들지 물어봄.
- JIRA 와 계정을 연결할지 물어봄. JIRA 가 있을 경우 Connect to JIRA 클릭
- JIRA 연결 정보와 관리자 계정 입력
- 다음을 눌러서 설치 완료
Add Comment