Confluence를 다른 Database로 이전(migrate)

원본 : https://confluence.atlassian.com/doc/migrating-to-another-database-148867.html

Database 이전의 제약 사항

Confluence에 내장 된 XML 내보내기는 대용량 데이터 세트의 백업 또는 마이그레이션에 적합하지 않습니다. 데이터 마이그레이션을 지원할 수있는 다양한 타사 도구가 있습니다. 올바른 도구를 선택하는 데 도움이 필요하거나 마이그레이션 자체에 도움이 필요한 경우 Atlassian Expert에 문의 바랍니다.

사전 작업

이 절차는 파일 시스템에 저장된 첨부 파일에만 적용됩니다. 데이터베이스에 첨부 파일을 저장한 경우 첨부 파일 스토리지 구성을 참조하여 다른 첨부 파일 스토리지간에 마이그레이션하는 방안을 찾아야합니다.

이전 작업 (Migration)

Step 1 : Marketplace 앱 기록

Confluence에서 현재 설치 및 활성화 된 앱 (플러그인 또는 애드온이라고도 함)을 기록하여 나중에 복원 할 수 있도록합니다. 각 앱마다 다음을 기록합니다.

• 앱 이름과 제조사

• 버전

• 활성 또는 비활성 상태. 모듈을 직접 활성화 또는 비활성화 한 경우 구성이 기본값과 다른 경우에 유용합니다.

Spep 2: 데이터 백업

1. 기존 데이터의 XML 백업을 작성하십시오. 사이트 수동 백업을 참조하십시오. XML 파일을 넣은 위치를 기록합니다. 나중에 Confluence 데이터를 새로운 데이터베이스로 가져 오기 위해 필요합니다.

2. Confluence를 중지합니다.

3. Confluence Home 디렉토리에 첨부 파일 디렉토리 (<CONFLUENCE-HOME-DIRECTORY> \ attachments)를 복사하십시오. 나중에 Confluence 첨부 파일 데이터를 새로운 Confluence 설치에 복사하기 위해 필요합니다.

4. 외부 데이터베이스를 사용하는 경우 해당 데이터베이스와 함께 설치된 유틸리티를 사용하여 별도의 백업을 만드십시오. 이것은 또한 예방 조치입니다.

Step 3 : 신규 database 셋업

새 데이터베이스에 대한 데이터베이스 설정 안내 사항을 선택하고 지시 사항에 따라 다음을 수행하십시오.

• 데이터베이스 서버를 설치합니다.

• 안내에 따라 데이터베이스 서버의 필수 구성을 수행합니다.

• Confluence 데이터베이스와 사용자를 추가합니다. 이 단계에서 정의한 사용자 이름과 비밀번호를 기록해 두십시오. 추후 Confluence 설정 마법사를 실행할 필요합니다.

Step 4 : 새로운 위치에 Confluence 설치

이제 다른 홈 디렉토리 경로와 설치 경로를 사용하여 Confluence를 다시 설치합니다.
참고 : 기존 설치와 동일한 버전의 Confluence를 사용해야합니다. (Confluence를 업그레이드하려면 별도의 단계로 수행해야합니다.) 예를 들어 현재 사이트에서 Confluence 5.1.2를 실행중인 경우 새 설치도 Confluence 5.1.2 여야합니다.

Confluence 인스톨러를 실행할 경우 :

• Custom Install을 선택합니다. (기존 설치를 업그레이드하도록 선택하지 마십시오.)

• 새로운 대상 디렉토리를 선택합니다. 이것은 새 Confluence의 설치 디렉토리입니다. 기존 Confluence 설치와 동일하지 않아야합니다.

• 새로운 홈 디렉토리를 선택하십시오. 이것은 새 Confluence의 데이터 디렉토리입니다. 기존 Confluence 설치와 동일하지 않아야합니다.

Step 5 : Database 드라이버 다운로드 및 설치

Confluence는 일부 데이터베이스 드라이버를 번들로 제공하지만 번들로 제공되지 않으면 직접 드라이버를 설치해야합니다. 필요한 경우 새 데이터베이스에 대한 데이터베이스 설정 지시 사항에 따라 데이터베이스 드라이버를 다운로드하여 설치하십시오.

Step 6 : Confluence 설정 마법사를 실행하고 새 데이터베이스에 데이터를 복사

Confluence 설정 마법사를 실행할 때 :

• 라이센스 키를 입력합니다.

• 설치 유형으로 Production Installation를 선택합니다.

• My own database를 선택한 다음 Database type 드롭 다운 메뉴에서 데이터베이스를 선택합니다.

• My own database를 선택하라는 메시지가 표시되면 새 데이터베이스 유형을 선택합니다.

• 데이터베이스 세부 사항을 입력합니다. test connection을 사용하여 데이터베이스가 올바르게 설정되었는지 확인합니다.

• 컨텐츠 로드 단계에서, Restore From Backup 선택하십시오. 여기에서 XML 백업에서 데이터를 가져옵니다. XML 파일에 액세스하기위한 두 가지 옵션이 있습니다 :

  • 네트워크에서 XML 백업 위치를 찾아서 업로드 및 복원을 선택합니다.

  • 또는 XML 파일을 새 사이트의 Confluence 홈 디렉토리 (<CONFLUENCE-HOME-DIRECTORY>\restore)에 넣고 복원을 선택합니다. 대규모 XML 파일에 권장되는 방법입니다.
    
    

참고 : Confluence 설정 마법사 중에 복원하지 않기로 선택한 경우 나중에 가져 오기를 수행 할 수 있습니다. Confluence 관리 콘솔로 이동하여 XML 백업을 복원하도록 선택하십시오. 사이트 백업 및 복원을 참조하십시오.

Step 7 : 첨부 파일 복사

첨부 파일 디렉토리 (<CONFLUENCE-HOME-DIRECTORY>\attachments)의 내용을 기존 Confluence Home 디렉토리에서 새 Confluence Home 디렉토리로 복사합니다.

Step 8 : Marketplace 앱 재설치

Confluence와 함께 제공되지 않는 앱 (플러그인 또는 애드온이라고도 함)을 다시 설치합니다.

• 기존 Confluence 사이트와 동일한 버전의 앱을 사용하십시오.

• 앱에서 생성 한 데이터는 XML 백업에 포함되어 있으므로 새 Confluence 사이트에 이미 존재합니다.

Step 9 : 신규 머신의 세팅 점검

Confluence를 다른 머신으로 옮기는 경우 다음 설정을 확인해야 합니다.

• 새 기본 URL을 구성합니다. 서버 기본 URL 구성을 참조하십시오.

• 응용 프로그램 링크를 확인합니다. 다른 응용 프로그램에 연결을 참조하십시오.

• 이 Confluence 사이트를 가리키는 외부 사이트에서 가젯 구독을 업데이트하십시오. 예를 들어 Jira 사이트가 Confluence 가젯에 가입 한 경우 Jira 사이트를 업데이트해야합니다.

• 다른 시스템이 Confluence에서 사용하는 다른 리소스를 검토하십시오.