Panduan Lengkap Migrasi Rapor Digital Madrasah (RDM) v3 ke v4

Pembaruan Rapor Digital Madrasah (RDM) ke versi 4 telah dirilis untuk meningkatkan performa dan fitur penilaian di madrasah. Proses migrasi ini dirancang agar aman—pembaruan hanya mengganti sistem aplikasi, sementara seluruh data madrasah dan pengaturan database Anda dipastikan tetap utuh.

Berikut adalah langkah-langkah komprehensif untuk melakukan migrasi RDM dari versi 3 ke versi 4.

A. Persiapan Sebelum Migrasi Langkah persiapan ini sangat krusial untuk mencegah kegagalan sistem saat proses pembaruan berlangsung.

• Lakukan Backup Data (Wajib): Masuk ke menu Backup Restore, lakukan backup database, dan unduh filenya. Selain itu, kompres dan unduh seluruh folder RDM Anda dari File Manager hosting sebagai cadangan.
  
  
• Perbarui RDM v3: Pastikan Anda menggunakan versi v3 paling mutakhir. Klik avatar di sudut kanan atas, lalu pilih Update. Tombol migrasi ke v4 hanya akan muncul jika v3 sudah berada di versi terakhir.
  
  
• Cek Spesifikasi Server: Pastikan server hosting Anda memenuhi syarat berikut:
  
  
  • Menggunakan PHP versi 7.4 (Wajib saat proses migrasi. Setelah selesai, dapat dinaikkan hingga versi 8.4).
    
    
  • ionCube Loader minimal versi 15 aktif.
    
    
  • Ekstensi zip dan curl aktif.
    
    
  • Akses folder RDM memiliki izin tulis (writable) oleh PHP.
    
    

B. Proses Migrasi Online (Paling Disarankan) Metode ini adalah yang paling cepat dan praktis karena file akan diunduh secara otomatis dari server pusat.

1. Login ke aplikasi RDM v3 menggunakan akun Proktor.
   
   
2. Klik foto profil/avatar di kanan atas, lalu pilih menu Migrasi ke Versi 4.
   
   
3. Sistem akan mengecek persyaratan server. Pastikan seluruh indikator berstatus OK.
   
   
4. Klik Mulai Migrasi, lalu konfirmasi dengan menekan Ya, migrasi.
   
   
5. Biarkan proses mengunduh dan memasang berjalan. Jangan menutup atau me-refresh halaman selama proses ini berlangsung.
   
   
6. Setelah selesai, sistem akan otomatis memuat ulang dan terbuka dengan antarmuka RDM v4.
   
   

C. Proses Migrasi Manual (Alternatif) Gunakan metode ini jika server hosting Anda mengalami kendala koneksi ke server pusat RDM.

1. Buka portal resmi RDM dan masuk ke halaman Download.
   
   
2. Unduh file Migrasi RDM v4 (berukuran sekitar 33 MB). Jika file tersebut gagal dipasang nantinya, unduh opsi Installer RDM v4 (sekitar 45 MB).
   
   
3. Buka RDM v3 Anda dan akses menu Migrasi ke Versi 4.
   
   
4. Pastikan kapasitas upload server Anda lebih besar dari ukuran file zip tersebut.
   
   
5. Pilih opsi Upload Manual, masukkan file .zip yang sudah diunduh, dan klik Ya, migrasi. Tunggu hingga proses instalasi selesai.
   
   

D. Langkah Pasca Migrasi Setelah RDM v4 berhasil terbuka, lakukan pengecekan akhir:

• Bersihkan cache browser dengan menekan Ctrl+Shift+R (atau Cmd+Shift+R di Mac) agar antarmuka v4 tampil sempurna tanpa sisa tampilan v3.
  
  
• Periksa kembali kelengkapan data seperti profil madrasah, daftar kelas, guru, siswa, dan nilai.
  
  
• Jalankan Update satu kali lagi dari menu avatar untuk memastikan tidak ada patch yang tertinggal.
  
  
• (Opsional) Anda kini bisa meningkatkan versi PHP server ke 8.2 hingga 8.4. Pastikan ekstensi ionCube untuk versi PHP terbaru tersebut juga sudah diaktifkan.
  
  

E. Solusi Masalah Umum (Troubleshooting) Jika Anda menemui kendala selama proses, berikut adalah solusinya:

• Peringatan PHP "Belum": Ubah versi PHP Anda ke 7.4 melalui panel hosting (cPanel/DirectAdmin).
  
  
• Peringatan ionCube "Belum/Tidak Aktif": Aktifkan modul ionCube Loader versi 15+ di pengaturan PHP Selector hosting Anda, atau hubungi penyedia hosting.
  
  
• Folder Tidak Dapat Ditulis / File RDM Tidak Dapat Ditimpa: Ubah hak kepemilikan (ownership) folder RDM ke user PHP hosting. Bagi pengguna VPS, jalankan perintah: chown -R <user-php>: /lokasi/folder/rdm
  
  
• Paket Migrasi Rusak Saat Diunduh: Menandakan koneksi server terputus di tengah jalan. Ulangi prosesnya atau gunakan metode Migrasi Manual.
  
  
• Ukuran File Melebihi Batas Upload: Tingkatkan batas upload_max_filesize dan post_max_size di pengaturan PHP Anda.
  
  
• Tampilan Berantakan: Ini adalah masalah cache. Coba akses menggunakan Incognito Mode atau lakukan hard refresh (Ctrl+Shift+R).
  
  

Catatan: Jika migrasi gagal di tengah jalan, segera kembalikan (restore) folder RDM dari file backup yang dibuat di langkah persiapan, perbaiki sumber masalahnya, lalu ulangi prosesnya. Database Anda tidak akan rusak karena proses migrasi hanya mengganti file aplikasi.

Sumber Lain yang Relevan di WebSebagai tambahan referensi visual, Anda dapat merujuk pada tutorial video terbaru yang dirilis oleh komunitas penyedia hosting madrasah, salah satunya adalah "Tutorial Update RDM Versi 4: Atur PHP sampai Migrasi Berhasil" (dirilis akhir Oktober 2026 di YouTube oleh AnymHostID). Video ini mendemonstrasikan langsung cara mengatur versi PHP ke 7.4 dan mengaktifkan ionCube Loader hingga RDM v4 berhasil diinstal.