Atlassian

Atlassian Confluence 설치: 초보자를 위한 완벽한 가이드

르헨리 ㅣ 2024. 1. 22. 14:08

반응형

효율적인 팀 협업과 지식 관리를 위해 Atlassian Confluence를 선택하셨나요?

이 가이드는 Confluence 설치 과정을 단계별로 안내하며,
설치 과정을 간소화하여 누구나 쉽게 따라할 수 있도록 도와드립니다.

 

Atlassian Confluence는 팀 협업과 지식 관리를 위한 웹 기반 도구입니다.

주요 기능과 장점은 다음과 같습니다.

 

  • 문서 관리
    • 사용자들은 Confluence에서 문서를 생성, 편집, 공유할 수 있습니다. 이를 통해 지식 기반을 구축하고
      정보를 중앙화할 수 있습니다.
  • 팀 협업 강화
    • 페이지 및 공간의 댓글 기능, 멘션, 페이지 공유 등을 통해 팀원들 간의 소통과 협업을 촉진합니다.
  • 사용자 정의 가능
    • 사용자는 템플릿, 매크로, 테마 등을 통해 페이지를 맞춤 설정할 수 있습니다.
  • 통합과 확장성
    • Jira, Bitbucket 등 다른 Atlassian 제품 및 다양한 제3자 애플리케이션과의 통합을 지원합니다.

 

Confluence는 이러한 기능을 통해 조직의 효율성을 높이고, 문서화된 지식을 통해 의사결정을 강화하는 데 기여합니다.

0. 설치 환경

OS: Ubuntu 20.04.6 LTS
JDK: openJDK 11
Confluence: 8.5.5 LTS
Database: PostgreSQL 14

 

1. 필요한 시스템 요구사항 확인

시스템 요구사항을 먼저 확인하고, 서버가 Confluence 설치를 지원하는지 확인하세요.

https://confluence.atlassian.com/conf85/system-requirements-1283361318.html
https://confluence.atlassian.com/conf85/server-hardware-requirements-guide-1283361319.html

https://confluence.atlassian.com/conf85/supported-platforms-1283361429.html

 

2. PostgreSQL Install

1) 공식 PostgreSQL 저장소 추가

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

먼저, PostgreSQL의 공식 저장소를 시스템에 추가합니다. 이를 위해 터미널을 열고 다음 명령어를 실행합니다.

 

2) 저장소 키 추가

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

저장소의 공개 키를 추가하여 패키지의 무결성을 검증합니다. 다음 명령어를 사용하여 키를 추가하세요.

 

3) 패키지 목록 업데이트

sudo apt-get update

새로운 저장소를 추가한 후, 패키지 목록을 업데이트 합니다. 이를 위해 다음 명령어를 실행합니다.

 

4) PostgreSQL 14 설치

sudo apt-get install postgresql-14 -y

이제 PostgreSQL 14를 설치할 수 있습니다. 다음 명령어로 설치를 진행하세요.

 

이 단계들을 수행하면 Ubuntu 20.04 시스템에서 PostgreSQL 14를 성공적으로 설치할 수 있습니다.

설치 후에는 PostgreSQL 서비스를 시작하고, 필요한 설정을 진행하면 됩니다.

 

5) PostgreSQL 외부 접속 허용 설정

vim /etc/postgresql/14/main/postgresql.conf
---
# - Connection Settings -

listen_addresses = '*'			# 60 lines 'localhost -> *'
---

Listen_addresses을 주석 해제 후 localhost에서 * 으로 변경합니다.

 

6) Crowd 인스턴스에서 접근 허용할 정보 입력

vim /etc/postgresql/14/main/pg_hba.conf
---
# Database administrative login by Unix domain socket
#local   all             postgres                                peer
local   all             postgres                                scram-sha-256		# 추가

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
#local   all             all                                     peer
local   all             all                                     scram-sha-256		# 추가
# IPv4 local connections:
host    all             all             127.0.0.1/32            scram-sha-256
# IPv6 local connections:
host    all             all             ::1/128                 scram-sha-256
# Allow replication connections from localhost, by a user with the
# replication privilege.
#local   replication     all                                     peer
local   replication     all                                     scram-sha-256		# 추가
host    replication     all             127.0.0.1/32            scram-sha-256
host    replication     all             ::1/128                 scram-sha-256

# 추가
# Allow Instance
# Crowd Server
host    crowddb         crowddbadmin    192.168.31.171/24       scram-sha-256

# Confluence Server
host    confldb         confldbadmin    192.168.31.172/24       scram-sha-256
---

 

7) PostgreSQL DB 구성

sudo -u postgres psql		# psql 접속

CREATE USER confldbadmin PASSWORD 'confladmin';

CREATE DATABASE confldb WITH OWNER confldbadmin ENCODING 'UTF-8';

GRANT ALL PRIVILEGES ON DATABASE confldb TO confldbadmin;

\q		# 종료 Exit

 

3. Confluence 구성

1) OpenJDK 11 설치

apt install openjdk-11-jdk -y

 

2) JAVA_HOME 환경 변수 설정

OpenJDK 설치 위치를 확인합니다. (기본적으로 /usr/lib/jvm에 존재합니다.)

dpkg -L openjdk-11-jdk
---
/.
/usr
/usr/lib
/usr/lib/jvm
/usr/lib/jvm/java-11-openjdk-amd64
/usr/lib/jvm/java-11-openjdk-amd64/bin
/usr/lib/jvm/java-11-openjdk-amd64/bin/jconsole
/usr/lib/jvm/java-11-openjdk-amd64/include
/usr/lib/jvm/java-11-openjdk-amd64/include/jawt.h
/usr/lib/jvm/java-11-openjdk-amd64/include/linux
/usr/lib/jvm/java-11-openjdk-amd64/include/linux/jawt_md.h
/usr/lib/jvm/java-11-openjdk-amd64/man
/usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8
/usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1
/usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jconsole.1.gz
/usr/lib/jvm/java-11-openjdk-amd64/man/man1
/usr/lib/jvm/java-11-openjdk-amd64/man/man1/jconsole.1.gz
/usr/lib/jvm/openjdk-11
/usr/share
/usr/share/doc
/usr/share/doc/openjdk-11-jre-headless
/usr/share/doc/openjdk-11-jre-headless/test-amd64
/usr/share/doc/openjdk-11-jre-headless/test-amd64/check-hotspot-hotspot.log.gz
/usr/share/doc/openjdk-11-jre-headless/test-amd64/check-jaxp-hotspot.log.gz
/usr/share/doc/openjdk-11-jre-headless/test-amd64/check-jdk-hotspot.log.gz
/usr/share/doc/openjdk-11-jre-headless/test-amd64/check-langtools-hotspot.log.gz
/usr/share/doc/openjdk-11-jre-headless/test-amd64/failed_tests-hotspot.tar.gz
/usr/share/doc/openjdk-11-jre-headless/test-amd64/jtreg-summary-hotspot.log
/usr/share/doc/openjdk-11-jre-headless/test-amd64/jtreg_output-hotspot.log.gz
/usr/share/doc/openjdk-11-jre-headless/test-amd64/jtreport-hotspot.tar.gz
/usr/lib/jvm/openjdk-11/src.zip
/usr/share/doc/openjdk-11-jdk
---
echo "export JAVA_HOME='/usr/lib/jvm/java-11-openjdk-amd64'" >> ~/.bashrc

source ~/.bashrc

 

3) Confluence 8.5.5 LTS 설치 파일 Download

https://www.atlassian.com/software/confluence/download-archives

 

4) Confluence Install

Confluence 디렉터리에 다운받은 설치 파일 실행

chmod a+x atlassian-confluence-8.5.5-x64.bin

./atlassian-confluence-8.5.5-x64.bin
---
Starting Installer ...

This will install Confluence 8.5.5 on your computer.
OK [o, Enter], Cancel [c] 
<Enter>

Click Next to continue, or Cancel to exit Setup.

Choose the appropriate installation or upgrade option.
Please choose one of the following:
Express Install (uses default settings) [1],
Custom Install (recommended for advanced users) [2, Enter],
Upgrade an existing Confluence installation [3]
<1>

See where Confluence will be installed and the settings that will be used.
Installation Directory: /opt/atlassian/confluence
Home Directory: /var/atlassian/application-data/confluence
HTTP Port: 8090
RMI Port: 8000
Install as service: Yes
Install [i, Enter], Exit [e]
<Enter>

Please wait a few moments while we configure Confluence.

Start Confluence now?
Yes [y, Enter], No [n]
<Enter>

Please wait a few moments while Confluence starts up.
Launching Confluence ...

Your installation of Confluence 8.5.5 is now ready and can be accessed via
your browser.
Confluence 8.5.5 can be accessed at http://localhost:8090
SLF4J: No SLF4J providers were found.
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See https://www.slf4j.org/codes.html#noProviders for further details.
Finishing installation ...
---

 

Confluence User 디렉터리 권한 할당

chown -R confluence:confluence /opt/atlassian/confluence/ /root/confluence/ && \ 
chmod -R u=rwx,go-rwx /opt/atlassian/confluence/ /root/confluence/

 

설치 전 confluence-init.properties 수정

vim /opt/atlassian/confluence/confluence/WEB-INF/classes/confluence-init.properties
---
#confluence.home = /var/atlassian/application-data/confluence
confluence.home = /root/confluence/		# confluence dir 설정
---

 

(선택) Server Port 및 Connect Port 변경

vim /opt/atlassian/confluence/conf/server.xml

 

(선택) Confluence Tomcat Context 변경

 

설치 스크립트 실행

 bash /opt/atlassian/confluence/bin/start-confluence.sh

 

5) Confluence 접속

http://<Server IP>:8090

 

Set up Confluence에서 Production Installation 선택 후 Next

 

License Key 입력 후 Next

 

Deployment type은 Non-clusterd(single node)로 선택 후 Next

 

Set up your database에 기존 Database 정보 기입하여, Test Connection을 통해 정상 연결 확인 후 Next

  • 1: PostgreSQL Server IP
  • 2: Database Name
  • 3: Database user
  • 4: Database Password

 

Load Content

 - 이 가이드에서는 Example Site로 진행

Confluence 설정 경험에 따라 사용자가 선택할 수 있는 옵션을 설명합니다.

Confluence 구성 경험이 있는 경우: 'Empty Site' 옵션을 선택하십시오.
이 옵션은 기존의 Confluence 사용 경험이 있는 사용자들이 자신의 환경을 처음부터 구성할 수 있도록 합니다.

Confluence 구성 경험이 없는 경우: 'Example Site'를 선택하십시오.
이 옵션은 Confluence 초보자를 위해 예시 콘텐츠와 구조가 포함된 사이트를 제공하여,
Confluence 사용 방법을 보다 쉽게 이해할 수 있도록 도와줍니다.

 

Configure User Management

 - Manage users and groups within Confluence 선택

 

Configure System Administrator Account

 - 시스템 관리자 계정 정보 기입 후 Next

 

설치완료

 

 


4. 마무리

Atlassian Confluence 설치가 완료되었습니다.

이제 팀과 함께 문서를 작성하고, 지식을 공유하며, 협업을 시작할 수 있습니다.

설치 과정에서 궁금한 점이나 추가적인 지원이 필요하다면

언제든지 Atlassian 커뮤니티에 문의하거나 공식 문서를 참조하세요.

반응형
저작자표시 (새창열림)

'Atlassian' 카테고리의 다른 글

Atlassian Jira 설치 가이드: 단계별 쉬운 설치 방법  (0) 2024.01.23
Atlassian Crowd 설치 가이드: 단계별 쉬운 설치 방법  (0) 2024.01.14
Atlassian 다른글

티스토리툴바