Upgrade¶
Aktivitas upgrade melibatkan pemindahan database dari versi lama ke versi lebih baru yang didukung (misalnya, dari Odoo 16.0 ke Odoo 18.0). Upgrade rutin sangat penting karena setiap versi menawarkan fitur baru, perbaikan bug, dan patch keamanan. Penggunaan versi yang didukung sangat dianjurkan. Setiap versi utama didukung selama tiga tahun.
Upgrade database dapat bersifat wajib tergantung jenis hosting dan versi Odoo yang digunakan.
Jika database menggunakan versi utama (misalnya, 16.0, 17.0, 18.0), upgrade wajib dilakukan setiap dua tahun.
Jika database menggunakan versi minor (misalnya, 17.1, 17.2, 17.4), upgrade wajib dilakukan beberapa minggu setelah versi berikutnya dirilis. Versi minor biasanya dirilis setiap dua bulan.
Setelah tiga tahun dukungan awal, akan ada dua tahun lagi untuk menyelesaikan upgrade. Anda akan diberi tahu ketika harus melakukan upgrade.
Anda tetap dapat menggunakan versi yang sama tanpa batas waktu, meskipun hal ini tidak dianjurkan. Perhatikan bahwa makin kecil perbedaan versi, makin mudah pula upgrade-nya.
Anda akan menerima notifikasi di database beberapa minggu sebelum upgrade wajib dilakukan secara otomatis. Anda yang menentukan prosesnya selama tenggat waktu belum tercapai.
Secara konkret, Tim Upgrade Odoo melakukan uji upgrade senyap pada setiap database yang harus di-upgrade. Jika pengujian berhasil dan berlangsung kurang dari 20 menit, Anda dapat langsung memicu upgrade dari database. Jika pengujian gagal, Anda dapat menguji upgrade menggunakan pengelola database.
Ketika Anda diundang untuk upgrade, sangat dianjurkan untuk meminta database uji coba yang sudah upgrade terlebih dahulu dan meluangkan waktu untuk mengujinya.
Upgrade otomatis ke versi berikutnya akan terpicu jika tidak ada tindakan yang diambil sebelum tanggal jatuh tempo yang ditentukan.
Upgrade tidak mencakup:
Downgrade ke versi Odoo yang sebelumnya
Mengubah edisi (misal, dari Community ke Enterprise)
Mengubah tipe hosting (misal, dari on-premise menjadi Odoo Online)
Migrasi dari ERP lain ke Odoo
Peringatan
Jika database Anda berisi modul kustom, database tidak dapat di-upgrade hingga versi modul kustom Anda tersedia untuk versi target Odoo. Untuk pelanggan yang tetap menggunakan modul kustomnya sendiri, kami merekomendasikan untuk memparalelkan prosesnya dengan meminta database yang di-upgrade sekaligus meng-upgrade kode sumber modul kustom Anda.
Mengupgrade secara singkat¶
Minta database uji coba yang di-upgrade (lihat mendapatkan database uji coba yang di-upgrade).
Bila dapat dilakukan, upgrade source code modul custom Anda untuk lebih kompatibel dengan versi Odoo yang baru (lihat Upgrade a customized database).
Uji database yang telah di-upgrade secara menyeluruh (lihat menguji versi baru database).
Laporkan masalah apa pun yang ditemui selama pengujian kepada Odoo dengan membuka halaman Dukungan dan memilih "Masalah terkait upgrade mendatang saya (Saya sedang menguji upgrade)".
Setelah semua masalah diselesaikan dan Anda yakin database yang diupgrade dapat digunakan sebagai database utama Anda tanpa masalah apa pun, rencanakan upgrade database production Anda.
Minta upgrade untuk database produksi. Hal ini membuat database tidak tersedia selama waktu yang diperlukan untuk menyelesaikan proses (lihat meng-upgrade database produksi).
Laporkan masalah apa pun yang ditemui selama upgrade kepada Odoo dengan membuka halaman Dukungan dan memilih "Masalah terkait upgrade saya (produksi)".
Mendapatkan database test yang diupgrade¶
Halaman Upgrade adalah platform utama untuk meminta database yang di-upgrade. Namun, tergantung jenis hosting-nya, Anda dapat melakukan upgrade dari command line (on-premise), pengelola database Odoo Online, atau proyect Odoo.sh Anda.
Catatan
Platform Upgrade mengikuti Kebijakan Privasi yang sama dengan layanan Odoo.com lainnya. Kunjungi Halaman Peraturan Perlindungan Data Umum untuk mempelajari lebih lanjut bagaimana Odoo menangani data dan kebijakan Anda.
Untuk meng-upgrade database Odoo Online:
Buka pengelola database.
Pilih database dan klik Kelola.
Klik Upgrade di bagian Database.
Pada popup:
Pilih versi Odoo yang ingin di-upgrade, biasanya versi terbaru.
Masukkan Email untuk notifikasi, yang akan menerima tautan ke database yang telah di-upgrade.
Pilih Tujuan upgrade, yang otomatis diatur ke Uji Coba untuk permintaan upgrade pertama.
Klik Upgrade.
In the database manager, the Connect button will be replaced by an unclickable Upgrading... button until completion. Once the process is successful, an email containing a link to the upgraded test database is sent to the address provided. The test database can also be accessed from the database manager by clicking the (caret down) button before the database name to display the test database, then clicking Connect.
Odoo.sh terintegrasi dengan platform upgrade untuk menyederhanakan proses upgrade.
The latest production daily automatic backup is then sent to the Upgrade platform.
Setelah platform upgrade selesai mengupgrade backup dan mengunggahnya ke branch, akan dimasukkan ke mode spesial: setiap kali commit didorong ke branch, restore operation dari backup yang diupgrade dan update dari semua modul custom akan terjadi. Ini memungkinkan Anda untuk mengetes modul custom Anda pada salinan baru dari database yang diupgrade. Log file proses upgrade dapat ditemukan di staging build Anda yang baru diupgrade dengan membuka ~/logs/upgrade.log.
Penting
Di database di mana modul custom diinstal, source code mereka harus up-to-date dengan versi tujuan Odoo sebelum upgrade dapat dilakukan. Bila tidak ada modul custom, mode "update saat commit" akan dilewati, database yang diupgrade dibangun langsung setelah ditransfer dari platform upgrade, dan lalu akan keluar dari mode upgrade.
Periksa halaman Upgrade a customized database untuk informasi lebih lanjut.
Proses upgrade standar dapat dimulai dengan memasukkan command line berikut pada mesin di mana database dihosting:
$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>
Catatan
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.
Command berikut dapat digunakan untuk menampilkan bantuan umum dan command-command utama:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
Penting
Di database di mana modul custom diinstal, source code mereka harus up-to-date dengan versi target Odoo sebelum upgrade dapat dilakukan. Periksa halaman Upgrade a customized database untuk lebih banyak informasi.
Catatan
Untuk alasan keamanan, hanya mereka yang menyerahkan permintaan upgrade dapat mengunduhnya.
Untuk alasan penyimpanan, salinan database diserahkan tanpa filestore ke server upgrade. Oleh karena itu, database yang diupgrade tidak memiliki filestore production.
Sebelum memulihkan database yang diupgrade, filestore harus dimerge dengan filestore production untuk dapat melakukan ujian dengan kondisi yang sama dengan yang di versi baru.
Database yang diupgrade memiliki:
File
dump.sqlyang memiliki database yang diupgradeFolder
filestoreyang memiliki file yang diekstrak dari record di database menjadi lampiran (bila ada) dan file standar baru Odoo dari versi Odoo tujuan (misal, gambar, ikon, logo penyedia pembayaran yang baru, dsb.). Ini adalah folder yang harus dimerge dengan filestore production agar dapat mendapatkan filestore lengkap yang diupgrade.
Catatan
Anda dapat meminta lebih dari satu database test bila Anda ingin menguji upgrade lebih dari sekali.
Catatan
Saat permintaan upgrade selesai, laporan upgrade dilampirkan ke email upgrade sukses, dan tersedia di app Discuss untuk user yang merupakan bagian dari kelompok "Administrasi / Pengaturan". Laporan ini menyediakan informasi penting mengenai perubahan yang muncul di versi baru.
Menguji versi baru database¶
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.
Catatan
Test database dinetralisir, dan beberapa fitur dinonaktifkan untuk mencegah mereka mengubah database production:
Action yang dijadwalkan dinonaktifkan.
Server email keluar dinonaktifkan dengan mengarsipkan yang aktif saat ini dan menambahkan satu yang palsu.
Penyedia pembayaran dan carrier pengirim direset ke environment testing.
Sinkronisasi bank dinonaktifkan. Apabila Anda ingin mengetes sinkronisasi, hubungi penyedia sinkronisasi bank Anda untuk mendapatkan kredensial sandbox.
Menguji sebanyak mungkin alur bisnis sangat disarankan untuk memastikan mereka semua bekerja dengan benar dan agar lebih terbiasa dengan versi baru.
Checklist basic test
Apakah ada tampilan yang dinonaktifkan di test database Anda tapi aktif di database production Anda?
Apakah tampilan biasa Anda masih ditampilkan dengan tepat?
Apakah laporan Anda (faktur, sales order, dsb.) dengan tepat dibuat?
Apakah halaman website Anda bekerja dengan benar?
Apakah Anda dapat membuat dan memodifikasi record? (sales order, faktur, pembelian, user, kontak, perusahaan, dsb.)
Apakah ada masalah apa pun dengan templat email Anda?
Apakah ada masalah apa pun dengan terjemahan yang tersimpan?
Apakah filter pencarian Anda masih tersedia?
Apakah Anda dapat mengekspor data Anda?
Memeriksa produk secara acak di katalog produk Anda dan membandingkan data test dan production untuk memverifikasi bahwa semuanya masih sama (kategori produk, harga jual, harga biaya, vendor, akun, rute, dsb.).
Membeli produk ini (app Purchase).
Mengonfirmasi penerimaan produk ini (app Inventaris).
Memeriksa bila rute untuk menerima produk ini sama seperti di database production Anda (app Inventaris).
Menjual produk ini (app Sales) untuk pelanggan secara acak.
Membuka database pelanggan Anda (app Kontak), memilih pelanggan (atau perusahaan), dan memeriksa datanya.
Mengirim produk ini (app Inventaris).
Memeriksa bila rute untuk mengirim produk ini sama seperti di database production Anda (app Inventaris).
Memvalidasi faktur pelanggan (app Faktur atau Akuntansi).
Memberikan faktur kredit (mengirim nota kredit) dan memeriksa apakah bertindak secara sama seperti di database production Anda.
Memeriksa hasil laporan Anda (app Akuntansi).
Secara acak memeriksa pajak, mata uang, akun bank, dan tahun fiskal Anda (app Akuntansi).
Membuat pesanan online (app Website) dari pilihan produk di toko Anda sampai proses checkout dan memeriksa bila semuanya bertindak seperti di database production Anda.
Daftar ini tidak lengkap. Tambahkan sampel untuk app lain berdasarkan penggunaan Odoo Anda.
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.
Anda mungkin menemukan perbedaan signifkan dengan tampilan standar, fitur, field, dan model selama testing. Perubahan-perubahan tersebut tidak dapat diputar-balk pada basis kasus-per-kasus. Namun, bila perubahan yang dilakukan oleh versi baru merusak kustomisasi, adalah tanggung jawab pengelola modul custom Anda untuk membuatnya kompatibel dengan versi baru Odoo.
Tip
Jangan lupa untuk menguji:
Integrasi dengan software eksternal (EDI, API, dsb.)
Alur kerja di antara app-app berbeda (sales online dengan eCommerce, mengonversi lead sampai ke sales order, pengiriman produk, dsb.)
Ekspor data
Tindakan Otomatis
Action server di menu action pada tampilan form, serta juga dengan mengeklik lebih dari satu record pada tampilan list
Mengupgrade database production¶
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.
Database production Anda akan tidak tersedia selama upgrade. Oleh karena itu, kami menyarankan merencanakan upgrade pada waktu di mana penggunaan database minim.
Karena script upgrade standar dan database Anda secara konstan berevolusi, disarankan untuk sering meminta test database upgrade lain untuk memastikan proses upgrade masih sukses, terutama bila membutuhkan waktu yang lama untuk selesai upgrade. Secara lengkap melatih proses upgrade sehari sebelum mengupgrade database production juga disarankan.
Penting
Menggunakan production sebelum testing terlebih dahulu mungkin berujung pada:
User gagal beradaptasi dengan perubahan dan fitur-fitur baru
Gangguan bisnis (contoh, tidak lagi memiliki opsi untuk memvalidasi action)
Pengalaman pelanggan yang buruk (contoh, website eCommerce yang tidak bekerja dengan tepat)
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.
Peringatan
Setelah upgrade diminta, database akan tidak tersedia sampai upgrade selesai. Setelah proses selesai, tidak mungkin untuk memutar balik ke versi sebelumnya.
The process is similar to obtaining an upgraded test database on the Production branch.
Proses dipicu setelah commit baru dibuat pada branch. Ini memungkinkan proses upgrade untuk disinkronisasi dengan deployment source code modul custom yang diupgrade. Bila tidak ada modul custom, proses upgrade akan langsung dipicu.
Penting
Database tidak tersedia selama proses. Bila terjadi kesalahan, platform secara otomatis memutar balik upgrade, sama seperti pada update reguler. Apabila sukses, backup dari database sebelum upgrade akan dibuat.
Update modul custom Anda harus sukses untuk menyelesaikan seluruh proses upgrade. Pastikan status upgrade staging Anda sukses sebelum mencobanya di production. Informasi lebih lanjut mengenai bagaimana untuk mengupgrade modul custom Anda dapat ditemukan di Upgrade a customized database.
Command untuk mengupgrade database ke production mirip dengan cara mengupgrade database test kecuali untuk argumen test, yang harus diganti dengan 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.
Penting
Saat meminta database diupdrage untuk tujuan production, salinan akan diserahkan tanpa filestore. Oleh karena itu, filestore database yang diupgrade harus digabung dengan filestore production sebelum mendeploy versi baru
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 upgrade (production)".
Perjanjian Tingkat Layanan (SLA)¶
Dengan Odoo Enterprise, mengupgrade database ke versi terbaru Odoo gratis, termasuk bantuan apa pun yang dibutuhkan untuk memperbaiki kemungkinan ketidaksamaan apa pun di database yang diupgrade.
Informasi mengenai layanan upgrade yang termasuk di Enterprise License tersedia di Odoo Enterprise Subscription Agreement. Namun, bagian ini mengklarifikasi apa layanan upgrade yang Anda dapat harapkan.
Layanan upgrade yang termasuk SLA¶
Database yang dihosting pada platform cloud Odoo (Odoo Online dan Odoo.sh) atau self-host (On-Premise) dapat memanfaatkan layanan upgrade kapan pun juga untuk:
upgrade untuk semua aplikasi standar;
upgrade untuk semua kustomisasi yang dibuat dengan app Studio, selama Studio masih diinstal dan langganan terkait masih aktif; dan
upgrade untuk semua development dan kustomisasi yang dibuat oleh pengelola langganan kustomisasi.
Layanan upgrade terbatas ke konversi teknis dan adapatasi database (modul dan data standar) agar membuatnya kompatibel dengan versi tujuan upgrade.
Layanan upgrade tidak termasuk SLA¶
Layanan terkait upgrade berikut tidak termasuk:
pembersihan data yang tersedia sebelumnya dan konfigurasi selagi mengupgrade;
the upgrade of additional modules not covered by a maintenance contract that are created in-house or by third parties, including Odoo partners; and
training untuk menggunakan fitur-fitur dan alur kerja dari versi yang diupgrade.
Lihat juga