Panduan Migrasi RDM v3 ke RDM v4 Lengkap: Persiapan, Langkah Migrasi, dan Solusi Error

Migrasi Rapor Digital Madrasah (RDM) dari versi 3 (RDM v3) ke versi 4 (RDM v4) merupakan langkah pembaruan aplikasi untuk mendapatkan versi yang lebih baru. Agar proses migrasi berjalan lancar, operator madrasah perlu melakukan persiapan, mencadangkan data, serta memastikan konfigurasi server telah memenuhi persyaratan.

Kabar baiknya, proses migrasi ini berfokus pada penggantian aplikasi RDM, sedangkan database tidak diubah oleh proses migrasi. Meskipun demikian, backup tetap wajib dilakukan sebagai langkah antisipasi apabila terjadi kendala selama proses pembaruan.

Artikel ini membahas panduan migrasi RDM v3 ke RDM v4, mulai dari persiapan server, migrasi online, migrasi manual, pemeriksaan setelah migrasi, hingga solusi berbagai masalah yang mungkin terjadi.

A. Persiapan Sebelum Migrasi RDM v4

Sebelum memulai proses migrasi, pastikan seluruh persiapan berikut telah dilakukan.

1. Backup Database dan File RDM

Backup merupakan langkah paling penting sebelum melakukan migrasi. Tujuannya untuk mengantisipasi kegagalan proses migrasi atau kerusakan file aplikasi.

Lakukan backup dengan langkah berikut:

1. Login ke aplikasi RDM v3.

2. Buka menu Backup Restore.

3. Pilih opsi backup database.

4. Unduh file hasil backup dan simpan di tempat yang aman.

5. Buka File Manager pada panel hosting.

6. Kompres seluruh folder RDM menjadi file arsip, kemudian unduh ke komputer.

Simpan file backup di lokasi terpisah dari server RDM. Dengan demikian, file cadangan tetap tersedia apabila terjadi masalah pada hosting.

Penting: Jangan melanjutkan migrasi sebelum memastikan file backup berhasil diunduh dan dapat diakses.

2. Update RDM v3 ke Versi Terbaru

Menu migrasi ke RDM v4 hanya muncul pada RDM v3 yang sudah diperbarui ke versi yang mendukung fitur migrasi.

Langkah-langkahnya:

1. Login ke RDM v3 menggunakan akun yang memiliki hak akses proktor.

2. Klik foto profil atau avatar di pojok kanan atas.

3. Pilih menu Update.

4. Tunggu hingga proses pembaruan selesai.

Setelah pembaruan berhasil, periksa kembali menu pada avatar. Pastikan opsi Migrasi ke Versi 4 sudah tersedia.

3. Periksa Konfigurasi Server dan PHP

Sebelum migrasi, pastikan server hosting memenuhi persyaratan berikut.

Komponen	Persyaratan
Versi PHP	PHP 7.4 saat migrasi
ionCube Loader	Versi 15 atau lebih baru
Ekstensi ZIP	Aktif
Ekstensi cURL	Aktif
Izin folder RDM	Dapat ditulis oleh proses PHP

Pengaturan tersebut dapat diperiksa melalui panel hosting, misalnya cPanel atau aaPanel, sesuai konfigurasi server yang digunakan.

Untuk versi PHP, gunakan PHP 7.4 selama proses migrasi. Setelah migrasi selesai dan aplikasi telah dipastikan berjalan normal, versi PHP dapat dinaikkan hingga PHP 8.4 sesuai persyaratan aplikasi dan dukungan ionCube Loader yang terpasang.

Pastikan pula ekstensi ionCube sesuai dengan versi PHP yang digunakan.

B. Cara Migrasi RDM v3 ke RDM v4 Secara Online

Migrasi online merupakan metode yang disarankan apabila server RDM dapat terhubung dengan server penyedia paket migrasi.

Ikuti langkah-langkah berikut.

Langkah 1: Login sebagai Proktor

Buka aplikasi RDM v3 melalui browser, kemudian login menggunakan akun proktor.

Langkah 2: Buka Menu Migrasi

Klik foto profil atau avatar di pojok kanan atas, lalu pilih menu Migrasi ke Versi 4.

Langkah 3: Periksa Persyaratan Migrasi

Sistem akan memeriksa kesiapan aplikasi dan server.

Pastikan seluruh persyaratan yang ditampilkan berstatus OK. Jika terdapat persyaratan yang belum terpenuhi, selesaikan terlebih dahulu masalah tersebut sebelum melanjutkan.

Langkah 4: Mulai Proses Migrasi

Jika semua persyaratan sudah terpenuhi:

1. Klik tombol Mulai Migrasi.

2. Konfirmasikan dengan memilih Ya, migrasi.

3. Tunggu hingga sistem menyelesaikan proses pengunduhan paket dan pemasangan RDM v4.

Perhatian: Selama proses migrasi berlangsung, jangan menutup tab browser, melakukan refresh halaman, atau menghentikan proses yang sedang berjalan.

Langkah 5: Tunggu Hingga Selesai

Setelah proses pengunduhan dan pemasangan berhasil, aplikasi akan terbuka secara otomatis menggunakan RDM v4.

Selanjutnya, lakukan pemeriksaan data dan pembaruan aplikasi sebagaimana dijelaskan pada bagian setelah migrasi.

C. Cara Migrasi RDM v3 ke RDM v4 Secara Manual

Migrasi manual dapat digunakan apabila server hosting tidak dapat terhubung ke server RDM atau proses pengunduhan otomatis mengalami kegagalan.

Langkah 1: Unduh Paket Migrasi

Buka halaman Download pada portal resmi RDM.

Unduh paket yang tersedia sesuai kebutuhan:

• Migrasi RDM v4: ukuran sekitar 33 MB.

• Installer RDM v4: ukuran sekitar 45 MB, sebagai alternatif apabila paket migrasi tidak dapat digunakan.

Ukuran file dapat berubah mengikuti paket yang tersedia. Pastikan file diperoleh dari portal resmi RDM.

Langkah 2: Buka Menu Migrasi RDM v3

Login ke aplikasi RDM v3, kemudian buka menu avatar dan pilih Migrasi ke Versi 4.

Langkah 3: Periksa Batas Upload Server

Sebelum mengunggah file, pastikan batas upload server lebih besar daripada ukuran paket yang akan digunakan.

Periksa konfigurasi PHP berikut:

• upload_max_filesize

• post_max_size

Nilai keduanya harus cukup untuk menerima file yang diunggah. Perubahan konfigurasi biasanya dilakukan melalui panel hosting atau pengaturan PHP yang tersedia.

Langkah 4: Upload Paket Migrasi

Setelah batas upload dipastikan mencukupi:

1. Klik Upload Manual.

2. Pilih file ZIP paket migrasi yang telah diunduh.

3. Tunggu hingga proses upload selesai.

4. Konfirmasikan dengan memilih Ya, migrasi.

Langkah 5: Tunggu Proses Migrasi Selesai

Biarkan aplikasi menyelesaikan pemasangan RDM v4. Jangan menutup halaman atau menghentikan proses sebelum migrasi benar-benar selesai.

Jika paket migrasi mengalami masalah atau sistem mendeteksi file RDM v3 yang berbeda dari rilis yang diharapkan, gunakan Installer RDM v4 dari portal resmi melalui fitur Upload Manual sesuai petunjuk sistem.

D. Langkah Setelah Migrasi RDM v4 Berhasil

Setelah migrasi selesai, lakukan pemeriksaan berikut untuk memastikan aplikasi dapat digunakan dengan baik.

1. Bersihkan Cache Browser

Terkadang browser masih menampilkan file CSS, JavaScript, atau tampilan lama dari RDM v3.

Untuk memuat ulang halaman tanpa menggunakan cache, tekan:

• Windows: Ctrl + Shift + R

• Mac: Cmd + Shift + R

Jika tampilan masih bermasalah, coba buka aplikasi melalui jendela penyamaran (Incognito/Private Window).

2. Periksa Data Madrasah

Lakukan pengecekan terhadap data penting, meliputi:

• Profil dan identitas madrasah.

• Data kelas dan rombongan belajar.

• Data guru.

• Data siswa.

• Data nilai dan komponen penilaian yang digunakan.

Pastikan data yang ditampilkan sesuai dengan kondisi sebelum migrasi. Apabila ditemukan ketidaksesuaian, lakukan pemeriksaan sebelum melanjutkan pekerjaan pengolahan rapor.

3. Jalankan Update Aplikasi

Buka menu avatar, kemudian jalankan Update sekali lagi jika opsi tersebut tersedia dan diperlukan.

Tunggu proses pembaruan selesai sebelum menggunakan aplikasi untuk pekerjaan rutin.

4. Pertimbangkan Upgrade Versi PHP

Setelah RDM v4 berjalan normal, versi PHP dapat dinaikkan ke PHP 8.2, 8.3, atau 8.4 apabila didukung oleh rilis RDM yang digunakan.

Sebelum mengganti versi PHP, pastikan:

• Versi PHP yang dipilih kompatibel dengan aplikasi.

• ionCube Loader untuk versi PHP tersebut telah aktif.

• Ekstensi PHP yang dibutuhkan aplikasi tersedia.

• Backup database dan file aplikasi tetap tersimpan.

Sebaiknya lakukan perubahan versi PHP secara bertahap dan uji aplikasi setelah setiap perubahan.

E. Solusi Masalah Umum Saat Migrasi RDM v4

Berikut beberapa masalah yang mungkin muncul selama migrasi beserta langkah penanganannya.

1. PHP 7.4 Berstatus Belum

Penyebab: Versi PHP yang digunakan belum sesuai dengan persyaratan migrasi.

Solusi:

1. Buka panel hosting.

2. Masuk ke pengaturan versi PHP pada domain RDM.

3. Pilih PHP 7.4.

4. Simpan perubahan.

5. Periksa kembali menu migrasi RDM.

Pastikan perubahan diterapkan pada domain atau subdomain yang benar.

2. ionCube Loader Berstatus Belum atau Tidak Aktif

Penyebab: ionCube Loader belum terpasang atau belum aktif pada versi PHP yang digunakan.

Solusi:

• Periksa konfigurasi PHP pada panel hosting.

• Aktifkan ionCube Loader versi 15 atau lebih baru sesuai persyaratan migrasi.

• Jika opsi tersebut tidak tersedia, hubungi penyedia hosting untuk meminta bantuan pemasangan.

Perlu diperhatikan bahwa ionCube harus aktif pada versi PHP yang benar, bukan hanya pada versi PHP lain di server.

3. Folder Tidak Dapat Ditulis atau File RDM Tidak Dapat Ditimpa PHP

Penyebab: Proses PHP tidak memiliki izin untuk menulis atau mengganti file aplikasi RDM.

Solusi:

• Periksa kepemilikan folder dan izin akses file RDM.

• Pastikan proses PHP berjalan menggunakan pengguna yang memiliki akses tulis yang sesuai.

• Jika menggunakan VPS, perbaiki kepemilikan folder sesuai pengguna PHP atau pengguna layanan web yang benar.

Contoh perintah pada VPS Linux:

chown -R <user-php>:<group-php> /lokasi/folder/rdm

Ganti <user-php>, <group-php>, dan /lokasi/folder/rdm dengan nilai yang sesuai pada server Anda.

Peringatan: Jangan menyalin perintah tersebut secara langsung tanpa memeriksa pengguna PHP, grup, dan lokasi instalasi yang sebenarnya. Hindari mengubah kepemilikan secara sembarangan atau memberikan izin 777 pada seluruh folder RDM karena dapat menimbulkan risiko keamanan.

4. Paket Migrasi Rusak Saat Diunduh

Penyebab: Koneksi terputus atau proses pengunduhan tidak selesai dengan sempurna.

Solusi:

1. Ulangi proses migrasi online ketika koneksi lebih stabil.

2. Jika masalah terus terjadi, unduh paket migrasi secara manual dari portal resmi RDM.

3. Pastikan file ZIP berhasil diunduh sebelum mengunggahnya ke aplikasi.

5. Ukuran File Melebihi Batas Upload

Penyebab: Batas upload PHP lebih kecil daripada ukuran file ZIP yang akan diunggah.

Solusi:

• Tingkatkan upload_max_filesize.

• Tingkatkan post_max_size agar cukup menampung seluruh permintaan upload.

• Periksa pula batas request body pada web server atau pembatas lain jika masih gagal.

• Alternatifnya, gunakan metode migrasi online jika koneksi server mendukung.

6. Terdapat File RDM yang Berbeda dari Rilis RDM v3

Penyebab: File aplikasi RDM v3 tidak sesuai dengan rilis yang diharapkan oleh proses migrasi.

Solusi:

1. Unduh Installer RDM v4 dari portal resmi RDM.

2. Buka menu Migrasi ke Versi 4.

3. Pilih Upload Manual.

4. Unggah file installer sesuai petunjuk yang ditampilkan.

5. Tunggu hingga proses selesai.

Pastikan file installer berasal dari sumber resmi dan sesuai dengan metode migrasi yang disediakan aplikasi.

7. Tampilan Berantakan atau Masih Menampilkan Versi Lama

Penyebab: Browser masih menggunakan cache dari aplikasi sebelumnya.

Solusi:

• Tekan Ctrl + Shift + R pada Windows.

• Tekan Cmd + Shift + R pada Mac.

• Coba buka aplikasi melalui jendela penyamaran.

• Jika diperlukan, bersihkan cache browser kemudian buka kembali aplikasi.

8. Migrasi Gagal di Tengah Jalan

Jika migrasi gagal sebelum selesai, jangan langsung menghapus file atau melakukan perubahan database secara manual.

Langkah pemulihan yang disarankan:

1. Catat pesan error yang muncul.

2. Periksa log aplikasi dan server untuk mengetahui penyebab kegagalan.

3. Siapkan kembali backup folder RDM yang dibuat sebelum migrasi.

4. Pulihkan file aplikasi dari backup sesuai kondisi instalasi.

5. Perbaiki penyebab kegagalan sebelum mencoba migrasi kembali.

Apabila diperlukan, lakukan pemulihan melalui prosedur yang sesuai dengan konfigurasi hosting. Hindari menimpa folder secara sembarangan karena dapat menyisakan file dari versi berbeda.

Proses migrasi RDM v3 ke RDM v4 tidak mengubah database menurut panduan ini. Namun, backup database tetap diperlukan sebagai perlindungan tambahan dan untuk mengantisipasi masalah lain di luar proses migrasi aplikasi.

F. Pemeriksaan Sebelum dan Sesudah Migrasi RDM v4

Gunakan daftar berikut untuk memastikan persiapan dan pemeriksaan migrasi tidak terlewat.

Sebelum migrasi:

◆ Database RDM sudah di-backup dan file backup telah diunduh.

◆ Seluruh folder aplikasi RDM sudah dikompres dan diunduh.

◆ RDM v3 sudah diperbarui ke versi yang mendukung migrasi.

◆ PHP 7.4 telah aktif pada domain RDM.

◆ ionCube Loader versi 15 atau lebih baru telah aktif.

◆ Ekstensi ZIP dan cURL telah aktif.

◆ Folder RDM dapat ditulis oleh proses PHP.

Sesudah migrasi:

◆ RDM v4 dapat dibuka tanpa error.

◆ Cache browser telah dimuat ulang.

◆ Profil madrasah sudah diperiksa.

◆ Data kelas, guru, siswa, dan nilai telah diperiksa.

◆ Update aplikasi telah dijalankan jika diperlukan.

◆ Aplikasi telah diuji sebelum digunakan untuk pekerjaan rutin.

Kesimpulan

Migrasi RDM v3 ke RDM v4 dapat dilakukan melalui metode online maupun manual. Migrasi online lebih praktis jika server dapat mengunduh paket dari server RDM, sedangkan migrasi manual menjadi alternatif ketika koneksi server mengalami kendala.

Kunci keberhasilan migrasi adalah melakukan backup terlebih dahulu, menggunakan PHP 7.4 selama proses migrasi, memastikan ionCube Loader serta ekstensi yang diperlukan aktif, dan memberikan izin tulis yang sesuai pada folder aplikasi.

Setelah migrasi berhasil, periksa seluruh data penting dan pastikan aplikasi berjalan normal sebelum digunakan kembali untuk pengelolaan rapor madrasah.

Catatan: Panduan ini disusun berdasarkan langkah dan persyaratan yang tercantum dalam sumber panduan migrasi. Sebelum melakukan perubahan pada server produksi, cocokkan kembali persyaratan dengan dokumentasi dan paket resmi RDM yang digunakan.

---

Madrasah Hebat Bermartabat

Solusi digitalisasi madrasah: website madrasah, PPDB/SPMB online, hosting RDM, dan CBT online.

Kunjungi: https://www.madrasahebat.com