FishEye, Crucible 4.4 버전이 릴리스 되었습니다. 자세한 사항은 FishEye 4.4 릴리스노트 를 참조하십시요..
페이지 트리
메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

한글가이드

  • 아래 가이드는 일반적인 설치환경을 기반으로 하였으므로 설치환경이 특별한 EAR/WAR 배포본 설치의 경우는 영문가이드를 같이 참조하시기 바랍니다.
  • 업그레이드는 반드시 운영서버와 동일한 테스트 환경을 구성하여 업그레이드 테스트를 먼저 수행 하실 것을 권장합니다.
  • 테스트 환경의 서버에서는 반드시 Developer 라이센스 혹은 평가용 테스트 라이센스를 이용하시기 바랍니다.
  • Crowd 를 현재 사용하는 고객의 경우 테스트 서버 구성 하기 전에 반드시 Local 디렉터리에 로컬관리자 계정을 추가하시기 바랍니다. (tick) 로그인 문제 발생 시 로컬관리자 계정으로 로그인하여 처리하기 위함입니다.

업그레이드 할 버전선택

  • 업그레이드 할 버전은 특별히 새로운 기능을 빠르게 사용할 목적이 아니라면 X.X.3 이상의 버전이 릴리스 된 이후 해당 버전으로 업그레이드 할 것을 권장합니다. (예를들어 현재 최신버전이 6.2.x 라면 최소 6.2.3 이상의 패치버전으로 선택)
  • 시스템 안정성을 최우선으로 하는 경우는 현재 릴리스된 최신 버전의 한단계 아래의 Major 버전의 최종 패치버전을 설치하시기를 권장합니다. (예를들면 현재 최신버전이 6.2.x 라면 6.1 의 최종 패치버전 (ex : 6.1.17) 을 선택)

 - 버전에 따른 업그레이드 단계는 아래 테이블을 참조

현재버전

최신버전으로의 권장 업그레이드 경로

2.7 이하버전2.7.4 버전으로 업그레이드 -> 3.5.17 버전 -> 5.0.3 -> 최신버전으로 업그레이드
2.8 에서 3.43.5.17 버전으로 업그레이드 -> 5.0.3 버전 -> 최신버전으로 업그레이드
3.5

5.0.3 으로 업그레이드 후 최신버전으로 업그레이드

4.0 에서 4.3 

현재 최신버전으로 업그레이드 가능

5.0 에서 5.9 

현재 최신버전으로 업그레이드 가능

(준비사항)

(1) Confluence가 Crowd 나 LDAP 과 연동된 경우라면 Confluence 자체의 로컬 관리자계정을 추가
(2) Standalone 배포본으로 설치 시 기존서버에 CATALINA_HOME, CATALINA_BASE 과 CATALINA_OPTS 환경변수가 설정되어 있다면 모두 설정해지 (unset)
(3) 현재 서버에 설치 운영되는 JDK, Database 와 사용자가 주로 사용하는 Browser 가 새로운 Confluence 버전이 지원하는 플랫폼 인지 확인 (Supported Platforms 문서 참조)

JDK 와 Database는 업그레이드 중 에러가 발생하는 경우가 아니면 업그레이드 완료 후에 변경하시기를 권장합니다.

버전별 지원 JDK

3.5 이상 버전의 경우 Oracle JDK 1.6.0_40 이상 지원

5.0 이상 버전의 경우 Oracle JDK 1.7 이상 지원

버전별 지원 DB 버전

3.5 이상 버전의 경우 PostgreSQL 8.2 이상, MySQL 5.0.28 이상, MSSQL 2005 이상, Oracle 11.1 이상 지원

5.0 이상 버전의 경우 PostgreSQL 8.3 이상, MySQL 5.1 이상, MSSQL 2005 이상, Oracle 11.1 이상 지원

5.5 이상 버전의 경우 PostgreSQL 8.4 이상, MySQL 5.0.28 이상 (5.6 버전의 경우는 5.6.16 이상) , MSSQL 2008 이상, Oracle 11.1 이상 지원

버전별 지원 IE 버전

3.5 이상 버전의 경우 IE 7,8 지원

5.0 이상 버전의 경우 IE 8,9 지원

5.5 이상 버전의 경우 IE 8,9,10,11 지원

 

(4) 애드온 호환성 체크를 미리 할 수 있는 경우 (Application Manager 버전에 따라 가능하지 않은 경우 있음)  미리 사용하는 플러그인들에 대해 호환성을 체크

(5) 현재 서버에서 사용하는 Database 에 대해 업그레이드 시의 발생 가능한 문제점을 아래 문서 참조하여 확인

https://confluence.atlassian.com/display/CONFKB/Database+Troubleshooting

 

 MySQL 관련 확인할 사항

MySQL 에서의 중요체크사항

--max_allowed_packet=32M 및 'READ-COMMITTED' transaction isolation level 가 설정되어야 하며, InnoDB 엔진을 사용하여야 업그레이드 시 문제가 발생하지 않음. 만약 InnoDB 엔진이 아니라면 MySQL MyISAM을 InnoDB 테이블로 변경하기문서 참조하여 변경해야 함.

MySQL 설정하기
MySQL의 /etc/my.cnf 파일을 수정하여 [mysqld] 섹션에 아래와 동일하도록 수정  (DB설정에 따라 파일명이 my.ini 와 같은 이름으로 다를수 있음)
[mysqld]
character-set-server=utf8
collation-server=utf8_bin
...
 
default_storage_engine=InnoDB
transaction-isolation=READ-COMMITTED
 ...
max_allowed_packet=32M


(참고) 아래 옵션이 지정되어 있다면 삭제할것
sql_mode = NO_AUTO_VALUE_ON_ZERO

InnoDB 엔진 설치여부 확인방법

mysql> show variables like 'have_innodb';  혹은

mysql> show engines;

 MSSQL Server 관련 확인사항

MSSQL Server 의 경우 DB 설정이 SQL_Latin1_General_CP1_CS_AS 으로 collation 설정 되어 대소문자 구분이 가능해야 합니다.

이에 대한 처리방법은 MS SQL Server database collation Skip to end of metadata 에러로 업그레이드 실패 문서를 참조하십시요.

 

 

(6) Confluence 설치폴더의 파일을 수정해 커스터마이즈한 내용에 대해 별도로 기록하기

(7) JIRA의 사용자정보를 Confluence에서 연동하여 사용중인 경우는 반드시 JIRA 4.3 버전 업그레이드 전에 먼저 Confluence 3.5 로 먼저 업그레이드 해야 함

(8) Confluence 3.5.17 에서 5.0.3 으로 버전업 하는 경우 Wiki Markup 에디터가 Rich Text Editor (RTE) 에 통합되므로 사용자가 숙지할 시간 필요한 점을 인지해야 함.

1. Confluence 이전버전 셧다운 및 Confluence 이전버전의 Home 디렉터리 복사본 및 DB 복사본 생성

 - 가능하면 confluencedb522 과 같은 형태로 이름에 버전정보 포함하는 것이 좋음
 - Home 디렉터리는 atlassian-confluence-x.x.x-home 이나 atlassian-confluence-x.x.x-data 와 같은 이름으로 복사 후 변경
 - (주의사항) Home 디렉터리는 Confluence 설치디렉터리 내부에 위치해서는 안됨

2. Confluence 신규버전 다운로드 및 설치 (압축풀기)

 - 최신 버전은 Confluence 최신버전 다운로드 페이지에서 이전 버전 다운로드는 https://www.atlassian.com/software/confluence/download-archives 에서 standalone 버전으로 다운로드하여 적절한 위치에 압축풀기

 

3. Confluence 신규 버전과 (1)에서 복사한 Home 디렉터리 연결하기

 - Home 디렉터리 연결은 (2)의 설치 폴더의 confluence/WEB-INF/classes 폴더내의 confluence-init.properties 파일내에 confluence.home 항목에 복사한 Home 디렉터리 경로를 지정 지정

4. 데이터베이스 드라이버 확인

 - DB연결 전 데이터베이스(MySQL 등) 드라이버 포함여부 확인하고 없는 경우 다운로드(http://dev.mysql.com/downloads/connector/j)하여 복사
 - 데이터베이스 (MySQL 등) 드라이버 복사위치는 <Confluence 설치폴더>/lib (드라이버 파일명은 mysql-connector-java-5.1.x.jar 형태임)

(참조링크) https://confluence.atlassian.com/display/CONF55/Database+Setup+For+MySQL#DatabaseSetupForMySQL-Step6.DownloadandinstalltheMySQLdatabasedriver

5. Confluence 신규 버전과 (1)에서 복사한 DB 및 연결하기

 - DB 연결설정은 일반적으로 <Confluence Home디렉터리> 아래에 있는 confluence.cfg.xml 파일을 수정 (Confluence 이전버전의 파일내용 참조)

 

EAR/WAR 버전에서 Standalone 버전으로 이전 업그레이드하는 경우

1. 업그레이드 할 Confluence 버전을 임시로 다른 경로에 신규로 설치합니다.
 - 임시 DB와 임시 Home 디렉터리 생성 후 구동하여 셋업마법사를 이용해 DB 연결하여 신규설치를 진행해 완료합니다.
 - confluence.cfg.xml 파일을 얻기 위한 목적이므로 해당 파일을 얻고 나면 삭제하시기 바랍니다.

2. (1)에서 생성된 <Home 디렉터리>/confluence.cfg.xml 파일을 업그레이드 진행 할 Confluence의 Home 디렉터리에 복사 후 편집
 - confluence.cfg.xml 파일의 DB 연결 URL을 수정합니다.
 - 기존 버전의 연결설정 중 반영할 파라미터가 있는 경우 반영해 줍니다.

6. 기존 Confluence 의 설정내용을 새로운 Confluence 에 적용하기

 - 아래의 파일들을 기존 Confluence 의 설정파일을 참조하여 적용
 - <Confluence설치폴더>/bin/setenv.sh (윈도우즈의 경우 setenv.bat) (EAR/WAR 버전인 경우 <톰캣(혹은 다른 어플리케이션) 설치폴더>/bin 폴더)
 - <Confluence설치폴더>/conf/server.xml (EAR/WAR 버전인 경우 <톰캣(혹은 다른 어플리케이션) 설치폴더>/conf 폴더) (tick) 톰캣자체와 연관된 부분은 수정하지 말것

 - Crowd 와 연동된 경우 <Confluence설치폴더>/confluence/WEB-INF/seraph-config.xml (EAR/WAR 버전인 경우 webapp/WEB-INF/classes 폴더) 에서 아래 항목을 찾아

<authenticator class="com.atlassian.crowd.integration.seraph.v22.ConfluenceAuthenticator"/>

아래와 같이 변경처리

<authenticator class="com.atlassian.confluence.user.ConfluenceCrowdSSOAuthenticator"/>

 

 - Crowd 혹은 LDAP 연동된 경우 <Confluence설치폴더>/confluence/WEB-INF/atlassian-user.xml (EAR/WAR 버전인 경우 webapp/WEB-INF/classes 폴더), 파일이 없는 경우 이전 Confluence 버전에서 복사
 - LDAP 연동된 경우 <Confluence설치폴더>/confluence/WEB-INF/classes/osuser.xml 파일 (EAR/WAR 버전인 경우 webapp/WEB-INF/classes 폴더), 파일이 없는 경우 이전 Confluence 버전에서 복사

 - Crowd  연동된 경우 <Confluence설치폴더>/confluence/WEB-INF/classes/crowd.properties (EAR/WAR 버전인 경우 webapp/WEB-INF/classes 폴더)

 

7. 기존의 톰캣 캐쉬정보 삭제 (아래 폴더 삭제)

  - <confluence-home>/bundled-plugins
  - <confluence-home>/plugins-cache
  - <confluence-home>/plugins-osgi-cache
  - <confluence-home>/plugins-temp
  - <confluence-home>/bundled-plugins_language
 -  <Confluence-설치폴더>/work/Catalina/localhost

8. 새로운 Confluence 버전 구동

 - 자동으로 업그레이드 진행되고 완료 후 접속가능한 상태가 되면 로그인

9. 업그레이드 이후의 체크사항

 - Confluence 로그 (<Confluence Home 디렉터리>/logs/atlassian-confluence.log 파일) 에 중요한 에러메시지 발생 여부 확인

 - 관리자메뉴에서 각종 Path (인덱스파일, 첨부파일) 와 Base URL 이 정상적으로 설정되었는지 확인

 - 메일기능 동작여부 확인 (tick) 경우에 따라 메일서버에서 새로운 JIRA 서버의 연결을 거부하여 메일기능이 동작하지 않는 경우가 있음

 - 기본적인 기능에 대한 검증 (레이아웃, 메뉴, 검색, 페이지 권한설정, 첨부파일)

 - 사용자 설치 플러그인 동작확인

 - 기존 Confluence 설치 폴더에서 JSP 혹은 VM 파일 등 기타 커스터마이즈 목적으로 수정한 파일이 있는 경우 새로운 Conflence 에서 필요한지 파악 후 필요한 경우 적용 (tick) 새로운 Confluence 버전에서 적용하였을 때 문제가 발생하는 경우, 다른 방법을 검토해야 함

 - Crowd 와 연결되어 SSO 설정된 경우 SSO 연결테스트

 

3.5.17 버전에서 5.0.3 버전으로 업그레이드 후 페이지 데이터가 모두 깨져서 나온다면 5.0.3 업그레이드 진행 시 XHTML 기반의 데이터포멧으로의 변경작업이 제대로 수행되지 않은 것이므로 아래 문서참조하여 수동으로 변환처리해야 함.

https://confluence.atlassian.com/display/DOC/Migration+from+Wiki+Markup+to+XHTML-Based+Storage+Format

 

 

영문가이드

This document describes the procedure for upgrading to the latest version of Confluence on Windows or Linux.

시작하기 전에

  • Check your Confluence licence is valid.
    To check go to Confluence Admin > License Details and make sure the license support period has not expired. If your support period has expired renew your licence and reapply it before proceeding with the upgrade.
  • Check the latest database setup guide for your database and ensure that the database is configured correctly. There may be new configuration requirements. See Database Configuration.

 

 

단계 1 업그레이드 순서 및 방법 결정하기

Find the upgrade path that works for your current version of Confluence and the version you plan to upgrade to.

The following table will help you to determine the most efficient upgrade path from your current version to the latest versions of Confluence. To use the table find your current installed version of Confluence in the left column and follow the suggested path.
  

Your Version

Recommended upgrade path to Confluence 5

2.7 혹은 그 이전버전Manually upgrade to 2.7.4 then upgrade to 3.5.17, and follow paths below.
2.7 to 3.4Manually upgrade to  3.5.17, and follow paths below.

3.5

Upgrade to 5.0.3 then upgrade to the latest version of Confluence 5.

4.0 to 4.3 

Upgrade directly to the latest version of Confluence 5.

5.0 to 5.6

Upgrade directly to the latest version of Confluence 5.

 

There are several factors that will determine the upgrade method you should use. If you:

otherwise you should follow the instructions below and use the Windows or Linux installer to upgrade Confluence.

 

단계 2 테스트 환경에서 Confluence 업그레이드하기

We strongly recommend you recreate your production instance and test the upgrade in this cloned environment.

  1. Create a snapshot of your current production Confluence environment on a test server - see Moving Confluence Between Servers for how to do this.
  2. Follow the steps below to perform the upgrade on your cloned environment.
  3. Test all your unsupported add-ons (plugins) and any customisation (for example custom themes and layouts) with the new version before proceeding with the upgrade in your production environment.

단계 3 백업하기

Before you begin the Confluence upgrade you must back up:

  • your external database
    You must perform a manual backup of your external database and confirm that the backup was created properly. If you are unfamiliar with the backup-restore facilities of your database, you can simply restore the backup to a different system to ensure the backup worked before proceeding.
  • your Confluence Home directory
    The Confluence Home directory is the folder where Confluence stores its configuration information, search indexes and page attachments.  The location of the Home directory is stored in a configuration file called confluence-init.properties, which is located inside the confluence/WEB-INF/classes directory in your Confluence Installation directory.
    if you store attachments outside the Confluence Home directory, you should also backup your attachments directory. 
  • the Confluence installation directory or Confluence webapp (if you are using the EAR-WAR edition)
    This is where the Confluence application files and libraries were unpacked (unzipped) when Confluence was originally installed. Confluence does not modify or store any data in this directory.

The installation wizard will back up your Confluence directories as part of the installation process, but you should also back these directions up manually before starting the upgrade. 

단계 4 운영 시스템에서 Confluence 업그레이드하기

  1. Download the appropriate Windows or Linux installer from the Confluence Download Center.
  2. Start the installer:
    • Windows Users:  run the .exe file.
      If prompted to allow the upgrade wizard to make changes to your computer, choose 'Yes'. If you do not, the installation wizard will have restricted access to your operating system and any subsequent installation options will be limited.
    • Linux users: open a Linux console and change directory (cd) to the '.bin' file directory and execute the '.bin' file. 
      If the '.bin' file is not executable after downloading it, make it executable, for example chmod a+x atlassian-confluence-5.4.1-x64.bin (specify the exact filename of the installer you downloaded).
  3. The installation wizard will guide you through the upgrade process.  Some things to note:
    1. When prompted choose Upgrade an existing Confluence installation (for Linux users this is option 3).
    2. Verify that the Existing Confluence installation directory suggested by the wizard is correct. This is especially important if you have multiple Confluence installations running on the same machine.
    3. At the 'Back up Confluence directories' step, ensure 'Back up Confluence home' is selected. This will create a .zip backup of the Confluence home and installation directories. This is strongly recommended.
    4. The installation wizard will notify you of customisations in the Confluence Installation directory. Make a note of these before proceeding as you will need to manually reapply these customisations after the upgrade is complete.
    5. If you have not already done so, the wizard will prompt you to backup your external database and check plugin compatibility. If your database does not support online backups you will need to stop the installation wizard at this point.
  4. The wizard will shut down your Confluence instance and proceed with the upgrade. Once complete, it will restart Confluence and you can then launch Confluence in your browser to confirm the upgrade was successful.

During the upgrade the wizard will migrate following from your existing Confluence installation:

  • TCP port values in your server.xml file. 
  • Custom values in your confluence-init.properties (confluence.home property) and setenv.sh / setenv.bat files (JAVA_OPTS parameters) 

(warning) Other configurations or customisations (including any other modifications in the server.xml file) are not migrated during the upgrade and need to be reapplied manually. See below for more information.

커스터마이즈가 있는 경우 추가적인 작업

The installation wizard's ability to notify you about customisations will depend on how your existing Confluence instance was installed:

  • If your current Confluence instance was installed using the installer, the wizard will check the entire Confluence Installation directory.
  • If your current Confluence instance was installed manually it will only check the confluence subdirectory of the Confluence Installation directory. The installation wizard will not notify you of modifications in any other directory, for example modifications to start-up scripts under the bin directory or modifications to the server.xml file (such as an SSL configuration). 

If customisations are present you will need to perform the following steps after the upgrade is complete:

  1. Stop the upgraded Confluence instance.
  2. Reapply the customisations to the relevant files in the upgraded Confluence Installation directory.
  3. Restart the upgraded Confluence instance.

We strongly recommend you test your customisations in a test instance prior to upgrading your production instance as changes may have been made to Confluence that make your customisations unsuable.

트러블슈팅

Did something go wrong?

If you need to retry the upgrade, you must restore your pre-upgrade backups first.  Do not attempt to run an upgrade again, or start the older version of Confluence again after an upgrade has failed. 

Some common issues encountered while upgrading:

  • Cannot proceed with upgrade because license has expired
     If your licence has expired and was not renewed and reapplied before upgrading you will receive errors during the upgrade process. See upgrading beyond current license period for information on how to resolve this problem.
  • Unable to proceed with upgrade because of a conflict with anti virus
    Some anti-virus or other Internet security tools may interfere with the Confluence upgrade process and prevent the process from completing successfully, particularly if you run Confluence as a Windows service. If you experience or anticipate experiencing such an issue with your anti-virus / Internet security tool, disable this tool first before proceeding with the Confluence upgrade.
  • Database does not support online backups
    The upgrade wizard will prompt you to backup your database using your database's backup utilities. If your database does not support online backups, stop the upgrade process, shut down Confluence, perform your database backup and then run the installer again to continue with the upgrade.
  • Upgrade is taking a very long time
    If you have a very large database (i.e. database backups take a very long time to complete), setting the confluence.upgrade.recovery.file.enabled  system property  to false  will speed up the upgrade process. It should be used only when there is a process to back up database and verify the backup before performing an upgrade.

You can also refer to the Upgrade Troubleshooting guide in the Confluence Knowledge Base, or check for answers from the community at Atlassian Answers.