Confluence Data Center 설치

Owned by 이병욱
Last updated: 2021-05-10
3 min read

본 설치 가이드는 Confluence 7.8.1 기준으로 작성 되었습니다.

사전 준비

  1. NFS 설정 - NFS 설정 참조

  2. Apache2 Load Balancer 설정

$ cd /etc/apach2/sites-available $ sudo a2enmod headers proxy_balancer proxy_http proxy lbmethod_byrequests slotmem_shm ## 모듈 활성화 $ vi dcconfluence.twoseed.co.kr.conf ## 원하는 이름으로 .conf 파일 생성 ============================== # 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) <VirtualHost *:80> ServerName dcconfluence.twoseed.co.kr ProxyRequests Off ProxyPreserveHost On RewriteEngine On # RewriteRule ^/login.action?$ http://login.twoseed.co.kr:8280/login?%{QUERY_STRING} [NE,R=301] RewriteCond %{REQUEST_URI} !^/synchrony RewriteRule ^/(.*) http://14.36.48.220:7190/$1 [P] <Proxy *> Require all granted </Proxy> ProxyPass /synchrony http://14.36.48.220:7091/synchrony <Location /synchrony> Require all granted RewriteEngine on RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC] RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC] RewriteRule .* ws://14.36.48.220:7091%{REQUEST_URI} [P] </Location> ProxyPass / http://14.36.48.220:7190 ProxyPassReverse / http://14.36.48.220:7190 <Location /> Require all granted </Location> </VirtualHost> ============================== $ sudo a2ensite dcconfluence.twoseed.co.kr.conf ## 사이트 활성화 $ sudo service apache2 reload ## apache 서버 다시 시작

 

요구 사항

Confluence 데이터 센터를 사용하려면 :

  • 데이터 센터 라이선스 보유(데이터 센터 라이센스를 구입하거나 my.atlassian.com에서 평가 라이센스 생성 가능)

  • 지원되는 외부 데이터베이스, 운영 체제 및 Java 버전 사용

  • 다른 Atlassian 제품(예: Jira)에 대한 응용 프로그램 링크가 있는 경우 OAuth 인증 사용

클러스터에서 데이터 센터를 사용하려면 :

  • Confluence 클러스터 앞에 세션 연결성 및 Web Socket 이 지원되는 로드 밸런서 사용

  • 동일한 경로에 있는 모든 클러스터 노드에서 액세스할 수 있는 공유 디렉토리(공유 홈 디렉토리). 이 디렉토리는 별도의 디렉토리여야 하며, 로컬 홈 또는 설치 디렉토리 내에 위치해서는 안 된다.

1. 첫 번째 노드에 Confluence를 설치

  • 노드 1에 Confluence 설치

  • 기본 Confluence 설정과 비슷하나 라이선스 키 입력 화면에서 Data center 용 라이선스 입력

이름

설명

이름

설명

Cluster name

구성할 클러스터 이름

Shared home directory

공유 홈 디렉토리의 경로

Network interface

노드 간 통신에 사용

join configuration

  • Multicast : 자신의 멀티 캐스트 주소 입력하거나 자동으로 생성

  • TCP / IP : 각 클러스터 노드의 IP 주소 입력

  • AWS : IAM 역할 또는 비밀 키 및 리전 입력

Cluster Member IPs

클러스터 구성원의 쉼표로 구분 된 IP 주소 목록

Cluster Member IPs 추가 구성

vi <Confleunce home directory>/confluence.cfg.xml ... #추가할 Node ip 입력 <property name="confluence.cluster.peers"><node 1 ip>,<추가할 node ip></property>

2. Confluence를 두번째 노드로 복사

  • 노드 1에서 Confluence 종료

  • 설치 디렉토리를 노드 1에서 노드 2로 복사

  • 로컬 홈 디렉토리를 노드 1에서 노드 2로 복사

3. 클러스터링 구성 확인

  • 한 번에 한 노드 씩 Confluence를 시작

    • 노드 1에서 Confluence 시작

    • 노드 1에서 Confluence가 사용 가능할 때까지 대기

    • 노드 2에서 Confluence 시작

    • 노드 2에서 Confluence가 사용 가능할 때까지 대기

  • 클러스터 모니터링 콘솔 ( 설정  > 일반 구성 > 클러스터링 ) → 활성 클러스터에 대한 정보가 표시. 클러스터가 제대로 실행되면 이 페이지에는 시스템 사용량 및 가동 시간을 포함한 각 노드의 세부 정보가 표시된다.

4. 에러 대처

Starting Confluence node fails with 'Port [5801] is already in use and auto-increment is disabled. Hazelcast cannot start' error 에러가 발생할 시 대처

$ vi /<Install Directory>/bin/setenv.sh ... # 추가 CATALINA_OPTS="-Dconfluence.cluster.hazelcast.listenPort=5851 ${CATALINA_OPTS}"