Jira 서버에서 데이터 센터로 마이그레이션

이 페이지에서는 Jira Data Center로 마이그레이션하는 프로세스를 간략하게 설명합니다.

Jira를 처음으로 설치하는 경우는 JIRA Data Center 설치를 참조하여 주시기 바랍니다.

1 사전 준비
2 데이터 센터 마이그레이션
- 2.1 클러스터되지 않은 데이터 센터로 마이그레이션
- 2.2 클러스터 설정

사전 준비

Jira Data Center를 사용하려면 다음이 선행되어야 합니다.

Jira Data Center는 Jira 7.0 이상에서 사용 가능.
데이터 센터 라이선스 보유
- 데이터 센터 라이선스를 구입하거나 my.atlassian.com에서 평가 라이선스 생성 가능
Session affinity 및 WebSockets 지원이 있는 로드 밸런서
동일한 경로의 모든 클러스터 노드에 액세스 할 수있는 공유 디렉토리 (공유 홈 디렉토리)
- 로컬 홈 또는 설치 디렉토리 내에 위치하지 않는 별도의 디렉토리여야 함
앱 검토 및 업그레이드
- 사이트에 설치된 앱이있는 경우 Data Center 앱 버전으로 업그레이드 필요
- 데이터 센터로 마이그레이션 할 때 서버 앱 업그레이드 참조

데이터 센터 마이그레이션

클러스터되지 않은 데이터 센터로 마이그레이션

클러스터링 되지 않은 단일 노드에 데이터 센터 마이그레이션 하는 경우는 라이선스만 변경하면 됩니다.

Administrator > Applications > Version and license
라이선스 키 변경
Jira 인스턴스 재시작

데이터 센터 라이선스는 서버에 사용한 라이선스와 일치해야합니다. 예를 들어 서버 라이선스에 Jira Software 및 Jira Service Desk가 포함되어 있지만 새 라이선스에 Jira Software만 있는 경우 업데이트 할 수 없으며 다음 오류가 표시될 가능성이 높습니다.

클러스터 설정

공유 디렉토리 설정

공유 폴더 생성 - NFS 설정 참조하여 폴더 생성
Jira 인스턴스 중지
$ cd <jira install directory>/bin $ ./stop-jira.sh
공유폴더에 아래 폴더 복사
- data, plugins, logos, import, export, caches
  cp -R <jira local home directory>/{data,plugins,logos,import,export,caches} <jira shared home directory>

클러스터에서 동작하도록 Jira 인스턴스 구성

JIRA 로컬 홈디렉토리에 파일 생성 - 공유폴더와 node 아이디 설정
$ cd <jira local home directory> $ vi cluster.properties --------------------------- # 클러스터에서 식별 가능한 ID jira.node.id = node1 # 모든 Jira 노드의 공유 홈 디렉토리 위치 jira.shared.home = <jira shared home directory> ---------------------------
열린 파일의 Max 값 변경
Jira 인스턴스를 시작하고 데이터 센터 라이선스 적용

매개 변수	필수	설명 / 값

매개 변수	필수	설명 / 값
`jira.node.id`	예	이 고유 ID는 아파치 구성의 사용자 이름과 밸런서멤버 항목과 일치해야 함
`jira.shared.home`	예	모든 Jira 노드에 대한 공유 홈 디렉토리의 위치
`ehcache.peer.discovery`	아니오	노드가 서로를 찾는 방법 설명: 기본값 – Jira가 노드를 자동으로 검색(권장) 자동 – EhCache의 멀티캐스트 검색을 사용. EhCache가 사용하는 역사적 방법이지만 구성이 어려울 수 있으며, 아틀라시안에서는 권장하지 않음. ehcache.peer.discovery = automatic을 설정하는 경우 다음 매개 변수를 설정: * ehcache.multicast.address * ehcache.multicast.port * ehcache.multicast.timeToLive * ehcache.multicast.hostName 매개 변수에 대한 자세한 내용은 Ehcache 설명서를 참조
`ehcache.listener.hostName`	아니오	캐시 통신을 위한 현재 노드의 호스트 이름. 매개 변수가 설정되지 않은 경우 Jira Data Center에서 내부적으로 확인한다. 네트워크의 호스트 이름을 확인하는데 문제가 있는 경우 이 매개 변수를 설정.
`ehcache.listener.port`	아니오	노드가 수신할 포트(기본값은 40001) 여러 노드가 동일한 호스트에 있거나 이 포트를 사용할 수 없는 경우 이 매개 변수를 수동으로 설정해야 할 수 있다.
`ehcache.object.port`	아니오	레지스트리에서 바인딩된 원격 개체가 호출을 수신하는 포트(기본값은 40011). 여러 노드가 동일한 호스트에 있거나 이 포트를 사용할 수 없는 경우 이 매개 변수를 수동으로 설정해야 할 수 있다.
`ehcache.listener.socketTimeoutMillis`	아니오	기본적으로 이 값은 EhCache 기본값으로 설정

로드 밸런서에 첫 번째 노드 추가

Apache Load Balancer에 첫번째 노드 추가
노드를 다시 시작한 다음 설정한 Jira 도메인으로 접속. 로드 밸런서가 제대로 작동하면 Jira에 액세스하는 데 문제가 없습니다.

Nginx의 경우 쿠키 기반 session affinity를 유료 버전인 plus 에서만 지원하기 때문에 무료 버전에서도 쿠키 기반 session affinity를 지원하는 Apache를 추천합니다.

나머지 노드를 클러스터에 추가

Jira 설치 디렉토리와 로컬 홈 디렉토리를 첫 번째 노드에서 새 노드로 복사
새 노드가 공유 홈 디렉토리에 액세스(읽기 및 쓰기) 할 수 있는지 확인
cluster.properties 파일을 편집하여 노드 ID 변경. 모든 노드 ID는 노드 간에 고유해야 합니다.
새 노드에서 Jira 인스턴스 시작. 이슈 생성, 검색, 첨부 파일 및 사용자 지정이 예상대로 작동하는지 확인
모든 것이 정상이면 트래픽을 새 노드로 라우팅하도록 로드 밸런서에 노드 추가 구성