Jira 데이터 센터 업그레이드 (Installer)

시작하기 전에

1단계: 초기 설치 방법을 결정하기 위해 Jira 홈 디렉터리 검색

Jira를 처음 설치하는 데 사용한 것과 동일한 방법을 사용하여 업그레이드하는 것이 좋습니다. 어떤 방법인지 확실하지 않은 경우 Jira 홈 디렉터리의 위치를 찾으세요. 이 위치는 일반적으로 Jira가 수동으로 설치되었는지 또는 바이너리 설치 관리자를 통해 설치되었는지를 나타내는 좋은 지표가 됩니다.

2단계: 업그레이드 준비

업그레이드 준비하기의 단계를 완료했는지 확인하세요. 이는 필수 사전 요구 사항이며 원활한 업그레이드를 위해 필수적입니다.

업그레이드 노트 검토

모든 Jira 릴리스에는 알려진 문제, 업그레이드와 관련된 중요 사항 또는 완료해야 하는 추가 단계가 포함될 수 있는 업그레이드 노트가 게시됩니다. 업그레이드 매트릭스에 모든 업그레이드 노트가 요약되어 있으므로 업그레이드를 위해 추가 변경이 필요한지 빠르게 확인할 수 있습니다.

상태 검사 실행

Jira에는 Jira 인스턴스가 업그레이드할 준비가 되었는지 확인할 수 있는 몇 가지 상태 검사가 있습니다. 

1. 화면 오른쪽 상단에서 관리 > 시스템을 선택

2. 시스템 지원(왼쪽 패널)에서 문제 해결 및 지원 도구를 선택

3. 모든 인스턴스 상태 검사 결과를 확인합니다. 모든 상태 검사에는 검사에 대한 간략한 설명과 자세한 정보가 포함된 문서 링크가 제공되므로 발견된 문제를 해결하는 방법을 알 수 있습니다.

4. 라이선스 및 데이터베이스와 관련된 검사에서 문제가 보고되지 않았는지 확인하되, 다른 감지된 문제도 수정할 수 있습니다.

앱(add-ons)의 호환성 확인

앱이 새 버전과 호환되는지 확인하여 업그레이드 후에도 계속 작동할 수 있도록 하세요. 호환되지 않는 앱은 업그레이드에 영향을 줄 수 있으므로 모두 비활성화해야 합니다:

1. 화면 오른쪽 상단에서 관리 > 앱 관리를 선택

2. JIRA 업데이트 확인을 선택

3. 업그레이드하려는 버전을 선택하고 확인을 선택

4. 앱의 호환성 결과에 따라 아래에 설명된 작업을 적용

사용자 정 수정이 있는 파일 목록 가져오기

Jira를 사용자 정의하기 위해 파일을 수정했나요? 이러한 변경 사항을 유지하려면 어떤 파일이 수정되었는지 알아야 합니다.

• 최신 버전의 ASTS 플러그인을 사용하는 경우 관리 > 애플리케이션 > 업그레이드 계획으로 이동하여 사용자 정의 변경 사항을 도입한 파일 목록을 확인하세요. 업그레이드된 인스턴스에서 이러한 변경 사항을 유지하려면 업그레이드하는 동안 전체 파일이 아닌 변경 사항을 각 파일에 복사해야 합니다. 이 목록을 잘 정리해 두면 업그레이드 과정에서 시간을 절약할 수 있습니다. 

• 업그레이드 계획 페이지를 불러올 수 없는 경우 수정한 파일 목록을 컴파일하세요.

Jira 인스턴스 백업

Jira 데이터베이스 및 중요한 디렉터리를 백업하여 문제가 발생하는 경우 이전 설정으로 안전하게 롤백할 수 있습니다.

Database

데이터베이스 기본 도구를 사용하여 백업을 만드세요.  데이터베이스가 온라인 백업을 지원하지 않는 경우 먼저 Jira를 중지해야 합니다.

Jira 디렉터리

Jira 디렉터리를 다른 위치에 복사하여 백업하세요.

이러한 모든 디렉터리의 위치를 확인하려면:

1. 화면 오른쪽 상단에서 관리 > 시스템

2. 시스템 지원(왼쪽 패널)에서 시스템 정보를 선택하고 파일 경로 섹션까지 아래로 스크롤

• 클러스터 모든 노드에서 Jira 설치 디렉터리 백업

• 클러스터 모든 노드에서 Jira 홈 디렉터리 백업

• 클러스터 공유 디렉터리 백업

3단계: 버전 선택

적합한 버전을 선택하는 데 도움이 필요한 경우 업그레이드 매트릭스로 이동하여 모든 Jira 버전에 대한 기능, 지원되는 플랫폼 및 기술 업그레이드 노트에 대한 간략한 요약을 확인하세요.

4단계: 클러스터 중지

클러스터의 모든 노드에서 Jira를 중지합니다. 또한 모든 노드에서 업그레이드가 완료될 때까지 트래픽을 Jira에서 다른 곳으로 리디렉션하도록 로드 밸런서를 구성하는 것이 좋습니다.

첫 번째 노드에서 Jira 업그레이드

각 노드를 개별적으로 업그레이드하지 않으려면 노드 중 하나만 업그레이드하고 해당 설치 디렉터리를 템플릿으로 만들면 됩니다. 그런 다음 이 템플릿을 나머지 노드에 복사합니다.

1단계: Jira 다운로드

웹 사이트에서 Jira 애플리케이션 중 하나를 다운로드합니다. Windows 또는 Linux 바이너리를 선택합니다.

• Jira Software

• Jira Service Management

2단계: 설치 마법사 시작

설치 마법사가 업그레이드 프로세스를 안내합니다.

1. 다운로드한 설치 프로그램을 실행합니다.

   1. Jira를 다운로드한 디렉터리로 변경한 다음 다음 명령을 실행하여 설치 프로그램을 실행합니다:

      chmod a+x atlassian-jira-X.X.X-x64.bin

      여기서 X.X.X는 다운로드한 Jira 버전입니다.

   2. 설치 관리자 실행 - sudo를 사용하여 설치 관리자를 실행하는 것이 좋습니다:

      sudo ./atlassian-jira-X.X.X-x64.bin

      루트 사용자 권한으로 설치 프로그램을 실행하도록 선택할 수도 있습니다.

2. 설치 마법사의 지시를 따릅니다:

   1. 메시지가 표시되면 Upgrade an existing Jira installation를 선택합니다.

   2. 마법사가 제안하는 기존 Jira 설치 디렉터리가 올바른지 확인합니다
      (동일한 컴퓨터에 여러 개의 Jira를 설치한 경우 특히 중요).

   3. 이미 Jira 홈 디렉터리를 백업한 경우, 추가 백업을 만들지 않도록 Jira 홈 디렉터리 백업 확인란의 선택을 취소합니다.

   4. 마법사는 Jira 설치 디렉터리에 있는 사용자 정의 수정된 파일에 대해 알려줍니다. 나중에 다시 적용해야 하므로 이러한 리스트를 따로 메모해 두세요.

      현재 사용자 정의 수정된 파일은 덮어쓰게 되지만 나중에 백업에서 복사할 수 있습니다.

3. 마지막 화면에서 업그레이드 마법사는 Jira 인스턴스를 시작하고 업그레이드를 완료하라는 메시지를 표시합니다. 이 단계에서 중지하고 이 페이지의 나머지 단계(처음으로 Jira 시작까지)를 완료하는 것이 좋습니다.

3단계: 데이터베이스 드라이버 설치

Oracle 또는 MySQL 데이터베이스를 사용하는 경우 새 JDBC 드라이버를 다운로드합니다. 다른 데이터베이스의 경우 이 단계를 생략할 수 있습니다.

1. 다음 드라이버 중 하나를 다운로드합니다:

   • Oracle: JDBC driver 19.3 (ojdbc8)

   • MySQL: MySQL Connector/J 5.1 driver.

2. <installation-directory>/lib에 설치합니다.

4단계: 수정 사항 다시 적용 및 풀 최대 크기 늘리기

Jira를 사용하는 동안 Jira 파일에 몇 가지 사용자 지정 수정 사항을 추가했을 것입니다. 여기에는 연결 세부 정보, 메모리 할당과 관련된 설정 또는 기타 JVM 인수가 포함될 수 있습니다. 이 단계에서는 백업에서 파일을 복사하여 새 파일에 동일한 수정 사항을 다시 적용해야 합니다.

마이그레이션된 수정 사항

업그레이드하는 동안 마법사는 기존 Jira 설치에서 다음을 마이그레이션했습니다:

• server.xml 파일의 TCP 값.

• jira-application.properties 파일에서 Jira 홈 디렉터리의 위치.

• setenv.sh / setenv.bat 파일의 다음 값:

  • JVM_SUPPORT_RECOMMENDED_ARGS

  • JVM_MINIMUM_MEMORY

  • JVM_MAXIMUM_MEMORY

  • JIRA_MAX_PERM_SIZE 

기타 수정 사항

위와 별도로 다른 모든 수정 사항을 다시 적용해야 합니다. 다음은 가장 중요한 파일입니다:

• server.xml

• dbconfig.xml

• jira-config.properties

• web.xml

• setenv.sh / setenv.bat (메모리 할당 및 기타 JVM 인수)

풀 최대 크기

Jira 7.x에서 Jira 8.x로 업그레이드하는 경우 업그레이드하기 전에 dbconfig.xml에서 pool-max-size매개 변수를 40으로 변경하는 것이 좋습니다. 기본값인 20을 그대로 두면 8.x에서 다시 인덱싱하는 동안 "ResultSet Closed" 오류가 발생할 수 있습니다.

5단계: 자동 재색인 비활성화

8.x와 9.x Jira 플랫폼 버전 간에 도입된 인덱싱 변경 사항으로 인해 이전 Jira 버전의 인덱스는 업그레이드 후 호환되지 않습니다.
새 인덱스를 만들려면 애플리케이션을 시작한 직후 Jira에서 자동 재인덱스를 트리거합니다. 두 번 색인을 생성하지 않으려면(시작 후 및 앱 업그레이드 후), 자동 재색인을 비활성화한 다음 나중에 준비가 되면 언제든지 두 번째 색인을 실행할 수 있습니다.

자동 재인덱스를 비활성화하려면 다음과 같이 하세요:

1. 다음 파일을 편집하거나 생성(없는 경우)합니다:

   <jira-home-directory>/jira-config.properties

2. 파일에 다음 줄을 추가한 다음 변경 내용을 저장합니다:

   upgrade.reindex.allowed=false

첫 번째 노드에서 업그레이드 후 단계

이 업그레이드 후 단계는 첫 번째 노드(방금 업그레이드한 노드)에서만 완료하세요. 나머지 노드는 나중에 공유 디렉토리에서 업그레이드된 앱과 인덱스를 다운로드합니다.

1단계: 처음으로 Jira 시작

새 Jira 버전을 시작하고 데이터베이스에 연결합니다.

1. (Installer) 업그레이드 마법사로 돌아가서 Jira를 시작합니다.
   (Installer and Manual) <설치 디렉터리>/bin으로 이동하여 다음 파일 중 하나를 실행하여 Jira를 시작할 수도 있습니다:

   • Windows:  start-jira.bat

   • Linux:  start-jira.sh 

2. 브라우저에서 Jira를 엽니다.

3. 화면의 지시에 따라 설정을 완료합니다.

4. 복사하지 않은 사용자 지정 변경 사항이 있는 파일을 놓친 경우 지금 자동으로 변경 사항을 복사할 수 있습니다.

   파일 변경 사항 확인은 다음 구성 파일에 대해서만 실행된다는 점에 유의하세요:

   - atlassian-jira/ directory
   - conf/server.xml
   - bin/setenv.sh

   그리고 자동 전송은 ATST 플러그인 1.20.0 이상에서만 지원됩니다.

변경 사항이 복사된 후 Jira를 다시 시작하라는 메시지가 표시됩니다.

2단계: (선택 사항) Jira Service Management 업데이트하기

Jira Service Management를 사용하는 경우 별도의 설치 프로그램을 다운로드하지 않고 UI에서 바로 업데이트할 수 있습니다.

1. Administration > Applications > Versions and licenses로 이동

2. Jira Service Management를 업데이트합니다. 그러면 Jira Service Management가 호환되는 버전으로 자동으로 업데이트됩니다.

3단계: 앱(add-ons) 업그레이드

이제 둘 다 업데이트되면 호환 가능이었던 앱을 업그레이드할 수 있습니다.

1. Administration > Manage apps > Manage apps로 이동

2. 지원되는 버전으로 앱을 업그레이드합니다.

3. 앱이 업그레이드되면 앱을 사용 설정할 수 있습니다.

4단계: 인덱스 다시 빌드

Jira를 다시 색인화하여 인덱스를 다시 만듭니다. 이 단계는 보유한 이슈 및 앱의 수에 따라 시간이 다소 걸릴 수 있습니다.

1. Administration > Indexing으로 이동하여 Lock Jira and rebuild reindex를 실행합니다.

5단계: 업그레이드된 Jira를 템플릿으로 복사

이 단계에서는 지금까지 수행한 모든 수정 사항이 포함된 새 설치 디렉터리를 복사합니다. 이렇게 하면 나중에 다른 노드에 복사할 수 있는 템플릿이 생성됩니다.

1. 새 설치 디렉터리를 다른 위치에 복사합니다. 이것이 템플릿이 됩니다.

나머지 노드 업그레이드

이제 준비된 Jira 템플릿과 업그레이드된 애드온 및 인덱스 데이터를 공유 디렉터리에서 사용할 수 있을 것입니다. 이 단계에서는 템플릿을 다른 노드에 복사하고 하나씩 시작하겠습니다.

1. 템플릿 설치 디렉터리를 새 노드에 복사합니다.

2. 이 노드에서 로컬 홈 디렉터리의 경로가 다른 경우 setenv.bat/setenv.sh 파일에서 경로를 업데이트합니다.

3. Jira를 시작합니다.

4. 반복: 다음 노드에서 이 단계를 반복합니다.