이 문서는 Confluence Data Center 설치 가이드를 공유하기 위해 작성되었다.



도구명Confluence Data Center
버전8.5.8
OSLinux(CentOs 7)
비고

PostgreSQL 13

Java 17

목차


0. 설치 전 준비

1) 호환 가능한 Java 버전과 데이터베이스 사전 설치

호환 가능 버전 확인 : confluence-supported-platforms

2) Confluence 용 데이터베이스 추가

해당 가이드문서에서는 PostgreSQL 13 버전을 예시로 제공합니다.

1.  PostgreSQL 접속

sudo su postgres
psql

2. 계정 생성

CREATE USER confdbuser WITH PASSWORD 'confdbuser' SUPERUSER;

3. 데이터베이스 생성

CREATE DATABASE confdb WITH ENCODING 'UTF8' LC_COLLATE 'ko_KR.utf8' LC_CTYPE 'ko_KR.utf8' TEMPLATE template0;
CREATE DATABASE  confdb WITH OWNER confdbuser ENCODING 'UTF-8';
    • LC_COLLATE 'ko_KR.utf8 : 데이터 정렬을 한국어 (ko_KR)로 설정
    • LC_CTYPE 'ko_KR.utf8 : 문자 유형을 한국어로 설정

3) 방화벽 해제

sudo firewall-cmd --permanent --zone=public --add-port=8090/tcp
firewall-cmd --reload


1. Atlassian Confluence 설치

1) Atlassian Confluence 설치 파일 다운로드

wget https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-8.5.8-x64.bin

2) 설치 파일 실행

sh atlassian-confluence-8.5.8-x64.bin

3) install 및 data 디렉토리 경로 변경

포트 번호 변경 가능

4) 설치 완료 후 실행

/app/atlassian/confluence/bin/start-confluence.sh


2. Confluence 설정

1) 운영환경 설치 → 라이선스 키 발급받아서 입력

2) 데이터베이스 설정

3) Jira에 연결

4) 관리자 계정 생성

3. 설치 후 추가 설정

1) 서비스 자동 시작 설정

  • 서버 재부팅 시 Confluence 자동으로 실행되도록 서비스로 등록

  • 사전에 start-confluence.sh 로 실행했다면 stop-confluence.sh 중지시키고 수행

# /etc/systemd/system/confluence.service 파일 생성 및 편집
vi /etc/systemd/system/confluence.service
 
# 파일에 다음 코드 입력 후 저장
[Unit]
Description=Atlassian Confluence Server Service
After=network.target postgresql-13.service
   
[Service]
Type=forking
User=confluence
ExecStart=/app/atlassian/confluence/bin/start-confluence.sh
ExecStop=/app/atlassian/confluence/bin/stop-confluence.sh
   
[Install]
WantedBy=multi-user.target
 
# 서비스 등록 및 서비스로 confluence 실행
sudo systemctl enable confluence.service
sudo systemctl daemon-reload
sudo systemctl start confluence.service
sudo systemctl status confluence.service

image-2024-4-16_16-15-34.png

2) Confluence의 매크로 한글 깨짐 방지

  • 나눔폰트 추가하기 위해 NanumGothic.ttf 파일 준비
# 폰트 파일을 /usr/share/fonts/nanum 경로에 저장
sudo mkdir /usr/share/fonts/nanum
sudo mv {폰트파일 저장경로}NanumGothic.ttf /usr/share/fonts/nanum/
# 설치된 폰트 이름 확인
$ fc-list | grep nanum
> /usr/share/fonts/nanum/NanumGothic.ttf: 나눔고딕,NanumGothic:style=Regular

# JVM OPTS에 폰트 경로 추가
# 편집기 열기
vi /app/atlassian/confluence/bin/setenv.sh
 
# 다음 코드를 추가
CATALINA_OPTS="-Dconfluence.document.conversion.fontpath=/usr/share/fonts ${CATALINA_OPTS}"											// 추가 부분
CATALINA_OPTS="-Dconfluence.document.conversion.words.defaultfontname=NanumGothic ${CATALINA_OPTS}"                                 // 추가 부분
CATALINA_OPTS="-Dconfluence.document.conversion.slides.defaultfontname.regular=NanumGothic ${CATALINA_OPTS}"                        // 추가 부분
CATALINA_OPTS="-Dconfluence.document.conversion.slides.defaultfontname.asian=NanumGothic ${CATALINA_OPTS}"                          // 추가 부분
CATALINA_OPTS="-Dconfluence.document.conversion.slides.defaultfontname.symbol=NanumGothic ${CATALINA_OPTS}"                         // 추가 부분
CATALINA_OPTS="-Dfile.encoding=utf-8 ${CATALINA_OPTS}"              																// Jira 이슈 매크로 한글 깨짐 방지
#---------------------------------------export CATALINA_OPTS 위에 추가--------------------------
export CATALINA_OPTS

3) Tomcat JVM OPT의 Heap Memory 수정

# 편집기 열기
vi /app/atlassian/confluence/bin/setenv.sh
 
# 다음 코드 수정
CATALINA_OPTS="-Xms8g -Xmx8g -XX:+UseG1GC ${CATALINA_OPTS}"                 // -Xms1024m -Xmx1024m 를 -Xms8g -Xmx8g로 수정하고 저장

4) Tomcat Max Thread 수정

# 편집기 열기
vi /app/atlassian/confluence/conf/server.xml
 
# 다음 코드 수정
<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
           maxThreads="240" minSpareThreads="10"                            // maxThreads="240"으로 수정
           enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
           protocol="org.apache.coyote.http11.Http11NioProtocol"/>

5) DB Connection Pool 수정

# 편집기 열기
vi /data/atlassian/confluence-home/confluence.cfg.xml

# 다음 코드 수정
<property name="hibernate.hikari.maximumPoolSize">200</property>

6) Session 설정

  • 동일한 서버에 각각 제품을 동시에 접근 시 한쪽에서 다른 제품 접근 시 자동 로그아웃 되는 현상을 방지
# 편집기 열기
vi /app/atlassian/confluence/conf/context.xml
 
<Context sessionCookieName ="CONFLUENCESESSIONID">       // <Context>를 <Context sessionCookieName ="CONFLUENCESESSIONID"> 로 변경 후 저장
.
.
</Context>

7) 설치 후 Port 변경 시

# server.xml 파일 편집기 열기
vi /app/atlassian/confluence/atlassian-confluence-8.5.8/conf/server.xml
 
# 다음 코드에서 port="8090"에서 포트 번호 변경 (기본값:8090)
        <Connector port="8090" connectionTimeout="20000" redirectPort="8443"
                   maxThreads="240" maxPostSize="16777216" minSpareThreads="10"
                   enableLookups="false" acceptCount="10" URIEncoding="UTF-8"
                   protocol="org.apache.coyote.http11.Http11NioProtocol"/>

8) PDF 내보내기 폰트 추가

톱니바퀴 → 일반 환경 설정 → PDF 내보내기 언어 지원 → 파일 선택 → 나눔고딕 폰트(NanumGothic.ttf) 열기 → Install

9) 통계 비활성화 설정

톱니바퀴 → 일반 환경 설정 → 통계 → Atlassian 분석 사용 안함 선택 후 저장