Upgrading JIRA applications using a rapid upgrade method

원문 : https://confluence.atlassian.com/adminjiraserver073/upgrading-jira-applications-using-a-rapid-upgrade-method-861253101.html

1. 사용자 정의 확인

빠른 업그레이드 방법을 사용하면 설치 프로그램이 자동으로 많은 업그레이드 작업을 수행 할 수 있습니다. 그러나 JIRA 애플리케이션 설치를 사용자 정의한 경우, 사용자 화 된 파일을 수동으로 업그레이드 된 설치로 마이그레이션해야합니다. 설치 프로그램이 자동으로 확인하고 마이그레이션합니다.

애플리케이션 서버 내의 데이터 소스 (JIRA 4.3.x 및 이전 버전에서 사용됨)에서 JIRA 플랫폼 버전 4.4 이상에서 사용되는 새로운 데이터베이스 구성으로 정의 된 레거시 데이터베이스 구성. 자세한 내용은 JIRA 4.4 업그레이드 노트 를 참조하십시오.
기존 JIRA 애플리케이션 설치 server.xml파일 의 TCP 포트 값 . 이 파일의 다른 구성 또는 사용자 정의는 이주되지 않습니다.
기존 JIRA 애플리케이션 설치 jira-application.properties및 setenv.sh/ setenv.bat파일 의 사용자 정의 값 .
에서 setenv.sh/의 setenv.bat파일 만 다음과 같은 값이 마이그레이션됩니다 :
- JVM_SUPPORT_RECOMMENDED_ARGS
- JVM_MINIMUM_MEMORY
- JVM_MAXIMUM_MEMORY
- JIRA_MAX_PERM_SIZE
JIRA가 Windows에서 서비스로 실행 중일 때 서비스에 대해 구성된 Java 시작 옵션 ( 시작시 속성 및 옵션 설정 - Windows 서비스에서 설명 )은 기본값으로 재설정됩니다. 메모리 할당 설정을 변경했거나 기본 이외의 매개 변수를 추가 한 경우 업그레이드를 진행하기 전에 해당 정보를 저장하십시오. 수동으로 저장하지 않으면이 설정이 손실됩니다.

업그레이드 과정에서 설치 프로그램 은 '기본'JIRA 응용 프로그램 설치에서 삭제, 추가 또는 수정 된 기존 JIRA 응용 프로그램 설치 디렉토리 의 하위 디렉토리 에있는 파일 ( jira-application.properties및 setenv.sh/는 setenv.bat제외)을 감지하고 통지 합니다. 업그레이드 마법사가 처리하지 않는 JIRA 애플리케이션 설치 디렉토리 의 파일 또는 기타 파일 사용자 정의를 사용자 정의한 경우,이를 업그레이드 된 JIRA 애플리케이션 설치로 수동으로 마이그레이션해야합니다.atlassian-jira seraph-config.xml

또한 업그레이드 기능은 기존 JIRA 애플리케이션 홈 디렉토리를 재사용 하므로 이전 JIRA 애플리케이션 설치에서이 디렉토리에 저장된 주요 데이터는 JIRA 애플리케이션 업그레이드 후에도 유지됩니다.

참고 사항 :

업그레이드 프로세스는 데이터베이스 백업 유틸리티를 사용하여 데이터베이스 백업을 수행하도록 요청합니다. 데이터베이스가 온라인 백업을 지원하지 않으면 업그레이드 프로세스를 중지하고 JIRA 애플리케이션을 종료하고 데이터베이스 백업을 수행 한 다음 업그레이드 프로세스를 다시 시작하여 계속 진행할 수 있습니다.
설치 프로그램은 기존 JIRA 애플리케이션 설치의 설치 및 홈 디렉토리를 자동으로 백업합니다. 첨부 파일과 인덱스 파일이 JIRA 어플리케이션 홈 디렉토리 밖에있을 경우,이 파일들을 수동으로 백업해야합니다. 이 페이지에서는 사용자 환경에서이 디렉토리의 위치를 확인하는 방법에 대해 설명합니다.
- 첨부 파일 디렉토리 - JIRA 어플리케이션 버전의 첨부 파일 구성 페이지를 참조하십시오 .
- 색인 디렉토리 - JIRA 응용 프로그램 버전에 대한 색인 색인 생성 페이지를 참조하십시오 .

2. 외부 데이터베이스 백업

업그레이드 마법사를 시작한 후 업그레이드를 시작하기 전에 외부 데이터베이스를 백업하라는 메시지가 표시됩니다. 데이터베이스의 기본 백업 도구를 사용하여 데이터베이스를 백업 할 수 있지만 다음 사항에 유의하십시오.

데이터베이스의 네이티브 백업 툴이 온라인 백업 (즉, 데이터베이스가 여전히 사용되는 동안 JIRA 애플리케이션 데이터베이스의 "스냅 샷"을 생성하는 백업)을 지원하는 경우, 데이터베이스 백업을 수행하는 동안 업그레이드 마법사를 실행 한 채로두고 계속할 수 있습니다 데이터베이스 백업이 올바르게 작성되었는지 검증 한 후 마} 사를 사용하십시오.
데이터베이스의 기본 백업 도구로 JIRA 애플리케이션 데이터베이스의 온라인 백업을 수행 할 수없는 경우 다음을 수행해야합니다.
1. 데이터베이스를 백업하라는 메시지가 나타나면 업그레이드 마법사를 종료하십시오.
2. JIRA 애플리케이션에 대한 액세스를 일시적으로 제한하여 사용자가 기존 JIRA 애플리케이션 데이터를 업데이트하지 못하게하여 (데이터베이스 백업의 구조적 일관성 보장). 자세한 정보는 백업 중에 사용자가 JIRA 애플리케이션에 액세스하지 못하도록 방지 페이지를 참조하십시오.
3. 데이터베이스의 기본 백업 툴을 사용하여 JIRA 애플리케이션 데이터베이스의 "오프라인 백업"을 수행하고이 백업이 올바르게 생성되었는지 확인하십시오.
4. Linux / Windows Installer를 다시 시작하여 업그레이드 마법사를 다시 시작하고 중단 한 부분부터 계속하십시오.
JIRA 응용 프로그램 '내부'데이터베이스는 H2이며 JIRA 응용 프로그램 만 평가할 때 사용해야합니다. 프로덕션 시스템에 실수로 H2 데이터베이스를 사용하는 경우, 백업에 관한 메시지가 나타나면 업그레이드 마법사를 종료하고 JIRA 응용 프로그램을 다른 서버로 마이그레이션 절차를 사용하여 JIRA 응용 프로그램을 업그레이드하십시오.

일치하지 않는 데이터베이스 백업이 올바르게 복원되지 않을 수 있습니다! 데이터베이스의 기본 백업 / 복원 기능에 익숙하지 않은 경우 계속하기 전에 다음을 수행하여 데이터베이스 백업의 무결성을 테스트하십시오.

다른 (테스트) 시스템으로 데이터베이스 백업 복원 및
현재 JIRA 애플리케이션 버전의 테스트 인스턴스를이 복원 된 데이터베이스에 연결합니다.

3. 업그레이드 수행

운영 체제에 맞는 아래의 해당 업그레이드 지침을 참조하십시오.

Windows에서 JIRA 애플리케이션 업그레이드하기

JIRA 애플리케이션 다운로드 페이지 에서 'JIRA Windows Installer'(.exe) 파일 (새로운 JIRA 애플리케이션 버전 용)을 다운로드하십시오 .
JIRA 애플리케이션을 종료하십시오.
업그레이드 마법사를 시작하려면 '.exe'파일을 실행하십시오.
Windows 7 (또는 Vista) '사용자 계정 컨트롤'대화 상자에서 업그레이드 마법사가 컴퓨터를 변경하도록 허용 할 것인지 묻는 메시지가 표시되면 예를 지정 합니다. 설치 마법사를 사용하지 않으면 설치 마법사에서 운영 체제에 대한 액세스가 제한되고 이후 설치 옵션이 제한됩니다.
'JIRA 업그레이드'에서? 단계에서 기존 JIRA 설치 업그레이드 옵션을 선택하십시오.
에서 기존 JIRA 설치 디렉토리 필드에 지정 JIRA 응용 프로그램 설치 디렉토리 당신의 JIRA 설치를 업그레이드 할 수 있습니다.
업그레이드 마법사는 기존 JIRA 설치를 찾아 그 위치를 사용하여이 필드를 미리 채 웁니다. 하지만, 특히 같은 머신에서 여러 개의 JIRA를 실행하고있는 경우, 항상이 위치를 확인하십시오.

업그레이드 마법사의 후속 단계에서 다음 옵션을 지정하거나 수행하라는 메시지가 표시됩니다.

'JIRA 디렉토리 백업'단계 에서이 디렉토리 백업 옵션이 선택 되어 있는지 확인하십시오 . 이렇게하면 기존 JIRA 설치 및 JIRA 홈 디렉토리의 각 zip 아카이브 파일 백업이 각각의 상위 디렉토리 위치에 생성됩니다.
참고 사항 :
- 이 옵션을 선택하는 것이 좋습니다!
- 업그레이드 마법사는 업그레이드 된 JIRA 설치로 자동으로 마이그레이션 할 수없는 기존 JIRA 설치 디렉토리의 모든 사용자 정의를 기록합니다. 이러한 사용자 화가 포함 된 파일에 대한 정보가 있으면 위 의 개요 에서 언급하지 않은 사용자 정의 파일을 업그레이드 된 JIRA 설치 로 수동으로 마이그레이션해야하므로이 파일을 기록해 두십시오 .
  SSL 구성
  - 업그레이드 마법사는 conf/server.xml JIRA 설치 디렉토리 의 파일에 정의 된 SSL 구성을 자동으로 마이그레이션 할 수 없습니다 .
  
  - JIRA 용 번들 JRE (JIRA 설치 디렉토리의 JRE 폴더에있는 )경우, 업그레이드 마법사는 업그레이드 후에도 SSL 인증서를 새 JRE로 가져올 수 없습니다.) SSL 인증서를 가져와야합니다 SSL 인증서 가져 오기에 대한 자세한 정보는 SSL 또는 HTTPS를 통한 JIRA 애플리케이션 실행을 참조하십시오 .
  
  - 시스템 JRE를 사용하는 경우, 업그레이드 후에 JRE에 SSL 인증서가 이미 있으므로 SSL 인증서를 새 JRE로 가져올 필요가 없습니다. JIRA가 시스템 JRE를 사용하고 있는지 확인하기 만하면됩니다. 이렇게하려면 포함 된 JRE 대신 시스템 JRE를 사용하는 방법에서catalina.bat 설명한대로 변경을 수행해야합니다 .
의 단계 '목록 확인 업그레이드'를 외부 데이터베이스를 백업 및 비 번들 플러그인을 업그레이드 JIRA 버전과 호환됩니다 있는지 확인합니다. 이미 2 단계 : 외부 데이터베이스 백업 에서 데이터베이스를 백업했을 수 있습니다 .

'업그레이드 검사 목록'단계가 끝나면 기존 JIRA 설치가 여전히 실행 중이면 종료됩니다. 업그레이드 마법사가 다음을 수행합니다.

기존 JIRA 설치를 백업하십시오.
기존 JIRA 설치 디렉토리의 내용을 삭제하십시오.
기존 JIRA 설치 디렉토리에 JIRA의 새로운 버전을 설치하십시오.

새로운 (업그레이드 된) JIRA 설치를 시작하십시오.

업그레이드 된 JIRA 설치 ( 위 ) 로 수동으로 마이그레이션해야하는 커스터마이제이션을 포함하고있는 파일을 언급 한 경우 ,

업그레이드 된 JIRA 설치를 중단하십시오.
이 파일의 커스터마이징을 업그레이드 된 JIRA 애플리케이션 설치 디렉토리 로 마이그레이션하십시오 .

업그레이드 된 JIRA 설치를 다시 시작하십시오.

기존 구성 마이그레이션 지침
기존 JIRA 설치의 설정 파일에서 속성을 수정했다면 새로운 JIRA 설치에서 같은 수정을하십시오. 그러나 구성 파일의 등록 정보가 버전간에 변경되었을 수 있으므로 기존 설치에서 구성 파일을 복사하고 새 설치에서 동등한 파일을 바꿀 수 없습니다.

기존 JIRA 설치에서 수정 한 각 파일에 대해 새로운 JIRA 설치에서 해당 파일 을 수동으로 편집하고 수정 사항을 다시 적용해야합니다 . 새 JIRA 설치 (예 : osuser.xml 최근 JIRA 버전)에 파일이 없으면 새 JIRA 설치로 파일을 복사하십시오.

아래 표는 JIRA 설치 디렉토리 내에서 가장 많이 수정되는 파일과 그 위치를 보여줍니다 :

파일	'권장'(이전의 '독립형') 위치 JIRA 배포판	기술
jira-application.properties	`atlassian-jira/WEB-INF/classes`	JIRA 4.3.x 및 이전 버전 의 JIRA 홈 디렉토리 및 고급 JIRA 설정 위치 . 기존의 JIRA 4.3.x (또는 이전 버전) 설치 파일에 정의 된 모든 사용자 정의 속성 값 은 새 JIRA 설치 를 시작하기 전에 새로운 JIRA 7.3 설치 파일 `jira-application.properties`로 마이그레이션해야 합니다 . 새 JIRA 설치를 시작하면 파일의 모든 사용자 정의 속성 값 이 자동으로 JIRA 데이터베이스 또는 jira-config.properties 파일 로 마이그레이션 됩니다. JIRA가 이후에 사용 하는 파일 의 유일한 속성입니다 .`jira-application.properties` `jira-application.properties` `jira.home` `jira-application.properties`
setenv.bat (Windows) 또는 setenv.sh (Linux)	`bin`	JIRA 메모리 증가
osuser.xml (JIRA 4.3.0 또는 이후 버전에서 업그레이드 할 경우 필요 없음)	`atlassian-jira/WEB-INF/classes`	당신이있는 경우 수정 JIRA와 통합 LDAP , JIRA와 통합 군중을 외부 사용자 관리 또는 사용자 인증의 사용자 지정 양식을 사용하는 경우, 또는.
seraph-config.xml	`atlassian-jira/WEB-INF/classes`	Crowd와 JIRA를 통합 한 경우 수정되었습니다 .
server.xml	`conf`	다음 상황에서 수정 됨 : 이전에 JIRA의 TCP 포트를 기본값과 다르게 설정 했다면 SSL 을 구현 한 경우 . JIRA 4.3.x 및 이전 버전에서 JIRA를 데이터베이스 에 연결할 때 .

버전 별 업그레이드 노트 이 일반적으로 수정 된 파일에 변경 될 수 있습니다 속성에 대한 자세한 내용이 포함되어 있습니다.

위 파일 외에도 업그레이드 프로세스의 일부로 다음 구성을 고려하거나 수행해야합니다.

JIRA를 Atlassian의 군중 과 함께 사용 하시겠습니까? - JIRA에서 Crowd를 사용하는 경우 JIRA와 군중 통합에 설명 된대로 Crowd와 통신하도록 새 JIRA를 구성하십시오 .
- JIRA의 새로운 호스트 이름 / IP 액세스 권한을 부여하도록 Crowd를 설정하십시오.
JIRA에 추가 메모리 할당하기 - 이전에 JIRA에 추가 메모리를 할당했다면, 새로운 JIRA 인스턴스에 대해서도 동일한 작업을하십시오. 자세한 정보는 JIRA 메모리 늘리기를참조하십시오 .
플러그인 - 이전 JIRA에 설치 한 플러그인은 http://plugins.atlassian.com 사이트 에서 JIRA 새 버전의 플러그인 버전을 다운로드 하십시오.
문자 인코딩 - 새 위치와 이전 위치에서 문자 인코딩 (예 : 로케일)이 동일해야합니다. 호환되지 않는 인코딩을 사용하는 두 시스템 사이에서 첨부 파일을 이동하면 JIRA의 새 버전이 올바르게 작동하지 않을 수 있습니다.
커스터마이징 - 커스터마이징 (코드, 템플릿 또는 설정 파일)을했다면,이 변경 사항의 호환 가능한 버전을 새로운 JIRA에 복사하십시오. (이전 버전을 사용자 정의한 조직의 개발자는 새 버전의 변경 사항을 빌드하고 테스트해야하며 업그레이드 된 JIRA 설치로 복사 할 파일을 제공해야합니다.)
(선택 사항) 다른 포트에서 JIRA 실행 하기 - 새로운 JIRA가 이전 JIRA와 동일한 머신에 설치되어있는 경우 이전 JIRA를 재시작해야 할 경우에 대비하여 다른 포트에서 실행되도록 할 수 있습니다. 자세한 내용은 JIRA의 TCP 포트 변경 하기를 참조하십시오.

업그레이드 마법사의 마지막 단계에서 브라우저에서 업그레이드 된 JIRA 설치를 시작하는 옵션을 선택하여 업그레이드를 확인할 수 있습니다.

축하합니다. Windows에서 JIRA 설치를 업그레이드했습니다!

Linux에서 JIRA 업그레이드하기

JIRA 다운로드 페이지 에서 운영체제 (새로운 버전의 JIRA)에 적합한 'JIRA Linux 64-bit / 32-bit Installer'(.bin) 파일을 다운로드하십시오 .
JIRA를 종료하십시오.
리눅스 콘솔을 열고 디렉토리 ( cd)를 '.bin'파일의 디렉토리로 변경하십시오.
'.bin'파일을 다운로드 한 후에 실행 가능하지 않으면 실행 파일로 만드십시오
chmod a+x atlassian-jira-X.Y.bin
( 예 : XY는 JIRA 버전을 나타냄)
업그레이드 마법사를 시작하려면 '.bin'파일을 실행하십시오.
새 JIRA 설치 또는 기존 설치 업그레이드 중 하나를 선택하라는 메시지가 나타나면 , 기존 JIRA 설치 업그레이드 옵션을 선택하십시오.
업그레이드 할 JIRA 설치의 JIRA 설치 디렉토리를 지정하십시오.
업그레이드 마법사는 기존의 JIRA 설치를 찾아 내려고 그 위치를 선택 사항으로 제공합니다. 하지만, 특히 같은 머신에서 여러 개의 JIRA를 실행하고있는 경우, 항상이 위치를 확인하십시오.
업그레이드 마법사의 후속 단계에서 다음 옵션을 지정하거나 수행하라는 메시지가 표시됩니다.
1. JIRA의 디렉토리를 백업하는 옵션을 선택하십시오. 이렇게하면 기존 JIRA 설치 및 JIRA 홈 디렉토리의 각 zip 아카이브 파일 백업이 각각의 상위 디렉토리 위치에 생성됩니다.
  참고 사항 :
  - 이 옵션을 선택하는 것이 좋습니다!
  - 업그레이드 마법사는 업그레이드 된 JIRA 설치로 자동으로 마이그레이션 할 수없는 기존 JIRA 설치 디렉토리의 모든 사용자 정의를 기록합니다. 이러한 사용자 화가 포함 된 파일에 대한 정보가 있으면 위 의 개요 에서 언급하지 않은 사용자 정의 파일을 업그레이드 된 JIRA 설치 로 수동으로 마이그레이션해야하므로이 파일을 기록해 두십시오 .
    SSL 구성
    - 업그레이드 마법사는 conf/server.xml JIRA 설치 디렉토리 의 파일에 정의 된 SSL 구성을 자동으로 마이그레이션 할 수 없습니다 .
    
    - JIRA 용 번들 JRE (JIRA 설치 디렉토리의 JRE 폴더에있는 )경우, 업그레이드 마법사는 업그레이드 후에도 SSL 인증서를 새 JRE로 가져올 수 없습니다.) SSL 인증서를 가져와야합니다 SSL 인증서 가져 오기에 대한 자세한 정보는 SSL 또는 HTTPS를 통한 JIRA 애플리케이션 실행을 참조하십시오 .
    
    - 시스템 JRE를 사용하는 경우, 업그레이드 후에 JRE에 SSL 인증서가 이미 있으므로 SSL 인증서를 새 JRE로 가져올 필요가 없습니다. JIRA가 시스템 JRE를 사용하고 있는지 확인하기 만하면됩니다. 이렇게하려면 포함 된 JRE 대신 시스템 JRE를 사용하는 방법에서catalina.sh 설명한대로 변경을 수행해야합니다 .
2. 상기 단계 '목록 확인 업그레이드'를 백업, 외부 데이터베이스. 이미 2 단계에서 외부 데이터베이스 백업 에서 데이터베이스를 백업했을 수 있습니다 .
3. '업그레이드 검사 목록'단계가 끝나면 기존 JIRA 설치가 여전히 실행 중이면 종료됩니다. 업그레이드 마법사가 다음을 수행합니다.
  1. 기존 JIRA 설치를 백업하십시오.
  2. 기존 JIRA 설치 디렉토리의 내용을 삭제하십시오.
  3. 기존 JIRA 설치 디렉토리에 새로운 버전의 JIRA를 설치하십시오.
  4. 새로운 (업그레이드 된) JIRA 설치를 시작합니다.
    업그레이드 된 JIRA 설치 ( 위 ) 로 수동으로 마이그레이션해야하는 커스터마이제이션을 포함하고있는 파일을 언급 한 경우 ,
    1. 업그레이드 된 JIRA 설치를 중단하십시오.
    2. 이 파일의 커스터마이징을 업그레이드 된 JIRA 애플리케이션 설치 디렉토리 로 마이그레이션하십시오 .
    3. 업그레이드 된 JIRA 설치를 다시 시작하십시오.
업그레이드 마법사의 마지막 단계는 브라우저에서 업그레이드 된 JIRA 설치를 시작하기위한 링크를 제공하므로 업그레이드를 확인할 수 있습니다.

4. 업그레이드 후 검사 및 작업

호환되는 버전의 가용성을 확인한 후에는 JIRA를 성공적으로 업그레이드 한 후에 플러그인을 업그레이드해야합니다. > Add-ons> Add-ons 관리 를 통해이 작업을 수행 할 수 있습니다 . Windows에서 JIRA가 서비스로 실행되고 있다면 이전 설정과 일치하도록 Java 설정을 업데이트하십시오.