Panduan Migrasi RDM v3 ke RDM v4 dengan Mudah dan Aman

Rapor Digital Madrasah (RDM) versi 4 merupakan versi terbaru yang dapat digunakan sebagai pengganti RDM versi 3. Agar proses perpindahan berjalan lancar, operator madrasah perlu melakukan beberapa persiapan sebelum memulai migrasi.

Hal penting yang perlu diketahui: migrasi RDM v3 ke RDM v4 berfokus pada penggantian file aplikasi. Database tidak diubah oleh proses migrasi ini. Namun, backup tetap wajib dilakukan untuk mengantisipasi masalah yang mungkin terjadi.

Ada dua cara untuk melakukan migrasi, yaitu secara online melalui aplikasi RDM dan secara manual menggunakan file installer.

Berikut panduan lengkapnya.

A. Persiapan Sebelum Migrasi

Sebelum memulai migrasi, lakukan beberapa langkah berikut.

1. Backup Database dan File RDM

Backup berfungsi sebagai cadangan jika terjadi masalah saat migrasi.

Lakukan langkah-langkah berikut:

1. Login ke aplikasi RDM v3.

2. Buka menu Backup Restore.

3. Lakukan backup database.

4. Unduh file backup ke komputer.

5. Buka File Manager pada hosting.

6. Kompres seluruh folder RDM, kemudian unduh ke komputer.

Simpan file backup di tempat yang aman. Jangan hanya menyimpan backup di server yang sama dengan aplikasi RDM.

2. Update RDM v3 ke Versi Terbaru

Menu migrasi ke RDM v4 hanya tersedia jika RDM v3 sudah diperbarui ke versi yang mendukung migrasi.

Caranya:

1. Login ke RDM menggunakan akun proktor.

2. Klik foto profil di pojok kanan atas.

3. Pilih menu Update.

4. Tunggu sampai proses update selesai.

Setelah selesai, periksa kembali menu pada foto profil. Pastikan menu Migrasi ke Versi 4 sudah muncul.

3. Periksa Pengaturan PHP dan Server

Sebelum migrasi, pastikan pengaturan server sudah sesuai dengan ketentuan berikut.

◆ PHP menggunakan versi 7.4 saat migrasi.

◆ ionCube Loader versi 15 atau lebih baru sudah aktif.

◆ Ekstensi ZIP sudah aktif.

◆ Ekstensi cURL sudah aktif.

◆ Folder RDM memiliki izin tulis untuk proses PHP.

Pengaturan tersebut dapat diperiksa melalui panel hosting, seperti cPanel atau aaPanel.

Setelah migrasi selesai dan RDM v4 berjalan normal, versi PHP dapat dinaikkan hingga PHP 8.4 jika didukung oleh versi aplikasi yang digunakan. Pastikan ionCube Loader yang sesuai juga sudah aktif.

B. Cara Migrasi RDM v3 ke RDM v4 Secara Online

Migrasi online merupakan cara yang paling praktis jika server hosting dapat terhubung ke server RDM.

Ikuti langkah-langkah berikut.

Langkah 1: Login ke RDM

Buka aplikasi RDM v3 dan login menggunakan akun proktor.

Langkah 2: Buka Menu Migrasi

Klik foto profil di pojok kanan atas, kemudian pilih Migrasi ke Versi 4.

Langkah 3: Periksa Persyaratan

Sistem akan memeriksa apakah server sudah memenuhi persyaratan migrasi.

Pastikan semua persyaratan menunjukkan status OK. Jika masih ada yang belum terpenuhi, perbaiki terlebih dahulu sesuai keterangan yang muncul.

Langkah 4: Mulai Migrasi

Jika semua persyaratan sudah terpenuhi:

1. Klik Mulai Migrasi.

2. Pilih Ya, migrasi untuk melanjutkan.

3. Tunggu proses pengunduhan dan pemasangan RDM v4.

Penting: Jangan menutup halaman browser atau menekan tombol refresh selama proses migrasi berlangsung. Tunggu sampai proses benar-benar selesai.

Langkah 5: Pastikan Migrasi Berhasil

Jika migrasi berhasil, aplikasi akan terbuka secara otomatis menggunakan RDM v4.

Setelah itu, lakukan pemeriksaan data dan aplikasi.

C. Cara Migrasi RDM v3 ke RDM v4 Secara Manual

Jika migrasi online gagal karena server tidak dapat terhubung ke server RDM, gunakan cara manual.

Langkah 1: Unduh File Migrasi

Buka halaman Download pada portal resmi RDM.

Unduh salah satu file berikut sesuai kebutuhan:

◆ Migrasi RDM v4, dengan ukuran sekitar 33 MB.

◆ Installer RDM v4, dengan ukuran sekitar 45 MB, sebagai alternatif jika paket migrasi tidak dapat digunakan.

Ukuran file dapat berubah sesuai paket yang tersedia. Pastikan file diunduh dari portal resmi RDM.

Langkah 2: Buka Menu Migrasi

Login kembali ke RDM v3 menggunakan akun proktor.

Klik foto profil, kemudian pilih Migrasi ke Versi 4.

Langkah 3: Periksa Batas Upload

Pastikan batas upload pada server cukup besar untuk menerima file yang akan diunggah.

Pengaturan PHP yang perlu diperiksa adalah:

• upload_max_filesize

• post_max_size

Jika batas upload terlalu kecil, sesuaikan melalui panel hosting.

Langkah 4: Upload File Migrasi

Setelah batas upload sesuai:

1. Klik Upload Manual.

2. Pilih file ZIP yang sudah diunduh.

3. Tunggu sampai proses upload selesai.

4. Klik Ya, migrasi untuk melanjutkan.

Langkah 5: Tunggu Sampai Selesai

Biarkan proses migrasi berjalan sampai selesai. Jangan menutup halaman atau menghentikan proses yang sedang berlangsung.

Jika paket migrasi gagal digunakan, coba gunakan Installer RDM v4 melalui menu Upload Manual sesuai petunjuk yang ditampilkan aplikasi.

D. Apa yang Harus Dilakukan Setelah Migrasi?

Setelah berhasil berpindah ke RDM v4, lakukan pemeriksaan berikut.

1. Refresh Browser

Jika tampilan masih berantakan atau terlihat seperti RDM v3, coba muat ulang halaman tanpa menggunakan cache.

Gunakan tombol berikut:

◆ Windows: Ctrl + Shift + R

◆ Mac: Cmd + Shift + R

Jika masih bermasalah, buka RDM melalui jendela penyamaran atau Incognito.

2. Periksa Data Madrasah

Pastikan data penting masih tersedia dan sesuai, antara lain:

◆ Profil dan identitas madrasah.

◆ Data kelas dan rombongan belajar.

◆ Data guru.

◆ Data siswa.

◆ Data nilai dan komponen penilaian.

Jika ada data yang tidak sesuai, lakukan pemeriksaan lebih lanjut sebelum menggunakan aplikasi untuk pekerjaan rutin.

3. Jalankan Update Kembali

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

Tunggu sampai proses selesai sebelum melanjutkan penggunaan aplikasi.

4. Naikkan Versi PHP Jika Diperlukan

Setelah RDM v4 berjalan normal, operator dapat mempertimbangkan penggunaan PHP 8.2, 8.3, atau 8.4 jika versi tersebut didukung.

Sebelum mengganti PHP, pastikan ionCube Loader dan ekstensi yang diperlukan sudah aktif pada versi PHP yang dipilih.

Sebaiknya lakukan perubahan dengan hati-hati dan periksa kembali aplikasi setelah penggantian versi PHP.

E. Cara Mengatasi Masalah Saat Migrasi RDM

Berikut beberapa masalah yang sering muncul beserta cara mengatasinya.

1. PHP 7.4 Berstatus Belum

Penyebab: Versi PHP pada hosting belum menggunakan PHP 7.4.

Solusi:

1. Masuk ke panel hosting.

2. Buka pengaturan versi PHP untuk domain RDM.

3. Pilih PHP 7.4.

4. Simpan pengaturan.

5. Buka kembali menu migrasi dan periksa statusnya.

Pastikan pengaturan diterapkan pada domain yang benar.

2. ionCube Loader Belum Aktif

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

Solusi:

◆ Periksa pengaturan PHP pada hosting.

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

◆ Jika tidak tersedia, hubungi penyedia hosting untuk meminta bantuan.

3. Folder RDM Tidak Bisa Ditulis

Penyebab: Pengguna yang menjalankan PHP tidak memiliki izin untuk mengubah file RDM.

Solusi:

◆ Periksa izin dan kepemilikan folder RDM.

◆ Pastikan pengguna PHP memiliki izin tulis yang sesuai.

◆ Jika menggunakan VPS, sesuaikan kepemilikan folder dengan pengguna layanan web yang benar.

Contoh perintah Linux untuk mengubah kepemilikan folder:

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

Ganti nama pengguna, grup, dan lokasi folder sesuai konfigurasi server. Jangan menjalankan perintah tersebut sebelum memastikan nilainya benar. Hindari memberikan izin 777 pada seluruh folder RDM karena dapat menimbulkan risiko keamanan.

4. Paket Migrasi Rusak Saat Diunduh

Penyebab: Koneksi internet terputus atau file tidak terunduh dengan sempurna.

Solusi:

◆ Ulangi proses migrasi online ketika koneksi stabil.

◆ Jika masih gagal, unduh paket migrasi secara manual.

◆ Pastikan file ZIP selesai diunduh sebelum digunakan.

5. Ukuran File Melebihi Batas Upload

Penyebab: Batas upload server terlalu kecil.

Solusi:

◆ Naikkan nilai upload_max_filesize.

◆ Sesuaikan nilai post_max_size.

◆ Periksa juga batas upload pada web server jika masalah masih terjadi.

◆ Gunakan migrasi online jika server dapat terhubung ke server RDM.

6. File RDM Berbeda dari Rilis yang Diharapkan

Penyebab: File aplikasi RDM v3 tidak sesuai dengan file 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 aplikasi.

5. Tunggu sampai proses selesai.

7. Tampilan RDM Masih Lama atau Berantakan

Penyebab: Browser masih menyimpan file tampilan dari versi sebelumnya.

Solusi:

◆ Tekan Ctrl + Shift + R pada Windows.

◆ Tekan Cmd + Shift + R pada Mac.

◆ Coba buka RDM melalui jendela penyamaran.

◆ Bersihkan cache browser jika diperlukan.

8. Migrasi Gagal di Tengah Proses

Jika migrasi gagal sebelum selesai, jangan langsung menghapus file aplikasi atau mengubah database secara manual.

Lakukan langkah berikut:

1. Catat pesan error yang muncul.

2. Periksa log aplikasi dan server.

3. Siapkan backup folder RDM yang dibuat sebelum migrasi.

4. Pulihkan file aplikasi menggunakan backup sesuai kondisi instalasi.

5. Perbaiki penyebab kegagalan sebelum mencoba kembali.

Lakukan pemulihan dengan hati-hati agar tidak mencampur file dari versi yang berbeda.

Menurut panduan ini, proses migrasi tidak mengubah database. Namun, backup database tetap diperlukan untuk mengantisipasi masalah lain.

F. Daftar Pemeriksaan Migrasi RDM v4

Agar tidak ada langkah yang terlewat, gunakan daftar berikut.

Sebelum migrasi

◆ Backup database sudah diunduh.

◆ Seluruh folder RDM sudah dikompres dan diunduh.

◆ RDM v3 sudah di-update.

◆ PHP 7.4 sudah aktif.

◆ ionCube Loader versi 15 atau lebih baru sudah aktif.

◆ Ekstensi ZIP dan cURL sudah aktif.

◆ Folder RDM dapat ditulis oleh PHP.

Sesudah migrasi

◆ RDM v4 berhasil dibuka.

◆ Tampilan aplikasi sudah normal.

◆ Profil madrasah sudah diperiksa.

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

◆ Update aplikasi sudah dijalankan jika diperlukan.

◆ Aplikasi sudah diuji sebelum digunakan kembali.

Kesimpulan

Migrasi RDM v3 ke RDM v4 dapat dilakukan dengan dua cara, yaitu online dan manual. Gunakan migrasi online jika server dapat terhubung ke server RDM. Jika tidak bisa, gunakan metode manual dengan mengunggah paket migrasi.

Hal terpenting yang harus dilakukan adalah backup database dan file RDM sebelum migrasi. Pastikan juga PHP 7.4, ionCube Loader, ekstensi ZIP, ekstensi cURL, dan izin folder sudah sesuai.

Setelah migrasi selesai, periksa data madrasah dan pastikan aplikasi berjalan normal sebelum digunakan kembali.

Catatan: Panduan ini disusun berdasarkan informasi sumber yang diberikan. Persyaratan teknis dapat berbeda sesuai paket RDM yang digunakan, sehingga tetap periksa petunjuk resmi sebelum melakukan perubahan pada server.

---

Madrasah Hebat Bermartabat

Layanan digitalisasi madrasah: Website Madrasah, PPDB/SPMB Online, Hosting RDM, dan CBT Online.

Kunjungi: https://www.madrasahebat.com