...
| Section |
|---|
| 도구명 | Confluence Data Center |
|---|
| 버전 | 8.5.8 |
|---|
| OS | Linux(CentOs 7) |
|---|
| 비고 | PostgreSQL 13 Java 17 |
|---|
|
목차
...
0. 설치 전 준비
1) 호환 가능한 Java 버전과 데이터베이스 사전 설치
호환 가능 버전 확인 : confluence-supported-platforms
2) Confluence 용 데이터베이스 추가
해당 가이드문서에서는 PostgreSQL 13 버전을 예시로 제공합니다.
...
- 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) 설치 파일 실행
| 코드 블럭 |
|---|
| language | powershell |
|---|
| theme | Emacs |
|---|
|
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 |
2) Confluence의 매크로 한글 깨짐 방지
| 코드 블럭 |
|---|
|
# 폰트 다운로드
curl -o nanumfont.zip http://cdn.naver.com/naver/NanumFont/fontfiles/NanumFont_TTF_ALL.zip
# 압축 해제할 디렉토리 생성
mkdir -p /app/atlassian/confluence/jre/lib/fonts
# 압축 해제
unzip nanumfont.zip -d /app/atlassian/confluence/jre/lib/fonts
# 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}" // 추가 부분
#---------------------------------------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 분석 사용 안함 선택 후 저장
...