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 proyek 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.
Di database manager, tombol Connect akan digantikan oleh tombol Upgrading... yang tidak dapat diklik hingga selesai. Setelah proses berhasil, email yang berisi tautan ke database uji yang telah diupgrade dikirim ke alamat yang diberikan. Database uji juga dapat diakses dari database manager dengan mengklik tombol (caret down) sebelum nama database untuk menampilkan database uji, kemudian klik Connect.
Odoo.sh terintegrasi dengan platform upgrade untuk menyederhanakan proses upgrade.
Cadangan otomatis harian produksi terbaru kemudian dikirim ke platform Upgrade.
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
Perintah ini memiliki beberapa persyaratan pada lingkungan tempat perintah dijalankan:
Beberapa perintah eksternal yang harus disediakan oleh sistem operasi, biasanya ditemukan di distribusi Linux mana pun (termasuk WSL). Kesalahan akan ditampilkan jika satu atau beberapa di antaranya hilang.
User sistem yang menjalankan perintah perlu dikonfigurasi dengan akses ke database. Silakan lihat dokumentasi PostgreSQL tentang lingkungan klien atau file kata sandi klien untuk persyaratan ini.
Skrip perlu dapat menjangkau satu atau beberapa server platform upgrade baik pada port TCP 443 maupun ke port TCP acak mana pun dalam rentang antara 32768 dan 60999. Hal ini dapat bertentangan dengan firewall ketat Anda dan mungkin memerlukan pengecualian yang ditambahkan ke konfigurasi firewall.
Command berikut dapat digunakan untuk menampilkan bantuan umum dan command-command utama:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
Database uji yang ditingkatkan juga dapat diminta melalui halaman Upgrade.
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¶
Sangat penting untuk menguji database uji yang ditingkatkan guna memastikan bahwa Anda tidak terhambat dalam aktivitas sehari-hari oleh perubahan tampilan, perilaku, atau pesan kesalahan setelah upgrade diterapkan.
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.
Jika Anda menghadapi masalah saat menguji database uji yang ditingkatkan, Anda dapat meminta bantuan Odoo dengan membuka halaman Dukungan dan memilih "An issue related to my future upgrade (I am testing an upgrade)". Bagaimanapun, penting untuk melaporkan masalah apa pun yang ditemui selama pengujian untuk memperbaikinya sebelum meningkatkan database produksi Anda.
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¶
Setelah pengujian selesai dan Anda yakin bahwa database yang ditingkatkan dapat digunakan sebagai database utama Anda tanpa masalah apa pun, saatnya merencanakan hari peluncuran.
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)
Proses peningkatan database produksi mirip dengan peningkatan database uji, tetapi dengan beberapa pengecualian.
Prosesnya mirip dengan mendapatkan database uji yang ditingkatkan, kecuali untuk opsi tujuan, yang harus diatur ke Production alih-alih Test.
Peringatan
Setelah upgrade diminta, database akan tidak tersedia sampai upgrade selesai. Setelah proses selesai, tidak mungkin untuk memutar balik ke versi sebelumnya.
Prosesnya mirip dengan mendapatkan database uji yang ditingkatkan pada cabang Production.
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>
Database produksi yang ditingkatkan juga dapat diminta melalui halaman Upgrade.
Setelah database diunggah, modifikasi apa pun pada database produksi Anda tidak akan ada pada database yang ditingkatkan. Inilah sebabnya kami menyarankan untuk tidak menggunakannya selama proses upgrade.
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
Jika terjadi masalah dengan database produksi Anda, Anda dapat meminta bantuan Odoo dengan membuka halaman Dukungan dan memilih "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;
upgrade modul tambahan yang tidak tercakup dalam kontrak maintenance yang dibuat secara internal atau oleh pihak ketiga, termasuk partner Odoo; dan
training untuk menggunakan fitur-fitur dan alur kerja dari versi yang diupgrade.
Lihat juga