Solusi Gagal Instal dan Registrasi RDM Versi Installer, XAMPP, serta Hosting

Aplikasi Raport Digital Madrasah (RDM) merupakan platform penting yang digunakan oleh operator madrasah di seluruh Indonesia untuk mengelola nilai dan data perkembangan peserta didik. Kendati demikian, dalam proses pengoperasiannya, tidak sedikit operator yang mengalami kendala teknis. Masalah yang sering muncul antara lain pesan error “This site can’t be reached” saat mengakses RDM versi Installer/Localhost, kegagalan registrasi token pada RDM versi Hosting, hingga kendala saat melakukan proses restore atau migrasi data.

Artikel ini menyajikan panduan penanganan masalah (troubleshooting) secara menyeluruh berdasarkan praktik teknis yang dapat diterapkan secara bertahap oleh operator madrasah.

Menganalisis Penyebab Utama Error pada Aplikasi RDM

Sebelum melakukan langkah perbaikan, sangat penting untuk memahami jenis kegagalan yang terjadi pada aplikasi RDM:

1. Error “This site can’t be reached” pada Versi Installer: Umumnya disebabkan oleh kegagalan pemanggilan baris perintah (script) arsitektur sistem (seperti perintah goto AMD64) pada file setup atau service database MySQL/Apache yang belum berjalan sempurna.

2. Gagal Registrasi Token pada Versi Hosting: Pesan seperti “NSM atau token tidak terdaftar” kerap terjadi akibat batasan keamanan server hosting atau gangguan komunikasi antara server hosting dengan server RDM Pusat.

3. Gagal Sync Data atau Restore di Versi Installer: Sering kali disebabkan oleh pembacaan data yang tidak stabil atau ketidaksesuaian versi patch aplikasi, sehingga memerlukan pemindahan (migrasi) ke lingkungan lingkungan server lokal XAMPP yang lebih terbuka.

Cara Mengatasi Error “This Site Can’t Be Reached” pada RDM Versi Installer

Jika saat membuka portal localhost RDM pada peramban web (browser) muncul tampilan “This site can’t be reached”, perbaikan dapat dilakukan dengan menyunting skrip setup penginstal di Drive C.

C:\RDM Madrasah\

Langkah-Langkah Perbaikan Skrip Setup RDM:

1. Buka Directory RDM: Masuk ke Local Disk (C:), lalu buka folder RDM Madrasah.

2. Edit File Setup: Cari file bernama setup (atau file eksekusi dengan ekstensi .bat/.cmd). Klik kanan pada file tersebut, lalu pilih Edit in Notepad.

3. Cari dan Perbaiki Perintah Goto:

   • Cari teks goto AMD64.

   • Salin (copy) frasa goto AMD64 tersebut.

   • Hapus blok sintaksis kurung siku/kondisional yang tidak diperlukan (sekitar 4 baris kode di area blok tersebut).

   • Tempelkan (paste) teks goto AMD64 secara langsung untuk menggantikan blok sintaks yang dihapus.

4. Simpan File: Klik menu File > Save (atau tekan Ctrl + S), kemudian tutup Notepad.

5. Jalankan Ulang Service via Administrator:

   • Kembali ke folder RDM Madrasah.

   • Klik kanan pada file setup, lalu pilih Run as administrator.

   • Tunggu hingga jendela Command Prompt (CMD) berwarna hitam muncul dan memproses layanan hingga selesai.

6. Muat Ulang Browser: Buka kembali peramban web dan lakukan reload/refresh pada alamat localhost RDM. Halaman login RDM kini akan terbuka dan dapat diakses menggunakan NSM serta Token Madrasah.

Solusi Mengatasi Hosting RDM Gagal Registrasi Token

Ketika memasang RDM pada versi Hosting, sebagian operator menjumpai kendala registrasi token yang selalu ditolak meskipun token resmi telah di-reset berulang kali dari portal pusat. Cara efektif untuk mengatasi masalah ini adalah dengan memanfaatkan RDM versi Installer dan XAMPP sebagai perantara pembuatan database.

Tahap 1: Registrasi Melalui RDM Installer Lokal

1. Unduh (download) dan instal RDM Versi Installer di komputer lokal.

2. Buka RDM Installer, masukkan data NSM, nama madrasah, dan token resmi.

3. Lakukan registrasi hingga berhasil masuk ke dashboard RDM lokal. (Catatan: RDM versi installer lokal hampir selalu berhasil melakukan registrasi token).

4. Lakukan logout dari RDM Installer.

Tahap 2: Pindahkan Database ke XAMPP

1. Unduh dan instal aplikasi XAMPP (disarankan menggunakan XAMPP dengan versi PHP 8.0.x).

2. Buka folder C:\RDM Madrasah\mysql\data.

3. Salin (copy) folder bernama rdm_madrasah serta tiga file log data berikut:

   • ib_logfile0

   • ib_logfile1

   • ibdata1

4. Buka folder tujuan di C:\xampp\mysql\data. Tempelkan (paste) dan timpa (replace) file/folder yang telah disalin tadi.

5. Jalankan XAMPP Control Panel, lalu aktifkan (start) service Apache dan MySQL.

Tahap 3: Ekspor Database dari PHPMyAdmin Lokal

1. Buka browser dan akses alamat http://localhost/phpmyadmin.

2. Pilih database rdm_madrasah pada panel sebelah kiri.

3. Klik tab Export, pilih metode Quick, format SQL, lalu klik Go. File .sql dari RDM yang telah terregistrasi akan tersimpan di komputer.

Tahap 4: Impor Database ke cPanel Hosting

1. Masuk ke halaman cPanel Hosting madrasah Anda.

2. Buka menu phpMyAdmin, lalu pilih nama database RDM Hosting Anda.

3. Centang seluruh tabel lama yang ada, lalu pilih tindakan Drop untuk mengosongkan database hosting.

4. Klik tab Import, klik Choose File, lalu pilih file .sql yang diunduh dari XAMPP lokal tadi.

5. Klik Import dan tunggu hingga proses unggah selesai.

6. Buka kembali tautan (link) RDM Hosting Anda lalu lakukan refresh. Aplikasi tidak lagi meminta registrasi ulang dan dapat langsung digunakan untuk login menggunakan akun yang telah didaftarkan di lokal.

Solusi Gagal Restore atau Sering Error Menggunakan RDM Versi XAMPP Portable

Apabila aplikasi RDM versi Installer sering mengalami kegagalan saat proses restore data backup, gagal kirim nilai, atau data siswa tidak dapat tersinkronisasi dengan EMIS/Verval, migrasi penuh ke RDM Versi XAMPP sangat direkomendasikan.

Langkah Migrasi ke RDM Versi XAMPP:

1. Ambil Backup Data Lama: Buka aplikasi RDM terdahulu, masuk ke menu pengaturannya, pilih Backup Semua, dan unduh file cadangannya ke komputer.

2. Ekstrak Paket RDM XAMPP: Unduh file paket RDM Portable/XAMPP. Ekstrak folder tersebut di direktori mana saja pada komputer (misalnya di D:\ atau C:\).

3. Jalankan Control Panel: Buka folder hasil ekstrak, cari file xampp-control.exe, lalu jalankan. Klik Start pada modul Apache dan MySQL.

4. Registrasi dan Update: Akses http://localhost pada browser. Abaikan notifikasi kegagalan update awal, lalu lakukan registrasi menggunakan token resmi. Masuk ke dasbor dan lakukan update patch hingga muncul notifikasi pembaruan berhasil.

5. Restore File Backup:

   • Pastikan versi patch RDM di lingkungan XAMPP baru sudah sama persis dengan versi RDM lama tempat file backup diambil.

   • Buka menu Restore, pilih file backup yang telah diunduh sebelumnya, lalu jalankan proses pengembalian data.

   • Tunggu proses restore berlangsung (umumnya memakan waktu sekitar 5 hingga 15 menit tergantung ukuran data).

Kesimpulan

Permasalahan pada aplikasi Raport Digital Madrasah (RDM) dapat diatasi secara mandiri dengan langkah-langkah yang tepat. Error “This site can’t be reached” pada versi installer umumnya selesai dengan perbaikan variabel pada file setup dan penjelangan service sebagai administrator. Sementara itu, kendala registrasi token hosting dapat diselesaikan melalui pengalihan database via XAMPP lokal, dan masalah pengiriman nilai/sync data dapat ditanggulangi dengan memindahkan RDM ke lingkungan XAMPP Portable.

FAQ (Pertanyaan Umum)

Bagaimana jika saya lupa atau kehilangan token RDM Madrasah?

Token RDM diterbitkan oleh server pusat. Anda dapat mengajukan permohonan reset atau pengecekan token RDM melalui Admin HD (Helpdesk) Kemenag Kabupaten/Kota atau melalui akun portal HD Madrasah masing-masing.

Apakah aman memindahkan file ibdata1 dari Installer RDM ke XAMPP?

Prosedur ini aman selama service MySQL pada kedua aplikasi sedang dalam keadaan mati (stopped) saat proses penyalinan dilakukan, guna mencegah kerusakan (corrupt) pada tabel InnoDB.

Mengapa proses restore data RDM memakan waktu cukup lama?

Lama proses restore bergantung pada jumlah riwayat siswa, nilai, serta spesifikasi komputer yang digunakan. Proses ini secara normal memakan waktu antara 5 hingga 15 menit. Pastikan koneksi dan daya listrik tidak terputus selama proses berlangsung.