업그레이드¶
An upgrade involves moving a database from an older version to a newer supported version (e.g., from Odoo 15.0 to Odoo 17.0). Regular upgrades are crucial as each version offers new features, bug fixes, and security patches. Using a supported version is strongly recommended. Each major version is supported for three years.
Depending on the hosting type and Odoo version used, a database upgrade can be mandatory.
If a database is on a major version (e.g., 15.0, 16.0, 17.0), an upgrade is mandatory every two years.
If a database is on a minor version (e.g., 17.1, 17.2, 17.4), an upgrade is mandatory a few weeks after the next version is released. Minor versions are usually released every three months.
After the initial three years of support, you will have another two years to complete the upgrade. You will be notified when an upgrade is required.
You can stay on the same version indefinitely, even if it is not recommended. Note that the smaller the version gap, the easier the upgrade should be.
You will receive a notification in your database a few weeks before a mandatory upgrade will be automatically carried out. You are in control of the process as long as the deadline is not reached.
Concretely, Odoo’s Upgrade Team performs a silent test upgrade of every database that should be upgraded. If the test is successful and lasts less than 20 minutes, you can directly trigger the upgrade from the database. If the test fails, you can test an upgrade using the database manager.
When you are invited to upgrade, it is strongly recommended to request an upgraded test database first and spend time testing it.
An automatic upgrade to the next version will be triggered if no action is taken before the specified due date.
다음 내용은 업그레이드에 포함되지 않습니다:
경고
If your database contains custom modules, it cannot be upgraded until a version of your custom modules is available for the target version of Odoo. For customers maintaining their own custom modules, we recommend to parallelize the process by requesting an upgraded database while also upgrading the source code of your custom modules.
업그레이드 요약¶
Request an upgraded test database (see obtaining an upgraded test database).
해당하는 경우, Odoo 새 버전과 호환되도록 사용자 지정모듈의 소스 코드를 업그레이드합니다 (Upgrade a customized database 참조).
Thoroughly test the upgraded database (see testing the new version of the database).
Report any issue encountered during the testing to Odoo by going to the Support page and selecting “An issue related to my future upgrade (I am testing an upgrade)”.
모든 문제가 해결되어 업그레이드된 데이터베이스를 문제 없이 기본 데이터베이스로 사용할 수 있다고 확신할 경우에는 프로덕션 데이터베이스의 업그레이드를 계획해 보세요.
Request the upgrade for the production database, rendering it unavailable for the time it takes to complete the process (see upgrading the production database).
Report any issue encountered during the upgrade to Odoo by going to the Support page and selecting “An issue related to my upgrade (production)”.
업그레이드된 테스트 데이터베이스 받기¶
The Upgrade page is the main platform for requesting an upgraded database. However, depending on the hosting type, you can upgrade from the command line (on-premise), the Odoo Online database manager, or your Odoo.sh project.
참고
업그레이드 플랫폼에서는 다른 Odoo.com 서비스와 동일한 개인정보 처리방침 을 따르고 있습니다. 일반개인정보보호법 페이지<https://www.odoo.com/gdpr>`_ 를 방문하여 Odoo에서 데이터 및 개인 정보를 처리하는 방법에 대해 자세히 알아보세요.
Odoo Online databases can be manually upgraded via the database manager.
데이터베이스 관리자에서 사용자 계정과 연결되어 있는 모든 데이터베이스가 표시됩니다. Odoo 최신 버전이 아닌 데이터베이스는 이름 옆에 있는 원 아이콘에 화살표가 표시되어 업그레이드할 수 있음을 나타냅니다.
원 안의 화살표 아이콘을 클릭하여 업그레이드 프로세스를 시작합니다. 팝업에 다음 내용을 입력하세요:
업그레이드하려는 Odoo 버전, 보통은 최신 버전
업그레이드된 데이터베이스 링크를 받을 ** 이메일** 주소
첫 업그레이드 요청 시 업그레이드 목적 이 자동으로 테스트 로 설정됩니다.
데이터베이스 이름 옆에 업그레이드 진행 중 태그가 완료될 때까지 표시됩니다. 프로세스가 완료하면 업그레이드된 테스트 데이터베이스에 대한 링크를 제공된 이메일 주소로 전송합니다. 데이터베이스 이름 앞에 있는 드롭다운 화살표를 클릭하면 데이터베이스 관리자로 데이터베이스에 액세스할 수도 있습니다.
Odoo.sh는 업그레이드 플랫폼과 통합되어 업그레이드 프로세스를 간소화할 수 있습니다.
The latest production daily automatic backup is then sent to the Upgrade platform.
업그레이드 플랫폼에서 백업 업그레이드를 완료하고 브랜치에 업로드하면 특수 모드**로 전환되며, 이는 브랜치에서 **커밋 푸시 가 될 때마다 업그레이드된 백업에 대한 복원 작업 을 수행하며 모든 사용자 지정 모듈 업데이트 를 진행합니다. 이를 통해 업그레이드된 데이터베이스의 원본 복사본에서 사용자 지정 모듈을 테스트할 수 있습니다. 업그레이드 프로세스의 로그 파일은 새로 업그레이드된 스테이징 빌드 의 ~/logs/upgrade.log
에서 확인할 수 있습니다.
중요
사용자 지정 모듈이 설치된 데이터베이스에서는 업그레이드를 하기 전에 반드시 Odoo 대상 버전의 해당 소스 코드가 최신 상태여야 합니다. 그렇지 않은 경우 “커밋 시 업데이트” 모드를 건너뛰고, 업그레이드 플랫폼에서 전송되는 즉시 데이터베이스 업그레이드가 진행되며, 업그레이드 모드는 종료됩니다.
자세한 내용은 Upgrade a customized database 페이지를 확인하세요.
데이터베이스가 호스팅되는 시스템에서 다음 명령줄을 입력하면 표준 업그레이드 프로세스를 시작할 수 있습니다.
$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>
참고
This command has some requirements on the environment it runs in:
Some external commands that must be provided by the operating system, normally found in any Linux distribution (including WSL). An error will be displayed if one or several of them are missing.
The system user that executes the command needs to be configured with access to the database. Please refer to the PostgreSQL documentation of the client environment or the client password file for this requirement.
The script needs to be able to reach one or multiple servers of the upgrade platform both on TCP port 443 and to any random TCP port in the range between 32768 and 60999. This can be in conflict with your restrictive firewall and may need an exception added to the firewall configuration.
다음 명령을 통해 일반 도움말과 기본 명령어를 표시할 수 있습니다:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
중요
데이터베이스에 사용자 지정 모듈을 설치한 경우에는, 업그레이드를 하기 전에 반드시 소스 코드가 대상 Odoo 버전 기준으로 최신 상태여야 합니다. 자세한 내용은 Upgrade a customized database 페이지를 확인하세요.
참고
보안상의 이유로, 업그레이드 요청을 한 사람만 다운로드를 받을 수 있습니다.
저장과 관련된 이유로 데이터베이스 복사본은 파일 저장소 없이 업그레이드 서버에 제출합니다. 따라서 업그레이드된 데이터베이스에는 프로덕션 파일 저장소가 포함되어 있지 않습니다.
업그레이드된 데이터베이스를 복원하기 전에 새 버전과 동일한 조건에서 테스트를 수행할 수 있도록 해당 파일 저장소를 프로덕션 파일 저장소와 병합해야 합니다.
업그레이드된 데이터베이스에서 확인할 수 있는 내용은:
업그레이드 데이터베이스가 포함된
dump.sql
파일`파일 저장소’ 폴더에는 데이터베이스 내부 레코드에서 첨부 파일로 추출된 파일 (있는 경우)과 대상 Odoo 버전의 새로운 표준 Odoo 파일 (예: 새 이미지, 아이콘, 결제대행업체 로고 등)을 보관합니다. 파일 저장소를 완전히 업그레이드하려면 프로덕션 파일 저장소와 폴더를 병합해야 합니다.
참고
업그레이드를 두 번 이상 테스트하려면 테스트 데이터베이스를 여러 개 요청할 수 있습니다.
참고
업그레이드 요청이 완료되면 업그레이드 성공 안내 이메일에 업그레이드 보고서가 첨부되며 “관리/설정” 그룹에 속한 사용자는 메일 및 채팅 앱에서 해당 보고서를 확인할 수 있습니다. 이 보고서에는 새 버전 도입으로 인한 변경 사항과 관련된 중요한 정보를 제공합니다.
데이터베이스 새 버전에 대한 테스트¶
It is essential to test the upgraded test database to ensure that you are not stuck in your day-to-day activities by a change in views, behavior, or an error message once the upgrade goes live.
참고
테스트 데이터베이스를 중립화하고 일부 기능은 프로덕션 데이터베이스에 영향을 미치지 않도록 비활성화됩니다.
예약된 작업이 비활성화됩니다.
기존 메일 서버를 보관하고 가짜로 메일 서버를 추가하여 발신 메일 서버를 비활성화합니다.
결제대행업체 및 배송업체가 테스트 환경으로 재설정됩니다.
은행 동기화가 비활성화되었습니다. 동기화 테스트를 하려면 은행 동기화 제공업체에 문의하여 샌드박스 자격 증명을 받으세요.
최대한 많이 비즈니스 플로우를 테스트하여 비즈니스 플로우가 제대로 작동하는지 확인하고 새 버전에 익숙해지도록 하는 것이 좋습니다.
기본 테스트 체크리스트
테스트 데이터베이스에서는 비활성화 상태이지만 프로덕션 데이터베이스에서는 활성화되어 있는 보기가 있나요?
일반적인 보기가 계속 제대로 표시되나요?
보고서 (청구서, 판매주문서 등)가 제대로 생성되나요?
웹사이트 페이지가 제대로 작동하고 있나요?
레코드를 생성하고 수정할 수 있나요? (판매주문서, 청구서, 매입, 사용자, 연락처, 회사 등)
메일 템플릿에 문제가 있나요?
저장된 번역에 문제가 있나요?
검색 필터가 아직 존재하나요?
데이터를 내보낼 수 있나요?
제품 카탈로그에서 임의의 제품을 확인하고 테스트와 프로덕션 데이터를 비교하여 모든 내용이 동일한지 확인합니다 (제품 카테고리, 판매가, 원가, 공급업체, 계정, 경로 등).
이 제품을 구매합니다 (앱 구매).
이 제품 (재고 관리 앱)을 수신 확인 중입니다.
이 제품을 수신하는 경로가 프로덕션 데이터베이스 (재고 관리 앱)와 동일한지 확인 중입니다.
이 제품 (판매 앱)을 임의의 고객에게 판매합니다.
고객 데이터베이스 (연락처 앱)를 열고 고객 (또는 회사)을 선택한 후 해당 데이터를 확인합니다.
이 제품 (재고 관리 앱)을 배송합니다 .
이 제품의 배송 경로가 프로덕션 데이터베이스 (재고 관리 앱)와 동일한지 확인합니다.
고객 청구서 확인 (청구서 발행 또는 회계 앱)
청구서를 크레딧 처리 후 (대변전표 발행) 프로덕션 데이터베이스에서와 같이 작동하는지 확인합니다.
보고서 결과 확인 (회계 앱)
세금, 통화, 은행 계좌, 회계연도를 무작위로 확인합니다 (회계 앱).
매장의 품목 선택부터 결제 프로세스까지 온라인 주문 (웹사이트 앱)을 한 후 모든 내용이 프로덕션 데이터베이스에서와 동일하게 작동하는지 확인합니다.
이 목록에서 전체를 아우르는 목록이 아닙니다. Odoo 사용에 따라 예시를 다른 앱으로 확장해서 적용해 보세요.
If you face an issue while testing your upgraded test database, you can request the assistance of Odoo by going to the Support page and selecting “An issue related to my future upgrade (I am testing an upgrade)”. In any case, it is essential to report any problem encountered during the testing to fix it before upgrading your production database.
테스트 중에 일반 화면, 기능, 필드 및 모델에 상당한 차이가 발생할 수 있습니다. 해당 변경 사항은 사례별로 되돌릴 수 없습니다. 다만, 새 버전에서 도입된 변경 사항으로 인해 사용자 지정이 중단되는 경우, 사용자 지정 모듈의 유지 관리자의 책임 하에 사용자 지정 모듈을 새 버전의 Odoo와 호환되도록 합니다.
팁
반드시 테스트를 실행합니다:
외부 소프트웨어와의 통합 (EDI, API 등)
다양한 앱 간의 작업 흐름 (전자 상거래를 통한 온라인 판매, 영업제안을 전부 판매주문서로 전환, 품목 배송 등)
데이터 내보내기
자동화된 작업
양식 보기의 활동 메뉴에 있는 서버 작업 및 목록 보기에서 여러 개의 레코드 선택을 통한 작업
프로덕션 데이터베이스 업그레이드하기¶
Once the tests are completed and you are confident that the upgraded database can be used as your main database without any issues, it is time to plan the go-live day.
업그레이드 중에는 프로덕션 데이터베이스를 사용할 수 없습니다. 따라서 데이터베이스를 최소한으로 사용하는 시기에 맞추어 업그레이드를 계획하는 것이 좋습니다.
표준 업그레이드 스크립트 및 데이터베이스가 계속하여 발전하고 있으므로 업그레이드 프로세스가 성공적으로 완료될 수 있도록, 특히 완료하는 데 시간이 오래 걸리는 경우에는 업그레이드된 테스트 데이터베이스를 자주 요청하는 것이 좋습니다. 프로덕션 데이터베이스를 업그레이드하기 전날 업그레이드 프로세스를 충분히 테스트해보는 것도 좋습니다.
중요
테스트를 먼저 실행하지 않고 프로덕션에 들어가게 될 경우에는:
사용자가 변경 사항 및 새로운 기능에 적응할 수 없음
비즈니스 중단 (예: 더 이상 작업을 검증할 수 없음)
고객 경험 악화 (예: 이커머스 웹사이트가 제대로 동작하지 않음)
The process of upgrading a production database is similar to upgrading a test database, but with a few exceptions.
The process is similar to obtaining an upgraded test database, except for the purpose option, which must be set to Production instead of Test.
경고
업그레이드 요청 시 업그레이드가 완료될 때까지 데이터베이스를 사용할 수 없습니다. 프로세스가 완료되면 이전 버전으로 되돌릴 수 없습니다.
The process is similar to obtaining an upgraded test database on the Production branch.
이 프로세스는 브랜치에 새로운 커밋이 생성되는 즉시 **작동**됩니다. 이렇게 하면 업그레이드 프로세스가 사용자 지정 모듈로 업그레이드된 소스 코드 배포와 동기화될 수 있습니다. 사용자 지정 모듈이 없는 경우에는 업그레이드 프로세스가 즉시 연계되어 작동됩니다.
중요
작업 전반에서 데이터베이스를 사용할 수 없습니다. 문제가 발생할 경우, 일반 업데이트와 마찬가지로 플랫폼에서 업그레이드를 자동으로 되돌립니다. 업그레이드가 성공하면 업그레이드 전 데이터베이스의 백업이 생성됩니다.
전체 업그레이드 프로세스를 완료하려면 커스텀 모듈의 업데이트가 성공해야 합니다. 프로덕션 환경에서 시도하기 전에 스테이지 업그레이드의 상태가 성공`인지 확인하세요. 사용자 정의 모델을 업그레이드하는 자세한 방법은 :doc:/developer/howtos/upgrade_custom_db`에서 확인하실 수 있습니다.
데이터베이스를 프로덕션으로 업그레이드하는 명령어는 테스트 데이터베이스를 업그레이드하는 명령어와 유사하며 반드시 test
인수를 `production`으로 대체해야 합니다.
$ python <(curl -s https://upgrade.odoo.com/upgrade) production -d <your db name> -t <target version>
An upgraded production database can also be requested via the Upgrade page.
Once the database is uploaded, any modification to your production database will not be present on your upgraded database. This is why we recommend not using it during the upgrade process.
중요
프로덕션 목적으로 업그레이드된 데이터베이스를 요청할 경우 파일 저장소 없이 복사본이 제출됩니다. 따라서 새 버전을 배포하기 전에 업그레이드된 데이터베이스 파일 저장소를 프로덕션 파일 저장소와 병합해야 합니다.
In case of an issue with your production database, you can request the assistance of Odoo by going to the Support page and selecting “An issue related to my future upgrade (I am testing an upgrade)”.
서비스 수준 계약 (SLA : Service-level agreement)¶
Odoo 엔터프라이즈를 사용하면 Odoo 데이터베이스를 최신 버전으로 무료 이며, 업그레이드 데이터베이스에서 가능한 모든 불일치 사항을 수정하도록 지원하는 것까지 포함됩니다.
기업 라이선스에 포함되어 있는 업그레이드 서비스에 대한 정보는 Odoo 엔터프라이즈 구독 계약서 에서 확인할 수 있습니다. 다만 이 섹션에서는 업그레이드 서비스에 어떤 내용이 있는지 설명합니다.
SLA가 적용되는 업그레이드 서비스¶
Odoo의 클라우드 플랫폼 (Odoo 온라인 및 Odoo.sh) 또는 자체 호스팅 (온프레미스)에서 호스팅되는 데이터베이스는 다음과 같은 업그레이드 서비스를 항상 이용할 수 있습니다.
모든 표준 애플리케이션 에 대한 업그레이드;
스튜디오가 설치되어 있고 구독이 계속 활성화된 상태인 경우 스튜디오 앱으로 생성된 모든 사용자 지정 항목 을 업그레이드하며,
맞춤형 구독에 대한 유지 관리가 적용되는 모든 개발 및 사용자 지정 항목 을 업그레이드합니다.
업그레이드 서비스는 업그레이드 대상 버전과 호환되도록 데이터베이스 (표준 모듈 및 데이터)를 기술적으로 변환하고 조정하는 것으로 제한됩니다.
SLA가 적용되지 않는 업그레이드 서비스¶
다음 업그레이드 관련 서비스는 포함되지 않습니다:
업그레이드 중에 기존 데이터 및 환경 설정 정리
Odoo 파트너를 포함하여, 자체 제작 혹은 타사에서 제작한 맞춤형 모듈 업그레이드;
표준 모듈에 추가된 코드 줄, 예를 들면 스튜디오 앱 외부에서 커스터마이징한 경우, 수동으로 입력한 코드 및 Python 코드를 사용한 자동화 작업; 및
업그레이드 버전의 기능 및 작업 흐름 사용에 대한 교육.