Checklist Upgrade Odoo 19: Sebelum, Selama, dan Sesudah
Checklist upgrade Odoo 19 yang praktis: inventaris modul, pembersihan data, staging, test upgrade berulang, uji laporan, cut-over, hingga rencana rollback.
Upgrade Odoo 19 paling aman dijalankan dengan checklist yang jelas, bukan dengan semangat "langsung coba saja". Artikel ini merangkum langkah yang perlu Anda centang sebelum, selama, dan sesudah upgrade, mulai dari inventaris modul sampai rencana rollback. Gunakan sebagai daftar kerja bersama antara tim IT, tim keuangan, dan vendor implementasi Anda.
Jika Anda ingin membaca cerita lapangan tentang apa saja yang benar-benar terjadi saat proyek upgrade berjalan, baca juga pelajaran dari upgrade Odoo 19. Artikel ini sengaja dibuat lebih ringkas dan bisa langsung dipakai.
Mengapa upgrade Odoo 19 butuh checklist
Upgrade versi mayor Odoo bukan sekadar mengganti kode. Struktur data ikut berubah. Di Odoo 19, misalnya, data kontrak karyawan berpindah dari model hr.contract ke model hr.version. Model product.packaging dan uom.category juga sudah tidak ada. Modul custom yang bergantung pada model tersebut harus disesuaikan, dan datanya harus dipindahkan dengan benar.
Tanpa checklist, hal kecil mudah terlewat. Satu view lama yang tidak kompatibel bisa membuat proses upgrade gagal. Satu salary rule yang tidak termigrasi bisa membuat payroll bulan berikutnya salah hitung. Checklist membantu Anda melihat semua risiko sejak awal.
Checklist sebelum upgrade
1. Inventaris modul
Buat daftar lengkap semua modul yang terpasang. Pisahkan menjadi tiga kelompok:
Modul standar Odoo, yang akan ikut diperbarui oleh proses upgrade resmi.
Modul pihak ketiga, misalnya dari OCA atau marketplace aplikasi. Cek apakah sudah tersedia versi untuk Odoo 19.
Modul custom buatan sendiri, yang wajib di-port oleh tim pengembang.
Tandai juga modul yang sebenarnya sudah tidak dipakai. Upgrade adalah momen yang tepat untuk membuang beban lama. Semakin sedikit modul, semakin kecil risiko.
2. Petakan perubahan model dan fitur
Tertarik berdiskusi lebih lanjut?
Tim kami siap membantu Anda mengimplementasikan solusi terbaik.
Untuk setiap modul custom, cek model dan field yang dipakai. Apakah ada yang dihapus atau dipindah di Odoo 19? Catat semua temuan dalam satu dokumen. Dokumen ini nanti menjadi dasar penulisan skrip migrasi pre-migrate dan post-migrate.
3. Pembersihan data
Data kotor memperlambat upgrade dan sering menjadi penyebab error. Sebelum mulai, lakukan:
Hapus atau arsipkan draf transaksi yang tidak akan pernah diproses.
Rapikan produk duplikat dan satuan ukur yang tidak konsisten.
Pastikan tidak ada jurnal yang menggantung atau tidak seimbang.
Cek data karyawan, kontrak, dan struktur gaji yang masih aktif.
4. Siapkan lingkungan staging
Jangan pernah menguji upgrade di database production. Siapkan salinan database di lingkungan staging. Jika Anda memakai Odoo.sh, gunakan branch staging atau branch preview khusus. Jika memakai server sendiri, buat server terpisah dengan spesifikasi yang mendekati production.
5. Tentukan kriteria sukses
Tuliskan apa arti "upgrade berhasil" bagi bisnis Anda. Contohnya: neraca dan laba rugi per tanggal tertentu sama persis sebelum dan sesudah upgrade, payslip bulan terakhir menghasilkan angka yang identik, dan stok per gudang tidak berubah.
Checklist selama upgrade
6. Port modul custom dan tulis skrip migrasi
Modul custom harus disesuaikan dengan API dan struktur data Odoo 19. Data yang berpindah model perlu skrip migrasi. Pre-migrate dijalankan sebelum modul diperbarui, misalnya untuk membereskan view lama yang akan bentrok. Post-migrate dijalankan sesudahnya, misalnya untuk memindahkan data ke model baru.
7. Jalankan test upgrade berulang kali
Satu kali test upgrade hampir tidak pernah cukup. Setiap putaran biasanya memunculkan masalah baru yang sebelumnya tertutup oleh error lain. Ulangi sampai prosesnya bersih dari awal hingga akhir tanpa intervensi manual.
8. Tambahkan unit test
Unit test membuat Anda yakin bahwa logika bisnis tetap berjalan setelah perubahan. Fokuskan pada proses yang paling berisiko: perhitungan gaji, penjurnalan, harga, dan pajak.
9. Uji laporan secara menyeluruh
Laporan adalah tempat kesalahan paling sering muncul tanpa disadari. Bandingkan laporan berikut antara database lama dan hasil upgrade:
Neraca, laba rugi, dan buku besar.
Umur piutang dan utang.
Nilai persediaan per gudang.
Rekap payroll dan slip gaji.
Laporan custom dan format cetak dokumen.
10. Uji alur kerja oleh pengguna kunci
Minta perwakilan tiap departemen mencoba skenario harian mereka di staging. Tim gudang mencoba penerimaan dan pengiriman. Tim keuangan mencoba pembayaran dan rekonsiliasi bank. Tim HR mencoba payroll. Catat semua temuan dan selesaikan sebelum cut-over.
Checklist cut-over dan sesudah upgrade
11. Rencanakan cut-over
Pilih waktu dengan aktivitas transaksi paling rendah, misalnya akhir pekan setelah tutup buku. Umumkan jadwal pembekuan transaksi ke semua pengguna. Lakukan gladi bersih dengan database terbaru agar Anda tahu berapa lama prosesnya berjalan.
12. Siapkan rencana rollback
Rencana rollback wajib ada, walaupun Anda berharap tidak memakainya. Pastikan:
Backup database dan filestore production diambil tepat sebelum cut-over.
Ada titik keputusan yang jelas: kapan upgrade dinyatakan gagal dan sistem dikembalikan ke versi lama.
Orang yang berwenang mengambil keputusan rollback sudah ditentukan.
13. Verifikasi setelah go-live
Setelah sistem baru aktif, cocokkan kembali angka-angka kunci dengan kriteria sukses yang Anda tulis di awal. Pantau log error selama beberapa hari pertama. Sediakan saluran cepat bagi pengguna untuk melaporkan masalah.
Contoh skenario nyata
Pada proyek upgrade Odoo 18 ke 19 Enterprise untuk PT Dua Putra Utama Makmur Tbk, tim kami mem-port 37 modul dan menulis 8 skrip pre/post-migrate. Sebanyak 415 salary rule dimigrasikan otomatis ke model hr.version. Ada 11 view lama yang perlu ditangani lewat pre-migrate. Test upgrade di Odoo.sh diulang 4 kali sampai bersih, didukung 246 unit test, branch preview khusus, dan gladi bersih sebelum go-live.
Angka-angka ini menunjukkan satu hal: upgrade yang mulus adalah hasil persiapan berulang, bukan keberuntungan.
Kesalahan umum saat upgrade
Menguji dengan data lama. Database staging yang diambil berbulan-bulan lalu tidak mewakili kondisi terbaru.
Hanya menguji tampilan, bukan angka. Halaman bisa terbuka normal, tetapi saldo atau perhitungan gaji ternyata berbeda.
Melupakan modul pihak ketiga. Modul yang belum mendukung Odoo 19 bisa menghentikan seluruh proses.
Tidak ada pembekuan transaksi. Transaksi yang masuk saat cut-over bisa hilang atau tercatat ganda.
Tidak menyiapkan rollback. Saat masalah muncul, tim panik karena tidak tahu harus kembali ke mana.
FAQ seputar upgrade Odoo 19
Berapa lama proses upgrade Odoo 19?
Tergantung jumlah modul custom, volume data, dan kerumitan skrip migrasi. Proyek dengan sedikit kustomisasi bisa selesai jauh lebih cepat dibanding proyek dengan puluhan modul custom dan data payroll yang kompleks.
Apakah bisa langsung lompat dari Odoo 16 ke Odoo 19?
Secara teknis data harus melewati setiap versi mayor di antaranya. Untuk Enterprise, layanan upgrade resmi Odoo menangani lompatan ini. Untuk Community, prosesnya biasanya bertahap dan perlu perencanaan lebih matang. Pertimbangkan juga apakah Odoo 18 Community sudah cukup untuk kebutuhan Anda.
Apakah modul custom pasti harus ditulis ulang?
Tidak selalu ditulis ulang total. Sebagian besar cukup di-port dan disesuaikan. Namun modul yang bergantung pada model yang dihapus atau dipindah, seperti hr.contract, perlu perubahan lebih dalam.
Siap merencanakan upgrade?
Tim kami menangani upgrade dan migrasi Odoo dari inventaris modul sampai go-live, termasuk skrip migrasi dan unit test. Jika Anda ingin checklist ini disesuaikan dengan sistem Anda, ambil konsultasi gratis bersama tim NexaCore Solutions.