1. 사용자 정의 확인
빠른 업그레이드 방법을 사용하면 설치 프로그램이 자동으로 많은 업그레이드 작업을 수행 할 수 있습니다. 그러나 JIRA 애플리케이션 설치를 사용자 정의한 경우, 사용자 화 된 파일을 수동으로 업그레이드 된 설치로 마이그레이션해야합니다. 설치 프로그램이 자동으로 확인하고 마이그레이션합니다.
...
- 업그레이드 프로세스는 데이터베이스 백업 유틸리티를 사용하여 데이터베이스 백업을 수행하도록 요청합니다. 데이터베이스가 온라인 백업을 지원하지 않으면 업그레이드 프로세스를 중지하고 JIRA 애플리케이션을 종료하고 데이터베이스 백업을 수행 한 다음 업그레이드 프로세스를 다시 시작하여 계속 진행할 수 있습니다.
- 설치 프로그램은 기존 JIRA 애플리케이션 설치의 설치 및 홈 디렉토리를 자동으로 백업합니다. 첨부 파일과 인덱스 파일이 JIRA 어플리케이션 홈 디렉토리 밖에있을 경우,이 파일들을 수동으로 백업해야합니다. 이 페이지에서는 사용자 환경에서이 디렉토리의 위치를 확인하는 방법에 대해 설명합니다.
2. 외부 데이터베이스 백업
업그레이드 마법사를 시작한 후 업그레이드를 시작하기 전에 외부 데이터베이스를 백업하라는 메시지가 표시됩니다. 데이터베이스의 기본 백업 도구를 사용하여 데이터베이스를 백업 할 수 있지만 다음 사항에 유의하십시오.
...
- 다른 (테스트) 시스템으로 데이터베이스 백업 복원 및
- 현재 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.xmlJIRA 설치 디렉토리 의 파일에 정의 된 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/classesJIRA 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.propertiesjira.homejira-application.propertiessetenv.bat (Windows) 또는 setenv.sh (Linux)
binosuser.xml
(JIRA 4.3.0 또는 이후 버전에서 업그레이드 할 경우 필요 없음)atlassian-jira/WEB-INF/classes당신이있는 경우 수정 JIRA와 통합 LDAP , JIRA와 통합 군중을 외부 사용자 관리 또는 사용자 인증의 사용자 지정 양식을 사용하는 경우, 또는.
seraph-config.xml
atlassian-jira/WEB-INF/classesCrowd와 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 디렉토리 백업'단계 에서이 디렉토리 백업 옵션이 선택 되어 있는지 확인하십시오 . 이렇게하면 기존 JIRA 설치 및 JIRA 홈 디렉토리의 각 zip 아카이브 파일 백업이 각각의 상위 디렉토리 위치에 생성됩니다.
- 업그레이드 마법사의 마지막 단계에서 브라우저에서 업그레이드 된 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를 실행하고있는 경우, 항상이 위치를 확인하십시오.
- 업그레이드 마법사의 후속 단계에서 다음 옵션을 지정하거나 수행하라는 메시지가 표시됩니다.
- JIRA의 디렉토리를 백업하는 옵션을 선택하십시오. 이렇게하면 기존 JIRA 설치 및 JIRA 홈 디렉토리의 각 zip 아카이브 파일 백업이 각각의 상위 디렉토리 위치에 생성됩니다. 참고 사항 :
- 이 옵션을 선택하는 것이 좋습니다!
업그레이드 마법사는 업그레이드 된 JIRA 설치로 자동으로 마이그레이션 할 수없는 기존 JIRA 설치 디렉토리의 모든 사용자 정의를 기록합니다. 이러한 사용자 화가 포함 된 파일에 대한 정보가 있으면 위 의 개요 에서 언급하지 않은 사용자 정의 파일을 업그레이드 된 JIRA 설치 로 수동으로 마이그레이션해야하므로이 파일을 기록해 두십시오 .
SSL 구성
- 업그레이드 마법사는
conf/server.xmlJIRA 설치 디렉토리 의 파일에 정의 된 SSL 구성을 자동으로 마이그레이션 할 수 없습니다 .- JIRA 용 번들 JRE (JIRA 설치 디렉토리의 JRE 폴더에있는
)경우, 업그레이드 마법사는 업그레이드 후에도 SSL 인증서를 새 JRE로 가져올 수 없습니다.) SSL 인증서를 가져와야합니다 SSL 인증서 가져 오기에 대한 자세한 정보는 SSL 또는 HTTPS를 통한 JIRA 애플리케이션 실행을 참조하십시오 .- 시스템 JRE를 사용하는 경우, 업그레이드 후에 JRE에 SSL 인증서가 이미 있으므로 SSL 인증서를 새 JRE로 가져올 필요가 없습니다. JIRA가 시스템 JRE를 사용하고 있는지 확인하기 만하면됩니다. 이렇게하려면 포함 된 JRE 대신 시스템 JRE를 사용하는 방법에서
catalina.sh설명한대로 변경을 수행해야합니다 .
- 상기 단계 '목록 확인 업그레이드'를 백업, 외부 데이터베이스. 이미 2 단계에서 외부 데이터베이스 백업 에서 데이터베이스를 백업했을 수 있습니다 .
- '업그레이드 검사 목록'단계가 끝나면 기존 JIRA 설치가 여전히 실행 중이면 종료됩니다. 업그레이드 마법사가 다음을 수행합니다.
- 기존 JIRA 설치를 백업하십시오.
- 기존 JIRA 설치 디렉토리의 내용을 삭제하십시오.
- 기존 JIRA 설치 디렉토리에 새로운 버전의 JIRA를 설치하십시오.
- 새로운 (업그레이드 된) JIRA 설치를 시작합니다. 업그레이드 된 JIRA 설치 ( 위 ) 로 수동으로 마이그레이션해야하는 커스터마이제이션을 포함하고있는 파일을 언급 한 경우 ,
- 업그레이드 된 JIRA 설치를 중단하십시오.
- 이 파일의 커스터마이징을 업그레이드 된 JIRA 애플리케이션 설치 디렉토리 로 마이그레이션하십시오 .
업그레이드 된 JIRA 설치를 다시 시작하십시오.
- JIRA의 디렉토리를 백업하는 옵션을 선택하십시오. 이렇게하면 기존 JIRA 설치 및 JIRA 홈 디렉토리의 각 zip 아카이브 파일 백업이 각각의 상위 디렉토리 위치에 생성됩니다.
- 업그레이드 마법사의 마지막 단계는 브라우저에서 업그레이드 된 JIRA 설치를 시작하기위한 링크를 제공하므로 업그레이드를 확인할 수 있습니다.
4. 업그레이드 후 검사 및 작업
호환되는 버전의 가용성을 확인한 후에는 JIRA를 성공적으로 업그레이드 한 후에 플러그인을 업그레이드해야합니다. > Add-ons> Add-ons 관리 를 통해이 작업을 수행 할 수 있습니다 . Windows에서 JIRA가 서비스로 실행되고 있다면 이전 설정과 일치하도록 Java 설정을 업데이트하십시오.