버그 수정 업데이트

소개

최신 개선 내용, 보안 수정, 버그 수정 및 성능 향상을 적용 받는 혜택을 받으려면 가끔씩 Odoo 설치 업데이트를 해야 할 수 있습니다.

본 안내 사항은 자체 호스팅 인프라에서 Odoo를 사용하는 경우에만 적용됩니다. Odoo 클라우드 솔루션 중에서 사용하는 경우 업데이트가 자동으로 수행됩니다.

소프트웨어 업데이트와 관련된 용어는 혼동되는 경우가 많으므로 다음과 같이 몇 가지 사전 정의를 안내해 드립니다.

업데이트 (Odoo 설치)

현재 사용 중인 Odoo 에디션에 대한 소스 코드의 최신 버전을 얻는 프로세스를 의미합니다. 예를 들어, Odoo 엔터프라이즈 13.0을 최신 버전으로 업데이트하는 것을 뜻합니다. 이 작업때문에 Odoo 데이터베이스 내용이 직접 변경되지는 않으며, 이전 버전의 소스 코드를 재설치하여 실행 취소할 수 있습니다.

업그레이드 (Odoo 데이터베이스)

데이터베이스의 구조 및 내용이 Odoo 새 버전과 호환되도록 영구적으로 변경하는 복잡한 데이터 처리 작업을 의미합니다. 작업은 되돌릴 수 없으며, 일반적으로 Odoo 최신 버전으로 전환하기로 결정한 경우 Odoo의 ‘데이터베이스 업그레이드 서비스 <https://upgrade.odoo.com>`_’를 통해 진행됩니다. 역사적으로 이 프로세스는 업그레이드 후 데이터베이스가 동일한 물리적 위치에 있더라도 데이터베이스 내부에서 데이터를 이동하기 때문에 “마이그레이션”이라고도 합니다.

이 페이지에서는 Odoo 설치를 최신 버전으로 *업데이트*하는 데 필요한 일반적인 단계에 대해 설명되어 있습니다. 데이터베이스 업그레이드에 대한 자세한 내용은 ‘Odoo 업그레이드 페이지 <https://upgrade.odoo.com>`_를 참조하세요.

한 마디로,

Odoo를 업데이트하려면, 현재 설치 내용에 최신 버전 Odoo 에디션을 재설치하기만 하면 됩니다. 이렇게 할 경우 PostgreSQL (Odoo와 함께 제공되는 데이터베이스 엔진)을 제거하지 않는 한 데이터를 변경하지 않고 보존할 수 있습니다.

업데이트에 대한 주로 참조할 수 있도록 논리적으로 일반적인 설치 방법을 설명하는 설치 가이드 를 확인해 보세요.

업데이트 절차는 매우 유사하기 때문에 Odoo를 초기 배포했던 담당자가 수행하는 것이 가장 적절합니다.

참고

저희는 언제나 최신판 Odoo 버전 전체를 다운로드 받으시는 것이, 보안 안내 사항과 함께 제공해드리는 보안 패치와 같은 서비스 패치를 직접 적용하시는 것보다 바람직하다고 권해드리고 있습니다. 설치 항목에 커스터마이징 항목이 극도로 많이 반영된 경우나, 기술 담당자가 전체 업데이트 테스트 중에 일시적으로 최소한만 변경하고자 하는 경우에 주로 패치를 사용하게 됩니다.

1단계: 업데이트된 Odoo 버전 다운로드하기

메인 다운로드 페이지는 https://www.odoo.com/page/download 입니다. Odoo 엔터프라이즈 다운로드를 하는 “구매” 링크가 표시되면 Odoo 엔터프라이즈 구독 항목 연결을 할 때 동일한 로그인으로 Odoo.com에 로그인되었는지 확인하세요.

또는 Odoo 엔터프라이즈 구매 확인 이메일에 있는 고유 다운로드 링크를 사용할 수 있습니다.

참고

Github를 통해 설치한 경우에는 업데이트된 버전을 다운로드할 필요가 없습니다 (아래 내용 참조).

2단계: 데이터베이스 백업 만들기

업데이트 절차는 매우 안전하며 데이터를 변경하지 안 됩니다. 그러나 설치 변경을 하기 전에 항상 전체 데이터베이스를 백업한 후 다른 안전한 컴퓨터에 저장하는 것이 가장 좋습니다.

데이터베이스 관리자 화면을 비활성화하지 않은 경우 (해야 하는 이유를 :ref:`여기 <security>`에서 참조), 활성화하여 (데이터베이스 선택 화면 하단에 있는 링크) 데이터베이스 백업을 다운로드할 수 있습니다. 비활성화한 경우에는 일반적인 백업 절차와 동일하게 진행합니다.

3단계: 업데이트된 버전 설치

현재 설치할 내용에 맞는 방법을 선택합니다.

설치 패키지

웹사이트에서 다운로드한 설치 패키지를 사용하여 Odoo를 설치한 경우 (권장 방법), 업데이트 프로세스는 간단합니다. 시스템에 맞는 설치 패키지를 다운로드하고 (1단계 참조) 서버에 설치하기만 하면 됩니다. 이러한 패키지는 매일 업데이트되며 최신 보안 수정 사항이 포함되어 있습니다. 일반적으로 패키지를 두 번 클릭하여 설치하면 기존 설치 파일 위에 설치됩니다. 설치가 완료된 후 Odoo 서비스를 다시 시작하거나 서버를 재부팅하면 모든 준비가 완료됩니다.

설치 소스 (Tarball)

원래 “Tarball” 버전 (소스 코드 아카이브)으로 Odoo를 설치한 경우에는, 설치 디렉토리를 최신 버전으로 바꿔야 합니다. 먼저 Odoo.com에서 최신 Tarball을 다운로드합니다. 업데이트는 매일 시행되며 최신 보안 수정 사항이 포함되어 있습니다 (1단계 참조). 패키지를 다운로드한 후 서버의 임시 위치에 압축을 풉니다.

소스 코드 버전이 표시된 폴더가 예를 들어, “odoo-13.0+e.20190719”와 같이 생성되며, “odoo.egg-info” 폴더와 “odoo” (Odoo 10 이상)라는 실제 소스 코드 폴더나 이전 버전의 경우 “openerp”라는 이름으로 폴더가 표시됩니다. odoo.egg-info 폴더는 무시해도 됩니다. 현재 설치 중인 내용이 배포된 폴더를 찾아 방금 압축을 푼 아카이브에 있는 최신 “odoo” 또는 “openerp” 폴더로 바꿉니다.

폴더 레이아웃이 일치하는지 확인합니다. 예를 들어 소스 코드에 포함된 새로운 “addons” 폴더는 이전과 동일한 경로에 있어야 합니다. 다음으로, 이전 폴더에서 직접 복사하거나 수정되었을 수 있는 특정 구성 파일을 찾아서 새 폴더에 복사합니다. 마지막으로 Odoo 서비스를 다시 시작하거나 컴퓨터를 재부팅하면 모든 설정이 완료됩니다.

소스 설치 (Github)

공식 리포지토리의 전체 Github 복제본으로 Odoo를 원래 설치한 경우 업데이트 절차에서 git을 통해 최신 소스 코드를 가져와야 합니다. 각 저장소 (기본 Odoo 저장소 및 엔터프라이즈 저장소)의 디렉토리로 변경한 후 다음 명령을 실행합니다.

git fetch
git rebase --autostash

Odoo 소스 코드를 로컬에서 편집한 경우 마지막 명령어에서 소스 코드가 충돌할 수 있습니다. 오류 메시지에서 충돌이 있는 파일 목록이 표시되므로, 충돌 항목을 수정하고 유지할 코드를 정하여 충돌을 수동으로 해결해야 합니다.

또는 변경 사항이 충돌할 경우 간단히 삭제한 후 공식 버전을 복원하려는 경우에는 다음 명령어를 사용할 수 있습니다.

git reset --hard

마지막으로 Odoo 서비스를 다시 시작하거나 컴퓨터를 재부팅하면 작업이 완료됩니다.

도커

업데이트에 대한 구체적인 안내 사항은 도커 이미지 문서 를 참조하세요.