Tutorial

Panduan lengkap instalasi dan penggunaan ZenCBT — dari setup database hingga pelaksanaan ujian.

Daftar Isi

📺 Video Tutorial🗄️ Tahap 1: Setup Database (PostgreSQL)⚡ Tahap 2: Instalasi & Menjalankan ZenCBT📦 Tahap 3: Manajemen Data & Soal🎯 Tahap 4: Pelaksanaan Ujian

📺 Video Tutorial

Panduan visual langkah demi langkah untuk instalasi ZenCBT.

Install Server Windows

Install Server Linux

Panduan Penggunaan

* Video tutorial lainnya akan segera ditambahkan.

🗄️ Tahap 1: Setup Database (PostgreSQL)

ZenCBT menggunakan PostgreSQL agar performa tetap cepat walau menampung ribuan koneksi ujian simultan.

Windows / Mac

  1. 1Unduh PostgreSQL: Buka situs resmi PostgreSQL dan pilih installer sesuai OS. Direkomendasikan versi 14 ke atas.
  2. 2Instalasi: Lakukan instalasi standar (Next-Next). Saat diminta membuat password untuk superuser postgres, gunakan password yang mudah diingat.
  3. 3Buat Database: Buka pgAdmin 4 (bawaan PostgreSQL), masuk dengan password Anda, lalu buat database baru bernama zencbt. Alternatif via Command Line: psql -U postgres -c "CREATE DATABASE zencbt;"
  4. 4Import Database: Import file init_db_zencbt_x.x.x.sql yang terdapat di dalam folder ZenCBT ke database zencbt yang baru dibuat.
  5. 5Cek tabel: Buka pgAdmin (bawaan PostgreSQL), masuk dengan password Anda, lalu cek tabel zencbt.

Linux

  1. 1Install PostgreSQL: Jalankan sudo apt install postgresql postgresql-contrib
  2. 2Buat Database: Jalankan psql -U postgres -c "CREATE DATABASE zencbt;"
  3. 3Import Database: Import file init_db_zencbt_x.x.x.sql ke database zencbt.

⚡ Tahap 2: Instalasi & Menjalankan ZenCBT

Download, setting .env, dan langsung jalankan.

  1. 1Unduh & Ekstrak: Download file zip rilis ZenCBT terbaru. Letakkan dan ekstrak di satu folder tersendiri. Untuk windows, gunakan path tanpa spasi!
  2. 2Sambungkan Database: Buka file .env yang berada di dalam folder tersebut menggunakan Notepad. Cari tulisan DB_PASSWORD=... lalu ganti isinya dengan password PostgreSQL yang Anda buat pada Tahap 1.
  3. 3Jalankan Aplikasi: Klik ganda file zencbt-xxx.exe (Windows) atau ./zencbt-xxx (Linux). Sistem akan otomatis mendeteksi database dan melakukan auto-migration tabel.
  4. 4Login Admin: Buka browser (Chrome/Edge/Firefox) lalu akses http://localhost:8080/admin (atau http://IP_Server:8080/admin dari komputer lain di jaringan LAN). Gunakan Username dan Password bawaan yang ada di rilis versi.
  5. 5Pastikan: Berikan akses Firewall di Windows Defender (windows) dan beri akses sudo chmod +x zencbt-xxx (linux)

📦 Tahap 3: Manajemen Data & Soal

Lengkapi master data, impor siswa, dan susun bank soal.

  1. 1Atur Identitas: Masukkan Logo Sekolah dan nama lembaga Anda di menu konfigurasi (Settings).
  2. 2Lengkapi Data Master: Isi data Program, Level, Group, dan Mata Pelajaran.
  3. 3Impor Data Siswa: Buka menu Master Data → Siswa, impor data peserta didik menggunakan Template Excel yang tersedia. Level, Group, dan Program mengikuti data yang sudah ada di template.
  4. 4Susun Bank Soal: Masuk ke menu Bank Soal, unggah berkas .docx (MS Word) rancangan Anda, selesai tanpa kendala ketik ulang gambar/tabel!

🎯 Tahap 4: Pelaksanaan Ujian

Rilis jadwal, pantau ruangan, dan cetak nilai.

  1. 1Rilis Jadwal: Pada menu Daftar Ujian, klik Tambah, pilih Bank Soal, tentukan Alokasi Waktu, kemudian terbitkan jadwal agar berstatus Aktif. Berikan Token Ujian kepada siswa yang masuk ruangan.
  2. 2Kendalikan Ruangan: Pantau siswa yang sudah online dan mengetik jawaban secara utuh dari meja Operator melalui layar monitoring.
  3. 3Cetak Nilai: Setelah timer peserta habis (diproses 100% via server, menutup peluang cheat time), beralih ke menu Hasil/Nilai, lalu unduh rekap Laporan Excel nilai untuk rapor hari itu juga.

Butuh bantuan lebih lanjut? Hubungi kami melalui:

Telegramadmin@hazenlabz.id