Confluence 데이터 센터 업그레이드

이 가이드에서는 설치 관리자를 사용하여 Windows 또는 Linux에서 Confluence 사이트를 최신 Confluence 버전으로 업그레이드하는 방법을 안내합니다.

시작하기 전에

Confluence를 업그레이드하기 전에 몇 가지 질문에 답해야 합니다.

업그레이드 계획 세우기

1. 업그레이드 경로 결정

아래 표를 사용하여 현재 버전에서 최신 버전의 Confluence로 가장 효율적으로 업그레이드할 수 있는 경로를 결정합니다.

엔터프라이즈 릴리스

장기 지원 릴리스는 2년의 전체 지원 기간 동안 중요한 보안 업데이트 및 중요 버그 수정을 백포트하는 기능 릴리스입니다. 1년에 한 번만 업그레이드할 수 있는 경우에는 장기 지원 릴리즈로 업그레이드하는 것을 고려하세요.

장기 지원 릴리스는 원래 엔터프라이즈 릴리스라고 불렀습니다.

2. 업그레이드 전 확인 사항 완료

1. 업그레이드하려는 버전(및 그 사이의 버전)에 대한 업그레이드 노트를 확인합니다.

2. 관리 > 일반 환경 설정 > 업그레이드 계획으로 이동한 다음 업그레이드할 버전을 선택합니다. 그러면 몇 가지 업그레이드 전 검사가 실행됩니다.

3. 관리 > 일반 환경 설정 > 문제 해결 및 지원 도구로 이동하여 상태 검사를 실행합니다.

   • 라이선스가 만료되었나요?
     라이선스에 포함된 소프트웨어 유지 관리 기간이 만료된 경우 Confluence를 계속 사용할 수 있지만 업그레이드하려면 먼저 갱신해야 합니다.
     관리 > 일반 환경 설정 > 라이선스 세부 정보로 이동하여 메시지에 따라 라이선스를 갱신합니다.

   • 데이터베이스 문자 인코딩이 잘못되었나요?
     데이터베이스 문자 인코딩은 UTF8(또는 MySQL 데이터베이스의 경우 UTF8MB4, Oracle 데이터베이스의 경우 AL32UTF8)로 설정해야 합니다. 올바른 문자 인코딩이 없으면 현재 Confluence 버전으로 업그레이드할 수 없습니다.  

4. 관리 > 앱 관리 > Confluence 업데이트 확인으로 이동하여 마켓플레이스 앱의 호환성을 확인합니다.

5. 업그레이드하려는 버전을 선택한 다음 확인을 선택합니다.

   • 호환되지 않는 애드온이 있는 경우
     사용자가 특정 마켓플레이스 앱에 의존하는 경우, 해당 앱이 호환될 때까지 기다렸다가 Confluence를 업그레이드하는 것이 좋습니다. 공급업체는 일반적으로 주요 릴리스 직후에 앱을 업데이트합니다.

     알아두면 유용합니다:

     • 아직 호환되지 않는 앱이 있는 경우 업그레이드하는 동안 일시적으로 앱을 사용하지 않도록 설정할 수 있습니다.

     • Atlassian Labs 및 기타 무료 앱에 대한 호환성 정보는 새 릴리스 직후에 제공되지 않는 경우가 많습니다. 대부분의 경우 앱은 여전히 작동하므로 프로덕션 사이트를 업그레이드하기 전에 테스트 사이트에서 사용해 보세요.

3. 테스트 환경에서 Confluence 업그레이드하기

1. 현재 프로덕션 환경의 준비 복사본을 만듭니다.  

2. 아래 단계에 따라 테스트 환경을 업그레이드하세요.

3. 프로덕션 환경을 업그레이드하기 전에 지원되지 않는 사용자 설치 앱, 사용자 지정(예: 사용자 지정 테마 또는 레이아웃) 및 프록시 구성(가능한 경우)을 모두 테스트하세요.

Confluence 업그레이드

4. 백업

1. 데이터베이스를 백업하고 백업이 제대로 만들어졌는지 확인합니다. 데이터베이스가 온라인 백업을 지원하지 않는 경우 먼저 Confluence를 중지해야 합니다.
   MySQL 데이터베이스를 사용하는 경우 백업에 저장 프로시저/함수가 포함되어 있는지 확인합니다.
   데이터베이스 백업이 성공적으로 완료되었음을 확인한 후에는 중간 규모 이상의 사이트에서는 이 프로세스에 시간이 오래 걸릴 수 있으므로 업그레이드 복구 파일의 자동 생성을 비활성화하도록 선택할 수 있습니다.

2. 설치 디렉터리 백업
   설치 마법사가 이 디렉터리를 완전히 대체하므로 키 저장소 또는 SSL 인증서와 같이 추가한 모든 파일은 유지되지 않습니다. 설치 마법사가 업그레이드를 시작하기 전에 이 디렉터리를 백업하지만, 먼저 수동으로 백업해야 합니다.
     

3. 홈 디렉터리 백업
   설치 마법사는 설치 프로세스의 일부로 홈 디렉터리를 백업하는 옵션을 제공하지만 업그레이드를 시작하기 전에 이 디렉터리도 수동으로 백업해야 합니다.
   홈 디렉터리의 위치는 <설치 디렉터리>/confluence/WEB-INF/classes/confluence-init.properties 파일에서 찾을 수 있습니다.

   여기에 검색 인덱스 및 첨부 파일이 저장됩니다. 첨부 파일을 Confluence 홈 디렉터리 외부에 저장하는 경우 첨부 파일 디렉터리도 백업해야 합니다.

5. Confluence 다운로드

운영 체제용 설치 관리자를 다운로드합니다.

• 최신 버전 https://www.atlassian.com/software/confluence/download

• 이전 버전 https://www.atlassian.com/software/confluence/download-archives  

6. 설치 관리자 실행

1. Confluence를 다운로드한 디렉터리로 변경한 다음 다음 명령을 실행하여 설치 관리자를 실행합니다:

   $ chmod a+x atlassian-confluence-X.X.X-x64.bin

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

   다음으로 설치 관리자를 실행합니다. sudo를 사용하여 설치 관리자를 실행하는 것이 좋습니다:

   $ sudo ./atlassian-confluence-X.X.X-x64.bin

   루트 사용자 권한으로 설치 관리자를 실행하도록 선택할 수도 있습니다.

2. 메시지에 따라 Confluence를 업그레이드합니다:

   1. 메시지가 표시되면 Upgrade an existing Confluence installation를 선택합니다(Linux 사용자의 경우 옵션 3).

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

   3. Confluence 홈 백업을 강력히 권장합니다. 이렇게 하면 Confluence 홈 및 설치 디렉터리의 .zip 백업이 만들어집니다.

   4. 설치 마법사는 Confluence 설치 디렉터리에 있는 사용자 정의 수정된 파일에 대해 알려줍니다. 나중에 다시 적용해야 하므로 이를 기록해 둡니다.

      • 설치 마법사가 사용자 정의 수정된 파일에 대해 알려주는 기능은 기존 Confluence 인스턴스가 설치된 방식에 따라 달라집니다:

        • 현재 Confluence 인스턴스가 설치 관리자를 사용하여 설치된 경우 마법사는 전체 Confluence 설치 디렉터리를 확인합니다.

        • 현재 Confluence 인스턴스를 수동으로 설치한 경우, 마법사는 Confluence 설치 디렉터리의 confluence 하위 디렉터리만 확인합니다. 설치 마법사는 다른 디렉터리의 수정 사항(예: bin 디렉터리 아래의 시작 스크립트 수정 또는 server.xml 파일 수정(예: SSL 구성)에 대해서는 알리지 않습니다.
          설치 디렉터리에 추가한 파일에 대해서는 알림을 받지 못하므로 먼저 백업을 해야 합니다.

3. 마법사는 Confluence 인스턴스를 종료하고 업그레이드를 진행합니다. 완료되면 Confluence가 다시 시작되고 브라우저에서 Confluence를 시작하여 업그레이드가 성공했는지 확인할 수 있습니다.
   인스턴스의 크기 및 실행할 업그레이드 작업의 수에 따라 이 단계는 몇 분 또는 몇 시간이 걸릴 수 있습니다.

업그레이드 후

7. 데이터베이스 드라이버 복사

Oracle 또는 MySQL 데이터베이스를 사용하는 경우, 기존 Confluence 설치 디렉터리에서 새 설치 디렉터리의 confluence/WEB-INF/lib로 jdbc 드라이버 jar 파일을 복사해야 합니다.

Microsoft SQL 및 Postgres 사용자는 이 단계를 건너뛸 수 있습니다.

8. 필요한 경우 서비스 다시 설치(Windows만 해당)

Windows에서 Confluence를 서비스로 실행하는 경우 기존 서비스를 삭제한 다음 <install-directory>/bin/service.bat를 실행하여 서비스를 다시 설치해야 합니다.

이렇게 하면 서비스에 최신 JVM 옵션이 적용됩니다.

9. 수정 사항 다시 적용

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

• <install-directory>/conf/server.xml 파일의 TCP 포트 값.

• <install-directory>/confluence/WEB-INF/classes/confluence-init.properties에서 Confluence 홈 디렉터리의 위치.

기타 구성, 사용자 정의(<install-directory>/conf/server.xml 파일의 기타 수정 사항 포함), <install-directory>/bin/setjre.sh 또는 setjre.bat에 있는 자체 Java 설치 경로 또는 설치 디렉터리에 추가된 추가 파일은 업그레이드 중에 마이그레이션되지 않으므로 수동으로 다시 적용해야 합니다.

1. 업그레이드된 Confluence 인스턴스를 중지합니다.

2. 업그레이드된 Confluence 설치 디렉터리에서 각 파일을 편집하고 사용자 정의를 다시 적용합니다.

3. 추가 파일(예: 키 저장소 또는 SSL 인증서)을 복사합니다.

4. 업그레이드된 Confluence 인스턴스를 다시 시작합니다.

프로덕션 인스턴스를 업그레이드하기 전에 테스트 인스턴스에서 사용자 정의를 테스트하는 것이 좋습니다. 사용자 정의를 사용할 수 없게 만드는 변경 사항이 Confluence에 적용되었을 수 있기 때문입니다.

10. 앱(add-ons) 업데이트

새 버전의 Confluence와 호환되는 모든 앱을 업데이트할 수 있습니다.

1. 관리 > 앱 관리로 이

2. 앱을 지원되는 버전으로 업데이트합니다.

11. 역방향 프록시를 업데이트하고 Confluence에 액세스할 수 있는지 확인

Confluence 5.x에서 Confluence 6.x로 업그레이드하는 경우 공동 편집에 필요한 동기화를 추가하기 위해 역방향 프록시(사용 중인 경우)를 수정해야 합니다. 프록시 구성에 변경해야 하는 사항에 대한 자세한 내용은 프록시 및 SSL 고려 사항을 참조하세요.
업그레이드가 완료되면 직접이 아닌 역방향 프록시를 통해 Confluence에 액세스해야 합니다:

• 관리 > 일반 환경 설정 > 공동 편집으로 이동하여 동기화 상태가 실행 중인지 확인합니다.  

• 아무 페이지나 편집하여 브라우저가 동기화에 연결할 수 있는지 확인합니다.

동기화가 실행되지 않거나 편집기에 오류가 표시되는 경우 역방향 프록시가 잘못 구성된 것일 수 있으므로 공동 작업 편집 문제 해결을 참조하여 다음 단계를 제안받으십시오.

Troubleshooting

• 라이선스가 만료되어 업그레이드를 진행할 수 없음
  라이선스가 만료되었지만 업그레이드 전에 갱신하여 다시 적용하지 않은 경우 업그레이드 프로세스 중에 오류가 발생합니다. 이 문제를 해결하는 방법에 대한 자세한 내용은 현재 라이선스 기간 이후 업그레이드를 참조하세요.

• 바이러스 백신과의 충돌로 인해 업그레이드를 진행할 수 없음
  일부 바이러스 백신 또는 기타 인터넷 보안 도구가 Confluence 업그레이드 프로세스를 방해하여 프로세스가 성공적으로 완료되지 않을 수 있으며, 특히 Confluence를 Windows 서비스로 실행하는 경우 더욱 그렇습니다. 바이러스 백신/인터넷 보안 도구에서 이러한 문제가 발생하거나 발생할 것으로 예상되는 경우, 먼저 이 도구를 비활성화한 후 Confluence 업그레이드를 진행하세요.

• 데이터베이스가 온라인 백업을 지원하지 않음
  업그레이드 마법사에서는 데이터베이스의 백업 유틸리티를 사용하여 데이터베이스를 백업하라는 메시지가 표시됩니다. 데이터베이스가 온라인 백업을 지원하지 않는 경우 업그레이드 프로세스를 중지하고 Confluence를 종료한 다음 데이터베이스 백업을 수행한 다음 설치 관리자를 다시 실행하여 업그레이드를 계속 진행하세요.

• 업그레이드가 매우 오래 걸리는 경우
  데이터베이스가 매우 큰 경우(즉, 데이터베이스 백업을 완료하는 데 매우 오랜 시간이 걸리는 경우) confluence.upgrade.recovery.file.enabled 시스템 속성을 false로 설정하면 업그레이드 프로세스의 속도를 높일 수 있습니다. 이 속성은 업그레이드를 수행하기 전에 데이터베이스를 백업하고 백업을 확인하는 프로세스가 있는 경우에만 사용해야 합니다.

• Confluence가 시작되지 않음
  호환되지 않는 Marketplace 앱으로 인해 때때로 Confluence가 성공적으로 시작되지 않을 수 있습니다. 사용자가 설치한 모든 앱을 일시적으로 비활성화한 상태에서 Confluence를 시작하여 문제를 해결할 수 있습니다.
  사용자가 설치한 모든 앱을 일시적으로 비활성화한 상태에서 Confluence를 시작하려면:

  $ cd <installation-directory>/bin $ ./start-confluence.sh --disable-all-addons

• 공동 작업 편집 오류
  동기화가 실행되지 않거나 오류가 표시되는 경우 공동 작업 편집 문제 해결로 이동하여 사용 중인 환경에서 공동 작업 편집을 시작하고 실행하는 방법에 대한 정보를 확인하세요. 가장 일반적인 문제는 역방향 프록시가 잘못 구성되었거나 포트 8091을 동기화에 사용할 수 없는 경우입니다.

• 업그레이드 후 스페이스 디렉터리가 비어 있음
  Confluence 6.3 이하에서 업그레이드하는 경우 스페이스 디렉터리에 스페이스가 나타나지 않는 알려진 문제가 있습니다. 이 문제를 해결하려면 업그레이드 후 사이트를 다시 색인화해야 합니다.

또한 Confluence 기술 자료에서 업그레이드 문제 해결 가이드를 참조하거나 Atlassian 커뮤니티에서 답변을 확인할 수 있습니다.