Dokumentasi RyuExam CBT

Satu komputer di sekolah berperan sebagai server: menjalankan aplikasi dan database. Perangkat siswa cukup membuka alamat server lewat browser, tanpa memasang apa pun.

Perkiraan kapasitas

Cara tercepat mencoba aplikasi di satu komputer. Langkah yang sama juga dipakai untuk server ujian LAN.

1. Pasang Laragon

   Unduh Laragon Full dari laragon.org, lalu pasang di C:\laragon.

2. Salin folder aplikasi

   Salin folder aplikasi ke C:\laragon\www\ujian. Pastikan berkas index.php berada langsung di C:\laragon\www\ujian\index.php, bukan di subfolder lain.

3. Jalankan Apache & MySQL

   Buka Laragon, klik Start All. Tunggu sampai Apache (port 80) dan MySQL (port 3306) berstatus berjalan.

4. Siapkan database

   Aplikasi membuat database cbt_ujian secara otomatis saat pertama kali dibuka. Jika paket Anda menyertakan berkas .sql, buat database cbt_ujian (collation utf8mb4_unicode_ci) di http://localhost/phpmyadmin atau HeidiSQL bawaan Laragon, lalu impor berkas tersebut.

5. Periksa config.php

   Pada instalasi Laragon standar berkas ini tidak perlu diubah. Nilai bawaan yang dipakai di komputer lokal:

   C:\laragon\www\ujian\config.phpSalin

   $db_local = [
       'host' => 'localhost',
       'port' => '3306',
       'name' => 'cbt_ujian',   // nama database
       'user' => 'root',
       'pass' => '',            // kosong pada Laragon
   ];

   Jika user root MySQL Anda memakai kata sandi, isikan pada 'pass'. Tidak perlu me-restart Laragon.

6. Buka aplikasi di browser

   Halaman siswa di http://localhost/ujian dan panel admin di http://localhost/ujian/admin.php. Masuk ke panel admin memakai akun yang diberikan bersama paket aplikasi, lalu segera ganti kata sandinya.

localhost/ujian

localhost/ujian/admin.php

Server dipasang seperti pada bagian Localhost, lalu dibuka dari perangkat lain lewat jaringan sekolah. Internet tidak diperlukan selama ujian.

Semua perangkat berada dalam satu jaringan (subnet) yang sama. Contoh di panduan ini memakai IP server 192.168.1.100 dan router 192.168.1.1; sesuaikan dengan jaringan sekolah Anda.

1. Beri IP statis pada server

IP server harus tetap agar alamat ujian tidak berubah setelah router dinyalakan ulang.

1. Buka Network Connections

   Tekan Windows + R, ketik ncpa.cpl, lalu Enter.

2. Buka pengaturan IPv4

   Klik kanan adapter yang terhubung ke router (Ethernet) → Properties → klik dua kali Internet Protocol Version 4 (TCP/IPv4).

3. Isi alamat

   Pilih Use the following IP address, isi sesuai tabel, lalu OK.

Cek hasilnya: buka Command Prompt, ketik ipconfig, lalu lihat baris IPv4 Address.

2. Izinkan port 80 di Windows Firewall

Firewall Windows sering memblokir akses dari perangkat lain. Cara tercepat: buka Command Prompt sebagai Administrator, lalu jalankan:

netsh advfirewall firewall add rule name="RyuExam CBT" dir=in action=allow protocol=TCP localport=80

Cara manual: Windows + R → wf.msc → Inbound Rules › New Rule → Port → TCP 80 → Allow the connection → centang semua profil → beri nama → Finish.

3. Atur router & access point

4. Uji dari perangkat siswa

1. Sambungkan perangkat

   Sambungkan satu HP atau laptop ke WiFi ruang ujian.

2. Buka alamat server

   Di browser ketik http://192.168.1.100/ujian. Halaman login siswa harus tampil.

3. Coba login siswa

   Masuk dengan satu akun siswa dan pastikan dashboard menampilkan jadwal ujian kelasnya.

4. Ulangi di setiap ruang

   Lakukan uji yang sama dari tiap access point sebelum hari ujian.

Jika siswa membuka server lewat domain buatan sendiri (mis. cbt.sekolah.id dari DNS lokal), paksa mode lokal:

// Sebelum
$environment_mode = 'auto';
// Sesudah
$environment_mode = 'local';

Daftar periksa hari ujian

• Server menyala dan tersambung kabel LAN, terhubung ke UPS atau stopkontak stabil.
• Laragon: Apache & MySQL berjalan. Mode sleep dimatikan (Power & sleep › Never) dan Windows Update dijeda.
• IP server sesuai hasil ipconfig; semua AP menyala dan sudah diuji dari tiap ruang.
• Jadwal ujian & kelas sudah benar, token ujian siap dibagikan pengawas.
• Database sudah dicadangkan lewat menu Backup di panel admin.

Untuk ujian lewat internet. Aplikasi dipasang di hosting dan siswa membuka alamat domain sekolah dari mana saja. Langkahnya mirip instalasi lokal, tetapi memakai database dan alamat dari hosting.

Perkakas cPanel yang dipakai ditandai nomor langkah pada gambar berikut.

namadomain.com:2083

Langkah 1. Unggah dan ekstrak aplikasi

1. Buka File Manager

   Masuk ke cPanel, lalu klik File Manager. Buka folder tujuan: public_html untuk domain utama, atau folder subdomain (misalnya public_html/ujian) bila memakai subdomain.

2. Unggah berkas ZIP

   Klik Upload, pilih berkas ZIP aplikasi, tunggu sampai selesai, lalu kembali ke File Manager.

3. Ekstrak

   Pilih berkas ZIP, klik Extract, lalu konfirmasi folder tujuan.

4. Periksa susunan folder

   Pastikan index.php, admin.php, dan config.php berada langsung di folder tujuan. Jika terbentuk satu folder tambahan di dalamnya, pilih semua isinya lalu pindahkan ke atas. Setelah itu hapus berkas ZIP.

namadomain.com:2083/…/filemanager

Langkah 2. Buat database

1. Buka MySQL® Database Wizard

   Dari beranda cPanel, klik MySQL® Database Wizard.

2. Buat database

   Isi nama database (contoh cbtujian). cPanel menambahkan awalan akun, sehingga nama lengkapnya menjadi seperti u123456_cbtujian.

3. Buat user database

   Isi username (contoh cbtadmin) dan password yang kuat. Catat ketiganya: nama database, username, dan password lengkap beserta awalannya.

4. Beri hak akses

   Centang ALL PRIVILEGES, lalu lanjutkan sampai selesai.

namadomain.com:2083/…/sql/wizard

Langkah 3. Atur versi PHP dan ekstensi

Buka Select PHP Version (atau MultiPHP Manager), pilih PHP 8.x untuk domain yang dipakai, lalu aktifkan ekstensi berikut:

namadomain.com:2083/…/select-php-version

Langkah 4. Isi koneksi database di config.php

1. Buka berkasnya

   Di File Manager, klik kanan config.php lalu pilih Edit (atau Code Editor).

2. Isi bagian $db_hosting

   Masukkan nama database, user, dan password dari langkah 2. Biarkan host tetap localhost dan port 3306 kecuali penyedia hosting menyebut lain.

3. Simpan

   Klik Save Changes. Bagian $db_local tidak perlu diubah.

$db_hosting = [
    'host' => 'localhost',
    'port' => '3306',
    'name' => 'u123456_cbtujian',   // nama database dari cPanel
    'user' => 'u123456_cbtadmin',   // user database
    'pass' => 'PASSWORD_DATABASE',  // password user database
];

namadomain.com:2083/…/editit

Langkah 5. Impor database (bila paket menyertakan berkas .sql)

Tabel dibuat otomatis saat aplikasi pertama kali dibuka. Jika paket Anda menyertakan berkas .sql, buka phpMyAdmin, pilih database yang baru dibuat, klik tab Import, pilih berkasnya, lalu klik Go. Jika tidak ada berkas .sql, lewati langkah ini.

Langkah 6. Aktifkan HTTPS

Buka SSL/TLS Status, pilih domain atau subdomain yang dipakai, lalu klik Run AutoSSL (atau pasang sertifikat Let's Encrypt dari menu yang tersedia di hosting Anda). Setelah aktif, buka alamat dengan https://. Dengan HTTPS, cookie sesi aplikasi otomatis memakai tanda Secure sehingga lebih aman.

Langkah 7. Buka aplikasi, ganti password, dan aktifkan lisensi

1. Buka panel admin

   Ketik https://ujian.sekolah.sch.id/admin.php (sesuaikan domain Anda). Halaman login admin akan tampil.

2. Masuk dan ganti password

   Gunakan akun admin dari paket aplikasi, lalu segera ganti kata sandinya di Pengaturan › Kelola Admin.

3. Aktifkan lisensi

   Ikuti langkah pada bagian Memasukkan Lisensi. Hosting sudah terhubung internet sehingga aktivasi bisa langsung dilakukan.

4. Uji dari perangkat siswa

   Buka alamat ujian dari HP, login dengan satu akun siswa uji, dan pastikan jadwal ujian tampil.

ujian.sekolah.sch.id/admin.php

Pengaturan agar lancar di hosting

• Izin berkas: gunakan 0755 untuk folder dan 0644 untuk berkas. Folder data dan _backup_questions harus dapat ditulis oleh aplikasi; pada cPanel standar izin ini sudah cukup.
• Interval sinkronisasi jawaban: di Pengaturan › Umum › Aturan Pengerjaan Ujian, atur 60 sampai 90 detik untuk hosting agar beban server ringan.
• Berkas besar: bila impor soal atau Impor ZIP gagal karena ukuran, naikkan upload_max_filesize dan post_max_size lewat MultiPHP INI Editor.
• Kapasitas: hosting bersama punya batas proses dan CPU. Untuk ujian serentak ratusan siswa, pilih paket cloud hosting atau VPS dan lakukan uji coba dengan banyak perangkat sebelum hari ujian.
• Cadangan: aktifkan backup berkala di cPanel (Backup), dan unduh backup database lewat Pengaturan › Database sebelum serta sesudah ujian.

Masalah umum di cPanel

Aplikasi diaktifkan sekali per server memakai NPSN sekolah dan kode lisensi yang Anda terima dari penjual. Halaman ujian siswa tetap berjalan normal selama proses aktivasi.

1. Siapkan NPSN dan kode lisensi

   NPSN terdiri dari 8 karakter. Kode lisensi berbentuk RYU-XXXXX-XXXXX-XXXXX-XXXXX. Belum punya kode? Hubungi penjual lewat WhatsApp.

2. Buka halaman aktivasi

   Buka panel admin di http://localhost/ujian/admin.php. Bila lisensi belum aktif, halaman aktivasi tampil. Anda juga bisa membukanya langsung di http://localhost/ujian/aktivasi.php.

3. Cari sekolah dengan NPSN

   Ketik NPSN sekolah, lalu klik Cari Sekolah.

   localhost/ujian/aktivasi.php

   

4. Pastikan nama sekolah sesuai

   Nama sekolah, NPSN, dan paket lisensi akan tampil. Jika bukan sekolah Anda, klik Ganti NPSN.

5. Masukkan kode lisensi lalu Aktifkan

   Tempel kode lisensi pada kolom Kode Lisensi, lalu klik Aktifkan. Jika berhasil, panel admin terbuka otomatis.

   localhost/ujian/aktivasi.php

   

Melihat dan mengelola lisensi

Buka panel admin → Pengaturan → tab Lisensi → klik Kelola Lisensi. Halaman ini menampilkan:

• Status lisensi (aktif atau tidak), nama sekolah, dan NPSN.
• Paket: Satu Sekolah, Multi Sekolah, atau Developer.
• Masa berlaku, serta batas waktu aman tanpa internet.
• ID instalasi server ini, berguna bila perlu menghubungi penjual.

Tombol Periksa ulang ke server lisensi menyegarkan status, misalnya setelah perpanjangan dari penjual.

Pindah server atau pasang ulang

1. Lepas lisensi di server lama

   Di halaman Kelola Lisensi, klik Lepas lisensi dari server ini. Bila server lama sudah tidak bisa diakses, minta penjual melepas instalasi lama.

2. Aktifkan di server baru

   Ulangi langkah aktivasi di atas dengan NPSN dan kode lisensi yang sama.

Gejala yang paling sering muncul saat pemasangan, beserta solusinya.

Instalasi & jaringan

Lisensi