Migrasi Database
Panduan update dari Rapkumer v0.x.x ke v1.x.x
Perubahan Skema Database
Update ke v1.x.x mengubah struktur database. Tanpa migrasi, aplikasi akan mengalami error 500.
Apa itu Migrasi Database?
Migrasi database adalah proses update struktur database untuk menyesuaikan dengan perubahan pada versi aplikasi yang lebih baru. Rapkumer v1.x.x memiliki perubahan signifikan pada skema database dibandingkan v0.x.x.
Gejala Database Belum Dimigrasi
Aplikasi menampilkan Error 500 saat dibuka atau saat mengakses menu tertentu.
Cara Melakukan Migrasi
Migrasi database dilakukan dengan menjalankan script khusus yang sudah disediakan di folder instalasi Rapkumer.
Tutup Aplikasi Rapkumer
Pastikan aplikasi Rapkumer sudah ditutup sepenuhnya sebelum menjalankan migrasi.
Jalankan Script Migrasi
Buka Windows Explorer dan ketik path berikut di address bar:
%localappdata%\RapkumerDi dalam folder tersebut, cari dan double-click file:
run-migrations.cmdTunggu Proses Selesai
Jendela command prompt akan terbuka dan menampilkan proses migrasi. Jangan tutup jendela ini sampai proses selesai.
Buka Aplikasi Rapkumer
Setelah migrasi selesai, buka kembali aplikasi Rapkumer. Aplikasi seharusnya sudah bisa digunakan tanpa error 500.
Jika Migrasi Gagal
Jika proses migrasi mengalami error atau gagal, silakan lakukan langkah berikut:
Hubungi Support via Telegram
Kirim permohonan bantuan ke grup Telegram Rapkumer dengan menyertakan:
- Screenshot pesan error (jika ada)
- Versi Rapkumer yang digunakan
- Deskripsi singkat masalah yang terjadi
Catatan Penting
Backup otomatis: Script migrasi akan membuat backup database sebelum melakukan perubahan.
Data tetap aman: Migrasi hanya mengubah struktur database, tidak menghapus data Anda.
Satu kali saja: Migrasi hanya perlu dilakukan sekali saat update dari v0.x.x ke v1.x.x.
Setelah Migrasi Berhasil
Setelah migrasi database berhasil, Anda bisa langsung menggunakan Rapkumer v1.x.x dengan semua fitur barunya.