Panduan Lengkap Migrasi RDM Versi 3 ke Versi 4: Persiapan Server, Langkah Instalasi, dan Solusi Kendala

Pelajari cara migrasi RDM V3 ke V4 secara online dan manual. Simak persiapan server, backup database, instalasi, hingga solusi error.

---

Mengenal Pembaruan Rapor Digital Madrasah Versi 4

Pengelolaan nilai dan administrasi pembelajaran di madrasah semakin bergantung pada sistem digital. Salah satu aplikasi yang digunakan untuk mendukung pekerjaan tersebut adalah Rapor Digital Madrasah (RDM).

Seiring perkembangan aplikasi, pengelola madrasah perlu memperhatikan pembaruan sistem, termasuk perpindahan dari RDM versi 3 ke RDM versi 4.

Proses migrasi ini tidak cukup dilakukan dengan mengganti file aplikasi begitu saja. Operator perlu memeriksa kesiapan hosting, memastikan kompatibilitas PHP, mengaktifkan komponen pendukung, serta membuat salinan data sebelum melakukan perubahan.

Kesalahan dalam tahap persiapan dapat menyebabkan aplikasi tidak berjalan sebagaimana mestinya. Karena itu, setiap operator sebaiknya memahami prosedur migrasi sebelum memulai proses pembaruan.

Artikel ini membahas dua metode migrasi RDM V3 ke V4, yaitu melalui fitur pembaruan langsung dan melalui unggahan file installer secara manual.

A. Hal yang Perlu Dipersiapkan Sebelum Migrasi

Persiapan menjadi bagian penting dalam proses perpindahan versi aplikasi. Operator sebaiknya menyelesaikan seluruh pemeriksaan berikut sebelum melakukan migrasi.

1. Membuat Backup Database dan File Aplikasi

Backup merupakan langkah perlindungan untuk mengantisipasi kegagalan pembaruan. Meskipun proses migrasi dirancang untuk mengganti file aplikasi tanpa mengubah database, operator tetap perlu menyimpan salinan seluruh data.

Berikut langkah yang dapat dilakukan:

1. Masuk ke aplikasi RDM V3 menggunakan akun proktor.
2. Buka menu Backup Restore.
3. Jalankan proses pencadangan database.
4. Unduh hasil backup ke komputer.
5. Masuk ke File Manager melalui panel hosting.
6. Cari direktori tempat aplikasi RDM terpasang.
7. Kompres seluruh folder aplikasi menjadi file ZIP.
8. Unduh file tersebut dan simpan di perangkat atau penyimpanan lain.

Sebaiknya simpan backup pada dua lokasi berbeda. Jangan hanya mengandalkan salinan yang berada di server hosting yang sama.

Dengan demikian, operator memiliki cadangan apabila terjadi kerusakan file atau gangguan pada server.

2. Memastikan RDM V3 Sudah Menggunakan Pembaruan Terbaru yang Mendukung Migrasi

Fitur perpindahan ke RDM V4 dapat bergantung pada versi aplikasi sebelumnya. Oleh sebab itu, operator perlu memastikan RDM V3 telah menggunakan pembaruan yang menyediakan menu migrasi.

Caranya sebagai berikut:

1. Login ke RDM menggunakan akun proktor.
2. Klik foto profil pada bagian kanan atas.
3. Cari menu Update.
4. Jalankan pembaruan apabila tersedia.
5. Tunggu hingga proses selesai.
6. Buka kembali menu profil.
7. Periksa apakah pilihan Migrasi ke Versi 4 sudah tersedia.

Apabila menu migrasi belum muncul, jangan langsung melakukan penggantian file secara manual. Periksa terlebih dahulu versi aplikasi dan petunjuk pembaruan yang berlaku.

3. Memeriksa Kompatibilitas Hosting

Kesiapan server sangat menentukan keberhasilan migrasi. Beberapa komponen PHP harus tersedia agar proses penggantian file aplikasi dapat berjalan.

Persyaratan teknis yang disebutkan dalam panduan sumber meliputi:

Komponen	Persyaratan
PHP	Versi 7.4 untuk proses migrasi sesuai panduan sumber
ionCube Loader	Versi 15 atau lebih baru
Ekstensi ZIP	Aktif
Ekstensi cURL	Aktif
Izin folder	Dapat ditulis oleh PHP

Pengaturan tersebut biasanya tersedia melalui cPanel, aaPanel, atau panel pengelolaan hosting lainnya.

Perlu diperhatikan bahwa PHP 7.4 sudah tidak mendapatkan dukungan keamanan resmi dari pengembang PHP. Jika versi tersebut memang diperlukan oleh proses migrasi, gunakan hanya sesuai petunjuk teknis aplikasi dan konsultasikan dengan penyedia hosting. Setelah migrasi berhasil, gunakan versi PHP yang masih didukung dan kompatibel dengan RDM V4.

Jangan menaikkan versi PHP hanya berdasarkan angka terbaru. Pastikan aplikasi, ionCube Loader, dan seluruh ekstensi pendukung sudah sesuai.

B. Migrasi RDM V3 ke V4 Menggunakan Metode Online

Metode online dapat menjadi pilihan pertama apabila server hosting mempunyai koneksi internet yang stabil dan dapat menjangkau server pembaruan RDM.

Keunggulan metode ini adalah operator tidak perlu mengunggah paket instalasi secara manual.

Ikuti tahapan berikut.

Langkah 1. Login ke Aplikasi RDM

Buka alamat RDM yang digunakan oleh madrasah. Masukkan username dan password akun proktor.

Pastikan operator menggunakan akun yang memiliki hak akses untuk menjalankan proses migrasi.

Langkah 2. Membuka Fitur Migrasi

Setelah berhasil masuk:

• Klik foto profil di bagian kanan atas.
• Cari pilihan Migrasi ke Versi 4.
• Klik menu tersebut untuk membuka halaman pemeriksaan sistem.

Langkah 3. Melakukan Pemeriksaan Persyaratan

Aplikasi akan memeriksa konfigurasi server sebelum mengizinkan proses migrasi.

Perhatikan hasil pemeriksaan yang ditampilkan. Pastikan seluruh persyaratan menunjukkan status OK.

Jika terdapat komponen yang belum memenuhi ketentuan, perbaiki melalui panel hosting atau minta bantuan teknisi server.

Jangan memaksakan proses migrasi ketika masih terdapat persyaratan yang belum terpenuhi.

Langkah 4. Menjalankan Proses Migrasi

Apabila seluruh pemeriksaan berhasil, operator dapat melanjutkan proses.

1. Klik tombol Mulai Migrasi.
2. Perhatikan konfirmasi yang ditampilkan.
3. Pilih Ya, Migrasi untuk menyetujui proses.
4. Tunggu hingga sistem mengunduh dan memasang file RDM V4.
5. Biarkan aplikasi menyelesaikan seluruh tahapan.

Selama proses berlangsung, jangan menutup browser, melakukan refresh, atau menghentikan proses yang sedang berjalan.

Tindakan tersebut berpotensi mengganggu proses penggantian file aplikasi.

Langkah 5. Memastikan RDM V4 Berhasil Dibuka

Setelah proses selesai, aplikasi akan mengarahkan pengguna ke RDM V4.

Operator perlu melakukan pemeriksaan awal untuk memastikan halaman aplikasi dapat dibuka dan tidak menampilkan pesan kesalahan.

Jika aplikasi sudah dapat diakses, lanjutkan dengan pemeriksaan data madrasah.

C. Migrasi RDM V3 ke V4 Menggunakan Metode Manual

Migrasi manual dapat digunakan ketika metode online mengalami kendala, misalnya server hosting tidak dapat terhubung ke server pembaruan.

Metode ini memanfaatkan file paket migrasi atau installer yang diunggah melalui menu migrasi pada aplikasi.

Langkah 1. Mengunduh Paket Migrasi

Operator perlu memperoleh file instalasi melalui portal resmi RDM.

Berdasarkan informasi panduan sumber, terdapat dua jenis file yang dapat digunakan:

Jenis File	Perkiraan Ukuran
Paket Migrasi RDM V4	33 MB
Installer RDM V4	45 MB

Ukuran tersebut merupakan perkiraan dan dapat berubah mengikuti rilis yang tersedia.

Pastikan file berasal dari sumber resmi. Hindari menggunakan paket instalasi dari situs yang tidak jelas karena dapat menimbulkan masalah keamanan dan kompatibilitas.

Langkah 2. Membuka Menu Migrasi

Setelah file berhasil diunduh:

1. Login kembali ke aplikasi RDM V3.
2. Gunakan akun proktor.
3. Klik foto profil.
4. Pilih Migrasi ke Versi 4.

Pastikan menu tersebut dapat dibuka sebelum melanjutkan.

Langkah 3. Memeriksa Batas Unggah File

Proses unggah membutuhkan kapasitas yang cukup pada konfigurasi PHP.

Dua pengaturan yang perlu diperhatikan adalah:

• upload_max_filesize
• post_max_size

Pastikan batas unggah mencukupi ukuran file yang akan digunakan.

Jika kapasitas belum memadai, sesuaikan melalui pengaturan PHP pada panel hosting. Perhatikan pula batas unggah yang diterapkan oleh web server.

Langkah 4. Mengunggah File Installer

Setelah konfigurasi siap, lakukan tahapan berikut:

1. Klik Upload Manual.
2. Pilih file ZIP paket migrasi yang sudah diunduh.
3. Tunggu sampai proses unggah selesai.
4. Periksa kembali file yang dipilih.
5. Klik Ya, Migrasi apabila aplikasi meminta konfirmasi.

Selanjutnya, biarkan aplikasi memproses file yang sudah diunggah.

Jika paket migrasi tidak dapat digunakan, operator dapat mempertimbangkan installer RDM V4 sesuai petunjuk yang disediakan aplikasi.

Langkah 5. Menunggu Proses Selesai

Jangan menghentikan proses sebelum aplikasi memberikan informasi bahwa migrasi telah selesai.

Setelah berhasil, buka kembali RDM dan pastikan sistem sudah menggunakan versi terbaru.

D. Pemeriksaan Setelah Berhasil Migrasi

Migrasi yang berhasil belum tentu menjamin seluruh fungsi aplikasi berjalan normal. Operator tetap perlu melakukan pemeriksaan setelah perpindahan versi.

Berikut beberapa hal yang perlu diperhatikan.

1. Memuat Ulang Tampilan Browser

Terkadang browser masih menyimpan file tampilan dari versi sebelumnya. Akibatnya, halaman RDM terlihat berantakan atau belum menampilkan desain terbaru.

Untuk mengatasinya, lakukan hard refresh:

• Windows: tekan Ctrl + Shift + R.
• Mac: tekan Command + Shift + R.

Jika tampilan belum berubah, coba buka aplikasi menggunakan jendela Incognito atau Private Browsing.

2. Memeriksa Kelengkapan Data Madrasah

Pastikan informasi penting masih tersedia setelah migrasi.

Data yang perlu diperiksa meliputi:

• Identitas dan profil madrasah.
• Data guru dan tenaga kependidikan.
• Data peserta didik.
• Data kelas dan rombongan belajar.
• Komponen penilaian.
• Data nilai dan administrasi rapor.

Jangan langsung menggunakan aplikasi untuk pekerjaan rutin sebelum operator memastikan data penting tetap tersedia dan sesuai.

3. Melakukan Pembaruan Aplikasi Jika Diperlukan

Periksa kembali menu Update pada aplikasi RDM V4.

Apabila tersedia pembaruan yang direkomendasikan, jalankan sesuai petunjuk resmi. Tunggu sampai proses selesai sebelum menggunakan aplikasi.

4. Menyesuaikan Versi PHP Hosting

Setelah aplikasi berjalan normal, operator dapat mengevaluasi kembali versi PHP yang digunakan.

Gunakan PHP 8.2, 8.3, atau 8.4 hanya jika versi RDM V4 yang terpasang mendukungnya.

Pastikan ionCube Loader dan ekstensi PHP yang diperlukan juga aktif pada versi yang dipilih.

Lakukan perubahan satu per satu dan uji kembali aplikasi setelah pengaturan server diperbarui.

E. Mengatasi Berbagai Kendala Migrasi RDM

Beberapa kendala dapat muncul ketika operator menjalankan migrasi. Sebagian besar berkaitan dengan konfigurasi server, kompatibilitas file, atau koneksi internet.

Berikut penjelasan beberapa masalah yang perlu diketahui.

1. Pemeriksaan PHP 7.4 Tidak Berhasil

Penyebab:

Server masih menggunakan versi PHP yang tidak sesuai dengan persyaratan migrasi.

Solusi:

• Buka panel hosting.
• Cari pengaturan versi PHP.
• Pilih versi yang disyaratkan oleh proses migrasi.
• Simpan perubahan.
• Periksa kembali menu migrasi pada RDM.

Pastikan pengaturan berlaku pada domain atau direktori tempat RDM dipasang.

2. ionCube Loader Tidak Terdeteksi

Penyebab:

Komponen ionCube Loader belum aktif atau tidak sesuai dengan versi PHP yang digunakan.

Solusi:

• Periksa konfigurasi PHP pada hosting.
• Pastikan ionCube Loader tersedia.
• Aktifkan versi yang sesuai dengan persyaratan aplikasi.
• Hubungi penyedia hosting jika komponen tersebut tidak tersedia.

3. Folder Aplikasi Tidak Memiliki Izin Tulis

Penyebab:

Pengguna yang menjalankan layanan PHP tidak mempunyai izin untuk mengubah file dalam direktori RDM.

Solusi:

Periksa kepemilikan folder dan izin aksesnya. Pastikan pengguna layanan web mempunyai hak akses yang diperlukan.

Jika menggunakan VPS, penyesuaian kepemilikan dapat dilakukan melalui terminal Linux oleh administrator yang memahami konfigurasi server.

Hindari memberikan izin 777 pada seluruh folder aplikasi. Pengaturan tersebut dapat membuka risiko keamanan karena memberikan hak akses terlalu luas.

4. File Migrasi Gagal Diunduh

Penyebab:

Koneksi internet terputus, server mengalami gangguan, atau proses pengunduhan tidak selesai.

Solusi:

• Periksa kestabilan koneksi internet.
• Ulangi proses pengunduhan.
• Pastikan ukuran file sesuai dengan paket yang tersedia.
• Gunakan metode manual jika migrasi online tetap gagal.

5. File ZIP Tidak Bisa Diunggah

Penyebab:

Ukuran file melebihi batas unggah yang ditentukan oleh server.

Solusi:

Periksa nilai upload_max_filesize dan post_max_size.

Jika diperlukan, sesuaikan pengaturan melalui panel hosting. Periksa juga konfigurasi web server apabila proses unggah tetap gagal.

6. Paket Migrasi Tidak Sesuai

Penyebab:

File yang digunakan tidak sesuai dengan paket yang diharapkan oleh sistem.

Solusi:

Unduh kembali paket migrasi atau installer dari portal resmi RDM. Pastikan jenis file yang digunakan sesuai dengan petunjuk aplikasi.

Jangan mencampurkan file dari beberapa versi RDM secara manual.

7. Tampilan Aplikasi Masih Menggunakan Versi Lama

Penyebab:

Browser masih menyimpan cache dari aplikasi sebelumnya.

Solusi:

• Gunakan Ctrl + Shift + R.
• Buka aplikasi melalui jendela Incognito.
• Bersihkan cache browser jika diperlukan.
• Login kembali setelah halaman berhasil dimuat.

8. Migrasi Terhenti Sebelum Selesai

Penyebab:

Gangguan koneksi, keterbatasan sumber daya hosting, kesalahan izin folder, atau masalah pada proses penggantian file.

Solusi:

Jangan langsung menghapus file aplikasi atau melakukan perubahan database.

Lakukan langkah berikut:

1. Catat pesan kesalahan yang muncul.
2. Periksa log aplikasi dan server.
3. Periksa kondisi folder RDM.
4. Siapkan backup database dan file aplikasi.
5. Identifikasi penyebab kegagalan.
6. Lakukan pemulihan berdasarkan kondisi instalasi.

Jika operator tidak memahami proses pemulihan, sebaiknya minta bantuan penyedia hosting atau teknisi yang berpengalaman.

F. Checklist Operator Sebelum dan Sesudah Migrasi

Agar tidak ada tahapan yang terlewat, operator dapat menggunakan daftar pemeriksaan berikut.

Sebelum migrasi:

• [ ] Database RDM sudah di-backup.
• [ ] Folder aplikasi sudah dikompres.
• [ ] File backup sudah disimpan di perangkat lain.
• [ ] RDM V3 sudah diperbarui.
• [ ] Menu migrasi sudah tersedia.
• [ ] Versi PHP sudah diperiksa.
• [ ] ionCube Loader sudah aktif.
• [ ] Ekstensi ZIP dan cURL sudah tersedia.
• [ ] Izin folder aplikasi sudah sesuai.
• [ ] Koneksi server sudah diperiksa.

Sesudah migrasi:

• [ ] RDM V4 berhasil dibuka.
• [ ] Tampilan aplikasi berjalan normal.
• [ ] Profil madrasah sudah diperiksa.
• [ ] Data guru dan peserta didik sudah diperiksa.
• [ ] Data kelas dan rombongan belajar sudah diperiksa.
• [ ] Data nilai sudah diperiksa.
• [ ] Fitur aplikasi sudah diuji.
• [ ] Versi PHP sudah dievaluasi kembali.
• [ ] Backup sebelum migrasi tetap tersimpan.

Kesimpulan

Perpindahan Rapor Digital Madrasah dari versi 3 ke versi 4 membutuhkan persiapan yang matang. Operator harus memastikan database dan file aplikasi memiliki cadangan sebelum memulai proses.

Terdapat dua pilihan metode migrasi, yaitu secara online melalui fitur yang tersedia pada aplikasi dan secara manual menggunakan paket migrasi atau installer.

Metode online dapat digunakan ketika server memiliki koneksi yang memadai. Sementara itu, metode manual menjadi alternatif apabila proses pembaruan langsung mengalami kendala.

Selain memperhatikan kompatibilitas PHP dan ionCube Loader, operator juga perlu memeriksa izin folder, ekstensi PHP, serta batas unggah file pada hosting.

Hal yang tidak kalah penting adalah melakukan pemeriksaan setelah migrasi. Pastikan seluruh data madrasah tetap tersedia dan fungsi aplikasi berjalan normal sebelum digunakan untuk pengelolaan nilai.

Dengan persiapan yang tepat, proses pembaruan RDM dapat dilakukan secara lebih terarah dan risiko gangguan terhadap pekerjaan administrasi madrasah dapat diminimalkan.

---

Artikel ini disusun sebagai bahan informasi dan panduan teknis bagi operator madrasah dalam mempersiapkan migrasi Rapor Digital Madrasah.

Referensi informasi:
Panduan Migrasi RDM V3 ke RDM V4, Madrasah Hebat Bermartabat.
https://www.madrasahebat.com/2026/11/panduan-migrasi-rdm-v3-ke-rdm-v4-dengan.html

Catatan: Persyaratan teknis dan prosedur migrasi dapat berubah mengikuti pembaruan aplikasi. Operator disarankan memeriksa dokumentasi resmi RDM dan berkonsultasi dengan penyedia hosting sebelum melakukan perubahan server.