Atlassian

Atlassian Jira 설치 가이드: 단계별 쉬운 설치 방법

르헨리 ㅣ 2024. 1. 23. 17:31

반응형


오늘날 기업들이 프로젝트 관리와 이슈 트래킹을 더 효율적으로 관리하기 위해 Jira를 선택하는 이유는 무엇일까요? 
이 글에서는 Jira를 설치하고 설정하는 단계별 프로세스를 소개해드릴 것입니다. 
Atlassian Jira를 처음 접하는 분들도 쉽게 따라 할 수 있는 가이드를 제공해드리겠습니다.

Jira Software는 사용자 친화적인 인터페이스와 강력한 프로젝트 관리 기능을 제공하는 도구입니다. 

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

 

  • 이슈 및 프로젝트 관리
    • Jira를 사용하여 작업, 버그, 기능 요청 등 다양한 유형의 이슈를 관리하고 추적할 수 있습니다.
      각 이슈는 상태, 우선 순위, 담당자 등 다양한 필드로 관리됩니다.
  • 사용자 정의 워크플로우
    • 팀의 요구 사항에 맞게 워크플로우를 사용자 정의하여 프로세스를 관리할 수 있습니다.
      각 단계의 이슈 상태, 전환, 규칙을 설정할 수 있습니다.
  • 협업과 통합
    • Jira는 협업을 촉진하며, Confluence, Bitbucket, Slack 등 다른 Atlassian 제품 및
      제3자 도구와의 통합을 지원합니다.
  • 보고 및 대시보드
    • 진행 상황을 시각적으로 파악할 수 있는 대시보드와 다양한 보고서 기능을 제공합니다.
  • 애자일 지원
    • 스크럼 및 칸반 보드를 통해 애자일 프로젝트 관리를 지원합니다.
  • 확장성
    • 마켓플레이스를 통해 다양한 애드온과 통합 옵션을 제공하여 기능을 확장할 수 있습니다.

 

Jira는 이러한 기능을 통해 프로젝트 관리 및 이슈 추적의 효율성을 높이며,
팀의 생산성과 협업을 개선하는 데 도움을 줍니다.

 

다음 단계를 통해 설치를 시작해보세요.

0. 설치 환경

OS: Ubuntu 20.04.6 LTS
JDK: openJDK 11
Jira: 9.12.2 LTS
Database: PostgreSQL 14

 

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

Jira를 설치하기 전에, 시스템이 다음 요구사항을 충족하는지 확인하세요.

https://confluence.atlassian.com/adminjiraserver/jira-applications-installation-requirements-938846826.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을 주석 해제 후 localshot에서 *으로 변경합니다.

 

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

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

# Jira Server
host    jiradb          jiradbadmin     192.168.31.173/24       scram-sha-256
---

 

7) PostgreSQL DB 구성

sudo -u postgres psql		# psql 접속

CREATE USER jiradbadmin PASSWORD 'jiraadmin';

CREATE DATABASE jiradb WITH OWNER jiradbadmin ENCODING 'UTF-8';

GRANT ALL PRIVILEGES ON DATABASE jiradb TO jiradbadmin;

\q		# 종료 Exit

 

3. Jira 구성

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) Jira Software 9.12.2 LTS 설치 파일 Download

https://www.atlassian.com/software/jira/update

 

4) Jira Install

Submit 링크 주소 복사 후 Jira 디렉터리에 설치 파일 다운로드 후 설치 파일 실행

cd /root/jira/

wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-9.12.2-x64.bin
chmod a+x atlassian-jira-software-9.12.2-x64.bin

./atlassian-jira-software-9.12.2-x64.bin
---
We could not find fontconfig, which is required to use OpenJDK. Press [y, Enter] to install it.
For more info, see https://confluence.atlassian.com/x/PRCEOQ
[Enter]


This will install Jira Software 9.12.2 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 (use default settings) [1], Custom Install (recommended for advanced users) [2, Enter], Upgrade an existing Jira installation [3]
[1]


Details on where Jira Software will be installed and the settings that will be used.
Installation Directory: /opt/atlassian/jira
Home Directory: /var/atlassian/application-data/jira
HTTP Port: 8080
RMI Port: 8005
Install as service: Yes
Install [i, Enter], Exit [e]
[Enter]

Extracting files ...

/opt/atlassian/jira/bin/tcnative-1.dll

The file already exists.

Would you like Setup to overwrite it?
Yes [y], Yes to All [ya], No [n], No to All [na]
[ya]


Please wait a few moments while Jira Software is configured.

Start Jira Software 9.12.2 now?
Yes [y, Enter], No [n]
[Enter]
---

 

jira User 디렉터리 권한 할당

chown -R jira:jira /root/jira /opt/atlassian/jira/		# 소유권 변경

chmod -R u=rwx,go-rwx /root/jira /opt/atlassian/jira/		# 권한 부여

 

설치 전 jira-application.properties 수정

vim /opt/atlassian/jira/atlassian-jira/WEB-INF/classes/jira-application.properties
---
#jira.home = /var/atlassian/application-data/jira
jira.home = /root/jira/		# 추가
---

 

(선택) Server Port 및 Connect Port 변경

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

 

(선택) Jira Tomcat Context 변경

 

설치 스크립트 실행

bash /opt/atlassian/jira/bin/start-jira.sh
---
To run Jira in the foreground, start the server with start-jira.sh -fg
executing using dedicated user: jira

                  `sMMMMMMMMMMMMMM+
                     MMMMMMMMMMMMMM
                     :sdMMMMMMMMMMM
                             MMMMMM
          `sMMMMMMMMMMMMMM+  MMMMMM
             MMMMMMMMMMMMMM  +MMMMM
              :sMMMMMMMMMMM   MMMMM
                     MMMMMM    `UOJ
   `sMMMMMMMMMMMMM+  MMMMMM
     MMMMMMMMMMMMMM  +MMMMM
      :sdMMMMMMMMMM   MMMMM
             MMMMMM    `UOJ
             MMMMMM
             +MMMMM
              MMMMM
               `UOJ

      Atlassian Jira
      Version : 9.12.2


If you encounter issues starting or stopping Jira, please see the Troubleshooting guide at https://docs.atlassian.com/jira/jadm-docs-0912/Troubleshooting+installation


Server startup logs are located in /opt/atlassian/jira/logs/catalina.out
Using CATALINA_BASE:   /opt/atlassian/jira
Using CATALINA_HOME:   /opt/atlassian/jira
Using CATALINA_TMPDIR: /opt/atlassian/jira/temp
Using JRE_HOME:        /opt/atlassian/jira/jre/
Using CLASSPATH:       /opt/atlassian/jira/bin/bootstrap.jar:/opt/atlassian/jira/bin/tomcat-juli.jar
Using CATALINA_OPTS:
Using CATALINA_PID:    /opt/atlassian/jira/work/catalina.pid
Existing PID file found during start.
Removing/clearing stale PID file.
Tomcat started.
---

 

5) Jira 접속

http://<Server IP>:8080

 

Jira setup에서 I'll set it up myself 선택 후 Next

 

Database setup

 - My Own Database에서 Database 정보 기입하여, Test Connection을 통해 정상 연결 확인 후 Next

  • 1: PostgreSQL ServerIP
  • 2: Database Name
  • 3: Database user
  • 4: Database Password
public 스키마가 아닌 다른 스키마로 변경 시, 진행이 중단됩니다.

 

Set up application properties

 - 이 가이드에서는 기본 값으로 설정 후 Next

웹사이트의 접근 설정을 선택해 주십시오.
비공개로 설정할 경우 특정 사용자만 접근이 가능하며, 공개 설정 시 누구나 회원 가입이 가능합니다.
이 설정은 추후에 변경이 가능합니다.

 

Specify your license key

 - License Key 입력 후 Next

 

Set up administrator account

 - 관리자 계정 정보 기입 후 Next

 

Set up email notifications

 - Later 선택 후 Finish

이 가이드에서는 Jira에서 나중에 이메일 알림을 보낼 수 있도록 발신 메일 서버를 설정합니다.

 

Language

 - 언어 선택 후 Continue

 

아바타 설정 후 Next

 

설치완료

 

4. 마무리

Jira Software 설치 과정을 따라와 주셔서 감사합니다.

이제 여러분의 팀은 효율적인 프로젝트 관리와 협업을 위한 강력한 도구를 갖추게 되었습니다.

설치 과정 중 어려움이 있으셨다면, Atlassian 커뮤니티와 포럼을 활용해 보세요.

여러분의 소중한 프로젝트가 Jira를 통해 한 단계 더 성장하길 기대합니다.

앞으로도 Jira를 활용하여 프로젝트의 성공을 이끌어 가실 여러분에게 큰 응원을 보냅니다!

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

'Atlassian' 카테고리의 다른 글

Atlassian Confluence 설치: 초보자를 위한 완벽한 가이드  (0) 2024.01.22
Atlassian Crowd 설치 가이드: 단계별 쉬운 설치 방법  (0) 2024.01.14
Atlassian 다른글

티스토리툴바